VOS3000 网关呼叫认证
客户的每一通呼叫都必须关联到正确的对接网关,从而关联到正确的账户。这个设置决定了如何关联。
更新于 · 作者:VOS3000 Web 团队
简要回答:VOS3000 对接网关上的呼叫认证方式决定如何将呼入的呼叫与客户匹配:按 IP、按 IP地址与端口,或者必须密码认证。未通过检查的呼叫在话单中以 CallAuthenticationFailure (-6) 结束。
- 位置
- 对接网关,补充设置,协议,SIP
- 方式
- IP、IP地址与端口、必须密码认证
- 检查失败
- CallAuthenticationFailure (-6)
- 未知的 IP 和号码
- IllegalCall (-9)
设置位置
打开导航 → 业务管理 → 网关业务 → 对接网关,编辑该客户的网关并进入补充设置 → 协议 → SIP。字段名为呼叫认证方式。它与补充设置 → 常规中的IP地址字段配合使用,在该字段中可以列出多个地址并附带信令端口,用逗号分隔。
三种方式
| 方式 | VOS3000 检查的内容 | 适用场景 |
|---|---|---|
| IP | 源 IP 地址。 | 客户从只有其自己使用的固定 IP 发送呼叫。 |
| IP地址与端口 | 源 IP 和端口。 | 多个客户或中继从同一个 IP 的不同端口发送呼叫。 |
| 必须密码认证 | 密码质询。 | 客户的 IP 会变化,或者您希望在地址之外再加一道检查。 |
静态和动态网关在这里同样重要。静态网关(补充设置 → 常规中的网关类型)直接按 IP 地址匹配;动态网关必须注册,并使用其网关名称进行认证,配置密码作为注册密码。如果两个静态网关共用一个 IP,由优先级决定匹配哪一个。
密码认证设置
| 参数 | 默认 | 作用 |
|---|---|---|
| SS_SIP_AUTHENTICATION_CODE | Unauthorized(401) | 对不带 Authorization 或 Proxy-Authorization 的 REGISTER 或 INVITE 的回复。 |
| SS_SIP_AUTHENTICATION_TIMEOUT | 10 秒 | 在此时间内未完成认证的主叫将被拒绝。 |
| SS_AUTHENTICATION_MAX_RETRY | 6 | 终端密码最大重试次数(0 至 999)。 |
| SS_AUTHENTICATION_FAILED_SUSPEND | 180 秒 | 重试次数过多后终端被禁用的时长(60 至 3600)。 |
这些限制也能减缓密码猜测;参见防欺诈设置。
解决 CallAuthenticationFailure (-6)
话单中的CallAuthenticationFailure (-6)表示 VOS3000 在认证步骤拒绝了该呼叫。请按以下顺序排查:
- 呼叫来自哪个 IP?将话单中的主叫 IP 与网关的IP地址列表进行比较。客户新增了服务器或第二个出口 IP 是常见原因。
- 哪个端口?在 IP地址与端口方式下,位于 NAT 之后或有多台服务器的客户可能会从您未列出的端口发送呼叫。如果该地址只属于该客户,请改用 IP 方式。
- 密码方式:客户的交换机必须在超时时间内用正确的凭据回应 401 质询。许多中继侧设备从不回应 INVITE 质询,因此开启前请先确认。
- 查看信令。开启调试跟踪,查看 INVITE 及其回复;参见调试跟踪。
不要将它与IllegalCall (-9)混淆:手册将非法呼叫定义为来自未授权 IP、且主叫号码未在平台上注册的呼叫,即根本没有匹配到任何对接网关。系统参数 SS_CDR_RECORD_ILLEGAL (开启)会记录这些呼叫,有助于发现扫描器。其他代码请参见呼叫失败。
关于本主题的常见问题
VOS3000 中的呼叫认证方式是什么?
对接网关的一项设置,决定 VOS3000 如何识别来自客户的呼叫:按 IP、按 IP地址与端口,或者必须密码认证。
CallAuthenticationFailure (-6) 是什么意思?
VOS3000 无法依据对接网关对该呼叫进行认证,因此拒绝了它。请检查客户发送的 IP、端口和密码。
-6 与 -9 IllegalCall 有什么区别?
IllegalCall 表示主叫的 IP 不在任何对接网关上,且主叫号码不是平台上的话机。-6 则表示呼叫被认证检查拒绝。
两个客户能否共用一个 IP 地址?
可以。使用 IP地址与端口方式并为每个客户设置不同的信令端口,或者使用密码认证。对于 IP 相同的静态网关,由优先级决定匹配哪一个。
运行 VOS3000,无需操心服务器
选择由我们托管的 VOS3000 服务器,或由我们在您自己的服务器上安装 VOS3000。均附带 VOS3000 Web 和 Android 应用。