En este documento, se describe cómo solucionar problemas de Acceso al SO mediante el servidor de metadatos. Para obtener información sobre la configuración de Acceso al SO o si quieres obtener instrucciones paso a paso, consulta Configura Acceso al SO.
Puedes consultar el servidor de metadatos desde una instancia de Compute Engine. Para obtener más información, consulta la sección sobre cómo almacenar y recuperar metadatos de instancias.
Antes de empezar
-
Si aún no lo hiciste, configura la autenticación.
La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar
código o muestras desde un entorno de desarrollo local, puedes autenticarte en
Compute Engine seleccionando una de las siguientes opciones:
Selecciona la pestaña según cómo planeas usar las muestras de esta página:
Console
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
-
- Configura una región y una zona predeterminadas.
REST
Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.
Instala Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .
Mensajes de error comunes:
Los siguientes son ejemplos de errores comunes que pueden surgir cuando usas Acceso al SO.
No se puede encontrar el nombre del grupo
En algunas instancias de procesamiento que usan el Acceso al SO, es posible que recibas el siguiente mensaje de error después de establecer la conexión:
/usr/bin/id: cannot find name for group ID 123456789
Ignora este mensaje de error. Este error no afecta tus instancias de procesamiento.
Error en la obtención de grupos
Es posible que veas registros similares a los siguientes cuando crees instancias de procesamiento:
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
Estos registros indican que tu organización no tiene configurados grupos de Linux de Acceso al SO. Ignora estos mensajes.
Precondición con errores
Es posible que veas un error similar al siguiente cuando te conectes a la instancia de procesamiento con SSH:
ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: The specified username or UID is not unique within given system ID.
Este error se produce cuando el Acceso al SO intenta generar un nombre de usuario que ya existe dentro de una organización. Esto es común cuando se borra una cuenta de usuario y se crea un usuario nuevo con la misma dirección de correo electrónico poco después. Cuando se borra una cuenta de usuario, pueden pasar hasta 48 horas para que se quite la información POSIX del usuario.
Para solucionar este problema, realiza una de las siguientes acciones:
- Restablece la cuenta borrada.
- Quita la información de POSIX de la cuenta antes de borrarla.
Se superó el límite de tamaño del perfil de Acceso al SO
Es posible que veas uno de los siguientes errores cuando te conectes a una instancia de procesamiento de Linux con SSH o uses SCP para transferir archivos:
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.
El Acceso al SO almacena la información del usuario, incluidas las claves públicas SSH, en una cuenta POSIX que tiene un límite de tamaño de 32 KiB por usuario. Si tu perfil de Acceso al SO supera este límite o si tienes más de 64 claves SSH en tu perfil, no podrás agregarle claves SSH adicionales, lo que te impedirá conectarte a las VMs con SSH.
Para resolver estos errores, haz lo siguiente:
Verifica el tamaño de tu perfil de Acceso al SO. Para verificar el tamaño de tu perfil, expórtalo a un archivo JSON temporal y verifica el tamaño del archivo ejecutando el siguiente comando:
gcloud compute os-login describe-profile --format="json" | wc
Si el tamaño se acerca a los 32 KiB o los supera, debes quitar las claves SSH que no se usen.
Revisa tu perfil de Acceso al SO para identificar las claves SSH que no se usen:
gcloud compute os-login describe-profile
El resultado es similar a lo siguiente:
name: '00000000000000' posixAccounts: ... sshPublicKeys: ...: fingerprint: ... key: | ssh-rsa AAAAB3NzaC1yc2... name: ... ...Quita las claves sin usar con el comando
gcloud compute os-login ssh-keys remove:gcloud compute os-login ssh-keys remove --key=KEY
Reemplaza
KEYpor la huella digital de la clave o la cadena de clave pública SSH completa.
Como alternativa, para evitar generar claves nuevas cuando te conectas a las VMs, puedes realizar una de las siguientes acciones:
Reutiliza un par de claves existente especificando la marca
--ssh-key-filecon el comandogcloud compute ssh:gcloud compute ssh VM_NAME --ssh-key-file=PATH_TO_PRIVATE_KEY
Si te conectas con frecuencia a las VMs a través de SSH con la gcloud CLI, crea un par de claves SSH predeterminado llamado
google_compute_engineen tu directorio.ssh/. La línea de comandos de gcloud CLI usa este par de claves si existe y no genera uno nuevo en cada conexión. Para generar un par de claves predeterminado, ejecuta el siguiente comando:ssh-keygen -t rsa -f ~/.ssh/google_compute_engine -C USERNAME -b 2048
Luego, agrega la clave pública a tu perfil de Acceso al SO:
gcloud compute os-login ssh-keys add --key-file=~/.ssh/google_compute_engine.pub
Cloud Build
Si usas Cloud Build y el perfil de Acceso al SO de tu cuenta de servicio supera el límite de 32 KiB, es posible que se produzcan fallas en la conexión SSH y que veas
el siguiente mensaje de error: Login profile size exceeds 32 KiB.... Para resolver este problema, puedes
configurar Cloud Build para que
use cuentas de servicio especificadas por el usuario
en lugar de la cuenta de servicio predeterminada de Cloud Build.
Para evitar que este problema ocurra en el futuro, agrega un hora de vencimiento para las claves SSH. Las claves vencidas se quitan automáticamente de tu perfil de acceso 48 horas después de su vencimiento o cuando agregas una clave nueva a tu perfil.
Código de respuesta HTTP: 429
Es posible que veas el siguiente error cuando intentes conectarte a una instancia de procesamiento con SSH:
Failed to validate organization user USERNAME has login permission, got HTTP response code: 429
Este problema se debe al límite de frecuencia del servidor de metadatos de 100 consultas por segundo por instancia de procesamiento. Este límite no se puede ajustar. Para resolver este problema, espera unos segundos y, luego, vuelve a intentar la conexión.
Para evitar este problema en el futuro, prueba lo siguiente:
- Implementa un mecanismo de reintento en el código de la aplicación. Para obtener más información, consulta
- Reutilizar las conexiones SSH existentes.
- Envía comandos por lotes para reducir las conexiones SSH y las consultas de metadatos de Acceso al SO.
Entradas de metadatos predeterminados de Acceso al SO
Compute Engine define un conjunto de entradas de metadatos predeterminados que proporcionan información sobre el Acceso al SO. El servidor siempre define y establece los metadatos predeterminados. Las claves de metadatos predeterminadas distinguen entre mayúsculas y minúsculas.
En la siguiente tabla, se describen las entradas que puedes consultar.
Relativo a http://metadata.google.internal/computeMetadata/v1/ |
|
|---|---|
| Entrada de metadatos | Descripción |
project/attributes/enable-oslogin |
Comprueba si el Acceso al SO está habilitado en el proyecto de Google Cloud actual. |
instance/attributes/enable-oslogin |
Comprueba si el Acceso al SO está habilitado en la instancia de procesamiento actual. |
oslogin/users/ |
Recupera información de perfil para los usuarios del Acceso al SO.
Puedes pasar parámetros de consulta como username, uid, pagesize y pagetoken.
|
oslogin/authorize/ |
Recupera la configuración de permisos de nivel administrativo o de acceso para un usuario del Acceso al SO.
Para verificar un permiso, debes especificar el parámetro de consulta |
Comprueba si el Acceso al SO está configurado
Usa la consola de Google Cloud o Google Cloud CLI para consultar los metadatos
y determinar si el Acceso al SO está habilitado. El Acceso al SO se habilita cuando la clave de metadatos
enable-oslogin se configura como TRUE en los metadatos del proyecto o la
instancia. Si se configuran los metadatos de la instancia y del proyecto, el valor establecido en los metadatos de la instancia tiene prioridad.
Visualiza los usuarios del Acceso al SO
Para ver la información del perfil de varios usuarios, puedes especificar el
parámetro pagesize. Reemplaza pagesize por el
valor numérico requerido.
curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=PAGE_SIZE" -H "Metadata-Flavor: Google"
El resultado puede contener un token de página, que se puede usar en llamadas posteriores para enumerar más usuarios.
Por ejemplo, para establecer pagesize en 1, ejecuta el siguiente comando:
curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1" -H "Metadata-Flavor: Google"
Para obtener el siguiente usuario, establece pagesize en 1 y pagetoken en el token de página del resultado del comando anterior.
curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1&pagetoken=PAGE_TOKEN" -H "Metadata-Flavor: Google"
En la mayoría de las distribuciones, también puedes ejecutar el comando getent passwd de Unix para recuperar las entradas de contraseña de los usuarios de la organización.
Visualiza un usuario específico del Acceso al SO
Para ver la información del perfil de un usuario específico en tu instancia de procesamiento, ejecuta el siguiente comando:
curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=USERNAME" -H "Metadata-Flavor: Google"
Reemplaza USERNAME por el nombre de usuario del usuario que deseas consultar.
Por ejemplo, puedes realizar una solicitud para buscar el usuario user_example_com.
El siguiente comando y el resultado muestran el formato agregado para mejorar la legibilidad.
curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"
El resultado es similar al siguiente:
{
"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..."
}
}
}]
}En la mayoría de las distribuciones, también puedes ejecutar comandos de Unix como getent passwd username o getent passwd uid para recuperar la información de perfil.
Para recuperar las claves SSH de un usuario, también puedes ejecutar /usr/bin/google_authorized_keys USERNAME.
Si no se devuelven claves, es posible que el usuario no tenga los permisos necesarios para acceder
a la instancia de procesamiento.
Verifica los permisos de acceso
Para ver los permisos de nivel administrativo y de acceso, debes proporcionar los parámetros de consulta policy=login&email=LOGIN_NAME.
Consulta el perfil del usuario para obtener el valor del campo
name:curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"
En el resultado, toma nota del
name.Ejecuta el siguiente comando de
logincon el valor dename:curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=LOGIN_NAME" -H "Metadata-Flavor: Google"
Por ejemplo, puedes consultar los permisos de acceso para el usuario user_example_com que se vio en la sección anterior.
curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=12345678912345" -H "Metadata-Flavor: Google"
El resultado del comando indica que el usuario está autorizado para acceder a la instancia de procesamiento:
{"success":true}Verifica si tu instancia de procesamiento tiene una cuenta de servicio
Puedes consultar el servidor de metadatos para encontrar la cuenta de servicio asociada con tu instancia de procesamiento. Accede a tu instancia de procesamiento y ejecuta el siguiente comando:
curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" -H "Metadata-Flavor: Google"
El resultado es similar a lo siguiente:
12345-sa@developer.gserviceaccount.com/ default/
Si no se encuentra una cuenta de servicio, el resultado está en blanco.
Problemas de SSH con la 2FA habilitada
En las siguientes secciones, se explica cómo se configura el Acceso al SO con autenticación de dos factores (2FA) en tu instancia y cómo solucionar problemas de conexión SSH cuando la 2FA está habilitada.
Autenticación de dos factores
La 2FA agrega una capa de seguridad adicional al Acceso al SO. Si se vulnera la cuenta de un usuario de tu organización, el acceso SSH a tus instancias de procesamiento permanecerá protegido hasta que se autentique un segundo factor.
Cuando estableces la clave de metadatos enable-oslogin-2fa en TRUE, el agente invitado
agrega la siguiente configuración de PAM para la 2FA en la parte superior del
archivo /etc/pam.d/sshd:
auth [success=done perm_denied=die default=ignore] pam_oslogin_login.so
El agente de invitado también actualiza el archivo de configuración de OpenSSH de todo el sistema,
/etc/ssh/sshd_config. El agente invitado no borra los pares de argumento de palabra clave configurados
anteriormente del archivo, pero, como OpenSSH usa el primer valor
para cada parámetro, el agente invitado agrega las siguientes líneas a la parte superior del
archivo /etc/ssh/sshd_config:
AuthenticationMethods publickey,keyboard-interactive
ChallengeResponseAuthentication yes
Cómo solucionar problemas de conexión con la 2FA
Cuando te conectas a una instancia de procesamiento con SSH y la 2FA habilitada,
es posible que Cloud Shell devuelva un mensaje de error genérico
Permission denied (keyboard-interactive) o not authorized
sin especificar el motivo de la falla:
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].
Si tienes problemas para conectarte a una instancia de procesamiento con SSH cuando la 2FA está habilitada, sigue estos pasos:
Para aislar si el problema se debe a la 2FA, desactiva la clave de metadatos
enable-oslogin-2fao establécela enFALSEy, luego, intenta conectarte a la instancia de procesamiento. Si la instancia de procesamiento sigue siendo inaccesible, es poco probable que el problema esté relacionado con la 2FA.Si puedes acceder a la instancia de procesamiento después de inhabilitar la 2FA, busca mensajes de error de 2FA en los archivos de registro del directorio
/var/log/para determinar por qué falló la 2FA.Mientras estás conectado a la instancia, vuelve a habilitar
enable-oslogin-2fay verifica que el agente invitado haya actualizado los archivos/etc/pam.d/sshdy/etc/ssh/sshd_config, por ejemplo, verificando sus marcas de tiempo de modificación con el comandols -l. Confirma que los archivos contengan las entradaspam_oslogin_login.so,AuthenticationMethods publickey,keyboard-interactiveyChallengeResponseAuthentication yesrequeridas que se describen en Autenticación de dos factores.Para verificar si la conexión falló porque la verificación en 2 pasos (2SV) no está habilitada en tu Cuenta de Google o dominio, filtra los registros de auditoría de Acceso al SO o los archivos de registro en el directorio
/var/log/para ver el siguiente mensaje de error:"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" ],Este mensaje de error se registra cuando no habilitaste la 2SV en tu Cuenta de Google o dominio. Es posible que tu cliente SSH también devuelva el error
No supported authentication methods available (server sent: keyboard-interactive).Puedes verificar si tu cuenta tiene habilitada la 2SV en la configuración de seguridad de tu Cuenta de Google. Si tu cuenta no tiene habilitada la 2SV, no aparecerá ningún diálogo que te solicite un código de seguridad, y el intento de acceso fallará con un error genérico
Permission denied.También puedes comunicarte con tu administrador de Google Workspace para verificar si la verificación en 2 pasos está habilitada en tu dominio.
Si la propiedad
response.challengesde los registros de auditoría deContinueSessionde Acceso al SO muestra un estado que no sea'READY', es posible que indique un problema con el desafío de autenticación que estás usando. En el siguiente ejemplo, se muestran problemas con el código de verificación por mensaje de voz o de texto que no se envía a tu teléfono para completar el proceso de acceso:"response": { "challenges": [ { "challengeId": 2, "challengeType": "IDV_PREREGISTERED_PHONE", "status": "RETRYABLE_ERROR" }Puedes usar otro método de verificación, como el Autenticador de Google, para acotar el problema. Si puedes conectarte con otro método de verificación, pero no recibes códigos de verificación por mensaje de texto en tu teléfono registrado y ves
RETRYABLE_ERRORparaIDV_PREREGISTERED_PHONEen los registros, comunícate con el equipo de asistencia de Google Workspace.
¿Qué sigue?
- Obtén más información sobre Acceso al SO.
- Obtén información sobre cómo funcionan las conexiones SSH a las instancias de Linux en Compute Engine.
- Para obtener instrucciones paso a paso, consulta una de las siguientes opciones:
- Consulta esta página sobre cómo administrar el Acceso al SO en una organización