Attivare l'accesso basato su certificati nelle applicazioni client

Questa pagina descrive come attivare l'accesso basato su certificati (CBA) nelle applicazioni client per chiamare le API di Google utilizzando librerie o strumenti compatibili.

Per abilitare l'autenticazione basata su certificati e consentire alle API di Google di identificare un dispositivo, il client chiamante deve stabilire connessioni mTLS con le API di Google e poi rilevare i certificati TLS sul dispositivo. Questa procedura è illustrata nel seguente diagramma:

Flusso di connessione del client

Client compatibili con CBA

Puoi utilizzare CBA con i seguenti client:

  • ConsoleGoogle Cloud (Chrome)
  • Google Cloud CLI versione 264.0.0 o successive
  • Terraform CLI versione 1.3.6 o successive
  • Librerie client delle API di Google
    • Python
    • Linguaggio Go

Attivare l'autenticazione basata su certificati per gcloud CLI

  1. Chiedi ai tuoi utenti di installare o aggiornare gcloud CLI per assicurarsi di avere una versione compatibile con CBA, versione 264.0.0 o successive.

    Gli utenti che hanno installato Google Cloud CLI possono verificare di avere la versione 264.0.0 o successive utilizzando il seguente comando:

    gcloud --version

    Se necessario, gli utenti possono aggiornare la versione di Google Cloud CLI utilizzando il seguente comando:

    gcloud components

  2. Per iniziare a utilizzare CBA, gli utenti devono eseguire questo comando:

    gcloud config set context_aware/use_client_certificate true

Abilitare CBA per Terraform CLI e le librerie client delle API di Google

  1. Per abilitare CBA per l'interfaccia a riga di comando Terraform e le librerie client delle API di Google, gli utenti devono impostare la seguente variabile di ambiente:

    export GOOGLE_API_USE_CLIENT_CERTIFICATE=1

Attivare l'autenticazione basata su certificati per IAP Desktop

Per abilitare l'accesso basato su certificati in IAP Desktop:

  1. Nell'applicazione, seleziona Strumenti > Opzioni.
  2. Seleziona Connessioni sicure a Google Cloud utilizzando l'accesso basato su certificati.
  3. Fai clic su OK.
  4. Chiudi IAP Desktop e riavvialo.

Se utilizzi Active Directory, puoi anche configurare un oggetto Criteri di gruppo per attivare automaticamente l'accesso basato su certificati per i tuoi utenti.