微信企业号第三方应用开发[一]——创建套件

注：文中绿色部分为摘自微信官方文档

第三方应用提供给企业的是一个应用，但是应用必须在套件下创建，所以第一步是要创建套件。

注册成为应用提供商，必须输入以下信息：

注册条件：a）拥有一个已经过认证的企业号 b）用系统管理员身份进行申请

摘自http://qydev.weixin.qq.com/wiki/index.php?title=%E5%BA%94%E7%94%A8%E6%8F%90%E4%BE%9B%E5%95%86%E6%B3%A8%E5%86%8C%E5%BA%94%E7%94%A8　

符合以上条件后，登录微信第三方应用官网，选择“服务商登录”

创建应用套件

开发者完成注册之后，即可创建应用套件。应用套件是第三方应用授权的主体，接口的开发都与应用套件息息相关，请开发者仔细阅读下方内容。

基本信息：

注意：

1）你应谨慎选择所填写的行业和标签，行业是指可使用该套件企业所属的行业。当应用套件达到一定的活跃度后（授权企业数和日活跃用户数），会自动在企业号第三方官网进行推荐，套件所在的分类将基于所设置的行业和标签。

2）授权方式的作用在于区分应用套件是否可以直接从企业号第三方官网发起授权，线上自助注册授权使用是指该应用套件可以直接从企业号第三方官网发起授权，而不跳转服务商网站，该类型的应用套件还可以支持移动端发起应用套件授权；服务商辅助授权使用是指该应用套件必须跳转服务商网站，从服务商网站发起应用套件的授权，该类型的应用套件不支持移动端发起应用套件授权。

3）你可以创建或者选择其他开发者已创建的标签。你应该谨慎选择套件标签，用户往往会在企业号中通过标签查找相关联的套件。

开发信息：

创建完成之后，系统会告知开发者该应用套件的Suiteid和Suitesecret。（详见第三方应用接口说明）

摘自http://qydev.weixin.qq.com/wiki/index.php?title=%E5%BA%94%E7%94%A8%E6%8F%90%E4%BE%9B%E5%95%86%E6%B3%A8%E5%86%8C%E5%BA%94%E7%94%A8

 登陆后界面如下，选择添加应用套件

进入创建套件页面，填写基本资料

点击下一步，填写开发资料

验证URL有效性

当你提交以上信息时，企业号将发送GET请求到填写的URL上，GET请求携带四个参数，企业在获取时需要做urldecode处理，否则会验证不成功。

企业通过参数msg_signature对请求进行校验，如果确认此次GET请求来自企业号，那么企业应该对echostr参数解密并原样返回echostr明文(不能加引号，不能带bom头，不能带换行符)，则接入验证生效，回调模式才能开启。

摘自http://qydev.weixin.qq.com/wiki/index.php?title=%E5%9B%9E%E8%B0%83%E6%A8%A1%E5%BC%8F

"系统事件接收URL"响应的代码如下

/**
     * 测试微信企业号第三方应用回调协议
     * @author:leap
     * @MethodName: testWXSaaSCallback
     * @Description:
     * @param req
     * @param res
     * @date:2016-8-9
     */
    @RequestMapping(value="testWXSaaSCallback")
    @ResponseBody
    public void testWXSaaSCallback( HttpServletRequest req, ServletResponse res){
        //常量值
        String CORP_ID = "wx9671de0651dbdxxx";    //CorpId, 企业号的普通管理组中可查看
        String SUITE_ID = "tja2312bedd5086xxx";    //套件ID，在套件信息中查看
        String SUITE_SECRET = "LGVT0BrN2DZ7VMTuIPOsudaWuXOE0iM67yHpIs1ofESS4l-jSC8LN9nOnmilhXXX";
        String SUITE_TOKEN = "ssI2AnbgOo40eb0kOxxx";
        String SUITE_ENCODING_AES_KEY = "Pmqgjzwt4yAEK9N6YZ34RKpy6onJD56r8mhCUFG9xxx";

        //获取参数
        String msgSignature = req.getParameter("msg_signature");
        String timestamp = req.getParameter("timestamp");
        String nonce = req.getParameter("nonce");
        String echostr = req.getParameter("echostr");    //创建套件时验证回调url时传入

        String result = "";
        try {
            if(!Utils.isBlank(echostr)){    //=======验证回调url有效性=======
                WXBizMsgCrypt wxBizMsgCrypt = new WXBizMsgCrypt(SUITE_TOKEN,
                        SUITE_ENCODING_AES_KEY, CORP_ID);//注意是CORP_ID
                result = wxBizMsgCrypt.VerifyURL(msgSignature, timestamp, nonce, echostr);
                System.out.println(result);
                res.getWriter().write(result);    //对echostr参数解密并原样返回echostr明文(不能加引号，不能带bom头，不能带换行符)
            }else{
                //其他操作
                res.getWriter().write("false");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

 其中类WXBizMsgCrypt由官方提供

java库(2014年9月24日更新,点击下载)

注意事项：

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

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

3.请开发者使用jdk1.6或以上的版本。针对org.apache.commons.codec.binary.Base64，需要导入jar包commons-codec-1.9（或commons-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目录下覆盖原来文件。

摘自http://qydev.weixin.qq.com/wiki/index.php?title=%E5%8A%A0%E8%A7%A3%E5%AF%86%E5%BA%93%E4%B8%8B%E8%BD%BD%E4%B8%8E%E8%BF%94%E5%9B%9E%E7%A0%81

红字部分是必要操作，不可忽略

[目录]

[上一篇] 微信企业号第三方应用开发[前言]