# 如何将 Amazon Elastic Container Service 与 IAM 结合使用
<a name="security_iam_service-with-iam"></a>

在使用 IAM 管理对 Amazon ECS 的访问权限之前，了解哪些 IAM 功能可用于 Amazon ECS。

 

 


| IAM 功能 | Amazon ECS 支持 | 
| --- | --- | 
|  [基于身份的策略](#security_iam_service-with-iam-id-based-policies)  |  是 | 
|  [基于资源的策略](#security_iam_service-with-iam-resource-based-policies)  |  否  | 
|  [策略操作](#security_iam_service-with-iam-id-based-policies-actions)  |  是 | 
|  [策略资源](#security_iam_service-with-iam-id-based-policies-resources)  |  部分 | 
|  [策略条件键](#security_iam_service-with-iam-id-based-policies-conditionkeys)  |  是 | 
|  [ACL](#security_iam_service-with-iam-acls)  |  否  | 
|  [ABAC（策略中的标签）](#security_iam_service-with-iam-tags)  |  是 | 
|  [临时凭证](#security_iam_service-with-iam-roles-tempcreds)  |  是 | 
|  [转发访问会话（FAS）](#security_iam_service-with-iam-principal-permissions)  |  是 | 
|  [服务角色](#security_iam_service-with-iam-roles-service)  |  是 | 
|  [服务关联角色](#security_iam_service-with-iam-roles-service-linked)  |  是 | 

要大致了解 Amazon ECS 和其它 AWS 服务如何与大多数 IAM 功能一起使用，请参阅 *IAM 用户指南*中的[与 IAM 一起使用的 AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。

## Amazon ECS 基于身份的策略
<a name="security_iam_service-with-iam-id-based-policies"></a>

**支持基于身份的策略：**是

基于身份的策略是可附加到身份（如 IAM 用户、用户组或角色）的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》**中的[使用客户管理型策略定义自定义 IAM 权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。

通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。要了解可在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素引用](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)。

### 适用于 Amazon ECS 的基于身份的策略示例
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>

 

要查看 Amazon ECS 基于身份的策略的示例，请参阅 [Amazon Elastic Container Service 的基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## Amazon ECS 内基于资源的策略
<a name="security_iam_service-with-iam-resource-based-policies"></a>

**支持基于资源的策略：**否 

基于资源的策略是附加到资源的 JSON 策略文档。基于资源的策略的示例包括 IAM *角色信任策略*和 Amazon S3 *存储桶策略*。在支持基于资源的策略的服务中，服务管理员可以使用它们来控制对特定资源的访问。对于在其中附加策略的资源，策略定义指定主体可以对该资源执行哪些操作以及在什么条件下执行。您必须在基于资源的策略中[指定主体](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)。主体可以包括账户、用户、角色、联合用户或。AWS 服务

要启用跨账户访问，您可以将整个账户或其他账户中的 IAM 实体指定为基于资源的策略中的主体。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的跨账户资源访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。

## Amazon ECS 的策略操作
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

**支持策略操作：**是

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

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

 

要查看 Amazon ECS 操作的列表，请参阅*服务授权参考*中的 [Amazon Elastic Container Service 定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-actions-as-permissions)。

Amazon ECS 中的策略操作在操作前面使用以下前缀：

```
ecs
```

要在单个语句中指定多项操作，请使用逗号将它们隔开。

```
"Action": [
      "ecs:{{action1}}",
      "ecs:{{action2}}"
         ]
```

 

 

您也可以使用通配符（\*）指定多个操作。例如，要指定以单词 `Describe` 开头的所有操作，包括以下操作：

```
"Action": "ecs:Describe*"
```

要查看 Amazon ECS 基于身份的策略的示例，请参阅 [Amazon Elastic Container Service 的基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## Amazon ECS 的策略资源
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

**支持策略资源：**部分

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

`Resource` JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践，请使用其 [Amazon 资源名称（ARN）](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)指定资源。对于不支持资源级权限的操作，请使用通配符 (\*) 指示语句应用于所有资源。

```
"Resource": "*"
```

要查看 Amazon ECS 资源类型及其 ARN 的列表，请参阅*服务授权参考*中的 [AAmazon Elastic Container Service 定义的资源](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-resources-for-iam-policies)。要了解您可以使用哪些操作指定每个资源的 ARN，请参阅 [Amazon Elastic Container Service 定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-actions-as-permissions)。

 

 

某些 Amazon ECS API 操作支持多个资源。例如，在调用 `DescribeClusters` API 操作时可以引用多个集群。要在单个语句中指定多个资源，请使用逗号分隔 ARN。

```
"Resource": [
      "EXAMPLE-RESOURCE-1",
      "EXAMPLE-RESOURCE-2"
```

例如，Amazon ECS 集群资源具有以下 ARN：

```
arn:${Partition}:ecs:${Region}:${Account}:cluster/${clusterName}
```

要在语句中指定 `my-cluster-1` 和 `my-cluster-2` 集群，请使用以下 ARN：

```
"Resource": [
         "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster-1",
         "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster-2"
```

要指定属于特定账户的所有集群，请使用通配符（\*）：

```
"Resource": "arn:aws:ecs:us-east-1:123456789012:cluster/*"
```

对于任务定义，您可以指定最新修订版本或特定修订版本。

要指定任务定义的所有修订版，请使用通配符（\*）：

```
"Resource:arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:*"
```

要指定特定的任务定义修订版，请使用 ${TaskDefinitionRevisionNumber}：

```
"Resource:arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber}"
```

要查看 Amazon ECS 基于身份的策略的示例，请参阅 [Amazon Elastic Container Service 的基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## Amazon ECS 的策略条件键
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

**支持特定于服务的策略条件密钥：**是

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

`Condition` 元素根据定义的条件指定语句何时执行。您可以创建使用[条件运算符](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)（例如，等于或小于）的条件表达式，以使策略中的条件与请求中的值相匹配。要查看所有 AWS 全局条件键，请参阅《IAM 用户指南》**中的 [AWS 全局条件上下文键](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。

Amazon ECS 支持以下特定于服务的条件键，您可以使用这些键来为 IAM 策略提供精细筛选：


|  条件键  |  说明  |  评估类型  | 
| --- | --- | --- | 
| aws:RequestTag/${TagKey} | 上下文键的格式为 `"aws:RequestTag/{{tag-key}}":"{{tag-value}}"`，其中 {{tag-key}} 和 {{tag-value}} 是标签键值对。<br />检查 AWS 请求中是否存在目标键值对。例如，您可以检查请求是否包含标签键 `"Dept"` 并具有 `"Accounting"` 值。 | 字符串 | 
| aws:ResourceTag/${TagKey} | 上下文键的格式为 `"aws:ResourceTag/{{tag-key}}":"{{tag-value}}"`，其中 {{tag-key}} 和 {{tag-value}} 是标签键值对。<br />检查附加到身份资源（用户或角色）的标签是否与指定的键名称和键值匹配。 | 字符串 | 
| aws:TagKeys | 该上下文密钥的格式为 `"aws:TagKeys":"{{tag-key}}"`，其中 {{tag-key}} 是没有值的标签键列表（例如，`["Dept","Cost-Center"]`）。<br />检查在 AWS 请求中包含的标签键。 | 字符串 | 
| ecs:ResourceTag/${TagKey} | 上下文键的格式为 `"ecs:ResourceTag/{{tag-key}}":"{{tag-value}}"`，其中 {{tag-key}} 和 {{tag-value}} 是标签键值对。<br />检查附加到身份资源（用户或角色）的标签是否与指定的键名称和键值匹配。 | 字符串 | 
| ecs:account-setting | 上下文键的格式为 `"ecs:account-setting":"{{account-setting}}"`，其中 {{account-setting}} 是账户设置的名称。 | 字符串 | 
| ecs:auto-assign-public-ip | 上下文密钥已格式化为 "ecs:auto-assign-public-ip":"{{value}}"，其中 {{value-}} 为“true”或“false”。 | 字符串 | 
| ecs:capacity-provider | 上下文键的格式为 `"ecs:capacity-provider":"{{capacity-provider-arn}}"`，其中 {{capacity-provider-arn}} 是容量提供程序的 ARN。 | ARN，Null | 
| ecs:cluster | 上下文键的格式为 `"ecs:cluster":"{{cluster-arn}}"`，其中 {{cluster-arn}} 是 Amazon ECS 集群的 ARN。 | ARN，Null | 
| ecs:compute-compatability | 上下文键的格式为 "ecs:compute-compatability":"{{compatability-type}}"，其中 {{{{compatability-type}}}} 为“FARGATE”、“EC2”或 EXTERNAL。 | 字符串 | 
| ecs:container-instances | 上下文键的格式为 `"ecs:container-instances":"{{container-instance-arns}}"`，其中 {{container-instance-arns}} 是一个或多个容器实例 ARN。 | ARN，Null | 
| ecs:container-name | 上下文密钥已格式化为 `"ecs:container-name":"{{container-name}}"`，其中 {{container-instance-}} 是任务定义中定义的 Amazon ECS 容器的名称。 | 字符串 | 
| ecs:enable-execute-command | 上下文密钥已格式化为 "ecs:enable-execute-command":"{{value}}"，其中 {{value-}} 为“true”或“false”。 | 字符串 | 
| ecs:enable-service-connect | 上下文键的格式为 `"ecs:enable-service-connect":"{{value}}"`，其中 {{value}} 为 `"true"` 或 `"false"`。 | 字符串 | 
| ecs:enable-ebs-volumes | 上下文键的格式为 `"ecs:enable-ebs-volumes":"{{value}}"`，其中 {{value}} 为 `"true"` 或 `"false"`。 | 字符串 | 
| ecs:enable-managed-tags | 上下文键的格式为 `"ecs:enable-managed-tags":"{{value}}"`，其中 {{value}} 为 `"true"` 或 `"false"`。 | 字符串 | 
| ecs:enable-vpc-lattice | 上下文键的格式为 `"ecs:vpc-lattice":"{{value}}"`，其中 {{value}} 为 `"true"` 或 `"false"`。 | 字符串 | 
| ecs:fargate-ephemeral-storage-kms-key | 上下文键的格式为 `"ecs:fargate-ephemeral-storage-kms-key":"{{key}}"`，其中 {{key}} 是 AWS KMS 键的 ID。 | 字符串 | 
| ecs:namespace | 上下文键的格式为 `"ecs:namespace":"{{namespace-arn}}"`，其中 {{namespace-arn}} 为 AWS Cloud Map 命名空间的 ARN。 | ARN，Null | 
| ecs:propagate-tags | 上下文键的格式为 `"ecs:propagate-tags":"{{value}}"`，其中 {{value}} 为 `"TASK_DEFINITION"`、`"SERVICE"` 或 `"NONE"`。 | 字符串 | 
| ecs:service | 上下文键的格式为 `"ecs:service":"{{service-arn}}"`，其中 {{service-arn}} 是 Amazon ECS 服务的 ARN。 | ARN，Null | 
| ecs:task-definition | 上下文键的格式为 `"ecs:task-definition":"{{task-definition-arn}}"`，其中 {{task-definition-arn}} 是 Amazon ECS 任务定义的 ARN。 | ARN，Null | 
| ecs:subnet | 上下文键的格式为 `"ecs:subnet":"{{subnets}}"`，其中 {{subnets}} 是使用 `awsvpc` 模式的任务或服务的子网。 | 字符串 | 
| ecs:task | 上下文键的格式为 `"ecs:task":"{{task-arn}}"`，其中 {{task-arn}} 是 Amazon ECS 服务的 ARN。 | ARN，Null | 
| ecs:task-cpu | 上下文键的格式为 "ecs:task-cpu":"{{task-cpu}}"，其中 {{task-cpu}} 是任务 cpu，为 1024 = 1 vCPU 的整数。 | 整数 | 
| ecs:task-memory | 上下文键的格式为 "ecs:task-memory":"{{task-memory}}"，其中 {{task-memory}} 是以 MiB 为单位的任务内存。 | 整数 | 

要查看 Amazon ECS 条件键的列表，请参阅*服务授权参考*中的 [Amazon Elastic Container Service 的条件键](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-policy-keys)。要了解您可以对哪些操作和资源使用条件键，请参阅 [Amazon Elastic Container Service 定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-actions-as-permissions)。

要查看 Amazon ECS 基于身份的策略的示例，请参阅 [Amazon Elastic Container Service 的基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## Amazon ECS 中的访问控制列表（ACL）
<a name="security_iam_service-with-iam-acls"></a>

**支持 ACL：**否 

访问控制列表（ACL）控制哪些主体（账户成员、用户或角色）有权访问资源。ACL 与基于资源的策略类似，但它们不使用 JSON 策略文档格式。

## 使用 Amazon ECS 的基于属性的访问权限控制（ABAC）
<a name="security_iam_service-with-iam-tags"></a>

**重要**  
Amazon ECS 支持对所有 Amazon ECS 资源进行基于属性的访问权限控制。要确定是否可以使用属性来确定操作的范围，请使用《服务授权参考》**中的[由 Amazon ECS 定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-actions-as-permissions)表。首先验证**资源**列中是否有资源。然后，使用**条件键**列查看操作/资源组合的键。

**支持 ABAC（策略中的标签）：**是

基于属性的访问权限控制（ABAC）是一种授权策略，该策略基于称为标签的属性来定义权限。您可以将标签附加到 IAM 实体和 AWS 资源，然后设计 ABAC 策略，以支持在主体的标签与资源上的标签匹配时执行操作。

要基于标签控制访问，您需要使用 `aws:ResourceTag/{{key-name}}``aws:RequestTag/{{key-name}}` 或 `aws:TagKeys` 条件键在策略的[条件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中提供标签信息。

如果某个服务对于每种资源类型都支持所有这三个条件键，则对于该服务，该值为**是**。如果某个服务仅对于部分资源类型支持所有这三个条件键，则该值为**部分**。

有关 ABAC 的更多信息，请参阅《IAM 用户指南》**中的[使用 ABAC 授权定义权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)。要查看设置 ABAC 步骤的教程，请参阅《IAM 用户指南》**中的[使用基于属性的访问权限控制（ABAC）](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html)。

有关标记 Amazon ECS 资源的更多信息，请参阅 [为 Amazon ECS 资源添加标签](ecs-using-tags.md)。

要查看基于身份的策略（用于根据资源上的标签来限制对该资源的访问）的示例，请参阅 [基于标签描述 Amazon ECS 服务](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-cluster-tags)。

## 将临时凭证用于 Amazon ECS
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

**支持临时凭证：**是

临时凭证提供对 AWS 资源的短期访问权限，并且是在您使用联合身份验证或切换角色时自动创建的。AWS 建议您动态生成临时凭证，而不是使用长期访问密钥。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的临时安全凭证](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)和[使用 IAM 的。AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)

## Amazon ECS 的转发访问会话
<a name="security_iam_service-with-iam-principal-permissions"></a>

**支持转发访问会话（FAS）：**是

 转发访问会话（FAS）使用调用 AWS 服务 的主体的权限，与发出请求的 AWS 服务 结合，向下游服务发出请求。有关发出 FAS 请求时的策略详情，请参阅[转发访问会话](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)。

## Amazon ECS 的服务角色
<a name="security_iam_service-with-iam-roles-service"></a>

**支持服务角色：**是

 服务角色是由一项服务担任、代表您执行操作的 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息，请参阅《IAM 用户指南》**中的[创建向 AWS 服务 委派权限的角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)。

**警告**  
更改服务角色的权限可能会破坏 Amazon ECS 的功能。仅当 Amazon ECS 提供相关指导时才编辑服务角色。

## Amazon ECS 的服务相关角色
<a name="security_iam_service-with-iam-roles-service-linked"></a>

**支持服务相关角色：**是

 服务关联角色是一种与 AWS 服务 关联的服务角色。服务可以代入代表您执行操作的角色。服务关联角色显示在您的 AWS 账户 中，并由该服务拥有。IAM 管理员可以查看但不能编辑服务关联角色的权限。

有关创建或管理 Amazon ECS 服务相关角色的详细信息，请参阅 [对 Amazon ECS 使用服务相关角色](using-service-linked-roles.md)。