更新用户角色
基于角色的访问控制(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 Lead和Test Engineer。
分配具有受控访问权限的角色
- 点击
Development Team Member,进入角色页面。 - 点击 + 关联策略。
- 在对话框中,执行以下操作:
- 在权限策略字段中选择
test-gateway-group-full-access。 - 点击提交。这使用户只能在测试环境中进行更改。
- 在权限策略字段中选择
- 为
Development Team Lead分配test-gateway-group-full-access和uat-gateway-group-full-access策略。这使用户可以在测试和 UAT 环境工作,也可能包括将稳定配置从测试同步到 UAT 的能力。 - 为
Test Engineer分配uat-gateway-group-full-access和production-gateway-group-full-access策略,将其访问权限限制在 UAT 和 Production 环境,专注于新 API 的测试和发布任务。
验证
- 使用具有
Development Team Member角色的账号登录 API7 企业版,该账号只能访问Test网关组。 - 使用具有
Development Team Lead角色的账号登录 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"}]}备注此策略允许访问除许可证之外的所有资源。
-
点击新增。
-
- 从顶部导航栏选择组织,然后选择用户。
- 点击 + 邀请用户。
- 在对话框中,执行以下操作:
- 在用户名字段中输入
Tom。 - 为 Tom 设置一次性密码。
- 在权限边界字段中选择
no-access-to-license。 - 点击邀请。
- 在用户名字段中输入
- 点击更新角色。
- 在对话框中,执行以下操作:
- 在角色字段中选择
Super Admin。 - 点击更新。
- 在角色字段中选择
验证
- 使用 Tom 的账号登录 API7 企业版。
- 从顶部导航栏选择组织,然后选择许可证。
- 点击许可证页面的编辑图标,你将看到以下提示,表明访问被拒绝:权限被拒绝。你的角色不允许此操作。如果需要额外访问权限,请联系管理员。
设置权限边界映射(需要 SSO)
符合指定键值映射规则的用户将在登录时自动获分配相应权限边界。详情请参阅启用权限边界映射。
备注
权限边界映射优先于手动修改权限边界。启用权限边界映射后,对用户权限边界的任何手动调整都会在用户下次登录时被覆盖。
相关阅读
- 核心概念
- 快速入门
- 最佳实践