Keycloak 12.0.2版本登出重定向URL配置方法咨询

Keycloak的登出接口本身支持通过redirect_uri参数指定跳转目标，但需要先完成客户端配置，再修改主题模板的登出链接，具体操作如下：

1. 先配置客户端的合法重定向地址 #

登录你的Keycloak管理控制台（http://localhost:8088/auth/admin/master/console/#/realms/realmName），找到项目对应的客户端：

• 进入客户端详情页，切换到Settings标签
• 在Valid Redirect URIs字段中添加你的项目主页地址，比如本地测试可以填http://localhost:xxxx/*，线上环境填https://your-project-domain.com/*（星号是通配符，允许该域名下所有地址）
• 点击Save保存配置

2. 修改account主题的template.ftl模板 #

找到Keycloak部署目录下的account主题模板文件，默认路径是keycloak/themes/account/ftl/template.ftl，如果用了自定义主题，就找对应主题目录下的该文件。找到登出按钮的代码块：

<li><a href="${url.logoutUrl}">${msg("doSignOut")}</a></li>

修改为带redirect_uri参数的链接，替换成你的实际项目主页地址：

<li><a href="${url.logoutUrl}?redirect_uri=http://your-project-domain.com">${msg("doSignOut")}</a></li>

3. 重启Keycloak实例 #

主题文件修改后，必须重启Keycloak服务才能让变更生效。

额外注意事项 #

• 如果用了自定义主题，确保修改的是当前realm正在使用的account主题模板
• 若登出后还是跳转到Keycloak登录页，检查Valid Redirect URIs是否和redirect_uri的地址完全匹配（协议、域名、端口都不能错）

内容的提问来源于stack exchange，提问作者Robert Głowacki