Solução de problemas de login do SO

Neste documento, descrevemos como solucionar problemas de login do SO usando o servidor de metadados. Para informações sobre como configurar o Login do SO ou para instruções detalhadas, consulte Como configurar o Login do SO.

É possível consultar o servidor de metadados de dentro de uma instância do Compute Engine. Para mais informações, consulte Como armazenar e recuperar metadados de instância.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud , não é necessário configurar a autenticação.

    gcloud

    1. Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  • Defina uma região e uma zona padrão.
  • REST

    Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a CLI do Google Cloud.

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Mensagens de erro comuns

Veja a seguir exemplos de erros comuns que você pode encontrar ao usar o Login do SO.

Não é possível encontrar o nome do grupo

Ao usar o Login do SO em algumas instâncias de computação, talvez você receba a seguinte mensagem de erro após a conexão ser estabelecida:

/usr/bin/id: cannot find name for group ID 123456789

Ignore essa mensagem de erro. Esse erro não afeta suas instâncias de computação.

Falha ao receber grupos

É possível que você veja registros semelhantes aos seguintes ao criar instâncias de computação:

Dec 10 22:31:05 instance-1 google_oslogin_nss_cache[381]: oslogin_cache_refresh[381]: Refreshing group entry cache
Dec 10 22:31:05 instance-1 google_oslogin_nss_cache[381]: oslogin_cache_refresh[381]: Failure getting groups, quitting

Esses registros indicam que a organização não tem grupos do Login do SO do Linux configurados. Ignore essas mensagens.

Falha na pré-condição

Talvez você observe um erro semelhante ao seguinte ao se conectar à instância de computação usando SSH:

ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: The specified username or UID is not unique within given system ID.

Esse erro ocorre quando o Login do SO tenta gerar um nome de usuário que já existe em uma organização. Isso é comum quando uma conta de usuário é excluída e um novo usuário com o mesmo endereço de e-mail é criado logo em seguida. Depois que uma conta de usuário é excluída, pode levar até 48 horas para as informações serem removidas do POSIX do usuário.

Para resolver esse problema, faça uma das seguintes ações:

O limite de tamanho do perfil de Login do SO foi excedido

Talvez você veja um dos seguintes erros ao se conectar a uma instância de computação do Linux usando SSH ou SCP para transferir arquivos:

ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: Login profile size exceeds 32 KiB. Delete profile values to make additional space.
ERROR: (gcloud.compute.scp) INVALID_ARGUMENT: Login profile size exceeds 32 KiB. Delete profile values to make additional space.

O Login do SO armazena informações do usuário, incluindo chaves públicas SSH, em uma conta POSIX com um limite de tamanho de 32 KiB por usuário. Se o perfil do Login do SO exceder esse limite ou se você tiver mais de 64 chaves SSH no perfil, não será possível adicionar outras chaves SSH a ele, o que impede a conexão com VMs usando SSH.

Para resolver esses erros, faça o seguinte:

  1. Verifique o tamanho do seu perfil do Login do SO. Para verificar o tamanho do perfil, exporte-o para um arquivo JSON temporário e verifique o tamanho do arquivo executando o seguinte comando:

    gcloud compute os-login describe-profile --format="json" | wc
    

    Se o tamanho estiver próximo ou exceder 32 KiB, remova as chaves SSH não utilizadas.

  2. Revise seu perfil do Login do SO para identificar as chaves SSH não usadas:

    gcloud compute os-login describe-profile
    

    O resultado será o seguinte:

    name: '00000000000000'
    posixAccounts:
    ...
    sshPublicKeys:
     ...:
       fingerprint: ...
       key: |
         ssh-rsa AAAAB3NzaC1yc2...
       name: ...
     ...
    
  3. Remova as chaves não utilizadas usando o comando gcloud compute os-login ssh-keys remove:

    gcloud compute os-login ssh-keys remove --key=KEY
    

    Substitua KEY pela impressão digital da chave ou pela string completa da chave pública SSH.

Como alternativa, para evitar a geração de novas chaves ao se conectar a VMs, faça o seguinte:

  • Reutilize um par de chaves especificando a flag --ssh-key-file com o comando gcloud compute ssh:

    gcloud compute ssh VM_NAME --ssh-key-file=PATH_TO_PRIVATE_KEY
    
  • Se você se conecta com frequência a VMs usando SSH com a CLI gcloud, crie um par de chaves SSH padrão chamado google_compute_engine no diretório .ssh/. A CLI gcloud usa esse par de chaves, se ele existir, e não gera um novo a cada conexão. Para gerar um par de chaves padrão, execute:

    ssh-keygen -t rsa -f ~/.ssh/google_compute_engine -C USERNAME -b 2048
    

    Em seguida, adicione a chave pública ao seu perfil de Login do SO:

    gcloud compute os-login ssh-keys add --key-file=~/.ssh/google_compute_engine.pub
    

Cloud Build

Se você usa o Cloud Build e o perfil de Login do SO da sua conta de serviço excede o limite de 32 KiB, talvez ocorram falhas de conexão SSH e a seguinte mensagem de erro: Login profile size exceeds 32 KiB.... Para resolver esse problema, configure o Cloud Build para usar contas de serviço especificadas pelo usuário em vez da conta de serviço padrão do Cloud Build.

Para evitar que esse problema ocorra no futuro, adicione um prazo de validade para as chaves SSH. As chaves expiradas são removidas automaticamente do perfil de login 48 horas após a expiração ou quando você adiciona uma nova chave ao perfil.

Código de resposta HTTP: 429

O seguinte erro pode aparecer quando você tentar se conectar a uma instância de computação usando SSH:

Failed to validate organization user USERNAME has login permission, got HTTP response code: 429

Esse problema é causado pela limitação de taxa do servidor de metadados de 100 consultas por segundo por instância de computação. Não é possível ajustar esse limite. Para resolver esse problema, aguarde alguns segundos e tente se conectar novamente.

Para evitar esse problema no futuro, tente o seguinte:

  • Implementar um mecanismo de nova tentativa no código do aplicativo. Confira mais informações em:
  • Reutilizar as conexões SSH atuais.
  • Envie comandos em lotes para reduzir as conexões SSH e as consultas de metadados do Login do SO.

Entradas de metadados de Login do SO padrão

O Compute Engine define um conjunto de entradas de metadados padrão que veiculam informações de Login do SO. Os metadados padrão sempre são definidos e configurados no servidor. As chaves de metadados padrão diferenciam maiúsculas de minúsculas.

A tabela a seguir descreve as entradas que você pode consultar.

Relativo a http://metadata.google.internal/computeMetadata/v1/
Entrada de metadados Descrição
project/attributes/enable-oslogin Verifica se o Login do SO está ativado no projeto atual do Google Cloud .
instance/attributes/enable-oslogin Verifica se o Login do SO está ativado na instância de computação atual.
oslogin/users/ Recupera informações de perfil para usuários do Login do SO. É possível transmitir parâmetros de consulta como username, uid, pagesize e pagetoken.
oslogin/authorize/

Recupera as configurações de permissão de login ou nível administrativo para um usuário de Login do SO.

Para verificar uma permissão, especifique o parâmetro de consulta policy. O valor do parâmetro de política precisa ser definido como login (para verificar a permissão de login) ou adminLogin (para verificar o acesso ao sudo).

Como verificar se o Login do SO está configurado

Use o console do Google Cloud ou a Google Cloud CLI para consultar metadados de modo a determinar se o Login do SO está ativado. O Login do SO é ativado quando a chave de metadados enable-oslogin é definida como TRUE nos metadados do projeto ou da instância. Se os metadados da instância e do projeto forem definidos, o valor definido nos metadados da instância terá precedência.

Como visualizar usuários de Login do SO

Para ver as informações de perfil de vários usuários, especifique o parâmetro pagesize. Substitua pagesize pelo valor numérico necessário.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=PAGE_SIZE" -H "Metadata-Flavor: Google"

A saída pode conter um token de página, que pode ser usado em chamadas subsequentes para listar mais usuários.

Por exemplo, para definir pagesize como 1, execute o seguinte comando:

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1" -H "Metadata-Flavor: Google"

Para receber o próximo usuário, defina pagesize como 1 e pagetoken como o token de página da saída do comando anterior.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1&pagetoken=PAGE_TOKEN" -H "Metadata-Flavor: Google"

Na maioria das distribuições, também é possível executar o comando Unix getent passwd para recuperar as entradas de senha para usuários da organização.

Como visualizar um usuário específico do Login do SO

Para ver as informações de perfil de um usuário específico na instância de computação, execute o seguinte comando:

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=USERNAME" -H "Metadata-Flavor: Google"

Substitua USERNAME pelo nome de usuário do usuário que você quer consultar.

Por exemplo, é executar uma solicitação para procurar o usuário user_example_com. O comando e a saída a seguir mostram uma formatação adicional para melhorar a legibilidade.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"

A resposta será semelhante a:

{
    "loginProfiles": [{
        "name": "12345678912345",
        "posixAccounts": [{
            "primary": true,
            "username": "user_example_com",
            "uid": "123451",
            "gid": "123451",
            "homeDirectory": "/home/user_example_com",
            "operatingSystemType": "LINUX"
        }],
        "sshPublicKeys": {
            "204c4b4fb...": {
                "key": "ssh-rsa AAAAB3Nz...",
                "fingerprint": "204c4b4fb..."
            }
        }
    }]
}

Na maioria das distribuições, também é possível executar comandos Unix, como getent passwd username ou getent passwd uid, para recuperar informações de perfil.

Para recuperar as chaves SSH de um usuário, também é possível executar /usr/bin/google_authorized_keys USERNAME. Se nenhuma chave for retornada, talvez o usuário não tenha as permissões necessárias para fazer login na instância de computação.

Como verificar as permissões de login

Para ver as permissões de login e nível administrativo, é necessário fornecer os parâmetros de consulta policy=login&email=LOGIN_NAME.

  1. Consulte o perfil de usuário para acessar o valor do campo name:

    curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"
  2. Na saída, anote o name.

  3. Execute o comando login a seguir usando o valor de name:

    curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=LOGIN_NAME" -H "Metadata-Flavor: Google"
    

Por exemplo, é possível consultar as permissões de login do usuário user_example_com que foi visualizado na seção anterior.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=12345678912345" -H "Metadata-Flavor: Google"

A resposta ao comando indica que o usuário está autorizado a fazer login na instância de computação:

{"success":true}

Como verificar se a instância de computação tem uma conta de serviço

É possível consultar o servidor de metadados para encontrar a conta de serviço associada à sua instância de computação. Faça login na instância de computação e execute o seguinte comando:

curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" -H "Metadata-Flavor: Google"

O resultado será o seguinte:

12345-sa@developer.gserviceaccount.com/
default/

Se nenhuma conta de serviço for encontrada, a saída ficará em branco.

Problemas de SSH com a 2FA ativada

As seções a seguir explicam como o Login do SO com autenticação de dois fatores (2FA) é configurado na instância e como resolver erros de conexão SSH quando a 2FA está ativada.

Autenticação de dois fatores

A 2FA adiciona uma camada extra de segurança ao Login do SO. Se a conta de um usuário na sua organização for comprometida, o acesso SSH às instâncias de computação vai permanecer protegido até que um segundo fator seja autenticado.

Quando você define a chave de metadados enable-oslogin-2fa como TRUE, o agente convidado adiciona a seguinte configuração de PAM para 2FA ao topo do arquivo /etc/pam.d/sshd:

auth       [success=done perm_denied=die default=ignore] pam_oslogin_login.so

O agente convidado também atualiza o arquivo de configuração do OpenSSH em todo o sistema, /etc/ssh/sshd_config. O agente convidado não exclui os pares de argumento de palavra-chave configurados anteriormente do arquivo, mas como o OpenSSH usa o primeiro valor para cada parâmetro, o agente convidado adiciona as seguintes linhas ao topo do arquivo /etc/ssh/sshd_config:

AuthenticationMethods publickey,keyboard-interactive
ChallengeResponseAuthentication yes

Resolver erros de conexão da 2FA

Quando você se conecta a uma instância de computação usando SSH com a 2FA ativada, o Cloud Shell pode retornar uma mensagem de erro genérica Permission denied (keyboard-interactive) ou not authorized sem especificar o motivo da falha:

Permission denied (keyboard-interactive)
ERROR: (gcloud.compute.start-iap-tunnel) Error while connecting [4033: 'not authorized'].
kex_exchange_identification: Connection closed by remote host
Connection closed by UNKNOWN port 65535

ERROR: (gcloud.compute.ssh) [/usr/bin/ssh] exited with return code [255].

Se você tiver problemas para se conectar a uma instância de computação usando SSH quando a 2FA estiver ativada, siga estas etapas:

  1. Para isolar se o problema é causado pela 2FA, remova a definição da chave de metadados enable-oslogin-2fa ou defina-a como FALSE e tente se conectar à instância de computação. Se a instância de computação continuar inacessível, é improvável que o problema seja com a 2FA.

  2. Se você conseguir acessar a instância de computação depois de desativar a 2FA, procure mensagens de erro de 2FA nos arquivos de registro no diretório /var/log/ para determinar por que a 2FA falhou.

  3. Enquanto estiver conectado à instância, reative enable-oslogin-2fa e verifique se o agente convidado atualizou os arquivos /etc/pam.d/sshd e /etc/ssh/sshd_config. Por exemplo, verifique os carimbos de data/hora de modificação com o comando ls -l. Confirme se os arquivos contêm as entradas obrigatórias pam_oslogin_login.so, AuthenticationMethods publickey,keyboard-interactive e ChallengeResponseAuthentication yes descritas em Autenticação de dois fatores.

  4. Para verificar se a conexão falhou porque a verificação em duas etapas (2SV) não está ativada na sua Conta do Google ou no seu domínio, filtre os registros de auditoria do Login do SO ou os arquivos de registro no diretório /var/log/ para encontrar a seguinte mensagem de erro:

    "message": "The caller does not have permission"
    
          "@type": "type.googleapis.com/google.cloud.oslogin.v1.StartSessionRequest",
          "supportedChallengeTypes": [
            "INTERNAL_TWO_FACTOR",
            "SECURITY_KEY_OTP",
            "AUTHZEN",
            "TOTP",
            "IDV_PREREGISTERED_PHONE"
          ],
    

    Essa mensagem de erro é registrada quando você não ativa a verificação em duas etapas na sua Conta do Google ou no seu domínio. O cliente SSH também pode retornar o erro No supported authentication methods available (server sent: keyboard-interactive).

    Para verificar se a 2SV está ativada na sua conta, acesse as configurações de segurança da Conta do Google. Se a conta não tiver a verificação em duas etapas ativada, nenhuma caixa de diálogo vai solicitar um código de segurança, e a tentativa de login vai falhar com um erro Permission denied genérico.

    Você também pode entrar em contato com o administrador do Google Workspace para verificar se a verificação em duas etapas está ativada no seu domínio.

  5. Se a propriedade response.challenges dos registros de auditoria ContinueSession do Login do SO mostrar qualquer status diferente de 'READY', isso pode indicar um problema com o desafio de autenticação que você está usando. O exemplo a seguir mostra problemas com o código de verificação por mensagem de texto ou de voz que não está sendo enviado ao seu smartphone para concluir o processo de login:

    "response": {
        "challenges": [
          {
            "challengeId": 2,
            "challengeType": "IDV_PREREGISTERED_PHONE",
            "status": "RETRYABLE_ERROR"
          }
    

    Você pode usar outro método de verificação, como o Google Authenticator, para restringir o problema. Se você conseguir se conectar usando outro método de verificação, mas não receber códigos de verificação por mensagem de texto no smartphone registrado e encontrar RETRYABLE_ERROR para IDV_PREREGISTERED_PHONE nos registros, entre em contato com o suporte do Google Workspace.

A seguir