Crea credenziali di accesso

Le credenziali vengono utilizzate per ottenere un token di accesso dai server di autorizzazione di Google in modo che la tua app possa chiamare le API Google Workspace. Questa guida descrive come scegliere e configurare le credenziali necessarie per la tua app.

Per le definizioni dei termini presenti in questa pagina, consulta Panoramica di autenticazione e autorizzazione.

Scegliere la credenziale di accesso più adatta a te

Le credenziali richieste dipendono dal tipo di dati, dalla piattaforma e dalla metodologia di accesso della tua app. Sono disponibili tre tipi di credenziali:

Caso d'uso Metodo di autenticazione Informazioni su questo metodo di autenticazione
Accedere in modo anonimo ai dati disponibili pubblicamente nella tua app. Chiavi API Verifica che l'API che vuoi utilizzare supporti le chiavi API prima di utilizzare questo metodo di autenticazione.
Accedere ai dati degli utenti, ad esempio indirizzo email o età. ID client OAuth Richiede che la tua app richieda e riceva il consenso dell'utente.
Accedere ai dati appartenenti alla tua applicazione o alle risorse per conto degli utenti di Google Workspace o Cloud Identity tramite la delega a livello di dominio. Service account Quando un'app esegue l'autenticazione come service account, ha accesso a tutte le risorse a cui il service account ha l'autorizzazione di accedere.

Credenziali della chiave API

Una chiave API è una lunga stringa contenente lettere maiuscole e minuscole, numeri, trattini bassi e trattini, ad esempio AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe. Questo metodo di autenticazione viene utilizzato per accedere in modo anonimo a dati disponibili pubblicamente, ad esempio i file di Google Workspace condivisi utilizzando l'impostazione di condivisione "Chiunque su internet con questo link". Per maggiori dettagli, vedi Utilizzo delle chiavi API.

Per creare una chiave API:

  1. Nella console Google Cloud, vai a Menu > API e servizi > Credenziali.

    Vai a credenziali

  2. Fai clic su Crea credenziali > Chiave API.
  3. Viene visualizzata la nuova chiave API.
    • Fai clic su Copia per copiare la chiave API da utilizzare nel codice della tua app. La chiave API è disponibile anche nella sezione "Chiavi API" delle credenziali del progetto.
    • Per impedire l'uso non autorizzato, ti consigliamo di limitare dove e per quali API può essere utilizzata la chiave API. Per maggiori dettagli, vedi Aggiungere limitazioni API.

Credenziali ID client OAuth

Per autenticare gli utenti finali e accedere ai dati utente nella tua app, devi creare uno o più ID client OAuth 2.0. L'ID client viene utilizzato per identificare una singola app nei server OAuth di Google. Se l'app viene eseguita su più piattaforme, devi creare un ID client separato per ciascuna piattaforma.

Scegli il tipo di applicazione per istruzioni specifiche su come creare un ID client OAuth:

Applicazione web

  1. Nella console Google Cloud, vai a Menu > > Client.

    Vai a Clienti

  2. Fai clic su Crea cliente.
  3. Fai clic su Tipo di applicazione > Applicazione web.
  4. Nel campo Nome, digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
  5. Aggiungi gli URI autorizzati correlati alla tua app:
    • App lato client (JavaScript): in Origini JavaScript autorizzate, fai clic su Aggiungi URI. Poi, inserisci un URI da utilizzare per le richieste del browser. Identifica i domini da cui la tua applicazione può inviare richieste API al server OAuth 2.0.
    • App lato server (Java, Python e altro): in URI di reindirizzamento autorizzati, fai clic su Aggiungi URI. Poi, inserisci un URI dell'endpoint a cui il server OAuth 2.0 può inviare le risposte.
  6. Fai clic su Crea.

    La credenziale appena creata viene visualizzata in ID client OAuth 2.0.

    Prendi nota dell'ID client. I client secret non vengono utilizzati per le applicazioni web.

Android

  1. Nella console Google Cloud, vai a Menu > > Client.

    Vai a Clienti

  2. Fai clic su Crea cliente.
  3. Fai clic su Tipo di applicazione > Android.
  4. Nel campo "Nome", digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
  5. Nel campo "Nome pacchetto", inserisci il nome del pacchetto dal file AndroidManifest.xml.
  6. Nel campo "Impronta digitale certificato SHA-1", inserisci l'impronta digitale certificato SHA-1 generata.
  7. Fai clic su Crea.

    La credenziale appena creata viene visualizzata in "ID client OAuth 2.0".

iOS

  1. Nella console Google Cloud, vai a Menu > > Client.

    Vai a Clienti

  2. Fai clic su Crea cliente.
  3. Fai clic su Tipo di applicazione > iOS.
  4. Nel campo "Nome", digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
  5. Nel campo "ID bundle", inserisci l'identificatore bundle elencato nel file Info.plist dell'app.
  6. (Facoltativo) Se la tua app è presente nell'Apple App Store, inserisci l'ID App Store.
  7. (Facoltativo) Nel campo "ID team", inserisci la stringa univoca composta da 10 caratteri generata da Apple e assegnata al tuo team.
  8. Fai clic su Crea.

    La credenziale appena creata viene visualizzata in "ID client OAuth 2.0".

Estensione di Chrome

  1. Nella console Google Cloud, vai a Menu > > Client.

    Vai a Clienti

  2. Fai clic su Crea cliente.
  3. Fai clic su Tipo di applicazione > Estensione Chrome.
  4. Nel campo "Nome", digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
  5. Nel campo "ID elemento", inserisci la stringa ID univoca di 32 caratteri della tua app. Puoi trovare questo valore ID nell'URL del Chrome Web Store della tua app e nella Dashboard per sviluppatori del Chrome Web Store.
  6. Fai clic su Crea.

    La credenziale appena creata viene visualizzata in "ID client OAuth 2.0".

Applicazione desktop

  1. Nella console Google Cloud, vai a Menu > > Client.

    Vai a Clienti

  2. Fai clic su Crea cliente.
  3. Fai clic su Tipo di applicazione > App per computer.
  4. Nel campo Nome, digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
  5. Fai clic su Crea.

    La credenziale appena creata viene visualizzata in "ID client OAuth 2.0".

TV e dispositivi a input limitato

  1. Nella console Google Cloud, vai a Menu > > Client.

    Vai a Clienti

  2. Fai clic su Crea cliente.
  3. Fai clic su Tipo di applicazione > TV e dispositivi di input limitati.
  4. Nel campo "Nome", digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
  5. Fai clic su Crea.

    La credenziale appena creata viene visualizzata in "ID client OAuth 2.0".

Universal Windows Platform (UWP)

  1. Nella console Google Cloud, vai a Menu > > Client.

    Vai a Clienti

  2. Fai clic su Crea cliente.
  3. Fai clic su Tipo di applicazione > Universal Windows Platform (UWP).
  4. Nel campo "Nome", digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
  5. Nel campo "ID store", inserisci il valore univoco dell'ID Microsoft Store della tua app, composto da 12 caratteri. Puoi trovare questo ID nell'URL Microsoft Store della tua app e nel Partner Center.
  6. Fai clic su Crea.

    La credenziale appena creata viene visualizzata in "ID client OAuth 2.0".

Credenziali dell'account di servizio

Un service account è un tipo speciale di account utilizzato da un'applicazione, anziché da una persona. Puoi utilizzare un service account per accedere ai dati o eseguire azioni tramite l'account robot oppure per accedere ai dati per conto degli utenti di Google Workspace o Cloud Identity. Per saperne di più, consulta Informazioni sui service account.

Crea un account di servizio

Console Google Cloud

  1. Nella console Google Cloud, vai a Menu > IAM e amministrazione > Service account.

    Vai a Service account

  2. Fai clic su Crea account di servizio.
  3. Compila i dettagli del service account, quindi fai clic su Crea e continua.
  4. (Facoltativo) Assegna ruoli al tuo service account per concedere l'accesso alle risorse del tuo progetto Google Cloud. Per ulteriori dettagli, consulta Concessione, modifica e revoca dell'accesso alle risorse.
  5. Fai clic su Continua.
  6. (Facoltativo) Inserisci gli utenti o i gruppi che possono gestire ed eseguire azioni con questo service account. Per maggiori dettagli, consulta Gestione dell'impersonificazione degli account di servizio.
  7. Fai clic su Fine. Prendi nota dell'indirizzo email del service account.

Interfaccia a riga di comando gcloud

  1. Crea l'account di servizio: 
    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --display-name="SERVICE_ACCOUNT_NAME"
  2. (Facoltativo) Assegna ruoli al tuo service account per concedere l'accesso alle risorse del tuo progetto Google Cloud. Per ulteriori dettagli, consulta Concessione, modifica e revoca dell'accesso alle risorse.

Assegnare un ruolo a un service account

Devi assegnare un ruolo predefinito o personalizzato a un service account da un account super amministratore.

  1. Nella Console di amministrazione Google, vai a Menu > Account > Ruoli amministratore.

    Vai a Ruoli amministratore

  2. Posiziona il puntatore del mouse sul ruolo che vuoi assegnare e fai clic su Assegna amministratore.

  3. Fai clic su Assegna service account.

  4. Inserisci l'indirizzo email del service account.

  5. Fai clic su Aggiungi > Assegna ruolo.

Crea le credenziali per un service account

Devi ottenere le credenziali sotto forma di coppia di chiavi pubblica/privata. Queste credenziali vengono utilizzate dal codice per autorizzare le azioni del service account all'interno della tua app.

Per ottenere le credenziali per il tuo service account:

  1. Nella console Google Cloud, vai a Menu > IAM e amministrazione > Service account.

    Vai a Service account

  2. Seleziona il tuo service account.
  3. Fai clic su Chiavi > Aggiungi chiave > Crea nuova chiave.
  4. Seleziona JSON, quindi fai clic su Crea.

    Una nuova coppia di chiavi pubblica/privata viene generata e scaricata sul tuo computer come nuovo file. Salva il file JSON scaricato come credentials.json nella directory di lavoro. Questo file è l'unica copia di questa chiave. Per informazioni su come archiviare la chiave in modo sicuro, consulta la sezione Gestire le chiavi degli account di servizio.

  5. Fai clic su Chiudi.

(Facoltativo) Configura la delega a livello di dominio per un service account

Per chiamare le API per conto degli utenti di un'organizzazione Google Workspace, al tuo service account deve essere concessa la delega dell'autorità a livello di dominio nella Console di amministrazione Google Workspace da un account super amministratore. Per ulteriori informazioni, vedi Delega dell'autorità a livello di dominio a un service account.

Per configurare la delega dell'autorità a livello di dominio per un service account:

  1. Nella console Google Cloud, vai a Menu > IAM e amministrazione > Service account.

    Vai a Service account

  2. Seleziona il tuo service account.
  3. Fai clic su Mostra impostazioni avanzate.
  4. Nella sezione "Delega a livello di dominio", trova l'ID client del tuo account di servizio. Fai clic su Copia per copiare il valore dell'ID client negli appunti.

  5. Se hai accesso come super amministratore all'account Google Workspace pertinente, fai clic su Visualizza la Console di amministrazione Google Workspace, poi accedi utilizzando un account utente super amministratore e continua a seguire questi passaggi.

    Se non disponi dell'accesso super amministratore all'account Google Workspace pertinente, contatta un super amministratore per quell'account e inviagli l'ID client del tuo account di servizio e l'elenco degli ambiti OAuth in modo che possa completare i seguenti passaggi nella Console di amministrazione.

    1. Nella Console di amministrazione Google, vai a Menu > Sicurezza > Accesso e controllo dei dati > Controlli API.

      Vai ai controlli API

    2. Fai clic su Gestisci delega a livello di dominio.
    3. Fai clic su Aggiungi nuova.
    4. Nel campo "ID client", incolla l'ID client che hai copiato in precedenza.
    5. Nel campo "Ambiti OAuth", inserisci un elenco delimitato da virgole degli ambiti richiesti dalla tua applicazione. Si tratta dello stesso insieme di ambiti che hai definito durante la configurazione della schermata per il consenso OAuth.
    6. Fai clic su Autorizza.

Passaggio successivo

Ora puoi sviluppare su Google Workspace. Consulta l'elenco dei prodotti per sviluppatori Google Workspace e come trovare assistenza.