用途:iblai-rbac 用于通过 ibl.ai 平台 API 管理组织的基于角色的访问控制(RBAC),即组织范围内“谁可以对什么执行什么操作”的接口层,路径位于 …/dm/api/core/rbac/…。
主要能力:定义角色和策略,将其附加到组和用户;检查权限;共享智能体(agent)和团队(team);切换学生可执行的操作。支持读取角色、策略、组、智能体访问策略、团队访问策略,以及学生智能体创建和学生 LLM 访问的状态开关;支持写入角色、策略、组的创建、更新、删除;支持权限检查、智能体访问共享、团队共享、批量用户策略设置与学生开关设置。
必要用法:Base URL 为 https://api.iblai.app。每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} 等于 $IBLAI_ORG(又称 platform_key),{username} 等于 $IBLAI_USERNAME。若尚未连接,先运行 /iblai-login 填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。RBAC 开发者文档将认证写作 Authorization: Token <key>,与平台密钥相同,此处使用 Api-Token。资源路径是层级结构,前缀 /platforms/{pk}/,授予父资源的策略会应用到子资源。操作形如 Ibl.Agent/Agents/delete(命名空间 / 资源 / 动词)。平台自带知名角色,可通过 roles 端点列出(可选包含全局角色)。权限检查示例:POST https://api.iblai.app/dm/api/core/rbac/permissions/check/,请求体包含 platform_key 和 resources 数组。多数读取以查询参数携带 platform_key={org};写入(POST/PUT/PATCH)在请求体中携带 platform_key。
适用场景:适用于从 API 驱动组织 RBAC,例如管理角色策略、组与用户绑定、权限校验、智能体与团队共享、批量用户策略以及学生权限开关。
限制:删除角色、策略、组为破坏性操作,需先与用户确认。资料中未提供收费、价格、平台支持范围或效果保证信息。