管理 Amazon CodeBuild 资源的访问权限的概述 - Amazon CodeBuild
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

管理 Amazon CodeBuild 资源的访问权限的概述

每个 Amazon 资源都归某个 Amazon 账户所有,创建和访问资源的权限由权限策略进行管理。账户管理员可以向 IAM 身份(即:用户、组和角色)附加权限策略。

注意

账户管理员(或管理员用户)是具有管理员权限的用户。有关更多信息,请参阅IAM 用户指南 中的 IAM 最佳实践

在您授予权限时,您要决定谁将获得权限、这些人可以访问的资源以及可以对这些资源执行的操作。

Amazon CodeBuild 资源和操作

在 Amazon CodeBuild 中,构建项目是主要资源。在策略中,您可以使用 Amazon 资源名称 (ARN) 标识策略应用到的资源。构建项目也是资源,且具有相关联的 ARN。有关更多信息,请参阅 。Amazon 资源名称 (ARN) 和Amazon服务命名空间中的Amazon Web Services 一般参考.

资源类型 ARN 格式
构建项目

arn:aws:codebuild:region-ID:account-ID:project/project-name

构建

arn:aws:codebuild:region-ID:account-ID:build/build-ID

报告组 arn:aws:codebuild:region-ID:account-ID:report-group/report-group-name
报告 arn:aws:codebuild:region-ID:account-ID:report/report-ID

所有 CodeBuild 资源

arn:aws:codebuild:*

指定帐户在指定账户中拥有的所有 CodeBuild 资源Amazon区域

arn:aws:codebuild:region-ID:account-ID:*

注意

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

例如,您可以在语句中使用特定构建项目 (myBuildProject) 的 ARN 来指示它,如下所示:

"Resource": "arn:aws:codebuild:us-east-2:123456789012:project/myBuildProject"

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

"Resource": "*"

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

"Resource": [ "arn:aws:codebuild:us-east-2:123456789012:project/myBuildProject", "arn:aws:codebuild:us-east-2:123456789012:project/myOtherBuildProject" ]

CodeBuild 提供一组操作来处理 CodeBuild 资源。有关列表,请参阅Amazon CodeBuild 权限参考

了解资源所有权

Amazon 账户对在该账户下创建的资源具有所有权,而无论创建资源的人员是谁。具体而言,资源所有者是对资源创建请求进行身份验证的Amazon委托人实体 (即根账户、IAM 用户或 IAM 角色) 的 账户。以下示例说明了它的工作原理:

  • 如果您使用的是您的根账户凭证Amazon帐户创建规则,您的Amazon帐户是 CodeBuild 资源的所有者。

  • 如果您在Amazon帐户并对该用户授予创建 CodeBuild 资源的权限,则该用户可以创建 Code 构建资源。但是,您的Amazon账户(该用户所属的账户)拥有 CodeBuild 资源。

  • 如果您在Amazon账户,则能够担任该角色的任何人都可以创 CodeBuild CodeBuild 资源。您的Amazon帐户(该角色所属的账户)拥有 CodeBuild 资源。

管理对资源的访问

权限策略规定谁可以访问哪些资源。

注意

本节讨论如何在中使用 IAMAmazon CodeBuild. 这里不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档,请参阅什么是 IAM?中的IAM 用户指南. 有关 IAM 策略语法和说明的信息,请参阅AmazonIAM 策略参考中的IAM 用户指南.

附加到 IAM 身份的策略称为基于身份的策略(IAM 策略)。附加到资源的策略称为基于资源的策略。CodeBuild 支持基于身份的策略和针对某些只读 API 的基于资源的策略,以实现跨账户资源共享。

基于身份的策略

您可以向 IAM 身份附加策略。

  • 将权限策略挂载到您的账户中的用户或组 – 要授予用户在 Amazon CodeBuild 控制台中查看构建项目和其他 Amazon CodeBuild 资源的权限,您可以将权限策略挂载到用户或用户所属的组。

  • 将权限策略附加到角色(授予跨账户权限)— 您可以将基于身份的权限策略挂载到 IAM 角色以授予跨账户权限。例如,账户 A 中的管理员可以创建一个角色,以向其他 Amazon 账户(如账户 B)或某项 Amazon 服务授予跨账户权限,如下所述:

    1. 账户 A 管理员可以创建一个 IAM 角色,然后向该角色附加授予其访问账户 A 中资源的权限策略。

    2. 账户 A 管理员可以向将账户 B 标识为能够代入该角色的委托人的角色附加信任策略。

    3. 之后,账户 B 管理员可以委派权限,以指派账户 B 中的任何用户代入该角色。这样,账户 B 中的用户便可以创建或访问账户 A 中的资源。如果您需要授予 Amazon 服务相应的权限以代入该角色,则信任策略中的委托人还必须是 Amazon 服务委托人。

    有关使用 IAM 委派权限的更多信息,请参阅访问控制中的IAM 用户指南.

在 CodeBuild 中,基于身份的策略用于管理对与部署过程相关的资源的权限。例如,您可以控制对构建项目的访问。

您可以创建 IAM 策略来限制您账户中的用户有权访问的调用和资源,然后将这些策略附加到 IAM 用户。有关如何创建 IAM 角色和探索用于 CodeBuild 的 IAM 策略语句示例的更多信息,请参阅。管理 Amazon CodeBuild 资源的访问权限的概述.

对 S3 存储桶的安全访问

我们强烈建议您在 IAM 角色中包括以下权限,确保与 CodeBuild 项目关联的 S3 存储桶由您或其他值得信任的人拥有。这些权限未包含在 Amazon 托管策略和角色中。您必须自行添加。

  • s3:GetBucketAcl

  • s3:GetBucketLocation

如果您的项目使用的 S3 存储桶的拥有者发生更改,则必须验证您是否仍拥有存储桶,如果没有,请更新您的 IAM 角色的权限。有关更多信息,请参阅 向 IAM 组或 IAM 用户添加 CodeBuild 访问权限创建 CodeBuild 服务角色

指定策略元素:操作、效果和委托人

对于每种 Amazon CodeBuild 资源,该服务都定义了一组 API 操作。为授予这些 API 操作的权限,CodeBuild 定义了一组您可以在策略中指定的操作。某些 API 操作可能需要多个操作的权限才能执行 API 操作。有关更多信息,请参阅 Amazon CodeBuild 资源和操作Amazon CodeBuild 权限参考

以下是基本的策略元素:

  • 资源 – 您使用 Amazon 资源名称 (ARN) 来标识策略应用到的资源。

  • 操作— 您可以使用操作关键字来标识要允许或拒绝的资源操作。例如,codebuild:CreateProject 权限授予用户执行 CreateProject 操作的权限。

  • Effect— 用于指定当用户请求操作时的效果(可以是允许或拒绝)。如果没有显式授予(允许)对资源的访问权限,则隐式拒绝访问。您也可显式拒绝对资源的访问。您可以执行此操作,以确保用户无法访问资源,即使有其他策略授予了访问权限也是如此。

  • 委托人— 在基于身份的策略 (IAM 策略) 中,挂载了策略的用户是隐式委托人。对于基于资源的策略,您可以指定您希望将权限授予的用户、账户、服务或其他实体。

有关 IAM 策略语法和描述的更多信息,请参阅AmazonIAM 策略参考中的IAM 用户指南.

有关显示所有 CodeBuild API 操作及其适用的资源的表,请参阅Amazon CodeBuild 权限参考.