企业微信-内部应用域名与ip白名单
前言
对于企业微信自建应用的开发,这一步是非常重要的。本章重点介绍一些常用的参数和整个开发过程中需要注意的几个小细节。(个人学习使用并不全面,如有错误欢迎指正。绝对听劝!)
一、创建自建应用
很简单,首先进入管理企业选择应用管理在最下面点击创建应用即可。
注意:应用的可见访问不仅仅是谁能看到该应用,后续获取通讯录数据也和这个设置有关
ps:登录企业微信点自己头像菜单最后一栏可快速打开管理企业页面。
二、重点参数
企业自建应用有几个参数需特别注意
参数名 | 中文 | 描述 |
---|---|---|
corpid | 企业ID | 在我的企业->企业信息最后一行可获取 |
agentId | 应用ID | 在自建应用的详情页面可获取,一定不要和corpid混淆 |
corpsecret | 应用密钥 | 同上页面获取,注意该密钥比较重要如有泄漏需及时重置 |
access_token | 令牌 | 这个令牌需要通过corpid和Secret获取,今后所有和企业微信交互的接口都需要携带access_token 文档入口 |
二、可信域名与ip白名单(本章重点)
-
域名:
没错你嘚有一个域名才能接企业微信。阿里云域名购买入口
这里我要吐槽一下,之前对接时由于公司认证主体和域名主体不一致导致无法配置可信域名,因此耽误了非常多的时间。大家需要重点注意。(如果你的企业没有认证主体可以不用考虑一致性问题)
听说企业主体和域名主体要一致这个设定被企业微信舍弃了,但描述还在,不知道是不是真的,有尝试配置不同主体认证成功的朋友麻烦告知一声,谢谢!
温馨提示:可信域名可不必设置ssl证书,但如果你需要接企业微信登录还是推荐配一个的,因为企微登录在域名是https时能成功触发自动登录回调。 -
校验:
域名申请下来挂好ip后需要在域名的根目录下放一个文件,该文件看点上图的 申请校验域名 即可获得。
文件放到指定位置并且可以通过浏览器访问到内容后填上域名点击确定即可。一定要域名的根路径!
如果出现如下图所示,请赶紧检查一下域名拼接文件名是否能通过浏览器获取到。
-
白名单:
前面两部成功后,就可以配置ip白名单了,首先先把域名绑定的ip配置上。
如果需要本地调试可以将本地电脑的ip配置上。IP小工具
总结
也没什么难点,唯一可能出问题的地方就在校验环节,校验环节的校验文件放对了而且能通过url访问几乎等于成功了。希望这篇文章能帮到大家,后续也会陆续出一些接企业微信的文章,有错的地方欢迎指正。