集成应用获取个人授权开通电子签说明
最后更新于 2024/01/29   阅读数 39

本文是对【获取个人授权链接接口】的说明指引,分别从集成方和集成方系统用户的视角来说明。

该接口的适用场景有4个:

  • 集成方系统访问个人用户的资源信息,如获取个人实名身份、获取个人身份下签名、签署任务、签署文档等数据,必须得到用户授权。(主要

  • 集成方系统以个人用户名义发起合同签署,必须得到用户授权。(主要

  • 集成方系统让个人用户提前完成实名认证。(次要

  • 集成方系统想获取法大大平台为该用户在该应用appId范围内分配的唯一标识openUserId便于后续业务维护。(次要

集成方视角:

  1. 个人授权是个人主体把他在法大大的数据资源和权限授权给集成方应用系统,只有得到相应的授权后,集成方的应用系统才可以通过接口来使用个人主体的法大大数据。

  2. 集成方业务如涉及到上面4个场景,则需要接入获取个人授权链接接口,否则无需接入该接口获取个人授权。

  3. 获取个人授权链接接口返回的是法大大提供的内嵌页面(EUI),整个授权流程都在法大大页面上完成。

集成方集成步骤参考:
步骤一、根据具体业务流程设置开通电子签的触发入口(调用获取个人授权接口)

步骤二、根据具体情况传参,不同入参决定后续授权流程的不同
  1. 接口入参userIdentInfo可预填用户需要在授权页填入的个人信息包含(开通帐号、姓名、证件类型、证件号、个人银行账户号)。例如:集成系统本身已经收集了用户的个人信息,此时可以通过接口入参带入到授权页,为了保持数据的一致性也可以通过参数nonEditableInfo设置在授权页不允许用户修改带入的信息。

  2. 接口入参identMethod可指定用户认证方式(人脸识别、手机号、银行卡、人工审核)

  3. 接口入参authScopes可设置本次授权的范围(ident_info:授权允许获取个人身份信息seal_info:授权允许获取个人用户的签名资源、signtask_init: 授权允许代表个人发起签署、signtask_info: 授权允许获取个人用户的签署任务、signtask_file: 授权允许获取个人用户的签署文件)

接口地址:获取个人授权链接接口

步骤三、设置重定向地址(可选)

接口入参redirectUrl可设置页面重定向地址,通常在完成授权流程后按照集成方的业务流程重定向到指定的页面,并在链接上带入授权结果信息。

重定向url示例:https://xxx.xxx.com/xxx/xxx(集成方系统页面地址)?clientUserId=198794465321&signature=ec0b72f7074afacaeb18aa774ea4302b2798d02c63a607ef81352a939618fec3&authResult=success&openUserId=0af67bdea7b1487098f4c5405c9f5ffc&authScope=ident_info,signtask_init,signtask_info,signtask_file,seal_info&timestamp=1684829288951(法大大附加的授权结果信息)

步骤四、接收个人用户授权事件回调(推荐)

推荐使用事件回调(异步)的方式拿到个人用户授权结果,虽然步骤三重定向地址也会带上授权结果,但是由于是通过前端浏览器页面的方式所以很容易会被干扰导致拿不到授权结果。

详细内容可查看:个人用户授权事件

集成方系统用户视角:

集成方用户使用步骤参考:
步骤一、用户通过入口进入开通电子签页面

示例图

步骤二、检查开通页信息是否正确
  1. 查看授权信息-完全是由集成系统控制,在开通电子签页面不可修改。

  2. 检查身份信息-可在页面输入,也可由集成系统带入。

  3. 选择认证方式-默认4种可选,也可由集成系统指定。

  4. 确认开通电子签的手机号/邮箱

    注:若之前有在法大大平台注册过的,可填入法大大平台登陆帐号。

步骤三、确认信息无误后点击【立即开通】

通过【开通电子签的手机号/邮箱】号码判断该帐号是否已在法大大平台做过认证、是否已经在集成应用系统开通了电子签。如下图所示

未在法大大平台认证过需要走法大大个人实名认证流程,如下图所示:

具体页面操作可参考下面的:个人授权EUI页面流程图-个人实名认证流程

步骤四、开通成功重定向回集成系统,由集成系统判断下一步操作。

个人授权EUI页面流程图:

未能解决您的问题?请联系
本篇目录
集成方视角:
集成方集成步骤参考:
步骤一、根据具体业务流程设置开通电子签的触发入口(调用获取个人授权接口)
步骤二、根据具体情况传参,不同入参决定后续授权流程的不同
步骤三、设置重定向地址(可选)
步骤四、接收个人用户授权事件回调(推荐)
集成方系统用户视角:
集成方用户使用步骤参考:
步骤一、用户通过入口进入开通电子签页面
步骤二、检查开通页信息是否正确
步骤三、确认信息无误后点击【立即开通】
步骤四、开通成功重定向回集成系统,由集成系统判断下一步操作。
个人授权EUI页面流程图: