更新用户角色
基于角色的访问控制(RBAC)将权限与角色关联。用户通过获授角色获得权限,从而简化访问管理、提高效率并减少错误。本指南介绍如何使用 API7 企业版的自定义角色、权限策略和权限边界管理基于角色的访问控制。
更新用户角色
- 从顶部导航栏选择 组织,然后选择 用户。
- 点击目标用户的 更新角色。
- 添加或删除角色。
- 点击 更新。
备注
要查看各个角色的权限,请从顶部导航栏选择 组织,然后选择 角色。
角色和权限策略共同控制访问。以下示例使用自定义角色和权限策略隔离各个环境的访问权限。
定义权限策略
- 创建三个网关组:
test、UAT和production。 - 从顶部导航栏选择 组织,然后选择 权限策略。
- 点击 + 新增策略。在 + 新增权限策略对话框中执行以下操作:
-
在 名称字段中输入
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 必须与已创建的网关组一致。请按实际情况修改。
-
点击 新增。
-
- 点击 + 新增策略。在 + 新增权限策略对话框中执行以下操作:
-
在 名称字段中输入
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"}]} -
点击 新增。
-
- 点击 + 新增策略。在 + 新增权限策略对话框中执行以下操作:
-
在 名称字段中输入
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"}]} -
点击 新增。
-
定义自定义角色
- 从顶部导航栏选择 组织,然后选择 角色。
- 点击 + 新增自定义角色。在 + 新增自定义角色对话框中执行以下操作:
- 在 名称字段中输入
Development Team Member。 - 点击 新增。
- 在 名称字段中输入
- 用同样的方法创建
Development Team Leader和Test Engineer两个角色。
分配具有受控访问权限的角色
- 点击
Development Team Member进入角色页面。 - 点击 + 关联策略。在 关联策略对话框中执行以下操作:
- 在 权限策略字段中选择
test-gateway-group-full-access。 - 点击 提交。获授此角色的用户只能在测试环境中进行更改。
- 在 权限策略字段中选择
- 将
test-gateway-group-full-access和uat-gateway-group-full-access策略分配给Development Team Leader。获授该角色的用户可以在测试和 UAT 环境中工作,也可能有权将稳定的配置从测试环境同步到 UAT。 - 将
uat-gateway-group-full-access和production-gateway-group-full-access策略分配给Test Engineer。获授该角色的用户只能访问 UAT 和生产环境,以执行新 API 的测试和发布任务。
验证
- 使用具有
Development Team Member角色的账号登录 API7 企业版,确认只能访问Test网关组。 - 使用具有
Development Team Leader角色的账号登录 API7 企业版,确认只能访问Test和UAT网关组。 - 使用具有
Test Engineer角色的账号登录 API7 企业版,确认只能访问UAT和Production网关组。
设置角色映射(需要 SSO)
满足键值映射规则的用户会在登录时自动获授对应角色。详情请参阅设置角色映射。
备注
角色映射优先于手动分配角色。启用角色映射后,用户下次登录时,对其角色的所有手动调整都会被覆盖。
设置用户权限边界
用户的有效权限由其获授的角色与权限边界的交集决定。只有满足以下条件时,用户才可以执行操作:
- 至少一个获授的角色允许该操作。
- 如果存在权限边界,至少一个权限边界允许该操作。
- 所有获授的角色和权限边界均未拒绝该操作。
以下示例使用权限边界限制对许可证的访问。你可以通过下方的互动演示了解操作过程。
创建权限策略并设置权限边界
- 从顶部导航栏选择 组织,然后选择 权限策略。
- 点击 + 新增策略。在 + 新增权限策略对话框中执行以下操作:
-
在 名称字段中输入
no-access-to-license。 -
在 策略编辑器字段中输入以下配置:
{"statement": [{"resources": ["arn:api7:iam:organization/*"],"actions": ["iam:UpdateLicense"],"effect": "deny"},{"resources": ["<.*>"],"actions": ["<.*>"],"effect": "allow"}]}备注此策略允许访问除许可证之外的所有资源。
-
点击 新增。
-
- 从顶部导航栏选择 组织,然后选择 角色。
- 点击 + 新增自定义角色。在 + 新增自定义角色对话框中执行以下操作:
- 在 名称字段中输入
Test Engineer。 - 点击 新增。
- 在 名称字段中输入
- 点击 + 关联策略。在 关联策略对话框中执行以下操作:
- 在 权限策略字段中选择
no-access-to-license。 - 点击 提交。
- 在 权限策略字段中选择
- 从顶部导航栏选择 组织,然后选择 用户。
- 点击 + 邀请用户。在 邀请用户对话框中执行以下操作:
- 在 用户名字段中输入
Tom。 - 为 Tom 设置一次性密码。
- 在 权限边界字段中选择
no-access-to-license。 - 点击 邀请。
- 在 用户名字段中输入
- 点击 更新角色。在 更新角色对话框中执行以下操作:
- 在 角色字段中选择
Test Engineer。 - 点击 更新。
- 在 角色字段中选择
验证
- 使用 Tom 的账号登录 API7 企业版。
- 从顶部导航栏选择 组织,然后选择 许可证。
- 点击许可证页面的编辑图标。页面会显示访问被拒绝的提示:权限被拒绝。你的角色不允许此操作。如果需要额外的访问权限,请联系管理员。
更新 Tom 的角色
- 从顶部导航栏选择 组织,然后选择 角色。
- 点击 更新角色。
- 在 更新角色对话框中执行以下操作:
- 在 角色字段中新增角色,选择
超级管理员。 - 点击 更新。
- 在 角色字段中新增角色,选择
验证
- 使用 Tom 的账号登录 API7 企业版。
- 从顶部导航栏选择 组织,然后选择 许可证。
- 点击许可证页面的编辑图标。页面会显示访问被拒绝的提示:权限被拒绝。你的角色不允许此操作。如果需要额外的访问权限,请联系管理员。
设置权限边界映射(需要 SSO)
满足键值映射规则的用户会在登录时自动获授对应的权限边界。详情请参阅设置权限边界映射。
备注
权限边界映射优先于手动修改权限边界。启用权限边界映射后,用户下次登录时,对其权限边界的所有手动调整都会被覆盖。