Przewodnik dla programistów Cloud Anchors dotyczący rozszerzeń ARCore kierowanych na iOS

Autoryzacja tokena (JWT)

Możesz używać tokena (podpisanego tokena JWT) do hostowania i rozwiązywania problemów z kotwicami Cloud z TTL od 1 do 365 dni. Obecnie jedynym obsługiwanym typem tokena jest podpisany token sieciowy JSON (JWT). Ten token musi być podpisany przez konto usługi Google.

1. Kliknij Edycja > Ustawienia projektu > XR Plug-in Management > ARCore Extensions i wybierz iOS Support Enabled (Obsługa w iOS).

   

2. W menu Strategia uwierzytelniania iOS wybierz opcję Token uwierzytelniania.

   

Wymagania dotyczące punktu końcowego serwera

Aby wygenerować tokeny na iOS, musisz mieć na serwerze punkt końcowy spełniający te wymagania:

1. Twój własny mechanizm autoryzacji chroni punkt końcowy.
2. Punkt końcowy musi generować nowy token za każdym razem, aby każdy użytkownik otrzymał unikalny token, który nie wygasa natychmiast.

Tworzenie konta usługi i klucza podpisywania

Wykonaj te czynności, aby utworzyć konto usługi Google i klucz podpisywania.

1. W menu nawigacyjnym konsoli Google Cloud Platform kliknij Interfejsy API i usługi > Dane logowania.
2. Wybierz projekt i kliknij Utwórz dane logowania > Konto usługi.
3. W sekcji Szczegóły konta usługi wpisz nazwę nowego konta i kliknij Utwórz.
4. Na stronie Uprawnienia konta usługi kliknij menu Wybierz rolę. Wybierz Service accounts (Konta usługi) > Service Account Token Creator (Twórca tokenów konta usługi) i kliknij Continue (Dalej).
5. Na stronie Przyznaj użytkownikom dostęp do tego konta usługi kliknij Gotowe. Spowoduje to powrót do sekcji Interfejsy API i usługi > Dane logowania.
6. Przewiń stronę Dane logowania w dół do sekcji Konta usługi i kliknij nazwę utworzonego konta.
7. Przewiń stronę Szczegóły konta usługi w dół do sekcji Klucze i wybierz Dodaj klucz > Utwórz nowy klucz.
8. Wybierz typ klucza JSON i kliknij Utwórz. Spowoduje to pobranie na komputer pliku JSON zawierającego klucz prywatny. Pobierz pobrany plik klucza JSON w bezpiecznym miejscu.

Plik JSON zawiera klucz prywatny, który nie może być dostępny publicznie. Nie zatwierdzaj go w repozytoriach kodu źródłowego, takich jak GitHub.

Tworzenie tokenów na serwerze

Aby utworzyć nowe tokeny (JWT) na serwerze, użyj standardowych bibliotek JWT i pliku JSON bezpiecznie pobranego z nowego konta usługi.

Tworzenie tokenów na komputerze programisty

Aby wygenerować tokeny JWT na komputerze programisty, użyj tego polecenia oauth2l:

// "oauth2l" uses a lowercase L, not a 1, as the last character.
// Specifying an empty cache location using the --cache flag is necessary
// to ensure that a different token is produced each time.
oauth2l fetch --cache "" --jwt --json $KEYFILE --audience "https://arcore.googleapis.com/"

Pamiętaj, aby przyciąć powstały ciąg znaków. Dodatkowe spacje lub znaki nowego wiersza spowodują odrzucenie tokena przez interfejs API.

Podpisz token

Aby podpisać token JWT, użyj algorytmu RS256 i tych twierdzeń:

• iss – adres e-mail konta usługi,
• sub – adres e-mail konta usługi,
• iat – czas uniksu wygenerowany w sekundach.
• exp – iat + 3600 (1 godzina). czas uniksowy (w sekundach), po którym token wygaśnie.
• aud – odbiorcy. Musi to być https://arcore.googleapis.com/.

Niestandardowe roszczenia nie są wymagane w ładunku JWT, chociaż deklaracja uid może być przydatna do identyfikacji odpowiedniego użytkownika.

Jeśli chcesz generować tokeny JWT w inny sposób, na przykład przy użyciu interfejsu API Google w środowisku zarządzanym przez Google, podpisz je przy użyciu deklaracji w tej sekcji. Przede wszystkim upewnij się, że odbiorcy są prawidłowa.

Przekazywanie tokena do sesji ARCore

Gdy otrzymasz token, przekaż go do sesji ARCore za pomocą ARAnchorManager.SetAuthToken():

// Designate the token to use when authorizing with the ARCore API
// on the iOS platform. The API should be called each time the application's token is refreshed.
ARAnchorManager.SetAuthToken(string authToken);

Podczas przekazywania tokena do sesji pamiętaj o tych kwestiach:

• Przed przystąpieniem do hostowania lub rozwiązania kotwicy musisz przekazać prawidłowy token autoryzacji.
• ARCore ignoruje tokeny autoryzacji, które zawierają spacje lub znaki specjalne.
• ARCore ignoruje podane tokeny autoryzacji, jeśli sesja zostanie utworzona z prawidłowym kluczem interfejsu API. Jeśli zdarzyło Ci się już używać klucza interfejsu API, którego już nie potrzebujesz, zalecamy usunięcie go w Google Cloud Platform Console i usunięcie go z aplikacji po przeniesieniu użytkowników do najnowszej wersji.
• Ważność tokena wygasa zazwyczaj po upływie godziny. Jeśli istnieje prawdopodobieństwo, że token wygaśnie w trakcie użycia, uzyskaj nowy token i wykonuj wywołania ARAnchorManager.SetAuthToken(string authToken) przy użyciu nowego tokena.

Autoryzacja klucza interfejsu API

Użyj autoryzacji klucza interfejsu API do hostowania i rozwiązywania problemów z kotwicami Cloud z TTL do 24 godzin (1 dzień).

Domyślna strategia autoryzacji w przypadku nowych projektów Unity utworzonych w ARCore SDK 1.24.0 lub nowszym to DoNotUse. Ma to na celu uniemożliwienie tworzenia aplikacji, które zawierają niepotrzebne biblioteki. Jeśli Twoja aplikacja korzysta z Cloud Anchor i została utworzona za pomocą pakietu ARCore SDK w wersji 1.24.0 lub nowszej, musisz ręcznie włączyć autoryzację w Ustawieniach projektu > Zarządzanie wtyczkami XR > Rozszerzenia ARCore.

1. Kliknij Edycja > Ustawienia projektu > XR Plug-in Management > ARCore Extensions i wybierz iOS Support Enabled (Obsługa w iOS).

   

2. W menu Strategia uwierzytelniania systemu iOS wybierz opcję Klucz interfejsu API.

   

3. Uzyskaj klucz interfejsu API tego projektu z konsoli Google Cloud.

4. Kliknij Edytuj > Ustawienia projektu > XR Plug-in Management > ARCore Extensions i dodaj klucz interfejsu API w polu Cloud Anchor API Keys.