如何在Keycloak默认账户客户端配置Valid redirect URIs并实现外部域名跳转

问题根源 #

你搞错了配置对象：默认的account客户端是Keycloak内置用于自身账户管理界面的，它的redirect_uri和Keycloak自身前端绑定。当你访问http://127.0.0.1:8001/realms/test/account/时，这个内置页面会自动用Keycloak自身地址作为跳转目标，修改它的Valid redirect URIs不仅无法让外部域名生效，还会破坏内置账户页的正常跳转逻辑。

正确配置步骤 #

• 不要修改默认的account客户端，在Keycloak控制台创建新的独立客户端，专门用于你的外部应用https://dbister.com。
• 新客户端核心配置：
  • Valid redirect URIs设为https://dbister.com/*
  • 根据应用类型选择对应Access Type（单页应用选public，后端服务选confidential）
• 外部应用需要登录时，引导用户访问Keycloak的授权端点，并在请求参数里指定redirect_uri为你的外部应用地址（比如https://dbister.com/login/callback），而非直接访问Keycloak的account页面。

特殊需求处理（自定义账户页跳转） #

如果确实需要Keycloak账户页操作后跳转到外部域名，不能通过修改默认account客户端实现，你需要：

• 自定义Keycloak主题，修改账户页的跳转逻辑
• 或使用Keycloak Account REST API，在外部应用中自行实现账户管理功能，完全绕过内置account页面

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