用途:在 ibl.ai 平台上配置基于角色的访问控制(RBAC),使某个 API 令牌能够列出并解密集成凭据。集成密钥默认以掩码形式提供,令牌只有在绑定到授予 integration-credentials 资源相关操作的 RBAC 策略后,才能读取敏感字段。
主要能力:授予令牌 unmask 访问权限;可限制令牌仅访问特定凭据,而非全部凭据。
使用方式:
- 打开 Organization Settings(Account Dialog)→ Integration → APIs。
- 添加新的 API key,记录获得的令牌。
- 超级管理员需将 Mode 改为 Token Policies。
- 在 Organization Settings → Management → Roles 中创建新角色,例如命名为 Unmask Sensitive Integration Credentials。
- 在 Actions 下点击搜索并添加以下操作后保存: Ibl.Mentor/IntegrationCredentialsSensitive/action Ibl.Mentor/IntegrationCredentialsUnmask/action Ibl.Mentor/IntegrationCredentials/list
- 在 Policies 标签页创建新策略,选择第 4 步创建的角色。
- 将策略的 Resources 设为 /platforms/<platform-pk>/integration-credentials/(platform PK 为整数,不是 key),在 Tokens 下添加令牌并保存。
- 超级管理员需进入 Rbac Policies,找到刚创建的策略,在 Tokens 下添加令牌并保存。
配置完成后,令牌可携带 unmask 查询参数访问集成凭据端点: GET {dmUrl}/api/ai-account/orgs/<org>/integration-credential/?unmask_sensitive_fields=true
限制:若要将令牌限制为特定凭据而非全部凭据,可在策略的 Resources 中添加该凭据的 PK(整数),而不是整个集合。相关技能包括 /iblai-vibe-rbac(默认角色、action-definitions 端点、SDK Roles + Policies 组件)和 /iblai-vibe-account(管理 API keys、Roles 和 Policies 的 Organization Settings 界面)。