如何在Keycloak账户管理页登出时修改redirect_uri实现自定义重定向

默认跳转回账户主页的原因 #

Keycloak内置账户管理控制台的登出逻辑严格遵循OIDC登出规范：当登出请求未携带合法的自定义redirect_uri参数时，系统会兜底跳转回当前关联客户端的默认页面，也就是内置account-console客户端对应的账户主页。你遇到的登出后跳转到http://localhost:8080/auth/realms/KLARA/account/的行为，并非系统硬编码的固定跳转，本质是当前登出流程关联的account-console客户端配置指向了KLARA领域的地址。

官方支持的配置操作步骤 #

• 定位正确的目标领域内置客户端
  进入Keycloak管理控制台，选择实际承载账户访问的MY_REALM领域，在客户端列表中找到默认内置的account-console客户端（旧版本Keycloak中该客户端名称为account）。注意不要在KLARA领域做配置修改，先排查清楚当前登出流程关联的客户端归属，避免跨域配置不生效。
• 配置允许的登出重定向地址
  进入account-console客户端的设置页，找到Valid Redirect URIs配置项，将需要的跳转地址http://destionation.com/home添加到合法重定向列表中，同时务必保留原有匹配账户页地址的规则（即http://localhost:8080/auth/realms/MY_REALM/account/*），避免账户页其他功能的重定向规则失效。
• 触发登出流程的自定义跳转
  可选择两种无侵入的官方配置路径：
  1. 可自定义领域主题时：找到主题模板中账户页登出按钮拼接的登出端点地址（标准格式为{keycloak域名}/realms/{领域名}/protocol/openid-connect/logout），在请求参数中显式携带redirect_uri参数，值为之前配置的合法地址http://destionation.com/home，Keycloak会在完成登出态清理后自动校验并跳转。
  2. 不希望修改主题时：在领域的客户端配置中开启Standard Flow Enabled开关，在account-console客户端的Logout settings板块配置默认登出重定向地址为目标地址，同时开启领域级别的Default Redirect Allowed配置，系统会在登出请求未显式携带redirect_uri时，自动使用配置的默认地址完成跳转。

注意事项 #

Keycloak对登出流程的redirect_uri有严格的校验规则：携带的跳转地址必须和客户端配置的Valid Redirect URIs完全匹配，不支持通配符跨域匹配，否则系统会直接忽略自定义的redirect_uri参数，兜底跳转回默认的账户主页。

内容的提问来源于stack exchange，提问作者bkl