接入微信公衆平臺
驗證消息是否來自於微信服務器
開發者提交信息後,微信服務器將發送GET請求到填寫的服務器地址URL上,GET請求攜帶參數如下表所示:
參數 | 概述 |
---|---|
signature | 微信加密簽名,signature結合了開發者填寫的token參數和請求中的timestamp參數、nonce參數。 |
timestamp | 時間戳 |
nonce | 隨機數 |
echostr | 隨機字符串 |
開發者通過檢驗signature對請求進行校驗(下面有校驗方式)。若確認此次GET請求來自微信服務器,請原樣返回echostr參數內容,則接入生效,成爲開發者成功,否則接入失敗。加密/校驗流程如下:
1)將token、timestamp、nonce三個參數進行字典序排序
2)將三個參數字符串拼接成一個字符串進行sha1加密
3)開發者獲得加密後的字符串可與signature對比,標識該請求來源於微信
新建一個Java web工程創建一個Servlet
package org.sm.servlet;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.sm.util.SignUtil;
/**
* 核心請求處理類
*
* @author sunming
* @date 2017-08-1
*/
public class ServiceServlet extends HttpServlet {
private static final long serialVersionUID = 2844745299238798077L;
/**
* 確認請求來自微信服務器
*/
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 微信加密簽名
String signature = request.getParameter("signature");
// 時間戳
String timestamp = request.getParameter("timestamp");
// 隨機數
String nonce = request.getParameter("nonce");
// 隨機字符串
String echostr = request.getParameter("echostr");
PrintWriter out = response.getWriter();
// 通過檢驗signature對請求進行校驗,若校驗成功則原樣返回echostr,表示接入成功,否則接入失敗
if (SignUtil.checkSignature(signature, timestamp, nonce)) {
out.print(echostr);
System.out.println("恭喜連接成功..");
}
out.close();
out = null;
}
/**
* 處理微信服務器發來的消息
*/
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// do some things
}
}
Servlet中用到的SignUtil工具類
package org.sm.util;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/**
* 請求校驗工具類
*
* @author sunming
* @date 2017-08-1
*/
public class SignUtil {
// 與接口配置信息中的Token要一致
private static String token = "weixintoken";
/**
* 驗證簽名
*
* @param signature
* 微信加密簽名
* @param timestamp
* 時間戳
* @param nonce
* 隨機數
* @return
*/
public static boolean checkSignature(String signature, String timestamp, String nonce) {
List<String> list = new ArrayList();
list.add(token);
list.add(timestamp);
list.add(nonce);
Collections.sort(list);
StringBuilder content = new StringBuilder();
for (String param : list) {
content.append(param);
}
MessageDigest md = null;
String tmpStr = null;
try {
md = MessageDigest.getInstance("SHA-1");
// 將三個參數字符串拼接成一個字符串進行sha1加密
byte[] digest = md.digest(content.toString().getBytes());
tmpStr = byteToStr(digest);
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
}
content = null;
// 將sha1加密後的字符串可與signature對比,標識該請求來源於微信
return tmpStr != null ? tmpStr.equals(signature.toUpperCase()) : false;
}
/**
* 將字節數組轉換爲十六進制字符串
*
* @param byteArray
* @return
*/
private static String byteToStr(byte[] byteArray) {
String strDigest = "";
for (int i = 0; i < byteArray.length; i++) {
strDigest += byteToHexStr(byteArray[i]);
}
return strDigest;
}
/**
* 將字節轉換爲十六進制字符串
*
* @param mByte
* @return
*/
private static String byteToHexStr(byte mByte) {
char[] Digit = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
char[] tempArr = new char[2];
tempArr[0] = Digit[(mByte >>> 4) & 0X0F];
tempArr[1] = Digit[mByte & 0X0F];
String s = new String(tempArr);
return s;
}
}
web.xml中配置
<servlet>
<servlet-name>serviceServlet</servlet-name>
<servlet-class>
org.sm.servlet.ServiceServlet
</servlet-class>
</servlet>
<!-- url-pattern中配置的/coreServlet用於指定該Servlet的訪問路徑 -->
<servlet-mapping>
<servlet-name>serviceServlet</servlet-name>
<url-pattern>/serviceServlet</url-pattern>
</servlet-mapping>
整個項目結構
將項目部署到tomcat中,啓動服務器。
二.內網穿透
tomcat服務器啓動了,回頭再看下微信公衆平臺服務器配置
其中token就是咱請求校驗工具類SignUtil中定義的token,EncodingAESKey是隨機生成的,主要看下URL。咱們的項目是起在本地的想要在外網上訪問怎麼辦呢那就需要用到內網穿透工具,我用的是ngrok,使用很簡單,將工具下下來後解壓,在鼠標移到解壓路徑上敲“cmd”命令
然後敲入 ngrok http tomcat端口號 就得到外網地址
URL由外網地址/項目名稱/指定Servlet的訪問路徑 組成。
修改配置提交成功之後,控制檯打印 恭喜連接成功.. 說明與接入微信公衆平臺成功瞭然後點擊啓用,下面的工作就是編寫咱們自己需要的業務。