Tokeny sieciowe JSON

Token internetowy JSON (JWT) to otwarty standard internetowy używany do uwierzytelniania i autoryzowania wymiany informacji między klientem a serwerem. Gdy użytkownik aplikacji zaloguje się po raz pierwszy za pomocą odpowiednich danych logowania do roli, serwer utworzy i zwróci zakodowany, podpisany cyfrowo token JWT do użycia w kolejnych żądaniach. Ten proces uwierzytelnia użytkownika i przyznaje mu uprawnienia dostępu do tras, usług i zasobów na podstawie jego roli na koncie.

Fleet Engine wymaga używania tokenów sieciowych JSON (JWT) w przypadku wywołań metod interfejsu API z środowisk o niskim poziomie zaufania: smartfonów i przeglądarek.

Token JWT pochodzi z Twojego serwera, jest podpisany i zaszyfrowany, a następnie przekazywany do klienta w celu dalszych interakcji z serwerem, dopóki nie wygaśnie lub nie będzie już ważny.

Najważniejsze informacje

• Użyj domyślnego uwierzytelniania aplikacji, aby uwierzytelnić się i autoryzować w Fleet Engine.
• Używaj odpowiedniego konta usługi do podpisywania tokenów JWT. Więcej informacji o rolach konta usługi Fleet Engine znajdziesz w artykule Podstawy Fleet Engine.

W odróżnieniu od kluczy API tokeny JWT mają krótki okres ważności i ograniczają operacje tylko do tych, które może wykonywać dana rola. Więcej informacji o tokenach JWT znajdziesz w artykule JSON Web Tokens w Wikipedii. Więcej informacji o rolach dostępu znajdziesz w sekcji Role konta usługi w tym przewodniku.

Elementy JWT

Tokeny JWT zawierają nagłówek i sekcję deklaracji. Sekcja nagłówka zawiera informacje takie jak klucz prywatny uzyskany z kont usługi i algorytm szyfrowania. Sekcja deklaracji zawiera informacje takie jak czas utworzenia JWT, czas życia danych (TTL), usługi, do których JWT deklaruje dostęp, oraz inne informacje o autoryzacji, które ograniczają zakres dostępu, np. identyfikator pojazdu dostawczego.

W tabeli poniżej znajdziesz ogólne informacje o polach JWT, a także szczegółowe informacje o tym, gdzie w projekcie w chmurze Fleet Engine możesz znaleźć wartości tych pól.

Pola nagłówka JWT

Pole	Opis
alg	Algorytm do użycia. `RS256`.
typ	Typ tokena. `JWT`.
dziecko	Identyfikator klucza prywatnego konta usługi. Znajdziesz go w polu private_key_id pliku JSON konta usługi. Używaj klucza z konta usługi z odpowiednim poziomem uprawnień.

Pola roszczeń JWT

Pole	Opis
iss	Adres e-mail konta usługi, który znajdziesz w polu client_email pliku JSON konta usługi.
zast.	Adres e-mail konta usługi, który znajdziesz w polu client_email pliku JSON konta usługi.
aud	SERVICE_NAME na koncie usługi, w tym przypadku https://fleetengine.googleapis.com/
iat	Sygnatura czasowa utworzenia tokena JWT podana w sekundach, które upłynęły od godziny 00:00:00 UTC, January 1, 1970. Odczekaj 10 minut, aby skorygować odchylenie. Jeśli sygnatura czasowa jest zbyt odległa w przeszłości lub przyszłości, serwer może zgłosić błąd.
exp	Sygnatura czasowa wygaśnięcia tokena JWT podana w sekundach, które upłynęły od 00:00:00 UTC, January 1, 1970. Żądanie kończy się niepowodzeniem, jeśli sygnatura czasowa jest późniejsza niż za godzinę.
autoryzacja	W zależności od przypadku użycia może zawierać deliveryvehicleid, trackingid, taskid lub taskids. Jeśli określasz identyfikatory zadań, zakres autoryzacji musi być tablicą w jednym z tych formatów: "taskids": ["task_id_one","task_id_two"] lub "taskids": ["*"]

Roszczenia JWT w usłudze Fleet Engine

Fleet Engine używa prywatnych roszczeń. Używanie prywatnych roszczeń zapewnia, że tylko autoryzowani klienci mogą uzyskać dostęp do własnych danych.

Na przykład, gdy serwer wydaje token sieciowy JSON na urządzenie mobilne kierowcy, powinien on zawierać roszczenie vehicleid lub roszczenie deliveryvehicleid z wartością identyfikatora pojazdu tego kierowcy. W zależności od roli kierowcy tokeny JWT umożliwiają dostęp tylko do konkretnego identyfikatora pojazdu, a nie do dowolnego innego identyfikatora pojazdu.

Fleet Engine używa tych prywatnych roszczeń:

Co dalej?

• Aby poznać pełny proces uwierzytelniania, zapoznaj się z informacjami o architekturze zabezpieczeń Fleet Engine.
• Dowiedz się, jak wydawać tokeny sieciowe JSON z serwera.