Se vuoi richiedere l'autenticazione per accedere al backend dell'API, devi ottenere gli ID client richiesti e fornirli al backend utilizzando l'attributo di annotazione API appropriato.
Android
Per creare l'ID client OAuth 2.0 per Android, devi disporre di un'impronta della chiave del certificato. Se utilizzi Android Studio, vengono creati automaticamente un keystore di debug e una chiave di debug. 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 del keystore di debug è android
e
l'alias della chiave è androiddebugkey
. La posizione predefinita per Linux
e macOS è ~/.android/debug.keystore
.
- Se non ne hai già una, genera una chiave di debug o di release per la tua applicazione Android. Se utilizzi Android Studio, la prima volta che crei un progetto Android viene generata automaticamente una chiave di debug nel keystore di debug.
-
In una finestra del terminale Linux o macOS, puoi ottenere l'impronta della chiave utilizzando
keytool
incluso nell'SDK Java come segue: L'output mostra una impronta simile alla seguente:keytool -exportcert -alias androiddebugkey -keystore path-to-debug-or-production-keystore -list -v
DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
-
Copia e salva l'impronta della chiave visualizzata dopo aver eseguito il comando
keytool
precedente. Devi fornire l'impronta per generare l'ID client Android nella console Google Cloud. - Nella console Google Cloud, vai alla pagina Credenziali.
- Dall'elenco dei progetti, seleziona il progetto contenente l'API.
- 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.
- Fai clic su Schermata consenso OAuth.
- Inserisci un nome nel campo Nome applicazione.
- Compila il resto dei campi in base alle esigenze.
- Fai clic su Salva.
- Nell'elenco a discesa Crea credenziali, seleziona ID client OAuth.
- Seleziona Android come tipo di applicazione.
- In Nome, inserisci un nome per l'ID client.
- In Fingerprint-certificate signing (Impronta-certificato firma), inserisci l'impronta ottenuta in precedenza.
-
In Nome pacchetto, inserisci il nome del pacchetto dell'applicazione Android, come specificato nel file
AndroidManifest.xml
. -
Fai clic su Crea.
Utilizza l'ID client generato nel back-end dell'API e nell'applicazione client.
Client web
- Nella console Google Cloud, vai alla pagina Credenziali.
- Dall'elenco dei progetti, seleziona il progetto contenente l'API.
- 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.
- Fai clic su Schermata consenso OAuth.
- Inserisci un nome nel campo Nome applicazione.
- Compila il resto dei campi in base alle esigenze.
- Fai clic su Salva.
- Nell'elenco a discesa Crea credenziali, seleziona ID client OAuth.
- Seleziona Applicazione web come tipo di applicazione.
- In Nome, inserisci un nome per l'ID client.
-
In Origini JavaScript autorizzate, inserisci una delle seguenti opzioni:
-
http://localhost:8080
se stai testando il backend localmente. -
https://YOUR_PROJECT_ID.appspot.com
, sostituendoYOUR_PROJECT_ID
con l'ID progetto App Engine se stai eseguendo il deployment dell'API di backend nella tua App Engine di produzione.
-
-
Fai clic su Crea.
Utilizza l'ID client generato nel back-end dell'API e nell'applicazione client.
Passaggi successivi
Per informazioni su come supportare l'autenticazione nella tua applicazione Android o JavaScript, consulta quanto segue: