天天看點

微信JS-SDK擷取signature簽名以及config配置

微信的JS-SDK通過config接口注入權限驗證配置,官網上的文檔說的很清楚:

wx.config({
    debug: true, // 開啟調試模式,調用的所有api的傳回值會在用戶端alert出來,若要檢視傳入的參數,可以在pc端打開,參數資訊會通過log打出,僅在pc端時才會列印。
    appId: '', // 必填,公衆号的唯一辨別
    timestamp: , // 必填,生成簽名的時間戳
    nonceStr: '', // 必填,生成簽名的随機串
    signature: '',// 必填,簽名,見附錄1
    jsApiList: [] // 必填,需要使用的JS接口清單,所有JS接口清單見附錄2
});      

 上面的幾個參數,對于像我這樣子的初學者而言,不簡單,是以在弄這塊的時候沒少碰釘子,這裡說一下。

先說那個最煩人的signature,官網附錄1是這麼說的:

-------------------------------------------------------------------------------------------------------------------------------------

jsapi_ticket

生成簽名之前必須先了解一下jsapi_ticket,jsapi_ticket是公衆号用于調用微信JS接口的臨時票據。正常情況下,jsapi_ticket的有效期為7200秒,通過access_token來擷取。由于擷取jsapi_ticket的api調用次數非常有限,頻繁重新整理jsapi_ticket會導緻api調用受限,影響自身業務,開發者必須在自己的服務全局緩存jsapi_ticket 。

1、參考以下文檔擷取access_token(有效期7200秒,開發者必須在自己的服務全局緩存access_token):../15/54ce45d8d30b6bf6758f68d2e95bc627.html

2、用第一步拿到的access_token 采用http GET方式請求獲得jsapi_ticket(有效期7200秒,開發者必須在自己的服務全局緩存jsapi_ticket):https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi

成功傳回如下JSON:

{
"errcode":0,
"errmsg":"ok",
"ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",
"expires_in":7200
}      

 獲得jsapi_ticket之後,就可以生成JS-SDK權限驗證的簽名了。

簽名算法

簽名生成規則如下:參與簽名的字段包括noncestr(随機字元串), 有效的jsapi_ticket, timestamp(時間戳), url(目前網頁的URL,不包含#及其後面部分) 。對所有待簽名參數按照字段名的ASCII 碼從小到大排序(字典序)後,使用URL鍵值對的格式(即key1=value1&key2=value2…)拼接成字元串string1。這裡 需要注意的是所有參數名均為小寫字元。對string1作sha1加密,字段名和字段值都采用原始值,不進行URL 轉義。

即signature=sha1(string1)。 示例:

  • noncestr=Wm3WZYTPz0wzccnW
  • jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg
  • timestamp=1414587457
  • url=http://mp.weixin.qq.com?params=value

步驟1. 對所有待簽名參數按照字段名的ASCII 碼從小到大排序(字典序)後,使用URL鍵值對的格式(即key1=value1&key2=value2…)拼接成字元串string1:

jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW&timestamp=1414587457&url=http://mp.weixin.qq.com?params=value

步驟2. 對string1進行sha1簽名,得到signature:

0f9de62fce790f9a083d5c99e95740ceb90c27ed

注意事項:

1、簽名用的noncestr和timestamp必須與wx.config中的nonceStr和timestamp相同。

2、簽名用的url必須是調用JS接口頁面的完整URL。

3、出于安全考慮,開發者必須在伺服器端實作簽名的邏輯。

-------------------------------------------------------------------------------------------------------------------------------------

以上的東西加起來就是四步:

1、使用APPID和APPSecret擷取access_token;

2、使用access_token擷取jsapi_ticket ;

3、用時間戳、随機數、jsapi_ticket和要通路的url按照簽名算法拼接字元串;

4、對第三步的字元串進行SHA1加密,得到簽名。

第一步、擷取access_token

這裡是官網的說法,可以看看。

以下是我的代碼實作:

public static String getAccessToken() {
    String access_token = "";
    String grant_type = "client_credential";//擷取access_token填寫client_credential 
    String AppId="APPID";//第三方使用者唯一憑證
    String secret="APPSECRET";//第三方使用者唯一憑證密鑰,即appsecret 
    //這個url連結位址和參數皆不能變
    String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type="+grant_type+"&appid="+AppId+"&secret="+secret;
     
    try {
        URL urlGet = new URL(url);
        HttpURLConnection http = (HttpURLConnection) urlGet.openConnection();
        http.setRequestMethod("GET"); // 必須是get方式請求
        http.setRequestProperty("Content-Type","application/x-www-form-urlencoded");
        http.setDoOutput(true);
        http.setDoInput(true);
        System.setProperty("sun.net.client.defaultConnectTimeout", "30000");// 連接配接逾時30秒
        System.setProperty("sun.net.client.defaultReadTimeout", "30000"); // 讀取逾時30秒
        http.connect();
        InputStream is = http.getInputStream();
        int size = is.available();
        byte[] jsonBytes = new byte[size];
        is.read(jsonBytes);
        String message = new String(jsonBytes, "UTF-8");
        JSONObject demoJson = JSONObject.fromObject(message);
        System.out.println("JSON字元串:"+demoJson);
        access_token = demoJson.getString("access_token");
        is.close();
    } catch (Exception e) {
            e.printStackTrace();
    }
    return access_token;
}
           

APPID和APPSECRET可以去微信公衆平台---“開發----基本配置”中查找。

第二步、擷取jsapi_ticket

public static String getTicket(String access_token) {
    String ticket = null;
    String url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token="+ access_token +"&type=jsapi";//這個url連結和參數不能變
    try {
        URL urlGet = new URL(url);
        HttpURLConnection http = (HttpURLConnection) urlGet.openConnection();
        http.setRequestMethod("GET"); // 必須是get方式請求
        http.setRequestProperty("Content-Type","application/x-www-form-urlencoded");
        http.setDoOutput(true);
        http.setDoInput(true);
        System.setProperty("sun.net.client.defaultConnectTimeout", "30000");// 連接配接逾時30秒
        System.setProperty("sun.net.client.defaultReadTimeout", "30000"); // 讀取逾時30秒
        http.connect();
        InputStream is = http.getInputStream();
        int size = is.available();
        byte[] jsonBytes = new byte[size];
        is.read(jsonBytes);
        String message = new String(jsonBytes, "UTF-8");
        JSONObject demoJson = JSONObject.fromObject(message);
        System.out.println("JSON字元串:"+demoJson);
        ticket = demoJson.getString("ticket");
        is.close();
    } catch (Exception e) {
            e.printStackTrace();
    }
    return ticket;
}
           

拿到了jsapi_ticket之後就要參數名排序和拼接字元串,并加密了。以下為sha1的加密算法:

public static String SHA1(String decript) {
    try {
        MessageDigest digest = java.security.MessageDigest.getInstance("SHA-1");
        digest.update(decript.getBytes());
        byte messageDigest[] = digest.digest();
        // Create Hex String
        StringBuffer hexString = new StringBuffer();
        // 位元組數組轉換為 十六進制 數
            for (int i = 0; i < messageDigest.length; i++) {
                String shaHex = Integer.toHexString(messageDigest[i] & 0xFF);
                if (shaHex.length() < 2) {
                    hexString.append(0);
                }
                hexString.append(shaHex);
            }
            return hexString.toString();
 
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        }
        return "";
}
           

加密算法轉載自:http://www.open-open.com/lib/view/open1392185662160.html

擷取簽名:

public static void main(String[] args) {
	//1、擷取AccessToken
	String accessToken = getAccessToken();
	
	//2、擷取Ticket
	String jsapi_ticket = getTicket(accessToken);
	
	//3、時間戳和随機字元串
	String noncestr = UUID.randomUUID().toString().replace("-", "").substring(0, 16);//随機字元串
    String timestamp = String.valueOf(System.currentTimeMillis() / 1000);//時間戳
    
    System.out.println("accessToken:"+accessToken+"\njsapi_ticket:"+jsapi_ticket+"\n時間戳:"+timestamp+"\n随機字元串:"+noncestr);
    
    //4、擷取url
    String url="http://www.luiyang.com/add.html";
    /*根據JSSDK上面的規則進行計算,這裡比較簡單,我就手動寫啦
    String[] ArrTmp = {"jsapi_ticket","timestamp","nonce","url"};
    Arrays.sort(ArrTmp);
    StringBuffer sf = new StringBuffer();
    for(int i=0;i<ArrTmp.length;i++){
    	sf.append(ArrTmp[i]);
    }
    */
    
    //5、将參數排序并拼接字元串
    String str = "jsapi_ticket="+jsapi_ticket+"&noncestr="+noncestr+"&timestamp="+timestamp+"&url="+url;
   
    //6、将字元串進行sha1加密
    String signature =SHA1(str);
    System.out.println("參數:"+str+"\n簽名:"+signature);
}
           

 該要的都有了,再次回到最開始的config配置,此時應該為:

wx.config({
    debug: true, //調試階段建議開啟
    appId: "APPID",//APPID
    timestamp: "timestamp",//上面main方法中拿到的時間戳timestamp
    nonceStr: "nonceStr",//上面main方法中拿到的随機數nonceStr
    signature: "signature",//上面main方法中拿到的簽名signature
    jsApiList: [
           //所有要調用的 API 都要加到這個清單中
          "chooseImage"//從本地的相冊、圖庫選擇圖檔
    ]
});      

 以上的時間戳、随機數、簽名一定要跟main方法中擷取到的一緻,否則會報invalid signature錯誤。

另外,這個簽名的有效時間為7200秒,也就是2個小時,是以當超過兩個小時候,再通路也會報invalid signature錯誤。

另外還有一個錯誤:invalid url domain

這個跟生成簽名時用的url有關系,官網的說法是:

invalid url domain目前頁面所在域名與使用的appid沒有綁定,請确認正确填寫綁定的域名,如果使用了端口号,則配置的綁定域名也要加上端口号(一個appid可以綁定三個有效域名)

這個url必須是:“公衆号設定---功能設定----JS接口安全域名”中綁定的三個域名之一

若是以上的配置沒有問題,且dubug也設定為了true,那麼再通路的時候,就會出現一個config:ok,這就說明配置成功了。