角色与权限策略
本文档介绍角色和权限策略的概念,这是 API7 企业版的一项专有高级功能。
概述
角色用于定义具有特定访问级别的用户组。你可以创建自定义角色,对具有相似权限需求的用户进行分类。一个角色可以关联多个权限策略。
权限策略用于描述 API7 企业版中特定资源(例如网关组、已发布服务)所允许的操作(权限)。一个权限策略可以由多个角色共享和使用,也可以直接应用于用户,作为权限边界。
权限策略有以下两种使用方式。
- 将权限策略关联到角色,可以为不同用户组分配适当的访问级别,简化访问控制管理,并确保用户只具有执行任务所需的权限。
- 将权限策略作为边界应用于特定用户,可以定义用户允许拥有的最大权限,防止权限过度提升。
通常,用户的有效权限由所分配角色与权限边界的交集决定。
角色和权限策略工作原理
用户的操作只有同时满足以下条件才会被允许。
- 至少一个分配给用户的角色允许该操作。
- 至少一个权限边界允许该操作(如果存在权限边界)。
- 任何分配给用户的角色或权限边界都没有拒绝该操作。
假设你创建了一个名为 Gateway Group Manager 的自定义角色,并关联名为 Gateway Group Basics Actions 的权限策略。
此权限策略对全部网关组资源(资源范围为 *)授予 GetGatewayGroups 操作,允许具有 Gateway Group Manager 角色的用户在控制台查看网关组列表,直接使用 Get all gateway groups API 获取列表,或使用 ADC、API7 Ingress Controller 等 API7 工具获取列表。
另外,创建一个名为 Prohibit License Operation 的权限策略,拒绝所有与许可证相关的操作。将其应用为用户的权限边界后,无论用户获分配什么角色,都会严格限制其对许可证的访问,防止用户超出预定义权限。
以下是关键说明。
- 角色根据用户共享的权限需求对用户进行分类。修改角色关联的权限策略会影响该角色中的所有用户。
- 权限策略指定 API7 企业版(包括 API7 网关和 API7 门户)中特定资源上被允许或禁止的操作。
- 将权限策略关联到多个角色,会向这些角色中的所有用户授予相关权限。
- 权限策略可以根据需要定义得细致或宽泛。可以先使用一组基础配置,再随着访问控制需求的变化逐步细化。
- 权限边界限制用户允许拥有的最大权限,不受所分配角色的影响。用作用户权限边界的权限策略通常包含一组拒绝语句。
使用案例
内置超级管理员角色
API7 企业版最初提供一个名为 Super Admin 的预定义角色,用于初始系统设置。该角色关联内置的 super-admin-permission-policy,授予对 API7 企业版中所有操作和资源的完全访问权限。预定义角色和策略均不可编辑,以确保核心系统安全。
初始 admin 账号永久绑定 Super Admin 角色,其角色不可更改。
使用自定义角色扩展访问控制
内置角色和策略提供完全访问权限,API7 企业版也允许你创建具有细粒度权限的自定义角色。在需要广泛访问权限的场景中,还可以将 super-admin-permission-policy 关联到自定义角色。
以下以隔离环境和定制安全控制为例。
将权限策略关联到特定网关组,可以为每个环境定义细粒度安全控制。例如,相较于 Test 或 UAT 等开发环境中较宽松的设置,可以对 Production 环境实施更严格的访问限制。
- 定义细粒度权限策略
为每个网关组创建特定的权限策略,例如 test-gateway-group-full-access、uat-gateway-group-full-access 和 production-gateway-group-full-access。这些策略定义各环境中允许的操作和资源。
- 分配具有受控访问权限的角色
创建自定义角色,对具有相似访问需求的用户进行分类。 为每个角色关联适当的权限策略。
- 开发团队成员关联
test-gateway-group-full-access策略,允许他们仅在测试环境中进行更改。 - 开发团队负责人同时关联
test-gateway-group-full-access和uat-gateway-group-full-access策略,允许他们在测试和 UAT 环境工作,也可能包括将稳定配置从测试环境同步到 UAT 的能力。 - 测试工程师关联
uat-gateway-group-full-access和production-gateway-group-full-access策略,将其访问权限限制在 UAT 和 Production 环境,专注于新 API 的测试和发布任务。
防止用户越权
用户的角色可能经常变化,因此你可能需要保障权限限制的措施。例如,可以使用权限边界防止 A 部门的用户访问 B 部门拥有的资源。 权限边界也可以防止意外访问许可证或组织设置等关键系统组件。通过显式拒绝访问这些区域,可以保护敏感配置免受未经授权的修改。
如何配置权限策略
API7 企业版目前将权限策略存储为 JSON 文档。创建和编辑策略时,需要在 JSON 编辑器中定义细节,然后手动将编辑后的 JSON 代码复制回 API7 企业版进行配置。
未来版本的 API7 企业版计划提供权限策略可视化编辑器,敬请关注更新。
JSON 策略文档结构
如下例所示,JSON 策略文档包含以下元素。
// PermissionPolicy 示例
{
"statement": [
{
"resources": [
"arn:gatewaygroup:<[^:]*>" // 必填字段,可操作的资源范围,通过资源 ID 指定,可以使用通配符。本示例指全部网关组资源。
],
"actions": [
"GatewayGroup:DeleteGatewayGroup" // 必填字段,从预定义操作集合中选择允许的操作。操作应与资源类型匹配。本示例指删除网关组的操作。
],
"conditions": { // 可选字段,按标签筛选可操作的资源。本示例指具有 "Environment Type: Production" 标签的全部网关组。
"gateway_group_label": {
"type": "MatchLabel",
"options": [
{
"key": "EnvType",
"operator": "exact_match",
"value": "Production"
}
]
}
},
"effect": "allow"
}
]
}
- API7 企业版中的单个权限策略可以包含多个语句,其管理的资源或操作可以重叠。通常,同一策略中的语句为 OR 关系。如果任一语句向用户授予权限(使用 "allow"),用户就被授权在指定资源上执行相应操作。
- API7 企业版对权限策略遵循“拒绝覆盖允许”的原则。
- 对于特定角色,如果关联了多个权限策略,只要其中任一策略的任一语句定义为 "deny",其他所有关联策略中针对同一资源和操作的 "allow" 语句都会失效。
- 对于特定用户,如果任一角色或该用户的权限边界策略最终 "deny" 某个资源和操作,则无论其他角色是否允许,用户都无法在该资源上执行指定操作。
示例
假设有以下三个网关组。
- 名为 Test gateway group,具有标签
EnvType:Test、Department:A。 - 名为 Blue gateway group,具有标签
EnvType:Production、Department:B。 - 名为 Green gateway group,具有标签
EnvType:Production、Department:A。
假设用户获分配了一个关联上述示例权限策略的角色。此用户可以通过控制台或 API7 工具删除 Blue gateway group 和 Green gateway group,但无法删除 Test gateway group。
如果 Test gateway group 的标签改为 EnvType:Production,用户就可以因标签匹配而将其删除。同样,新创建的、具有 EnvType:Production 标签的 Black gateway group 也可以由该用户删除。
在权限策略条件中使用标签
在权限策略条件中使用标签代替资源 ID,有以下优点和缺点。
优点
- 动态访问控制。标签可以随时更新,资源 ID 则无法编辑。
- 可扩展性。一个标签可以应用于多个资源,简化不断增加的资源的策略管理。使用标签可以避免用户创建新资源(例如网关组)后,因为引用旧资源 ID 的权限策略未包含新资源而无法访问该资源的情况。
缺点
- 清晰度降低。标签引入了抽象层,可能使人难以一眼看出策略适用于哪些具体资源。
- 配置错误风险。不一致或不准确的标签可能导致非预期的访问授予或拒绝。
- 动态访问控制导致非预期行为。标签提供灵活性,也带来动态访问控制。用户能否访问特定资源可能随资源标签的更新而变化,与使用静态资源 ID 相比,访问行为可能更难预测。
可以采用以下方式取得适当平衡。
- 对较宽泛的访问控制类别使用标签,例如 "production"、"test"。
- 对需要细粒度控制的特定资源使用资源 ID,例如关键 API 端点的唯一 ID。
- 在整个 API 环境中使用一致且定义明确的标签规范。
了解这些权衡并实施最佳实践,可以有效利用标签来提升 API7 企业版权限策略的安全性和可管理性。
使用技巧
授予最小权限
只向用户授予在 API 环境中执行指定任务所需的最小权限。先明确定义用户和角色的需求,再创建仅包含有限操作和资源的权限策略。只有在确有必要时才增加权限,以平衡效率与强访问控制。
这样做具有以下好处。
- 缩小攻击面。限制权限可以降低账号被入侵后的潜在影响。
- 增强问责。明确的用户访问限制有助于明确归属和责任。
- 简化管理。维持最小权限可以简化权限管理,并降低意外疏漏的风险。
配置角色和权限策略的权限
与 API7 企业版中的其他资源一样,角色和权限策略本身也需要明确定义的访问控制。以下是两种常见方式。
-
集中权限管理。指定用户可以更新角色本身,并修改其关联的所有权限策略,从而集中管理两方面工作,简化流程。在此场景中,让所有权限策略都只关联一个角色,有助于简化设计。
-
分离访问控制。分别管理角色和权限策略的访问控制。这样可以在保持策略内容稳定的同时,允许角色中的用户频繁变化。
最佳方式取决于具体需求,可以考虑以下因素。
- 角色成员变更的频率
- 维持稳定策略内容的重要性