Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

JSON ウェブトークンを発行する

このドキュメントでは、ウェブベースおよびモバイルベースのアプリが Fleet Engine データにアクセスできるようにする一環として、JSON Web Token を発行する方法について説明します。まだお読みでない場合は、Fleet Engine のセキュリティ セクションの JSON ウェブトークンをご覧ください。Fleet Engine サービスでは、次のいずれかの方法で JWT を発行できます。

認可ライブラリを使用する - コードベースが Java で記述されている場合は、この方法を使用することをおすすめします。このライブラリは、サービスで必要になる可能性のあるすべてのユースケースシナリオの JWT の発行を処理し、実装を大幅に簡素化します。
独自の JWT を作成する - Google の JWT ライブラリを使用できない場合は、独自のコードベースに組み込む必要があります。このセクションでは、各シナリオの JWT のさまざまな例を示します。

JWT の仕組み

スマートフォンやウェブブラウザなどの信頼できない環境では、バックエンドサーバーが次のように機能する JWT を発行します。

信頼度の低い環境で実行されているクライアントコードが、信頼度の高い環境で実行されているサーバーコードを呼び出し、Fleet Engine に渡す適切な JWT をリクエストします。
JWT はサービスアカウントに関連付けられているため、Fleet Engine に送信されるリクエストは、JWT に署名したサービスアカウントに暗黙的に関連付けられます。
JWT クレームは、クライアントが操作できるリソース（特定の車両、乗車、タスクなど）をさらに制限します。

Java 用の認可ライブラリを使用する

Java 用 Fleet Engine 認証ライブラリを使用するには、GitHub リポジトリをご覧ください。このライブラリを使用すると、Fleet Engine JWT の構築が簡素化され、安全に署名できます。次の機能を提供します。

プロジェクトの依存関係の宣言
オンデマンドトリップまたはスケジュール設定されたタスクのすべてのサービスアカウントロールの完全なリスト
認証情報ファイルの使用以外のトークン署名メカニズム（サービスアカウントの権限借用など）
gRPC スタブまたは Google API Codegen（GAPIC）クライアントライブラリから送信されるアウトバウンドリクエストに署名付きトークンを添付します。
署名者を Fleet Engine クライアントライブラリと統合する手順

コードから JWT を発行する場合

Java 用の認可ライブラリを使用できない場合は、独自のコードベースに JWT を実装する必要があります。このセクションでは、独自のトークンを作成するためのガイドラインをいくつか示します。JWT のフィールドとクレームのリストについては、Fleet Engine のセキュリティ セクションの JSON ウェブトークンをご覧ください。Fleet Engine で使用されるサービスアカウントのロールについては、サービスアカウントのロールをご覧ください。オンデマンドの乗車またはスケジュール設定されたタスクの JWT の例については、次のセクションをご覧ください。

一般的なガイドライン

適切なサービスアカウントとロールを使用します。サービスアカウントと関連付けられたロールにより、トークンをリクエストするユーザーに、トークンが付与する情報へのアクセス権が付与されます。詳細は以下のとおりです。
- モバイルデバイスに渡される JWT に署名する場合は、Driver SDK または Consumer SDK のロールにサービスアカウントを使用します。そうしないと、モバイルデバイスがアクセス権のないデータにアクセスして変更する可能性があります。
- 特権呼び出しに使用する JWT に署名する場合は、ADC または JWT を使用する際に、適切な Fleet Engine 管理者ロールを持つサービスアカウントを使用します。それ以外の場合、オペレーションは失敗します。
作成したトークンのみを共有します。トークンの作成に使用した認証情報は共有しないでください。
gRPC 呼び出しの場合、トークンを添付するメカニズムは、呼び出しに使用する言語とフレームワークによって異なります。HTTP 呼び出しにトークンを指定するメカニズムは、値がトークンである署名なしトークンを含む Authorization ヘッダーを含めることです。
有効期限を返します。サーバーは、トークンの有効期限（通常は秒単位）を返す必要があります。
OAuth 2.0 アクセストークンを使用するのではなく、トークンベアラーとして JSON を直接作成して署名する必要がある場合は、Identity デベロッパードキュメントの OAuth を使用しないサービスアカウントの認可の手順をご覧ください。

オンデマンドの移動の場合

JWT ペイロードを作成するときに、承認セクションに、呼び出し対象の車両 ID またはルート ID の値に設定されたキー vehicleid または tripid を含む追加のクレームを追加します。

スケジュールされたタスク

サーバーが他の API を呼び出す場合、トークンには適切なクレームも含まれている必要があります。これを行うには、次の操作を行います。
- 各キーの値を * に設定します。
- ユーザーにすべての taskids と deliveryvehicleids へのアクセス権を付与します。これを行うには、taskid キーと deliveryvehicleid キーを使用して、認可セクションに追加のクレームを追加します。
- taskids クレームでアスタリスク（*）を使用する場合は、配列内の唯一の要素にする必要があります。

オンデマンドのルートの JWT の例

このセクションでは、オンデマンド乗車を使用する場合の一般的なシナリオの JWT の例を示します。

ドライバーアプリのオペレーションのトークンの例

{
  "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"
   }
}

ユーザーアプリオペレーションのトークンの例

{
  "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"
   }
}

スケジュールされたタスクの JWT の例

このセクションでは、スケジュールされたタスクを使用する場合の一般的なシナリオの JWT の例を示します。

ドライバーアプリのトークンの例

    {
      "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"
       }
    }

ユーザーアプリのトークンの例

    {
      "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"
       }
    }

フリートオペレーションの JWT の例

このセクションでは、フリートオペレーションの一般的なシナリオの JWT の例を示します。

フリート内のすべてのタスクと車両を追跡するトークンの例

次の例は、オペレーターが使用するウェブベースのアプリからフリート内のすべてのタスクと車両を追跡するトークンです。これらのオペレーションに必要な権限は、クライアントアプリケーションに必要な権限よりも大きくなります。このトークンを使用するクライアントサイドの実装については、JavaScript フリートトラッキングライブラリを設定するをご覧ください。

Fleet Engine Delivery Fleet Reader Cloud IAM ロールを使用してトークンに署名します。

注: このロールを使用して作成されたトークンは、Fleet Engine エンティティに一部の権限を付与します。バックエンドが認証済みのユーザーとのみトークンを共有するようにしてください。

   {
      "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": "*",
       }
    }

バックエンドサーバーオペレーションの代替認証方法

バックエンドサーバーのオペレーションを認証するには、ADC を使用することをおすすめします。ADC を使用できず、JWT を使用する必要がある場合は、これらの例をご覧ください。

オンデマンドバックエンドサーバーオペレーションのトークンの例

  {
    "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": "*"
     }
  }

スケジュール設定されたバックエンドサーバーオペレーションのトークンの例

    {
      "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": "*"
       }
    }

スケジュール設定されたバックエンドサーバーのバッチ作成タスクオペレーションのトークンの例

    {
      "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": ["*"]
       }
    }

スケジュール設定されたバックエンドサーバーの配送車両ごとのオペレーション用のトークンの例

    {
      "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": "*"
       }
    }

次のステップ

設定を確認して、トライアル車両を作成し、トークンが意図したとおりに機能していることを確認します。
バックエンドサーバーオペレーションに JWT ではなく ADC を使用する方法については、セキュリティの概要をご覧ください。