<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<p>前回はOAuthについてまとめましたが、今回はOpenID Connectについてまとめてみたいと思います。</p>
<p>間違っているところがあればご指摘ください。</p>
<h1 id="openid-connect%E3%81%A8%E3%81%AF">
<a class="header-anchor-link" href="#openid-connect%E3%81%A8%E3%81%AF" aria-hidden="true"></a> OpenID Connectとは</h1>
<blockquote>
<p>OpenID Connect は OAuth 2.0 認可プロセスを拡張し, 認証目的で利用できるようにする. 本拡張を利用する場合, Client は openid<br>
 scope を指定して Authorization Request を送信する. 認証結果は ID Token (<strong><a href="http://openid-foundation-japan.github.io/openid-connect-core-1_0.ja.html#IDToken" target="_blank" rel="nofollow noopener noreferrer">Section 2</a></strong><br>
 参照) と呼ばれる <strong><a href="http://openid-foundation-japan.github.io/openid-connect-core-1_0.ja.html#JWT" target="_blank" rel="nofollow noopener noreferrer">JSON Web Token (JWT)</a></strong><br>
 [JWT] として返される. OpenID Connect をサポートする OAuth 2.0 Authentication Server は, OpenID Provider (OP) とも呼ばれる. OpenID Connect を利用する OAuth 2.0 Client は Relying Party (RP) とも呼ばれる.<br>
(OpenID Connect Core 1.0 incorporating errata set 1より引用）</p>
</blockquote>
<p>つまり、OAuthの仕様を拡張し、アクセストークンに加えてIDトークンを発行することで、認証を行うことを可能にするためのものということができるかと思います。</p>
<p>OAuthはあくまで認可のための権限の移譲プロセスを定めた仕様であるため、本来、認証は仕様の範囲外です。しかしOAuthの「ユーザーIDとパスワードの管理を外部に任せられる」「ユーザー登録作業を簡略化できる」という利点から、OAuthによる認証というものが広まりました。</p>
<p>しかしながらOAuth認証は後述する問題点を孕んでいるため、OAuthの利点を享受しながら問題点を解消するための仕組みとして、OpenID Connectという仕様がOAuthの上に乗せる形で策定されたという経緯があります。</p>
<h1 id="oauth%E3%81%AB%E3%82%88%E3%82%8B%E8%AA%8D%E8%A8%BC%E3%81%AE%E5%95%8F%E9%A1%8C%E7%82%B9">
<a class="header-anchor-link" href="#oauth%E3%81%AB%E3%82%88%E3%82%8B%E8%AA%8D%E8%A8%BC%E3%81%AE%E5%95%8F%E9%A1%8C%E7%82%B9" aria-hidden="true"></a> OAuthによる認証の問題点</h1>
<p>まずOAuth認証とは何かというと、ユーザー情報（emailやuser_idなど）を対象リソースとしたOAuthによる認可プロセスを利用して取得したユーザー情報をもって認証を実行することです。</p>
<p>以下はインプリシットグラントタイプのOAuthのシーケンス図ですが、最後にリソースサーバーから返されるのがユーザー情報であれば、クライアントはこのユーザー情報をもって認証処理を実行することができます。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/5bbe3d26938b-20230104.png" alt loading="lazy" class="md-img"></p>
<p>これの何が問題なのでしょうか。</p>
<p>アクセストークンにはクライアントを確認するための仕組みがありません。つまり誰宛に発行したアクセストークンなのかに関わらず、リソースサーバーはリソースを返してしまうということです。このため、クライアントが悪意あるクライアントであった場合、上記のフローで取得した他人のアクセストークンを使って、OAuth認証を採用している任意のサイトになりすましログインが可能となってしまいます。</p>
<p>OpenID ConnectではIDトークンというものを用いてこの問題に対処しています。次はIDトークンとは何かについてみていきましょう。</p>
<h1 id="id%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%81%A8%E3%81%AF">
<a class="header-anchor-link" href="#id%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%81%A8%E3%81%AF" aria-hidden="true"></a> IDトークンとは</h1>
<p>以下の情報および署名を含むトークン。JWT（JSON Web Tokenの略。詳細の説明は割愛）という形式でIDプロバイダ（OpenID Connectの登場人物の項を3章）から発行される。</p>
<h3 id="id%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%81%AB%E5%90%AB%E3%81%BE%E3%82%8C%E3%82%8B%E6%83%85%E5%A0%B1%EF%BC%88%E4%BB%A3%E8%A1%A8%E7%9A%84%E3%81%AA%E3%82%82%E3%81%AE%E3%81%AE%E3%81%BF%E6%8E%B2%E8%BC%89%E3%80%82%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%8A%E3%83%AB%E3%81%AA%E6%83%85%E5%A0%B1%E3%81%8C%E3%81%93%E3%82%8C%E3%82%89%E4%BB%A5%E5%A4%96%E3%81%AB%E4%BB%98%E4%B8%8E%E3%81%95%E3%82%8C%E3%82%8B%E3%81%93%E3%81%A8%E3%82%82%E3%81%82%E3%82%8B%EF%BC%89">
<a class="header-anchor-link" href="#id%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%81%AB%E5%90%AB%E3%81%BE%E3%82%8C%E3%82%8B%E6%83%85%E5%A0%B1%EF%BC%88%E4%BB%A3%E8%A1%A8%E7%9A%84%E3%81%AA%E3%82%82%E3%81%AE%E3%81%AE%E3%81%BF%E6%8E%B2%E8%BC%89%E3%80%82%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%8A%E3%83%AB%E3%81%AA%E6%83%85%E5%A0%B1%E3%81%8C%E3%81%93%E3%82%8C%E3%82%89%E4%BB%A5%E5%A4%96%E3%81%AB%E4%BB%98%E4%B8%8E%E3%81%95%E3%82%8C%E3%82%8B%E3%81%93%E3%81%A8%E3%82%82%E3%81%82%E3%82%8B%EF%BC%89" aria-hidden="true"></a> IDトークンに含まれる情報（代表的なもののみ掲載。オプショナルな情報がこれら以外に付与されることもある）</h3>
<ul>
<li>iss<br>
Issuerの略。IDトークンの発行者</li>
<li>aud<br>
Audienceの略。IDトークンの発行を受けるクライアントIDが入る</li>
<li>sub<br>
Subjectの略。エンドユーザーの識別子。これを持ってエンドユーザーを識別できる</li>
<li>iat<br>
Issued Atの略。JWTの発行時間を表す。</li>
<li>exp<br>
Expiration timeの略。トークンの有効期限</li>
<li>nonce<br>
リプレイアタック防止のためのランダムな文字列</li>
</ul>
<p>IDトークンには、ユーザー識別子、IDトークンの発行元、発行先などの情報が含まれるため、これらの情報が改竄されていないことを確認するために署名が含まれています。</p>
<p>OAuth認証と比べて、IDトークンの仕組みによって、ユーザー識別子、IDトークンの発行元、発行先などの情報が含まれているため、これらを適切に検証することでユーザーのなりすましを防ぐことができます。</p>
<h1 id="openid-connect%E3%81%AE%E7%99%BB%E5%A0%B4%E4%BA%BA%E7%89%A9">
<a class="header-anchor-link" href="#openid-connect%E3%81%AE%E7%99%BB%E5%A0%B4%E4%BA%BA%E7%89%A9" aria-hidden="true"></a> OpenID Connectの登場人物</h1>
<p>OpenID ConnectはOAuthの拡張仕様ですが、OAuthと登場人物の呼び方が異なります。</p>
<p>以下が対応表となります。</p>
<table>
<thead>
<tr>
<th>OAuth</th>
<th>OpenID Connect</th>
</tr>
</thead>
<tbody>
<tr>
<td>リソースオーナー</td>
<td>エンドユーザー</td>
</tr>
<tr>
<td>クライアント</td>
<td>リライングパーティ</td>
</tr>
<tr>
<td>認可サーバー</td>
<td>IDプロバイダ</td>
</tr>
<tr>
<td>リソースサーバー</td>
<td>UserInfoエンドポイント</td>
</tr>
</tbody>
</table>
<h1 id="openid-connect%E3%81%AE%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E7%A8%AE%E9%A1%9E">
<a class="header-anchor-link" href="#openid-connect%E3%81%AE%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E7%A8%AE%E9%A1%9E" aria-hidden="true"></a> OpenID Connectのフローの種類</h1>
<ul>
<li>認可コードフロー<br>
OAuthの認可コードグラントタイプに対応するフロー。コンフィデンシャルなリライングパーティにおいて適応されるフロー</li>
<li>インプリシットフロー<br>
パブリッククライアント向けのフロー</li>
<li>ハイブリッドフロー<br>
ネイティブアプリにバックエンドサーバーがある場合など、パブリッククライアントとコンフィデンシャルクライアントの両方で構成されるリライングパーティにおいて適応されるフロー</li>
</ul>
<h1 id="%E3%82%B7%E3%83%BC%E3%82%B1%E3%83%B3%E3%82%B9%E5%9B%B3">
<a class="header-anchor-link" href="#%E3%82%B7%E3%83%BC%E3%82%B1%E3%83%B3%E3%82%B9%E5%9B%B3" aria-hidden="true"></a> シーケンス図</h1>
<p>一番重要な認可コードフローのみ掲載します（以下の参考書籍に掲載されているものをdiagrams.netで写経してみたものになります。OAuthの記事でも書きましたが、この著者の方の本はどれも超勉強になるのでぜひ読んでみてください）</p>
<p><a href="https://authya.booth.pm/items/1550861" target="_blank" rel="nofollow noopener noreferrer">OAuth、OAuth認証、OpenID Connectの違いを整理して理解できる本 - Auth屋 - BOOTH</a></p>
<p>シーケンス図は以下の通りです。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/895f82e5f695-20230104.png" alt loading="lazy" class="md-img"></p>
<p>OAuthの認可グラントタイプのシーケンス図とほぼ同じですが、トークンリクエストのレスポンスにIDトークンが含まれており、IDトークンの検証のプロセスが存在するのが大きな違いとなっています。</p>
<h1 id="%E3%81%BE%E3%81%A8%E3%82%81">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h1>
<p>OpenID Connectの仕様は奥が深く、全然表面の部分しか書けていないですが、さらに勉強を進めてまたの機会に深掘りした記事を書いていきたいと思います。</p>
<p>次回はセキュリティ的に重要な仕組みだが混乱しがちな、state, PKCE, nonce, c_hash, at_hashの違いについてまとめていきたいと思います。</p>
<h1 id="%E5%8F%82%E8%80%83">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83" aria-hidden="true"></a> 参考</h1>
<p><a href="http://openid-foundation-japan.github.io/openid-connect-core-1_0.ja.html" target="_blank" rel="nofollow noopener noreferrer">OpenID Connect Core 1.0 incorporating errata set 1</a></p>
<p><a href="https://qiita.com/TakahikoKawasaki/items/f2a0d25a4f05790b3baa" target="_blank" rel="nofollow noopener noreferrer">OAuth 2.0 + OpenID Connect のフルスクラッチ実装者が知見を語る - Qiita</a></p>
<p><a href="https://qiita.com/TakahikoKawasaki/items/8f0e422c7edd2d220e06" target="_blank" rel="nofollow noopener noreferrer">IDトークンが分かれば OpenID Connect が分かる - Qiita</a></p>
<p><a href="https://www.sakimura.org/2012/02/1487/" target="_blank" rel="nofollow noopener noreferrer">単なる OAuth 2.0 を認証に使うと、車が通れるほどのどでかいセキュリティー・ホールができる</a></p>
<p><a href="https://authya.booth.pm/items/1550861" target="_blank" rel="nofollow noopener noreferrer">OAuth、OAuth認証、OpenID Connectの違いを整理して理解できる本 - Auth屋 - BOOTH</a></p>


OpenID Connectについて勉強したのでまとめる

IDトークンに含まれる情報（代表的なもののみ掲載。オプショナルな情報がこれら以外に付与されることもある）

Discussion