Jetons Web JSON

Un jeton Web JSON (JWT) est une norme Web ouverte utilisée pour authentifier et autoriser les échanges d'informations entre un client et un serveur. Lorsqu'un utilisateur d'application se connecte pour la première fois avec les identifiants de rôle appropriés, le serveur crée et renvoie un jeton JWT encodé et signé numériquement pour une utilisation avec les requêtes ultérieures. Ce processus authentifie l'utilisateur et l'autorise à accéder aux itinéraires, aux services et aux ressources en fonction du rôle de son compte.

Fleet Engine nécessite l'utilisation de jetons Web JSON (JWT) pour les appels de méthodes d'API à partir d'environnements à faible niveau de confiance : smartphones et navigateurs.

Un jeton JWT est généré sur votre serveur, signé, chiffré et transmis au client pour les interactions ultérieures avec le serveur, jusqu'à ce qu'il expire ou ne soit plus valide.

Informations importantes

Contrairement aux clés API, les JWT sont de courte durée et limitent les opérations à celles que le rôle est autorisé à effectuer. Pour en savoir plus sur les jetons JWT, consultez Jetons Web JSON sur Wikipédia. Pour en savoir plus sur les rôles d'accès, consultez Rôles des comptes de service dans ce guide.

Éléments JWT

Les JWT contiennent un en-tête et une section de revendications. La section d'en-tête contient des informations telles que la clé privée obtenue à partir des comptes de service et l'algorithme de chiffrement. La section "Revendications" contient des informations telles que l'heure de création et la durée de vie du jeton JWT, les services auxquels le jeton JWT revendique l'accès et d'autres informations d'autorisation pour définir l'étendue de l'accès (par exemple, l'ID du véhicule de livraison).

Le tableau suivant fournit des informations descriptives sur les champs JWT en général, ainsi que des informations spécifiques sur l'emplacement des valeurs de ces champs dans votre projet cloud Fleet Engine.

Champs d'en-tête JWT

Champ

Description

alg

Algorithme à utiliser. `RS256`.

typ

Type de jeton. `JWT`.

enfant

ID de la clé privée de votre compte de service. Vous trouverez cette valeur dans le champ private_key_id du fichier JSON de votre compte de service. Veillez à utiliser une clé provenant d'un compte de service disposant du bon niveau d'autorisation.
Champs de revendications JWT

Champ

Description

iss

Adresse e-mail de votre compte de service, qui se trouve dans le champ client_email de votre fichier JSON de compte de service.

Pub/Sub.

Adresse e-mail de votre compte de service, qui se trouve dans le champ client_email de votre fichier JSON de compte de service.

aud

SERVICE_NAME de votre compte de service, dans ce cas https://fleetengine.googleapis.com/

iat

Code temporel de création du JWT, spécifié en secondes écoulées depuis 00:00:00 UTC, January 1, 1970. Prévoyez 10 minutes pour l'inclinaison. Si le code temporel est trop éloigné dans le passé ou dans le futur, le serveur peut signaler une erreur.

exp

Code temporel d'expiration du jeton JWT, spécifié en secondes écoulées depuis 00:00:00 UTC, January 1, 1970. La requête échoue si le code temporel est situé au-delà d'une heure dans le futur.

autorisation

Selon le cas d'utilisation, peut contenir deliveryvehicleid, trackingid, taskid ou taskids.

Si vous spécifiez des taskid, le champ d'autorisation doit être un tableau sous l'une des formes suivantes :

"taskids": ["task_id_one","task_id_two"]

ou

"taskids": ["*"]

Revendications JWT Fleet Engine

Fleet Engine utilise des revendications privées. L'utilisation de revendications privées garantit que seuls les clients autorisés peuvent accéder à leurs propres données.

Par exemple, lorsque votre serveur émet un jeton Web JSON pour l'appareil mobile d'un chauffeur, il doit contenir la revendication vehicleid ou la revendication deliveryvehicleid avec la valeur de l'ID du véhicule de ce chauffeur. Ensuite, en fonction du rôle du chauffeur, les JWT permettent d'accéder uniquement à l'ID de véhicule spécifique et non à un autre ID de véhicule arbitraire.

Fleet Engine utilise les revendications privées suivantes :

Trajets à la demande

  • vehicleid :
    • Le Driver SDK utilise toujours cette revendication, qu'il s'agisse d'un trajet ou d'un véhicule. Le backend Fleet Engine s'assure que le véhicule est associé au trajet demandé avant d'effectuer la modification.
    • Le jeton JWT peut couvrir les opérations sur les véhicules et les trajets, même si ce n'est pas obligatoire, ce qui peut simplifier l'implémentation de la signature JWT.
  • tripid :
    • Le SDK Consumer utilise toujours cette revendication.
    • Le JWT peut couvrir les opérations sur les véhicules et les trajets, même si ce n'est pas obligatoire, ce qui peut simplifier l'implémentation de la signature du jeton.

Tâches programmées

  • deliveryvehicleid

    À utiliser lors de l'appel des API par véhicule de livraison.

  • taskid

    À utiliser lors de l'appel des API par tâche.

  • taskids

    À utiliser lors d'un appel : BatchCreateTasksAPI. Cette revendication doit être sous forme de tableau, et le tableau doit contenir tous les ID de tâches nécessaires pour exécuter la requête. N'incluez pas les revendications delivervehicleid, trackingid ni taskid.

  • trackingid

    À utiliser lors de l'appel de GetTaskTrackingInfoAPI. La réclamation doit correspondre à l'ID de suivi dans la demande. N'incluez pas les revendications delivervehicleid, taskid ni taskids.

Étape suivante