微信公众号开发 (1) 微信接入认证成为开发者

迷南。 2022-03-27 02:38 293阅读 0赞

### 一、前言 ###

本系列教程将基于`springboot2.1.8.RELEASE`完成

本文将实现

1.  注册账号
2.  接入微信
3.  认证成为开发者

### 二、进入微信公众平台注册账号 ###

> [https://mp.weixin.qq.com/][https_mp.weixin.qq.com]

个人用户建议注册订阅号  
![在这里插入图片描述][20190111182649715.png]  
最后注册成功如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70]

### 三、接入认证成为开发者 ###

> 可参考微信官方开发文档：[https://mp.weixin.qq.com/wiki?t=resource/res\_main&id=mp1421135319][https_mp.weixin.qq.com_wiki_t_resource_res_main_id_mp1421135319]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70]

#### 1、填写服务器配置 ####

选择左下方的开发者工具，进入测试账号开发

> why？  
> 测试账号的权限多点，如果已经认证了的账号可不需要利用测试账号开发

![在这里插入图片描述][20190610111857434.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70 1]  
登录进去  
![在这里插入图片描述][20190610112012769.png]

填写服务器 `URL` 和自定义的校验`Token`  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 1]

> 温馨小提示：
> 
> 1.  微信公众号接口必须以http://或https://开头，分别支持80端口和443端口！
> 2.  这里的url可以选择自己买的服务器地址，记得必须开放80端口去使用！  
>     或者使用内网映射外网工具生成一个域名地址供给你开发使用，此方法自行百度，如下就是其中一种使用~  
>     ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 2]

#### 2、提交验证URL有效性 ####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 3]

配置好后，点击提交，微信服务器会发送一个`GET`请求到我们配置的地址上，在后台通过get请求的方式获取，请求的时候会传入几个参数  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 4]  
回到项目中，处理微信认证，然后启动项目测试

> 温馨小提示：这里小编将自己的内网映射到外网了，方便本地测试~

@Slf4j
    @RestController
    @RequestMapping("/api/weixin/index")
    @Api(tags = "微信 - 接口")
    public class IndexController extends BaseController { 
    
        // TODO 这里的token是微信公众平台上自己所配的！
        private static final String token = "zhengqing";
    
        /** * 处理微信认证：验证服务器地址的有效性，get提交 * signature: 微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。 * timestamp 时间戳 * nonce: 随机数 * echostr: 随机字符串 */
        @GetMapping
        public void checkSignature(HttpServletRequest request, HttpServletResponse response) throws IOException { 
            System.out.println("============= 处理微信认证 ===============");
            // 拿到微信的请求参数
            String signature = request.getParameter("signature");
            String timestamp = request.getParameter("timestamp");
            String nonce = request.getParameter("nonce");
            String echostr = request.getParameter("echostr");
    
            // ① 将token、timestamp、nonce三个参数进行字典序排序 b a d c h ==>a b c d h
            String[] strArr = { token, timestamp, nonce};
            // 字典排序
            Arrays.sort(strArr);
            // ② 将三个参数字符串拼接成一个字符串进行sha1加密
            StringBuffer sb = new StringBuffer();
            // 字符串拼接
            for (String str : strArr) { 
                sb.append(str);
            }
            // 加密
            String sha1Str = SecurityUtil.sha1(sb.toString());
            // ③ 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信
            if (sha1Str.equals(signature)) { 
                // 如果相等，就是来自微信请求
                // 若确认此次GET请求来自微信服务器，原样返回echostr参数内容，则接入生效
                response.getWriter().println(echostr);
            }
        }
    
    }

其中sha1加密工具类

public class SecurityUtil { 
    	public static String sha1(String str) { 
    		try { 
    			StringBuilder sb = new StringBuilder();
    			MessageDigest digest = MessageDigest.getInstance("sha1");
    			// 放入加密字符串
    			digest.update(str.getBytes());
    			// 进行加密
    			byte[] digestMsg = digest.digest();
    			// byte转换16进制
    			for (byte b : digestMsg) { 
    				sb.append(String.format("%02x", b));
    			}
    			return sb.toString();
    		} catch (NoSuchAlgorithmException e) { 
    			e.printStackTrace();
    		}
    		return str;
    	}
    }

注意端口必须为80端口哦！！！  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 5]

#### 3、测试接入认证 ####

启动项目后，回到微信公众平台，提交发送接入认证请求，如果配置正确，会提示配置成功，并保存配置信息

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 6]

就这样，我们简单的完成了微信认证成为开发者 ~

### 本文案例demo源码 ###

[https://gitee.com/zhengqingya/java-workspace][https_gitee.com_zhengqingya_java-workspace]

[https_mp.weixin.qq.com]: https://mp.weixin.qq.com/
[20190111182649715.png]: /images/20220327/5932729caa6848df89e7944f3e8c7a78.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70]: /images/20220327/96c4ae064d7a448d83370bf9bcddeb4f.png
[https_mp.weixin.qq.com_wiki_t_resource_res_main_id_mp1421135319]: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421135319
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70]: /images/20220327/5b15404912024a4db28001fda9d9a690.png
[20190610111857434.png]: /images/20220327/858a89e9c1d648aeaaf4a216046fe5e0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70 1]: /images/20220327/e1f7d81c2c82455881910becc40454e0.png
[20190610112012769.png]: /images/20220327/b83aa81bf7e04f2795f7258dd34eccc6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 1]: /images/20220327/f4b9cc6aa56c4ce3b384b6842edc034a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 2]: /images/20220327/e726eefa507f44d492d81cfd4ec44292.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 3]: /images/20220327/c3b4ad8d84da40debf970ee1d17dd81a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 4]: /images/20220327/e2aa8d168a8b40358f536075daa38a3d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 5]: /images/20220327/00c3b61881d649508a9566d85a632a10.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly96aGVuZ3FpbmcuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 6]: /images/20220327/1e1105f7200a46a08dcfc72925a86c03.png
[https_gitee.com_zhengqingya_java-workspace]: https://gitee.com/zhengqingya/java-workspace