Konfigurowanie biblioteki śledzenia floty JavaScriptu

Zanim użyjesz biblioteki śledzenia floty JavaScript, sprawdź, czy znasz i skonfigurowałem Fleet Engine. Więcej informacji: Fleet Engine.

Z tego dokumentu dowiesz się, jak włączyć autoryzację między aplikacją strony internetowej a Fleet Engine. Gdy Twoje żądania do Fleet Engine została skonfigurowana przy użyciu prawidłowych tokenów autoryzacji, możesz śledzić pojazd na mapie.

Autoryzacja konfiguracji

Fleet Engine wymaga użycia tokenów sieciowych JSON (JWT) podpisanych przez odpowiednie konto usługi do wywołań metody interfejsu API pochodzących od low-Trust . Środowiska o niskim stopniu zaufania to m.in. smartfony i przeglądarki. Token JWT zaczyna się na serwerze, który jest w pełni zaufanym środowiskiem. Token JWT jest podpisany, zaszyfrowany i przekazywany do klienta w celu kolejnego serwera. do momentu ich wygaśnięcia lub utraty ważności.

Twój backend powinien uwierzytelniać się i autoryzować we Fleet Engine za pomocą standardowych domyślnych danych logowania aplikacji. Marka używaj tokenów JWT, które zostały podpisane przez odpowiednie konto usługi. Dla lista ról konta usługi, zobacz role konta usługi Fleet Engine w artykule Podstawy floty.

Jak działa autoryzacja?

Autoryzacja za pomocą danych Fleet Engine obejmuje zarówno po stronie serwera, jak i klienta implementacji.

Autoryzacja po stronie serwera

Zanim skonfigurujesz autoryzację w aplikacji do śledzenia floty, Twój backend Serwer musi mieć możliwość obsługi tokenów sieciowych JSON. W ten sposób Fleet Engine rozpoznaje żądania pochodzące z aplikacji jako autoryzowane do dostępu dane zawarte w żądaniu. Instrukcje dotyczące implementacji JWT po stronie serwera znajdziesz tutaj: Wydaj tokeny sieciowe JSON w ramach Fleet Engine Essentials.

Aby wygenerować tokeny z serwera podczas wdrażania śledzenia floty, zapoznaj się z :

Autoryzacja po stronie klienta

Gdy używasz biblioteki śledzenia JavaScriptu, żąda ona tokena od serwera za pomocą modułu pobierania tokenów autoryzacji. Dzieje się tak, gdy jest spełniony dowolny z tych warunków:

  • Brak prawidłowego tokena, na przykład wtedy, gdy pakiet SDK nie wywołał modułu pobierania wczytanie nowej strony lub gdy moduł pobierania nie zwrócił się z tokenem.

  • Token wygasł.

  • Token wygaśnie w ciągu minuty.

W przeciwnym razie biblioteka śledzenia flot w JavaScripcie używa wcześniej wydanego, prawidłowego tokena i nie mogą wywoływać modułu pobierania.

Tworzenie funkcji pobierania tokena autoryzacji

Aby utworzyć funkcję pobierania tokenu autoryzacyjnego, postępuj zgodnie z tymi wskazówkami:

  • Moduł pobierania musi zwrócić strukturę danych z 2 polami opakowaną w Promise w następujący sposób:

    • Ciąg token.

    • Numer expiresInSeconds. Token wygaśnie w tym czasie po pobraniu. Moduł pobierania tokenów uwierzytelniania musi utracić ważność czas w sekundach, od momentu pobrania do biblioteki, jak widać w z przykładu.

  • Aby pobrać token, pobieracz powinien wywołać adres URL na Twoim serwerze. Ten adres URL (SERVER_TOKEN_URL) zależy od implementacji backendu. ten przykładowy URL dotyczy backendu przykładowej aplikacji na GitHubie:

    • https://SERVER_URL/token/fleet_reader

Przykład – tworzenie modułu do pobierania tokenów autoryzacji

Te przykłady pokazują, jak utworzyć funkcję pobierania tokena autoryzacji:

JavaScript

async function authTokenFetcher(options) {
  // options is a record containing two keys called
  // serviceType and context. The developer should
  // generate the correct SERVER_TOKEN_URL and request
  // based on the values of these fields.
  const response = await fetch(SERVER_TOKEN_URL);
  if (!response.ok) {
    throw new Error(response.statusText);
  }
  const data = await response.json();
  return {
    token: data.Token,
    expiresInSeconds: data.ExpiresInSeconds
  };
}

TypeScript

function authTokenFetcher(options: {
  serviceType: google.maps.journeySharing.FleetEngineServiceType,
  context: google.maps.journeySharing.AuthTokenContext,
}): Promise<google.maps.journeySharing.AuthToken> {
  // The developer should generate the correct
  // SERVER_TOKEN_URL based on options.
  const response = await fetch(SERVER_TOKEN_URL);
  if (!response.ok) {
    throw new Error(response.statusText);
  }
  const data = await response.json();
  return {
    token: data.token,
    expiresInSeconds: data.ExpiresInSeconds,
  };
}

Co dalej?