企业微信开发:自建应用:获取企业微信IP段(用于防火墙配置)
在企业微信开发流程中,为了确保与企业微信API的网络通信安全,并适应防火墙配置要求,开发者需要获取企业微信API服务的IP地址范围。这样,仅允许与企业微信官方通信的合法请求通过防火墙,从而保障数据传输的安全性。
概述
在企业微信开发流程中,为了确保与企业微信API的网络通信安全,并适应防火墙配置要求,开发者需要获取企业微信API服务的IP地址范围。这样,仅允许与企业微信官方通信的合法请求通过防火墙,从而保障数据传输的安全性。
企业微信IP地址分类
在与企业微信的交互过程中,信息传递涉及两个方向:
- 从企业服务器向企业微信服务器发送消息;
- 从企业微信服务器向企业服务器推送回调信息。
这两类信息传输分别对应着企业微信中的两组服务器 —— API服务器
和回调服务器
,它们可能拥有不同的IP地址段。因此,为了实现双向通信的畅通无阻,企业需要将这两组IP地址段都配置到防火墙中;如果只是单方向通信,则只需配置对应方向的IP地址段。
企业微信服务器中,API服务器接收企业发送的信息,回调服务器发送信息给企业服务器,分别对应着两条信息传递路径。这两组服务器,可能会有不同的IP地址;所以,为了能和企业微信服务器进行双向通信,需要将两组IP端,都配置到防火墙中,以确保通信畅通。
- 企业微信
接口IP段
(关联于API服务器
); - 企业微信
回调IP段
(关联于回调服务器
);
获取企业微信IP段的方法
企业微信官方提供了两个专门的接口来获取这两个IP地址段,具体调用方法在官方文档中有详细说明:
获取企业微信接口IP段
- 请求方式:GET(HTTPS)
- 请求地址: https://qyapi.weixin.qq.com/cgi-bin/get_api_domain_ip?access_token=ACCESS_TOKEN
获取企业微信接口IP段
- 请求方式:GET(HTTPS)
- 请求地址: https://qyapi.weixin.qq.com/cgi-bin/getcallbackip?access_token=ACCESS_TOKEN
IP地址变更
企业微信的IP地址段可能会发生变更,当变更发生时,新旧IP段会并行保留一段时间以保证平稳过渡。因此,企业微信官方建议开发者每天定时查询和更新IP地址段,并调整防火墙设置,避免因IP段变化导致通信中断。
官方文档
-
企业微信
接口IP段
:获取企业微信接口IP段 -
企业微信
回调IP段
:获取企业微信回调IP段
以下是获取企业微信IP段的官方文档截图(实际使用时请参考最新官方文档):
- 获取企业微信回调IP段
- 获取企业微信回调IP段
接口调用示例
- 获取企业微信接口IP段
- 获取企业微信回调IP段
IP段与具体应用无关
经过测试,不同的应用,获取到的企业微信IP段,是相同的;也就是说,IP段与具体应用其实是没有对应关系的。
两个不同的应用,分别获取 access_token ,然后调用接口,获取企业微信的 接口IP段 ,经过对比,IP段是完全相同的。同样,获取企业微信的 回调IP段,IP段也是完全相同的。
- 接口 IP段
左右两边对比的文本,分别是两个不同应用获取到的 接口IP段,完全相同。
- 回调IP段对比
左右两边对比的文本,分别是两个不同应用获取到的 回调IP段,完全相同。
更多推荐
所有评论(0)