(风和水之名)
(再见了，过往)
第三方登录：微信企业号开发之加密方案与全局返回码说明
我的图书馆
微信企业号开发之加密方案与全局返回码说明
07net01.com 发布于 4小时前分类：阅读()
本文包含了企业号回调企业时加解密的详细方案、库和示例代码的下载，以及企业号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、加解密库的返回码
签名验证错误
xml解析失败
sha加密生成签名失败
AESKey 非法
corpid 校验错误
AES 加密失败
AES 解密失败
解密后得到的buffer非法
base64加密失败
base64解密失败
生成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
python库(点击下载)
注意事项：
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文件。
三、全局返回码说明
企业号每次调用接口时，可能获得正确或错误的返回码，企业可以根据返回码信息调试接口，排查错误。
全局返回码说明如下：
获取access_token时Secret错误，或者access_token无效
不合法的凭证类型
不合法的UserID
不合法的媒体文件类型
不合法的文件类型
不合法的文件大小
不合法的媒体文件id
不合法的消息类型
不合法的corpid
不合法的access_token
不合法的菜单类型
不合法的按钮个数
不合法的按钮类型
不合法的按钮名字长度
不合法的按钮KEY长度
不合法的按钮URL长度
不合法的菜单版本号
不合法的子菜单级数
不合法的子菜单按钮个数
不合法的子菜单按钮类型
不合法的子菜单按钮名字长度
不合法的子菜单按钮KEY长度
不合法的子菜单按钮URL长度
不合法的自定义菜单使用员工
不合法的oauth_code
不合法的UserID列表
不合法的UserID列表长度
不合法的请求字符，不能包含\uxxxx格式的字符
不合法的参数
不合法的请求格式
不合法的URL长度
不合法的插件token
不合法的插件id
不合法的插件会话
url中包含不合法domain
不合法的子菜单url域名
不合法的按钮url域名
不合法的agentid
不合法的callbackurl
不合法的红包参数
不合法的上报地理位置标志位
设置上报地理位置标志位时没有设置callbackurl
设置应用头像失败
不合法的应用模式
红包参数为空
管理组名字已存在
不合法的管理组名字长度
不合法的部门列表
标题长度不合法
不合法的标签ID
不合法的标签ID列表
列表中所有标签（用户）ID都不合法
不合法的标签名字，标签名字已经存在
不合法的标签名字长度
不合法的openid
news消息不支持指定为高保密消息
缺少access_token参数
缺少corpid参数
缺少refresh_token参数
缺少secret参数
缺少多媒体文件数据
缺少media_id参数
缺少子菜单数据
缺少oauth code
缺少UserID
缺少agentid
缺少应用头像mediaid
缺少应用名字
缺少应用描述
缺少Content
缺少标签ID
缺少标签名字
access_token超时
refresh_token超时
oauth_code超时
插件token超时
需要GET请求
需要POST请求
需要接收者关注
需要好友关系
需要支付授权
需要处于回调模式
需要企业授权
多媒体文件为空
POST的数据包为空
图文消息内容为空
文本消息内容为空
多媒体文件大小超过限制
消息内容超过限制
标题字段超过限制
描述字段超过限制
链接字段超过限制
图片链接字段超过限制
语音播放时间超过限制
图文消息超过限制
接口调用超过限制
创建菜单个数超过限制
回复时间超过限制
系统分组，不允许修改
分组名字过长
分组数量超过上限
不存在媒体数据
不存在的菜单版本
不存在的菜单数据
不存在的员工
解析JSON/XML内容错误
redirect_uri未授权
员工不在权限范围
应用已停用
员工状态不正确（未关注状态）
企业已禁用
部门长度不符合限制
部门层级深度超过限制
部门不存在
父亲部门不存在
不允许删除有成员的部门
不允许删除有子部门的部门
不允许删除根部门
部门名称已存在
部门名称含有非法字符
部门存在循环关系
管理员权限不足，（user/department/agent）无权限
不允许删除默认应用
不允许关闭应用
不允许开启应用
不允许修改默认应用可见范围
不允许删除存在成员的标签
不允许设置企业
UserID已存在
手机号码不合法
手机号码已存在
邮箱不合法
邮箱已存在
微信号不合法
微信号已存在
QQ号已存在
部门个数超出限制
UserID不存在
成员姓名不合法
身份认证信息（微信号/手机/邮箱）不能同时为空
性别不合法
馆藏&24719
TA的最新馆藏[转]&
喜欢该文的人也喜欢微信8月21号转账提现失败怎么回事 微信8月21号转账提现一直提示系统繁忙怎么办
&&微信8月21号转账提现失败怎么回事 微信8月21号转账提现一直提示系统繁忙怎么办
微信8月21号转账提现失败怎么回事 微信8月21号转账提现一直提示系统繁忙怎么办
16:38:44来源：9553编辑：9553资讯编辑
今天许多用户反映微信8月21号转账提现失败，一直提示系统繁忙，请稍后再试，那么微信8月21号转账提现失败怎么回事？微信8月21号转账提现一直提示系统繁忙怎么办？
微信v6.5.10版是微信的最新版，本次更新了许多非常实用的功能，比如你是不为那什么朋友圈点赞消息而烦恼，每次点赞都会收到好多消息，现在可以设置某条朋友圈的互动不再通知啦！
授权：免费软件大小：43.8MB语言：简体中文
微信8月21号转账提现失败怎么回事？
腾讯微信出现了大面积的故障，包括转账、提现、朋友圈分享等功能均受到了不同程度的影响。
从网友提供的图片来看，零钱提现时会出现“系统繁忙，请稍后再试”的提示。转账时则会出现“网络通信出现问题，请稍后再试”的字样。
无论是Android版还是iOS版，均受到了本次故障的影响。
腾讯微信出现了大面积的故障，包括转账、提现、朋友圈分享等功能均受到了不同程度的影响。
从网友提供的图片来看，零钱提现时会出现“系统繁忙，请稍后再试”的提示。转账时则会出现“网络通信出现问题，请稍后再试”的字样。
无论是Android版还是iOS版，均受到了本次故障的影响。
关键词： 微信8月21号转账提现失败
热门游戏开服表为什么我的微信修改昵称不能生效_百度知道
为什么我的微信修改昵称不能生效
我给微信修改昵称，保存后过一会就变回原来的，然后在别人的通信录里还是原来的昵称，要怎么才能修改成功？
我有更好的答案
修改头像方法：右上角“设置”-----修改头像----保存，如果不保存的话是没用的。修改昵称方法：右上角“设置”---个人资料----修改姓名（也是“昵称”）----保存微信昵称修改后要点击保存
保存按钮，我已经按了，我用的是6.0版本，右上角是个&+&号啊。
你修改好后，如果你手机上更改过来了，好友的通讯录没更改过来说明还没有跟新缓存，或者别人已经设置了备注名
我搞清楚了，微信是可以改昵称的，因为我改的昵称有敏感字（微信），所以老是改不成功，微信没有提示，所以让我以为软件有问题。
采纳率：79%
来自团队：
为您推荐：
其他类似问题
微信的相关知识
换一换
回答问题，赢新手礼包
个人、企业类
违法有害信息,请在下方选择后提交
色情、暴力
我们会通过消息、邮箱等方式尽快将举报结果通知您。