微信伺服器首次接入時會發送 GET 請求驗證 URL 有效性,後續推送訊息則為 POST。兩者均攜帶 signature/msg_signature、timestamp、nonce 參數,需依 SHA1 演算法驗證簽名。本文示範在 ASP.NET MVC 中以 ActionFilterAttribute 統一攔截驗證,確保只有合法請求進入 Action。
區分驗證階段(GET)與訊息推送階段(POST)的參數名稱差異:
public class WeChatVerifyModel {
public string Signature { get; set; } // GET 參數名:signature
public string MsgSignature { get; set; } // POST 參數名:msg_signature
public string Timestamp { get; set; }
public string Nonce { get; set; }
public string Echostr { get; set; } // 僅 GET 驗證時存在
}
將 Token、Timestamp、Nonce 字典序排序拼接後 SHA1 雜湊,比對 Signature:
private bool CheckSignature(string token, string signature, string timestamp, string nonce) {
var arr = new[] { token, timestamp, nonce };
Array.Sort(arr);
string raw = string.Join("", arr);
string hash = FormsAuthentication.HashPasswordForStoringInConfigFile(raw, "SHA1").ToLower();
return hash.Equals(signature, StringComparison.OrdinalIgnoreCase);
}
public class WeChatRequestValidAttribute : ActionFilterAttribute {
private const string Token = "YourToken"; // 應從配置讀取
public override void OnActionExecuting(ActionExecutingContext filterContext) {
var request = filterContext.HttpContext.Request;
var model = new WeChatVerifyModel {
Signature = request.QueryString["signature"],
MsgSignature = request.QueryString["msg_signature"],
Timestamp = request.QueryString["timestamp"],
Nonce = request.QueryString["nonce"],
Echostr = request.QueryString["echostr"]
};
// GET 驗證階段:直接回傳 echostr
if (request.HttpMethod == "GET") {
if (CheckSignature(Token, model.Signature, model.Timestamp, model.Nonce)) {
filterContext.Result = new ContentResult { Content = model.Echostr };
} else {
filterContext.Result = new HttpStatusCodeResult(403, "簽名驗證失敗");
}
return;
}
// POST 訊息階段:驗證 msg_signature
if (request.HttpMethod == "POST") {
if (!CheckSignature(Token, model.MsgSignature, model.Timestamp, model.Nonce)) {
filterContext.Result = new HttpStatusCodeResult(403, "訊息簽名驗證失敗");
}
}
}
}
在需處理微信請求的 Controller 或 Action 標註屬性:
[WeChatRequestValid]
public class WeChatController : Controller {
[HttpGet]
public ActionResult Index(WeChatVerifyModel model) {
// 驗證已由 Filter 完成,若通過這裡不會被執行(已短路回傳 echostr)
return new EmptyResult();
}
[HttpPost]
public ActionResult Index(WeChatVerifyModel model) {
// 此處 Request.InputStream 為明文或加密 XML,交由業務邏輯處理
return HandlePost(model);
}
}
若專案需接入多個公眾號,可將 Token 存於資料庫,依 URL 路由或查詢字串 appid 動態取得:
public class WeChatRequestValidAttribute : ActionFilterAttribute {
public override void OnActionExecuting(ActionExecutingContext filterContext) {
string appId = filterContext.HttpContext.Request.QueryString["appid"];
string token = TokenProvider.GetToken(appId); // 從快取/DB 取得
// ... 後續驗證邏輯使用動態 token
}
}
透過 ActionFilter 集中驗證,不僅程式碼乾淨,也能確保所有微信入口均受保護,避免偽造請求造成資安風險。