微信企业号开发之加密方案与全局返回码说明

最新推荐文章于 2023-12-11 11:33:20 发布
最新推荐文章于 2023-12-11 11:33:20 发布 · 976 阅读 · 0
文章标签：

#java #php #python

本文详细介绍企业号回调加解密方案，包括术语定义、消息签名验证、加解密流程及示例代码下载。提供了C++、Python、PHP、Java和C#等多种语言的加解密库。

本文包含了企业号回调企业时加解密的详细方案、库和示例代码的下载，以及企业号api接口返回的错误码。

一、关于加解密方案的详细说明

1、术语及说明

开启回调模式时，有以下术语需要了解：

1）msg_signature是签名，用于验证调用者的合法性

2）EncodingAESKey用于消息体的加密，长度固定为43个字符，从a-z, A-Z, 0-9共62个字符中选取，是AESKey的Base64编码。解码后即为32字节长的AESKey

3）AESKey=Base64_Decode(EncodingAESKey + “=”)，是AES算法的密钥，长度为32字节。AES采用CBC模式，数据采用PKCS#7填充；IV初始向量大小为16字节，取AESKey前16字节。具体详见：http://tools.ietf.org/html/rfc2315

4）msg为消息体明文，格式为XML

5）msg_encrypt = Base64_Encode( AES_Encrypt[random(16B) + msg_len(4B) + msg + $CorpID] )，是对明文消息msg加密处理后的Base64编码

2、消息体签名

为了验证调用者的合法性，微信在回调url中增加了消息签名，以参数msg_signature标识，企业需要验证此参数的正确性后再解密。验证步骤：

1）企业计算签名：dev_msg_signature=sha1(sort(Token、timestamp、nonce、msg_encrypt))。sort的含义是将参数按照字母字典排序，然后从小到大拼接成一个字符串

2）比较dev_msg_signature和msg_signature是否相等，相等则表示验证通过。

3、加解密方案说明

  • 对明文msg加密的过程如下：

msg_encrypt = Base64_Encode( AES_Encrypt[random(16B) + msg_len(4B) + msg + $CorpID] )

AES加密的buf由16个字节的随机字符串、4个字节的msg长度、明文msg和$CorpID组成。其中msg_len为msg的字节数，网络字节序；$CorpID为企业号的CorpID。经AESKey加密后，再进行Base64编码，即获得密文msg_encrypt。

  • 对应于加密方案，解密方案如下：

1）对密文BASE64解码：aes_msg=Base64_Decode(msg_encrypt)

2）使用AESKey做AES解密：rand_msg=AES_Decrypt(aes_msg)

3）验证解密后$CorpID、msg_len

4）去掉rand_msg头部的16个随机字节，4个字节的msg_len,和尾部的$CorpID即为最终的消息体原文msg。

内容导航

二、加解密库下载和返回码

1、加解密库的返回码

返回码说明
0请求成功
-40001签名验证错误
-40002xml解析失败
-40003sha加密生成签名失败
-40004AESKey 非法
-40005corpid 校验错误
-40006AES 加密失败
-40007AES 解密失败
-40008解密后得到的buffer非法
-40009base64加密失败
-40010base64解密失败
-40011生成xml失败

2、加解密库下载及示例

  • c++库(点击下载)

注意事项：

1）WXBizMsgCrypt.h声明了WXBizMsgCrypt类，提供用户接入企业微信的三个接口。WXBizMsgCrypt.cpp文件提供了三个接口的实现。Sample.cpp文件提供了如何使用这三个接口的示例。

2）WXBizMsgCrypt类封装了VerifyURL, DecryptMsg, EncryptMsg三个接口，分别用于开发者验证回调url，收到用户回复消息的解密以及开发者回复消息的加密过程。使用方法可以参考Sample.cpp文件。

3）加解密协议请参考企业微信官方文档。

4）加解密过程使用了开源的openssl和tinyxml2库，请开发者自行安装之后使用。

*openssl的版本号是openssl-1.0.1h，http://www.openssl.org/

*tinyxml2的版本号是tinyxml2-2.1.0，https://github.com/leethomason/tinyxml2

注意事项：

1）WXBizMsgCrypt.py文件封装了WXBizMsgCrypt接口类，提供了用户接入企业微信的三个接口，Sample.py文件提供了如何使用这三个接口的示例，ierror.py提供了错误码。

2）WXBizMsgCrypt封装了VerifyURL, DecryptMsg, EncryptMsg三个接口，分别用于开发者验证回调url、接收消息的解密以及开发者回复消息的加密过程。使用方法可以参考Sample.py文件。

3）本代码用到了pycrypto第三方库，请开发者自行安装此库再使用。

  • php库(点击下载)

注意事项：

1）WXBizMsgCrypt.php文件提供了WXBizMsgCrypt类的实现，是用户接入企业微信的接口类。Sample.php提供了 示例以供开发者参考。errorCode.php, pkcs7Encoder.php, sha1.php, xmlparse.php文件是实现这个类的辅助类，开发者无须关心其具体实现。

2）WXBizMsgCrypt类封装了VerifyURL, DecryptMsg, EncryptMsg三个接口，分别用于开发者验证回调url、接收消息的解密以及开发者回复消息的加密过程。使用方法可以参考Sample.php文件。

  • Java库(点击下载)

注意事项：

1）com\qq\weixin\mp\aes目录下是用户需要用到的接入企业微信的接口，其中WXBizMsgCrypt.java文件提供的 WXBizMsgCrypt类封装了用户接入企业微信的三个接口，其它的类文件用户用于实现加解密，用户无须关心。sample.java文件提供了接口 的使用示例。

2）WXBizMsgCrypt封装了VerifyURL, DecryptMsg, EncryptMsg三个接口，分别用于开发者验证回调url、接收消息的解密以及开发者回复消息的加密过程。使用方法可以参考Sample.java文件。

3）请开发者使用jdk1.7以上的版本。针对org.apache.commons.codec.binary.Base64，需要导入jar包commons-codec-1.9（或comm ons-codec-1.8等其他版本），我们有提供，官方下载地址：

http://commons.apache.org/proper/commons-codec/download_codec.cgi

4）异常java.security.InvalidKeyException:illegal Key Size的解决方案：

在官方网站下载JCE无限制权限策略文件（JDK7的下载地址：

http://www.Oracle.com/techNetwork/java/javase/downloads/jce-7-download-432124.html

下载后解压，可以看到local_policy.jar和US_export_policy.jar以及readme.txt。如果安装了JRE， 将两个jar文件放到%JRE_HOME% \lib\security目录下覆盖原来的文件，如果安装了JDK，将两个jar文件放到%JDK_HOME%\jre\lib\security目录 下覆盖原来文件。

  • c#库(点击下载)

注意事项：

1）Cryptography.cs文件封装了AES加解密过程，用户无须关心具体实现。WXBizMsgCrypt.cs文件提供了用户接入企业微信的三个接口，Sample.cs文件提供了如何使用这三个接口的示例。

2）WXBizMsgCrypt.cs封装了VerifyURL, DecryptMsg, EncryptMsg三个接口，分别用于开发者验证回调url、接收消息的解密以及开发者回复消息的加密过程。使用方法可以参考Sample.cs文件。

内容导航

三、全局返回码说明

企业号每次调用接口时，可能获得正确或错误的返回码，企业可以根据返回码信息调试接口，排查错误。

全局返回码说明如下：

返回码说明
-1系统繁忙
0请求成功
40001获取access_token时Secret错误，或者access_token无效
40002不合法的凭证类型
40003不合法的UserID
40004不合法的媒体文件类型
40005不合法的文件类型
40006不合法的文件大小
40007不合法的媒体文件id
40008不合法的消息类型
40013不合法的corpid
40014不合法的access_token
40015不合法的菜单类型
40016不合法的按钮个数
40017不合法的按钮类型
40018不合法的按钮名字长度
40019不合法的按钮KEY长度
40020不合法的按钮URL长度
40021不合法的菜单版本号
40022不合法的子菜单级数
40023不合法的子菜单按钮个数
40024不合法的子菜单按钮类型
40025不合法的子菜单按钮名字长度
40026不合法的子菜单按钮KEY长度
40027不合法的子菜单按钮URL长度
40028不合法的自定义菜单使用员工
40029不合法的oauth_code
40031不合法的UserID列表
40032不合法的UserID列表长度
40033不合法的请求字符，不能包含\uxxxx格式的字符
40035不合法的参数
40038不合法的请求格式
40039不合法的URL长度
40040不合法的插件token
40041不合法的插件id
40042不合法的插件会话
40048url中包含不合法domain
40054不合法的子菜单url域名
40055不合法的按钮url域名
40056不合法的agentid
40057不合法的callbackurl
40058不合法的红包参数
40059不合法的上报地理位置标志位
40060设置上报地理位置标志位时没有设置callbackurl
40061设置应用头像失败
40062不合法的应用模式
40063红包参数为空
40064管理组名字已存在
40065不合法的管理组名字长度
40066不合法的部门列表
40067标题长度不合法
40068不合法的标签ID
40069不合法的标签ID列表
40070列表中所有标签（用户）ID都不合法
40071不合法的标签名字，标签名字已经存在
40072不合法的标签名字长度
40073不合法的openid
40074news消息不支持指定为高保密消息
41001缺少access_token参数
41002缺少corpid参数
41003缺少refresh_token参数
41004缺少secret参数
41005缺少多媒体文件数据
41006缺少media_id参数
41007缺少子菜单数据
41008缺少oauth code
41009缺少UserID
41010缺少url
41011缺少agentid
41012缺少应用头像mediaid
41013缺少应用名字
41014缺少应用描述
41015缺少Content
41016缺少标题
41017缺少标签ID
41018缺少标签名字
42001access_token超时
42002refresh_token超时
42003oauth_code超时
42004插件token超时
43001需要GET请求
43002需要POST请求
43003需要HTTPS
43004需要接收者关注
43005需要好友关系
43006需要订阅
43007需要授权
43008需要支付授权
43009需要认证
43010需要处于回调模式
43011需要企业授权
44001多媒体文件为空
44002POST的数据包为空
44003图文消息内容为空
44004文本消息内容为空
45001多媒体文件大小超过限制
45002消息内容超过限制
45003标题字段超过限制
45004描述字段超过限制
45005链接字段超过限制
45006 图片链接字段超过限制
45007语音播放时间超过限制
45008图文消息超过限制
45009接口调用超过限制
45010创建菜单个数超过限制
45015回复时间超过限制
45016系统分组，不允许修改
45017分组名字过长
45018分组数量超过上限
46001不存在媒体数据
46002不存在的菜单版本
46003不存在的菜单数据
46004不存在的员工
47001解析JSON/XML内容错误
48002Api禁用
50001redirect_uri未授权
50002员工不在权限范围
50003应用已停用
50004员工状态不正确（未关注状态）
50005企业已禁用
60001部门长度不符合限制
60002部门层级深度超过限制
60003部门不存在
60004父亲部门不存在
60005不允许删除有成员的部门
60006不允许删除有子部门的部门
60007不允许删除根部门
60008部门名称已存在
60009部门名称含有非法字符
60010部门存在循环关系
60011 管理员权限不足，（user/department/agent）无权限
60012不允许删除默认应用
60013不允许关闭应用
60014不允许开启应用
60015不允许修改默认应用可见范围
60016不允许删除存在成员的标签
60017不允许设置企业
60102UserID已存在
60103 手机号码不合法
60104手机号码已存在
60105邮箱不合法
60106邮箱已存在
60107微信号不合法
60108微信号已存在
60109QQ号已存在
60110部门个数超出限制
60111UserID不存在
60112成员姓名不合法
60113身份认证信息（微信号/手机/邮箱）不能同时为空
60114性别不合法
iteye_14984
关注
微信开发与代码的编写(一)
悦分享
08-27 3391
微信开发与代码的编写(一) 微信开发环境的搭建 目前移动开发处于比较火的的趋势,很多的开发者都跃跃欲试,目前移动App开发领域主要分为以下几种类型 　　 　　我在平时的工作中接触得比较多的就是基于Android的Native App开发和基于微信公众号的Light App开发,今天就来带领大家快速进入微信公众号的开发领域. 微信开发环境搭建 　　工欲善其事，必先利其器。要做微信公众号开...
企业微信H5_集成消息解密类,消息推送Get及Post回调处理
Gblfy_Blog
02-28 1053
文章目录一、 验证URL有效性1. 阅读文档2. 文档分析3. 加解密方案说明4. 下载加解密算法5. 案例分析二、实战集成2.1. 工具类拷贝2.2. 依赖引入2.3. 案例1集成2.4. 参数处理2.5. 重启项目2.6. 验证URL有效性2.7. 验证三、消息接收与处理3.1. 文档阅读3.2. 案例2拷贝3.3. 参数处理3.4. 重启项目3.5. 发送消息3.6. 验证3.7. 日志监控3.8. 收到回复消息四、源码分享4.1. 后端源码4.2. 前端源码 一、 验证URL有效性 官网文档：ht.
微信第三方平台开发 必备工具代码库 PHP版本 WXBizMsgCrypt
03-08
微信第三方平台开发官方提供的工具库文件，主要用于提供满足与第三方平台服务器通信要求的PHP工具函数，可以直接调用进行加解密。 注意事项： 1.WXBizMsgCrypt.php文件提供了WXBizMsgCrypt类的实现，是用户接入企业微信的接口类。Sample.php提供了示例以供开发者参考。errorCode.php, pkcs7Encoder.php, sha1.php, xmlparse.php文件是实现这个类的辅助类，开发者无须关心其具体实现。 2.WXBizMsgCrypt类封装了 DecryptMsg, EncryptMsg两个接口，分别用于开发者解密以及开发者回复消息的加密。使用方法可以参考Sample.php文件。 3.加解密协议请参考微信公众平台官方文档。
PHP对接企业微信审批回调
sunsijia21983的博客
09-29 2008
在【管理后台->应用和小程序->审批->API->接收事件服务器】中，设置回调地址，并勾选需要进行状态变化回调通知的审批模板类型。设置后，回调地址可接收审批应用所有允许进行回调的审批申请相关状态变化通知。2.选择需要回调的模板，需要哪个就勾选哪个就行。3.点击保存就验证看这个回调接口是否通过了。我就是在原来测试回调的方法里面写的。描述：里面有回调后的参数介绍。审批申请状态变化回调通知。1.配置一个回调地址，加解密库下载与返回码。接收消息与事件 概述。
微信企业号开发之加密方案与全局返回码说明(3)
love70song的专栏
11-22 2229
微信企业号开发之加密方案与全局返回码说明  三、全局返回码说明 企业号每次调用接口时，可能获得正确或错误的返回码，企业可以根据返回码信息调试接口，排查错误。 全局返回码说明如下： 返回码 说明 -1 系统繁忙 0 请求成功 40001 获取access_token时Secret错误，或者acc
企业微信 被动接受消息代码
小倪粑粑的BLOG
04-09 526
using BN.Data; using Newtonsoft.Json.Linq; using System; using System.Configuration; using System.IO; using System.Net.Http; using System.Text; using System.Web; using System.Web.Http; using System.Xml; using WebApi.Jwt.cls; //获取消息加密解密算法,腾讯提供 //https://wo
C#实现微信企业号API服务端调用封装
04-27
C#实现微信企业号API服务端调用封装全部源码 1、基础方法 1.1 在回调模式下验证服务器接口地址 1.2 服务器端解密方法 1.3 服务器端加密方法 1.4 获取AccessToken（企业号的全局唯一票据） 1.5 获取企业号应用的基本...
C#封装微信企业号API：完整源码与调用方法
以上封装的方法库适用于任何C#开发的项目，开发者可以使用这些方法快速集成微信企业号的各种功能，提高开发效率，拓展企业应用的通讯能力。 文件名称"Mesnac.WebChat"可能代表了包含此封装方法库的C#项目名称。...
C#实现微信企业号多格式消息推送教程
微信企业号是腾讯微信团队为企业用户提供的移动应用解决方案，它支持与企业内部IT系统的无缝集成。 集成微信企业号的第一步是注册并创建微信企业号。企业号注册成功后，可以获取到一个企业ID（CorpID），以及对应的...
微信JS接口- 企业号开发者接口文档
YiFeng_888的博客
01-22 5988
目录 1 概述 1.1 使用说明 1.1.1 步骤一：引入JS文件 1.1.2 步骤二：通过config接口注入权限验证配置 1.1.3 步骤三：通过ready接口处理成功验证 1.1.4 步骤四：通过error接口处理失败验证 1.2 接口调用说明 2 基础接口 2.1 判断当前客户端版本是否支持指定JS接口 3 分享接口 3.1 获取“分...
wxbizmsgcrypt+php7,wxBizMsgCrypt.php
weixin_42632156的博客
03-20 1001
/*** 对公众平台发送给公众账号的消息加解密示例代码.** @copyright Copyright (c) 1998-2014 Tencent Inc.*/include_once "sha1.php";include_once "xmlparse.php";include_once "pkcs7Encoder.php";include_once "errorCode.php";/*** 1....
Java对接微信公众平台详解
靖节先生的博客
10-28 7850
Java对接微信公众平台详解1.公众平台概述1.1 公众平台概述1.2 入门指引2.对接流程2.1 接入概述2.2 填写服务器配置2.3 接口域名说明2.4 获取Access token3.项目实现3.1 创建项目3.2 项目依赖3.3 项目配置3.4 加解密工具3.5 代码实现4.测试验证 1.公众平台概述 1.1 公众平台概述 微信公众平台是运营者通过公众号为微信用户提供资讯和服务的平台，而公众平台开发接口则是提供服务的基础，开发者在公众平台网站中创建公众号、获取接口权限后，实现后台接口对接微信公众号的
微信公众平台开发教程企业号修改篇（AES验证）
csnewdn的专栏
12-14 3068
柳峰微信公众平台开发教程企业号修改篇（AES验证）   本文针对《微信公众平台应用开发：方法、技巧与案例》 一书中示例和代码不适用于微信企业号的情况进行修改。    修改原因：   企业在接收消息，以及发送被动响应消息时，消息体都以AES方式加密，以保证传输的安全   修改方法：   按照微信加密库进行加密验证，具体加密库下载地点请参考开发人员文档，这里不再叙述
Java企业微信开发_13_异常：com.qq.weixin.mp.aes.AesException: 解密后得到的buffer非法
weixin_34365635的博客
03-06 2834
一、异常信息 方法：POST@ echostr是否存在 ：false java.lang.IllegalArgumentException: 20 > -367029533 at java.util.Arrays.copyOfRange(Arrays.java:3519) at com.qq.weixin.mp.aes.WXBi...
WXBizMsgCrypt微信小程序实现微信开放平台的加密解密
最新发布
学习激发潜力
12-11 2171
创建WXBizMsgCrypt.js文件。需要引入的文件crypto-js.js。需要引入的文件base64.js。
微信公众平台企业号验证接口、回调 PHP版
热门推荐
炉火纯青
10-21 3万+
微信公众平台企业号验证接口、回调 PHP版，本人为了解决这个企业号的验证和发送消息的问题，整整研究了几天时间，因为微信企业号刚推出来，网上资料太少了！后来在一些朋友的帮助下和本人反复调试完善下，终于整理得到了比较理想的文档，经亲测，实验成功。
企业微信-通用开发参数回调设置
json_li的博客
09-21 4110
公司业务需要开发企业微信，注册三方服务商审核通过后， 开始配置开发信息。本篇中记录在调试url验证中遇到错误及解决方式。
企业微信回调接口
jeff技术博客
11-14 3890
package com.wx.demo; import com.qq.weixin.mp.aes.WXBizMsgCrypt; import com.wx.demo.wx.ElementUtils; import com.wx.demo.wx.FormatUtils; import com.wx.demo.wx.model.InMsgEntity; import com.wx.demo.wx...
企业微信开发PHP版-被动回复消息无反应解决办法
weixin_42979295的博客
05-20 1228
如果你是在官网指定的git 链接中 下载的 demo 那出现这个问题就不足为奇 问题表象：1，点击菜单，无消息回复 2，打印加密返回信息后生成的xml文件，出现乱码 问题原因： git上 文件pkcs7Encoder.php 文件中 类Prpcrypt 的 方法encrypt() 是有问题的 用如下代码替换 原来encrypt() 方法，这样文件就解决了。 public function encrypt($text, $cor...
微信企业号开发中加密解密类的应用与实现
以下是关于微信企业号开发中加密解密知识点的详细说明： **知识点一：微信企业号的安全机制** 微信企业号提供的消息加解密功能是基于微信自身的安全机制而设计的，主要是为了确保企业号通信过程中的数据安全。这种...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值