典型访问场景
本页介绍用基于规则的角色划分组织内访问权限的九种常见方式。每个场景给出目标,在控制台和 Admin API 请求体两种形式下定义角色,说明分配给谁,并描述此人之后能看到什么。
所有场景共用一个示例组织,可以并排配置、互相对照。基于规则的角色从控制面 1.11.0 起在 AISIX Enterprise 和 AISIX Cloud 中提供。
示例组织
各场景假定以下配置:
- 两个环境:
test和prod。 - 在 标签键 页面声明的标签键
dept、tier和vendor。参见声明标签键。 - 两个团队:
payments的负责人是lead-payments,成员有dev-alice;search的成员有dev-carol。 - 两个环境中都有调用方 API Key:有的分配给个人成员,有的绑定到团队但不指定成员,有的带有标签
dept=payments或dept=search。 - 两个环境中都有模型,有的带访问控制标签
tier=public,有的带dept=payments或dept=search。 - 带访问控制标签
vendor=openai或vendor=anthropic的 Provider Key。
API Key 上的 dept 是成本归属标签。模型和 Provider Key 的标签在其创建和编辑表单的 访问控制标签 中设置。
场景中的每个人都是以默认角色受限成员受邀加入的。
创建并分配角色
在控制台中,打开 角色,选择 新建角色,输入角色的 名称,按场景规则表的每一行添加一张规则卡片,然后选择 创建角色。之后在 成员 页面该成员所在行通过 角色 和 添加角色 分配,或在团队的 团队角色 卡片中分配。
使用 Admin API 时,把场景中的请求体发送到 POST /roles,然后按 user_id 分配给成员,或按 team_id 分配给团队。请把请求体中的 TEST_ENV_ID 替换为 test 环境的 ID。
# AISIX_CP 包含 /api,且末尾不带斜杠。
# 本地 AISIX Enterprise 快速开始使用 http://localhost:8080/api。
export AISIX_CP="YOUR_AISIX_CONTROL_PLANE_API_URL"
export AISIX_TOKEN="YOUR_ADMIN_TOKEN"
# 先把场景的请求体保存为 role.json。
curl -sS -X POST "${AISIX_CP}/roles" \
-H "Authorization: Bearer ${AISIX_TOKEN}" \
-H "Content-Type: application/json" \
-d @role.json
# 分配给成员。
curl -sS -X POST "${AISIX_CP}/members/${USER_ID}/roles" \
-H "Authorization: Bearer ${AISIX_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"role": "ROLE_NAME"}'
# 或分配给团队。
curl -sS -X POST "${AISIX_CP}/teams/${TEAM_ID}/roles" \
-H "Authorization: Bearer ${AISIX_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"role": "ROLE_NAME"}'
分配角色需要所有者,或像场景 9 那样持有 role_assignments 的成员。定义角色需要内置的管理员或所有者。
1. 新成员默认受限
目标:新受邀的成员在有人决定其所需权限之前没有任何访问权限。
角色:内置的受限成员。它只读取分配给本人、本人所在团队和本人负责的团队的 API Key,以及这些 Key 的用量,无需额外定义。
分配给