【企微安全升级解读】基础应用、自建应用的 IP 及域名设置限制
解读背景
最近关注到企微开发者社区和 ToB Dev 公众号下的企微开发同行群里,经常有人问到 基础应用 及 自建应用 填写企业可信 IP 白名单、回调 URL 地址时报错的问题, 以及自建应用填写网页授权及JS-SDK的可信域名报错的问题。
基础应用:通讯录同步、会话内容存档等企业微信自带的应用,官方文档常称基础应用,我们同行常称企微系统应用。
自建应用:企业在自己企业微信后台应用管理下自建应用类别创建的应用。
常见问题
这些问题对应具体的表现、截图、文档与解决思路如下:(部分错误截图来自企业微信开发者中心 及 ToB Dev 十六个企微同行群)
可信域名验证不通过
问题表现:
在新建的自建应用设置可信域名时报“该域名为第三方服务商” 或者 “校验主体校验未通过”,无法确认保存。
出现这个问题,一般为以下三种情况:
- 可能是给自己公司做自建应用,使用的不是自己企业备案的域名;
- 可能是有些开发者给客户做开发,使用了自己公司的域名;
- 可能这个域名已经被服务商在第三方应用使用过;
解决思路:
按惯例出现问题先查官方文档,通过企微开发者中心的相关接口文档及升级文档查阅了解:在企业微信进行安全性升级后,基础应用(通讯录同步、会话内容存档等应用)及自建应用填写的域名,需要域名备案的企业主体与企业微信认证的企业主体是同一个,或者有关连(关连需要联系企业微信客服证明关连性例如分公司使用总公司备案域名等)。
解决方法就比较明显了:
- 如果是给自己公司做开发,那么需要将企业微信进行企业主体认证并备案同主体的域名
- 如果是开发者给客户做开发,可以申请成为服务商创建自建代开发应用,让客户安装使用,自建代开发应用的域名可以使用服务商的域名。
可参考官方文档: 企业微信自建应用安全性升级上线通知(8月15日)
二、企业可信 IP 验证不通过
问题表现:
公司在基础应用(通讯录同步、会话内容存档等应用)及自建应用在设置可信 IP 时,提示“以下新加入的 IP 地址属于第三方服务商”。
这问题出现其实和上面的域名原因大致相同,不过这个 IP 被识别为第三方服务商,这是由企业微信官方的算法(官方没有公开)判断的。
根据我们 ToB Dev 企微开发同行群大多同行经验,一般是此 IP 被用于了多个企业的自建应用及基础应用,或者是已经在服务商的 IP 白名单设置使用过。
解决思路:
按惯例出现问题先查官方文档,通过企微开发者中心的相关接口文档及升级文档查阅了解。基础应用(通讯录同步、会话内容存档等应用)及自建应用在企微安全性升级后需设置可信 IP,并且此 IP 不能填写被服务商白名单使用过的 IP(据同行群友经验也有可能存在多个企业上使用过的 IP 被判定为服务商 IP)。
可查看官方文档: 自建及代开发应用安全性升级
三、自建应用需先设置域名才能设置IP问题
问题表现:
此问题比较简单,在设置企业可信IP时提示“配置企业可信IP前,请先设置可信域名”。
解决思路:
按惯例出现问题先查官方文档,通过企微开发者中心的相关接口文档及升级文档查阅了解。这个是 2002.09.16 新发的通知,按照要求先完善域名就行了,个人感觉是在原自建限制域名和 IP 后的升级。
可查看官方文档:企业自建应用配置IP前需先设置域名(9月16日)
总结
这些限制最影响的,还是原来一些服务商给企业做了自建应用,并且还有些给客户配置了基础应用的同行。企微在基础应用及自建应用进行安全性升级后,对其IP及域名进行了严格的限制,不能随意创建自建应用及在已有基础应用及基础应用上设置被识别为服务商的IP与非当前企业的域名。
现在自建应用这么多限制,如果以往给企业做批量自建应用的同行,建议大家转自建代开发或者第三方应用。同时企业微信官方也提供了自建转开发的功能可以向官方申请转移,原自建应用的转自建代开发适配难度比第三方要低些。
劳资曹死尼的玛,我用公司的二级域名校验不通过,一级域名校验也不通过,那踏马怎么开发,都在通讯录那边配置可信IP了,在自建应用还要配置,配置之前还要配置域名,哪个脑瘫想出来的,尼玛死了
怎么恶心到极致
越来越搓,瞎搞
可以骂人吗?
越来越严了, 哪哪都要实名要人脸, 关键好多还不给开放
开发好应用 被这域名心累,挣着钱,折腾的心里添堵
请问我自己公司用阿里云的ip 会报ip是第三方服务商的吗
本来只是小组使用,现在要上升到公司层面,非常麻烦
感谢李月喜老哥奉献,周末才在B站上看到你关于企微的一些视频。
企业微信真的搞复杂了,特别是对个人学习人员,没有注册企业的,用起来处处受制;而且企微经常变动大,太影响了
都是为了大家考虑,别埋怨。不转第三方怎么收你们钱呢!以后按接口调用次数收费哈哈
没注意是开发者投稿的,我以为官方发的,你这写的还是不错的,对那些刚接触的人来看是不错的
ToB Dev真的让我少踩很多坑,感谢群里的大佬,辛亏入坑直代开发,不然今天抱怨的人肯定有我一个
企微这生态真是tmd不是给人玩的,早晚完蛋
集团下兄弟公司双方盖公章都不行,一定要我在房产证上提供证明我是我妈生的,NM脑残逻辑
我都不考虑我的安全,你强制我安全。嗯 合理 👍
整复杂了呀
赞赞,深入了解相关的限制
真是脑子抽了瞎搞,本来IP白名单就一定程度上相对安全了。
后来要求必须有备案域名,
然后后面又要求必须为主体域名。
我们外贸企业根本都没备案过,这是变相给你腾讯云发展潜在客户吧。
脑子有坑的产品经理
企业微信有些功能越来越难用了,功能多了一点不简洁了
不知道钉钉,有没有相应对策。说不定又能收一批用户呢
老大威武
多看看避免踩坑👍🏻
垃圾腾讯,为了钱不择手段!
这个变化要赶走了不少用户了,我们公司自己在Salesforce上开发的应用,应该算自开发的,只不过域名用的salesforce,就认证不了了
好像说了,又好像啥都没说