ASP.NET MVC 微信JS-SDK認證
寫在前面
前陣子因為有個專案需要做微信自定義分享功能,因而去研究了下微信JS-SDK相關知識。
此文做個簡單的記(tu)錄(cao)…
開始
專案需要用到的是分享介面 不過使用微信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}×tamp={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×tamp={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回來繼續玩。
完整程式碼:liguobao/WeixinAPI · GitHub(測試前記得把web.config裡面的appid和wxsecret改成自己的)