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

更新用户角色

基于角色的访问控制(RBAC)将权限关联到角色,而不是直接关联到用户。再为用户分配这些角色,从而简化访问管理、提高效率并减少错误。本指南介绍如何使用 API7 企业版的自定义角色、权限策略和权限边界来管理基于角色的访问控制。

更新用户角色​

  1. 从顶部导航栏选择组织,然后选择用户。
  2. 点击目标用户的更新角色。
  3. 添加或移除角色。
  4. 点击更新。
备注

要查看每个角色的权限,请从顶部导航栏选择组织,然后选择角色。

角色和权限策略配合控制访问。以下以自定义角色和权限策略为例,介绍如何隔离对不同环境的访问。

定义权限策略​

  1. 创建 test、UAT 和 production 三个网关组。
  2. 从顶部导航栏选择组织,然后选择权限策略。
  3. 点击 + 新增策略。
  4. 在 + 新增权限策略对话框中,执行以下操作:
    • 在名称字段中输入 test-gateway-group-full-access。

    • 在策略编辑器字段中输入配置:

      {
      "statement": [
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/b6db7341-fc1f-4cee-a318-3e782a163d24"
      ],
      "actions": [
      "<.*>"
      ],
      "effect": "allow"
      },
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/b6db7341-fc1f-4cee-a318-3e782a163d24/publishedservice/<.*>"
      ],
      "actions": [
      "<.*>"
      ],
      "effect": "allow"
      }
      ]
      }
      备注

      资源 ID 应与创建的网关组一致。请根据实际使用情况修改。

    • 点击新增。

  5. 点击 + 新增策略。
  6. 在对话框中,执行以下操作:
    • 在名称字段中输入 uat-gateway-group-full-access。

    • 在策略编辑器字段中输入配置:

      {
      "statement": [
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/45a06edc-4a93-4bea-a437-3f153b56254c"
      ],
      "actions": [
      "<.*>"
      ],
      "effect": "allow"
      },
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/45a06edc-4a93-4bea-a437-3f153b56254c/publishedservice/<.*>"
      ],
      "actions": [
      "<.*>"
      ],
      "effect": "allow"
      }
      ]
      }
    • 点击新增。

  7. 点击 + 新增策略。
  8. 在对话框中,执行以下操作:
    • 在名称字段中输入 production-gateway-group-full-access。

    • 在策略编辑器字段中输入配置:

      {
      "statement": [
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/edc12ecd-94a5-49b2-b82d-8d1113e6cd86"
      ],
      "actions": [
      "<.*>"
      ],
      "effect": "allow"
      },
      {
      "resources": [
      "arn:api7:gateway:gatewaygroup/edc12ecd-94a5-49b2-b82d-8d1113e6cd86/publishedservice/<.*>"
      ],
      "actions": [
      "<.*>"
      ],
      "effect": "allow"
      }
      ]
      }
    • 点击新增。

定义自定义角色​

  1. 从顶部导航栏选择组织,然后选择角色。
  2. 点击 + 新增自定义角色。
  3. 在对话框中,执行以下操作:
    • 在名称字段中输入 Development Team Member。
    • 点击新增。
  4. 用相同方式创建另外两个角色 Development Team Lead 和 Test Engineer。

分配具有受控访问权限的角色​

  1. 点击 Development Team Member,进入角色页面。
  2. 点击 + 关联策略。
  3. 在对话框中,执行以下操作:
    • 在权限策略字段中选择 test-gateway-group-full-access。
    • 点击提交。这使用户只能在测试环境中进行更改。
  4. 为 Development Team Lead 分配 test-gateway-group-full-access 和 uat-gateway-group-full-access 策略。这使用户可以在测试和 UAT 环境工作,也可能包括将稳定配置从测试同步到 UAT 的能力。
  5. 为 Test Engineer 分配 uat-gateway-group-full-access 和 production-gateway-group-full-access 策略,将其访问权限限制在 UAT 和 Production 环境,专注于新 API 的测试和发布任务。

验证​

  1. 使用具有 Development Team Member 角色的账号登录 API7 企业版,该账号只能访问 Test 网关组。
  2. 使用具有 Development Team Lead 角色的账号登录 API7 企业版,该账号只能访问 Test 和 UAT 网关组。
  3. 使用具有 Test Engineer 角色的账号登录 API7 企业版,该账号只能访问 UAT 和 Production 网关组。

设置角色映射(需要 SSO)​

符合指定键值映射规则的用户将在登录时自动获分配相应角色。详情请参阅启用角色映射。

备注

角色映射优先于手动角色分配。启用角色映射后,对用户角色的任何手动调整都会在用户下次登录时被覆盖。

设置用户权限边界​

用户的有效权限由获分配角色与权限边界的交集决定。 这意味着用户的操作只有满足以下条件才会被允许:

  • 至少一个分配给用户的角色允许该操作。
  • 权限边界允许该操作(如果存在权限边界)。
  • 任何分配给用户的角色或权限边界都没有拒绝该操作。

以下以权限边界限制许可证访问为例。下面的互动演示提供操作介绍。

创建权限策略并设置权限边界​

  1. 从顶部导航栏选择组织,然后选择权限策略。
  2. 点击 + 新增策略。
  3. 在对话框中,执行以下操作:
    • 在名称字段中输入 no-access-to-license。

    • 在策略编辑器字段中输入配置:

      {
      "statement": [
      {
      "resources": [
      "arn:api7:iam:organization/*"
      ],
      "actions": [
      "iam:UpdateLicense"
      ],
      "effect": "deny"
      },
      {
      "resources": [
      "<.*>"
      ],
      "actions": [
      "<.*>"
      ],
      "effect": "allow"
      }
      ]
      }
      备注

      此策略允许访问除许可证之外的所有资源。

    • 点击新增。

  4. 从顶部导航栏选择组织,然后选择用户。
  5. 点击 + 邀请用户。
  6. 在对话框中,执行以下操作:
    • 在用户名字段中输入 Tom。
    • 为 Tom 设置一次性密码。
    • 在权限边界字段中选择 no-access-to-license。
    • 点击邀请。
  1. 点击更新角色。
  2. 在对话框中,执行以下操作:
    • 在角色字段中选择 Super Admin。
    • 点击更新。

验证​

  1. 使用 Tom 的账号登录 API7 企业版。
  2. 从顶部导航栏选择组织,然后选择许可证。
  3. 点击许可证页面的编辑图标,你将看到以下提示,表明访问被拒绝:权限被拒绝。你的角色不允许此操作。如果需要额外访问权限,请联系管理员。

设置权限边界映射(需要 SSO)​

符合指定键值映射规则的用户将在登录时自动获分配相应权限边界。详情请参阅启用权限边界映射。

备注

权限边界映射优先于手动修改权限边界。启用权限边界映射后,对用户权限边界的任何手动调整都会在用户下次登录时被覆盖。

相关阅读​