Este documento describe cómo configurar el inicio de sesión en el sistema operativo y el inicio de sesión en el sistema operativo con autenticación de dos factores (2FA).
El inicio de sesión del sistema operativo le permite controlar el acceso a instancias de máquinas virtuales (VM) según los permisos de IAM. Puede usar el inicio de sesión del sistema operativo con o sin 2FA, pero no puede usar 2FA sin usar el inicio de sesión del sistema operativo. Para obtener más información sobre el inicio de sesión del sistema operativo y el inicio de sesión del sistema operativo 2FA, incluidos los tipos de desafíos que admite el inicio de sesión del sistema operativo, consulte Acerca del inicio de sesión del sistema operativo .
Antes de comenzar
- Si desea utilizar 2FA para iniciar sesión en el sistema operativo, habilite 2FA en su dominio o cuenta:
- Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Máquinas virtuales Windows Server y SQL Server
- Máquinas virtuales Fedora CoreOS. Para administrar el acceso de instancia a las máquinas virtuales creadas con estas imágenes, use el sistema de encendido Fedora CoreOS
- Habilitar inicio de sesión en el sistema operativo:
- Clave:
enable-oslogin
- Valor:
TRUE
- Clave:
- (Opcional) Habilite la autenticación de dos factores:
- Clave:
enable-oslogin-2fa
- Valor:
TRUE
- Clave:
- Habilitar inicio de sesión en el sistema operativo:
- Clave:
enable-oslogin
- Valor:
TRUE
- Clave:
- (Opcional) Habilite la autenticación de dos factores:
- Clave:
enable-oslogin-2fa
- Valor:
TRUE
- Clave:
- Expanda la sección Opciones avanzadas .
- Expanda la sección Seguridad .
- Expanda la sección Administrar acceso .
- Seleccione Controlar el acceso a la máquina virtual mediante permisos de IAM .
- Opcional: si desea habilitar el inicio de sesión en el sistema operativo 2FA, seleccione Requerir verificación en dos pasos .
- Haga clic en Crear para crear e iniciar la VM.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Cree una máquina virtual que habilite el inicio de sesión en el sistema operativo y (opcionalmente) el inicio de sesión en el sistema operativo 2FA al inicio ejecutando uno de los siguientes comandos
gcloud compute instance create
:Para habilitar solo el inicio de sesión en el sistema operativo, ejecute el siguiente comando:
gcloud compute instances create VM_NAME \ --image-family=IMAGE_FAMILY \ --image-project=IMAGE_PROJECT \ --metadata enable-oslogin=TRUE
Para habilitar el inicio de sesión en el sistema operativo 2FA, ejecute el siguiente comando:
gcloud compute instances create VM_NAME \ --image-family=IMAGE_FAMILY \ --image-project=IMAGE_PROJECT \ --metadata enable-oslogin=TRUE,enable-oslogin-2fa=TRUE
Reemplace lo siguiente:
-
VM_NAME
: el nombre de la nueva VM. -
IMAGE_FAMILY
: la familia de imágenes de un sistema operativo Linux. Esto crea la máquina virtual a partir de la imagen del sistema operativo no obsoleta más reciente. Para todas las familias de imágenes públicas, consulte Detalles del sistema operativo . -
IMAGE_PROJECT
: el proyecto de imagen que contiene la familia de imágenes. Cada sistema operativo tiene su propio proyecto de imagen. Para todos los proyectos de imágenes públicas, consulte Detalles del sistema operativo .
Opción 1: configure
enable-oslogin
en los metadatos de todo el proyecto para que se aplique a todas las máquinas virtuales de su proyecto.Utilice el recurso Terraform
google_compute_project_metadata
y establezca un valor de metadatos dondeoslogin=TRUE
:Alternativamente, puede configurar
enable-oslogin
enFALSE
para deshabilitar el inicio de sesión en el sistema operativo.Opción 2: configurar
enable-oslogin
en los metadatos de una máquina virtual nueva o existente.Utilice el recurso Terraform
google_compute_instance
y establezcaoslogin=TRUE
. Reemplaceoslogin_instance_name
con el nombre de su VM.Alternativamente, puede configurar
enable-oslogin
enFALSE
para excluir su VM del uso del inicio de sesión del sistema operativo.- Descubra cómo funcionan las conexiones SSH a máquinas virtuales Linux en Compute Engine.
- Aprenda a utilizar SSH con claves de seguridad para restringir aún más el acceso a las máquinas virtuales.
Terraform
Para usar las muestras de Terraform de esta página en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Para obtener más información, consulta Set up authentication for a local development environment.
Limitaciones
El inicio de sesión en el sistema operativo no es compatible con las siguientes máquinas virtuales:Asignar roles de IAM de inicio de sesión en el sistema operativo
Asigne todos los roles de IAM requeridos a los usuarios que se conectan a máquinas virtuales que tienen habilitado el inicio de sesión en el sistema operativo.
Role Usuarios requeridos Nivel de subvención roles/compute.osLogin
oroles/compute.osAdminLogin
Todos los usuarios Si un usuario requiere acceso SSH desde la consola de Google Cloud o la CLI de Google Cloud, debes otorgar estos roles a nivel de proyecto o, además, otorgar un rol a nivel de proyecto que contenga el permiso
compute.projects.get
.roles/iam.serviceAccountUser
Todos los usuarios, si la VM tiene una cuenta de servicio En la cuenta de Servicio . roles/compute.osLoginExternalUser
Usuarios de una organización diferente a la máquina virtual a la que se están conectando Sobre la Organización .
Este rol debe ser otorgado por un administrador de la organización.
Habilitar inicio de sesión en el sistema operativo
Puede habilitar el inicio de sesión en el sistema operativo o el inicio de sesión en el sistema operativo con autenticación de dos factores para una única máquina virtual o todas las máquinas virtuales de un proyecto configurando los metadatos de inicio de sesión en el sistema operativo.
Cuando configuras los metadatos de inicio de sesión del sistema operativo, Compute Engine elimina los archivos de
authorized_keys
de la VM y ya no acepta conexiones de claves SSH que están almacenadas en los metadatos del proyecto o de la instancia.Habilite el inicio de sesión del sistema operativo para todas las máquinas virtuales de un proyecto
Para habilitar el inicio de sesión en el sistema operativo para todas las máquinas virtuales de un proyecto, establezca los siguientes valores en los metadatos del proyecto :
Habilite el inicio de sesión en el sistema operativo para una sola máquina virtual
Para habilitar el inicio de sesión en el sistema operativo para una única máquina virtual, establezca los siguientes valores en los metadatos de la instancia :
Habilite el inicio de sesión del sistema operativo durante la creación de VM
Habilite el inicio de sesión en el sistema operativo (opcionalmente, con verificación en dos pasos) mientras crea una máquina virtual mediante la consola de Google Cloud o la CLI de gcloud.
Consola
Cree una máquina virtual que habilite el inicio de sesión en el sistema operativo y (opcionalmente) el inicio de sesión en el sistema operativo 2FA al inicio; para ello, cree una máquina virtual a partir de una imagen pública y especifique las siguientes configuraciones:
nube de gcloud
Terraformar
Puede aplicar los valores de metadatos a sus proyectos o máquinas virtuales mediante una de las siguientes opciones:
Conéctese a máquinas virtuales que tengan habilitado el inicio de sesión en el sistema operativo
Conéctese a máquinas virtuales que tengan habilitado el inicio de sesión en el sistema operativo mediante los métodos descritos en Conexión a máquinas virtuales Linux .
Cuando te conectas a máquinas virtuales que tienen habilitado el inicio de sesión en el sistema operativo, Compute Engine usa el nombre de usuario que el administrador de tu organización configuró para ti . Si el administrador de su organización no ha configurado un nombre de usuario para usted, Compute Engine genera un nombre de usuario con el formato
USERNAME_DOMAIN_SUFFIX
. Para obtener más información sobre los nombres de usuario, consulte Cómo funciona el inicio de sesión en el sistema operativo .Cuando se conecta a máquinas virtuales que tienen habilitado OS Login 2FA, también ve un mensaje basado en el método de verificación en dos pasos o el tipo de desafío seleccionado. Para el método de indicación telefónica, acepte las indicaciones en su teléfono o tableta para continuar. Para otros métodos, ingrese su código de seguridad o contraseña de un solo uso.
Solucionar problemas de inicio de sesión del sistema operativo
Para encontrar métodos para diagnosticar y resolver errores de inicio de sesión en el sistema operativo, consulte Solución de problemas de inicio de sesión en el sistema operativo .
¿Qué sigue?
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-04-21 (UTC).
-