今日のひとこと Challange IT For Future

FessのOIDCでPKCE必須のIdPに接続する

Fess 読了 3分
目次
  1. 対応版をそろえてログインする
  2. 互換性設定の場所と初期値
  3. 新規ログインで動作を確認する
  4. 関連PR

OIDCのIdPでクライアントにPKCEを必須にすると、従来のFessプラグインでは認可要求を受け付けてもらえませんでした。OIDCプラグインの開発版には、S256方式のPKCEを送る変更がmainに入りました。

対応版をそろえてログインする

対応プラグインでは、設定キー oic.pkce がない場合にPKCEが有効になります。通常は追加設定なしで、IdPのクライアントをS256必須にしてログインを試せます。認可要求には code_challenge と code_challenge_method=S256 が付き、トークン要求には対応する code_verifier が付きます。

verifierはstate、nonceとともにセッションに保持され、コールバック処理時には結果にかかわらず削除されます。OpenSearchのセッション共有ではこの値も共有対象です。複数ノードで運用する場合は、先に全ノードを対応版にそろえます。新しいノードで開始した認証を古いノードで完了しようとすると、verifierを送れずIdPに拒否されるためです。

互換性設定の場所と初期値

oic.pkce は system.properties の設定です。管理画面の全般ページには入力欄がなく、-Dfess.system.oic.pkce で指定する項目でもありません。

初期値は有効で、値が false の場合だけ無効になります。それ以外の値やキーの省略では有効なままです。設定はログインごとに読み取るため、読み取り対象のプロパティへ反映されれば再起動せず次のログインに適用されます。PKCEパラメータ自体を拒否する古いIdPとの互換性用に無効化できますが、PKCE必須のIdPには無効状態で接続できません。

新規ログインで動作を確認する

IdPのクライアントでS256を要求し、新規ログインが完了することを確認します。既存セッションがあるだけでは認可コード交換の確認になりません。ロードバランサー越しの場合は開始と完了が別ノードになる経路も確認します。

PKCEを送らず開始したログインは、対応版ノードでもverifierなしで完了します。更新中に開始した認証と、全ノード更新後の認証を区別してください。PKCE追加はissuerなどのクレーム検証やnonceの代わりにはならず、iat と nbf の検証追加も今回の範囲外です。

関連PR