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
-
Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud initAo 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:
- Restaure a conta excluída.
- Remova as informações de POSIX da conta antes de excluí-la.
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:
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.
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: ... ...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
KEYpela 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-filecom o comandogcloud 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_engineno 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
|
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.
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"
Na saída, anote o
name.Execute o comando
logina seguir usando o valor dename: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:
Para isolar se o problema é causado pela 2FA, remova a definição da chave de metadados
enable-oslogin-2faou defina-a comoFALSEe 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.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.Enquanto estiver conectado à instância, reative
enable-oslogin-2fae verifique se o agente convidado atualizou os arquivos/etc/pam.d/sshde/etc/ssh/sshd_config. Por exemplo, verifique os carimbos de data/hora de modificação com o comandols -l. Confirme se os arquivos contêm as entradas obrigatóriaspam_oslogin_login.so,AuthenticationMethods publickey,keyboard-interactiveeChallengeResponseAuthentication yesdescritas em Autenticação de dois fatores.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 deniedgené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.
Se a propriedade
response.challengesdos registros de auditoriaContinueSessiondo 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_ERRORparaIDV_PREREGISTERED_PHONEnos registros, entre em contato com o suporte do Google Workspace.
A seguir
- Saiba mais sobre o Login do SO.
- Saiba como as conexões SSH com instâncias do Linux funcionam no Compute Engine.
- Para instruções detalhadas, siga um dos seguintes procedimentos:
- Leia Como gerenciar o Login do SO em uma organização.