DPoP

Bearer トークンは、持っている人なら誰でも使えます。DPoP トークン (RFC 9449) はクライアントの鍵ペアにバインドされています。すべてのトークンリクエストとすべての API 呼び出しは、秘密鍵で署名した短い JWT、つまり証明を運び、トークンはそれなしでは役に立ちません。登録の dpop プロパティでこれが有効になります。セキュリティスターターのリソースサーバーは両方の種類を受け入れます。

使う理由

アプリのトークンは、紛失したり侵害されたりしうるデバイスの上にあり、ネットワークやプロキシを通過します。Secure Enclave や Android Keystore に保持された鍵にバインドされたトークンは、それをコピーした人がリプレイすることはできません。Spring Security 7 にはクライアント側の DPoP がありません。これは追加されたものです。

例

# auto (デフォルト): 鍵がプログラムより長く残り (アプリの鍵)、
# プロバイダーのメタデータが dpop_signing_alg_values_supported に ES256 を列挙していれば有効。
spring.security.oauth2.client.registration.my-provider.dpop=auto

# true: 常に (手で設定したプロバイダー、または独自の鍵を持つサーバー)。
# false: Bearer トークン。

DPoP を使いたいサーバーは、再起動後も残る鍵を宣言します。

@Bean()
DPoPKey dPoPKey(KeyStore store) => SoftwareDPoPKey.fromJwk(store.read('dpop'));

dpop プロパティ

値 意味
auto (デフォルト) 鍵がプログラムより長く残り (DPoPKey.persistent: Flutter のセキュリティパッケージのアプリの鍵)、検出されたプロバイダーのメタデータが dpop_signing_alg_values_supported に ES256 を列挙していれば有効。
true 常に有効。再起動後も残る (そして、セッションを共有する複数のインスタンスがある場合は共有される) DPoPKey Bean を宣言する。
false Bearer トークン。

サーバーのデフォルトの鍵は一回の実行のためにメモリ上で作られるため、サーバーでは auto は Bearer トークンのままです。登録が dpop=true を指定しない限り、oauth2Login() には何も変わりません。DPoP を告知しないプロバイダーでは、どこでも Bearer になります。

DPoP の登録が行うこと

鍵

鍵は DPoPKey Bean です: algorithm (ES256)、publicJwk、そして JOSE が求める生の R || S を返す sign (ECDSA.transcodeSignatureToConcat はプラットフォームの鍵の DER を変換します)。

鍵 置き場所
SoftwareDPoPKey (スターターのデフォルト) Dart で作られる ES256 の鍵。実行ごとに生成され、メモリに保持される。それにバインドされたトークンはプロセスとともに失われ、リフレッシュトークンも同様。再起動後はリフレッシュが失敗し、ユーザーは再びログインする。
SoftwareDPoPKey.fromJwk(...) toJwk() が保存した場所から復元される。toJwk は秘密鍵を持つ。決してログに出してはいけない。
Flutter のセキュリティパッケージの鍵 iOS と macOS では Secure Enclave か Keychain、Android Keystore、Windows と Linux ではその SecretStore の中の鍵。そのモジュールが先に来るため、こちらは引き下がる。
LoadableDPoPKey プラットフォームが応答して初めて公開部分がわかる鍵。DPoPProofBuilder はまずその load() を待つ。

スターターの中の何物も、鍵、証明、トークンをログに出しません。Feign の headers のログは、Authorization と同じく DPoP ヘッダーをマスクします。

Spring (Java) との対応

Spring Security 7 にはクライアント側の DPoP がありません (spring-security#18228 が ClientSettings.requireDpop を提案しています)。dpop プロパティ、DPoPMode、DPoPKey、SoftwareDPoPKey、DPoPProofBuilder、そしてトークンクライアント、ユーザーサービス、Feign のインターセプターの DPoP の部分は、この移植独自のものです。OAuth2AccessTokenResponse は Spring Security 6.5 と同じく token_type: DPoP を読みます。まだないもの: Web での WebCrypto の鍵、use_dpop_nonce で応答された Feign の呼び出しのリトライ。

関連項目