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.

Comment fonctionne Amazon Elastic Container Registry avec IAM

Avant IAM de gérer l'accès à AmazonECR, vous devez connaître les IAM fonctionnalités disponibles sur AmazonECR. Pour obtenir une vue d'ensemble de la façon dont Amazon ECR et les autres AWS services fonctionnent avecIAM, consultez la section AWS Services That Work with IAM dans le guide de IAM l'utilisateur.

Politiques basées sur Amazon ECR Identity

Avec les politiques IAM basées sur l'identité, vous pouvez spécifier les actions et les ressources autorisées ou refusées ainsi que les conditions dans lesquelles les actions sont autorisées ou refusées. Amazon ECR prend en charge 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 JSON politique, consultez la section Référence des éléments de IAM JSON stratégie dans le guide de IAM l'utilisateur.

Actions

Les administrateurs peuvent utiliser AWS JSON des politiques 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'Actionélément d'une JSON politique décrit les actions que vous pouvez utiliser pour autoriser ou refuser l'accès dans une politique. Les actions de stratégie portent généralement le même nom que l' AWS APIopération associée. Il existe certaines exceptions, telles que les actions avec autorisation uniquement qui n'ont pas d'opération correspondante. API 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 stratégie afin d’accorder l’autorisation d’exécuter les opérations associées.

Les actions politiques sur Amazon ECR utilisent le préfixe suivant avant l'action :ecr:. Par exemple, pour autoriser quelqu'un à créer un ECR référentiel Amazon avec l'ECRCreateRepositoryAPIopération Amazon, vous devez inclure cette ecr:CreateRepository action 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 décrivant 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 consulter la liste des ECR actions Amazon, consultez la section Actions, ressources et clés de condition pour Amazon Elastic Container Registry dans le guide de IAM l'utilisateur.

Ressources

Les administrateurs peuvent utiliser AWS JSON des politiques 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 Resource JSON de stratégie indique le ou les objets auxquels s'applique l'action. Les instructions doivent inclure un élément Resource ou NotResource. Il est recommandé de spécifier une ressource en utilisant 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 ECR référentiel Amazon possède les éléments suivants ARN :

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

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

Par exemple, pour spécifier le my-repo référentiel dans la us-east-1 région dans votre relevé, utilisez ce qui suit ARN :

"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 ECR ressources Amazon et leurs caractéristiquesARNs, consultez la section Ressources définies par Amazon Elastic Container Registry dans le guide de IAM l'utilisateur. Pour savoir avec quelles actions vous pouvez spécifier pour chaque ressource, consultez Actions définies par Amazon Elastic Container Registry. ARN

Clés de condition

Les administrateurs peuvent utiliser AWS JSON des politiques 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 autoriser un IAM utilisateur à accéder à une ressource uniquement si celle-ci est étiquetée avec son nom IAM d'utilisateur. Pour plus d'informations, consultez IAMla section Éléments de politique : variables et balises dans le Guide de IAM l'utilisateur.

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 contextuelles de condition AWS globales dans le guide de IAM l'utilisateur.

Amazon ECR définit son propre ensemble de clés de condition et prend également en charge l'utilisation de certaines clés de condition globales. Pour voir toutes les clés de condition AWS globales, voir Clés contextuelles de condition AWS globale dans le guide de IAM l'utilisateur.

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

Pour consulter la liste des clés de ECR condition Amazon, consultez la section Clés de condition définies par Amazon Elastic Container Registry dans le guide de IAM l'utilisateur. 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 consulter des exemples de politiques ECR basées sur l'identité d'Amazon, consultez. Exemples de politiques basées sur l'identité du registre de conteneur Amazon Elastic

Politiques basées sur ECR les ressources d'Amazon

Les politiques basées sur les ressources sont des documents de JSON politique qui spécifient les actions qu'un principal spécifié peut effectuer sur une ECR ressource Amazon et dans quelles conditions. Amazon ECR prend en charge les politiques d'autorisation basées sur les ressources pour les référentiels AmazonECR. 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 les ressources pour autoriser un AWS service à accéder à vos référentiels AmazonECR.

Pour activer l'accès entre comptes, vous pouvez spécifier un compte entier ou IAM des entités d'un autre compte comme principal dans une politique basée sur les ressources. L’ajout d’un principal entre comptes à 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 stratégie basée sur des ressources accorde l'accès à un principal dans le même compte, aucune autre stratégie basée sur l'identité n'est requise. Pour plus d'informations, consultez la section En quoi IAM les rôles diffèrent des politiques basées sur les ressources dans le guide de l'IAMutilisateur.

Le ECR service Amazon ne prend en charge qu'un seul type de politique basée sur les ressources, appelé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 ECR basées sur les ressources d'Amazon, consultez Exemples de politiques relatives aux référentiels privés dans Amazon ECR

Autorisation basée sur les ECR tags Amazon

Vous pouvez associer des balises aux ECR ressources Amazon ou transmettre des balises dans une demande adressée à AmazonECR. Pour contrôler l’accès basé sur des étiquettes, vous devez fournir les informations d’étiquette 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 plus d'informations sur le balisage des ECR ressources Amazon, consultezMarquer un dépôt privé sur 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.

ECRIAMRôles Amazon

Un IAMrôle est une entité de votre AWS compte qui possède des autorisations spécifiques.

Utilisation d'informations d'identification temporaires avec Amazon ECR

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

Amazon ECR prend en charge l'utilisation d'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 au service apparaissent dans votre IAM compte et appartiennent au service. Un IAM administrateur peut consulter mais pas modifier les autorisations pour les rôles liés à un service.

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