Le funzionalità di ARCore, come l'API Geospaziale e Cloud Anchors, utilizzano l'API ARCore ospitata su Google Cloud. Quando utilizzi queste funzionalità, la tua applicazione utilizza le credenziali per accedere al servizio API ARCore.
Questa guida rapida descrive come configurare l'applicazione in modo che possa comunicare con il servizio API ARCore ospitato su Google Cloud.
Crea un nuovo progetto Google Cloud o utilizzane uno esistente.
Se hai un progetto esistente, selezionalo.
Se non hai un progetto Google Cloud esistente, creane uno.
Attivare l'API ARCore
Per utilizzare l'API ARCore, devi abilitarla nel tuo progetto.
Configurare un metodo di autorizzazione
Un'applicazione per iOS può comunicare con l'API ARCore utilizzando due diversi metodi di autorizzazione: l'autorizzazione senza chiave, che è il metodo consigliato, e l'autorizzazione con chiave API:
- L'autorizzazione senza chiave utilizza un token firmato per controllare l'accesso all'API. Questo metodo richiede un server di tua proprietà per firmare i token e controllare l'accesso all'API.
- Una chiave API è una stringa che identifica un progetto cloud di Google. Le chiavi API in genere non sono considerate sicure perché sono in genere accessibili ai client. Valuta la possibilità di utilizzare l'autorizzazione tramite token per comunicare con l'API ARCore.
Keyless
ARCore supporta l'autorizzazione delle chiamate API in iOS utilizzando un token web JSON. Il token deve essere firmato da un account di servizio Google.
Per generare token per iOS, devi avere un endpoint sul server che soddisfi i seguenti requisiti:
Il tuo meccanismo di autorizzazione deve proteggere l'endpoint.
L'endpoint deve generare un nuovo token ogni volta, in modo che:
- Ogni utente riceve un token univoco.
- I token non scadono immediatamente.
Creare un service account e una chiave di firma
Segui questi passaggi per creare un service account Google e una chiave di firma:
- In Google Cloud, apri la pagina Credenziali.
Credenziali - Fai clic su Crea credenziali > Service account.
- In Dettagli service account, digita un nome per il nuovo account, quindi fai clic su Crea.
- Nella pagina Autorizzazioni service account, vai al menu a discesa Seleziona un ruolo. Seleziona Account di servizio > Creatore token account di servizio, quindi fai clic su Continua.
- Nella pagina Concedi agli utenti l'accesso a questo service account, fai clic su Fine.
- Nella pagina Credenziali, individua la sezione Account di servizio e fai clic sul nome dell'account che hai appena creato.
- Nella pagina Dettagli service account, scorri verso il basso fino alla sezione Chiavi e seleziona Aggiungi chiave > Crea nuova chiave.
Seleziona JSON come tipo di chiave e fai clic su Crea.
Viene scaricato un file JSON contenente la chiave privata sul computer. Archivia il file della chiave JSON scaricato in una posizione sicura.
Crea token sul server
Per creare nuovi token (JWT) sul server, utilizza le librerie JWT standard e il file JSON scaricato in modo sicuro dal nuovo service account.
Crea token sulla macchina di sviluppo
Per generare JWT sulla macchina di sviluppo, utilizza il seguente comando
oauth2l:
oauth2l fetch --cache "" --jwt --json $KEYFILE --audience "https://arcore.googleapis.com/"
La specifica di una posizione della cache vuota utilizzando il flag --cache è necessaria per
garantire che venga prodotto un token diverso ogni volta. Assicurati di tagliare la stringa risultante. Spazi aggiuntivi o caratteri di nuova riga faranno sì che l'API
rifiuti il token.
Firma il token
Per firmare il JWT, devi utilizzare l'algoritmo RS256 e le seguenti attestazioni:
iss: l'indirizzo email del service account.sub: l'indirizzo email del service account.iat: l'ora Unix epoch in cui è stato generato il token, in secondi.exp-iat+3600(1 ora). L'ora Unix epoch in cui il token scade, in secondi.aud: il pubblico. Deve essere impostato suhttps://arcore.googleapis.com/.
Le attestazioni non standard non sono richieste nel payload JWT, anche se l'attestazione
uid può essere utile per identificare l'utente corrispondente.
Se utilizzi un approccio diverso per generare i JWT, ad esempio utilizzando un'API Google in un ambiente gestito da Google, assicurati di firmare i JWT con le rivendicazioni in questa sezione. Innanzitutto, assicurati che il pubblico sia corretto.
Passa il token nella sessione ARCore
La tua app è ora configurata per utilizzare l'autenticazione senza chiave.
Tieni presente quanto segue quando passi un token nella sessione:
Se hai utilizzato una chiave API per creare la sessione, ARCore ignorerà il token e registrerà un errore.
Se non hai più bisogno della chiave API, eliminala in Google Developers Console e rimuovila dalla tua app.
ARCore ignora i token che contengono spazi o caratteri speciali.
I token scadono in genere dopo un'ora. Se esiste la possibilità che il token scada durante l'utilizzo, ottieni un nuovo token e passalo all'API.
Chiave API
- In Google Cloud, apri la pagina Credenziali.
Credenziali - Fai clic su Crea credenziali, poi seleziona Chiave API dal menu.
La finestra di dialogo Chiave API creata mostra la stringa della chiave appena creata. - Consulta la documentazione sulle limitazioni relative alle chiavi API per proteggere la tua chiave API.
Ora la tua app è configurata per utilizzare le chiavi API.
Passaggi successivi
Con l'autorizzazione configurata, dai un'occhiata alle seguenti funzionalità di ARCore che la utilizzano: