ASP.NET MVC 微信JS-SDK認證

layout: post

title: ASP.NET MVC 微信JS-SDK認證

category: .net

date: 2016-11-01 00:00:00

tags:

.net
javascript

寫在前面

前陣子因為有個項目需要做微信自定義分享功能，因而去研究了下微信JS-SDK相關知識。

此文做個簡單的記(tu)錄(cao)...

開始

所有的東西都從文檔開始:微信JSSDK說明文檔

項目需要用到的是分享接口不過使用微信JS-SDK之前，需要做JS接口認證。

認證如下：

步驟一：綁定域名

步驟二：引入JS檔案

步驟三：通過config接口注入權限驗證配置

步驟四：通過ready接口處理成功驗證

步驟五：通過error接口處理失敗驗證

步驟一中允許使用域名/子域名，隻要xx.com/xxx.txt或者xx.com/mp/xxx.txt能通路就好。域名認證通過之後，此域名下的所有端口的網站都可以使用JS-SDK。

步驟二沒什麼問題，略過。

步驟三最磨人，下面單獨講解。

config接口注入權限驗證配置

先來一段說明：

所有需要使用JS-SDK的頁面必須先注入配置資訊，否則将無法調用
（同一個url僅需調用一次，對于變化url的SPA的web app可在每次url變化時進行調用,
目前Android微信用戶端不支援pushState的H5新特性，
是以使用pushState來實作web app的頁面會導緻簽名失敗，此問題會在Android6.2中修複）。

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

看到這裡肯定懵逼了，這是都什麼鬼...怎麼玩啊。

提示我們去看附錄1...看完之後總結如下：

使用config接口注入權限驗證配置，重點是生成合法的signatrue
生成signature需要通過appid和secret擷取token
時間戳和調用接口URL必不可少
此操作需要服務端完成，不能使用用戶端實作

整個過程變成：

通過appid和secret擷取access_token，接着使用token擷取jsapi_ticket；
拿到jsapi_ticket之後，把jsapi_ticket、時間戳、随機字元串、接口調用頁面URL 拼接成完整字元串，使用sha1算法加密得到signature。
最後傳回至頁面，在wx.config裡面填入appid，上一步的時間戳timestamp，上一部的随機字元串、sha1拿到的signature，想要使用的JS接口。

廢話少說，直接上代碼吧。

代碼時間

public class WeiXinController : Controller
    {
        public static readonly string appid =
        System.Web.Configuration.WebConfigurationManager.AppSettings["wxappid"];

        public static readonly string secret =
        System.Web.Configuration.WebConfigurationManager.AppSettings["wxsecret"];

        public static readonly bool isDedug =
        System.Web.Configuration.WebConfigurationManager.AppSettings["IsDebug"] =="true";


        public static string _ticket = "";

        public static DateTime _lastTimestamp;


        public ActionResult Info(string url,string noncestr)
        {
            if (string.IsNullOrEmpty(_ticket) || 
            _lastTimestamp == null || (_lastTimestamp - DateTime.Now).Milliseconds > 7200)
            {
                var resultString = HTTPHelper.GetHTMLByURL("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid="
                    + appid + "&secret=" + secret);
                dynamic resultValue = JsonConvert.DeserializeObject<dynamic>(resultString);
                if (resultValue == null || resultValue.access_token == null 
                || resultValue.access_token.Value == null)
                {
                    return Json(new { issuccess = false, 
                    error = "擷取token失敗" });
                }
                var token = resultValue.access_token.Value;

                resultString = HTTPHelper.GetHTMLByURL
                ("https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=" + 
                token + "&type=jsapi");
                dynamic ticketValue = JsonConvert.DeserializeObject<dynamic>(resultString);
                if (ticketValue == null || ticketValue.errcode == null
                || ticketValue.errcode.Value != 0 || ticketValue.ticket == null)
                    return Json(new { issuccess = false,
                    error = "擷取ticketValue失敗" });
                _ticket = ticketValue.ticket.Value;
                _lastTimestamp = DateTime.Now;
                var timestamp = GetTimeStamp();
                var hexString = string.Format("jsapi_ticket={0}&noncestr={3}&timestamp={1}&url={2}",
                _ticket, timestamp, url,noncestr);

                return Json(new {
                    issuccess = true, 
                    sha1value = GetSHA1Value(hexString), 
                    timestamp = timestamp, 
                    url = url, 
                    appid = appid, 
                    debug=isDedug,
                    tiket=_ticket
                });
                
            }
            else
            {
                var timestamp = GetTimeStamp();
                var hexString = string.Format("jsapi_ticket={0}&noncestr=1234567890123456&timestamp={1}&url={2}",
                   _ticket, timestamp, url);
                return Json(new { 
                    issuccess = true, sha1value = GetSHA1Value(hexString),
                    timestamp = timestamp, url = url,
                    appid = appid, debug = isDedug,tiket = _ticket
                });
            }
        }


        private string GetSHA1Value(string sourceString)
        {
            var hash = SHA1.Create().ComputeHash(Encoding.UTF8.GetBytes(sourceString));
            return string.Join("", 
            hash.Select(b => b.ToString("x2")).ToArray());
        }

        private static string GetTimeStamp()
        {

            TimeSpan ts = DateTime.Now - new DateTime(1970, 1, 1, 0, 0, 0, 0);

            return Convert.ToInt64(ts.TotalSeconds).ToString();

        }

    }
    
    
    
    
    public class HTTPHelper
    {
        public static string GetHTMLByURL(string url)
        {
            string htmlCode = string.Empty;
            try
            {
                HttpWebRequest webRequest = (System.Net.HttpWebRequest)System.Net.WebRequest.Create(url);
                webRequest.Timeout = 30000;
                webRequest.Method = "GET";
                webRequest.UserAgent = "Mozilla/4.0";
                webRequest.Headers.Add("Accept-Encoding", "gzip, deflate");
                HttpWebResponse webResponse = (System.Net.HttpWebResponse)webRequest.GetResponse();
                //擷取目标網站的編碼格式
                string contentype = webResponse.Headers["Content-Type"];
                Regex regex = new Regex("charset\\s*=\\s*[\\W]?\\s*([\\w-]+)", RegexOptions.IgnoreCase);
                if (webResponse.ContentEncoding.ToLower() == "gzip")//如果使用了GZip則先解壓
                {
                    using (System.IO.Stream streamReceive = webResponse.GetResponseStream())
                    {
                        using (var zipStream = new System.IO.Compression.GZipStream(streamReceive, System.IO.Compression.CompressionMode.Decompress))
                        {
                            //比對編碼格式
                            if (regex.IsMatch(contentype))
                            {
                                Encoding ending = Encoding.GetEncoding
                                (regex.Match(contentype).Groups[1].Value.Trim());
                                using (StreamReader sr = new System.IO.StreamReader(zipStream, ending))
                                {
                                    htmlCode = sr.ReadToEnd();
                                }
                            }
                            else
                            {
                                using (StreamReader sr = new System.IO.StreamReader(zipStream, Encoding.UTF8))
                                {
                                    htmlCode = sr.ReadToEnd();
                                }
                            }
                        }
                    }
                }
                else
                {
                    using (System.IO.Stream streamReceive = webResponse.GetResponseStream())
                    {
                        var encoding = Encoding.Default;
                        if (contentype.Contains("utf"))
                            encoding = Encoding.UTF8;
                        using (System.IO.StreamReader sr = new System.IO.StreamReader(streamReceive, encoding))
                        {
                            htmlCode = sr.ReadToEnd();
                        }

                    }
                }
                return htmlCode;
            }
            catch (Exception ex)
            {
                return "";
            }
        }
    }

PS：這裡要注意緩存一下_ticket（即access_token），照微信文檔說的，access_token兩個小時内有效，不需要頻繁調用。而且擷取access_token的接口有調用次數的限制，如果超過了次數，就不允許調用了。

PPS:建議noncestr和URL由前台傳入比較适合，使用 var theWebUrl = window.location.href.split('#')[0] 擷取URL，noncestr就随意了。

PPPS:遇到詭異的invalid signature的時候，首先檢查url參數，然後檢查noncestr，再不行重新開機一下程式擷取一個新的token回來繼續玩。

PPPPS：成果在這裡，SNH48解救行動（流量預警：HTML5遊戲，預計獲得-15M+流量，非wifi條件祝好運。）。微信打開，直接分享或者完成遊戲之後分享都可以看到自定義分享内容。

完整代碼：liguobao/WeixinAPI · GitHub（測試前記得把web.config裡面的appid和wxsecret改成自己的）

ASP.NET MVC 微信JS-SDK認證

寫在前面

開始

config接口注入權限驗證配置

代碼時間

繼續閱讀

Asp.net MVC3 自定義HtmlHelper控件

[ASP.NET MVC ]13 - Helper Method自定義 Helper Method字元串編碼問題表單元素 Helper Method模闆化的 Helper Method自定義 Helper Method 模闆

asp.net mvc htmlhelper擴充

ASP.NET MVC 上傳附件

asp.net檢測是否為移動裝置

asp.net 使用redis緩存（二）

＜httpHandlers＞的配置和使用

ASP.NET-MVC-Razor引擎的使用

ASP.NET MVC小記

ASP.NET MVC 系列之 (依賴注入(DI)和Ninject) 為什麼需要依賴注入什麼是依賴注入使用NuGet安裝庫使用Ninject的一般步驟 Ninject如何提高編碼效率 Ninject的綁定方式在ASP.NET MVC中使用Ninject

asp.net MVC中使用JQuery插件

asp.net mvc　設定啟動頁面在區域中

Html.AntiForgeryToken() 防止CSRF攻擊的AJaX應用

asp.net 用戶端驗證前端頁面無效

基于Web窗體的Web應用程式的優勢

無法将類型為“System.Int32”的對象強制轉換為類型“System.String”“/”應用程式中的伺服器錯誤。