跳到主要内容
版本:3.8.x

创建自定义角色

API7 企业版最初提供不可修改的 Super Admin 角色和策略,授予初始设置所需的全部访问权限。默认 admin 账号永久绑定此角色,用于紧急恢复。

通过自定义角色,可以建立符合具体需求的细粒度权限系统。本教程介绍如何在 API7 企业版中定义自定义角色,以更精确地管理访问控制。

本教程创建的自定义角色对生产网关组具有只读访问权限,对测试网关组具有完全访问权限(查看和编辑)。你将完成以下步骤:

  1. 创建两个权限策略,分别定义对生产网关组的只读权限和对测试网关组的完全访问权限。
  2. 创建自定义角色 Development Team Member,并关联上述两个权限策略。

前提条件​

  1. 安装 API7 企业版。
  2. 为测试和生产环境创建两个网关组,每个组中至少有一个网关实例。
  3. 在两个网关组中都发布一个服务,用于验证。
  4. (可选)了解权限策略示例。

创建权限策略​

创建生产环境只读权限策略​

  1. 从顶部导航栏选择组织,然后选择权限策略。
  2. 点击新增权限策略。
  3. 在对话框中,执行以下操作:
  • 在名称字段中输入 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"
}
]
}
  • 点击新增。

创建测试环境完全访问权限策略​

  1. 从顶部导航栏选择组织,然后选择权限策略。
  2. 点击新增权限策略。
  3. 在对话框中,执行以下操作:
  • 在名称字段中输入 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"
}
]
}
  • 点击新增。

创建自定义角色​

  1. 从顶部导航栏选择组织,然后选择角色。
  2. 点击新增自定义角色。
  3. 在对话框中,执行以下操作:
  • 在名称字段中输入 Development Team Member。
  • (可选)在描述字段中输入 View-only access to production gateway group and full access (view & edit) to test gateway group.
  • 点击新增。
  1. 在角色详情页点击关联策略。
  2. 选择 production-gateway-group-view-only 和 test-gateway-group-full-access。
  3. 点击提交。

验证自定义角色​

  1. 按照更新用户角色教程,为其他用户(例如 Tom)分配 Development Team Member 角色。
  2. 请 Tom 登录并验证其权限。

相关阅读​