VOS3000 操作指南

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_CODEUnauthorized(401)对不带 Authorization 或 Proxy-Authorization 的 REGISTER 或 INVITE 的回复。
SS_SIP_AUTHENTICATION_TIMEOUT10 秒在此时间内未完成认证的主叫将被拒绝。
SS_AUTHENTICATION_MAX_RETRY6终端密码最大重试次数(0 至 999)。
SS_AUTHENTICATION_FAILED_SUSPEND180 秒重试次数过多后终端被禁用的时长(60 至 3600)。

这些限制也能减缓密码猜测;参见防欺诈设置。

解决 CallAuthenticationFailure (-6)

话单中的CallAuthenticationFailure (-6)表示 VOS3000 在认证步骤拒绝了该呼叫。请按以下顺序排查:

  1. 呼叫来自哪个 IP?将话单中的主叫 IP 与网关的IP地址列表进行比较。客户新增了服务器或第二个出口 IP 是常见原因。
  2. 哪个端口?在 IP地址与端口方式下,位于 NAT 之后或有多台服务器的客户可能会从您未列出的端口发送呼叫。如果该地址只属于该客户,请改用 IP 方式。
  3. 密码方式:客户的交换机必须在超时时间内用正确的凭据回应 401 质询。许多中继侧设备从不回应 INVITE 质询,因此开启前请先确认。
  4. 查看信令。开启调试跟踪,查看 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 应用。