Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Problema con i token web JSON

Questo documento descrive come emettere token web JSON nell'ambito dell'abilitazione dell'accesso delle tue app web e mobile ai dati di Fleet Engine. Se non l'hai ancora fatto, leggi Token web JSON nella sezione Sicurezza in Fleet Engine. Con il servizio Fleet Engine, puoi emettere JWT in uno dei seguenti modi:

Utilizza la libreria di autorizzazione: Google consiglia di utilizzare questo approccio quando il codebase è scritto in Java. Questa libreria gestisce l'emissione di JWT per tutti gli scenari di casi d'uso di cui potresti aver bisogno con il servizio e semplifica notevolmente l'implementazione.
Crea i tuoi JWT: se non puoi utilizzare la nostra libreria JWT, dovrai crearli nel tuo codebase. Questa sezione fornisce i vari esempi di JWT per ogni scenario.

Come funzionano i JWT

Per gli ambienti non attendibili, come smartphone e browser web, il server di backend emette JWT che funzionano come segue:

Il codice client in esecuzione in un ambiente con un livello di attendibilità basso chiama il codice server in esecuzione in un ambiente completamente attendibile per richiedere il JWT appropriato da passare a Fleet Engine.
I JWT sono associati ai service account, pertanto le richieste inviate a Fleet Engine sono implicitamente associate al service account che ha firmato il JWT.
Le rivendicazioni JWT limitano ulteriormente le risorse su cui il client può operare, ad esempio veicoli, corse o attività specifici.

Utilizza la libreria di autorizzazione per Java

Per utilizzare la libreria di autorizzazione di Fleet Engine per Java, visita il repository GitHub. La libreria semplifica la creazione dei JWT di Fleet Engine e li firma in modo sicuro. Offre quanto segue:

Dichiarazioni delle dipendenze del progetto
Un elenco completo di tutti i ruoli dei service account per corse on demand o attività pianificate
Meccanismi di firma dei token diversi dall'utilizzo di file di credenziali, come l'impersonificazione di un service account
Collega i token firmati alle richieste in uscita effettuate da uno stub gRPC o da una libreria client API di Google Codegen (GAPIC)
Istruzioni su come integrare i firmatari con le librerie client di Fleet Engine

Se emetti JWT dal tuo codice

Se non puoi utilizzare la libreria di autorizzazione per Java, devi implementare i JWT nel tuo codebase. Questa sezione fornisce alcune linee guida per la creazione dei tuoi token. Per un elenco dei campi e delle rivendicazioni JWT, consulta Token web JSON nella sezione Sicurezza in Fleet Engine. Consulta Ruoli dei service account per i ruoli dei service account utilizzati da Fleet Engine. Consulta la sezione seguente per un elenco di esempi di JWT per corse on demand o attività pianificate.

Linee guida generali

Utilizza i service account e i ruoli appropriati. Il service account e il ruolo associato garantiscono che l'utente che richiede il token sia autorizzato a visualizzare le informazioni a cui il token concede l'accesso. In particolare:
- Se firmi un JWT da passare a un dispositivo mobile, utilizza l'account di servizio per il ruolo SDK Driver o Consumer. In caso contrario, il dispositivo mobile può alterare e accedere a dati a cui non dovrebbe avere accesso.
- Se firmi il JWT da utilizzare per le chiamate con privilegi, utilizza il service account con il ruolo Amministratore Fleet Engine corretto quando utilizzi ADC o JWT. In caso contrario, l'operazione non va a buon fine.
Condividi solo i token creati. Non condividere mai le credenziali utilizzate per creare i token.
Per le chiamate gRPC, il meccanismo per allegare il token dipende dal linguaggio e dal framework utilizzati per effettuare la chiamata. Il meccanismo per specificare un token per una chiamata HTTP consiste nell'includere un'intestazione Authorization con un token di connessione il cui valore è il token.
Restituisci una data di scadenza. Il tuo server deve restituire una data di scadenza per il token, in genere in secondi.
Se devi creare e firmare un JSON direttamente come portatore di token, anziché utilizzare i token di accesso OAuth 2.0, leggi le istruzioni per l'autorizzazione dei service account senza OAuth nella documentazione per lo sviluppo di Identity.

Per le corse on demand

Quando crei il payload JWT, aggiungi un claim aggiuntivo nella sezione di autorizzazione con la chiave vehicleid o tripid impostata sul valore dell'ID veicolo o dell'ID corsa per cui viene effettuata la chiamata.

Per le attività pianificate

Quando il tuo server chiama altre API, i token devono contenere anche la claim appropriata. A questo scopo, puoi procedere nel seguente modo:
- Imposta il valore di ogni chiave su *.
- Concedi all'utente l'accesso a tutti i taskids e deliveryvehicleids. Per farlo, aggiungi un'ulteriore attestazione nella sezione di autorizzazione con le chiavi taskid e deliveryvehicleid.
- Quando utilizzi l'asterisco (*) nell'attestazione taskids, deve essere l'unico elemento dell'array.

Esempi di JWT per le corse on demand

Questa sezione fornisce esempi di JWT per scenari comuni se utilizzi corse on demand.

Token di esempio per un'operazione dell'app per i conducenti

{
  "alg": "RS256",
  "typ": "JWT",
  "kid": "private_key_id_of_driver_service_account"
}
.
{
  "iss": "driver@yourgcpproject.iam.gserviceaccount.com",
  "sub": "driver@yourgcpproject.iam.gserviceaccount.com",
  "aud": "https://fleetengine.googleapis.com/",
  "iat": 1511900000,
  "exp": 1511903600,
  "authorization": {
     "vehicleid": "driver_12345"
   }
}

Token di esempio per un'operazione di un'app per utenti finali

{
  "alg": "RS256",
  "typ": "JWT",
  "kid": "private_key_id_of_consumer_service_account"
}
.
{
  "iss": "consumer@yourgcpproject.iam.gserviceaccount.com",
  "sub": "consumer@yourgcpproject.iam.gserviceaccount.com",
  "aud": "https://fleetengine.googleapis.com/",
  "iat": 1511900000,
  "exp": 1511903600,
  "authorization": {
     "tripid": "trip_54321"
   }
}

Esempi di JWT per le attività pianificate

Questa sezione fornisce un esempio di JWT per scenari tipici se utilizzi attività pianificate.

Token di esempio per un'app per conducenti

    {
      "alg": "RS256",
      "typ": "JWT",
      "kid": "private_key_id_of_delivery_driver_service_account"
    }
    .
    {
      "iss": "driver@yourgcpproject.iam.gserviceaccount.com",
      "sub": "driver@yourgcpproject.iam.gserviceaccount.com",
      "aud": "https://fleetengine.googleapis.com/",
      "iat": 1511900000,
      "exp": 1511903600,
      "authorization": {
         "deliveryvehicleid": "driver_12345"
       }
    }

Token di esempio per un'app per utenti finali

    {
      "alg": "RS256",
      "typ": "JWT",
      "kid": "private_key_id_of_delivery_consumer_service_account"
    }
    .
    {
      "iss": "consumer@yourgcpproject.iam.gserviceaccount.com",
      "sub": "consumer@yourgcpproject.iam.gserviceaccount.com",
      "aud": "https://fleetengine.googleapis.com/",
      "iat": 1511900000,
      "exp": 1511903600,
      "authorization": {
         "trackingid": "shipment_12345"
       }
    }

Esempi di JWT per le operazioni del parco risorse

Questa sezione fornisce un esempio di JWT per uno scenario tipico delle operazioni del parco risorse.

Token di esempio per monitorare tutte le attività e i veicoli di una flotta

L'esempio seguente è un token che monitora tutte le attività e i veicoli della flotta da un'app basata sul web utilizzata da un operatore. Le autorizzazioni richieste per queste operazioni sono maggiori rispetto a quelle per le applicazioni client. Consulta Configura la libreria di monitoraggio del parco risorse JavaScript per l'implementazione lato client che utilizzerà questo token:

Firma il token utilizzando il ruolo Cloud IAM Fleet Engine Delivery Fleet Reader.

Nota: il token creato utilizzando questo ruolo concede alcune autorizzazioni alle entità di Fleet Engine. Assicurati che il tuo backend condivida il token solo con gli utenti autenticati.

   {
      "alg": "RS256",
      "typ": "JWT",
      "kid": "private_key_id_of_consumer_service_account"
    }
    .
    {
      "iss": "superuser@yourgcpproject.iam.gserviceaccount.com",
      "sub": "superuser@yourgcpproject.iam.gserviceaccount.com",
      "aud": "https://fleetengine.googleapis.com/",
      "iat": 1511900000,
      "exp": 1511903600,
      "scope": "https://www.googleapis.com/auth/xapi",
      "authorization": {
         "taskid": "*",
         "deliveryvehicleid": "*",
       }
    }

Metodo di autenticazione alternativo per le operazioni del server di backend

Google consiglia di utilizzare ADC per autenticare le operazioni del server di backend. Se non puoi utilizzare ADC e devi utilizzare i JWT, consulta questi esempi.

Token di esempio per un'operazione del server di backend on demand

  {
    "alg": "RS256",
    "typ": "JWT",
    "kid": "private_key_id_of_provider_service_account"
  }

  {
    "iss": "provider@yourgcpproject.iam.gserviceaccount.com",
    "sub": "provider@yourgcpproject.iam.gserviceaccount.com",
    "aud": "https://fleetengine.googleapis.com/",
    "iat": 1511900000,
    "exp": 1511903600,
    "authorization": {
       "vehicleid": "*",
       "tripid": "*"
     }
  }

Token di esempio per un'operazione pianificata del server di backend

    {
      "alg": "RS256",
      "typ": "JWT",
      "kid": "private_key_id_of_provider_service_account"
    }
    .
    {
      "iss": "provider@yourgcpproject.iam.gserviceaccount.com",
      "sub": "provider@yourgcpproject.iam.gserviceaccount.com",
      "aud": "https://fleetengine.googleapis.com/",
      "iat": 1511900000,
      "exp": 1511903600,
      "authorization": {
         "taskid": "*"
       }
    }

Token di esempio per un'operazione di creazione di attività batch del server di backend pianificata

    {
      "alg": "RS256",
      "typ": "JWT",
      "kid": "private_key_id_of_provider_service_account"
    }
    .
    {
      "iss": "provider@yourgcpproject.iam.gserviceaccount.com",
      "sub": "provider@yourgcpproject.iam.gserviceaccount.com",
      "aud": "https://fleetengine.googleapis.com/",
      "iat": 1511900000,
      "exp": 1511903600,
      "authorization": {
         "taskids": ["*"]
       }
    }

Esempio di token per un'operazione pianificata del server di backend per veicolo di consegna

    {
      "alg": "RS256",
      "typ": "JWT",
      "kid": "private_key_id_of_provider_service_account"
    }
    .
    {
      "iss": "provider@yourgcpproject.iam.gserviceaccount.com",
      "sub": "provider@yourgcpproject.iam.gserviceaccount.com",
      "aud": "https://fleetengine.googleapis.com/",
      "iat": 1511900000,
      "exp": 1511903600,
      "authorization": {
         "deliveryvehicleid": "*"
       }
    }

Passaggi successivi

Verifica la configurazione per creare un veicolo di prova e assicurarti che i token funzionino come previsto.
Per informazioni sull'utilizzo di ADC anziché di JWT per le operazioni del server di backend, consulta la Panoramica della sicurezza.