AWSSupport-ResetLinuxUserPassword - AWS Systems Manager Referência do runbook de automação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWSSupport-ResetLinuxUserPassword

Descrição

O runbook AWSSupport-ResetLinuxUserPassword ajuda você a redefinir a senha de um usuário do sistema operacional (SO) local. Esse runbook é especialmente útil para usuários que precisam acessar suas instâncias do Amazon Elastic Compute Cloud EC2 (Amazon) usando o console serial. O runbook cria uma EC2 instância temporária da Amazon em sua função Conta da AWS e uma função AWS Identity and Access Management (IAM) com permissões para recuperar um valor AWS Secrets Manager secreto contendo a senha.

O runbook interrompe sua EC2 instância de destino da Amazon, separa o volume raiz do Amazon Elastic Block Store (Amazon EBS) e o anexa à instância temporária da Amazon. EC2 Usando o comando Executar, um script é executado na instância temporária para definir a senha do usuário do sistema operacional que você especificar. Em seguida, o volume raiz do Amazon EBS é reconectado à sua instância de destino. O runbook também oferece uma opção para criar um snapshot do volume raiz no início da automação.

Antes de começar

Crie um segredo do Secrets Manager com o valor da senha que você deseja atribuir ao usuário do sistema operacional. O valor deve estar em texto simples. Para obter mais informações, consulte Criar um AWS Secrets Manager segredo no AWS Secrets Manager Guia do usuário.

Considerações

  • Recomendamos fazer backup da sua instância antes de usar este runbook. Considere definir o valor do parâmetro CreateSnapshot como Yes.

  • A alteração da senha do usuário local exige que o runbook interrompa sua instância. Quando uma instância é interrompida, os dados armazenados na memória ou nos volumes de armazenamento da instância são perdidos. Além disso, todos os IPv4 endereços públicos atribuídos automaticamente são liberados. Para obter mais informações sobre o que acontece quando você interrompe uma instância, consulte Pare e inicie sua instância no Guia EC2 do usuário da Amazon.

  • Se os volumes do Amazon EBS anexados à sua EC2 instância Amazon de destino forem criptografados com uma chave gerenciada pelo cliente AWS Key Management Service (AWS KMS), certifique-se de que a AWS KMS chave não seja deleted disabled ou sua instância não iniciará.

Executar esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

Linux

Parâmetros

  • AutomationAssumeRole

    Tipo: String

    Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.

  • InstanceId

    Tipo: string

    Descrição: (Obrigatório) O ID da instância Amazon EC2 Linux que contém a senha de usuário do sistema operacional que você deseja redefinir.

  • LinuxUserName

    Tipo: string

    Padrão: ec2-user

    Descrição: (opcional) a conta de usuário do sistema operacional cuja senha você deseja redefinir.

  • SecretArn

    Tipo: string

    Descrição: (obrigatório) o ARN do segredo do Secrets Manager contendo a nova senha.

  • SecurityGroupId

    Tipo: string

    Descrição: (Opcional) O ID do grupo de segurança a ser anexado à EC2 instância temporária da Amazon. Se você não fornecer um valor para esse parâmetro, o grupo de segurança padrão da Amazon Virtual Private Cloud (Amazon VPC) é usado.

  • SubnetId

    Tipo: string

    Descrição: (Opcional) O ID da sub-rede na qual você deseja iniciar a instância EC2 temporária da Amazon. Por padrão, a automação escolhe a mesma sub-rede da sua instância de destino. Se você optar por fornecer uma sub-rede diferente, ela deve estar na mesma zona de disponibilidade da instância de destino e ter acesso aos endpoints do Systems Manager.

  • CreateSnapshot

    Tipo: string

    Valores válidos: sim | não

    Padrão: sim

    Descrição: (Opcional) Determina se um snapshot do volume raiz da sua EC2 instância Amazon de destino é criado antes da execução da automação.

  • StopConsent

    Tipo: string

    Valores válidos: sim | não

    Padrão: não

    Descrição: Entre Yes para confirmar que sua EC2 instância de destino da Amazon será interrompida durante essa automação. Quando a EC2 instância da Amazon é interrompida, todos os dados armazenados na memória ou nos volumes de armazenamento da instância são perdidos e o IPv4 endereço público automático é liberado. Para obter mais informações, consulte Pare e inicie sua instância no Guia EC2 do usuário da Amazon.

Permissões obrigatórias do IAM

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.

  • 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

Etapas do documento

  1. aws:branch— Filiais com base no fato de você ter fornecido consentimento para interromper a EC2 instância de destino da Amazon.

  2. aws:assertAwsResourceProperty— Garante que o status da EC2 instância Amazon esteja em um stopped estado running ou. Caso contrário, a automação termina.

  3. aws:executeAwsApi— Obtém as propriedades da EC2 instância Amazon.

  4. aws:executeAwsApi— Obtém as propriedades do volume raiz.

  5. aws:branch— Ramifica a automação dependendo se um ID de sub-rede para a EC2 instância temporária da Amazon foi fornecido.

  6. aws:assertAwsResourceProperty— Garante que a sub-rede especificada no SubnetId parâmetro esteja na mesma zona de disponibilidade da EC2 instância de destino da Amazon.

  7. aws:assertAwsResourceProperty— Garante que o volume raiz da EC2 instância Amazon de destino seja um volume do Amazon EBS.

  8. aws:assertAwsResourceProperty— Garante que a arquitetura da EC2 instância Amazon seja arm64 oux86_64.

  9. aws:assertAwsResourceProperty— Garante que o comportamento de desligamento da EC2 instância Amazon seja stop ou nãoterminate.

  10. aws:branch— Garante que a EC2 instância da Amazon não seja uma instância spot. Caso contrário, a automação termina.

  11. aws:executeScript— Garante que a EC2 instância da Amazon não faça parte de um grupo de auto scaling. Se a instância fizer parte de um grupo de auto scaling, a automação confirma que a EC2 instância da Amazon está em um estado de ciclo de Standby vida.

  12. aws:createStack— Cria uma EC2 instância temporária da Amazon que é usada para redefinir a senha do usuário do sistema operacional que você especificar.

  13. aws:waitForAwsResourceProperty— Espera até que a EC2 instância temporária recém-lançada da Amazon esteja em execução.

  14. aws:executeAwsApi— Obtém o ID da EC2 instância temporária da Amazon.

  15. aws:waitForAwsResourceProperty— Espera que a EC2 instância temporária da Amazon seja reportada conforme gerenciada pelo Systems Manager.

  16. aws:changeInstanceState— Interrompe a EC2 instância de destino da Amazon.

  17. aws:changeInstanceState— Força a EC2 instância de destino da Amazon a parar caso ela fique presa em um estado de parada.

  18. aws:branch— Ramifica a automação dependendo se um snapshot do volume raiz da EC2 instância de destino da Amazon foi solicitado.

  19. aws:executeAwsApi— Cria um snapshot do volume raiz da EC2 instância Amazon de destino do Amazon EBS.

  20. aws:waitForAwsResourceProperty— Espera que o instantâneo esteja em um completed estado.

  21. aws:executeAwsApi— Separa o volume raiz do Amazon EBS da instância de destino da Amazon EC2 .

  22. aws:waitForAwsResourceProperty— Espera que o volume raiz do Amazon EBS seja separado da instância de destino da Amazon. EC2

  23. aws:executeAwsApi— Anexa o volume raiz do Amazon EBS à instância temporária da Amazon EC2 .

  24. aws:waitForAwsResourceProperty— Espera que o volume raiz do Amazon EBS seja anexado à instância temporária da Amazon EC2 .

  25. aws:runCommand— Redefine a senha do usuário de destino executando um script de shell usando o Run Command na EC2 instância temporária da Amazon.

  26. aws:executeAwsApi— Separa o volume raiz do Amazon EBS da instância temporária da Amazon EC2 .

  27. aws:waitForAwsResourceProperty— Espera que o volume raiz do Amazon EBS seja separado da instância temporária da Amazon. EC2

  28. aws:executeAwsApi— Separa o volume raiz do Amazon EBS da EC2 instância temporária da Amazon após um erro.

  29. aws:waitForAwsResourceProperty— Espera que o volume raiz do Amazon EBS seja separado da EC2 instância temporária da Amazon após um erro.

  30. aws:branch— Ramifica a automação dependendo se um instantâneo do volume raiz foi solicitado para determinar o caminho de recuperação em caso de erro.

  31. aws:executeAwsApi— Reconecta o volume raiz do Amazon EBS à instância de destino da Amazon. EC2

  32. aws:waitForAwsResourceProperty— Espera que o volume raiz do Amazon EBS seja anexado à instância da Amazon EC2 .

  33. aws:executeAwsApi— Cria um novo volume do Amazon EBS a partir do snapshot do volume raiz da EC2 instância Amazon de destino.

  34. aws:waitForAwsResourceProperty— Espera até que o novo volume do Amazon EBS esteja em um available estado.

  35. aws:executeAwsApi— Anexa o novo volume do Amazon EBS à instância de destino como volume raiz.

  36. aws:waitForAwsResourceProperty— Espera que o volume do Amazon EBS esteja em um attached estado.

  37. aws:executeAwsApi— Descreve os eventos da CloudFormation pilha se os runbooks falharem em criar ou atualizar a CloudFormation pilha.

  38. aws:branch— Ramifica a automação de acordo com o estado anterior da EC2 instância Amazon. Se o estado foi running, a instância será iniciada. Se estivesse em um estado stopped, a automação continua.

  39. aws:changeInstanceState— Inicia a EC2 instância da Amazon, se necessário.

  40. aws:waitForAwsResourceProperty— Espera até que a CloudFormation pilha esteja em um status de terminal antes de excluí-la.

  41. aws:executeAwsApi— Exclui a CloudFormation pilha, incluindo a instância temporária da Amazon EC2 .