企业微信开发：自建应用：获取企业微信IP段（用于防火墙配置）

拼搏现实的明天。 2024-02-05 21:18 29阅读 0赞

## 概述 ##

在企业微信开发流程中，为了确保与企业微信API的网络通信安全，并适应防火墙配置要求，开发者需要获取企业微信API服务的IP地址范围。这样，仅允许与企业微信官方通信的合法请求通过防火墙，从而保障数据传输的安全性。

![在这里插入图片描述][471ffae8e146420da7ccb833ee9ff091.png]

## 企业微信IP地址分类 ##

在与企业微信的交互过程中，信息传递涉及两个方向：

1.  从企业服务器向企业微信服务器发送消息；
2.  从企业微信服务器向企业服务器推送回调信息。

这两类信息传输分别对应着企业微信中的两组服务器 —— `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段

![在这里插入图片描述][291ccd8e5c7947919eabfb99291c1fff.png]

*  获取企业微信回调IP段

![在这里插入图片描述][155a52e25d5e468ca8ad30363093e3e3.png]

## 接口调用示例 ##

*  获取企业微信接口IP段

![在这里插入图片描述][d46ea6a7d7064199b40c925aec174ba7.png]

*  获取企业微信回调IP段

![在这里插入图片描述][586a8eab8f4c41b79a0bd05d4ac264e4.png]

--------------------

## IP段与具体应用无关 ##

经过测试，不同的应用，获取到的企业微信IP段，是相同的；也就是说，IP段与具体应用其实是没有对应关系的。

两个不同的应用，分别获取 access\_token ，然后调用接口，获取企业微信的 **接口IP段** ，经过对比，IP段是完全相同的。同样，获取企业微信的 **回调IP段**，IP段也是完全相同的。

*  接口 IP段

左右两边对比的文本，分别是两个不同应用获取到的 **接口IP段**，完全相同。

![在这里插入图片描述][8793de2e530c4e289cefcd5f6b895dde.png]

*  回调IP段对比

左右两边对比的文本，分别是两个不同应用获取到的 **回调IP段**，完全相同。

![在这里插入图片描述][e0f783310e4b42f8840a42bf5f86a3ca.png]

[471ffae8e146420da7ccb833ee9ff091.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/81733866e9d044a78a04493d4171020f.png
[IP]: https://developer.work.weixin.qq.com/document/path/92520
[IP_]: https://developer.work.weixin.qq.com/document/path/92521
[291ccd8e5c7947919eabfb99291c1fff.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/8b3e822c76f94164b562025952931e65.png
[155a52e25d5e468ca8ad30363093e3e3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/5d2e58216a12403982027fddec3b209a.png
[d46ea6a7d7064199b40c925aec174ba7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/628847d99a5f4a79874d7e6adc98d31a.png
[586a8eab8f4c41b79a0bd05d4ac264e4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/917a49b17f5e48db97fa41c87e6694ec.png
[8793de2e530c4e289cefcd5f6b895dde.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/c1675f6f325f420e830ed8188b46f27d.png
[e0f783310e4b42f8840a42bf5f86a3ca.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/1b1da4d8b02f4796acd502d34647af8a.png