{"canonical_url":"https://engineer.company/ja/glossary/openid-connect/","content_markdown":"# OpenID Connect\n\n## どのようなものか\n\nOpenID Connectは、その人をログインさせたばかりのサービスから、アプリケーションがその人が誰なのかを知るための標準的な方法です。仕様は、OAuth 2.0の上の単純なID層と呼びます。実際、OAuthと同じリダイレクト、エンドポイント、トークンに、もう一つのトークンとエンドポイント、それらを検査する規則を足します。通常OIDCと略します。中核仕様は2014年2月に最終版となり、二度目の訂正を取り込んだ現在の本文は、2023年12月15日付です。OpenID Foundationの作業部会が維持しています。\n\nOAuth単体が答えるのは、「このアプリケーションに、何を許すか」という問いです。API向けのアクセストークンを渡し、アプリケーション自身は、それを読む想定ではありません。OpenID Connectは、「誰がログインしたか」を加え、アプリケーション自身を受信先とするJSON Web Token、IDトークンで答えます。誰なのか、誰がその身元を保証するのか、いつ発行し、どのアプリケーションに向けたかを示します。IDトークンには署名が必須ですが、仕様は`alg: none`を例外として許します。ただし、認可エンドポイントからIDトークンを返さない応答型であり、かつクライアントが登録時に明示的に`none`を求めた場合に限ります。\n\n仕様は、この用途に合わせてOAuthの役割を呼び替えます。OpenID Provider（OP）は、本人を認証し、IDトークンを出すOAuth認可サーバーです。Relying Party（RP）は、その人が誰かを知る必要のあるOAuthクライアントです。本人をEnd-User、エンドユーザーと呼びます。スコープに`openid`を入れると、OpenID Connectのリクエストになり、その値は必須です。「openidスコープ値がなければ、動作は完全に未規定である」と定めます。\n\nさらに、プロフィール情報を求めるスコープ値があります。`profile`は、名前、ニックネーム、画像、ロケールなどのクレームを求め、`email`は、`email`と`email_verified`を追加します。`address`と`phone`は、名前どおりの情報です。アプリケーションは、プロバイダーのUserInfoエンドポイントから、これらを取得できます。アクセストークンで呼ぶ、通常のOAuth保護APIです。\n\n動かし方は三つあります。認可コードフローは、短い有効期間のコードだけをブラウザーで運び、トークンエンドポイントへのHTTPSリクエストでトークンを取得します。インプリシットフローは、トークンを直接リダイレクトで返し、ハイブリッドフローは両方を組み合わせます。付属仕様のOpenID Connect Discovery 1.0を使うと、一つのアドレスから、すべてのエンドポイントと署名鍵を調べられます。\n\n## なぜ重要なのか\n\n採用する理由は、シングルサインオンです。多数のアプリケーションの前に一つのIDプロバイダーを置くと、本人が持つ資格情報は一組で、アプリケーションは保存しません。パスワードの規則から第二の認証要素まで、ログイン方法の方針を、プロバイダーで一度だけ定めます。プロバイダー側でアカウントを無効にすると、それに依存するどのアプリケーションでも、新しいセッションを始められません。そのため、利用終了時の処理は、作業の一覧でなく一段階で済みます。\n\n素のOAuthでログインを実装するときに、陥りがちな穴も塞ぎます。RFC 6749は、インプリシットフローでは、パブリッククライアントが、アクセストークンの発行先クライアントを判別できないと警告します。有効なトークンを渡せるのはリソース所有者だけだと考えると、なりすましが可能になります。別のアプリケーション向けのトークンを持つ攻撃者が、それを提示して、そのトークンが表す本人だと認められてしまいます。IDトークンは、`aud`クレームで発行先のアプリケーションを示し、アプリケーションが検査します。\n\n標準なので、実装を別の環境にも移せます。仕様は、相互運用できる形でプロフィール情報を提供することを約束します。一つのプロバイダーでログインするコードを、別のプロバイダーにも使えます。Discoveryがあれば、手でコピーした設定でなく、発行者URLから、エンドポイントと署名鍵を取得できます。\n\n最後に、OpenID Connectは、各人に安定した識別子を与えます。仕様は、`iss`、つまりトークンの発行者と、`sub`、つまり対象主体の識別子の組だけが、本人の安定した識別子として頼れるクレームの組だと明示します。`sub`は、その発行者の中で一意で、再割り当てされず、最大255文字のASCII文字列です。プロバイダーは、アプリケーションごとに異なる`sub`を出す、ペアワイズ識別子も使えます。許可なく、その人の活動をアプリケーション間で関連付けられないようにするためです。\n\n## 実際の活用例\n\nOpenID Providerの`https://server.example.com`に、クライアントID`s6BhdRkqt3`で登録したウェブアプリケーションを考えます。以下の値は、仕様自身の例から取っています。まず、発行者URL配下の所定のアドレスから、プロバイダーの設定を読みます。\n\n```http\nGET /.well-known/openid-configuration HTTP/1.1\nHost: server.example.com\n```\n\n応答はJSON文書です。短くしたものは、次のとおりです。\n\n```json\n{\n  \"issuer\": \"https://server.example.com\",\n  \"authorization_endpoint\": \"https://server.example.com/connect/authorize\",\n  \"token_endpoint\": \"https://server.example.com/connect/token\",\n  \"userinfo_endpoint\": \"https://server.example.com/connect/userinfo\",\n  \"jwks_uri\": \"https://server.example.com/jwks.json\",\n  \"scopes_supported\": [\"openid\", \"profile\", \"email\", \"address\", \"phone\"],\n  \"id_token_signing_alg_values_supported\": [\"RS256\", \"ES256\", \"HS256\"]\n}\n```\n\nDiscoveryは、その文書の`issuer`が、アプリケーションが所定のパスの前に置いた発行者URLと、完全に一致することを求めます。違えば、処理を止めます。続いて、認可コードフローと`openid`スコープ、それにブラウザーセッションに結び付けて保存した二つの乱数値で、本人のブラウザーを認可エンドポイントへ送ります。リダイレクト用の`state`と、IDトークン用の`nonce`です。パブリッククライアントでは、RFC 9700が必須とするPKCEパラメーターも付けますが、ここでは行を短くするため省きます。\n\n```http\nGET /connect/authorize?response_type=code\u0026client_id=s6BhdRkqt3\n    \u0026redirect_uri=https%3A%2F%2Fclient.example.org%2Fcb\n    \u0026scope=openid%20profile%20email\n    \u0026state=af0ifjsldkj\u0026nonce=n-0S6_WzA2Mj HTTP/1.1\nHost: server.example.com\n```\n\nプロバイダーは、本人をログインさせ、コードを付けてブラウザーを戻します。アプリケーションは、通常のOAuthと同じように、トークンエンドポイントでコードをトークンに引き換えます。違いは応答にあり、アクセストークンに加え、`id_token`を含みます。ここでは短くしています。\n\n```json\n{\n  \"access_token\": \"SlAV32hkKG\",\n  \"token_type\": \"Bearer\",\n  \"refresh_token\": \"8xLOxBtZp8\",\n  \"expires_in\": 3600,\n  \"id_token\": \"eyJhbGciOiJSUzI1NiIsImtpZCI6IjFlOWdkazcifQ.ewogImlzc...\"\n}\n```\n\nIDトークンは、ドットで区切った三つのbase64url部分からなります。最初をデコードすると、`{\"alg\":\"RS256\",\"kid\":\"1e9gdk7\"}`となり、署名アルゴリズムと、プロバイダーが公開する鍵集合内の鍵IDを示します。中央の部分にクレームがあり、仕様の例は次のとおりです。\n\n```json\n{\n  \"iss\": \"https://server.example.com\",\n  \"sub\": \"24400320\",\n  \"aud\": \"s6BhdRkqt3\",\n  \"nonce\": \"n-0S6_WzA2Mj\",\n  \"exp\": 1311281970,\n  \"iat\": 1311280970,\n  \"auth_time\": 1311280969,\n  \"acr\": \"urn:mace:incommon:iap:silver\"\n}\n```\n\n内容を一言でも信じる前に、アプリケーションはトークンを検証します。仕様は手順を列挙しています。`iss`は、プロバイダーの発行者と完全一致しなければなりません。`aud`は、自分のクライアントIDを含み、信頼しない受信対象を含んではいけません。署名は、ヘッダーのアルゴリズムを使い、`jwks_uri`から得たプロバイダーの鍵で検証できなければなりません。ただし、この例のように、TLSでトークンエンドポイントから直接受け取った場合は、サーバーのTLS証明書の検査を、署名検証の代わりに使えます。現在時刻は`exp`より前で、`nonce`は送った値と同じでなければなりません。そこで初めて、`https://server.example.com`と`24400320`を組み合わせたキーで、本人をログインさせます。必要なら、アクセストークンでUserInfoエンドポイントからメールとプロフィールのクレームを取得します。\n\n多数のシステムで一つのプロバイダーを使うのは、技術だけでなく、組織の変更でもあります。このサイトの[M365とSSOにまたがるアクセス管理](/ja/portfolio/led-access-management-across-m365-and-sso/)では、M365、1Password、Red Hat SSO、OKTA SSOのIDとアクセスを統合し、最小権限を強制しました。参加時と利用終了時の処理も標準化し、組織を離れた人のアクセスを速やかに取り消せるようにしました。\n\n## 問題が起きるところ\n\n**メールアドレスを、アカウントのキーにします。** 分かりやすい選択ですが、間違いです。仕様は、プロバイダーが時を経て同じメールアドレスを別人に再利用する可能性があり、`email`、`phone_number`、`preferred_username`、`name`を、一意の識別子にしてはならないとします。メールで本人を探すアプリケーションは、そのアドレスの次の所有者に、以前の人のアカウントを渡しかねません。`iss`と`sub`の組をキーにし、メールは属性として保存します。アドレスを何に使う場合も、先に`email_verified`がtrueか確かめます。\n\n**アクセストークンで、誰がログインしたかを証明しようとします。** アクセストークンを受け取り、それでAPIを呼んだ応答を、ログインと見なすアプリケーションがあります。全く別のアプリケーションに発行したトークンかもしれず、RFC 6749が警告するなりすましになります。IDトークンに基づいてログインさせ、必ず先に、その`aud`が自分のクライアントIDを指すか確かめます。\n\n**IDトークンをデコードしても、検証しません。** クレームを読むだけなら、base64urlでデコードするだけで、鍵は不要です。その手軽さが落とし穴です。署名、`iss`、`aud`、`exp`を検査しないトークンは、偽造されていたり、別のアプリケーション向けだったり、期限切れだったりします。保守されているライブラリーに、発行者とクライアントIDを渡し、都合の良い検査だけを選ばず、仕様の一覧のすべてを実行させます。\n\n**nonceがないか、固定されているか、比較されません。** これがなければ、あるログインで取得されたIDトークンを、別のログインに再利用できてしまいます。RFC 9700は、nonceを一回のログイン専用にし、それを始めたブラウザーに結び付けることも求めます。仕様が示す一例は、暗号学的な乱数値をHttpOnlyのセッションクッキーに保ち、そのハッシュを`nonce`として送り、IDトークンが戻ったら両者を照合する方法です。\n\n**署名鍵を、いつまでもキャッシュします。** プロバイダーは鍵を更新するため、昨日の鍵集合だけを持つアプリケーションは、新しい鍵で署名したすべてのトークンを拒否します。仕様は、プロバイダーが`jwks_uri`で鍵を公開し、各トークンに`kid`を付け、アプリケーションは、知らない`kid`に出会えば鍵集合を取得し直すことを想定します。鍵はキャッシュしても、未知の`kid`はログインを拒否する理由でなく、再取得の合図にします。\n\n**同じホストの二つのテナントを、一つの発行者として扱います。** プロバイダーは、一つのホストで複数の発行者を動かせます。パスも、発行者識別子の一部です。対象主体`1234`が`https://example.com`にある場合と、対象主体`1234`が`https://example.com/sales`にある場合は、別人です。発行者の文字列全体を保存し、完全一致で比べ、ホスト名だけに切り詰めてはいけません。\n\n## 参考資料\n\n- [OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html) — 2023年12月の第2弾の訂正を取り込んだ版にある、IDトークン、三つのフロー、標準クレーム、検証手順です。\n- [OpenID Connect Discovery 1.0](https://openid.net/specs/openid-connect-discovery-1_0.html) — 所定の場所の設定文書と、取得元の発行者URLに文書の発行者が一致しなければならないという規則です。\n- [RFC 6749：OAuth 2.0認可フレームワーク](https://www.rfc-editor.org/rfc/rfc6749) — OpenID Connectの基になる枠組みで、第10.16節は、アクセストークンで本人を識別する危険を警告します。\n- [RFC 7519：JSON Web Token（JWT）](https://www.rfc-editor.org/rfc/rfc7519) — すべてのIDトークンが使う形式です。\n- [RFC 9700：OAuth 2.0の現在の最良セキュリティー実務](https://www.rfc-editor.org/rfc/rfc9700) — OAuthと同じくOpenID Connectにも適用する、PKCE、nonce、リダイレクトの現在の指針です。\n\n\u003chttps://engineer.company/ja/glossary/openid-connect/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"OpenID Connectは、OAuthにログイン用のID層を加えます。IDトークンのクレーム、DiscoveryからIDトークンの検証までの手順、署名の例外、受信対象やnonceを取り違える六つの失敗例を説明します。","formats":{"gemtext":"https://engineer.company/ja/glossary/openid-connect/index.gmi","gopher":"https://engineer.company/ja/glossary/openid-connect/gophermap","html":"https://engineer.company/ja/glossary/openid-connect/","json":"https://engineer.company/ja/glossary/openid-connect/index.json","markdown":"https://engineer.company/ja/glossary/openid-connect/index.md","pdf":"https://engineer.company/ja/glossary/openid-connect/index.pdf"},"kind":"page","language":"ja","title":"OpenID Connectとは？","url":"https://engineer.company/ja/glossary/openid-connect/","version":1}