权限策略和权限边界
API7 网关通过权限策略和权限边界实现细粒度访问控制。二者都使用相同语法的 JSON 文档表达,并会在处理请求时进行评估,以决定是否允许对特定资源执行特定操作。
本页记录控制面接受的确切 JSON 结构。完整的允许操作和资源目录请参阅权限策略操作和资源。可直接复用和调整的示例请参阅权限策略示例。
概念
- 权限策略:定义一组
statement语句的 JSON 文档。每个语句允许或拒绝对特定资源执行特定操作,并可选地受条件约束。权限策略可以附加到一个或多个角色。 - 权限边界:直接应用于用户的权限策略。用户的有效权限是其角色权限与权限边界的交集:只有当用户角色允许且权限边界也允许时,某个操作才会被允许。权限边界是安全委派的主要机制,例如允许团队负责人管理本部门用户,但不允许其提升权限。
策略文档结构
权限策略通过 Admin API 向 /api/permission_policies 发送包含 PermissionPolicy 对象的 POST 请求来创建。顶层对象包含以下字段:
| 字段 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
name | 字符串 | 是 | 策略的人类可读名称。 |
desc | 字符串 | 否 | 描述该策略授予的权限。 |
labels | map[string]string | 否 | 附加到策略自身的标签,用于组织和过滤。 |
policy_document | 对象 | 是 | 实际策略规则,封装在 policy_document 对象中。 |
policy_document 对象包含单个 statement 字段,该字段保存一个语句数组:
{
"name": "production-readonly",
"desc": "Read-only access to production gateway groups.",
"labels": {
"team": "sre",
"env": "production"
},
"policy_document": {
"statement": [
{
"effect": "allow",
"resources": [
"arn:api7:gateway:gatewaygroup/<.*>"
],
"actions": [
"<.*>Get<.*>"
],
"conditions": {
"gateway_group_label": {
"type": "MatchLabel",
"options": {
"key": "env",
"operator": "exact_match",
"value": "production"
}
}
}
}
]
}
}