萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET MVC 微信公眾平台:以 ActionFilter 驗證請求真實性

微信伺服器首次接入時會發送 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);
}

三、ActionFilter 實作

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

在需處理微信請求的 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

若專案需接入多個公眾號,可將 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 集中驗證,不僅程式碼乾淨,也能確保所有微信入口均受保護,避免偽造請求造成資安風險。

copyright © 萬盛學電腦網 all rights reserved