OAuthのPKCEを図で整理する
目次
はじめに
前回の記事では、写真プリントサービスがInstagramの写真を取り込む例で、OAuthの認可コードフローを整理しました。そこで前提にしていたのは、クライアントシークレットを安全に保管できるWebアプリ(コンフィデンシャルクライアント)です。
ところが、同じ写真プリントサービスがスマホアプリを出すと、話が変わります。スマホアプリはシークレットを安全に持てないので、前回のフローのままでは、認可コードを横取りされたときに防げません。
そこで使われるのがPKCE(Proof Key for Code Exchange、「ピクシー」と読みます)です。今回は、スマホアプリで何が困るのか、PKCEがそれをどう防ぐのかを、前回と同じ例とシーケンス図で整理します。あわせて、前回のstateとの違いや、Webアプリでも使われる理由にも触れます。
スマホアプリで困ること
シークレットを隠せない
前回のフローでは、認可コードをアクセストークンと交換するときに、クライアントシークレットを送って「正規のクライアントからのリクエストである」ことを証明していました。Webアプリなら、シークレットをクライアント(写真プリントサービス)自身のサーバーに置けます。認可サーバー(Instagram)に預けるのではなく、クライアントの事業者が管理するサーバーなので、利用者からは見えません。
スマホアプリは事情が違います。アプリ本体は利用者のスマホにダウンロードされて動くため、シークレットを埋め込んでも、アプリを解析すれば取り出せてしまいます。前回の分類でいう、パブリッククライアントです。
シークレットが使えないと、認可サーバーには、トークンを求めてきた相手が本当に正規のアプリなのかを確かめる手段がありません。認可コードさえ持っていれば、誰でもトークンと交換できてしまいます。
認可コードの横取り
スマホアプリでは、認可サーバーからのリダイレクト先(redirect_uri)に、com.example.print:/callbackのようなアプリ専用のURL(カスタムURLスキーム)を使うことがあります。ブラウザがこのURLを開くと、OSはそのスキームを登録しているアプリを起動して、URLを渡します。
ところが、同じスキームは別のアプリも登録できてしまいます。悪意のあるアプリが同じスマホに入っていると、次の手順で認可コードを横取りされ、そのままアクセストークンまで取られてしまいます。赤い矢印が、攻撃にあたるステップです。
リダイレクトで届いた認可コードを、正規のアプリと悪意のあるアプリのどちらに渡すかは、OSの振り分け次第です(4,5)。悪意のあるアプリは、受け取ったコードでそのままトークンを求めます(6)。シークレットを使わないので、認可サーバーは正規のアプリと区別できず、アクセストークンを渡してしまいます(7)。
このように、認可コードを悪意のあるアプリに横取りされる攻撃を、認可コード横取り攻撃(authorization code interception attack)と呼びます。PKCEは、この攻撃を防ぐために作られた仕組みです。
PKCEの仕組み
使い捨ての合言葉
PKCEの考え方は、「認可リクエストのたびに、使い捨ての合言葉をその場で作る」というものです。前もってアプリに埋め込んでおくシークレットと違い、毎回作って使い終わったら捨てるので、アプリを解析されても取り出せません。
合言葉はcode_verifierとcode_challengeの2つで1組です。code_verifierはアプリが作るランダムな文字列で、手元に残しておきます。code_challengeは、code_verifierをSHA-256でハッシュし、Base64URLで文字列にしたものです。アプリは先にcode_challengeだけを認可サーバーへ送っておき、トークンと交換するときに初めてcode_verifierを送ります。
ハッシュは一方向の計算なので、code_challengeからcode_verifierを求めることはできません。code_challengeはブラウザを通るURLに載るので見られるかもしれませんが、それを見てもcode_verifierはわかりません。
パラメータ
| パラメータ | 内容 |
|---|---|
code_verifier | アプリが作る、推測できないランダムな文字列(43〜128文字)。トークンリクエストで送る |
code_challenge | code_verifierをSHA-256でハッシュし、Base64URLで文字列にしたもの。認可リクエストで送る |
code_challenge_method | code_challengeの作り方。S256(SHA-256)を指定する。認可リクエストで送る |
code_challenge_methodには、ハッシュせずにそのまま送るplainもあります。ただ、plainではcode_challengeを見られるとcode_verifierもわかってしまいます。PKCEの仕様(RFC 7636)でも、S256を使えるクライアントはS256を使わなければならないとされています。
PKCEを使った認可コードフロー
全体像
前回のフローに、PKCEで増える部分を紫で示しました。ドメインは前回と同じで、スマホアプリのリダイレクト先にはcom.example.print:/callbackを使います。
前回と違うのは、最初に合言葉を作ること(2)、認可リクエストにcode_challengeを付けること(4,5)、トークンと交換するときにシークレットの代わりにcode_verifierを送り、認可サーバーが確かめること(10,11)の3点です。このあとStepごとに、該当する矢印を緑で示します。
Step 1:合言葉を作る(図の1,2)
ユーザーが「写真を選ぶ」を押すと、アプリはまずcode_verifierを作り、そこからcode_challengeを計算します。
考え方をPythonで書くと、次のようになります。
import base64
import hashlib
import secrets
# 推測できないランダムな文字列(43文字)
code_verifier = secrets.token_urlsafe(32)
# SHA-256でハッシュし、Base64URLで文字列にする(末尾の=は取る)
digest = hashlib.sha256(code_verifier.encode("ascii")).digest()
code_challenge = base64.urlsafe_b64encode(digest).rstrip(b"=").decode("ascii")
この記事では、PKCEの仕様(RFC 7636)の付録にある例の値を使います。code_verifierがdBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXkで、そこから計算したcode_challengeがE9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cMです。code_verifierはアプリの中に保存しておき、まだどこにも送りません。
Step 2:認可リクエスト(図の3〜5)
アプリはブラウザで認可画面を開きます。このとき、認可リクエストにcode_challengeとcode_challenge_methodを付けます。
GET /authorize?response_type=code
&client_id=s6BhdRkqt3
&redirect_uri=com.example.print%3A%2Fcallback
&scope=photos.read
&state=35ce
&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
&code_challenge_method=S256 HTTP/1.1
Host: auth.example.net
認可サーバーは、受け取ったcode_challengeを保存しておきます(5)。このあと発行する認可コードと紐付けて、トークンリクエストのときに照らし合わせるためです。
なお、スマホアプリでは、認可画面をアプリに埋め込んだWebViewではなく、OSのブラウザやアプリ内ブラウザタブで開くことが求められています(RFC 8252)。WebViewだと、アプリがログイン画面に入力されたパスワードを読み取れてしまうためです。
Step 3:ログインと同意、認可コードの発行(図の6〜9)
ここは前回と同じです。ユーザーがログインして許可すると、認可サーバーはredirect_uriへリダイレクトし、OSが認可コードをアプリに渡します。
HTTP/1.1 302 Found
Location: com.example.print:/callback?code=SplxlOBeZQQYbYS6WxSbIA&state=35ce
Step 4:トークンとの交換(図の10〜12)
アプリは認可コードと一緒に、合言葉を作るときに保存しておいたcode_verifierを送ります。シークレットを持たないのでAuthorizationヘッダーは付けず、client_idを本文に入れます。
POST /token HTTP/1.1
Host: auth.example.net
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code
&code=SplxlOBeZQQYbYS6WxSbIA
&redirect_uri=com.example.print%3A%2Fcallback
&client_id=s6BhdRkqt3
&code_verifier=dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk
認可サーバーは、届いたcode_verifierを同じ方法でハッシュし、認可リクエストのときに保存しておいたcode_challengeと比べます(11)。一致すれば、認可リクエストを送ったのと同じアプリからのリクエストだとわかるので、アクセストークンを発行します(12)。
Step 5:APIへのアクセス(図の13,14)
ここも前回と同じです。アクセストークンをリクエストに付けて、リソースサーバー(api.example.net)から写真データを取得します。
GET /photos HTTP/1.1
Host: api.example.net
Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA
横取りされたコードが使えない理由
PKCEを使っていれば、悪意のあるアプリに認可コードを横取りされても、トークンとは交換できません。赤が攻撃のステップ、紫がPKCEによる確認です。a〜cは、合言葉を作る、code_challengeを保存する、code_verifierを確かめる、にあたります。
悪意のあるアプリが手に入れられるのは、リダイレクトで届いた認可コードだけです(4,5)。code_verifierは正規のアプリの中にしかなく、まだどこにも送られていません。code_challengeはURLに載るので見られるかもしれませんが、そこからcode_verifierは求められません。そのため、悪意のあるアプリのトークンリクエストは、cの確認で拒否されます。
正規のアプリがcode_verifierを送るトークンリクエストは、アプリから認可サーバーへHTTPSで直接送られ、ブラウザやOSの振り分けを通りません。そのため、code_verifierが途中で横取りされることもありません。
stateとの違い
PKCEと前回のstateは、どちらも「リクエストを始めた相手と、戻ってきた相手が同じか」を確かめる仕組みです。ただ、確かめる人と、主に防ぐ攻撃が違います。
state | PKCE | |
|---|---|---|
| 確かめる人 | クライアント | 認可サーバー |
| 比べるもの | セッションに保存した値と、リダイレクトで戻ってきた値 | 保存したcode_challengeと、届いたcode_verifierのハッシュ |
| 主に防ぐ攻撃 | CSRF(攻撃者のコードを被害者に使わせる) | 認可コードの横取り(被害者のコードを攻撃者が使う) |
なお、OAuthのセキュリティのベストプラクティス(RFC 9700)では、認可サーバーがPKCEに対応していると確認できる場合は、PKCEでCSRFも防げるとして、PKCEに頼ってよいとしています。
Webアプリでの利用
PKCEは、スマホアプリのためだけの仕組みではありません。同じベストプラクティス(RFC 9700)では、パブリッククライアントにはPKCEを必須とし、Webアプリのようなコンフィデンシャルクライアントにも使うことを推奨しています。シークレットがあっても、認可コードを横取りされたり、攻撃者のコードを送り込まれたりするのを防ぐのに役立つためです。
OAuthの新しい版であるOAuth 2.1でも、認可コードフローではPKCEを使うのが基本になっています。前回のWebアプリのフローも、実際に作るときはPKCEを組み合わせておくのが安全です。
まとめ
- スマホアプリはシークレットを持てないので、認可コードを横取りされると、そのままトークンと交換されてしまう
- PKCEは、認可リクエストのたびに使い捨ての合言葉(
code_verifier)を作り、そのハッシュ(code_challenge)を先に送っておく仕組み - トークンと交換するときに
code_verifierを送り、認可サーバーがハッシュを比べるので、合言葉を知らない相手はトークンを受け取れない stateはクライアントがCSRFを防ぎ、PKCEは認可サーバーが認可コードの横取りを防ぐ
次回予告
ここまでのOAuthとPKCEは、どれも「プリントサービスに何をさせてよいか」を決める仕組みでした。では、同じプリントサービスに「Instagramでログイン」を付けて、ログインしたのが誰かを知りたいときはどうするのか。
そこで使われるのが、OAuthの上に乗るOpenID Connect(OIDC)です。OIDCについては、次の記事で図を使って整理しました。