SSO登录对接

## SSO登录对接必读 > SSO登录,指通过乐陪方的SSO登录到第三方系统平台。对接方提供平台页面地址与接口对接,由乐陪方配置后,学校用户可以由SSO登录到第三方系统平台。目前老师能通过SSO登录电脑端和手机端。学生家长仅能登录手机端。 > *++**对接SSO登录的前提是经过人员数据同步对接。**++* ### SSO登录对接流程 ![image.png](https://cos.easydoc.net/32050984/files/lac859vd.png) ### 对接方提供接口 ***接口要求*** > **业务逻辑:** 乐陪系统调用此接口,传入乐陪学校ID及加密后的乐陪用户ID,对接方根据参数校验是否允许登录,不允许登录返回原因(乐陪系统直接提示用户),允许登录即返回对接方系统网页地址。**系统网页地址要求能正常打开系统并能进入登录成功后的页面** > > POST请求,Content-Type: application/json ****接口参数结构**** ```json { "appId":"1231232", "schoolId":"2", "encryptData":"yJWsNup/sbbWoCf47qWP3BHz6N/CJzNUB3ex1JJCz5iekw=" } ``` ****接口参数结构说明**** | 字段名称 | 字段类型 | 字段描述 | | ----------- | -------- | :---------------------------------- | | appId | string | 乐陪的APPID | | schoolId | string | 乐陪的学校ID | | encryptData | string | 加密数据(AES-256-CBC后base64编码) | ### 解密后数据结构说明 | 字段名称 | 字段类型 |是否必传| 字段描述 | | ----------- | -------- |----| :---------------------------------- | | appId | string |是| 乐陪的APPID | | schoolId | string |是| 乐陪的学校ID | | userId | string |是| 乐陪用户ID,解密后可能是老师ID、家长ID | | mobile | string |是| 手机号,老师和家长是手机号,学生是证件号 | | studentId | string |否| 学生ID,家长绑定的学生ID,1个 | ****接口返回数据结构**** ```json { "code":200, "message":"success", "data":"http://abc.aaa.com/index.html?q1=aaa&q2=bbb" //返回的内容必须是对接方系统网页地址 } 说明: 1、正常情况下返回的成功json串,code为200即成功,非200即失败;非200的message内容会直接提示用户。 2、data返回的网页地址中包含特殊字符,请将特殊字符进行转义。 ```