Przewodnik dla programistów Cloud Anchors na temat kierowania na Unity na iOS

Uwierzytelnianie tokenu (JWT)

Opcja tokena uwierzytelniania może hostować Cloud Anchor przez maksymalnie 365 dni. Ta opcja musi być używana przez kotwicy w chmurze z wartością TTL większą niż 1 dzień. Aby wygenerować tokeny na iOS, musisz mieć na serwerze punkt końcowy, który spełnia te wymagania:

• Twój własny mechanizm uwierzytelniania musi chronić punkt końcowy.

• Punkt końcowy musi za każdym razem generować nowy token. Na przykład:

  • Każdy użytkownik otrzymuje unikalny token.
  • Tokeny nie wygasają natychmiast.

Obecnie jedynym obsługiwanym typem tokena jest podpisany token JWT (token sieciowy JSON podpisany przez konto usługi Google). Wprowadzenie do tokenów JWT znajdziesz na oficjalnej stronie tokena JWT.

Tworzenie konta usługi i klucza podpisywania

Aby utworzyć konto usługi Google i klucz podpisywania, wykonaj te czynności:

1. W menu nawigacyjnym konsoli Google Cloud Platform kliknij Interfejsy API i usługi & gt; Dane logowania.

2. Wybierz odpowiedni projekt, a następnie kliknij Utwórz dane logowania > Konto usługi.

3. W sekcji Szczegóły konta usługi wpisz nazwę nowego konta, a następnie kliknij Utwórz.

4. Na stronie Uprawnienia do konta usługi kliknij menu Wybierz rolę. Wybierz Konta usługi > Kreator tokenów konta usługi, a następnie kliknij Dalej.

5. Na stronie Przyznaj użytkownikom dostęp do tego konta usługi kliknij Gotowe. Spowoduje to powrót na stronę Interfejsy API i usługi & gt; Dane logowania.

6. Przewiń stronę Dane logowania w dół do sekcji Konta usługi i kliknij nazwę właśnie utworzonego konta.

7. Na stronie Szczegóły konta usługi przewiń 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 pliku JSON zawierającego klucz prywatny na Twój komputer. Zapisz pobrany plik klucza JSON w bezpiecznym miejscu.

Tworzenie tokenów na serwerze

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

Tworzenie tokenów na komputerze programisty

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

oauth2l fetch --jwt --json $KEYFILE $AUDIENCE --cache ""

Określenie pustej lokalizacji pamięci podręcznej za pomocą flagi --cache jest konieczne, aby za każdym razem generowany był inny token. Pamiętaj, aby przyciąć wynikowy ciąg znaków, ponieważ dodatkowe spacje lub znaki nowego wiersza spowodują, że token zostanie odrzucony przez ARCore.

Podpisz token

Aby móc podpisać token JWT, musisz użyć algorytmu RS256 i tych twierdzeń:

• iss – adres e-mail konta usługi,
• sub – adres e-mail konta usługi,
• iat – czas uniksowy wygenerowany przez token w sekundach.
• exp – iat + 3600 (1 godzina). Czas uniksowy (w sekundach) po wygaśnięciu tokena.
• aud – odbiorcy. Należy ustawić: https://arcore.googleapis.com.

Niestandardowe deklaracje nie są wymagane w ładunku JWT, ale roszczenie uid może być przydatne do zidentyfikowania odpowiedniego użytkownika.

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

Przekazywanie tokena do sesji ARCore

Po otrzymaniu tokena przekaż go do sesji ARCore za pomocą XPSession.SetAuthToken():

// Set the token to use when authenticating with the ARCore Cloud Anchor service
// on the iOS platform.
// This should be called each time the application's token is refreshed.
XPSession.SetAuthToken(string authToken);

Gdy przekazujesz token do sesji, pamiętaj o tych kwestiach:

• Jeśli nie przekażesz prawidłowego tokena, zanim spróbujesz hostować lub rozwiązać kotwicę, wystąpią błędy uwierzytelniania.
• ARCore ignoruje tokeny zawierające spacje lub znaki specjalne. ARCore ignoruje też wszystkie tokeny, jeśli utworzysz sesję z prawidłowym kluczem interfejsu API. Jeśli zdarzyło Ci się wcześniej używać klucza interfejsu API, którego już nie potrzebujesz, zalecamy usunięcie go w Google Developers Console i usunięcie z aplikacji po przeniesieniu użytkowników do najnowszej wersji.
• Tokeny tracą zwykle ważność po godzinie. Jeśli istnieje ryzyko, że token wygaśnie, gdy jest używany, uzyskaj nowy token i przekaż go do interfejsu API.

Uwierzytelnianie klucza interfejsu API

Użyj uwierzytelniania klucza interfejsu API, aby hostować i rozwiązywać problemy z kotwicami Cloud z wartością TTL do 24 godzin (1 dzień).

• W Unity kliknij Edit (Edytuj) > Project Settings (Ustawienia projektu) > ARCore Project Settings (Ustawienia projektu ARCore).
• Dodaj klucz interfejsu API w polu Klucze interfejsu Cloud Anchor API.