什么是联合登录
因为公司产品的发展,会与第三方的一些商户进行对接,商户APP提供入口,进入我们的H5页,从而提供服务。
而商户希望用户在其APP进行账户登录后,进入H5页不再进行登录,所以我们的H5需要拿到用户在商户的账户的标识id(暂时称之PartnerID),然后与我们的产品的账户标识id(暂时称之H5ID)进行一个关联,这样在用户登录APP后,我们能够通过PartnerID去查询关联的H5ID以获取账户信息,这样就可以保持登录的同步了。
解决方案
上述描述中的一个关键点是:如何拿到PartnerID
获取PartnerID大体有以三种方案:
方案1:授权回调式,商户提供授权页面,H5页面需要登录时,先进入商户提供的授权页,由用户同意授权,进而获取PartnerID
方案2:APP接口式,商户APP存在nativeAPI,H5页面调用nativeAPI以获取PartnerID
方案3:凭证解密式,商户APP在H5的url的query上添加加密字符串,H5页面取之解密后获取PartnerID
基本说遇到的联合登录大多以上三种之一,例如微信授权登录,可以视微信为商户,微信的unionid即PartnerID,微信使用的就是方案1
就开发复杂度由繁到简的排序如下:1 > 2 > 3
越复杂自然越安全,所以,安全性也就是以上的排序。
联合登录的详细步骤
代码就不贴了,详细步骤如下:
- 1:准备进入一个H5页面,它需要登录方可访问
- 2:在进入之前先取PartnerID,商户APP未登录则进行APP登录,再返回PartnerID
- 3:得到PartnerID,去查询相应的H5ID,有则存储账户登录信息进入第5步,无关联则进入下一步
- 4:H5登录页进行登录,登录后得到H5ID,将H5ID与PartnerID进行绑定,并且存储账户登录信息
- 5:此时已登录,进入页面中
独立代码
方案有三种,但有些代码是必须得写的,总结如下:
- 配置文件:因为商户不同,则接入类型和配置参数不同,假设有一个 shanghu.js ,如下代码:
module.exports = {
id: 'a', // 商户名称
type: 1, // 接入方案类型
}
- 方案1:“调用进入商户授权页”和“调用商户API获取PartnerID”的两个函数
- 方案2:“调用nativeAPI获取PartnerID”的函数
- 方案3:“解密字符串得到PartnerID”的函数
这些根据商户不同代码也是不同的,做不到统一解决方案,so,老老实实写吧。
不过有些代码可以做成通用的,开发完成则后续接入可以不用再管了。
通用代码
方案1:授权回调式
说是最复杂的方案,其实通用代码就两个路由:
前往授权 /toAuth:前往需要登录的页面时(假设地址为A),则先前往此路由,此路由接收一个回调地址(A)并存储在 session 中,然后此路由进入商户授权页(此时调用独立代码中进入商户授权页的函数)
授权回调 /authBack:必须提供给商户的回调路由,当商户授权页面中用户授权后,会返回此路由,用户的token亦会在query上传递回来,通过token去换取PartnerID,即执行联合登录的3、4步后(此时调用独立代码中调用商户API获取PartnerID的函数),则取出session中的回调地址(例子中的A)并进入
方案2:APP接口式
这个方案的通用代码其实就是一个前端函数:
根据商户调用其特定的独立函数:前端能得到PartnerID,所以在需要登录之前,先调用该商户的独立代码中的调用nativeAPI获取PartnerID的函数,得到PartnerID,再执行联合登录的3、4步,最后完成登录操作。
方案3:凭证解密式
这个方案最简单,只是在入口的路由加一个操作:
存储加密凭证字符串:在入口路由上,将加密凭证存入session中,在需要登录前,则调用该商户的独立代码中的解密字符串得到PartnerID的函数,得到PartnerID,再执行联合登录的3、4步,最后完成登录操作。
查询接口
联合登录的第3步中,会存在两个api,这些由我们自己开发,分别是:
- 查询绑定账户:通过PartnerID查询关联的H5ID,若存在,则返回账户的登录信息,若不存在,则返回无绑定关系,前端根据api结果判断是否进入H5的登录页
- 进行账户绑定:将PartnerID和H5ID进行绑定,返回账户的登录信息
其他比较特殊的登录
静默登录
在上面的过程中,中间会有一层绑定的操作,此时需要内部H5页进行一次登录,而这样会出现两次登录的情况:APP登录后,首次进入H5,H5中登录并绑定。
所以,有些商户有这样的需求:APP已登录,则在H5内部无需登录,即首次进入H5也无需在H5进行登录绑定就可以有登录状态。
这种样的解决方案其实很简单,在查询的两个接口中,存在查询绑定账户的接口,这个接口的功能是:
- 通过PartnerID查询关联的H5ID,若存在,则返回账户的登录信息,若不存在,则返回无绑定关系,进入H5的登录页
如果需要满足上述需求,实际是这个接口永远返回登录信息,包括首次登录,如此简单即可。
因为在调用接口时,会传递商户名称和PartnerID,接口开发人员可以根据商户名进行操作。
例如:平台cmb需要静默登录,则后端开发人员在查询绑定账户接口接收参数 partnerName,若 partnerName === 'cmb',则静默注册一个账号并登录,返回登录信息,其余的则正常流程。
而对于多个商户都有此类需求,可以维护一个 array ,符合array内的条目,进行进行静默注册并登录,不符合则走正常的步骤。
快应用的嵌入
快应用页可以获取用户在开放平台unionid,在进行嵌入开发时,有时候需要拿到unionid和H5的账户进行绑定。
首先,快应用提供了API以获取用户唯一身份标识,其次,快应用本身应该视为一个轻量APP的开发,而快应用也提供了一些方法,我们可以封存一些方法和接口,由H5以nativeAPI的方式进行调用和开发,故而快应用的联合登录应该是方案2:APP接口式。
封装
web组件可以使用:
- postMessage:向内部H5推送一个消息
- onmessage:监听内部H5的消息
内部H5可以使用:
- system.postMessage:向外部web组件推送一个消息
- system.onmessage:监听外部web组件传递的消息
故可以在web组件监听 onmessage ,得到网页 system.postMessage 发送的登录请求时,在快应用层去调用登录API,得到PartnerID后,再由web组件的 postMessage 将PartnerID传递给内部H5页面,而H5则得到PartnerID,走正常的联合登录流程。
END
个人特别不建议针对一个商户就写一套方案,浪费时间且大量重复代码,不利于代码维护。
虽说有多种情况,但大部分都是可以围绕三种方案进行延伸拓展,有其他情况再补充,现在就写到这里。。