システム・プロトコル図鑑 · 基礎から応用へ

OpenID Connect:ID Tokenを検証して本人情報を受け取る

ID Tokenとアクセストークンの宛先を分け、issuer・audience・nonceなどの確認を具体的に追います。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. OAuthに本人情報の契約を加える
  2. 誰向けに発行されたのか
  3. 要求への結び付けと利用者のキー
  4. ログイン成功の後にも認可は残る
  5. この記事をロゲイアに質問する理解を確かめる

OAuthに本人情報の契約を加える

OpenID ConnectはOAuth 2.0の上に、利用者の認証結果や属性をクライアントへ伝える契約を加えます。中心となるID Tokenは、認可サーバーが行った認証に基づく情報を表します。APIへアクセスするためのアクセストークンと、クライアントが本人情報を確かめるためのID Tokenは役割が違います。ID TokenはJWTです。アクセストークンもJWT形式の場合がありますが、同じ受信者・同じ検証規則でよいとは限りません。ログイン後のアプリ内セッションも、トークンそのものとは別に管理します。

誰向けに発行されたのか

例えばクライアントA向けに発行されたID Tokenを、クライアントBが受け取ってログイン成功にしてはいけません。署名が正しいだけでなく、issuerが期待した発行者か、audienceが自分のクライアントを含むか、期限が有効かを検証します。アルゴリズムや鍵の選択も、受信した値を無条件に信じず、設定された方針と発行者の正しい情報に基づかせます。複数audienceなど追加条件がある場合は、authorized partyなど必要な項目も仕様に沿って確認します。

要求への結び付けと利用者のキー

認証要求でnonceを送った場合は、返されたID Tokenのnonceが対応することを確認します。古い応答や別のフローの結果を受け入れないために、要求時の状態との対応が必要です。利用者の識別には、発行者とその発行者内のsubjectの組を使う考え方が重要です。メールアドレスだけでは変更や再割当などの条件があり、すべての発行者をまたぐ不変の識別子と断定できません。表示用の属性、照合用の識別子、権限判断に使う情報を分けて管理します。

ログイン成功の後にも認可は残る

ID Tokenを検証できても、その利用者が特定の管理画面や他人のデータへアクセスしてよいとは限りません。アプリケーションの認可は各操作で別途確認します。ID Tokenを目的の違うAPIへアクセストークンの代わりに送ることも避けます。セッションの終了、トークンの期限、アカウント状態の変化をどう反映するかは、採用する機能と運用の範囲を決める必要があります。短い実装例で署名確認だけを行い「OIDC対応済み」とするのではなく、使用するフローの検証項目全体を確認します。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

サーバーの中で起きていること · STEP 19

学習コースから次を選ぶ