第2章 リリース固有の変更
2.1. バージョン 26.4.4 の互換性を失わせる変更 リンクのコピーリンクがクリップボードにコピーされました!
互換性を失わせる変更とは、既存のユーザーの設定やアプリケーションの変更が必要になる可能性がある変更として識別されます。マイナーリリースまたはパッチリリースでは、Red Hat build of Keycloak はバグを修正するためにのみ、互換性を失わせる変更を導入します。
2.1.1. リクエストでは正規化されたパスのみを受け入れる リンクのコピーリンクがクリップボードにコピーされました!
以前のリリースでは、Red Hat build of Keycloak は、パスにダブルドット (..) またはダブルスラッシュ (//) を含むパスを持つ HTTP リクエストを受け入れていました。これらのリクエストを処理すると、RFC3986 に従ってダブルスラッシュが折りたたまれた正規化されたパスが生成されました。このアプローチにより、URL フィルタリングの設定が難しくなりました。たとえば、リバースプロキシーでは正規化が無効になり、Red Hat build of Keycloak は HTTP 400 応答コードで応答します。
サーバーログで拒否されたリクエストを分析するには org.keycloak.quarkus.runtime.services.RejectNonNormalizedPathFilter のデバッグログを有効にします。
以前の動作に戻して、正規化されていない URL を受け入れるには、http-accept-non-normalized-paths を true に設定します。この設定では、HTTP アクセスログを有効にして確認し、問題のあるリクエストを特定します。