Amazon Elastic Container Registry 如何与 IAM 结合使用 - Amazon ECR
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

Amazon Elastic Container Registry 如何与 IAM 结合使用

在使用 IAM 管理对 Amazon ECR 的访问权限之前,您应该了解哪些 IAM 功能可用于 Amazon ECR。要全面了解 Amazon ECR 和其他 Amazon 服务如何与 IAM 配合使用,请参阅 IAM 用户指南中的与 IAM 配合使用的Amazon 服务

Amazon ECR 基于身份的策略

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

操作

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

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。策略操作通常与关联的 Amazon API 操作同名。有一些例外情况,例如没有匹配 API 操作的仅限权限 操作。还有一些操作需要在策略中执行多个操作。这些附加操作称为相关操作

在策略中包含操作以授予执行关联操作的权限。

Amazon ECR 中的策略操作在操作前面使用以下前缀:ecr:。例如,要授予某人使用 Amazon ECR CreateRepository API 操作创建 Amazon ECR 存储库的权限,您应将 ecr:CreateRepository 操作纳入其策略中。策略语句必须包含 ActionNotAction 元素。Amazon ECR 定义了一组自己的操作,以描述您可以使用该服务执行的任务。

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

"Action": [ "ecr:action1", "ecr:action2"

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

"Action": "ecr:Describe*"

要查看 Amazon ECR 操作的列表,请参阅 IAM 用户指南中的 Amazon Elastic Container Registry 的操作、资源和条件键

资源

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

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。语句必须包含 ResourceNotResource 元素。作为最佳实践,请使用其 Amazon 资源名称(ARN)指定资源。对于支持特定资源类型(称为资源级权限)的操作,您可以执行此操作。

对于不支持资源级权限的操作(如列出操作),请使用通配符 (*) 指示语句应用于所有资源。

"Resource": "*"

Amazon ECR 存储库资源具有以下 ARN:

arn:${Partition}:ecr:${Region}:${Account}:repository/${Repository-name}

有关 ARN 格式的更多信息,请参阅 A mazon 资源名称 (ARN) 和 Amazon 服务命名空间。

例如,要在语句中指定 us-east-1 区域中的 my-repo 存储库,请使用以下 ARN:

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/my-repo"

要指定属于特定账户的所有存储库,请使用通配符 (*):

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/*"

要在单个语句中指定多个资源,请使用逗号分隔 ARN。

"Resource": [ "resource1", "resource2"

要查看 Amazon ECR 资源类型及其 ARN 的列表,请参阅 IAM 用户指南中的 Amazon Elastic Container Registry 定义的资源。要了解您可以使用哪些操作指定每个资源的 ARN,请参阅 Amazon Elastic Container Registry 定义的操作

条件键

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

Condition 元素(或 Condition )中,可以指定语句生效的条件。Condition 元素是可选的。您可以创建使用条件运算符(例如,等于或小于)的条件表达式,以使策略中的条件与请求中的值相匹配。

如果您在一个语句中指定多个 Condition 元素,或在单个 Condition 元素中指定多个键,则 Amazon 使用逻辑 AND 运算评估它们。如果您为单个条件键指定多个值,则使用逻辑OR运算来 Amazon 评估条件。在授予语句的权限之前必须满足所有的条件。

在指定条件时,您也可以使用占位符变量。例如,只有在使用 IAM 用户名标记 IAM 用户时,您才能为其授予访问资源的权限。有关更多信息,请参阅《IAM 用户指南》中的 IAM 策略元素:变量和标签

Amazon 支持全局条件密钥和特定于服务的条件密钥。要查看所有 Amazon 全局条件键,请参阅 IAM 用户指南中的Amazon 全局条件上下文密钥

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

大多数 Amazon ECR 操作都支持 aws:ResourceTagecr:ResourceTag 条件键。有关更多信息,请参阅 使用基于标签的访问控制

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

示例

要查看 Amazon ECR 基于身份的策略的示例,请参阅 Amazon Elastic Container Registry 基于身份的策略示例

Amazon ECR 基于资源的策略

基于资源的策略是 JSON 策略文档,它们指定了指定委托人可在 Amazon ECR 资源上执行的操作以及在什么条件下可执行。Amazon ECR 支持针对 Amazon ECR 存储库的基于资源的权限策略。基于资源的策略允许您基于资源向其他账户授予使用权限。您也可以使用基于资源的策略以允许 Amazon 服务访问您的 Amazon ECR 存储库。

要启用跨账户访问,您可以将整个账户或其他账户中的 IAM 实体指定为基于资源的策略中的委托人。将跨账户主体添加到基于资源的策略只是建立信任关系工作的一半而已。当委托人和资源位于不同的 Amazon 账户中时,您还必须向委托人实体授予访问资源的权限。通过将基于身份的策略附加到实体以授予权限。但是,如果基于资源的策略向同一个账户中的主体授予访问权限,则不需要额外的基于身份的策略。有关更多信息,请参阅《IAM 用户指南》 中的 IAM 角色与基于资源的策略有何不同

Amazon ECR 服务仅支持一种类型的基于资源的策略(称为容器策略),这种策略附加到存储库。这个策略定义哪些委托人实体(账户、用户、角色和联合身份用户)可以在存储库上执行操作。要了解如何将基于资源的策略附加到存储库,请参阅私有存储库策略

注意

在 Amazon ECR 存储库策略中,策略元素 Sid 支持 IAM policy 所不支持的其他字符和间距。

示例

要查看 Amazon ECR 基于资源的策略的示例,请参阅 私有存储库策略示例

基于 Amazon ECR 标签的授权

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

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

Amazon ECR IAM 角色

I AM 角色是您的 Amazon 账户中具有特定权限的实体。

将临时凭证用于 Amazon ECR

可以使用临时凭证进行联合身份验证登录,分派 IAM 角色或分派跨账户角色。您可以通过调用AssumeRole或之类的 Amazon STS API 操作来获取临时安全证书GetFederationToken

Amazon ECR 支持使用临时凭证。

服务相关角色

服务相关角色允许 Amazon 服务访问其他服务中的资源以代表您完成操作。服务相关角色显示在 IAM 账户中,并归该服务所有。IAM 管理员可以查看但不能编辑服务相关角色的权限。

Amazon ECR 支持服务相关角色。有关更多信息,请参阅 对 Amazon ECR 使用服务相关角色