Utilizzare l'API ARCore su Google Cloud

Senza chiave

ARCore supporta l'autorizzazione delle chiamate API in iOS tramite un file JSON Web ). Il token deve essere firmato da un Account di servizio.

Al fine di generare token per iOS, devi avere un endpoint sul tuo server che soddisfi i seguenti requisiti:

• Il tuo meccanismo di autorizzazione deve proteggere l'endpoint.

• L'endpoint deve generare ogni volta un nuovo token, in modo che:

  • Ogni utente riceve un token univoco.
  • I token non scadono immediatamente.

Crea un account di servizio e una chiave di firma

Segui questi passaggi per creare un account di servizio Google e una chiave di firma:

1. In Google Cloud, apri la pagina Credenziali.
   Credenziali
2. Fai clic su Crea credenziali > Account di servizio.
3. In Dettagli account di servizio, digita un nome per il nuovo account, quindi fai clic su Crea.
4. Nella pagina Autorizzazioni account di servizio, vai al menu a discesa Seleziona un ruolo. Seleziona Account di servizio > Creatore token account di servizio, quindi fai clic su Continua.
5. Nella pagina Concedi agli utenti l'accesso a questo account di servizio, fai clic su Fine.
6. Nella pagina Credentials (Credenziali) individua la sezione Account di servizio e fai clic sul nome dell'account che hai appena creato.
7. Nella pagina Dettagli account di servizio, scorri verso il basso fino alla sezione Chiavi e Seleziona Aggiungi chiave > Crea nuova chiave.

8. Seleziona JSON come tipo di chiave e fai clic su Crea.

   Viene scaricato un file JSON contenente la chiave privata sulla tua macchina. Negozio il file della chiave JSON scaricato in una posizione sicura.

Crea token sul tuo server

Per creare nuovi token (JWT) sul tuo server, utilizza il metodo JWT standard biblioteche e il file JSON che hai scaricato in modo sicuro dal nuovo account di servizio.

Crea token sul tuo computer di sviluppo

Per generare JWT sul tuo computer di sviluppo, usa quanto segue Comando oauth2l:

oauth2l fetch --cache "" --jwt --json $KEYFILE --audience "https://arcore.googleapis.com/"

È necessario specificare una posizione della cache vuota utilizzando il flag --cache per assicura che venga generato ogni volta un token diverso. Assicurati di tagliare stringa risultante. Gli spazi aggiuntivi o i caratteri di nuova riga fanno sì che l'API rifiuta il token.

Firma il token

Per firmare il JWT, devi utilizzare l'algoritmo RS256 e le seguenti attestazioni:

• iss: l'indirizzo email dell'account di servizio.
• sub: l'indirizzo email dell'account di servizio.
• iat: l'ora Unix in cui è stato generato il token, espressa in secondi.
• exp - iat + 3600 (1 ora). L'epoca di Unix in cui scade il token, in pochi secondi.
• aud: il pubblico. Deve essere impostato su https://arcore.googleapis.com/.

Le attestazioni non standard non sono richieste nel payload JWT, sebbene sia possibile trovare Affermazione uid utile per identificare l'utente corrispondente.

Se utilizzi un approccio diverso per generare i tuoi JWT, ad esempio utilizzando un in un ambiente gestito da Google, assicurati di firmare i tuoi JWT con le in questa sezione. Assicurati innanzitutto che il pubblico sia corretto.

Passare il token nella sessione ARCore

1. Costruire una sessione GARSession#sessionWithError:

   NSError *error = nil;
   GARSession *garSession = [GARSession sessionWithError:&error];
   

2. Quando ottieni un token, passalo alla sessione utilizzando setAuthToken: In caso contrario, la sessione utilizzerà il token di autorizzazione valido più recente che hai passato. Richiama questo metodo ogni volta che aggiorni il token:

   [garSession setAuthToken: authToken]
   

La tua app è ora configurata per utilizzare l'autenticazione senza chiave.

Quando passi un token alla sessione, tieni presente quanto segue:

• Se hai utilizzato una chiave API per creare la sessione, ARCore ignorerà il e registrare un errore.

  Se non hai più bisogno della chiave API, eliminala in Google Developers Console e rimuoverlo dalla dell'app.

• ARCore ignora i token che contengono spazi o caratteri speciali.

• In genere i token scadono dopo un'ora. Se esiste la possibilità che il tuo potrebbe scadere durante l'uso, ottenere un nuovo token e passarlo all'API.

Chiave API

1. In Google Cloud, apri la pagina Credenziali.
   Credenziali
2. Fai clic su Crea credenziali, quindi seleziona Chiave API dal menu.
   Il La finestra di dialogo Chiave API creata mostra la stringa per la chiave appena creata.

3. Quando crei una GARSession, usa GARSession#sessionWithAPIKey:bundleIdentifier:error: e inserisci la chiave API:

   self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                                  bundleIdentifier:nil
                                             error:&error];
   

4. Consulta la documentazione sulle limitazioni relative alle chiavi API per proteggere la chiave API.

L'app è ora configurata per l'utilizzo delle chiavi API.