ASP.NET Core2实现静默获取微信公众号的用户OpenId
最近在做个微信公众号的项目，需要将入口放置在公众号二级菜单内，通过点击该菜单链接后进入到该项目中去，进入到项目后程序会自动通过微信公众号的API完成用户的OpenId获取。需求很简单，实现起来也不复杂，于是在一番折腾后需求实现了。为此，写下此文仅为初次接触的朋友提供个小小的帮助。
准备
老规矩，在开始动手前，咱们先简单介绍下实现的组成部分，如下：
微信公众号静默获取用户OpenId：要实现该功能，可以通过微信公众号提供的“网页授权”接口完成（官网描述：以snsapi_base为scope发起的网页授权，是用来获取进入页面的用户的openid的，并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页（往往是业务页面）），具体说明在此：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842
Lezhima.Site：是一个基于ASP.NET Core2的Web Mvc带视图的程序，用来模拟接受微信公众号菜单链接的请求，并自动获取用户的OpenId。
实现
如上面所述，我们已经清楚了整个实现思路，那么下面就来看看Lezhima.Site项目内的代码实现吧：
1、首先我们先创建一个名为“BasicController”的业务基类，并继承“Controller”类。其作用有两个，一是将验证是否正确获取OpenId的业务封装成基类，二是方便其它业务控制器使用OpenId。具体代码如下：
1 /// <summary> 2 /// 业务基类 3 /// </summary> 4 public class BasicController:Controller 5 { 6 //当前用户openId 7 protected string CurrentUserOpenId { set; get; } 8 9 public BasicController() 10 { 11 //从Cookie中获取当前用户的openId 12 var openId = Cookies.GetCookieByUser(); 13 //如果没有，则导航到指定提示页，需要用户关闭后重新进入 14 if (string.IsNullOrEmpty(openId)) 15 { 16 System.Web.HttpContext.Current.Response.Redirect("/VxinWeb/Index"); 17 return; 18 } 19 20 CurrentUserOpenId = openId; 21 } 22 }
2、再创建一个名为“VxinWebController”的控制器与View视图。其作用是用来接受来自微信公众号菜单内的链接入口，并自动完成获取用户OpenId。代码如下：
1 /// <summary> 2 /// 此页面用于对外微信菜单地址，用于获取用户openId 3 /// 这是本系统网页的入口 4 /// </summary> 5 public class VxinWebController : Controller 6 { 7 public ActionResult Index() 8 { 9 //获取当前进到本系统的微信用户的openid 10 //该请求从微信那边过来 11 if (Request.QueryString["code"] != null) 12 { 13 var code = Request.QueryString["code"].ToString(); 14 var openId = VxinUtils.GetOpenID(code); 15 if (string.IsNullOrEmpty(openId))//没有获取到openId 16 { 17 //返回当前视图，需要提示用户关闭窗口，尝试重新进入 18 return View(); 19 } 20 //将openId放入cookie，放到cookie之前需将openId进行加密，取出来后再解密 21 Cookies.SetUserToCookie(openId); 22 return RedirectToAction("Index", "Home"); 23 } 24 return View(); 25 } 26 }
3、在第二步时，我们发现有个VxinUtils类，该类封装了对微信公众号API的操作，具体代码如下：
1 /// <summary> 2 /// 微信公众号工具类 3 /// </summary> 4 public class VxinUtils 5 { 6 7 /// <summary> 8 /// 微信token 9 /// </summary> 10 public static string WeiXinToken { get { return ConfigurationManager.AppSettings["WeiXinToken"].ToString(); } } 11 12 /// <summary> 13 /// 微信appID 14 /// </summary> 15 public static string AppID { get { return ConfigurationManager.AppSettings["AppID"].ToString(); } } 16 17 18 /// <summary> 19 /// 微信Aappsecret 20 /// </summary> 21 public static string Appsecret { get { return ConfigurationManager.AppSettings["Appsecret"].ToString(); } } 22 23 24 /// <summary> 25 /// 获得access_token地址 26 /// </summary> 27 public static string Access_token_URL { get { return string.Format("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}", AppID, Appsecret); } } 28 29 /// <summary> 30 /// 通过code换取网页授权access_token地址 31 /// </summary> 32 public static string Web_Access_token_URL { get { return string.Format("https://api.weixin.qq.com/sns/oauth2/access_token?appid={0}&secret={1}&grant_type=authorization_code&code=", AppID, Appsecret); } } 33 34 35 /// <summary> 36 /// 微信菜单创建提交地址 37 /// </summary> 38 public static string MENU_POST_URL { get { return "https://api.weixin.qq.com/cgi-bin/menu/create?access_token="; } } 39 40 41 /// <summary> 42 /// 微信获取用户分组地址 43 /// </summary> 44 public static string Group_Get_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/get?access_token="; } } 45 46 47 /// <summary> 48 /// 微信修改用户分组地址 49 /// </summary> 50 public static string Group_Update_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token="; } } 51 52 53 54 /// <summary> 55 /// 微信获取用户所属分组地址 56 /// </summary> 57 public static string Group_GetUserGroup_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/getid?access_token="; } } 58 59 /// <summary> 60 /// 拉取用户信息(需scope为 snsapi_userinfo) 61 /// 如果网页授权作用域为snsapi_userinfo，则此时开发者可以通过access_token和openid拉取用户信息了。 62 /// https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN 63 /// </summary> 64 public static string GetUserUserinfo_Url { get { return "https://api.weixin.qq.com/sns/userinfo?lang=zh_CN&access_token="; } } 65 66 67 /// <summary> 68 /// 获取用户的OpenId 69 /// </summary> 70 /// <param name="code"></param> 71 /// <returns></returns> 72 public static string GetOpenID(string code) 73 { 74 var openid = ""; 75 using (var wl = new WebClient()) 76 { 77 wl.Headers.Add(HttpRequestHeader.Accept, "json"); 78 wl.Headers.Add(HttpRequestHeader.ContentType, "application/json;charset=UTF-8"); 79 wl.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/4.0"); 80 wl.Encoding = Encoding.UTF8; 81 openid = wl.DownloadString(Web_Access_token_URL + code); 82 } 83 if (!string.IsNullOrEmpty(openid)) 84 { 85 var token = JObject.Parse(openid).SelectToken("openid"); 86 if (token != null) 87 openid = token.ToString(); 88 } 89 return openid; 90 } 91 92 }
总结
1、基于“snsapi_base为scope发起的网页授权”的微信公众号方案，可以很方便的实现用户静默授权及获取用户的OpenId。
2、通过将获取到的OpenId写入在Cookie中，并封装一个业务基类完成Cookie的读取与判断，可以使其它业务类很方便的使用OpenId。
声明
本文为作者原创，转载请备注出处与保留原文地址，谢谢。如文章能给您带来帮助，请点下推荐或关注，感谢您的支持！
