创建自定义角色
API7 企业版最初提供不可修改的 Super Admin 角色和策略,授予初始设置所需的全部访问权限。默认 admin 账号永久绑定此角色,用于紧急恢复。
通过自定义角色,可以建立符合具体需求的细粒度权限系统。本教程介绍如何在 API7 企业版中定义自定义角色,以更精确地管理访问控制。
本教程创建的自定义角色对生产网关组具有只读访问权限,对测试网关组具有完全访问权限(查看和编辑)。你将完成以下步骤:
- 创建两个权限策略,分别定义对生产网关组的只读权限和对测试网关组的完全访问权限。
- 创建自定义角色
Development Team Member,并关联上述两个权限策略。
前提条件
- 安装 API7 企业版。
- 为测试和生产环境创建两个网关组,每个组中至少有一个网关实例。
- 在两个网关组中都发布一个服务,用于验证。
- (可选)了解权限策略示例。
创建权限策略
创建生产环境只读权限策略
- 从顶部导航栏选择组织,然后选择权限策略。
- 点击新增权限策略。
- 在对话框中,执行以下操作:
- 在名称字段中输入
production-gateway-group-view-only。 - 在策略编辑器字段中输入以下 JSON:
{
"statement": [
{
"resources": [
"arn:api7:gateway:gatewaygroup/{production gateway group id}" // 使用网关组 ID 标识
],
"actions": [
"<.*>Get<.*>"
],
"effect": "allow"
},
{
"resources": [
"arn:api7:gateway:gatewaygroup/{production gateway group id}/publishedservice/<.*>" // 只读访问这些网关组中的所有已发布服务
],
"actions": [
"<.*>Get<.*>"
],
"effect": "allow"
}
]
}
- 点击新增。
创建测试环境完全访问权限策略
- 从顶部导航栏选择组织,然后选择权限策略。
- 点击新增权限策略。
- 在对话框中,执行以下操作:
- 在名称字段中输入
test-gateway-group-full-access。 - 在策略编辑器字段中输入以下 JSON:
{
"statement": [ // 同一策略中的多个语句为 OR 关系。
{
"resources": [
"arn:api7:gateway:gatewaygroup/{test gateway group id}"
],
"actions": [
"<.*>"
],
"effect": "allow"
},
{
"resources": [
"arn:api7:gateway:gatewaygroup/{test gateway group id}/publishedservice/<.*>" // 完全访问此网关组中的所有已发布服务
],
"actions": [
"<.*>"
],
"effect": "allow"
}
]
}
- 点击新增。
创建自定义角色
- 从顶部导航栏选择组织,然后选择角色。
- 点击新增自定义角色。
- 在对话框中,执行以下操作:
- 在名称字段中输入
Development Team Member。 - (可选)在描述字段中输入
View-only access to production gateway group and full access (view & edit) to test gateway group. - 点击新增。
- 在角色详情页点击关联策略。
- 选择
production-gateway-group-view-only和test-gateway-group-full-access。 - 点击提交。
验证自定义角色
- 按照更新用户角色教程,为其他用户(例如
Tom)分配Development Team Member角色。 - 请 Tom 登录并验证其权限。