静态 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:事件回调 | 事件与签名 |
| 推送产品 | 推送配置 |
| 客户端环境要求 | 座席侧网络 |
| 安全白皮书 | 传输加密与访问控制 |
Updated about 2 months ago
Did this page help you?