用途:通过 ibl.ai 平台 API 对组织进行管理,覆盖用户、组、RBAC 角色与策略、团队以及告警,用于组织级用户与访问权限管理。
认证与约定:基础地址为 https://api.iblai.app;每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org} 对应 $IBLAI_ORG(即 platform_key),{username} 对应 $IBLAI_USERNAME。这些端点位于 DM 主机的 /api/core/… 下,唯一例外是用户提升/降级,切换到 LMS 主机 learn.iblai.app。若尚未连接,先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
主要能力:读取方面可列出用户及其策略、组、角色、策略、团队及团队访问策略;写入方面可提升/降级用户角色、激活/停用用户、设置用户策略,创建/更新/删除组、角色、策略、团队,设置团队访问,以及管理告警(watched-groups、watched-users、watchers)。
使用方式:多数端点即使请求体已含 platform_key,仍需在查询参数中再传一次。策略将角色(RBAC 角色 id)绑定到资源、用户和组,需先创建角色,再在创建策略时引用其 id。角色权限使用 actions(可选 data_actions),而非 permissions,完整角色/策略模型见 /iblai-api-rbac。
限制与注意:任何子项的 DELETE 均为破坏性操作,删除组、角色、策略、团队、被关注组/用户或观察者前需先与用户确认。提升/降级是唯一位于 LMS 主机的调用,其余端点均在 DM 主机的 /api/core/… 下。资料未提供收费、价格或平台支持范围等信息。