静态 IP 地址

快速阅读

平台发往企业服务器的 Webhook 和 API 回调,默认从一组固定出口 IP 发出。企业在自己的防火墙上放行这些地址。

  • 平台侧没有单独的「打开静态 IP」步骤。出站 HTTP 默认走固定出口。
  • 现稿把地址写成占位符,没有公布具体网段。可用列表按部署区域向支持索取。
  • 生产有主用、备用两段;预发 / 测试另有一段,按环境使用。
  • 中国(cn-1)和国际区域都提供静态出口,国际区域的具体地址向支持索取。
  • 地址调整时,现稿写明至少提前 30 天通知登记的管理员邮箱。
  • 白名单只限制来源地址。HTTPS、API Key、请求签名仍按集成文档配置。

阅读地图

  • 出口怎么用、列表向谁要:读「二」「三」。
  • 防火墙放行什么:读「四」。
  • 区域、变更通知、收不到回调:读「五」「六」。

一、文档说明

本文说明呼叫中心平台出站 HTTP 的来源地址:Webhook、API 回调从哪些固定出口出去,企业防火墙如何放行。

适用:企业网络管理员、集成开发、实施顾问。

推送内容与事件见 推送产品、Webhooks:事件回调。座席终端网络见 客户端环境要求。

二、出站范围

固定出口覆盖平台发出的 Webhook 请求和 API 回调。企业用这组地址做入站访问控制,核对请求是否来自平台基础设施。

这组地址随部署区域变化。本文不填写未核实的网段。向支持索取当前区域的有效列表后再写入防火墙。

三、地址怎么提供

环境现稿中的分段文档里的写法
生产主 IP 段、备用 IP 段占位,向支持索取
预发 / 测试测试 IP 段占位,按需索取

两段生产地址都要放行。只放主用时,切到备用出口会导致回调到不了。

区域现稿说明
中国(cn-1)可用,使用该区域的静态 IP 池
国际区域可用,具体地址向支持索取

四、企业防火墙

在企业侧放行支持提供的网段,协议为 HTTPS,端口 443。云上安全组和网络 ACL 同样放行这些来源。

放行来源之后,仍要做这几件事:

  • 端点使用 HTTPS。
  • 按集成要求校验 API Key 和 Webhook 签名。
  • 先在预发核对,再改生产防火墙。
  • 定期看访问日志,确认来源落在已放行的网段内。
  • 收到地址变更通知后更新规则。

五、变更通知

因基础设施升级、区域扩展或安全加固需要调整出口地址时,至少提前 30 天通知登记的管理员邮箱。

六、收不到或时断时续

现象先核对
回调被拦截主用和备用网段是否都在防火墙、安全组、ACL 里;服务端口是否为 443
投递不稳定是否只放了主用;前面是否有会改写来源地址的负载均衡或代理;端点是否返回 HTTP 200

支持邮箱:[email protected]。当前网段也可以通过开通时的对接人索取。

七、相关阅读

文档用途
Webhooks:事件回调事件与签名
推送产品推送配置
客户端环境要求座席侧网络
安全白皮书传输加密与访问控制

Did this page help you?