Configura OS Login

Questo documento descrive come configurare OS Login e OS Login con 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 l'autenticazione a due fattori senza 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 2FA sul tuo dominio o account:
  • Se non l'hai già fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

    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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. Terraform

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

      1. Install the Google Cloud CLI.

      2. To initialize the gcloud CLI, run the following command: 

        gcloud init

      3. 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.

      Per ulteriori informazioni, consulta Set up authentication for a local development environment.

Limitazioni

OS Login non è supportato sulle seguenti VM:

Assegna ruoli IAM 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

Nel progetto o instance.

Se un utente richiede l'accesso SSH dalla console Google Cloud o dall'interfaccia a riga di comando Google Cloud, devi concedere questi ruoli a livello di progetto oppure concedere un altro 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

Nella pagina Organizzazione.

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

Attiva OS Login

Puoi attivare l'accesso al sistema operativo o l'accesso al sistema operativo con autenticazione a due fattori per una singola VM o per tutte le VM di un progetto impostando i metadati di OS Login.

Quando imposti i metadati di accesso al sistema operativo, Compute Engine elimina i fileauthorized_keys della VM e non accetta più connessioni da chiavi SSH archiviate nei metadati del progetto o dell'istanza.

Abilita OS Login per tutte le VM in un progetto

Per abilitare l'accesso al sistema operativo per tutte le VM di un progetto, imposta i seguenti valori nei metadati del progetto:

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

Attivare l'accesso al sistema operativo per una singola VM

Per attivare l'accesso al sistema operativo per una singola VM, imposta i seguenti valori nei metadati dell'istanza:

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

Attivare l'accesso OS durante la creazione della VM

Attiva l'accesso al sistema operativo (se vuoi, con la verifica in due passaggi) durante la creazione di una VM utilizzando la console Google Cloud o l'interfaccia a riga di comando gcloud.

Console

Crea una VM che attivi l'accesso al sistema operativo e (facoltativo) l'autenticazione a due fattori di accesso al sistema operativo all'avvio creando una VM da un'immagine pubblica e specificando le seguenti configurazioni:

  1. Espandi la sezione Opzioni avanzate.
  2. Espandi la sezione Sicurezza.
  3. Espandi la sezione Gestisci accesso.
  4. Seleziona Controlla l'accesso alle VM tramite autorizzazioni IAM.
  5. (Facoltativo) Se vuoi abilitare OS Login 2FA, seleziona Richiedere la verifica in due passaggi.
  6. Fai clic su Crea per creare e avviare la VM.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Crea una VM che attivi OS Login e (facoltativamente) la 2FA di OS Login all'avvio eseguendo uno dei seguenti comandi gcloud compute instance create:

    • Per abilitare solo OS Login, esegui il comando seguente:

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

    • Per attivare l'autenticazione a due fattori per l'accesso al sistema operativo, esegui il seguente 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. Questo crea la VM dall'immagine del sistema operativo non deprecata più recente. Per tutti di immagini pubbliche, consulta Dettagli del sistema operativo.
    • IMAGE_PROJECT: il progetto immagine che contiene famiglia di immagini. Ogni sistema operativo ha il proprio progetto di immagini. Per tutte le immagini pubbliche progetti, consulta la sezione Dettagli del sistema operativo.

Terraform

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

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

    Utilizza la risorsa Terraform google_compute_project_metadata e imposta un valore dei metadati in cui 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 risorsa nuova o esistente VM.

    Utilizza la google_compute_instance Risorsa Terraform e set 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 VM dall'utilizzo di OS Login.

Connettiti alle VM in cui è abilitato OS Login

Connettiti alle VM in cui è attivato l'accesso del sistema operativo utilizzando i metodi descritti in Connettersi alle VM Linux.

Quando ti connetti alle VM in cui è attivato OS Login, Compute Engine utilizza il nome utente configurato per te dall'amministratore dell'organizzazione. Se l'amministratore della tua 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 OS Login 2FA, 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 sullo smartphone, accetta le richieste sullo smartphone o sul tablet per continuare. Per gli altri metodi, inserisci il codice di sicurezza o la password monouso.

Risolvere i problemi di OS Login

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

Passaggi successivi