Analyseur d’ARN AWS
Analyser un ARN
Tourne dans votre navigateur, même hors ligne : l’ARN n’est envoyé nulle part. Les ARN ne sont pas secrets, mais ils contiennent votre ID de compte.
Un Amazon Resource Name (ARN) a la forme arn:partition:service:region:account-id:resource, par exemple arn:aws:sns:us-east-1:123456789012:my-topic. La partie ressource est un ID, ou un type et un ID reliés par / ou :, et certains ARN laissent des champs vides : les ARN IAM n’ont pas de région, et les ARN de bucket S3 n’ont ni région ni compte.
Les parties d’un ARN
Les ARN identifient une ressource sans ambiguïté dans tout AWS : c’est pourquoi les politiques IAM, les tags de ressource et de nombreux appels d’API les demandent. Chaque ARN a les mêmes six parties séparées par des deux-points, même si la partie ressource peut elle-même contenir des deux-points et des barres obliques :
| Partie | Ce que c’est | Exemple |
|---|---|---|
arn | Préfixe littéral | arn |
| partition | Le groupe de régions : aws (régions AWS), aws-cn (Chine), aws-us-gov (GovCloud US). La documentation S3 liste aussi aws-eusc (European Sovereign Cloud). Chaque compte appartient à une partition. | aws |
| service | L’espace de noms du service, qui n’est pas toujours le nom du produit : Step Functions est states, les règles EventBridge sont events, les équilibreurs de charge elasticloadbalancing. | lambda |
| region | Le code de région, ou vide pour les ressources globales comme les rôles IAM, les buckets S3, les distributions CloudFront et les zones hébergées Route 53. | us-east-2 |
| account-id | L’ID à 12 chiffres du compte propriétaire de la ressource, sans tirets. Vide pour les buckets et objets S3 ; aws pour les politiques gérées par AWS. | 123456789012 |
| resource | resource-id, resource-type/resource-id ou resource-type:resource-id. Elle peut inclure une ressource parente ou un qualificateur comme une version. | function:my-function |
Formats d’ARN de 27 services AWS courants
Les variables sont entre ${…}. Elles viennent de la page de chaque service dans la Service Authorization Reference, qui liste le format d’ARN de chaque type de ressource utilisable dans une politique ; les formats des sessions STS viennent de la page sur les identifiants IAM.
| Service | Ressource | Format d’ARN |
|---|---|---|
| IAM | utilisateur | arn:${Partition}:iam::${Account}:user/${UserNameWithPath} |
| IAM | rôle | arn:${Partition}:iam::${Account}:role/${RoleNameWithPath} |
| IAM | politique | arn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath} |
| IAM | groupe | arn:${Partition}:iam::${Account}:group/${GroupNameWithPath} |
| IAM | profil d’instance | arn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath} |
| IAM | utilisateur root | arn:${Partition}:iam::${Account}:root |
| STS | session de rôle assumé | arn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName} |
| STS | utilisateur fédéré | arn:${Partition}:sts::${Account}:federated-user/${FederatedUserName} |
| Amazon S3 | bucket | arn:${Partition}:s3:::${BucketName} |
| Amazon S3 | objet | arn:${Partition}:s3:::${BucketName}/${ObjectName} |
| Amazon EC2 | instance | arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId} |
| Amazon EC2 | VPC | arn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId} |
| Amazon EC2 | sous-réseau | arn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId} |
| Amazon EC2 | groupe de sécurité | arn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId} |
| Amazon EC2 | volume EBS | arn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId} |
| Amazon EC2 | AMI | arn:${Partition}:ec2:${Region}::image/${ImageId} |
| AWS Lambda | fonction | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName} |
| AWS Lambda | version de fonction | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version} |
| AWS Lambda | alias de fonction | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias} |
| Amazon DynamoDB | table | arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName} |
| Amazon SQS | file d’attente | arn:${Partition}:sqs:${Region}:${Account}:${QueueName} |
| Amazon SNS | rubrique | arn:${Partition}:sns:${Region}:${Account}:${TopicName} |
| Amazon RDS | instance de base de données | arn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName} |
| Amazon RDS | cluster de base de données | arn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName} |
| Amazon ECS | cluster | arn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName} |
| Amazon ECS | service | arn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName} |
| Amazon ECS | tâche | arn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId} |
| Amazon ECS | définition de tâche | arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber} |
| Amazon ECR | référentiel | arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName} |
| Amazon EKS | cluster | arn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName} |
| AWS KMS | clé | arn:${Partition}:kms:${Region}:${Account}:key/${KeyId} |
| AWS KMS | alias | arn:${Partition}:kms:${Region}:${Account}:alias/${Alias} |
| Secrets Manager | secret | arn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId} |
| CloudWatch Logs | groupe de logs | arn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName} |
| CloudWatch | alarme | arn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName} |
| Step Functions | machine d’état | arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName} |
| Step Functions | exécution | arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId} |
| EventBridge | règle (bus par défaut) | arn:${Partition}:events:${Region}:${Account}:rule/${RuleName} |
| EventBridge | règle (bus personnalisé) | arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName} |
| EventBridge | bus d’événements | arn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName} |
| EventBridge Scheduler | planification | arn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName} |
| CloudFormation | pile | arn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id} |
| API Gateway | API REST | arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId} |
| CloudFront | distribution | arn:${Partition}:cloudfront::${Account}:distribution/${DistributionId} |
| Route 53 | zone hébergée | arn:${Partition}:route53:::hostedzone/${Id} |
| Certificate Manager | certificat | arn:${Partition}:acm:${Region}:${Account}:certificate/${CertificateId} |
| Elastic Load Balancing | Application Load Balancer | arn:${Partition}:elasticloadbalancing:${Region}:${Account}:loadbalancer/app/${LoadBalancerName}/${LoadBalancerId} |
| Elastic Load Balancing | groupe cible | arn:${Partition}:elasticloadbalancing:${Region}:${Account}:targetgroup/${TargetGroupName}/${TargetGroupId} |
| Systems Manager | paramètre | arn:${Partition}:ssm:${Region}:${Account}:parameter/${ParameterNameWithoutLeadingSlash} |
| Kinesis Data Streams | flux | arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName} |
Quelques détails piègent souvent. Les ARN de file SQS et de rubrique SNS n’ont pas de type de ressource, seulement le nom. Les ARN Lambda avec un suffixe de version ou d’alias (:prod, :3) sont « qualifiés » et ne désignent que cette version. Un ARN de définition de tâche ECS se termine par family:revision. Les noms IAM WithPath incluent le chemin : un rôle de service ressemble donc à role/service-role/MyRole.
Chemins, caractères génériques et ARN incomplets
- Chemins. Les noms d’utilisateurs, de groupes, de rôles et de politiques IAM peuvent avoir un chemin, et les clés d’objets S3 utilisent des barres obliques comme des dossiers. Les chemins IAM peuvent contenir des lettres, des chiffres et
/ + = , . @ _ -. - Caractères génériques. Dans l’élément
ResourceouNotResourced’une politique,*correspond à n’importe quels caractères et?à un seul :arn:aws:iam::123456789012:role/service-*,arn:aws:s3:::amzn-s3-demo-bucket/????-test, ouarn:aws:ec2:*:123456789012:vpc/*pour tous les VPC de toutes les régions. Ils sont interdits dansPrincipalouNotPrincipal, dans le type de ressource (functi*) et dans la partition. - ARN incomplets. Dans une politique basée sur l’identité, un ARN de moins de six parties est complété par des caractères génériques :
arn:aws:sqssignifie doncarn:aws:sqs:*:*:*, soit toutes les files de toutes les régions et de tous les comptes. Les politiques de session transmises à AssumeRole n’acceptent pas les ARN incomplets et échouent avecMalformedPolicyDocumentException.
Trouver un ARN
La plupart des commandes describe-, get- et list- renvoient l’ARN avec le nom, et la console l’affiche sur la page de détails de la ressource. Pour savoir à quelle identité appartiennent vos identifiants CLI, exécutez aws sts get-caller-identity : un rôle assumé apparaît sous la forme arn:aws:sts::123456789012:assumed-role/RoleName/SessionName, qui désigne la session, pas le rôle lui-même (arn:aws:iam::123456789012:role/RoleName). Utilisez l’ARN du rôle dans les politiques d’approbation et de ressource.
Selon AWS, les ARN ne sont ni secrets, ni sensibles, ni confidentiels, mais ils révèlent l’ID de compte et les noms de ressources : partagez-les avec la même prudence que tout autre identifiant.
Sources
Questions fréquentes
Quel est le format d’un ARN AWS ?
arn:partition:service:region:account-id:resource. La partie ressource est un ID de ressource, ou un type de ressource et un ID séparés par une barre oblique ou un deux-points, comme role/MyRole ou function:my-function. Certains ARN laissent vides la région, l’ID de compte ou les deux : les ARN de bucket S3 ressemblent à arn:aws:s3:::my-bucket.
Pourquoi un ARN IAM ou S3 a-t-il des champs vides (:::) ?
IAM est global : les ARN IAM n’ont donc pas de région (arn:aws:iam::123456789012:role/MyRole). Les noms de bucket S3 sont uniques dans la partition : les ARN de bucket et d’objet n’ont donc ni région ni ID de compte (arn:aws:s3:::my-bucket/key).
Un ARN est-il secret ?
Non. Selon AWS, les ARN ne sont pas considérés comme secrets, sensibles ou confidentiels, mais comme tout identifiant, partagez-les avec prudence. Un ARN contient l’ID de compte et le nom de la ressource.
Puis-je utiliser des caractères génériques dans un ARN ?
Dans l’élément Resource ou NotResource d’une politique IAM, oui : * correspond à n’importe quels caractères et ? à un seul, comme dans arn:aws:s3:::my-bucket/* ou arn:aws:ec2:*:123456789012:vpc/*. Pas dans Principal ou NotPrincipal, pas dans le type de ressource (functi*) et pas dans la partition.
Quelles sont les partitions AWS ?
aws pour les régions AWS standard, aws-cn pour les régions de Chine et aws-us-gov pour AWS GovCloud (US). La documentation S3 liste aussi aws-eusc pour l’AWS European Sovereign Cloud. Un compte appartient à une partition.
Comment trouver l’ARN de ma propre identité IAM ?
Exécutez aws sts get-caller-identity. La commande renvoie votre ID de compte et l’ARN de l’utilisateur ou de la session de rôle assumé à laquelle appartiennent vos identifiants.
La recherche de CloudConsole trouve instances, fonctions, buckets, bases de données, groupes de logs, alarmes et services ECS par nom, ID, ARN ou IP, dans tous vos comptes et régions, et vous permet de copier l’ARN ou le lien de console d’une ressource. Sur iPhone et Android.
À propos de l’app →