自建应用 “域名归属校验不通过” 及 “域名主体校验未通过”问题!ToB Dev企微常见问题系列

发布

最近关注到 企微开发者社区和 ToB Dev 公众号下的 企微开发同行群 经常有问 在做企业微信自建应用开发时遇到“域名归属校验不通过” 及“域名主体校验未通过”等问题。这是二个不同问题,经常有同行把他们理解为一个问题,下面为大家分别解析下。


一,域名归属校验不通过


图片


需要进行域名校验。


图片


图片


图片


可信域名分二种,一种是要用于oauth登录的(只能配置一个),另一种是可调用js-sdk,跳转小程序的可信域名这个可以是10个。


“域名归属校验不通过” 问题都是没有完成域名归属验证。何谓域名归属其实就是企业微信设置的一种机制,企微提供一个文件让你上传到自己域名对应的程序下,让企业微信能通过公网(注意一定是公网)访问到这个域名下的文件,这样就能证明此域名是你们公司管理的。


1,很多朋友在自己局域网或者自己测试环境访域名加验证文件能访问就以为通过了,这是需要公网能访问而不是你内部能访问就行了,想想企业微信怎么访问你内部网络... 可自己在浏览器或者让朋友在浏览器打开验证链接验证在公网是否能正确访问。

2,返回并不是原始的txt文件,或者txt的文件内容并不对,大家最好用企业微信提供的原始的txt文件上传到自己服务器。

3,很多在访问原始链接后进行了跳转等,一定要确定企业微信指定的链接能访问。a)有些进行了302或者https跳转导致指定链接不能访问也可能会出问题。b)还有些指定了端口也是要确保协议头加域名加端口加验证文件的原始链接要访问

4,要确保配置的每个可信域名加端口的链接都是要正常访问,有些同行配置了多个可信域名,但只完成了部分可信域名的验证链接能访问,导致某些域名下的程序无法正常调用企业微信api。


可信域名验证完成后会显示已启用及已验证如下面截图。

图片

图片


二,域名主体校验未通过,需配置备案主体与当前企业主体相同或有关联关系的域名

这一般是域名完成归属校验后,可能出现的问题,原因就和描述一样,


图片


1,首页需要清楚 域名备案主体,在大陆我们所有的域名都要在工信部进行备案才能使用的。如果没做过或者不清楚自己当前域名的主体是谁可以进行查询。

a) 进入工信部备案查询网站,输入一级域名查询。

下以https://open.work.weixin.qq.com/企业微信官网的域名为例,它的一级域名为qq.com。

登录工信部备案查询网站

https://beian.miit.gov.cn/#/Integrated/index

图片


图片

点详情,其ICP备案主体的主办单位即为 域名备案主体 

图片


2,然后确认自己企业微信当前的企业的认证主体。

1)登录企业微信后台 https://work.weixin.qq.com 让管理员登录,点我的企业,查看企业全称及确认是否是“已认证”。

图片



3,最后 确认工信部的域名备案主体与企业微信认证的主体是否是同一个。

图片

1,点配置指引

https://open.work.weixin.qq.com/wwopen/common/readDocument/40754

如果确定了域名备案主体与企业微信认证的主体是同一个但不通过,或者域名备案主体主企业微信认证主体二公司之前有上面描述的关连。这二种情况只能找企业微信客服处理。


图片



图片


向客服提供对应信息,等待客服处理目前别无它法。


评论·2
2025/01/06

同问?

赞同
评论
2024/10/09

如果多个企微归属不同主体,但配置的消息回调地址的域名都是同一个,是否能够支持?

多个主体用同一个域名

赞同
评论 2
2025/01/18
同问
赞同
回复
2025/01/20
已解决。多个主体与域名主体证明股权关系
赞同
回复
你还未登录,请先登录