用户退出

用户退出,就是使用企业服务平台的《授权码模式》或者《授权码模式(PKCE)》登录授权后,返回的id_token,跳转企业服务平台进行用户退出,用户退出成功后,还可以跳转到应用系统,大体步骤如下:

 

构造用户退出链接

链接及参数说明

请求地址:

生产环境:https://esp.xkw.cn/connect/logout

沙箱测试环境:https://esp.doc.xkw.cn/connect/logout

应用系统需要获取用户的身份信息,第一步需要构造如下的链接来获取code参数:

参数说明:

参数必须说明
id_token_hint《授权码模式》或者《授权码模式(PKCE)》登录授权后,返回的id_token
client_id应用的client_id
post_logout_redirect_uri用户退出后重定向的回调链接地址,请使用urlencode对链接进行处理
state重定向后会带上state参数,企业可以填写a-zA-Z0-9的参数值,长度不可超过128个字节

员工点击后,页面将跳转至 post_logout_redirect_uri?state=STATE。

 

例子说明

比如应用系统client_id:oa

访问链接跳转地址:https://oa.xkw.cn/logout

根据URL规范,将上述参数分别进行UrlEncode,得到拼接的OAuth2链接为:

注意,构造OAuth2链接中参数的post_logout_redirect_uri是经过UrlEncode的

员工点击后,页面将跳转至

应用系统可根据自身业务情况,进行会话销毁等操作。

 

注意事项

  1. 如果授权码模式,有调用“令牌刷新”接口,会返回新的id_token,系统需要更新对应的id_token,旧的id_token失效,不能用于退出操作;