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_signed | false。Response署名を個別に必須とする設定 |
saml.security.want_assertions_signed | false。Assertion署名を個別に必須とする設定 |
saml.security.authnrequest_signed | false。有効化にはSP秘密鍵が必要 |
saml.security.want_assertions_encrypted | false |
saml.security.want_logout_signed | true。IdPからのログアウトメッセージにも署名を要求 |
saml.security.allow_deprecated_alg | false。SHA-1署名を既定で拒否 |
saml.security.allow_rsa_1_5 | false。RSA 1.5鍵転送を既定で拒否 |
saml.security.clock_drift | 120秒 |
saml.security.max_message_size | 1048576バイト |
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の処理上限変更を紹介する記事とは対象ライブラリが異なります。