微信小程序之獲取並解密用戶數據（獲取 openId、unionId）

前言
微信小程序API文檔：mp.weixin.qq.com/debug/wxado…
在實際的小程序開發中，往往需要用戶授權登陸並獲取用戶的數據，快速對接用戶系統。
openId : 用戶在當前小程序的唯一標識
unionId : 如果開發者擁有多個移動應用、網站應用、和公衆帳號（包括小程序），可通過unionid來區分用戶的唯一性，因爲只要是同一個微信開放平臺帳號下的移動應用、網站應用和公衆帳號（包括小程序），用戶的unionid是唯一的。換句話說，同一用戶，對同一個微信開放平臺下的不同應用，unionId是相同的。詳情登錄微信開放平臺(open.weixin.qq.com) 。
在微信小程序開發中，unionId等敏感數據則被加密在encryptedData，於是需要以下流程來解密敏感數據，從而獲取unionId等信息。

流程
1、（客戶端）微信小程序客戶端調用 wx.login()接口獲取登錄憑證（code）

//1、調用微信登錄接口，獲取code
wx.login({
    success: function (r) {
        var code = r.code;//登錄憑證
        if (code) {
            //2、調用獲取用戶信息接口
            //...
 
        } else {
            console.log('獲取用戶登錄態失敗！' + r.errMsg)
        }
    },
    fail: function () {
        callback(false)
    }
})

2、（客戶端）微信小程序客戶端調用 wx.getUserInfo()接口獲取用戶基本信息、encryptedData（用戶敏感信息加密數據）和 iv（加密算法的初始向量）

//1、調用微信登錄接口，獲取code
wx.login({
    success: function (r) {
        var code = r.code;//登錄憑證
        if (code) {
            //2、調用獲取用戶信息接口
            wx.getUserInfo({
                success: function (res) {
                    console.log({encryptedData: res.encryptedData, iv: res.iv, code: code})
                    //3.解密用戶信息 獲取unionId
                    //...
                },
                fail: function () {
                    console.log('獲取用戶信息失敗')
                }
            })
 
        } else {
            console.log('獲取用戶登錄態失敗！' + r.errMsg)
        }
    },
    fail: function () {
        callback(false)
    }
})

3、(客戶端)將前面獲取到的 code 、encryptedData、iv發送到自己的服務器（開發者服務器），通過自己的服務器（開發者服務器）解密獲取信息

//1、調用微信登錄接口，獲取code
wx.login({
    success: function (r) {
        var code = r.code;//登錄憑證
        if (code) {
            //2、調用獲取用戶信息接口
            wx.getUserInfo({
                success: function (res) {
                    console.log({encryptedData: res.encryptedData, iv: res.iv, code: code})
                    //3.請求自己的服務器，解密用戶信息 獲取unionId等加密信息
                    wx.request({
                        url: 'https://xxxx.com/wxsp/decodeUserInfo',//自己的服務接口地址
                        method: 'post',
                        header: {
                            'content-type': 'application/x-www-form-urlencoded'
                        },
                        data: {encryptedData: res.encryptedData, iv: res.iv, code: code},
                        success: function (data) {
 
                            //4.解密成功後 獲取自己服務器返回的結果
                            if (data.data.status == 1) {
                                var userInfo_ = data.data.userInfo;
                                console.log(userInfo_)
                            } else {
                                console.log('解密失敗')
                            }
 
                        },
                        fail: function () {
                            console.log('系統錯誤')
                        }
                    })
                },
                fail: function () {
                    console.log('獲取用戶信息失敗')
                }
            })
 
        } else {
            console.log('獲取用戶登錄態失敗！' + r.errMsg)
        }
    },
    fail: function () {
         console.log('登陸失敗')
    }
})

4、（服務端 java）自己的服務器發送code到微信服務器獲取openid（用戶唯一標識）和session_key（會話密鑰），最後將encryptedData、iv、session_key通過AES解密獲取到用戶敏感數據

a、獲取祕鑰並處理解密的controller（這裏用的是springMVC）

/**
     * 解密用戶敏感數據
     *
     * @param encryptedData 明文,加密數據
     * @param iv            加密算法的初始向量
     * @param code          用戶允許登錄後，回調內容會帶上 code（有效期五分鐘），開發者需要將 code 發送到開發者服務器後臺，使用code 換取 session_key api，將 code 換成 openid 和 session_key
     * @return
     */
    @ResponseBody
    @RequestMapping(value = "/decodeUserInfo", method = RequestMethod.POST)
    public Map decodeUserInfo(String encryptedData, String iv, String code) {
 
        Map map = new HashMap();
 
        //登錄憑證不能爲空
        if (code == null || code.length() == 0) {
            map.put("status", 0);
            map.put("msg", "code 不能爲空");
            return map;
        }
 
        //小程序唯一標識   (在微信小程序管理後臺獲取)
        String wxspAppid = "xxxxxxxxxxxxxx";
        //小程序的 app secret (在微信小程序管理後臺獲取)
        String wxspSecret = "xxxxxxxxxxxxxx";
        //授權（必填）
        String grant_type = "authorization_code";
 
 
        //////////////// 1、向微信服務器 使用登錄憑證 code 獲取 session_key 和 openid ////////////////
        //請求參數
        String params = "appid=" + wxspAppid + "&secret=" + wxspSecret + "&js_code=" + code + "&grant_type=" + grant_type;
        //發送請求
        String sr = HttpRequest.sendGet("https://api.weixin.qq.com/sns/jscode2session", params);
        //解析相應內容（轉換成json對象）
        JSONObject json = JSONObject.fromObject(sr);
        //獲取會話密鑰（session_key）
        String session_key = json.get("session_key").toString();
        //用戶的唯一標識（openid）
        String openid = (String) json.get("openid");
 
        //////////////// 2、對encryptedData加密數據進行AES解密 ////////////////
        try {
            String result = AesCbcUtil.decrypt(encryptedData, session_key, iv, "UTF-8");
            if (null != result && result.length() > 0) {
                map.put("status", 1);
                map.put("msg", "解密成功");
 
                JSONObject userInfoJSON = JSONObject.fromObject(result);
                Map userInfo = new HashMap();
                userInfo.put("openId", userInfoJSON.get("openId"));
                userInfo.put("nickName", userInfoJSON.get("nickName"));
                userInfo.put("gender", userInfoJSON.get("gender"));
                userInfo.put("city", userInfoJSON.get("city"));
                userInfo.put("province", userInfoJSON.get("province"));
                userInfo.put("country", userInfoJSON.get("country"));
                userInfo.put("avatarUrl", userInfoJSON.get("avatarUrl"));
                userInfo.put("unionId", userInfoJSON.get("unionId"));
                map.put("userInfo", userInfo);
                return map;
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        map.put("status", 0);
        map.put("msg", "解密失敗");
        return map;
    }

b、AesCbcUtil.java 工具類

package com.yfs.util;
 
import org.apache.commons.codec.binary.Base64;
import org.bouncycastle.jce.provider.BouncyCastleProvider;
 
import javax.crypto.BadPaddingException;
import javax.crypto.Cipher;
import javax.crypto.IllegalBlockSizeException;
import javax.crypto.NoSuchPaddingException;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.io.UnsupportedEncodingException;
import java.security.*;
import java.security.spec.InvalidParameterSpecException;
 
/**
 * Created by yfs on 2017/2/6.
 * <p>
 * AES-128-CBC 加密方式
 * 注：
 * AES-128-CBC可以自己定義“密鑰”和“偏移量“。
 * AES-128是jdk自動生成的“密鑰”。
 */
public class AesCbcUtil {
 
 
    static {
        //BouncyCastle是一個開源的加解密解決方案，主頁在http://www.bouncycastle.org/
        Security.addProvider(new BouncyCastleProvider());
    }
 
    /**
     * AES解密
     *
     * @param data           //密文，被加密的數據
     * @param key            //祕鑰
     * @param iv             //偏移量
     * @param encodingFormat //解密後的結果需要進行的編碼
     * @return
     * @throws Exception
     */
    public static String decrypt(String data, String key, String iv, String encodingFormat) throws Exception {
//        initialize();
 
        //被加密的數據
        byte[] dataByte = Base64.decodeBase64(data);
        //加密祕鑰
        byte[] keyByte = Base64.decodeBase64(key);
        //偏移量
        byte[] ivByte = Base64.decodeBase64(iv);
 
 
        try {
            Cipher cipher = Cipher.getInstance("AES/CBC/PKCS7Padding");
 
            SecretKeySpec spec = new SecretKeySpec(keyByte, "AES");
 
            AlgorithmParameters parameters = AlgorithmParameters.getInstance("AES");
            parameters.init(new IvParameterSpec(ivByte));
 
            cipher.init(Cipher.DECRYPT_MODE, spec, parameters);// 初始化
 
            byte[] resultByte = cipher.doFinal(dataByte);
            if (null != resultByte && resultByte.length > 0) {
                String result = new String(resultByte, encodingFormat);
                return result;
            }
            return null;
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        } catch (NoSuchPaddingException e) {
            e.printStackTrace();
        } catch (InvalidParameterSpecException e) {
            e.printStackTrace();
        } catch (InvalidKeyException e) {
            e.printStackTrace();
        } catch (InvalidAlgorithmParameterException e) {
            e.printStackTrace();
        } catch (IllegalBlockSizeException e) {
            e.printStackTrace();
        } catch (BadPaddingException e) {
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
 
        return null;
    }
 
}

c、HttpRequest.java 工具類

package com.yfs.util;
 
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.PrintWriter;
import java.net.URL;
import java.net.URLConnection;
import java.util.List;
import java.util.Map;
 
public class HttpRequest {
 
    public static void main(String[] args) {
        //發送 GET 請求
        String s=HttpRequest.sendGet("http://v.qq.com/x/cover/kvehb7okfxqstmc.html?vid=e01957zem6o", "");
        System.out.println(s);
 
//        //發送 POST 請求
//        String sr=HttpRequest.sendPost("http://www.toutiao.com/stream/widget/local_weather/data/?city=%E4%B8%8A%E6%B5%B7", "");
//        JSONObject json = JSONObject.fromObject(sr);
//        System.out.println(json.get("data"));
    }
 
    /**
     * 向指定URL發送GET方法的請求
     * 
     * @param url
     *            發送請求的URL
     * @param param
     *            請求參數，請求參數應該是 name1=value1&name2=value2 的形式。
     * @return URL 所代表遠程資源的響應結果
     */
    public static String sendGet(String url, String param) {
        String result = "";
        BufferedReader in = null;
        try {
            String urlNameString = url + "?" + param;
            URL realUrl = new URL(urlNameString);
            // 打開和URL之間的連接
            URLConnection connection = realUrl.openConnection();
            // 設置通用的請求屬性
            connection.setRequestProperty("accept", "*/*");
            connection.setRequestProperty("connection", "Keep-Alive");
            connection.setRequestProperty("user-agent",
                    "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
            // 建立實際的連接
            connection.connect();
            // 獲取所有響應頭字段
            Map<String, List<String>> map = connection.getHeaderFields();
            // 遍歷所有的響應頭字段
            for (String key : map.keySet()) {
                System.out.println(key + "--->" + map.get(key));
            }
            // 定義 BufferedReader輸入流來讀取URL的響應
            in = new BufferedReader(new InputStreamReader(
                    connection.getInputStream()));
            String line;
            while ((line = in.readLine()) != null) {
                result += line;
            }
        } catch (Exception e) {
            System.out.println("發送GET請求出現異常！" + e);
            e.printStackTrace();
        }
        // 使用finally塊來關閉輸入流
        finally {
            try {
                if (in != null) {
                    in.close();
                }
            } catch (Exception e2) {
                e2.printStackTrace();
            }
        }
        return result;
    }
 
    /**
     * 向指定 URL 發送POST方法的請求
     * 
     * @param url
     *            發送請求的 URL
     * @param param
     *            請求參數，請求參數應該是 name1=value1&name2=value2 的形式。
     * @return 所代表遠程資源的響應結果
     */
    public static String sendPost(String url, String param) {
        PrintWriter out = null;
        BufferedReader in = null;
        String result = "";
        try {
            URL realUrl = new URL(url);
            // 打開和URL之間的連接
            URLConnection conn = realUrl.openConnection();
            // 設置通用的請求屬性
            conn.setRequestProperty("accept", "*/*");
            conn.setRequestProperty("connection", "Keep-Alive");
            conn.setRequestProperty("user-agent",
                    "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
            // 發送POST請求必須設置如下兩行
            conn.setDoOutput(true);
            conn.setDoInput(true);
            // 獲取URLConnection對象對應的輸出流
            out = new PrintWriter(conn.getOutputStream());
            // 發送請求參數
            out.print(param);
            // flush輸出流的緩衝
            out.flush();
            // 定義BufferedReader輸入流來讀取URL的響應
            in = new BufferedReader(
                    new InputStreamReader(conn.getInputStream()));
            String line;
            while ((line = in.readLine()) != null) {
                result += line;
            }
        } catch (Exception e) {
            System.out.println("發送 POST 請求出現異常！"+e);
            e.printStackTrace();
        }
        //使用finally塊來關閉輸出流、輸入流
        finally{
            try{
                if(out!=null){
                    out.close();
                }
                if(in!=null){
                    in.close();
                }
            }
            catch(IOException ex){
                ex.printStackTrace();
            }
        }
        return result;
    }    
}

備註
代碼中需要用到的jar包，請自行下載並添加到項目中。
這裏需要注意的是，AES解密的時候需要用到javax.crypto.*包的類，在jdk的 jce.jar中提供，是jdk自帶的庫。如果是MAVEN項目，則需要在pom.xml文件中配置指定編譯路徑jce.jar
在bootclasspath中添加jce.jar的地址： ${JAVA_HOME}/jre/lib/rt.jar:$ {JAVA_HOME}/jre/lib/jce.jar ，注意rt.jar 和 jce.jar 間以:號連接，如：

<build>
  <finalName>com.yfs.app</finalName>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>2.5.1</version>
      <configuration>
        <source>1.7</source>
        <target>1.7</target>
        <compilerArguments>
          <verbose />
          <bootclasspath>${JAVA_HOME}/jre/lib/rt.jar:${JAVA_HOME}/jre/lib/jce.jar</bootclasspath>
        </compilerArguments>
        <encoding>utf-8</encoding>
      </configuration>
    </plugin>
 
  </plugins>
</build>

總結
好了，總算完成數據解密了，接下來對接新的或已有的用戶系統都妥妥的。

有一點需要注意的是，要對接已有的用戶系統可能需要用到unionId，如果通過以上方法獲取不到unionId，那麼你就要去檢查一下你的微信開放平臺(https://open.weixin.qq.com)是否有綁定微信小程序咯~



前段時間剛做完微信小程序的項目，之間遇到的一些問題會陸續發佈，歡迎大家一起來探討。

微信小程序之獲取並解密用戶數據（獲取 openId、unionId）

Nginx R31 doc 官方文檔-01-nginx 如何安裝

挑戰程序設計競賽 2.2章習題 POJ - 3617 Best Cow Line 貪心

golang開發環境搭建(win10)

微信小程序之獲取並解密用戶數據（獲取 openId、unionId）

Java高併發情況下的鎖機制優化

推薦，Java Emoji Converter（Emoji表情轉換工具）

log4j重定向stdout和stderr到log文件

pdf.js預覽pdf文件流（base64）親測可用

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結