OpenID Connect

どのようなものか

OpenID
Connectは、その人をログインさせたばかりのサービスから、アプリケー
ションがその人が誰なのかを知るための標準的な方法です。仕様は、OAuth
2.0の上の単純なID層と呼びます。実際、OAuthと同じリダイレクト、エンド
ポイント、トークンに、もう一つのトークンとエンドポイント、それらを検
査する規則を足します。通常OIDCと略します。中核仕様は2014年2月に最終
版となり、二度目の訂正を取り込んだ現在の本文は、2023年12月15日付で
す。OpenID
Foundationの作業部会が維持しています。

OAuth単体が答えるのは、「このアプリケーションに、何を許すか」という
問いです。API向けのアクセストークンを渡し、アプリケーション自身は、
それを読む想定ではありません。OpenID
Connectは、「誰がログインしたか」を加え、アプリケーション自身を受信
先とするJSON Web
Token、IDトークンで答えます。誰なのか、誰がその身元を保証するのか、
いつ発行し、どのアプリケーションに向けたかを示します。IDトークンには
署名が必須ですが、仕様は`alg:
none`を例外として許します。ただし、認可エンドポイントからIDトークン
を返さない応答型であり、かつクライアントが登録時に明示的に`none`を求
めた場合に限ります。

仕様は、この用途に合わせてOAuthの役割を呼び替えます。OpenID
Provider（OP）は、本人を認証し、IDトークンを出すOAuth認可サーバーで
す。Relying
Party（RP）は、その人が誰かを知る必要のあるOAuthクライアントです。本
人をEnd-User、エンドユーザーと呼びます。スコープに`openid`を入れる
と、OpenID
Connectのリクエストになり、その値は必須です。「openidスコープ値がな
ければ、動作は完全に未規定である」と定めます。

さらに、プロフィール情報を求めるスコープ値があります。`profile`は、
名前、ニックネーム、画像、ロケールなどのクレームを求め、`email`は、
`email`と`email_verified`を追加します。`address`と`phone`は、名前ど
おりの情報です。アプリケーションは、プロバイダーのUserInfoエンドポイ
ントから、これらを取得できます。アクセストークンで呼ぶ、通常のOAuth
保護APIです。

動かし方は三つあります。認可コードフローは、短い有効期間のコードだけ
をブラウザーで運び、トークンエンドポイントへのHTTPSリクエストでトー
クンを取得します。インプリシットフローは、トークンを直接リダイレクト
で返し、ハイブリッドフローは両方を組み合わせます。付属仕様のOpenID
Connect Discovery 1.0を使うと、一つのアドレスから、すべてのエンドポ
イントと署名鍵を調べられます。

なぜ重要なのか

採用する理由は、シングルサインオンです。多数のアプリケーションの前に
一つのIDプロバイダーを置くと、本人が持つ資格情報は一組で、アプリケー
ションは保存しません。パスワードの規則から第二の認証要素まで、ログイ
ン方法の方針を、プロバイダーで一度だけ定めます。プロバイダー側でアカ
ウントを無効にすると、それに依存するどのアプリケーションでも、新しい
セッションを始められません。そのため、利用終了時の処理は、作業の一覧
でなく一段階で済みます。

素のOAuthでログインを実装するときに、陥りがちな穴も塞ぎます。RFC
6749は、インプリシットフローでは、パブリッククライアントが、アクセス
トークンの発行先クライアントを判別できないと警告します。有効なトーク
ンを渡せるのはリソース所有者だけだと考えると、なりすましが可能になり
ます。別のアプリケーション向けのトークンを持つ攻撃者が、それを提示し
て、そのトークンが表す本人だと認められてしまいます。IDトークンは、
`aud`クレームで発行先のアプリケーションを示し、アプリケーションが検
査します。

標準なので、実装を別の環境にも移せます。仕様は、相互運用できる形でプ
ロフィール情報を提供することを約束します。一つのプロバイダーでログイ
ンするコードを、別のプロバイダーにも使えます。Discoveryがあれば、手
でコピーした設定でなく、発行者URLから、エンドポイントと署名鍵を取得
できます。

最後に、OpenID
Connectは、各人に安定した識別子を与えます。仕様は、`iss`、つまりトー
クンの発行者と、`sub`、つまり対象主体の識別子の組だけが、本人の安定
した識別子として頼れるクレームの組だと明示します。`sub`は、その発行
者の中で一意で、再割り当てされず、最大255文字のASCII文字列です。プロ
バイダーは、アプリケーションごとに異なる`sub`を出す、ペアワイズ識別
子も使えます。許可なく、その人の活動をアプリケーション間で関連付けら
れないようにするためです。

実際の活用例

OpenID
Providerの`https://server.example.com`に、クライアントID`s6BhdRkqt3`
で登録したウェブアプリケーションを考えます。以下の値は、仕様自身の例
から取っています。まず、発行者URL配下の所定のアドレスから、プロバイ
ダーの設定を読みます。

```http
GET /.well-known/openid-configuration HTTP/1.1
Host: server.example.com
```

応答はJSON文書です。短くしたものは、次のとおりです。

```json
{
  "issuer": "https://server.example.com",
  "authorization_endpoint": "https://server.example.com/connect/authorize",
  "token_endpoint": "https://server.example.com/connect/token",
  "userinfo_endpoint": "https://server.example.com/connect/userinfo",
  "jwks_uri": "https://server.example.com/jwks.json",
  "scopes_supported": ["openid", "profile", "email", "address", "phone"],
  "id_token_signing_alg_values_supported": ["RS256", "ES256", "HS256"]
}
```

Discoveryは、その文書の`issuer`が、アプリケーションが所定のパスの前
に置いた発行者URLと、完全に一致することを求めます。違えば、処理を止
めます。続いて、認可コードフローと`openid`スコープ、それにブラウザー
セッションに結び付けて保存した二つの乱数値で、本人のブラウザーを認可
エンドポイントへ送ります。リダイレクト用の`state`と、IDトークン用の
`nonce`です。パブリッククライアントでは、RFC
9700が必須とするPKCEパラメーターも付けますが、ここでは行を短くするた
め省きます。

```http
GET /connect/authorize?response_type=code&client_id=s6BhdRkqt3
    &redirect_uri=https%3A%2F%2Fclient.example.org%2Fcb
    &scope=openid%20profile%20email
    &state=af0ifjsldkj&nonce=n-0S6_WzA2Mj HTTP/1.1
Host: server.example.com
```

プロバイダーは、本人をログインさせ、コードを付けてブラウザーを戻しま
す。アプリケーションは、通常のOAuthと同じように、トークンエンドポイ
ントでコードをトークンに引き換えます。違いは応答にあり、アクセストー
クンに加え、`id_token`を含みます。ここでは短くしています。

```json
{
  "access_token": "SlAV32hkKG",
  "token_type": "Bearer",
  "refresh_token": "8xLOxBtZp8",
  "expires_in": 3600,
  "id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjFlOWdkazcifQ.ewogImlzc..."
}
```

IDトークンは、ドットで区切った三つのbase64url部分からなります。最初
をデコードすると、`{"alg":"RS256","kid":"1e9gdk7"}`となり、署名アル
ゴリズムと、プロバイダーが公開する鍵集合内の鍵IDを示します。中央の部
分にクレームがあり、仕様の例は次のとおりです。

```json
{
  "iss": "https://server.example.com",
  "sub": "24400320",
  "aud": "s6BhdRkqt3",
  "nonce": "n-0S6_WzA2Mj",
  "exp": 1311281970,
  "iat": 1311280970,
  "auth_time": 1311280969,
  "acr": "urn:mace:incommon:iap:silver"
}
```

内容を一言でも信じる前に、アプリケーションはトークンを検証します。仕
様は手順を列挙しています。`iss`は、プロバイダーの発行者と完全一致し
なければなりません。`aud`は、自分のクライアントIDを含み、信頼しない
受信対象を含んではいけません。署名は、ヘッダーのアルゴリズムを使い、
`jwks_uri`から得たプロバイダーの鍵で検証できなければなりません。ただ
し、この例のように、TLSでトークンエンドポイントから直接受け取った場
合は、サーバーのTLS証明書の検査を、署名検証の代わりに使えます。現在
時刻は`exp`より前で、`nonce`は送った値と同じでなければなりません。そ
こで初めて、`https://server.example.com`と`24400320`を組み合わせた
キーで、本人をログインさせます。必要なら、アクセストークンでUserInfo
エンドポイントからメールとプロフィールのクレームを取得します。

多数のシステムで一つのプロバイダーを使うのは、技術だけでなく、組織の
変更でもあります。このサイトのM365とSSOにまたがるアクセス管理では、
M365、1Password、Red
Hat SSO、OKTA
SSOのIDとアクセスを統合し、最小権限を強制しました。参加時と利用終了
時の処理も標準化し、組織を離れた人のアクセスを速やかに取り消せるよう
にしました。

問題が起きるところ

メールアドレスを、アカウントのキーにします。
分かりやすい選択ですが、間違いです。仕様は、プロバイダーが時を経て同
じメールアドレスを別人に再利用する可能性があり、`email`、
`phone_number`、`preferred_username`、`name`を、一意の識別子にしては
ならないとします。メールで本人を探すアプリケーションは、そのアドレス
の次の所有者に、以前の人のアカウントを渡しかねません。`iss`と`sub`の
組をキーにし、メールは属性として保存します。アドレスを何に使う場合
も、先に`email_verified`がtrueか確かめます。

アクセストークンで、誰がログインしたかを証明しようとします。
アクセストークンを受け取り、それでAPIを呼んだ応答を、ログインと見な
すアプリケーションがあります。全く別のアプリケーションに発行したトー
クンかもしれず、RFC
6749が警告するなりすましになります。IDトークンに基づいてログインさ
せ、必ず先に、その`aud`が自分のクライアントIDを指すか確かめます。

IDトークンをデコードしても、検証しません。
クレームを読むだけなら、base64urlでデコードするだけで、鍵は不要で
す。その手軽さが落とし穴です。署名、`iss`、`aud`、`exp`を検査しない
トークンは、偽造されていたり、別のアプリケーション向けだったり、期限
切れだったりします。保守されているライブラリーに、発行者とクライアン
トIDを渡し、都合の良い検査だけを選ばず、仕様の一覧のすべてを実行させ
ます。

nonceがないか、固定されているか、比較されません。
これがなければ、あるログインで取得されたIDトークンを、別のログインに
再利用できてしまいます。RFC
9700は、nonceを一回のログイン専用にし、それを始めたブラウザーに結び
付けることも求めます。仕様が示す一例は、暗号学的な乱数値をHttpOnlyの
セッションクッキーに保ち、そのハッシュを`nonce`として送り、IDトーク
ンが戻ったら両者を照合する方法です。

署名鍵を、いつまでもキャッシュします。
プロバイダーは鍵を更新するため、昨日の鍵集合だけを持つアプリケーショ
ンは、新しい鍵で署名したすべてのトークンを拒否します。仕様は、プロバ
イダーが`jwks_uri`で鍵を公開し、各トークンに`kid`を付け、アプリケー
ションは、知らない`kid`に出会えば鍵集合を取得し直すことを想定しま
す。鍵はキャッシュしても、未知の`kid`はログインを拒否する理由でな
く、再取得の合図にします。

同じホストの二つのテナントを、一つの発行者として扱います。
プロバイダーは、一つのホストで複数の発行者を動かせます。パスも、発行
者識別子の一部です。対象主体`1234`が`https://example.com`にある場合
と、対象主体`1234`が`https://example.com/sales`にある場合は、別人で
す。発行者の文字列全体を保存し、完全一致で比べ、ホスト名だけに切り詰
めてはいけません。

参考資料

  * OpenID Connect Core 1.0 —
2023年12月の第2弾の訂正を取り込んだ版にある、IDトークン、三つのフ
ロー、標準クレーム、検証手順です。

  * OpenID Connect Discovery 1.0 —
所定の場所の設定文書と、取得元の発行者URLに文書の発行者が一致しなけ
ればならないという規則です。

  * RFC 6749：OAuth 2.0認可フレームワーク — OpenID
Connectの基になる枠組みで、第10.16節は、アクセストークンで本人を識別
する危険を警告します。

  * RFC 7519：JSON Web Token（JWT） — すべてのIDトークンが使う形式で
す。

  * RFC 9700：OAuth 2.0の現在の最良セキュリティー実務 — OAuthと同じ
くOpenID
Connectにも適用する、PKCE、nonce、リダイレクトの現在の指針です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/openid-connect/	engineer.company	70
