跳到主要内容
版本:3.2.14.6

角色与权限策略

本文介绍角色和权限策略的概念。这是 API7 企业版专有的高级功能。

概述​

  • 角色:定义具有特定访问级别的用户组。你可以创建自定义角色,对具有相似权限需求的用户进行分类。一个角色可以与多个权限策略相关联。
  • 权限策略:指定 API7 企业版中网关组、已发布服务等特定资源允许的操作(权限)。同一权限策略可用于多个角色,也可直接应用到用户,作为该用户的权限边界。

权限策略有两种用法。

  • 将权限策略关联到角色,为不同用户组分配合适的访问级别。这能简化访问控制,并确保用户只获得完成任务所需的权限。
  • 将权限策略用作特定用户的权限边界,设置该用户可以获得的最大权限,避免越权。

通常,用户的有效权限是其获授角色与权限边界的交集。

角色和权限策略工作原理​

用户的操作必须同时满足以下条件才会获准。

  • 至少一个授予用户的角色允许该操作。
  • 如果设置了权限边界,至少一个权限边界允许该操作。
  • 授予用户的角色和权限边界均未拒绝该操作。

假设你创建了自定义角色 Gateway Group Manager,并将权限策略 Gateway Group Basics Actions 关联到该角色。该策略允许对所有网关组资源执行 GetGatewayGroups 操作,资源范围为 *。具有该角色的用户可以在控制台查看网关组列表,也可以通过 Get all gateway groups API、ADC 或 API7 Ingress Controller 等工具查询列表。

再创建权限策略 Prohibit License Operation,拒绝所有许可证相关操作。把该策略用作用户的权限边界后,无论用户具有哪些角色,都必须遵守许可证访问限制。

关键点:

  • 角色用于根据用户的共享权限要求对用户进行分类。对角色的关联权限策略的更改将影响该角色关联的所有用户。
  • 权限策略指定 API7 企业版(包括 API7 网关和 API7 门户)中指定资源允许或禁止的操作。
  • 将权限策略关联到多个角色会将关联的权限授予这些角色中的所有用户。
  • 权限策略可以根据需要进行详细或广泛的定义。建议从基本设置开始,然后随着访问控制要求的发展对其进行细化。
  • 权限边界限定用户所能获得的最大权限,与授予用户的角色无关。用作权限边界的权限策略通常包含一组拒绝语句。

使用案例​

内置超级管理员角色​

API7 企业版在初始系统设置时提供了一个预定义的角色,名为 超级管理员。此角色与内置的 super-admin-permission-policy 相关联,该策略授予对 API7 企业版内所有操作和资源的完全访问权限。内置的角色和策略都是不可编辑的,以确保核心系统安全。

初始 admin 帐户永久绑定到 超级管理员 角色,并且其角色无法更改。

使用自定义角色扩展访问控制​

API7 企业版中还能够创建具有精细权限的自定义角色。对于需要完全访问的场景,你也可以直接将 super-admin-permission-policy 关联到你的自定义角色。

示例场景:隔离环境和定制安全性

通过将权限策略限定在特定网关组的资源范围内,你可以为每个环境定义精细的安全控制。与测试或 UAT 等开发环境中更宽松的权限设置相比,你可以在生产等环境中实施更严格的访问限制。

  1. 定义权限策略

为每个网关组创建权限策略,例如 test-gateway-group-full-access、uat-gateway-group-full-access 和 production-gateway-group-full-access。这些策略分别定义各环境允许的操作与资源。

  1. 分配角色

创建自定义角色以对具有相似访问需求的用户进行分类,然后将适当的权限策略关联到每个角色:

  • 开发团队成员:关联 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 和生产环境,以便测试和发布新的 API。

防止用户越权​

用户的角色可能经常发生变化,因此你可能需要一种保障措施来确保边界限制。 例如,权限边界可用于防止 A 部门用户访问 B 部门拥有的资源。权限边界还可用于防止意外访问关键系统组件,例如许可证或组织设置。通过明确拒绝访问这些区域,你可以维持一个强大的安全层,保护敏感配置免遭未经授权的修改。

如何配置权限策略​

API7 企业版目前以 JSON 文档存储权限策略。创建和编辑权限策略时,在 JSON 编辑器中定义策略,然后将编辑后的 JSON 手动复制回 API7 企业版进行配置。

API7 企业版计划在未来版本中提供可视化的权限策略编辑器。

JSON 策略文档结构​

JSON 策略文档包含下例所示的元素。

// PermissionPolicy 示例
{
"statement": [
{
"resources": [
"arn:gatewaygroup:<[^:]*>" // 必填字段,指定可操作的资源 ID 范围,支持通配符。本例指所有网关组资源。
],
"actions": [
"GatewayGroup:DeleteGatewayGroup" // 必填字段,从预定义操作中选择与资源类型匹配的允许操作。本例指删除网关组的操作。
],

"conditions": { // 可选字段,按标签筛选可操作的资源。本例指所有带 EnvType:Production 标签的网关组。
"gateway_group_label": {
"type": "MatchLabel",
"options": [
{
"key": "EnvType",
"operator": "exact_match",
"value": "Production"
}
]
}
},
"effect": "allow"
}
]
}
  • API7 企业版中的单个权限策略可以包含多条语句,这些语句定义的资源和操作可以重叠。通常,策略中的语句是逻辑或关系。只要有一条语句对用户给出了 allow,该用户就可以对指定资源执行对应操作。
  • API7 企业版对权限策略执行“拒绝覆盖允许”的原则。
    • 对某个具体角色来说,如果关联了多个权限策略,只要有任意一个策略中有任意一个语句(Statement)定义为“拒绝”(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 相比,这可能会导致访问行为更不可预测。

找到合适的平衡:

  • 标签适用较宽泛的分类:将标签用于更宽泛的访问控制类别(例如,“生产”、“测试”)。
  • 细粒度控制使用资源 ID:对需要细粒度控制的特定资源使用资源 ID,例如关键 API 端点的唯一 ID。
  • 清晰的标签规划:确保在整个 API 环境中保持一致且定义明确的标签定义。

通过了解这些利弊并实施最佳实践,你可以有效地利用标签来增强 API7 企业版权限策略的安全性和可管理性。

使用技巧​

授予最小权限​

仅授予用户在 API 环境中执行指定任务所需的最小权限。为了实现这一点,首先要明确定义用户和角色的需求。然后,制定具有一组受限操作和资源的权限策略。最后,仅在绝对必要时添加更多权限,确保管理效率和强访问控制之间的平衡。

优点:

  • 缩小攻击面:限制权限可减少账户遭入侵后的潜在影响。
  • 增强问责制:明确的用户访问限制可促进更好的所有权和责任感。
  • 简化管理:维护最小权限简化了权限管理并降低了意外疏忽的风险。

配置角色和权限策略的权限​

与 API7 企业版中的其他资源一样,角色和权限策略本身也需要明确定义的访问控制。以下是两种常用方法:

  1. 集中管理:指定用户可以更新角色及其关联的所有权限策略。统一管理这两类资源可简化工作流程。将权限策略都只关联到该角色有助于简化设计。

  2. 分开管理:分别设置角色和权限策略的访问控制。这适用于角色成员经常变化,而权限策略内容需要保持稳定的情况。

最佳方法取决于你的具体需求。考虑以下因素来进行抉择:

  • 角色成员变更的频率
  • 维持稳定角色和策略内容的必要性

相关阅读​