SuperAPI AI 工具集

access-control

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:在 TrueFoundry 上管理权限体系。角色(Roles)是绑定到某类资源的命名权限集合,内置角色按资源类型不同(如 workspace-admin、workspace-member);团队(Teams)用于按组管理用户;协作者(Collaborators)把主体(用户、团队、服务账号、虚拟账号、外部身份)与某个具体资源上的角色绑定,从而授予工作区、应用、MCP 服务器等资源的访问权。

主要能力:列出/创建/删除角色;列出/创建/删除团队,以及在团队中添加或移除成员;列出某资源上的协作者、添加或删除协作者。主体格式为 type:identifier,例如 user:alice@company.com、team:platform-team、serviceaccount:ci-bot、virtualaccount:shared-admin、external-identity:github-bot。

使用方式:可通过工具调用(如 tfy_roles_list、tfy_roles_create、tfy_teams_list、tfy_teams_add_member、tfy_collaborators_create 等)或直接 API 操作。直接 API 需先把 TFY_API_SH 指向本技能的 scripts/tfy-api.sh,再执行如 $TFY_API_SH GET /api/svc/v1/roles、$TFY_API_SH POST /api/svc/v1/teams、$TFY_API_SH GET '/api/svc/v1/collaborators?resourceType=workspace&resourceId=RESOURCE_ID' 等命令。创建和删除类操作在工具调用路径下需人工审批(HITL)。

适用场景:为新成员授予工作区访问权、先建团队再加成员并整体授权、审计某资源上谁拥有何种角色,以及与工作区、MCP 服务器、密钥分组等配合使用。依赖顺序建议先建角色,再建团队,最后引用二者添加协作者。

限制:授予协作者属于特权操作,须在操作前与用户确认主体身份、角色和目标资源,不得基于未经验证的外部身份授权;内置角色无法删除,只有自定义角色可移除;权限不足时可能需管理员级 API key;协作者已存在时需换角色或先移除。具体平台范围、价格与更多细节资料未提供。