AWSSupport-ResetLinuxUserPassword - AWS Systems Manager Guide de 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 (Amazon EC2) à l'aide de la console série. Le runbook crée une EC2 instance Amazon temporaire dans votre rôle Compte AWS et dans un rôle 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 (Amazon EBS) racine et l'attache à l'instance Amazon temporaire. EC2 À 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 volume Amazon EBS 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 volumes Amazon EBS 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) L'ARN de votre secret Secrets Manager contenant le nouveau mot de passe.

  • SecurityGroupId

    Type : String

    Description : (Facultatif) L'ID du groupe de sécurité à associer à l' EC2 instance Amazon temporaire. Si vous ne fournissez aucune valeur pour ce paramètre, le groupe de sécurité Amazon Virtual Private Cloud (Amazon VPC) 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' EC2 instance 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' IPv4 adresse 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.

Autorisations IAM 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' EC2 instance Amazon cible.

  2. aws:assertAwsResourceProperty— Garantit que le statut de l' EC2 instance 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' EC2 instance 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' EC2 instance 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' EC2 instance Amazon cible.

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

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

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

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

  11. aws:executeScript— Garantit que l' EC2 instance 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' EC2 instance 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' EC2 instance 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' EC2 instance 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' EC2 instance Amazon cible a été demandé ou non.

  19. aws:executeAwsApi— Crée un instantané du volume Amazon EBS 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 racine Amazon EBS de l'instance Amazon EC2 cible.

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

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

  24. aws:waitForAwsResourceProperty— Attend que le volume racine Amazon EBS soit attaché à l'instance Amazon EC2 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' EC2 instance Amazon temporaire.

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

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

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

  29. aws:waitForAwsResourceProperty— Attend que le volume racine Amazon EBS soit détaché de l' EC2 instance 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 volume Amazon EBS racine à l'instance Amazon EC2 cible.

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

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

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

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

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

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

  38. aws:branch— Divise l'automatisation en fonction de l'état précédent de l' EC2 instance 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' EC2 instance Amazon si nécessaire.

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

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