AWSSupport-ResetLinuxUserPassword - AWS Systems Manager Référence du manuel d'automatisation

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.

AWSSupport-ResetLinuxUserPassword

Description

Le AWSSupport-ResetLinuxUserPassword runbook vous aide à réinitialiser le mot de passe d'un utilisateur du système d'exploitation (OS) local. Ce runbook est particulièrement utile pour les utilisateurs qui ont besoin d'accéder à leurs instances Amazon Elastic Compute Cloud (AmazonEC2) à l'aide de la console série. Le runbook crée une EC2 instance Amazon temporaire dans votre rôle Compte AWS and an AWS Identity and Access Management (IAM) avec les autorisations nécessaires pour récupérer une valeur AWS Secrets Manager secrète contenant le mot de passe.

Le runbook arrête votre EC2 instance Amazon cible, détache le volume Amazon Elastic Block Store EBS (Amazon) racine et l'attache à l'instance Amazon EC2 temporaire. À l'aide de Run Command, un script s'exécute sur l'instance temporaire pour définir le mot de passe de l'utilisateur du système d'exploitation que vous spécifiez. Le EBS volume Amazon racine est ensuite rattaché à votre instance cible. Le runbook fournit également une option permettant de créer un instantané du volume racine au début de l'automatisation.

Avant de commencer

Créez un secret Secrets Manager avec la valeur du mot de passe que vous souhaitez attribuer à l'utilisateur de votre système d'exploitation. La valeur doit être en texte brut. Pour plus d'informations, consultez Créer un secret AWS Secrets Manager dans le Guide de l'utilisateur AWS Secrets Manager .

Considérations

  • Nous vous recommandons de sauvegarder votre instance avant d'utiliser ce runbook. Envisagez de définir la valeur du CreateSnapshot paramètre commeYes.

  • La modification du mot de passe de l'utilisateur local nécessite que le runbook arrête votre instance. Lorsqu'une instance est arrêtée, toutes les données stockées en mémoire ou sur les volumes de stockage d'instance sont perdues. De plus, toutes les IPv4 adresses publiques attribuées automatiquement sont publiées. Pour plus d'informations sur ce qui se passe lorsque vous arrêtez une instance, consultez Arrêter et démarrer votre instance dans le guide de EC2 l'utilisateur Amazon.

  • Si les EBS volumes Amazon attachés à votre EC2 instance Amazon cible sont chiffrés à l'aide d'une clé gérée par le client AWS Key Management Service (AWS KMS), assurez-vous que ce n'est pas le AWS KMS cas, deleted disabled sinon votre instance ne démarrera pas.

Exécuter cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

Linux

Paramètres

  • AutomationAssumeRole

    Type : String

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.

  • InstanceId

    Type : String

    Description : (Obligatoire) L'ID de l'instance Amazon EC2 Linux qui contient le mot de passe utilisateur du système d'exploitation que vous souhaitez réinitialiser.

  • LinuxUserName

    Type : String

    Par défaut : ec2-user

    Description : (Facultatif) Le compte utilisateur du système d'exploitation dont vous souhaitez réinitialiser le mot de passe.

  • SecretArn

    Type : String

    Description : (Obligatoire) Le secret ARN de votre Gestionnaire de Secrets contenant le nouveau mot de passe.

  • SecurityGroupId

    Type : String

    Description : (Facultatif) L'ID du groupe de sécurité à associer à l'EC2instance Amazon temporaire. Si vous ne fournissez aucune valeur pour ce paramètre, le groupe de sécurité Amazon Virtual Private Cloud (AmazonVPC) par défaut est utilisé.

  • SubnetId

    Type : String

    Description : (Facultatif) L'ID du sous-réseau dans lequel vous souhaitez lancer l'instance EC2 temporaire Amazon. Par défaut, l'automatisation choisit le même sous-réseau que votre instance cible. Si vous choisissez de fournir un sous-réseau différent, celui-ci doit se trouver dans la même zone de disponibilité que l'instance cible et avoir accès aux points de terminaison de Systems Manager.

  • CreateSnapshot

    Type : String

    Valeurs valides : Oui | Non

    Par défaut : Oui

    Description : (Facultatif) Détermine si un instantané du volume racine de votre EC2 instance Amazon cible est créé avant l'exécution de l'automatisation.

  • StopConsent

    Type : String

    Valeurs valides : Oui | Non

    Par défaut : Non

    Description : Entrez Yes pour confirmer que votre EC2 instance Amazon cible sera arrêtée pendant cette automatisation. Lorsque l'EC2instance Amazon est arrêtée, toutes les données stockées en mémoire ou dans les volumes de stockage de l'instance sont perdues et l'IPv4adresse publique automatique est publiée. Pour plus d'informations, consultez la section Arrêter et démarrer votre instance dans le guide de EC2 l'utilisateur Amazon.

IAMAutorisations requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • ssm:DescribeInstanceInformation

  • ssm:ListTagsForResource

  • ssm:SendCommand

  • ec2:AttachVolume

  • ec2:CreateSnapshot

  • ec2:CreateSnapshots

  • ec2:CreateVolume

  • ec2:DescribeImages

  • ec2:DescribeInstances

  • ec2:DescribeInstanceStatus

  • ec2:DescribeSnapshotAttribute

  • ec2:DescribeSnapshots

  • ec2:DescribeSnapshotTierStatus

  • ec2:DescribeVolumes

  • ec2:DescribeVolumeStatus

  • ec2:DetachVolume

  • ec2:RunInstances

  • ec2:StartInstances

  • ec2:StopInstances

  • ec2:TerminateInstances

  • cloudformation:CreateStack

  • cloudformation:DeleteStack

  • cloudformation:DescribeStackResource

  • cloudformation:DescribeStacks

  • cloudformation:ListStacks

  • logs:CreateLogDelivery

  • logs:CreateLogGroup

  • logs:DeleteLogDelivery

  • logs:DeleteLogGroup

  • logs:DescribeLogGroups

  • logs:DescribeLogStreams

  • logs:PutLogEvents

Étapes de document

  1. aws:branch— Branches selon que vous avez autorisé ou non l'arrêt de l'EC2instance Amazon cible.

  2. aws:assertAwsResourceProperty— Garantit que le statut de l'EC2instance Amazon est à stopped l'état running ou. Dans le cas contraire, l'automatisation prend fin.

  3. aws:executeAwsApi— Obtient les propriétés de l'EC2instance Amazon.

  4. aws:executeAwsApi— Récupère les propriétés du volume racine.

  5. aws:branch— Divise l'automatisation selon qu'un ID de sous-réseau a été fourni ou non pour l'EC2instance Amazon temporaire.

  6. aws:assertAwsResourceProperty— Garantit que le sous-réseau que vous spécifiez en SubnetId paramètre se trouve dans la même zone de disponibilité que l'EC2instance Amazon cible.

  7. aws:assertAwsResourceProperty— Garantit que le volume racine de l'EC2instance Amazon cible est un EBS volume Amazon.

  8. aws:assertAwsResourceProperty— Garantit que l'architecture de l'EC2instance Amazon est arm64 oux86_64.

  9. aws:assertAwsResourceProperty— Garantit que le comportement d'arrêt de l'EC2instance Amazon est stop ou nonterminate.

  10. aws:branch— Garantit que l'EC2instance Amazon n'est pas une instance Spot. Dans le cas contraire, l'automatisation prend fin.

  11. aws:executeScript— Garantit que l'EC2instance Amazon ne fait pas partie d'un groupe de dimensionnement automatique. Si l'instance fait partie d'un groupe de dimensionnement automatique, l'automatisation confirme que l'EC2instance Amazon est dans un état de Standby cycle de vie.

  12. aws:createStack— Crée une EC2 instance Amazon temporaire qui est utilisée pour réinitialiser le mot de passe de l'utilisateur du système d'exploitation que vous spécifiez.

  13. aws:waitForAwsResourceProperty— Attend que l'EC2instance Amazon temporaire récemment lancée soit en cours d'exécution.

  14. aws:executeAwsApi— Obtient l'ID de l'EC2instance Amazon temporaire.

  15. aws:waitForAwsResourceProperty— Attend que l'EC2instance Amazon temporaire soit signalée comme étant gérée par Systems Manager.

  16. aws:changeInstanceState— Arrête l'EC2instance Amazon cible.

  17. aws:changeInstanceState— Force l'EC2instance Amazon cible à s'arrêter au cas où elle resterait bloquée dans un état d'arrêt.

  18. aws:branch— Divise l'automatisation selon qu'un instantané du volume racine de l'EC2instance Amazon cible a été demandé ou non.

  19. aws:executeAwsApi— Crée un instantané du EBS volume Amazon racine de l'EC2instance Amazon cible.

  20. aws:waitForAwsResourceProperty— Attend que l'instantané soit dans un completed état.

  21. aws:executeAwsApi— Détache le volume EBS racine Amazon de l'EC2instance Amazon cible.

  22. aws:waitForAwsResourceProperty— Attend que le volume EBS racine Amazon soit détaché de l'EC2instance Amazon cible.

  23. aws:executeAwsApi— Attache le EBS volume Amazon racine à l'EC2instance Amazon temporaire.

  24. aws:waitForAwsResourceProperty— Attend que le volume EBS racine Amazon soit attaché à l'EC2instance Amazon temporaire.

  25. aws:runCommand— Réinitialise le mot de passe de l'utilisateur cible en exécutant un script shell à l'aide de Run Command sur l'EC2instance Amazon temporaire.

  26. aws:executeAwsApi— Détache le volume EBS racine Amazon de l'EC2instance Amazon temporaire.

  27. aws:waitForAwsResourceProperty— Attend que le volume EBS racine Amazon soit détaché de l'EC2instance Amazon temporaire.

  28. aws:executeAwsApi— Détache le volume EBS racine Amazon de l'EC2instance Amazon temporaire après une erreur.

  29. aws:waitForAwsResourceProperty— Attend que le volume EBS racine Amazon soit détaché de l'EC2instance Amazon temporaire après une erreur.

  30. aws:branch— Divise l'automatisation selon qu'un instantané du volume racine a été demandé ou non pour déterminer le chemin de restauration en cas d'erreur.

  31. aws:executeAwsApi— Rattache le EBS volume Amazon racine à l'EC2instance Amazon cible.

  32. aws:waitForAwsResourceProperty— Attend que le volume EBS racine Amazon soit attaché à l'EC2instance Amazon.

  33. aws:executeAwsApi— Crée un nouveau EBS volume Amazon à partir de l'instantané du volume racine de l'EC2instance Amazon cible.

  34. aws:waitForAwsResourceProperty— Attend que le nouveau EBS volume Amazon soit en available état.

  35. aws:executeAwsApi— Attache le nouveau EBS volume Amazon à l'instance cible en tant que volume racine.

  36. aws:waitForAwsResourceProperty— Attend que le EBS volume Amazon soit en attached état.

  37. aws:executeAwsApi— Décrit les événements de la AWS CloudFormation pile si les runbooks ne parviennent pas à créer ou à mettre à jour la AWS CloudFormation pile.

  38. aws:branch— Divise l'automatisation en fonction de l'état précédent de l'EC2instance Amazon. Si l'état étaitrunning, l'instance est démarrée. S'il était dans un stopped état, l'automatisation continue.

  39. aws:changeInstanceState— Démarre l'EC2instance Amazon si nécessaire.

  40. aws:waitForAwsResourceProperty— Attend que la AWS CloudFormation pile soit en état de terminal avant de la supprimer.

  41. aws:executeAwsApi— Supprime la AWS CloudFormation pile, y compris l'EC2instance Amazon temporaire.