今日のひとこと Challange IT For Future

FessのSAMLでsaml4j移行前に設定を見直す

Fess 読了 5分
目次
  1. system.propertiesとIdP登録を照合する
  2. 初期値と使えなくなる設定を確認する
  3. ログインとログアウトを検証する
  4. 関連PR

FessのSAMLプラグイン開発版では、認証ライブラリをjava-samlからsaml4jへ切り替える変更がmainに入りました。単なる依存ライブラリの更新にとどまらず、証明書、ログアウト署名、旧設定の扱いが変わります。Fess 15.10系向けの変更で、プラグインはsaml4j 0.1.0-SNAPSHOTを参照しており、正式版の更新手順としてはまだ扱えません。

system.propertiesとIdP登録を照合する

試す場合は対応するFessとプラグインをそろえ、検証環境で現在の system.properties とIdPのクライアント設定を控えます。IdPの署名証明書は saml.idp.x509cert に設定します。証明書フィンガープリントだけを信頼元にする設定は使えません。証明書切り替え時は saml.idp.x509certMulti.1、.2 などを使えます。IdP証明書のRSA鍵は2048ビット以上が必要です。

SPのentity ID、アサーション受信先URL、IdPに登録したログアウト先 /sso/logout を照合します。URLは saml.sp.base.url などの設定から組み立てられ、受信リクエストのURL任せにはなりません。Fessから開始したログインだけが対象です。saml.security.requested_authncontext と saml.security.requested_authncontextcomparison は初期値が Password と exact ですが、IdPへの要求のみで応答のAuthnContextを強制確認しません。強い認証方式の強制をこの設定だけに任せないようにします。

初期値と使えなくなる設定を確認する

設定初期値・動作
saml.security.want_messages_signedfalse。Response署名を個別に必須とする設定
saml.security.want_assertions_signedfalse。Assertion署名を個別に必須とする設定
saml.security.authnrequest_signedfalse。有効化にはSP秘密鍵が必要
saml.security.want_assertions_encryptedfalse
saml.security.want_logout_signedtrue。IdPからのログアウトメッセージにも署名を要求
saml.security.allow_deprecated_algfalse。SHA-1署名を既定で拒否
saml.security.allow_rsa_1_5false。RSA 1.5鍵転送を既定で拒否
saml.security.clock_drift120秒
saml.security.max_message_size1048576バイト

ResponseとAssertionの個別設定がどちらも false でも、両方とも未署名の応答は受け付けません。Audience、Recipient、Destination、issuer、有効期間の検証も行われます。saml.strict=false は拒否されます。

旧 saml.security.reject_missing_audience は不要になり、AudienceのないAssertionは常に拒否されます。saml.security.allow_duplicated_attribute_name にかかわらず同名属性は結合されます。旧 reject_deprecated_alg や allowed_key_transport_algorithms などは警告付きで無視されます。認識されない他の saml.* キーは設定エラーになるため、旧設定の一括コピーは避け、プラグインの UPGRADING.md と照合します。

ログインとログアウトを検証する

IdP証明書、SPのURLとentity ID、署名方法を合わせて、ログインとIdP起点のログアウトを確認します。ログアウト応答のPOST先にも /sso/logout を登録し、アサーション受信先へ送らないようにします。

SAML設定不備によるメタデータ取得失敗は、Fess本体の関連変更でリクエストごとのスタックトレースから1行の警告になります。設定エラーが解決する変更ではないため、ログの理由を読み、再度メタデータ取得と認証を確認します。旧java-samlの処理上限変更を紹介する記事とは対象ライブラリが異なります。

関連PR