Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonctionnement d'Amazon Elastic Container Service avec IAM
<a name="security_iam_service-with-iam"></a>

Avant d'utiliser IAM pour gérer l'accès à Amazon ECS, apprenez les fonctions IAM qui peuvent être utilisées dans cette situation.

 

 


| Fonctionnalité IAM | Prise en charge d'Amazon ECS | 
| --- | --- | 
|  [Identity-based politiques](#security_iam_service-with-iam-id-based-policies)  |  Oui | 
|  [Resource-based politiques](#security_iam_service-with-iam-resource-based-policies)  |  Non  | 
|  [Actions de politique](#security_iam_service-with-iam-id-based-policies-actions)  |  Oui | 
|  [Ressources de politique](#security_iam_service-with-iam-id-based-policies-resources)  |  Partielle | 
|  [Clés de condition de politique](#security_iam_service-with-iam-id-based-policies-conditionkeys)  |  Oui | 
|  [ACL](#security_iam_service-with-iam-acls)  |  Non  | 
|  [ABAC (étiquettes dans les politiques)](#security_iam_service-with-iam-tags)  |  Oui | 
|  [Informations d’identification temporaires](#security_iam_service-with-iam-roles-tempcreds)  |  Oui | 
|  [Transmission des sessions d’accès (FAS)](#security_iam_service-with-iam-principal-permissions)  |  Oui | 
|  [Rôles de service](#security_iam_service-with-iam-roles-service)  |  Oui | 
|  [Service-linked rôles](#security_iam_service-with-iam-roles-service-linked)  |  Oui | 

Pour obtenir une vue d'ensemble de la façon dont Amazon ECS et les autres AWS services fonctionnent avec la plupart des fonctionnalités IAM, consultez les [AWS services compatibles avec IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) dans le guide de l'utilisateur *IAM*.

## Identity-based politiques pour Amazon ECS
<a name="security_iam_service-with-iam-id-based-policies"></a>

**Prend en charge les politiques basées sur l’identité :** oui

Identity-based les politiques sont des documents de politique d'autorisation JSON que vous pouvez associer à une identité, telle qu'un utilisateur IAM, un groupe d'utilisateurs ou un rôle. Ces politiques contrôlent quel type d’actions des utilisateurs et des rôles peuvent exécuter, sur quelles ressources et dans quelles conditions. Pour découvrir comment créer une politique basée sur l’identité, consultez [Définition d’autorisations IAM personnalisées avec des politiques gérées par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) dans le *Guide de l’utilisateur IAM*.

Avec les politiques IAM basées sur l’identité, vous pouvez spécifier des actions et ressources autorisées ou refusées, ainsi que les conditions dans lesquelles les actions sont autorisées ou refusées. Pour découvrir tous les éléments que vous utilisez dans une politique JSON, consultez [Références des éléments de politique JSON IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) dans le *Guide de l’utilisateur IAM*.

### Identity-based exemples de politiques pour Amazon ECS
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>

 

Pour voir des exemples de politiques Amazon ECS basées sur l'identité, consultez [Identity-based exemples de politiques pour Amazon Elastic Container Service](security_iam_id-based-policy-examples.md).

## Resource-based politiques au sein d'Amazon ECS
<a name="security_iam_service-with-iam-resource-based-policies"></a>

**Prend en charge les politiques basées sur les ressources :** non 

Resource-based les politiques sont des documents de politique JSON que vous attachez à une ressource. Par exemple, les *politiques de confiance de rôle* IAM et les *politiques de compartiment* Amazon S3 sont des politiques basées sur les ressources. Dans les services qui sont compatibles avec les politiques basées sur les ressources, les administrateurs de service peuvent les utiliser pour contrôler l’accès à une ressource spécifique. Pour la ressource dans laquelle se trouve la politique, cette dernière définit quel type d’actions un principal spécifié peut effectuer sur cette ressource et dans quelles conditions. Vous devez [spécifier un principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) dans une politique basée sur les ressources. Les principaux peuvent inclure des comptes, des utilisateurs, des rôles, des utilisateurs fédérés ou. Services AWS

Pour permettre un accès intercompte, vous pouvez spécifier un compte entier ou des entités IAM dans un autre compte en tant que principal dans une politique basée sur les ressources. Pour plus d’informations, consultez [Accès intercompte aux ressources dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) dans le *Guide de l’utilisateur IAM*.

## Actions de politique pour Amazon ECS
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

**Prend en charge les actions de politique :** oui

Les administrateurs peuvent utiliser les politiques AWS JSON pour spécifier qui a accès à quoi. C’est-à-dire, quel **principal** peut effectuer **des actions** sur quelles **ressources** et dans quelles **conditions**.

L’élément `Action` d’une politique JSON décrit les actions que vous pouvez utiliser pour autoriser ou refuser l’accès à une politique. Intégration d’actions dans une politique afin d’accorder l’autorisation d’exécuter les opérations associées.

 

Pour afficher la liste des actions Amazon ECS, consultez [Actions définies par Amazon Elastic Container Service](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-actions-as-permissions) dans *Référence de l'autorisation de service*.

Les actions de politique dans Amazon ECS utilisent le préfixe suivant avant l'action :

```
ecs
```

Pour indiquer plusieurs actions dans une seule déclaration, séparez-les par des virgules.

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

 

 

Vous pouvez aussi spécifier plusieurs actions à l’aide de caractères génériques (\*). Par exemple, pour spécifier toutes les actions qui commencent par le mot `Describe`, incluez l’action suivante :

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

Pour voir des exemples de politiques Amazon ECS basées sur l'identité, consultez [Identity-based exemples de politiques pour Amazon Elastic Container Service](security_iam_id-based-policy-examples.md).

## Ressources de politique pour Amazon ECS
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

**Prend en charge les ressources de politique :** partiellement

Les administrateurs peuvent utiliser les politiques AWS JSON pour spécifier qui a accès à quoi. C’est-à-dire, quel **principal** peut effectuer **des actions** sur quelles **ressources** et dans quelles **conditions**.

L’élément de politique JSON `Resource` indique le ou les objets auxquels l’action s’applique. Il est recommandé de définir une ressource à l’aide de son [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). Pour les actions qui ne sont pas compatibles avec les autorisations de niveau ressource, utilisez un caractère générique (\*) afin d’indiquer que l’instruction s’applique à toutes les ressources.

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

Pour afficher la liste des types de ressources Amazon ECS et leur ARN, consultez [Ressources définies par Amazon Elastic Container Service](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-resources-for-iam-policies) dans la *Référence de l'autorisation de service*. Pour connaître les actions avec lesquelles vous pouvez spécifier l'ARN de chaque ressource, consultez [Actions définies par Amazon Elastic Container Service](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-actions-as-permissions).

 

 

Certaines actions d'API Amazon ECS prennent en charge plusieurs ressources. Par exemple, plusieurs clusters peuvent être référencés lors de l'appel de l'action d'API `DescribeClusters`. Pour spécifier plusieurs ressources dans une seule instruction, séparez leurs ARN par des virgules. 

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

Par exemple, la ressource de cluster Amazon ECS a l'ARN suivant :

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

Pour spécifier le cluster `my-cluster-1` et `my-cluster-2` dans votre instruction, utilisez les ARN suivants :

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

Pour spécifier tous les clusters qui appartiennent à un compte spécifique, utilisez le caractère générique (\*) :

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

Pour les définitions de tâches, vous pouvez spécifier la dernière révision ou une révision spécifique.

Pour spécifier toutes les révisions de la définition de tâche, utilisez le caractère générique (\*) :

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

Pour spécifier une révision de définition de tâche spécifique, utilisez $ {TaskDefinitionRevisionNumber} :

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

Pour voir des exemples de politiques Amazon ECS basées sur l'identité, consultez [Identity-based exemples de politiques pour Amazon Elastic Container Service](security_iam_id-based-policy-examples.md).

## Clés de condition de politique pour Amazon ECS
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

**Prend en charge les clés de condition de politique spécifiques au service :** oui

Les administrateurs peuvent utiliser les politiques AWS JSON pour spécifier qui a accès à quoi. C’est-à-dire, quel **principal** peut effectuer **des actions** sur quelles **ressources** et dans quelles **conditions**.

L’élément `Condition` indique à quel moment les instructions s’exécutent en fonction de critères définis. Vous pouvez créer des expressions conditionnelles qui utilisent des [opérateurs de condition](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), tels que les signes égal ou inférieur à, pour faire correspondre la condition de la politique aux valeurs de la demande. Pour voir toutes les clés de condition AWS globales, voir les clés de [contexte de condition AWS globales](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) dans le *guide de l'utilisateur IAM*.

Amazon ECS prend en charge les clés de condition spécifiques au service suivantes que vous pouvez utiliser pour fournir un filtrage précis pour vos politiques IAM :


|  Clé de condition  |  Description  |  Types d'évaluation  | 
| --- | --- | --- | 
| était : RequestTag /$ {} TagKey | La clé de contexte est formatée à l'`"aws:RequestTag/{{tag-key}}":"{{tag-value}}"`endroit où se {{tag-key}} {{tag-value}} trouvent une clé de balise et une paire de valeurs.<br />Vérifie que la paire clé-valeur du tag est présente dans une AWS demande. Par exemple, vous pouvez vérifier que la requête comprend la clé d'étiquette `"Dept"` et qu'elle a la valeur `"Accounting"`. | String | 
| était : ResourceTag /$ {} TagKey | La clé de contexte est formatée à l'`"aws:ResourceTag/{{tag-key}}":"{{tag-value}}"`endroit où se {{tag-key}} {{tag-value}} trouvent une clé de balise et une paire de valeurs.<br />Vérifie que l'étiquette attachée à la ressource d'identité (utilisateur ou rôle) correspond aux nom et valeur de la clé spécifiée. | String | 
| lois : TagKeys | Cette clé de contexte est formatée `"aws:TagKeys":"{{tag-key}}"` avec {{tag-key}} une liste de clés de balise sans valeurs (par exemple,`["Dept","Cost-Center"]`).<br />Vérifie les clés de balise présentes dans une AWS demande. | String | 
| sec : ResourceTag /$ {} TagKey | La clé de contexte est formatée à l'`"ecs:ResourceTag/{{tag-key}}":"{{tag-value}}"`endroit où se {{tag-key}} {{tag-value}} trouvent une clé de balise et une paire de valeurs.<br />Vérifie que l'étiquette attachée à la ressource d'identité (utilisateur ou rôle) correspond aux nom et valeur de la clé spécifiée. | String | 
| ecs:account-setting | La clé de contexte est formatée à l'`"ecs:account-setting":"{{account-setting}}"`endroit où se {{account-setting}} trouve le nom du paramètre du compte. | String | 
| ecs:auto-assign-public-ip | La clé de contexte est formatée "ecs:auto-assign-public-ip":"{{value}}" avec {{value-}} « true » ou « false ». | String | 
| ecs:capacity-provider | La clé de contexte est formatée `"ecs:capacity-provider":"{{capacity-provider-arn}}"` là où se {{capacity-provider-arn}} trouve l'ARN du fournisseur de capacité. | ARN, Null | 
| ecs:cluster | La clé de contexte est formatée `"ecs:cluster":"{{cluster-arn}}"` là où se {{cluster-arn}} trouve l'ARN du cluster Amazon ECS. | ARN, Null | 
| ecs:compute-compatability | La clé de contexte est "ecs:compute-compatability":"{{compatability-type}}" formatée {{ {{compatability-type}} }} avec FARGATE « », « EC2 » ou « EXTERNAL ». | String | 
| ecs:container-instances | La clé de contexte est formatée `"ecs:container-instances":"{{container-instance-arns}}"` là où {{container-instance-arns}} se trouvent un ou plusieurs ARN d'instance de conteneur. | ARN, Null | 
| ecs:container-name | La clé de contexte est formatée `"ecs:container-name":"{{container-name}}"` là où se {{container-instance-}} trouve le nom d'un conteneur Amazon ECS défini dans la définition de tâche.  | String | 
| ecs:enable-execute-command | La clé de contexte est formatée "ecs:enable-execute-command":"{{value}}" avec {{value-}} « true » ou « false ». | String | 
| ecs:enable-service-connect | La clé de contexte est formatée à l'`"ecs:enable-service-connect":"{{value}}"`endroit où se {{value}} trouve `"true"` ou`"false"`. | String | 
| ecs:enable-ebs-volumes | La clé de contexte est formatée à l'`"ecs:enable-ebs-volumes":"{{value}}"`endroit où se {{value}} trouve `"true"` ou`"false"`. | String | 
| ecs:enable-managed-tags | La clé de contexte est formatée à l'`"ecs:enable-managed-tags":"{{value}}"`endroit où se {{value}} trouve `"true"` ou`"false"`. | String | 
| ecs:enable-vpc-lattice | La clé de contexte est formatée à l'`"ecs:vpc-lattice":"{{value}}"`endroit où se {{value}} trouve `"true"` ou`"false"`. | String | 
| ecs:fargate-ephemeral-storage-kms-key | La clé de contexte est formatée `"ecs:fargate-ephemeral-storage-kms-key":"{{key}}"` là où se {{key}} trouve l'ID de la AWS KMS clé. | String | 
| ecs:namespace | La clé de contexte est formatée `"ecs:namespace":"{{namespace-arn}}"` là où se {{namespace-arn}} trouve l'ARN de l'espace de AWS Cloud Map noms. | ARN, Null | 
| ecs:propagate-tags | La clé de contexte est formatée à l'`"ecs:propagate-tags":"{{value}}"`endroit où {{value}} est `"TASK_DEFINITION"``"SERVICE"`, ou`"NONE"`. | String | 
| ecs:service | La clé de contexte est formatée `"ecs:service":"{{service-arn}}"` là où se {{service-arn}} trouve l'ARN du service Amazon ECS. | ARN, Null | 
| ecs:task-definition | La clé de contexte est formatée `"ecs:task-definition":"{{task-definition-arn}}"` là où se {{task-definition-arn}} trouve l'ARN pour la définition de tâche Amazon ECS. | ARN, Null | 
| ecs:subnet | La clé de contexte est formatée `"ecs:subnet":"{{subnets}}"` là où se {{subnets}} trouvent les sous-réseaux d'une tâche ou d'un service utilisant `awsvpc` le mode. | String | 
| ecs:task | La clé de contexte est formatée `"ecs:task":"{{task-arn}}"` là où se {{task-arn}} trouve l'ARN du service Amazon ECS. | ARN, Null | 
| ecs:task-cpu | La clé de contexte est formatée à l'"ecs:task-cpu":"{{task-cpu}}"endroit où se {{task-cpu}} trouve le processeur de tâches, sous la forme d'un entier avec 1024 = 1 vCPU. | Entier | 
| ecs:task-memory | La clé de contexte est formatée "ecs:task-memory":"{{task-memory}}" là où se {{task-memory}} trouve la mémoire des tâches en MiB. | Entier | 

Pour voir la liste des clés de condition Amazon ECS, consultez [Clés de condition pour Amazon Elastic Container Service](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-policy-keys) dans la *Référence de l'autorisation de service*. Pour savoir avec quelles actions et ressources vous pouvez utiliser une clé de condition, consultez [Actions définies par Amazon Elastic Container Service](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-actions-as-permissions).

Pour voir des exemples de politiques Amazon ECS basées sur l'identité, consultez [Identity-based exemples de politiques pour Amazon Elastic Container Service](security_iam_id-based-policy-examples.md).

## Listes de contrôle d'accès (ACL) dans Amazon ECS
<a name="security_iam_service-with-iam-acls"></a>

**Prend en charge les ACL :** non 

Les listes de contrôle d’accès (ACL) vérifie quels principaux (membres de compte, utilisateurs ou rôles) ont l’autorisation d’accéder à une ressource. Les listes de contrôle d’accès sont similaires aux politiques basées sur les ressources, bien qu’elles n’utilisent pas le format de document de politique JSON.

## Attribute-based contrôle d'accès (ABAC) avec Amazon ECS
<a name="security_iam_service-with-iam-tags"></a>

**Important**  
Amazon ECS prend en charge le contrôle d'accès basé sur les attributs pour toutes les ressources Amazon ECS. Pour déterminer si vous pouvez utiliser des attributs pour définir le périmètre d'une action, utilisez le tableau [Actions définies par Amazon ECS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerservice.html#amazonelasticcontainerservice-actions-as-permissions) dans la *Référence de l'autorisation de service*. Vérifiez d'abord qu'il existe une ressource dans la colonne **Ressource**. Utilisez ensuite la colonne **Clés de condition** pour voir les clés de la action/resource combinaison.

**Prise en charge d’ABAC (balises dans les politiques) :** Oui

Attribute-based le contrôle d'accès (ABAC) est une stratégie d'autorisation qui définit les autorisations en fonction d'attributs appelés balises. Vous pouvez associer des balises aux entités et aux AWS ressources IAM, puis concevoir des politiques ABAC pour autoriser les opérations lorsque la balise du principal correspond à la balise de la ressource.

Pour contrôler l’accès basé sur des étiquettes, vous devez fournir les informations d’étiquette dans l’[élément de condition](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) d’une politique utilisant les clés de condition `aws:ResourceTag/{{key-name}}`, `aws:RequestTag/{{key-name}}` ou `aws:TagKeys`.

Si un service prend en charge les trois clés de condition pour tous les types de ressources, alors la valeur pour ce service est **Oui**. Si un service prend en charge les trois clés de condition pour certains types de ressources uniquement, la valeur est **Partielle**.

Pour plus d’informations sur ABAC, consultez [Définition d’autorisations avec l’autorisation ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) dans le *Guide de l’utilisateur IAM*. Pour accéder à un didacticiel décrivant les étapes de configuration de l’ABAC, consultez [Utilisation du contrôle d’accès par attributs (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html) dans le *Guide de l’utilisateur IAM*.

Pour en savoir plus sur l'identification des ressources Amazon ECS, consultez [Balisage des ressources Amazon ECS](ecs-using-tags.md).

Pour visualiser un exemple de politique basée sur l'identité permettant de limiter l'accès à une ressource en fonction des étiquettes de cette ressource, consultez [Description des services Amazon ECS basée sur des balises](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-cluster-tags).

## Utilisation d'informations d'identification temporaires avec Amazon ECS
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

**Prend en charge les informations d’identification temporaires :** oui

Les informations d'identification temporaires fournissent un accès à court terme aux AWS ressources et sont automatiquement créées lorsque vous utilisez la fédération ou que vous changez de rôle. AWS recommande de générer dynamiquement des informations d'identification temporaires au lieu d'utiliser des clés d'accès à long terme. Pour plus d’informations, consultez [Informations d’identification de sécurité temporaires dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) et [Services AWS compatibles avec IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) dans le *Guide de l’utilisateur IAM*.

## Transmission des sessions d’accès pour Amazon ECS
<a name="security_iam_service-with-iam-principal-permissions"></a>

**Prend en charge les sessions d’accès direct (FAS) :** oui

 Les sessions d'accès direct (FAS) utilisent les autorisations du principal appelant et Service AWS, combinées Service AWS à la demande d'envoi de demandes aux services en aval. Pour plus de détails sur la politique relative à la transmission de demandes FAS, consultez la section [Sessions de transmission d’accès](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html). 

## Fonctions du service pour Amazon ECS
<a name="security_iam_service-with-iam-roles-service"></a>

**Prend en charge les rôles de service :** oui

 Un rôle de service est un [rôle IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) qu’un service endosse pour accomplir des actions en votre nom. Un administrateur IAM peut créer, modifier et supprimer un rôle de service à partir d’IAM. Pour plus d’informations, consultez [Création d’un rôle pour la délégation d’autorisations à un Service AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) dans le *Guide de l’utilisateur IAM*. 

**Avertissement**  
La modification des autorisations d'une fonction de service peut altérer la fonctionnalité d'Amazon ECS. Ne modifiez des rôles de service que quand Amazon ECS vous le conseille.

## Service-linked rôles pour Amazon ECS
<a name="security_iam_service-with-iam-roles-service-linked"></a>

**Prend en charge les rôles liés à un service :** oui

 Un rôle lié à un service est un type de rôle de service lié à un. Service AWS Le service peut assumer le rôle d'effectuer une action en votre nom. Service-linked les rôles apparaissent dans votre fichier Compte AWS et appartiennent au service. Un administrateur IAM peut consulter, mais ne peut pas modifier, les autorisations concernant les rôles liés à un service. 

Pour plus d'informations sur la création ou la gestion des rôles liés à un service Amazon ECS service, veuillez consulter [Utilisation des rôles liés à un service pour Amazon ECS](using-service-linked-roles.md).