Tokeny sieciowe JSON

Token internetowy JSON (JWT) to otwarty standard internetowy, który służy do uwierzytelniania i autoryzowania wymiany informacji między klientem a serwerem. Gdy użytkownik aplikacji po raz pierwszy zaloguje się przy użyciu 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 autoryzuje go do uzyskiwania dostępu do tras, usług i zasobów na podstawie roli na koncie.

W przypadku wywołań metod interfejsu API z środowisk o niskim poziomie zaufania usługa Fleet Engine wymaga korzystania z tokenów sieciowych JSON (JWT) podpisanych odpowiednim kontem usługi. Środowiska o niskim poziomie zaufania to smartfony i przeglądarki. Token JWT pochodzi z serwera, który jest pełnowymiarowym zaufanym środowiskiem. JWT jest podpisywany, szyfrowany i przekazywany do klienta na potrzeby kolejnych interakcji z serwerem, dopóki nie wygaśnie lub nie straci ważności.

Twój backend powinien uwierzytelniać i autoryzować się w Fleet Engine za pomocą standardowych mechanizmów domyślnych danych logowania aplikacji. Upewnij się, że używasz tokenów JWT podpisanych przez odpowiednie konto usługi. Listę ról kont usług znajdziesz w artykule Podstawy Fleet Engine, w sekcji Role kont usług Fleet Engine.

Z kolei backend powinien uwierzytelniać i autoryzować się w ramach Fleet Engine, korzystając ze standardowych mechanizmów danych logowania aplikacji.

W przeciwieństwie do kluczy API tokeny JWT są krótkotrwałe i ograniczają operacje tylko do tych, które są autoryzowane przez daną rolę. Więcej informacji o tokenach JWT znajdziesz w artykule Tokeny sieciowe JSON w Wikipedii. Szczegółowe informacje o rolach dostępu znajdziesz w sekcji Rola konta usługi w tym przewodniku.

Elementy JWT

Tokeny JWT zawierają nagłówek i sekcję z roszczeniami. Sekcja nagłówka zawiera informacje takie jak klucz prywatny uzyskany z kont kont usługi oraz algorytm szyfrowania. Sekcja oświadczenia zawiera informacje takie jak czas utworzenia i czas ważności tokena JWT, usługi, do których token JWT ma dostęp, oraz inne informacje autoryzujące zakres dostępu, na przykład identyfikator pojazdu dostawczego.

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

Pola nagłówka JWT

Pole	Opis
alg	algorytm, `RS256`.
typ	Typ tokena. `JWT`.
dziecko	Identyfikator klucza prywatnego konta usługi. Znajdziesz ją w polu private_key_id w pliku JSON konta usługi. Upewnij się, że używasz klucza z konta usługi o odpowiednim poziomie uprawnień.

Pola roszczeń JWT

Pole	Opis
iss	Adres e-mail konta usługi, który znajdziesz w polu client_email w pliku JSON konta usługi.
zast.	Adres e-mail konta usługi, który znajdziesz w polu client_email w 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 w sekundach od 00:00:00 UTC, January 1, 1970. Zaczekaj 10 minut na wyrównanie. 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 od 00:00:00 UTC, January 1, 1970. Prośba zakończy się niepowodzeniem, jeśli sygnatura czasowa wskazuje na więcej niż 1 godzinę w przyszłości.
autoryzacja	W zależności od przypadku użycia może zawierać deliveryvehicleid, trackingid, taskid lub taskids. Jeśli podajesz identyfikatory zadań, zakres autoryzacji musi być tablicą w jednej z tych form: "taskids": ["task_id_one","task_id_two"] lub "taskids": ["*"]

Roszczenia dotyczące JWT w Fleet Engine

Silnik floty korzysta z zaświadczeń prywatnych. Dzięki używaniu prywatnych roszczeń tylko upoważnieni klienci mają dostęp do swoich danych.

Jeśli na przykład serwer wydaje token sieci Web JSON dla urządzenia mobilnego kierowcy, powinien on zawierać oświadczenie vehicleid lub oświadczenie deliveryvehicleid z wartością identyfikatora pojazdu tego kierowcy. Następnie, w zależności od roli kierowcy, tokeny JWT umożliwiają dostęp tylko do określonego identyfikatora pojazdu, a nie dowolnego innego identyfikatora pojazdu.

Fleet Engine używa tych prywatnych roszczeń:

Co dalej?

• Aby poznać pełny proces uwierzytelniania, zapoznaj się z projektowaniem zabezpieczeń Fleet Engine.
• Dowiedz się, jak wydawać tokeny sieciowe JSON na serwerze.