You need to enable JavaScript to run this app. 如何正确调用Keycloak的end_session_endpoint实现单点登出功能
优惠活动
大模型
产品
解决方案
定价
更多

如何正确调用Keycloak的end_session_endpoint实现单点登出功能

Keycloak 12.0.4 end_session_endpoint 调用说明

参数要求说明

  • 关于id_token_hint参数:
    Keycloak 12.0.4的单点登出端点遵循OpenID Connect RP发起登出的规范,必须携带id_token_hint查询参数,参数值为用户登录时下发的有效id_token。该参数用于Keycloak定位对应用户的SSO会话,缺少该参数会直接返回400错误,你观察到的mod_auth_openidc的传参逻辑是符合标准规范的实现。
  • 关于client id/secret凭证:
    是否需要传凭证分两种场景判断:
    • 浏览器重定向场景:也就是将用户浏览器直接跳转到end_session_endpoint的场景,不需要携带client id/secret。Keycloak会自动校验id_token_hint的签名有效性,匹配到用户会话后即可完成全平台单点登出。如果需要登出后跳转到指定页面,可额外携带post_logout_redirect_uri参数,注意该参数值必须提前在对应Keycloak客户端的「有效重定向URI」配置项中登记,否则会跳转失败。
    • 后端服务直接调用场景:也就是通过后端程序直接请求登出端点的场景,同样不需要携带client id/secret,但需要在请求头中附带用户当前的Keycloak SSO Cookie才能匹配到活跃会话,实现成本比浏览器跳转更高,一般更推荐优先使用浏览器重定向方案。

标准调用示例

https://<你的Keycloak服务地址>/auth/realms/<你的Realm名称>/protocol/openid-connect/logout?id_token_hint=<用户合法id_token值>&post_logout_redirect_uri=<提前登记的登出回调地址>

内容的提问来源于stack exchange,提问作者bjlevine

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 09:06:05