跳到主要内容
版本:3.2.14.6

更新用户角色

基于角色的访问控制(RBAC)将权限与角色关联。用户通过获授角色获得权限,从而简化访问管理、提高效率并减少错误。本指南介绍如何使用 API7 企业版的自定义角色、权限策略和权限边界管理基于角色的访问控制。

更新用户角色​

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

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

角色和权限策略共同控制访问。以下示例使用自定义角色和权限策略隔离各个环境的访问权限。

定义权限策略​

  1. 创建三个网关组:test、UAT 和 production。
  2. 从顶部导航栏选择 组织,然后选择 权限策略。
  3. 点击 + 新增策略。在 + 新增权限策略对话框中执行以下操作:
    • 在 名称字段中输入 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 必须与已创建的网关组一致。请按实际情况修改。

    • 点击 新增。

  4. 点击 + 新增策略。在 + 新增权限策略对话框中执行以下操作:
    • 在 名称字段中输入 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"
      }
      ]
      }
    • 点击 新增。

  5. 点击 + 新增策略。在 + 新增权限策略对话框中执行以下操作:
    • 在 名称字段中输入 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. 点击 + 新增自定义角色。在 + 新增自定义角色对话框中执行以下操作:
    • 在 名称字段中输入 Development Team Member。
    • 点击 新增。
  3. 用同样的方法创建 Development Team Leader 和 Test Engineer 两个角色。

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

  1. 点击 Development Team Member 进入角色页面。
  2. 点击 + 关联策略。在 关联策略对话框中执行以下操作:
    • 在 权限策略字段中选择 test-gateway-group-full-access。
    • 点击 提交。获授此角色的用户只能在测试环境中进行更改。
  3. 将 test-gateway-group-full-access 和 uat-gateway-group-full-access 策略分配给 Development Team Leader。获授该角色的用户可以在测试和 UAT 环境中工作,也可能有权将稳定的配置从测试环境同步到 UAT。
  4. 将 uat-gateway-group-full-access 和 production-gateway-group-full-access 策略分配给 Test Engineer。获授该角色的用户只能访问 UAT 和生产环境,以执行新 API 的测试和发布任务。

验证​

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

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

满足键值映射规则的用户会在登录时自动获授对应角色。详情请参阅设置角色映射。

备注

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

设置用户权限边界​

用户的有效权限由其获授的角色与权限边界的交集决定。只有满足以下条件时,用户才可以执行操作:

  • 至少一个获授的角色允许该操作。
  • 如果存在权限边界,至少一个权限边界允许该操作。
  • 所有获授的角色和权限边界均未拒绝该操作。

以下示例使用权限边界限制对许可证的访问。你可以通过下方的互动演示了解操作过程。

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

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

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

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

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

    • 点击 新增。

  3. 从顶部导航栏选择 组织,然后选择 角色。
  4. 点击 + 新增自定义角色。在 + 新增自定义角色对话框中执行以下操作:
    • 在 名称字段中输入 Test Engineer。
    • 点击 新增。
  5. 点击 + 关联策略。在 关联策略对话框中执行以下操作:
    • 在 权限策略字段中选择 no-access-to-license。
    • 点击 提交。
  6. 从顶部导航栏选择 组织,然后选择 用户。
  7. 点击 + 邀请用户。在 邀请用户对话框中执行以下操作:
    • 在 用户名字段中输入 Tom。
    • 为 Tom 设置一次性密码。
    • 在 权限边界字段中选择 no-access-to-license。
    • 点击 邀请。
  8. 点击 更新角色。在 更新角色对话框中执行以下操作:
    • 在 角色字段中选择 Test Engineer。
    • 点击 更新。

验证​

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

更新 Tom 的角色​

  1. 从顶部导航栏选择 组织,然后选择 角色。
  2. 点击 更新角色。
  3. 在 更新角色对话框中执行以下操作:
    • 在 角色字段中新增角色,选择 超级管理员。
    • 点击 更新。

验证​

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

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

满足键值映射规则的用户会在登录时自动获授对应的权限边界。详情请参阅设置权限边界映射。

备注

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

相关阅读​