C#微信公众号开发系列教程二（新手接入指南）

2023-10-29 20:27:58

此系列前面已经更新了两篇博文了，都是微信开发的前期准备工作，现在切入正题，本篇讲解新手接入的步骤与方法，大神可直接跳过，也欢迎大神吐槽。

微信公众平台消息接口的工作原理大概可以这样理解：从用户端到公众号端一个流程是这样的，用户发送消息到微信服务器，微信服务器将接收到的消息post到用户接入时填写的url中，在url处理程序中，首先判断消息的合法性，判断成功后根据消息体的内容做相应的相应。原理很容易理解，接触过socket的可能理解起来更容易。

然而，微信的文档有的时候确实有点让人摸不着头脑，关于微信接入的文档写的确实不敢恭维啊。官方文档写的第一步是“申请消息接口”，这里是需要填写一个url的，此url用来处理微信发送的消息的，但微信把url中相关的配置写在了第二步，一不小心就把新手给坑了。下面我按照我的理解来进行解释。

首先，开发者在接入时，微信服务器将发送get请求到你填写的url上，此请求携带四个参数，分别signature（微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。），timestamp（时间戳），nonce（随机数），echostr(随机字符串).用 HttpContext.Current.Request.RawUrl可以获取当前请求的原始url，如下图所示：

开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。

加密/校验流程如下：
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信。

下面是代码实现。

首先，在你的处理程序中（我是新建了一个一般处理程序wx.ashx）,判断当前请求的类型，因为接入时，是发送的GET请求，消息处理是发送的POST请求。如下图：

这里我对验证url的方法进行封装。

/// <summary>
        /// 验证url权限， 接入服务器
        /// </summary>
        /// <param name="token"></param>
        /// <returns></returns>
        public static bool ValidUrl(string token)
        {
            string echoStr = VqiRequest.GetQueryString("echoStr");
            if (CheckSignature(token))
            {
                if (!string.IsNullOrEmpty(echoStr))
                {
                    Utils.ResponseWrite(echoStr);
                    return true;
                }

            }
            return false;
        }

/// <summary>
        /// 验证微信签名
        /// </summary>
        /// * 将token、timestamp、nonce三个参数进行字典序排序
        /// * 将三个参数字符串拼接成一个字符串进行sha1加密
        /// * 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信。
        /// <returns></returns>
        public static bool CheckSignature(string token)
        {
            string signature = VqiRequest.GetQueryString("signature");
            string timestamp = VqiRequest.GetQueryString("timestamp");
            string nonce = VqiRequest.GetQueryString("nonce");
            string[] ArrTmp = { token, timestamp, nonce };
            Array.Sort(ArrTmp);     //字典排序
            string tmpStr = string.Join("", ArrTmp);
            tmpStr = Utils.HashPasswordForStoringInConfigFile(tmpStr, "SHA1");
            tmpStr = tmpStr.ToLower();
            if (tmpStr == signature)
            {
                return true;
            }
            else
            {
                return false;
            }
        }

注：代码VqiRequest.GetQueryString是封装的QueryString请求的方法，使用的时候可以改成QueryString[“”]

处理过程如图：

将signature，timestamp，nonce三个参数放在数组中，

排序后的ArrTmp:

将三个将三个参数字符串拼接成一个字符串：

将tmpStr进行sha1加密，加密后的字符串转换成小写：

然后和签名进行对比，相同则表示验证成功。

验证成功将echoStr返回给微信。

/// <summary>
        /// 根据指定的密码和哈希算法生成一个适合于存储在配置文件中的哈希密码
        /// </summary>
        /// <param name="str">要进行哈希运算的密码</param>
        /// <param name="type"> 要使用的哈希算法</param>
        /// <returns>经过哈希运算的密码</returns>
        public static string HashPasswordForStoringInConfigFile(string str, string type)
        {
            return FormsAuthentication.HashPasswordForStoringInConfigFile(str, type);
        }

        public static void ResponseWrite(string str)
        {
            HttpContext.Current.Response.Write(str);
            HttpContext.Current.Response.End();
        }

处理程序编写完毕后，部署到iis（方法请参照教程一），登录微信管理后台https://mp.weixin.qq.com/在开发者中心页，点击“修改配置按钮”填写URL、Token和EncodingAESKey，其中URL是开发者用来接收微信服务器数据的接口URL。Token可由开发者可以任意填写，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性）。EncodingAESKey由开发者手动填写或随机生成，将用作消息体加解密密钥。同时，开发者可选择消息加解密方式：明文模式、兼容模式和安全模式。模式的选择与服务器配置在提交后都会立即生效。加解密方式的默认状态为明文模式。加解密模式将在后期的系列中与大家共享，敬请期待。

如图所示：

点击提交后，微信服务器将get请求到上文中编写的url中。验证成功，则绑定成功。

C#微信公众号开发系列教程二（新手接入指南）

码农公寓

相关文章