1. 进入统一登录授权页
请求方式: GET(HTTPS)
请求地址: https://test-sso.qq.com/open/oauth2/authorize?appid=APPID
请求参数:
参数 | 必填 | 说明 |
---|---|---|
appid | 是 | 登录的目标应用appid |
base_appid | 否 | 应用间带登录态跳转时必填,继承指定应用的登录态,需要提前开通权限 |
redirect_uri | 否 | 授权后重定向的回调地址,请使用urlencode对链接进行处理 ,注意域名需要设置为第三方应用的可信域名;如果不填,默认跳转到应用在教育号开放平台填写的首页地址。 |
response_type | 否 | 返回类型,此时固定为:code(默认值) |
state | 否 | 重定向后会带上state参数,可以填写a-zA-Z0-9的参数值,长度不可超过128个字节 |
请求示例:
https://test-sso.qq.com/open/oauth2/authorize?appid=APPID&base_appid=BASE_APPID&redirect_uri=REDIRECT_URI&response_type=RESPONSE_TYPE&state=STATE
用户可在浏览器手动输入统一登录页url进行登录授权
应用通过构造网络授权链接跳转到到统一登录页
2. 用户登录授权
登录方式
支持微信/企业微信扫码、帐号+密码和手机号+验证码等多种登录方式
补充登录页截图
3. 授权完成后跳转
登录成功后重定向到应用的首页地址或redirect_uri指定的地址,并携带登录授权code。
在手机端默认跳转到应用配置的移动端首页地址,在ipad、电脑端默认跳转到应用配置的PCWeb端地址。
示例:
https://app_url?code=b29eb6164d62d522ff09d64429a8e6a1&appid=APPID&state=STATE
4. 查询授权用户信息
应用从跳转链接中解析code,获取用户凭证,查询用户身份信息;
详情请查阅用户凭证管理和查询用户身份信息
5. 切换登录身份
开发中...
6. 用户登出
用户已登录状态下,执行登出操作,前端调用以下接口完成登出,教育号将清空当前用户指定应用的登录态
https://test-sso.qq.com/open/logout?appid=APPID