我们只要通过微信官方认证,成为开发者,才能实现微信提供的各种接口,否则即使调用了接口,微信也不会实现推送,功能也无法通过开发模式真正得到实现,所以需要正确配置微信信息,通过微信官方认证,成为开发者才可以进行下一步的接口开放。
一、客户端需要配置的信息
客户端配置微信信息的时候大概需要参数有:
序号 | 参数 | 说明 |
1 | URL | 验证开发者身份的url |
2 | token | 用于校验 |
3 | wechat_name | 微信号 |
4 | appid | 调用微信接口的凭证 |
5 | appsecret | 调用微信接口的凭证密钥 |
6 | wechat_originalid | 微信原始id |
7 | wechat_type | 微信类型(服务号,订阅号,企业号) |
8 | wechat_key | 为了安全起见,在url后面加的标示参数 |
这些信息都要保存到客户端中,所以我们创建数据库表字段的时候按照上面的参数即可,如下
CREATE TABLE [dbo].[w_wechat]( [wechat_id] [int] IDENTITY(1,1) NOT NULL, [wechat_name] [varchar](250) NULL, [wechat_key] [varchar](250) NULL, [wechat_url] [varchar](250) NULL, [wechat_token] [varchar](250) NULL, [wechat_appid] [varchar](250) NULL, [wechat_appsecret] [varchar](250) NULL, [wechat_originalid] [varchar](250) NULL, [wechat_addtime] [datetime] NULL, [wechat_isdel] [int] NULL, [wechat_stutas] [int] NULL, [user_id] [int] NULL, [wechat_type] [int] NULL, CONSTRAINT [PK_w_wechat] PRIMARY KEY CLUSTERED ( [wechat_id] ASC )WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY] ) ON [PRIMARY] GO
至于如何保存,这里就不在多说,通过三层和mvc都可以,这里只要页面的代码贴出来大家看看
using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.UI; using System.Data; using System.Web.UI.WebControls; using weixin.Model; using weixin.DAL; namespace weixinWeb.web.admin.wechat { public partial class bindapi : weixinWeb.web.admin.cs.adminbase { w_wechat_dal wechatdal = new w_wechat_dal(); protected w_wechat_model wechatmodel = new w_wechat_model(); protected DataTable dtweixin = new DataTable(); protected void Page_Load(object sender, EventArgs e) { dtweixin = wechatdal.GetList(" user_id =" + user_id).Tables[0]; //打开页面就获取并保存url和token信息 if (dtweixin.Rows.Count <= 0) { string weixin_key = Guid.NewGuid().ToString(); string weixin_url = "http://" + Request.Url.Authority + "/web/wechat/api/wechatapi.aspx?key=" + weixin_key;//url wechatmodel.wechat_token = GetRandom();//token用来验证每次的接口访问 wechatmodel.wechat_url = weixin_url; wechatmodel.wechat_key = weixin_key; wechatmodel.wechat_addtime = DateTime.Now; wechatmodel.user_id = int.Parse(user_id); wechatdal.Add(wechatmodel); } else { wechatmodel = wechatdal.GetModel(int.Parse(dtweixin.Rows[0]["wechat_id"].ToString())); } switch (Request.Form["action"]) { case "bindapi": api(); break; } } /// <summary> /// 修改和保存微信配置信息 /// </summary> private void api() { dtweixin = wechatdal.GetList(" user_id =" + user_id).Tables[0]; if (dtweixin.Rows.Count > 0) { wechatmodel = wechatdal.GetModel(int.Parse(dtweixin.Rows[0]["WeChat_ID"].ToString())); wechatmodel.wechat_name = Request.Form["weixin_name"].Trim().ToString();//微信名称 wechatmodel.wechat_appid = Request.Form["appid"].Trim().ToString();//凭证 wechatmodel.wechat_appsecret = Request.Form["appsecret"].Trim().ToString();//凭证钥匙 wechatmodel.wechat_originalid = Request.Form["originalid"].Trim().ToString();//微信原始id wechatmodel.wechat_type = int.Parse(Request.Form["is_show"].Trim().ToString());//公众号类型(服务号,订阅号) wechatdal.Update(wechatmodel); Response.Write("{\"errno\":\"0\",\"tip\":\"设置成功!\",\"url\":\"bindapi.aspx\",\"error\":\"\"}"); } Response.End(); } #region 获取10位随即数(字符串类型) /// <summary> /// 获取10位随即数(字符串类型) /// </summary> /// <returns></returns> private string GetRandom() { Random ran = new Random(); int RandomValue = ran.Next(999999999) + 1000000000; return RandomValue.ToString(); } #endregion 获取10位随即数(字符串类型) } }
其中这里要说的是
string weixin_key = Guid.NewGuid().ToString(); string weixin_url = "http://" + Request.Url.Authority + "/web/wechat/api/wechatapi.aspx?key=" + weixin_key;//url wechatmodel.wechat_token = GetRandom();//token用来验证每次的接口访问
url的地址wechatapi.aspx主要是用来验证微信信息的,下面会重点说说这个页面
token是随机生成的一个说,主要在官网输入的和客户端一致就可以,token可以随意获取。
二、微信url和token验证基本原理和流程
微信是如何验证url和token的呢,假如填写的url和token信息为
URL: http://demo.xxx.com/web/wechat/api/wechatapi.aspx?key=d26bd9ae-5a4f-45d6-bb91-c434e3a7087a ToKen:1369750827
首先、开发者提交信息后,微信服务器将发送GET请求到填写的URL上,GET请求携带四个参数:
参数 | 描述 |
---|---|
signature | 微信加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。 |
timestamp | 时间戳 |
nonce | 随机数 |
echostr | 随机字符串 |
其次、客户端接受到这四个参数后,需要进行验证处理:
加密/校验流程如下: 1. 将token、timestamp、nonce三个参数进行字典序排序 2. 将三个参数字符串拼接成一个字符串进行sha1加密 3. 开发者获得加密后的字符串可与signature对比,标识该请求来源于微信
也就是通过客户端的token,和微信服务器发送过来的timestamp,nonce进行字典排序,组成字符串并通过sha1加密,然后和微信服务器发送过来的signature进行比较,如果一样,则验证通过,并返回接收的echostr,
验证通过后,正确返回echostr,则表示接入成功,成为开发者,否则需要检查配置信息。
三、客户端验证处理
首先,开发端接收微信服务器发送的参数,并按照验证流程进行验证signature是否一致,代码如下
wechatapi.aspx
/// <summary> /// 验证微信签名 /// </summary> /// <returns></returns> /// * 将token、timestamp、nonce三个参数进行字典序排序 /// * 将三个参数字符串拼接成一个字符串进行sha1加密 /// * 开发者获得加密后的字符串可与signature对比,标识该请求来源于微信。 private bool CheckSignature() { string WeChat_Token = ""; string WeChat_Key = Request.QueryString["key"]; DataTable dtWeChat = wechatdal.GetList("wechat_key='" + WeChat_Key + "'").Tables[0]; if (dtWeChat.Rows.Count > 0) { WeChat_Token = dtWeChat.Rows[0]["wechat_token"].ToString(); } //从微信服务器接收传递过来的数据 string signature = Request.QueryString["signature"]; //微信加密签名 string timestamp = Request.QueryString["timestamp"];//时间戳 string nonce = Request.QueryString["nonce"];//随机数 string[] ArrTmp = { WeChat_Token, timestamp, nonce }; Array.Sort(ArrTmp); //字典排序 string tmpStr = string.Join("", ArrTmp);//将三个字符串组成一个字符串 tmpStr = FormsAuthentication.HashPasswordForStoringInConfigFile(tmpStr, "SHA1");//进行sha1加密 tmpStr = tmpStr.ToLower(); //加过密的字符串与微信发送的signature进行比较,一样则通过微信验证,否则失败。 if (tmpStr == signature) { return true; } else { return false; } } #endregion 验证微信API接口
若验证通过,正确返回echostr
/// <summary> /// 验证微信API接口 /// </summary> private void CheckWeChat() { string echoStr = Request.QueryString["echoStr"]; if (CheckSignature()) { if (!string.IsNullOrEmpty(echoStr)) { Response.Write(echoStr); Response.End(); } } }
最后,微信访问页面的时候就要对其进行处理验证,所以事件要放到页面加载的地方
protected void Page_Load(object sender, EventArgs e) { //微信通过get请求验证api接口 CheckWeChat(); }
这样就基本完成了微信公众平台的配置和验证,成为开发者,下一步就是获取access_token,实现各个接口了。