跳到主要内容
版本:3.2.14.6

设计自定义角色系统

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

关键因素​

  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/23w9q4t-ba7e-f310-a1d45b-78jklz1234",
"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 系统允许各团队创建自己的角色和权限,按需管理访问,减少对超级管理员或 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/23w9q4t-ba7e-f310-a1d45b-78jklz1234",
"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. 可以将超级管理员或 Role Manager 设计的共享角色分配给团队成员。

  3. API7 企业版支持在团队内进一步委派权限。作为 Team Lead,你可以创建关联同一权限策略的自定义角色,减轻团队负责人管理角色的负担。

委派有助于提高效率,同时也要兼顾安全。角色管理层级过多会增加整体访问控制的复杂度和管理难度。

相关阅读​