JSON ウェブトークン

JSON Web Token（JWT）はオープンウェブ標準であり、認証に使用される クライアントとサーバー間の情報交換の承認などです。アプリが ユーザーがまず適切なロール認証情報でログインすると、サーバーは 後続のリクエストで使用するために、エンコードされたデジタル署名された JWT を返します。 このプロセスは、ユーザーの認証とルートへのアクセスの許可の両方を行います。 リソースに対して IAM ロールを付与します。

信頼性の低い環境からの API メソッド呼び出しの場合、Fleet Engine には 適切なサービス アカウントで署名された JSON Web Token（JWT）の使用。 信頼性の低い環境には、スマートフォンやブラウザが含まれます。JWT は、完全に信頼できる環境であるサーバー上で生成されます。JWT は署名され、暗号化され、有効期限が切れるか無効になるまで、その後のサーバーとのやり取りのためにクライアントに渡されます。1 つの サービス アカウントのロールのリストについては、Fleet Engine サービス アカウントのロールをご覧ください。 「Fleet Engine Basics」をご覧ください。

対照的に、バックエンドは Fleet Engine に対して認証と認可を行う必要がある 標準のアプリケーションのデフォルト認証情報を使用 メカニズムです。

API キーとは異なり、JWT は存続期間が短いため、オペレーションは API キーにしか そのロールに実行が許可されていることを 判断しますJWT の詳細については、JSON Web トークン」をご覧ください。アクセスロールの詳細については、このガイドのサービス アカウントのロールをご覧ください。

JWT 要素

JWT にはヘッダーとクレーム セクションがあります。header セクションには、 秘密鍵の情報（サービス アカウントから取得した秘密鍵）と 暗号化アルゴリズムで行われます。クレーム セクションには、JWT の作成時間、存続時間、JWT がアクセスを要求するサービス、アクセス範囲のその他の認可情報（配送車両 ID など）が含まれます。

次の表に、JWT フィールドの一般的な説明を示します。 それぞれの値を確認する場所についての Fleet Engine Cloud プロジェクトの Cloud Storage バケットに保存できます

JWT ヘッダー フィールド

フィールド	説明
alg	使用するアルゴリズム。`RS256`。
標準	トークンのタイプ。JWT。
子供	サービス アカウントの秘密鍵 ID。この値は サービス アカウント JSON ファイルの private_key_id フィールド。製造元 適切なレベルの権限を持つサービス アカウントのキーを使用してください。

JWT クレーム フィールド

フィールド	説明
iss	サービス アカウントのメールアドレス。 サービス アカウント JSON ファイルの client_email フィールド。
Pub/Subです	サービス アカウントのメールアドレス。 サービス アカウント JSON ファイルの client_email フィールド。
AUD	サービス アカウントの SERVICE_NAME（この場合は https://fleetengine.googleapis.com/）
iat	JWT 作成時のタイムスタンプ（秒単位で指定します） 00:00:00（UTC, January 1, 1970）から経過しています。スキューには 10 分ほどかかります。タイムスタンプが古すぎる、または未来すぎる場合は、 サーバーがエラーを報告する可能性があります。
exp	JWT が期限切れになるときのタイムスタンプ（経過時間（秒）） 00:00:00 UTC, January 1, 1970以降。次の場合、リクエストは失敗します。 タイムスタンプが 1 時間以上先になっています。
authorization	ユースケースに応じて、deliveryvehicleid、 trackingid、taskid、または taskids。 taskid を指定する場合、認可スコープは 1 つの 次の形式です。 "taskids": ["task_id_one","task_id_two"] または "taskids": ["*"]

Fleet Engine JWT クレーム

Fleet Engine はプライベート クレームを使用します。非公開クレームを使用すると、 自分のデータにアクセスできます。

たとえば、サーバーがドライバーのモバイル デバイスの JSON Web Token を発行し、 vehicleid クレームまたは そのドライバーの車両 ID の値を含む deliveryvehicleid クレーム。次に、 ドライバーのロールに応じて、JWT は特定の車両のみにアクセスを許可する その他の任意の車両 ID は使用できません。

Fleet Engine は、次のプライベート クレームを使用します。

次のステップ

• Fleet Engine のセキュリティ設計を参照して、 認証フローについて説明します。
• サーバーから JSON Web Token を発行する方法を学習する。