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 du registre de conteneur Amazon Elastic avec IAM

Avant d'utiliser IAM pour gérer les accès à Amazon ECR, vous devez comprendre quelles sont les fonctions IAM qui peuvent être utilisées avec Amazon ECR. Pour obtenir une vue d'ensemble de la manière dont Amazon ECR et les autres AWS services fonctionnent avec IAM, consultez la section AWS Services That Work with IAM dans le guide de l'utilisateur IAM.

Politiques basées sur les identités Amazon ECR

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. Amazon ECR est compatible avec des actions, des ressources et des clés de condition spécifiques. Pour en savoir plus sur tous les éléments que vous utilisez dans une politique JSON, consultez Références des éléments de politique JSON IAM dans le Guide de l’utilisateur IAM.

Actions

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. Les actions de stratégie portent généralement le même nom que l'opération AWS d'API associée. Il existe quelques exceptions, telles que les actions avec autorisations uniquement qui n’ont pas d’opération API correspondante. Certaines opérations nécessitent également plusieurs actions dans une politique. Ces actions supplémentaires sont nommées actions dépendantes.

Intégration d’actions dans une politique afin d’accorder l’autorisation d’exécuter les opérations associées.

Les actions de politique dans Amazon ECR utilisent le préfixe suivant avant l'action : ecr:. Par exemple, pour accorder à une personne l'autorisation de créer un référentiel Amazon ECR à l'aide de l'opération d'API CreateRepository Amazon ECR, vous devez inclure l'action ecr:CreateRepository dans sa politique. Les déclarations de politique doivent inclure un élément Action ou NotAction. Amazon ECR définit son propre ensemble d'actions qui décrivent les tâches que vous pouvez effectuer avec ce service.

Pour spécifier plusieurs actions dans une seule déclaration, séparez-les par des virgules comme suit :

"Action": [
      "ecr:action1",
      "ecr: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": "ecr:Describe*"

Pour afficher la liste des actions Amazon ECR, consultez Actions, ressources et clés de condition pour le registre de conteneur Amazon Elastic dans le guide de l'utilisateur IAM.

Ressources

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. Les instructions doivent inclure un élément Resource ou NotResource. Il est recommandé de définir une ressource à l’aide de son Amazon Resource Name (ARN). Vous pouvez le faire pour des actions qui prennent en charge un type de ressource spécifique, connu sous la dénomination autorisations de niveau ressource.

Pour les actions qui ne sont pas compatibles avec les autorisations de niveau ressource, telles que les opérations de liste, utilisez un caractère générique (*) afin d’indiquer que l’instruction s’applique à toutes les ressources.

"Resource": "*"

Une ressource de référentiel Amazon ECR possède l'ARN suivant :

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

Pour plus d'informations sur le format de ARNs, consultez Amazon Resource Names (ARNs) et AWS Service Namespaces.

Par exemple, pour spécifier le référentiel my-repo dans la région us-east-1 dans votre instruction, utilisez l'ARN suivant :

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

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

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

Pour spécifier plusieurs ressources dans une seule instruction, séparez-les ARNs par des virgules.

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

Pour consulter la liste des types de ressources Amazon ECR et leurs caractéristiques ARNs, consultez la section Ressources définies par Amazon Elastic Container Registry dans le guide de l'utilisateur IAM. Pour connaître les actions avec lesquelles vous pouvez spécifier l'ARN de chaque ressource, consultez Actions définies par le registre de conteneur Amazon Elastic.

Clés de condition

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 (ou le bloc Condition) vous permet de spécifier des conditions lorsqu’une instruction est appliquée. L’élément Condition est facultatif. Vous pouvez créer des expressions conditionnelles qui utilisent des opérateurs de condition, tels que les signes égal ou inférieur à, pour faire correspondre la condition de la politique aux valeurs de la demande.

Si vous spécifiez plusieurs éléments Condition dans une instruction, ou plusieurs clés dans un seul élément Condition, AWS les évalue à l’aide d’une opération AND logique. Si vous spécifiez plusieurs valeurs pour une seule clé de condition, AWS évalue la condition à l'aide d'une OR opération logique. Toutes les conditions doivent être remplies avant que les autorisations associées à l’instruction ne soient accordées.

Vous pouvez aussi utiliser des variables d’espace réservé quand vous spécifiez des conditions. Par exemple, vous pouvez accorder à un utilisateur IAM l’autorisation d’accéder à une ressource uniquement si elle est balisée avec son nom d’utilisateur IAM. Pour plus d’informations, consultez Éléments d’une politique IAM : variables et identifications dans le Guide de l’utilisateur IAM.

AWS prend en charge les clés de condition globales et les clés de condition spécifiques au service. Pour voir toutes les clés de condition AWS globales, voir les clés de contexte de condition AWS globales dans le guide de l'utilisateur IAM.

Amazon ECR définit son propre ensemble de clés de condition et est également compatible avec l'utilisation de certaines clés de condition globales. Pour voir toutes les clés de condition AWS globales, consultez la section Clés contextuelles de condition AWS globale dans le guide de l'utilisateur IAM.

La plupart des actions Amazon ECR prennent en charge les clés de condition aws:ResourceTag et ecr:ResourceTag. Pour de plus amples informations, veuillez consulter Utilisation du contrôle d'accès basé sur les balises.

Pour afficher la liste des clés de condition Amazon ECR, consultez Clés de condition définies par le registre de conteneur Amazon Elastic dans le guide de l’utilisateur IAM. Pour savoir avec quelles actions et ressources vous pouvez utiliser une clé de condition, consultez Actions définies par le registre de conteneur Amazon Elastic.

Exemples

Pour voir des exemples de politiques Amazon ECR basées sur l'identité, consultez Exemples de politiques basées sur l'identité du registre de conteneur Amazon Elastic.

Politiques basées sur les ressources Amazon ECR

Les politiques basées sur les ressources sont des documents de politique JSON précisant les actions qu'un principal spécifié peut effectuer sur la ressource Amazon ECR et dans quelles conditions. Amazon ECR prend en charge les politiques d'autorisation basées sur les ressources pour les référentiels Amazon ECR. Les politiques basées sur les ressources permettent d'accorder une autorisation à d'autres comptes en fonction des ressources. Vous pouvez également utiliser une politique basée sur une ressource pour autoriser un service AWS à accéder à vos référentiels Amazon ECR.

Pour permettre un accès comptes multiples, 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. L’ajout d’un principal intercompte à une politique basée sur les ressources ne représente qu’une partie de l’instauration de la relation d’approbation. Lorsque le principal et la ressource se trouvent dans des AWS comptes différents, vous devez également accorder à l'entité principale l'autorisation d'accéder à la ressource. Accordez l'autorisation en attachant une stratégie basée sur les identités à l'entité. Toutefois, si une politique basée sur les ressources accorde l'accès à un principal sur le même compte, vous n'avez pas besoin d'autorisations supplémentaires sur le référentiel Amazon ECR dans la politique basée sur l'identité. Pour en savoir plus, consultez Différence entre les rôles IAM et les politiques basées sur les ressources dans le guide de l’utilisateur IAM.

Le service Amazon ECR prend en charge un seul type de politique basée sur une ressource, nommée politique de référentiel, qui est attachée à un référentiel Cette politique définit les entités principales (comptes, utilisateurs, rôles et utilisateurs fédérés) qui peuvent effectuer des actions sur le référentiel. Pour savoir comment attacher une politique basée sur les ressources à un référentiel, consultez Politiques relatives aux référentiels privés dans Amazon ECR.

Exemples

Pour consulter des exemples de politiques basées sur les ressources ,Amazon ECR, consultez Exemples de politiques relatives aux référentiels privés dans Amazon ECR.

Autorisation basée sur les balises Amazon ECR

Vous pouvez rattacher des balises aux ressources Amazon ECR ou transmettre des balises dans une demande à Amazon ECR. Pour contrôler l'accès basé sur des balises, vous devez fournir les informations de balises dans l'élément de condition d'une politique utilisant les clés de condition ecr:ResourceTag/key-name, aws:RequestTag/key-name ou aws:TagKeys. Pour en savoir plus sur le balisage des ressources Amazon ECR, consultez Marquage d'un référentiel privé dans Amazon ECR.

Pour visualiser un exemple de politique basée sur l'identité permettant de limiter l'accès à une ressource en fonction des balises de cette ressource, consultez Utilisation du contrôle d'accès basé sur les balises.

Rôles IAM Amazon ECR

Un rôle IAM est une entité de votre AWS compte qui dispose d'autorisations spécifiques.

Utiliser des informations d'identification temporaires avec Amazon ECR

Vous pouvez utiliser des informations d’identification temporaires pour vous connecter à l’aide de la fédération, endosser un rôle IAM ou encore pour endosser un rôle intercompte. Vous obtenez des informations d'identification de sécurité temporaires en appelant des opérations d' AWS STS API telles que AssumeRoleou GetFederationToken.

Amazon ECR est compatible avec l'utilisation des informations d'identification temporaires.

Rôles liés à un service

Les rôles liés aux AWS services permettent aux services d'accéder aux ressources d'autres services pour effectuer une action en votre nom. Les rôles liés à un service s’affichent dans votre compte IAM et sont la propriété du service. Un administrateur IAM peut consulter, mais ne peut pas modifier, les autorisations concernant les rôles liés à un service.

Amazon ECR prend en charge les rôles liés à un service. Pour de plus amples informations, veuillez consulter Utilisation des rôles liés à un service pour Amazon ECR.