文章内容

帮助中心 > 云助手 >

第三方集成自定义单点登录api开发指引

背景:第三方集成明源的移动产品,明源产品需要适配第三方的单点登录

实现原理:


配置方法:

登录明源云移动产品企业后台,企业号及账号密码请咨询对应一线。




说明

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点击后的链接如下:

   https://qy-ci.fdccloud.com/workflow-micro/my596c24f03fc0e/workflow/process-list/index?__from=erpapijc&kindType=5&ticket=xxxx

此时移动端检测系统需要免登用户,则向二开配置的单点登录自定义接口地址,请求(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