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

设计自定义角色系统

本教程介绍如何为组织设计和实现自定义角色系统。自定义角色允许你为用户授予细粒度访问权限,从而增强安全性并提高数据完整性。

关键因素​

  1. 明确需求和目标

首先,明确定义设计自定义角色系统的具体需求和目标。 例如,你希望提高应用程序安全性、简化访问控制管理,还是满足更复杂的访问控制需求? 明确需求可以帮助你更好地定义角色和权限,并选择合适的实现方式。

  1. 合理划分角色

根据应用程序功能和用户职责合理划分角色,确保粒度适当。避免角色划分过细导致管理复杂,或划分过粗而缺乏足够的权限控制。

  1. 明确定义权限

每个角色都应有明确的权限定义。权限定义应清晰易懂,并与角色职责一致。避免向同一角色授予过多或无关的权限。

在不同角色中复用权限策略可能是一把双刃剑。它有助于简化配置和管理,但处理不当也可能带来安全风险。如果复用策略的安全性受到破坏,可能影响所有继承该策略的角色,进而导致对多个资源的未授权访问,扩大安全事件的潜在损害。过于宽泛的策略也会使最小权限原则难以落实,让用户获得超出实际需要的访问权限。

  1. 清晰的层级和可扩展性

易于使用的自定义角色系统应具有较高的可扩展性,并能适应未来需求。这样可以分离为用户分配适当角色的职责。通过定制角色和权限策略满足部门需求,可以减少日常权限管理对单个“超级管理员”的依赖。也可以由组长在团队内部为成员分配角色和权限,实现细粒度控制,并尽量减少对其他团队的影响。

使用案例​

通常,API7 企业版建议审慎管理团队内的角色。大多数场景可以使用团队负责人角色;只有在存在明确需求并经过全面安全审查时,才考虑创建更小范围的负责人角色。

团队特定访问控制​

假设你需要一个 RBAC 系统,能够管理跨团队共享且职责稳定的角色,例如“测试工程师”和“开发工程师”。但在以下情况下,管理可能面临挑战。

  • 团队成员经常变化:新成员加入,或团队成员因调整而变更角色。
  • 存在团队特定职责:每个团队可能有独特的工作流或职责,需要细粒度访问控制。
  • 用户可见性有限:用户可能不熟悉其他团队的同事。

解决方案​

  1. 超级管理员和具有 Role Manager 自定义角色的用户(授予以下权限)负责维护 API7 企业版中的所有角色:
{
"statement": [ // 同一策略中的多个语句为 OR 关系。
{
"resources": [
"arn:api7:iam:user/<.*>"
],
"actions": [
"<.*>"
],
"effect": "allow"
},
{
"resources": [
"arn:api7:iam:role/<.*>" // 除超级管理员以外的所有角色
],
"actions": [
"<.*>"
],
"effect": "allow"
},
{
"resources": [
"arn:api7:iam:permissionpolicy/<.*>" // 除 super-admin-permission-policy 以外的所有权限策略
],
"actions": [
"<.*>"
],
"effect": "allow"
}
]
}
  1. 创建具有以下权限的自定义角色 Team Lead。获分配此角色的用户负责管理其特定团队内的角色。
{
"statement": [
{
"resources": [
"arn:api7:iam:users/23w9q4t-ba7e-f310-a1d45b-78jklz1234", // 所有团队成员的用户 ID
"arn:api7:iam:users/n5p1u6y-0df3-4a5b-c90fe1-32kasd789b",

"arn:api7:iam:users/gt8h2x3-1fe4-5678-d21b0a-98zxc1b546",
"arn:api7:iam:users/y7u8i9o-pasd-fghj-123456-7klmnop12"
],
"actions": [ // 包含团队管理所需的全部操作,不包括邀请用户。
"iam:GetUser",
"iam:UpdateUserRole",
"iam:ResetPassword",
"iam:DeleteUser"
],
"effect": "allow"
}
]
}

团队特定角色设计​

通过支持团队特定角色和权限创建的模块化 RBAC 系统,每个团队可以管理自身的访问需求,减少对 Super Admin 或 Role Manager 的依赖。

解决方案​

  1. 创建自定义角色 Team Lead,并关联以下两个权限策略。获分配此角色的用户负责设计和管理其特定团队内的角色。

权限策略 1 用于为团队成员分配角色:

{
"statement": [
{
"resources": [
"arn:api7:iam:users/23w9q4t-ba7e-f310-a1d45b-78jklz1234", // 所有团队成员的用户 ID
"arn:api7:iam:users/n5p1u6y-0df3-4a5b-c90fe1-32kasd789b",

"arn:api7:iam:users/gt8h2x3-1fe4-5678-d21b0a-98zxc1b546",
"arn:api7:iam:users/y7u8i9o-pasd-fghj-123456-7klmnop12"
],
"actions": [ // 包含团队管理所需的全部操作,不包括邀请用户
"iam:GetUser",
"iam:UpdateUserRole",
"iam:ResetPassword",
"iam:DeleteUser"
],
"effect": "allow"
}
]
}

权限策略 2 用于为团队创建自定义角色和权限策略:

{
"statement": [
{
"resources": [
"arn:api7:iam:role/<.*>",
],
"actions": [ // 包含角色管理所需的全部操作
"<.*>"
],
"conditions": {
"role_label": {
"type": "MatchLabel",
"options": {
"key": "team",
"operation": "exact_match",
"value": "champion"
}
}
},
"effect": "allow"
},
{
"resources": [
"arn:api7:iam:permissionpolicy/<.*>"
],
"actions": [ // 包含权限策略管理所需的全部操作
"<.*>"
],
"conditions": {
"permissionpolicy_label": {
"type": "MatchLabel",
"options": {
"key": "team",
"operation": "exact_match",
"value": "champion"
}
}
},
"effect": "allow"
}
]
}
  1. 作为 Team Lead,始终在你创建的资源中添加团队指定的标签,以确保角色和权限策略具有适当的访问控制。

  2. 你也可以使用由 Super Admin 或 Role Manager 设计的共享角色,并将其分配给团队成员。

  3. API7 企业版允许在团队内部进一步委派权限。作为 Team Lead,你甚至可以创建一个关联相同权限策略的自定义角色。这种方式可以显著减轻团队负责人管理角色的负担。

委派权限有助于提高效率,但必须兼顾安全。过多的角色管理层级会增加复杂性,并使整体访问控制更难管理。

相关阅读​