背景:第三方集成明源的移动产品,明源产品需要适配第三方的单点登录
实现原理:
配置方法:
登录明源云移动产品企业后台,企业号及账号密码请咨询对应一线。
说明
1.接口管家集成用户参数: 用来配置个性化的固定参数和重构系统中接口权限认定,如果是重构系统需要配置选项:{"_header_option": {"appid":"变量值","appkey":"变量值"}},以便请求二开的接口!
2.单点登录自定义接口地址:移动审批,移动报表等移动端H5应用需要免登的时候会把当前url上的query参数,转换为json格式,以curl post json的形式请求二开的地址,二开自己识别当前可用的参数来获取用户信息,按照要求返回当前用户的user_code,移动端来根据user_code来自动免登系统!
自定义API,开发指引:
请求post,为json字符串:
---------------------
{
"xxxx":"xx",
"xxx":"xxx",
"各种其他参数":"各种值"
}
------------------
返回值格式,json字符串:
-----------------------------------------------------------------------
{"errorcode":"错误code,正确标识为:0,否则为失败","errormsg":"错误的信息,请一定要填写此处错误新,便于问题排查","usercode":""}
示例:
--------------
如 移动审批从第三方oa点击后的链接如下:
此时移动端检测系统需要免登用户,则向二开配置的单点登录自定义接口地址,请求(POST)JSON信息
{ "__from":"erpapijc", "kindType":"5", "ticket":"xxxxxxxxx" }
------------------------------------------------------
返回结果
成功:
{"errorcode":"0","errormsg":"ok","usercode":"admin"}
移动端就会免登为账号为admin,展示对应的页面信息
失败:
{"errorcode":"100","errormsg":"未能识别当前用户信息","usercode":""}
移动端会提示友好的报错信息,不能使用移动系统
查看日志:
备注
1、如果是mip接口请选择权限为OAuth 2.0
作者: 初良祥 日期: 2023-05-08