Comment ? AWS Systems Manager fonctionne avec IAM - AWS Systems Manager

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 ? AWS Systems Manager fonctionne avec IAM

Avant d'utiliser AWS Identity and Access Management (IAM) pour gérer l'accès à AWS Systems Manager, vous devez comprendre quelles IAM fonctionnalités peuvent être utilisées avec Systems Manager. Pour obtenir une vue d'ensemble de la manière dont Systems Manager et d'autres Services AWS applicationsIAM, voir celles Services AWS qui fonctionnent avec IAM dans le guide de IAM l'utilisateur.

Systems Manager politiques basées sur l'identité

Avec IAM les politiques 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. Systems Manager 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 référence aux éléments de IAM JSON politique 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 politique afin d’accorder l’autorisation d’exécuter les opérations associées.

Actions politiques dans Systems Manager utilisez le préfixe suivant avant l'action : ssm: Par exemple, pour autoriser quelqu'un à créer un Systems Manager paramètre (SSMparamètre) avec Systems Manager PutParameterAPIopération, vous incluez l'ssm:PutParameteraction dans leur politique. Les déclarations de politique doivent inclure un élément Action ou NotAction. Systems Manager 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": [ "ssm:action1", "ssm:action2" ]
Note

Les fonctionnalités suivantes permettent d' AWS Systems Manager utiliser différents préfixes avant les actions.

  • AWS AppConfig utilise le préfixe appconfig: avant les actions.

  • Incident Manager utilise le préfixe ssm-incidents: ou ssm-contacts: avant les actions.

  • Systems Manager GUI Connect utilise le préfixe ssm-guiconnect: avant les actions.

  • Quick Setup utilise le préfixe ssm-quicksetup: avant les actions.

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": "ssm:Describe*"

Pour voir la liste des Systems Manager actions, voir Actions définies par AWS Systems Managerdans la référence d'autorisation de service.

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 à 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": "*"

Par exemple, le Systems Manager La ressource de fenêtre de maintenance a le ARN format suivant.

arn:aws:ssm:region:account-id:maintenancewindow/window-id

Pour spécifier les fenêtres de EXAMPLE maintenance mw-0c50858d01 dans votre relevé dans la région USA Est (Ohio), vous devez utiliser un modèle similaire à ce qui suit. ARN

"Resource": "arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0c50858d01EXAMPLE"

Pour spécifier toutes les fenêtres de maintenance appartenant à un compte spécifique, utilisez le caractère générique (*).

"Resource": "arn:aws:ssm:region:123456789012:maintenancewindow/*"

Pour les Parameter Store API opérations, vous pouvez fournir ou restreindre l'accès à tous les paramètres d'un niveau d'une hiérarchie en utilisant des noms hiérarchiques et AWS Identity and Access Management (IAM) des politiques comme suit.

"Resource": "arn:aws:ssm:region:123456789012:parameter/Dev/ERP/Oracle/*"

Momentanée Systems Manager les actions, telles que celles relatives à la création de ressources, ne peuvent pas être effectuées sur une ressource spécifique. Dans ces cas-là, vous devez utiliser le caractère générique (*).

"Resource": "*"

Momentanée Systems Manager APIles opérations acceptent plusieurs ressources. Pour spécifier plusieurs ressources dans une seule instruction, séparez-les ARNs par des virgules comme suit.

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

La plupart Services AWS considèrent les deux points (:)) ou les barres obliques (/) comme le même caractère dansARNs. Cependant, Systems Manager nécessite une correspondance exacte entre les modèles de ressources et les règles. Lorsque vous créez des modèles d'événements, veillez à utiliser les bons ARN caractères afin qu'ils correspondent à ceux de la ressourceARN.

Le tableau ci-dessous décrit les ARN formats des types de ressources pris en charge par Systems Manager.

Note

Notez les exceptions suivantes relatives aux ARN formats.

  • Les fonctionnalités suivantes permettent d' AWS Systems Manager utiliser différents préfixes avant les actions.

    • AWS AppConfig utilise le préfixe appconfig: avant les actions.

    • Incident Manager utilise le préfixe ssm-incidents: ou ssm-contacts: avant les actions.

    • Systems Manager GUI Connect utilise le préfixe ssm-guiconnect avant les actions.

  • Les documents et les ressources de définition d'automatisation détenus par Amazon, ainsi que les paramètres publics fournis par Amazon et par des sources tierces, n'incluent pas le compte IDs dans leurs ARN formats. Par exemple :

    • Le SSM document AWS-RunPatchBaseline :

      arn:aws:ssm:us-east-2::document/AWS-RunPatchBaseline

    • Le manuel d'automatisation AWS-ConfigureMaintenanceWindows :

      arn:aws:ssm:us-east-2::automation-definition/AWS-ConfigureMaintenanceWindows

    • Le paramètre public /aws/service/bottlerocket/aws-ecs-1-nvidia/x86_64/1.13.4/image_version :

      arn:aws:ssm:us-east-2::parameter/aws/service/bottlerocket/aws-ecs-1-nvidia/x86_64/1.13.4/image_version

    Pour plus d'informations sur ces trois types de ressources, consultez les rubriques suivantes :

  • Quick Setup utilise le préfixe ssm-quicksetup: avant les actions.

Type de ressource ARNformat
Application (AWS AppConfig) arn:aws:appconfig :region:account-id:demande/application-id
Association arn:aws:ssm :region:account-id:association/association-id
Exécution d'Automation arn:aws:ssm :region:account-id:automatisation-exécution/automation-execution-id
Définition d'Automation (avec sous-ressource de version)

arn:aws:ssm :region:account-id:définition-automatisation/automation-definition-id:version-id Footnote callout 1 to explain a line in a JSON policy

Profil de configuration (AWS AppConfig) arn:aws:appconfig :region:account-id:demande/application-id/profil de configuration/configurationprofile-id
Contact (Incident Manager)

arn:aws:ssm-contacts :region:account-id:contact/contact-alias

Politique de déploiement (AWS AppConfig) arn:aws:appconfig :region:account-id: stratégie de déploiement/deploymentstrategy-id
Document

arn:aws:ssm :region:account-id:document/document-name

Environnement (AWS AppConfig) arn:aws:appconfig :region:account-id:demande/application-id/environnement/environment-id
Incident

arn:aws:ssm-incidents :region:account-id:enregistrement-d'incident/response-plan-name/incident-id

Fenêtre de maintenance

arn:aws:ssm :region:account-id: fenêtre de maintenance/window-id

Nœud géré

arn:aws:ssm :region:account-id:instance gérée/managed-node-id

Inventaire des nœuds gérés arn:aws:ssm :region:account-id:managed-instance-inventory/managed-node-id
OpsItem arn:aws:ssm :region:account-id:opsitem/OpsItem-id
Paramètre

Un paramètre de premier niveau :

  • arn:aws:ssm :region:account-id:paramètre/parameter-name/

Un paramètre nommé avec une construction hiérarchique :

  • arn:aws:ssm :region:account-id:paramètre/parameter-name-root/level-2/level-3/level-4/level-5 Footnote callout 2 to explain a line in a JSON policy

Référentiel de correctifs

arn:aws:ssm :region:account-id:patchbaseline/patch-baseline-id

Plan de réponse

arn:aws:ssm-incidents :region:account-id:plan de réponse/response-plan-name

Session

arn:aws:ssm :region:account-id:session/session-id Footnote callout 3 to explain a line in a JSON policy

Tous Systems Manager resources

arn:aws:ssm:*

Tous Systems Manager ressources détenues par les personnes spécifiées Compte AWS dans les Région AWS

arn:aws:ssm :region:account-id:*

Footnote callout 1 to explain a line in a JSON policyPour les définitions de l'automatisation, Systems Manager prend en charge une ressource de deuxième niveau, l'ID de version. Dans AWS, ces ressources de deuxième niveau sont appelées sous-ressources. La spécification d'une sous-ressource de version pour une ressource de définition de l'automatisation vous permet de fournir l'accès à certaines versions d'une définition de l'automatisation. Par exemple, il se peut que vous souhaitiez veiller à ce que seule la dernière version de la définition de l'automatisation soit utilisée dans votre gestion des nœuds.

Footnote callout 2 to explain a line in a JSON policy Pour organiser et gérer des paramètres, vous pouvez créer des noms pour les paramètres à l'aide d'une construction hiérarchique. Grâce à une construction hiérarchique, un nom de paramètre peut inclure un chemin que vous définissez en utilisant des barres obliques. Vous pouvez nommer une ressource de paramètre avec quinze niveaux maximum. Nous vous suggérons de créer des hiérarchies qui reflètent une structure hiérarchique existante dans votre environnement. Pour de plus amples informations, veuillez consulter Création Parameter Store paramètres dans Systems Manager.

Footnote callout 3 to explain a line in a JSON policy Dans la plupart des cas, l'ID de session est construit avec l'ID de l'utilisateur de compte qui a démarré la session, auquel est ajouté un suffixe alphanumérique. Par exemple :

arn:aws:us-east-2:111122223333:session/JohnDoe-1a2b3c4sEXAMPLE

Toutefois, si le nom d'utilisateur n'est pas disponible, ARN il est plutôt construit de la manière suivante :

arn:aws:us-east-2:111122223333:session/session-1a2b3c4sEXAMPLE

Pour plus d'informations sur le format deARNs, consultez Amazon Resource Names (ARNs) dans le Référence générale d'Amazon Web Services.

Pour une liste des Systems Manager types de ressources et leurs ARNs caractéristiques, voir Ressources définies par AWS Systems Managerdans la référence d'autorisation de service. Pour savoir avec quelles actions vous pouvez spécifier pour chaque ressource, voir Actions définies par ARN AWS Systems Manager.

Clés de condition pour Systems Manager

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.

Pour voir la liste des Systems Manager clés de condition, voir Clés de condition pour AWS Systems Managerdans la référence d'autorisation de service. Pour savoir avec quelles actions et ressources vous pouvez utiliser une clé de condition, voir Actions définies par AWS Systems Manager.

Pour obtenir des informations sur l'utilisation de la clé de condition ssm:resourceTag/*, consultez les rubriques suivantes :

Pour plus d'informations sur l'utilisation des touches ssm:Recursivessm:Policies, et de ssm:Overwrite condition, consultezEmpêcher l'accès à Parameter Store APIopérations.

Exemples

Pour voir des exemples de Systems Manager politiques basées sur l'identité, voir. AWS Systems Manager exemples de politiques basées sur l'identité

Systems Manager politiques basées sur les ressources

D'autres Services AWS, comme Amazon Simple Storage Service (Amazon S3), prennent en charge les politiques d'autorisation basées sur les ressources. Par exemple, vous pouvez attacher une politique d'autorisation à un compartiment S3 pour gérer les autorisations d'accès à ce compartiment.

Systems Manager ne prend pas en charge les politiques basées sur les ressources.

Autorisation basée sur Systems Manager balises

Vous pouvez attacher des tags à Systems Manager ressources ou balises de transmission dans une demande adressée à Systems Manager. Pour contrôler l'accès en fonction des balises, vous devez fournir les informations relatives aux balises dans l'élément de condition d'une politique à l'aide des clés ssm:resourceTag/key-name aws:ResourceTag/key-nameaws:RequestTag/key-name,, ou de aws:TagKeys condition. Vous pouvez ajouter des balises aux types de ressources suivants lorsque vous les créez ou les mettez à jour :

  • Document

  • Nœud géré

  • Fenêtre de maintenance

  • Paramètre

  • Référentiel de correctifs

  • OpsItem

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 Visualisation Systems Manager documents basés sur des balises.

Systems Manager IAMrôles

Un IAMrôle est une entité au sein de vous Compte AWS qui possède des autorisations spécifiques.

Utilisation d'informations d'identification temporaires avec Systems Manager

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 Security Token Service (AWS STS) API des opérations telles que AssumeRoleou GetFederationToken.

Systems Manager prend en charge l'utilisation d'informations d'identification temporaires.

Rôles liés à un service

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

Systems Manager prend en charge les rôles liés aux services. Pour plus de détails sur la création ou la gestion Systems Manager rôles liés à un service, voir. Utilisation de rôles liés à un service pour Systems Manager

Rôles de service

Cette fonction permet à un service d’endosser une fonction du service en votre nom. Ce rôle autorise le service à accéder à des ressources d’autres services pour effectuer une action en votre nom. Les rôles de service sont affichés dans votre IAM compte et appartiennent au compte. Cela signifie qu'un administrateur peut modifier les autorisations associées à ce rôle. Toutefois, une telle action peut perturber le bon fonctionnement du service.

Systems Manager soutient les rôles de service.

Choisir un IAM rôle dans Systems Manager

Dans Systems Manager pour interagir avec vos nœuds gérés, vous devez choisir un rôle à autoriser Systems Manager pour accéder aux nœuds en votre nom. Si vous avez déjà créé un rôle de service ou un rôle lié à un service, Systems Manager vous propose une liste de rôles parmi lesquels choisir. Il est important de choisir un rôle qui permet d'accéder au démarrage et à l'arrêt des nœuds gérés.

Pour accéder aux EC2 instances, vous devez configurer les autorisations des instances. Pour plus d'informations, consultez Configurer les autorisations d'instance requises pour Systems Manager.

Pour accéder à EC2 des non-nœuds dans un cloud hybride et multicloud, le rôle Compte AWS dont vous avez besoin est un rôle IAM de service. Pour plus d'informations, consultez la section Créer le rôle de IAM service requis pour Systems Manager dans les environnements hybrides et multicloud.

Un flux de travail Automation peut être lancé dans le contexte d'un rôle de service (ou rôle de responsable). Cela permet au service d'effectuer des actions en votre nom. Si vous ne spécifiez pas de rôle de responsable, Automation utilise le contexte de l'utilisateur qui a appelé l'exécution. Cependant, certaines situations exigent que vous spécifiiez un rôle de service pour Automation. Pour de plus amples informations, veuillez consulter Configuration d'un accès à un rôle de service (rôle de responsable) pour les automatisations.

AWS Systems Manager stratégies gérées

AWS répond à de nombreux cas d'utilisation courants en fournissant des IAM politiques autonomes créées et administrées par AWS. Ces politiques gérées AWS octroient les autorisations requises dans les cas d'utilisation courants, ce qui vous évite d'avoir à vous en soucier. (Vous pouvez également créer vos propres IAM politiques personnalisées pour autoriser les autorisations pour Systems Manager actions et ressources.)

Pour plus d'informations sur les politiques gérées pour Systems Manager, voir AWS politiques gérées pour AWS Systems Manager

Pour des informations générales sur les politiques gérées, voir les politiques AWS gérées dans le Guide de IAM l'utilisateur.