ESSO 用户接入文档-前端手册

登录状态判断规则

与IDaaS相同，当用户通过单点登录地址完成登录操作后，地址栏中会携带一个参数作为登录token。
此参数的参数名为access_token，值为string格式的Bearer类型token字符串
若存在此参数，说明用户已完成登录，调用后台接口时在header中携带Authorization字段，对应的值为Bearer 拼接access_token
1
2
3
headers = {
'Authorization': 'Bearer ' + access_token
}
若不存在此参数，在需要用户登录的时候令用户跳转至单点登录地址即可。

单点登录地址生成规则

获取当前url，并将其进行url编码

1	let url_encode = encodeURIComponent(location.href);

在url编码前拼接登录指定地址。

测试服地址：http://essotest.zjzwfw.gov.cn/opensso/spsaehandler/metaAlias/sp?spappurl=https://gdte-api.cloudvhall.com:8443/ban/api/v1/login/esso?goto=
正式服地址：https://esso.zjzwfw.gov.cn/opensso/spsaehandler/metaAlias/sp?spappurl=https://dea-api.idtshow.com:8443/ban/api/v1/login/esso?goto=

// 正式服地址
// const ESSO_PREFIX = 'https://esso.zjzwfw.gov.cn/opensso/spsaehandler/metaAlias/sp?spappurl=https://dea-api.idtshow.com:8443/ban/api/v1/login/esso?goto=';
// 测试服地址
const ESSO_PREFIX = 'http://essotest.zjzwfw.gov.cn/opensso/spsaehandler/metaAlias/sp?spappurl=https://gdte-api.cloudvhall.com:8443/ban/api/v1/login/esso?goto=';
let esso_url = ESSO_PREFIX + url_encode;

令浏览器跳转至拼接出来的单点登录地址。
1
location.href = esso_url;

测试账号

公共测试账号：zjfrcszh
公共密码：Zjfrcszh123

登出

ESSO用户的登出需要分两步执行：首先解除我们后台服务器的登录状态，然后跳转ESSO地址解除用户登录操作。
ESSO只提供了正式服的登出操作。若在测试服中想要模拟登出操作，可在访问后台接口后关闭浏览器来完成登出操作。

调用数字展览浙里办API提供的登出接口。
- 文档地址：http://docs.cloudvhall.com/sw/index.html?src=/api/dea_ban_api.yaml#/User/post_logout
使用页面跳转的方式解除ESSO用户系统的登录记录。

登出的跳转地址生成方式类似于单点登录的生成规则，不同的是当前url不能进行url编码操作
- 正式服地址：http://esso.zjzwfw.gov.cn/opensso/UI/Logout?goto=https://oauth.zjzwfw.gov.cn/oauth/logout.do?redirect=
  1
  2
  const ESSO_LOGOUT_PREFIX = 'http://esso.zjzwfw.gov.cn/opensso/UI/Logout?goto=https://oauth.zjzwfw.gov.cn/oauth/logout.do?redirect=';
  location.href = ESSO_LOGOUT_PREFIX + location.href;