跳到主要内容
版本:3.2.14.6

创建自定义角色

API7 企业版默认配置了一个锁定的、内置的 超级管理员 角色和策略,以提供初始设置的完全访问权限。默认的 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/{gateway group id}" // 使用网关组 ID 来匹配资源
      ],
      "actions": [ // 列出对网关组内所有类型资源的查看权限
      "gateway:GetGatewayGroup",
      "gateway:GetGatewayInstance",
      "gateway:GetConsumer",
      "gateway:GetSSLCertificate",
      "gateway:GetGlobalPluginRule",
      "gateway:GetPluginMetadata",
      "gateway:GetServiceRegistry",
      "gateway:GetPublishedService"
      ],
      "effect": "allow"
      },
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/{gateway group id}/publishedservice/<.*>" // 查看指定网关组上所有已发布服务
      ],
      "actions": [
      "gateway:GetPublishedService"
      ],
      "effect": "allow"
      }
      ]
      }

      你也可以使用通配符来编写:

      {
      "statement": [
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/{gateway group id}" // 使用网关组 ID 匹配资源
      ],
      "actions": [ // 匹配所有以 "Get" 开头的操作
      "<.*>Get<.*>"
      ],
      "effect": "allow"
      },
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/{gateway group id}/publishedservice/<.*>" // 查看指定网关组上所有已发布服务
      ],
      "actions": [
      "gateway:GetPublishedService"
      ],
      "effect": "allow"
      }
      ]
      }
    • 点击 新增。

创建测试权限策略​

  1. 从顶部导航栏中选择 组织,然后选择 权限策略。
  2. 点击 添加权限策略。
  3. 在表单执行以下操作:
    • 在 名称 字段中填写 test-gateway-group-full-access。

    • 策略编辑器 输入 JSON:

      {
      "statement": [
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/{gateway group id}" // 使用网关组 ID 匹配资源
      ],
      "actions": [ // 包含所有网关组相关权限
      "<.*>"
      ],
      "effect": "allow"
      },
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/{gateway group id}/publishedservice/<.*>" // 对指定网关组上所有已发布服务的完全访问权限
      ],
      "actions": [
      "<.*>"
      ],
      "effect": "allow"
      }
      ]
      }
    • 点击 新增。

创建自定义角色​

  1. 从顶部导航栏中选择 组织,然后选择 角色。
  2. 点击 添加自定义角色。
  3. 在表单中执行以下操作:
    • 在 名称 字段中填写 Development Team Member。
    • (可选)描述 填写 生产网关组只读访问权限和测试网关组完全访问权限(查看和编辑)。
    • 点击 新增。
  4. 在角色详情页面,点击 关联策略。
  5. 选择 production-gateway-group-view-only 和 test-gateway-group-full-access。
  6. 点击 提交。

验证自定义角色​

  1. 按照更新用户角色中的步骤,将 Development Team Member 分配给另一个用户,例如 Tom。
  2. 让 Tom 登录并验证他的权限。

相关阅读​