几乎所有的开发和配置工作都围绕着某个应用展开。
支持的操作
可信域名
此项在本地只读,应在企业微信后台事先配置好。
在设置可信域名框中点击
申请校验域名
,按照提示下载文件放在平台\webserver\webapps\ROOT中,如没有ROOT在portal同级目录手动创建ROOT文件夹,在勾选已上传域名归属校验文件,并按提示在浏览器地址栏中输入URL校验访问正常
如果AWS PaaS的Web URL服务有端口号,那可信域名
也必须加上端口号。如果为正式环境,可信域名
必须是一个通过ICP备案验证的互联网域名,如应用页面需要使用微信JS-SDK,需完成域名归属验证。
//例子1
b2b.awspaas.com
//例子2
b2b.awspaas.com:8088
密钥设置
将企业微信后台该应用的回调模式>回调URL及密钥
的Token
、EncodingAESKey
项复制到本地应用的回调Token
和EncodingAESKey
。该项握手配对过程,只需设置一次。
微信应用配置 | 本地应用配置 |
---|---|
本地应用的
回调Token
和EncodingAESKey
配置完毕后,请先点击确定
,使之生效。这样可以在微信后台为接下来的回调URL设置,提供OAuth验证的自动化检查。
回调URL设置
第一次配置时,本地应用会自动生成回调URL
,将其复制到微信后台该应用的回调模式>回调URL及密钥
的URL
项即可。该项握手配对过程,只需设置一次。
注意:
可信域名
一致,如果URL服务有端口号,那可信域名
也必须加上端口号。http://localhost
,说明您的AWS PaaS本地开发环境未设置用域名可访问的地址(见bin/conf/aws-portal.xml
配置的portal>url项),需要改为用域名可访问的地址本地应用配置 | 微信应用配置 |
---|---|
如果本地应用尚未配置
回调Token
和EncodingAESKey
,在企业微信后台保存回调URL时,可能会抛出echostr校验失败,请您检查是否正确解密并输出明文echostr
错误
接收变更通知
见企业微信后台该应用的接收消息>已启用API接收>回调URL及密钥
相关项
上报进入事件
见企业微信后台该应用的接收消息>已启用API接收>接收的消息事件类型
相关项
企业微信要求菜单最多为两级,一级菜单最多为3个,二级菜单最多为5个。菜单类型说明可参照企业微信接口文档
如果菜单类型是
跳转网页
,且URL请求来自AWS PaaS的原生URL服务,请简写成cmd=xxx&参数...。在发布到微信时,系统会自动按企业微信规范补齐完整的调用地址
点击左下角的图标,弹出当前AWS PaaS平台支持微信应用部署的App,完成关联操作。
这是一个重要操作,只有通过菜单关联,该企业微信应用所推送的消息、事件才能分发给被关联的本地AWS PaaS应用。
这里采用了复制而不是关联,当本地某个AWS PaaS应用的微信菜单结构发生变化后,需要重新部署。