如何与 Amazon Elastic Container Registry 协同工作IAM - Amazon ECR
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

如何与 Amazon Elastic Container Registry 协同工作IAM

使用前 IAM 管理访问 Amazon ECR,您应该了解 IAM 功能可用于 Amazon ECR. 以获得如何 Amazon ECR 其他 AWS 服务与IAM合作,请参阅 AWS 合作的服务 IAMIAM 用户指南.

Amazon ECR 基于身份的策略

带有 IAM 基于身份的策略,您可以指定允许或拒绝的操作和资源,以及允许或拒绝操作的条件。 Amazon ECR 支持具体的操作、资源和条件密钥。要了解您在JSON政策中使用的所有元素,请参阅 IAM JSON政策元素参考IAM 用户指南.

Actions

Administrators can use AWS JSON policies to specify who has access to what. That is, which principal can perform actions on what resources, and under what conditions.

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

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

策略操作 Amazon ECR 操作前使用以下前缀: ecr:...例如,授予某人授权创建 Amazon ECR 存储库 Amazon ECR CreateRepository API操作,您包括 ecr:CreateRepository 其政策中的操作。政策声明必须包括 ActionNotAction 元素。 Amazon ECR 定义了描述您可以使用此服务执行的任务的各种操作。

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

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

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

"Action": "ecr:Describe*"

查看列表 Amazon ECR 操作,请参阅 的操作、资源和条件密钥 Amazon Elastic Container RegistryIAM 用户指南.

Resources

Administrators can use AWS JSON policies to specify who has access to what. That is, which principal can perform actions on what resources, and under what conditions.

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

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

"Resource": "*"

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

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

有关ARNS格式的更多信息,请参阅 亚马逊资源名称(ARNS)和 AWS 服务命名空间.

例如,要指定 my-repo 存储库 us-east-1 在您的账单中的区域,使用以下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 资源类型和其ARNS,请参见 资源定义人 Amazon Elastic Container RegistryIAM 用户指南. 要了解您可以指定每个资源的ARN的操作,请参阅 操作定义人 Amazon Elastic Container Registry.

条件键

Administrators can use AWS JSON policies to specify who has access to what. That is, which principal can perform actions on what resources, and under what conditions.

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

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

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

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

Amazon ECR 定义了自己的一组条件键,还支持使用一些全局条件键。查看全部 AWS 全局条件键,请参阅 AWS 全局条件上下文关键字IAM 用户指南.

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

查看列表 Amazon ECR 条件键,参见 条件密钥定义人 Amazon Elastic Container RegistryIAM 用户指南. 要了解您可以使用条件密钥的操作和资源,请参阅 操作定义人 Amazon Elastic Container Registry.

Examples

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

Amazon ECR 基于资源的策略

基于资源的策略是指定指定负责人可以对 Amazon ECR 资源和条件。 Amazon ECR 支持基于资源的权限策略 Amazon ECR 存储库。基于资源的策略允许您基于资源向其他账户授予使用权限。您还可以使用基于资源的策略来允许 AWS 使用服务 Amazon ECR 存储库。

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

TheThethe Amazon ECR 服务仅支持一种基于资源的策略,称为A 存储库策略,附加到 资料库. 这个策略定义哪些委托人实体(账户、用户、角色和联合身份用户)可以在存储库上执行操作。

要了解如何将基于资源的策略附加到存储库,请参阅存储库策略.

Examples

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

基于 Amazon ECR 标签的授权

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

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

Amazon ECR IAM 角色

一个 IAM 角色 是您的 AWS 具有特定权限的帐户。

将临时凭证用于 Amazon ECR

您可以使用临时凭证进行联合身份登录,担任 IAM 角色或担任跨账户角色。您通过致电 AWS STS API操作,例如 假设GetFederationToken.

Amazon ECR 支持使用临时凭证。

服务相关角色

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

Amazon ECR 不支持服务相关角色。