Amazon CodePipeline 如何与 IAM 协同工作 - Amazon CodePipeline
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Amazon CodePipeline 如何与 IAM 协同工作

在使用 IAM 管理对 CodePipeline 的访问之前,您应了解哪些 IAM 功能可与 CodePipeline 结合使用。要大致了解 CodePipeline 和其他 Amazon Web Services 服务 如何与 IAM 一起使用,请参阅 IAM 用户指南 中的与 IAM 一起使用的Amazon Web Services 服务

CodePipeline 基于身份的策略

通过使用 IAM 基于身份的策略,您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。CodePipeline 支持特定的操作、资源和条件键。要了解在 JSON 策略中使用的所有元素,请参阅《IAM 用户指南》 中的 IAM JSON 策略元素参考

操作

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。在策略中包含操作以授予执行关联操作的权限。

CodePipeline 中的策略操作在操作前面使用以下前缀:codepipeline:

例如,要授予某人查看账户中现有管道的权限,您可以在其策略中包括 codepipeline:GetPipeline 操作。策略语句必须包含 ActionNotAction 元素。CodePipeline 定义了一组自己的操作,以描述您可以使用该服务执行的任务。

要在单个语句中指定多项操作,请使用逗号将它们隔开,如下所示:

"Action": [ "codepipeline:action1", "codepipeline:action2"

您也可以使用通配符 (*) 指定多个操作。例如,要指定以单词 Get 开头的所有操作,包括以下操作:

"Action": "codepipeline:Get*"

有关 CodePipeline 操作的列表,请参阅 IAM 用户指南 中的 Amazon CodePipeline 定义的操作

资源

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践,请使用其 Amazon 资源名称(ARN)指定资源。对于不支持资源级权限的操作,请使用通配符(*)来指示此语句应用于所有资源。

"Resource": "*"

CodePipeline 资源和操作

在 CodePipeline 中,主要资源为管道。在策略中,您可以使用 Amazon 资源名称(ARN)标识策略应用到的资源。CodePipeline 支持可与主要资源一起使用的其他资源,如阶段、操作和自定义操作。这些资源称为子资源。这些资源和子资源具有与其关联的唯一 Amazon 资源名称(ARN)。有关 ARN 的详细信息,请参阅 Amazon Web Services 一般参考 中的 Amazon 资源名称 (ARN) 和 Amazon Web Services 服务 命名空间。要获取与您的管道关联的管道 ARN,您可以在控制台的设置下找到管道 ARN。有关更多信息,请参阅 查看管道 ARN 和服务角色 ARN(控制台)

资源类型 ARN 格式

管道运输

arn:aws:codepipeline:region:account:pipeline-name

舞台

arn:aws:codepipeline:region:account:pipeline-name/stage-name

操作

arn:aws:codepipeline:region:account:pipeline-name/stage-name/action-name

自定义操作 arn:aws:codepipeline:region:account:actiontype:owner/category/provider/version

所有 CodePipeline 资源

arn:aws:codepipeline:*

指定账户在指定区域拥有的所有 CodePipeline 资源

arn:aws:codepipeline:region:account:*

注意

Amazon 中的大多数服务将 ARN 中的冒号(:)或正斜杠(/)视为相同的字符。不过,CodePipeline 在事件模式和规则中使用精确匹配。请在创建事件模式时务必使用正确的 ARN 字符,以使其匹配需要匹配的管道中的 ARN 语法。

在 CodePipeline 中,有支持资源级权限的 API 调用。资源级权限指示 API 调用是否可以指定资源 ARN,或者 API 调用是否只能使用通配符指定所有资源。有关资源级权限的详细说明以及支持资源级权限的 CodePipeline API 调用列表,请参阅 CodePipeline 权限参考

例如,您可以使用某个特定管道(myPipeline)的 ARN 在语句中指定该管道,如下所示:

"Resource": "arn:aws:codepipeline:us-east-2:111222333444:myPipeline"

还可以使用通配符(*)指定属于特定账户的所有管道,如下所示:

"Resource": "arn:aws:codepipeline:us-east-2:111222333444:*"

要指定所有资源,或者,如果特定 API 操作不支持 ARN,请在 Resource 元素中使用(*)通配符,如下所示:

"Resource": "*"
注意

在您创建 IAM 策略时,请遵循授予最低权限这一标准安全建议,即仅授予执行任务所需的权限。如果某个 API 调用支持 ARN,则它支持资源级权限,您无需使用通配符(*)。

有些 CodePipeline API 调用接受多个资源(例如,GetPipeline)。要在单个语句中指定多种资源,请使用逗号将它们隔开,如下所示:

"Resource": ["arn1", "arn2"]

CodePipeline 提供了一组操作来处理 CodePipeline 资源。有关可用操作的列表,请参阅 CodePipeline 权限参考

条件键

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

Condition 元素指定语句何时根据定义的标准执行。您可以创建使用条件运算符(例如,等于或小于)的条件表达式,以使策略中的条件与请求中的值相匹配。要查看所有 Amazon 全局条件键,请参阅《IAM 用户指南》中的 Amazon 全局条件上下文键

CodePipeline 定义了自己的一组条件键,还支持使用一些全局条件键。要查看所有 Amazon 全局条件键,请参阅《IAM 用户指南》中的 Amazon 全局条件上下文键

所有 Amazon EC2 操作都支持 aws:RequestedRegionec2:Region 条件键。有关更多信息,请参阅示例:限制对特定区域的访问

要查看 CodePipeline 条件键的列表,请参阅 IAM 用户指南 中的 Amazon CodePipeline 条件键。要了解您可以对哪些操作和资源使用条件键,请参阅 Amazon CodePipeline 定义的操作

示例

要查看 CodePipeline 基于身份的策略示例,请参阅 Amazon CodePipeline 基于身份的策略示例

CodePipeline 基于资源的策略

CodePipeline 不支持基于资源的策略。但是,提供了与 CodePipeline 相关的 S3 服务的基于资源的策略示例。

示例

要查看 CodePipeline 基于资源的策略示例,请参阅 Amazon CodePipeline 基于资源的策略示例

基于 CodePipeline 标签的授权

您可以将标签附加到 CodePipeline 资源或将请求中的标签传递到 CodePipeline。要基于标签控制访问,您需要使用 codepipeline:ResourceTag/key-nameaws:RequestTag/key-nameaws:TagKeys 条件键在策略的条件元素中提供标签信息。有关为 CodePipeline 资源添加标签的更多信息,请参阅为资源添加标签

要查看基于身份的策略(用于根据资源上的标签来限制对该资源的访问)的示例,请参阅使用标签控制对 CodePipeline 资源的访问

CodePipeline IAM 角色

IAM 角色是您的 Amazon 账户中一个具有特定权限的实体。

将临时凭证用于 CodePipeline

可以使用临时凭证进行联合身份验证登录,分派 IAM 角色或分派跨账户角色。可以通过调用 Amazon STS API 操作(如 AssumeRoleGetFederationToken)获得临时安全凭证。

CodePipeline 支持使用临时凭证。

服务角色

CodePipeline 允许服务代表您扮演服务角色。此角色允许服务访问其他服务中的资源以代表您完成操作。服务角色显示在 IAM 账户中,并归该账户所有。这意味着,IAM 管理员可以更改该角色的权限。但是,这样做可能会中断服务的功能。

CodePipeline 支持服务角色。