Creazione di ID client

Se vuoi richiedere l'autenticazione per accedere al backend dell'API, devi ottenere gli ID client richiesti e fornirli al backend utilizzando l'argomento del decoratore API appropriato.

Android

Per creare l'ID client Android OAuth 2.0, devi avere un impronta digitale della chiave del certificato. Se usi Android Studio, un archivio chiavi di debug e una chiave di debug vengono create automaticamente. Puoi utilizzare la chiave di debug per scopi di test, ma devi utilizzare una chiave di rilascio per la produzione.

Tieni presente che la password predefinita dell'archivio chiavi di debug è android e l'alias della chiave è androiddebugkey. Il percorso predefinito per Linux e macOS è ~/.android/debug.keystore.

  1. Se non ne hai già uno, genera un debug o una chiave di rilascio per il tuo app per Android. Se utilizzi Android Studio, questo genera automaticamente un chiave di debug nell'archivio chiavi di debug la prima volta che crei un progetto Android.
  2. In una finestra del terminale Linux o macOS, puoi ottenere l'impronta del utilizzando l'elemento keytool incluso nell'SDK Java come segue: 
    keytool -exportcert -alias androiddebugkey -keystore path-to-debug-or-production-keystore -list -v
     L'output mostra un'impronta simile alla seguente: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
  3. Copia e salva l'impronta della chiave visualizzata dopo aver eseguito il comando keytool precedente. Devi fornire l'impronta generare l'ID client Android nella console Google Cloud.
  4. Nella console Google Cloud, vai alla pagina Credenziali.

    Vai alla pagina Credenziali

  5. Dall'elenco dei progetti, seleziona quello contenente l'API.
  6. Se è la prima volta che crei un ID client in questo progetto, segui i passaggi secondari per andare alla pagina Consenso OAuth. In caso contrario, vai al passaggio successivo.
    1. Fai clic su Schermata consenso OAuth.
    2. Inserisci un nome nel campo Nome applicazione.
    3. Compila il resto dei campi, se necessario.
    4. Fai clic su Salva.
  7. Nell'elenco a discesa Crea credenziali, seleziona ID client OAuth.
  8. Seleziona Android come tipo di applicazione.
  9. In Nome, inserisci un nome per l'ID client.
  10. In Signing-certificate fingerprint (Impronta per il certificato di firma), inserisci l'impronta ottenuti in precedenza.
  11. In Nome pacchetto, inserisci il nome del pacchetto dell'app Android, ad esempio specificato nel file AndroidManifest.xml.
  12. Fai clic su Crea.

    Utilizza l'ID client generato nel back-end dell'API e nell'applicazione client.

Client web

  1. Nella console Google Cloud, vai alla pagina Credenziali.

    Vai alla pagina Credenziali

  2. Dall'elenco dei progetti, seleziona quello contenente l'API.
  3. Se è la prima volta che crei un ID client in questo progetto, segui i passaggi secondari per andare alla pagina Consenso OAuth. In caso contrario, vai al passaggio successivo.
    1. Fai clic su Schermata consenso OAuth.
    2. Inserisci un nome nel campo Nome applicazione.
    3. Compila il resto dei campi, se necessario.
    4. Fai clic su Salva.
  4. Nell'elenco a discesa Crea credenziali, seleziona ID client OAuth.
  5. Seleziona Applicazione web come tipo di applicazione.
  6. In Nome, inserisci un nome per l'ID client.
  7. In Origini JavaScript autorizzate, inserisci uno dei seguenti valori:
    • http://localhost:8080 se stai testando il backend localmente.

    • https://YOUR_PROJECT_ID.appspot.com, sostituzione di YOUR_PROJECT_ID con l'ID progetto App Engine se esegui il deployment l'API backend nell'App Engine di produzione.

  8. Fai clic su Crea.

    Utilizzi l'ID client generato nel backend dell'API e nel tuo client. un'applicazione.

Passaggi successivi

Per informazioni su come supportare l'autenticazione nei tuoi account Android o JavaScript, verifica quanto segue: