身份策略授权参考
云服务在IAM预置了常用的权限,称为系统身份策略。如果IAM系统身份策略无法满足授权要求,管理员可以根据各服务支持的授权项,创建IAM自定义身份策略来进行精细的访问控制,IAM自定义身份策略是对系统身份策略的扩展和补充。
除IAM服务外,Organizations服务中的服务控制策略(Service Control Policy,以下简称SCP)也可以使用这些授权项元素设置访问控制策略。
SCP不直接进行授权,只划定权限边界。将SCP绑定到组织单元或者成员账号时,并没有直接对组织单元或成员账号授予操作权限,而是规定了成员账号或组织单元包含的成员账号的授权范围。IAM身份策略授予权限的有效性受SCP限制,只有在SCP允许范围内的权限才能生效。
IAM服务与Organizations服务在使用这些元素进行访问控制时,存在着一些区别,详情请参见:IAM服务与Organizations服务权限访问控制的区别。
本章节介绍IAM服务身份策略授权场景中自定义身份策略和组织服务中SCP使用的元素,这些元素包含了操作(Action)、资源(Resource)和条件(Condition)。
操作(Action)
操作(Action)即为身份策略中支持的授权项。
- “访问级别”列描述如何对操作进行分类(List、Read和Write等)。此分类可帮助您了解在身份策略中相应操作对应的访问级别。
- “资源类型”列指每个操作是否支持资源级权限。
- 资源类型支持通配符号*表示所有。如果此列没有值(-),则必须在身份策略语句的Resource元素中指定所有资源类型(“*”)。
- 如果该列包含资源类型,则必须在具有该操作的语句中指定该资源的URN。
- 资源类型列中必需资源在表中用星号(*)标识,表示使用此操作必须指定该资源类型。
关于eg定义的资源类型的详细信息请参见资源类型(Resource)。
- “条件键”列包括了可以在身份策略语句的Condition元素中支持指定的键值。
- 如果该授权项资源类型列存在值,则表示条件键仅对列举的资源类型生效。
- 如果该授权项资源类型列没有值(-),则表示条件键对整个授权项生效。
- 如果此列条件键没有值(-),表示此操作不支持指定条件键。
关于eg定义的条件键的详细信息请参见条件(Condition)。
- “别名”列包括了可以在身份策略中配置的策略授权项。通过这些授权项,可以控制支持策略授权的API访问。详细信息请参见身份策略兼容性说明。
您可以在身份策略语句的Action元素中指定以下eg的相关操作。
| 授权项 | 描述 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 |
|---|---|---|---|---|---|
| eg:subscriptions:createSubscription | 授予权限以创建订阅。 | Write | subscriptions * | - | eg:subscriptions:create |
| - | |||||
| eg:subscriptions:list | 授予权限以查询订阅列表。 | List | subscriptions * | - | - |
| eg:subscriptions:updateSubscription | 授予权限以更新订阅。 | Write | subscriptions * | eg:subscriptions:update | |
| eg:subscriptions:getSubscription | 授予权限以查询订阅详情。 | Read | subscriptions * | eg:subscriptions:get | |
| eg:subscriptions:deleteSubscription | 授予权限以删除订阅。 | Write | subscriptions * | eg:subscriptions:delete | |
| eg:subscriptions:operate | 授予权限以操作订阅。 | Write | subscriptions * | - | |
| eg:channels:create | 授予权限以创建通道。 | Write | channels * | - | - |
| - | |||||
| eg:channels:list | 授予权限以查询通道列表。 | List | channels * | - | - |
| eg:channels:update | 授予权限以更新通道。 | Write | channels * | - | |
| eg:channels:getChannel | 授予权限以查询通道详情。 | Read | channels * | eg:channels:get | |
| eg:channels:delete | 授予权限以删除通道。 | Write | channels * | - | |
| eg:event:getEventTrace | 授予权限以查询事件轨迹详情。 | Read | - | - | eg:sources:get |
| eg:event:getEvent | 授予权限以查询事件详情。 | Read | - | - | eg:sources:get |
| eg:event:list | 授予权限以查询事件列表。 | List | - | - | eg:sources:list |
| eg:channels:putEvents | 授予权限以发布事件。 | Write | channels * | - | |
| eg:event:check | 授予权限以校验发布事件。 | Write | - | - | eg:channels:get |
| eg:sources:create | 授予权限以创建事件源。 | Write | - | - | - |
| eg:sources:listSources | 授予权限以查询事件源列表。 | List | sources * | - | eg:sources:list |
| eg:sources:update | 授予权限以更新事件源。 | Write | sources * | - | |
| eg:sources:getSource | 授予权限以查询事件源详情。 | Read | sources * | eg:sources:get | |
| eg:sources:delete | 授予权限以删除事件源。 | Write | sources * | - | |
| eg:targetCatalogs:list | 授予权限以查询事件目标列表。 | List | - | - | - |
| eg:schemas:discover | 授予权限以发现事件模型。 | Write | - | - | - |
| eg:schemas:create | 授予权限以创建事件模型。 | Write | - | - | - |
| eg:schemas:list | 授予权限以查询事件模型列表。 | List | - | - | - |
| eg:schemas:update | 授予权限以更新事件模型。 | Write | - | - | - |
| eg:schemas:getSchema | 授予权限以查询事件模型详情。 | Read | - | - | eg:schemas:get |
| eg:schemas:delete | 授予权限以删除事件模型。 | Write | - | - | - |
| eg:schemas:createVersion | 授予权限以创建事件模型版本。 | Write | - | - | - |
| eg:schemas:listVersions | 授予权限以查询事件模型版本列表。 | List | - | - | eg:schemas:get |
| eg:schemas:getVersion | 授予权限以查询事件模型版本详情。 | Read | - | - | - |
| eg:schemas:deleteVersion | 授予权限以删除事件模型版本。 | Write | - | - | - |
| eg:connections:create | 授予权限以创建目标连接。 | Write | connections * | - | - |
| eg:connections:list | 授予权限以查询目标连接列表。 | List | connections * | - | - |
| eg:connections:update | 授予权限以更新目标连接。 | Write | connections * | - | |
| eg:connections:get | 授予权限以查询目标连接详情。 | Read | connections * | - | |
| eg:connections:delete | 授予权限以删除目标连接。 | Write | connections * | - | |
| eg:quota:listQuotas | 授予权限以查询配额列表。 | List | - | - | eg:quota:list |
| eg:apiVersion:list | 授予权限以查询API版本。 | List | - | - | - |
| eg:endpoints:update | 授予权限以更新访问端点。 | Write | endpoints * | - | |
| eg:endpoints:delete | 授予权限以删除访问端点。 | Write | endpoints * | - | |
| eg:endpoints:create | 授予权限以创建访问端点。 | Write | endpoints * | - | - |
| eg:endpoints:list | 授予权限以查询访问端点列表。 | List | endpoints * | - | - |
| eg::replaceObsNotification | 授予权限以替换OBS的FG通知为EG通知。 | Write | - | - | eg:subscriptions:create |
| eg:pubMetrics:list | 授予权限以查询通道监控指标。 | List | - | - | - |
| eg:subMetrics:list | 授予权限以查询订阅监控指标。 | List | - | - | - |
| eg:samples:list | 授予权限以查询事件示例列表。 | List | - | - | - |
| eg:eventStreaming:create | 授予权限以创建事件流。 | Write | - | - | eg:subscriptions:create |
| eg:eventStreaming:list | 授予权限以查询事件流列表。 | List | eventStreaming * | - | eg:sources:list |
| eg:eventStreaming:update | 授予权限以更新事件流。 | Write | eventStreaming * | eg:subscriptions:update | |
| eg:eventStreaming:get | 授予权限以查询事件流详情。 | Read | eventStreaming * | eg:subscriptions:get | |
| eg:eventStreaming:delete | 授予权限以删除事件流。 | Write | eventStreaming * | eg:subscriptions:delete | |
| eg:eventStreaming:operate | 授予权限以操作事件流。 | Write | eventStreaming * | eg:subscriptions:update | |
| eg:feature:list | 授予权限以查询支持的特性列表。 | List | - | - | eg:quota:list |
| eg:erjobs:create | 授予权限以创建专业版事件流作业。 | Write | erjobs * | - | - |
| eg:erjobs:list | 授予权限以查询专业版事件流作业列表。 | List | erjobs * | - | - |
| eg:erjobs:delete | 授予权限以删除专业版事件流作业。 | Write | erjobs * | - | - |
| eg:erjobs:getJob | 授予权限以查询专业版事件流作业详情。 | Read | erjobs * | - | eg:erjobs:get |
| eg:erjobs:update | 授予权限以更新专业版事件流作业。 | Write | erjobs * | - | - |
| eg:erjobs:operate | 授予权限以操作专业版事件流作业。 | Write | erjobs * | - | - |
| eg:erjobs:validate | 授予权限以校验专业版事件流作业。 | Write | erjobs * | - | - |
| eg:erjobs:getSyncDetail | 授予权限以查询专业版事件流作业同步详情。 | Read | erjobs * | - | eg:erjobs:get |
| eg:erclusters:getAvailabilityZone | 授予权限以查询可用区。 | Read | - | - | eg:erclusters:list |
| eg:erclusters:create | 授予权限以创建专业版事件流集群。 | Write | erclusters * | - | - |
| eg:erclusters:listClusters | 授予权限以查询专业版事件流集群列表。 | List | erclusters * | - | eg:erclusters:list |
| eg:erclusters:delete | 授予权限以删除专业版事件流集群。 | Write | erclusters * | - | - |
| eg:erclusters:get | 授予权限以查询专业版事件流集群详情。 | Read | erclusters * | - | - |
| eg:erclusters:update | 授予权限以更新专业版事件流集群。 | Write | erclusters * | - | - |
eg的API通常对应着一个或多个授权项。表2展示了API与授权项的关系,以及该API需要依赖的授权项。
| API | 对应的授权项 | 依赖的授权项 |
|---|---|---|
| eg:subscriptions:createSubscription | - | |
| eg:subscriptions:list | - | |
| eg:subscriptions:updateSubscription | - | |
| eg:subscriptions:getSubscription | - | |
| eg:subscriptions:deleteSubscription | - | |
| PUT /v1/{project_id}/subscriptions/{subscription_id}/sources/{source_id} | eg:subscriptions:updateSubscription | - |
| POST /v1/{project_id}/subscriptions/{subscription_id}/targets | eg:subscriptions:updateSubscription | - |
| PUT /v1/{project_id}/subscriptions/{subscription_id}/targets/{target_id} | eg:subscriptions:updateSubscription | - |
| GET /v1/{project_id}/subscriptions/{subscription_id}/targets/{target_id} | eg:subscriptions:getSubscription | - |
| DELETE /v1/{project_id}/subscriptions/{subscription_id}/targets/{target_id} | eg:subscriptions:updateSubscription | - |
| eg:subscriptions:operate | - | |
| eg:channels:create | - | |
| eg:channels:list | - | |
| eg:channels:update | - | |
| eg:channels:getChannel | - | |
| eg:channels:delete | - | |
| eg:event:getEventTrace | - | |
| eg:event:getEvent | - | |
| eg:event:list | - | |
| eg:channels:putEvents | - | |
| eg:event:check | - | |
| eg:sources:create | - | |
| eg:sources:listSources | - | |
| eg:sources:update | - | |
| eg:sources:getSource | - | |
| eg:sources:delete | - | |
| eg:targetCatalogs:list | - | |
| eg:schemas:discover | - | |
| eg:schemas:create | - | |
| eg:schemas:list | - | |
| eg:schemas:update | - | |
| eg:schemas:getSchema | - | |
| eg:schemas:delete | - | |
| eg:schemas:createVersion | - | |
| eg:schemas:listVersions | - | |
| eg:schemas:getVersion | - | |
| DELETE /v1/{project_id}/schemas/{schema_id}/versions/{version} | eg:schemas:deleteVersion | - |
| eg:connections:create | - | |
| eg:connections:list | - | |
| eg:connections:update | - | |
| eg:connections:get | - | |
| eg:connections:delete | - | |
| eg:quota:listQuotas | - | |
| eg:apiVersion:list | - | |
| eg:subscriptions:list | - | |
| GET /v1/{project_id}/subscription-triggers/workflow/{workflow_id} | eg:subscriptions:list | - |
| eg:endpoints:update | - | |
| eg:endpoints:delete | - | |
| eg:endpoints:create | - | |
| eg:endpoints:list | - | |
| POST /v1/{project_id}/subscriptions/obsbuckets/{bucket_name}/refurbishobs | eg::replaceObsNotification | - |
| - | eg:pubMetrics:list | - |
| - | eg:subMetrics:list | - |
| eg:samples:list | - | |
| eg:eventStreaming:create | - | |
| eg:eventStreaming:list | - | |
| eg:eventStreaming:update | - | |
| eg:eventStreaming:get | - | |
| eg:eventStreaming:delete | - | |
| POST /v1/{project_id}/eventstreamings/operate/{eventstreaming_id} | eg:eventStreaming:operate | - |
| - | eg:feature:list | - |
| eg:erjobs:create | - | |
| eg:erjobs:list | - | |
| eg:erjobs:delete | - | |
| eg:erjobs:getJob | - | |
| eg:erjobs:update | - | |
| eg:erjobs:operate | - | |
| eg:erjobs:validate | - | |
| eg:erjobs:getSyncDetail | - | |
| eg:erclusters:getAvailabilityZone | - | |
| eg:erclusters:create | - | |
| eg:erclusters:listClusters | - | |
| eg:erclusters:delete | - | |
| eg:erclusters:get | - | |
| eg:erclusters:update | - | |
| eg:erjobs:operate | - |
资源类型(Resource)
资源类型(Resource)用于定义身份策略生效的资源范围。如表3中某项操作已指定了对应的资源类型,则在包含该操作的身份策略语句中选择填写对应资源的URN时,身份策略仅对该指定资源生效;未填写对应资源的URN时,身份策略将对指定资源类型下所有资源生效;如未指定资源类型,Resource默认取值为“*”,身份策略将作用于所有资源。此外,您也可在身份策略中设置条件,进一步精细化限定资源类型。
eg定义了以下可以在自定义身份策略的Resource元素中使用的资源类型。
| 资源类型 | URN |
|---|---|
| sources | eg:<region>:<account-id>:sources:<source-id> |
| erclusters | eg:<region>:<account-id>:erclusters:<cluster-id> |
| connections | eg:<region>:<account-id>:connections:<connection-id> |
| eventStreaming | eg:<region>:<account-id>:eventStreaming:<eventStreaming-id> |
| endpoints | eg:<region>:<account-id>:endpoints:<endpoint-id> |
| channels | eg:<region>:<account-id>:channels:<channel-id> |
| subscriptions | eg:<region>:<account-id>:subscriptions:<subscription-id> |
| erjobs | eg:<region>:<account-id>:erjobs:<job-id> |
条件(Condition)
条件键概述
条件(Condition)是身份策略生效的特定条件,包括条件键和运算符。
- 条件键表示身份策略语句的Condition元素中的键值。根据适用范围,分为全局级条件键和服务级条件键。
- 全局级条件键(前缀为g:)适用于所有操作,在鉴权过程中,云服务不需要提供用户身份信息,系统将自动获取并鉴权。详情请参见:全局条件键。
- 服务级条件键(前缀通常为服务缩写,如eg:)仅适用于对应服务的操作,详情请参见表4。
- 单值/多值表示API调用时请求中与条件关联的值数。单值条件键在API调用时的请求中最多包含一个值,多值条件键在API调用时请求可以包含多个值。例如:g:SourceVpce是单值条件键,表示仅允许通过某个VPC终端节点发起请求访问某资源,一个请求最多包含一个VPC终端节点ID值。g:TagKeys是多值条件键,表示请求中携带的所有标签的key组成的列表,当用户在调用API请求时传入标签可以传入多个值。
- 运算符与条件键、条件值一起构成完整的条件判断语句,当请求信息满足该条件时,身份策略才能生效。支持的运算符请参见:运算符。
eg支持的服务级条件键
eg定义了以下可以在自定义身份策略的Condition元素中使用的条件键,您可以使用这些条件键进一步细化身份策略语句应用的条件。