.Net之微信小程序获取用户UnionID

前言：

　　在实际项目开发中我们经常会遇到账号统一的问题，如何在不同端或者是不同的登录方式下保证同一个会员或者用户账号唯一（便于用户信息的管理）。这段时间就有一个这样的需求，之前有个客户做了一个微信小程序商城（店主端的），然后现在又要做一个会员购物端的小程序商场。首先之前用户登录凭证都是使用微信openid来做的唯一标识，而现在客户需求是要做到用户在会员端小程序跳转到到店主端小程序假如之前该用户微信是在店主端审核通过的用户则不需要在进行资料提交审核操作，直接登录。所以，所以我们使用了UnionID来进行关联，如下是我们现在项目的基本流程（画的丑莫见怪）。

640?wx_fmt=png

说说UnionID机制：

　　如果开发者拥有多个移动应用、网站应用、和公众帐号（包括小程序），可通过 UnionID 来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号（包括小程序），用户的 UnionID 是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。

官方UnionID机制详细说明：https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/union-id.html

微信开放平台绑定小程序流程：

登录微信开放平台 — 管理中心 — 小程序 — 绑定小程序（直接使用微信官方图）

640?wx_fmt=png

微信小程序获取UnoinID的两种方式：

调用接口 wx.getUserInfo，从解密数据（encryptedData）中获取 UnionID（推荐使用）：

推荐使用原因：无需关注微信公众号即可获取到UnionID。

调用接口wx.getUserInfo前提：用户允许授权获取用户信息！

开发者后台校验与解密开放数据：

　　微信为了保证用户信息，把用户通过wx.getUserInfo接口获取到的相关敏感信息进行了加密。加密方式对称加密（后面会提到），首先我们需要通过微信小程序登录流程获取到用户的session_key(会话密钥)，然后我们可以报获取到的会话密钥使用缓存存起来，在通过用户授权获取用户相关信息，如下是用户授权成功获取到的用户信息：

640?wx_fmt=png

基本流程图如下：

640?wx_fmt=png

(encryptedData)加密数据解密算法：

开发者如需要获取敏感数据，需要对接口返回的加密数据(encryptedData) 进行对称解密。解密算法如下：

对称解密使用的算法为 AES-128-CBC，数据采用PKCS#7填充。
对称解密的目标密文为 Base64_Decode(encryptedData)。
对称解密秘钥 aeskey = Base64_Decode(session_key), aeskey 是16字节。
对称解密算法初始向量为Base64_Decode(iv)，其中iv由数据接口返回

很遗憾的是微信居然没有为我们大.Net提供解密算法demo，实属让人不算，最后自己根据网上的资料还是配上了符合微信对称加密的解密算法。

代码实现：

首先关于session_key（会话密钥）的获取，请看下面的wx.login+code2Session 方式

调用接口wx.getUserInfo获取encryptedData（加密数据）和iv（初始向量）：

640?wx_fmt=png

.Net WebApi 解密数据接口：

640?wx_fmt=png

注意参数使用Convert.FromBase64String转化，提示“Base-64字符数组的无效长度” 的问题：

原因:加密参数中的"+"通过地址栏传过来时,后台会解析为空格。

解决：最好的做法是使用encryptedData.Replace("+", "%2B")先将空格编码，然后再作为参数传给另一页面传递，这样页面在提取参数时才会将“%2B”解码为加号.但这儿为了简化，将空格直接还原为"+"或者是直接在后台将空格替换为“+”encryptedData.Replace(' ', '+');

直接通过 wx.login + `code2Session` 获取到该用户 UnionID：

其实这个方式就是实现了小程序的登录流程，微信官方详细说明：

https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html

优点：无需用户授权。

前提：用户需要关注该微信公众号。

小程序端调用接口wx.login获取code凭证，在通过请求auth.code2Session接口获取用户信息（UnionID,openid,session_key会话密钥）两种方式：

1.直接通过wx.login请求到code凭证后，在请求该地址获取用户信息：

详细说明请看微信官方文档（代码略）：https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html

2.通过请求wx.login获取code凭证，在向.net webapi后端请求code2Session接口：

原因：因为我们需要对获取的用户信息做相关业务逻辑处理。

微信小程序端代码：

/**
*封装用户promise登录，通过code凭证获取用户信息（UnionID,openid,session_key会话密钥）
*/
userLogin: function() {
var that = this;
//定义promise方法
return new Promise(function(resolve, reject) {
//调用登录接口
wx.login({
success: function(res) {
if (res.code) {
console.log("用户登录授权code为：" + res.code);
//调用wx.request请求传递code凭证换取用户openid，并获取后台用户信息
wx.request({
url: 'https://www.xxxx.xxx.api/User_oAuth/GetUserInfo',//后台请求用户信息方法
data: {
code: res.code //code凭证
},
header: {
'content-type':'application/json' // 默认值
},
success(res) {
console.log(res.data)
if (res.data.errcode == 0) {
//存入session缓存中
console.log(res.data.openid);//微信用户唯一标识
console.log(res.data.UnionID);//微信开发平台联合ID
console.log(res.data.session_key);//会话密钥
//***注意****
//注意：这里是直接把session_key缓存起来，在上面wx.getUserInfo会使用到
wx.setStorageSync("session_key",res.data.session_key);

//promise机制放回成功数据 
resolve(res.data);
} else 
{ reject('error'); }
}, fail: function(res)
{
reject(res);
wx.showToast({ title: '系统错误' })
}, complete: () => { } //complete接口执行后的回调函数，无论成功失败都会调用 
}) } else 
{
reject("error");
}}
})
})}