Configura OS Login

Questo documento descrive come configurare OS Login e OS Login con l'autenticazione a due fattori (2FA).

OS Login ti consente di controllare l'accesso alle istanze di macchine virtuali (VM) in base alle autorizzazioni IAM. Puoi utilizzare OS Login con o senza 2FA, ma non puoi utilizzare OS Login. Per scoprire di più su OS Login e OS Login 2FA, inclusi i tipi di verifica supportati da OS Login, consulta Informazioni su OS Login.

Prima di iniziare

  • Se vuoi utilizzare OS Login 2FA, attiva questa autenticazione nel tuo dominio o account:
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

    Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init
    2. Imposta una regione e una zona predefinite.

    Terraform

    Per utilizzare gli esempi Terraform in questa pagina da un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

    1. Installa Google Cloud CLI.

    2. Per initialize gcloud CLI, esegui questo comando: 

      gcloud init

    3. Crea credenziali di autenticazione locali per il tuo Account Google: 

      gcloud auth application-default login

    Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

Limitazioni

OS Login non è supportato nelle seguenti VM:
  • VM Windows Server e SQL Server
  • VM Fedora CoreOS. Per gestire l'accesso delle istanze alle VM create utilizzando queste immagini, utilizza il sistema di accensione Fedora CoreOS

Assegna ruoli IAM di OS Login

Assegna tutti i ruoli IAM richiesti agli utenti che si connettono alle VM in cui è abilitato OS Login.

Ruolo Utenti obbligatori Livello di concessione
roles/compute.osLogin o roles/compute.osAdminLogin Tutti gli utenti

Sul progetto o sull'istanza.

Se un utente richiede l'accesso SSH dalla console Google Cloud o da Google Cloud CLI, devi concedere questi ruoli a livello di progetto o, in aggiunta, un ruolo a livello di progetto che contenga l'autorizzazione compute.projects.get.
roles/iam.serviceAccountUser Tutti gli utenti, se la VM ha un account di servizio In Account di servizio.
roles/compute.osLoginExternalUser Utenti di un'organizzazione diversa dalla VM a cui si connettono

Nell'Organizzazione.

Questo ruolo deve essere concesso da un amministratore dell'organizzazione.

Attiva OS Login

Puoi abilitare OS Login o OS Login con l'autenticazione a due fattori per una singola VM, o per tutte le VM in un progetto, impostando i metadati OS Login.

Quando imposti i metadati OS Login, Compute Engine elimina i file authorized_keys della VM e non accetta più connessioni dalle chiavi SSH archiviate nei metadati del progetto o dell'istanza.

Abilita OS Login per tutte le VM in un progetto

Per abilitare OS Login per tutte le VM in un progetto, imposta i seguenti valori nei metadati del progetto:

  1. Attiva OS Login:
    • Chiave: enable-oslogin
    • Valore: TRUE
  2. (Facoltativo) Abilita l'autenticazione a due fattori:
    • Chiave: enable-oslogin-2fa
    • Valore: TRUE

Abilita OS Login per una singola VM

Per abilitare OS Login per una singola VM, imposta i seguenti valori nei metadati dell'istanza:

  1. Attiva OS Login:
    • Chiave: enable-oslogin
    • Valore: TRUE
  2. (Facoltativo) Abilita l'autenticazione a due fattori:
    • Chiave: enable-oslogin-2fa
    • Valore: TRUE

Abilita OS Login durante la creazione della VM

Abilita OS Login (facoltativamente con la verifica in due passaggi) durante la creazione di una VM mediante la console Google Cloud o gcloud CLI.

Console

Crea una VM che abiliti OS Login e, facoltativamente, OS Login 2FA all'avvio, creando una VM da un'immagine pubblica e specificando le seguenti configurazioni:

  1. Nella sezione Networking, dischi, sicurezza, gestione, single-tenancy, espandi la sezione Sicurezza.
  2. Espandi la sezione Gestisci accesso.
  3. Seleziona Controlla l'accesso alle VM tramite le autorizzazioni IAM.
  4. (Facoltativo) Se vuoi attivare OS Login 2FA, seleziona Richiedi verifica in due passaggi.
  5. Fai clic su Crea per creare e avviare la VM.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Crea una VM che abiliti OS Login e, facoltativamente, OS Login 2FA all'avvio, eseguendo uno dei seguenti comandi gcloud compute instance create:

    • Per abilitare solo OS Login, esegui questo comando:

      gcloud compute instances create VM_NAME \
 --image-family=IMAGE_FAMILY \
 --image-project=IMAGE_PROJECT \
 --metadata enable-oslogin=TRUE

    • Per abilitare OS Login 2FA, esegui questo comando:

      gcloud compute instances create VM_NAME \
 --image-family=IMAGE_FAMILY \
 --image-project=IMAGE_PROJECT \
 --metadata enable-oslogin=TRUE,enable-oslogin-2fa=TRUE

    Sostituisci quanto segue:

    • VM_NAME: il nome della nuova VM.
    • IMAGE_FAMILY: la famiglia di immagini di un sistema operativo Linux. Viene creata la VM dall'immagine del sistema operativo non deprecata più recente. Per tutte le famiglie di immagini pubbliche, consulta Dettagli del sistema operativo.
    • IMAGE_PROJECT: il progetto di immagini che contiene la famiglia di immagini. Ogni sistema operativo ha il proprio progetto di immagini. Per tutti i progetti di immagini pubblici, consulta Dettagli del sistema operativo.

Terraform

Puoi applicare i valori dei metadati ai progetti o alle VM utilizzando una delle seguenti opzioni:

  • Opzione 1: imposta enable-oslogin nei metadati a livello di progetto in modo che venga applicato a tutte le VM nel progetto.

    Utilizza la risorsa Terraform google_compute_project_metadata e imposta un valore dei metadati dove oslogin=TRUE:

    resource "google_compute_project_metadata" "default" {
  metadata = {
    enable-oslogin = "TRUE"
  }
}

    In alternativa, puoi impostare enable-oslogin su FALSE per disattivare OS Login.

  • Opzione 2: imposta enable-oslogin nei metadati di una VM nuova o esistente.

    Utilizza la risorsa Terraform google_compute_instance e imposta oslogin=TRUE. Sostituisci oslogin_instance_name con il nome della tua VM.

    resource "google_compute_instance" "oslogin_instance" {
  name         = "oslogin-instance-name"
  machine_type = "f1-micro"
  zone         = "us-central1-c"
  metadata = {
    enable-oslogin : "TRUE"
  }
  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  network_interface {
    # A default network is created for all GCP projects
    network = "default"
    access_config {
    }
  }
}

    In alternativa, puoi impostare enable-oslogin su FALSE per escludere la tua VM dall'utilizzo di OS Login.

Connettiti alle VM in cui è abilitato OS Login

Connettiti alle VM in cui è abilitato OS Login utilizzando i metodi descritti in Connettersi a VM Linux.

Quando ti connetti alle VM in cui è abilitato OS Login, Compute Engine utilizza il nome utente configurato per te dall'amministratore della tua organizzazione. Se l'amministratore dell'organizzazione non ha configurato un nome utente per te, Compute Engine genera un nome utente nel formato USERNAME_DOMAIN_SUFFIX. Per ulteriori informazioni sui nomi utente, vedi Come funziona OS Login.

Quando ti connetti alle VM in cui è abilitata l'autenticazione a due fattori OS Login, viene visualizzato anche un messaggio in base al metodo di verifica in due passaggi o al tipo di verifica selezionato. Per il metodo di richiesta sul telefono, accetta le richieste sullo smartphone o sul tablet per continuare. Se vuoi usare altri metodi, inserisci il tuo codice di sicurezza o una password monouso.

Risolvere i problemi relativi a OS Login

Per trovare metodi per diagnosticare e risolvere gli errori OS Login, consulta Risoluzione dei problemi di OS Login.

Passaggi successivi