XSwitch用户手册

与其它系统对接

与其它系统对接有很多方法,根据不同的使用场景大约有以下几种方式。

对接运营商 IMS

如果运营商提供 IMS 线路,通常需要注册,根据运营商提供的以下信息建一个网关:

  • 域:如ims.beijing.chinamobile.com之类
  • 注册代理服务器:IP 地址
  • 外呼代理服务器:IP 地址
  • From 域:域
  • 用户名:用户名
  • 密码:密码
  • 其它参数

将网关挂在public这个 SIP Profile 上,以便能接收来话。

去话:本地电话拨打 IMS

做一条路由,目的地选择这个新建的网关。

来话:IMS 拨打 XSwitch

根据运营商提供的 DID(通常跟用户名差不多),做一条路由,可以路由到 IVR,也可以根据 DID 与分机一一对应(在 DID 菜单中设置)。

与其它系统 IP 对接 #

需要的参数:

  • 对端 IP
  • 号码格式,如 E.164 格式或其它格式,长途是否加0之类
  • 支持的音、视频编码

给对端提供的参数:

  • 本端 IP

去话:

  • 加一个网关,将去话路由到该网关,或
  • 做一条路由,将去话路由到 IP 地址,格式有:
    • ip,如192.168.0.1
    • ip:port,如192.168.0.1:5060
    • ip:port;transport=tcp,如192.168.0.1;transport=tcp会使用 TCP 连接对端
  • 加一条中继,路由到该中继
  • 加一个中继组,路由到该中继组

来话:

  • 不验证对方 IP:直接让对方将来话路由到public Profile 对应的 IP 地址和端口(默认为 5080)
  • 验证对方 IP:新建一个分机,将对方 IP 段填入分机的 CIDR 字段
  • 根据 DID 建一条路由

本地 FXS 模拟网关 IP 对接

FXS 口的模拟网关用于把普通的模拟话机(老式话机)变成 SIP 话机。

  • 在 XSwitch 上添加一个分机
  • 将模拟话机插到网关的 S 口,在网关上设置,注册到 XSwitch

本地 FXO 模拟网关 IP 对接

FXO 口的模拟网关用户连接外线,即运营商的线路。

来话:

  • 将 FXO 口网关来话指向 XSwitch 的public Profile 指定的端口
  • 根据 DID 做路由处理来话
  • 如果使用 IP 验证收可以建一个分机,将网关的地址填入分机的 CIDR 字段

去话:

  • 做路由指向网关的 IP

模拟网关注册到 XSwitch

有时候,模拟网关的 IP 不可预测,或在 NAT 后面不可达,如 XSwitch 在云端但模拟网关在办公室的场景。

来话:

  • 模拟网关注册到 XSwitch
  • 将来话送给 XSwitch
  • XSwitch 做相应路由处理来话

去话:

  • 模拟网关注册到 XSwitch
  • 做路由,目的地选择【分机网关】

XSwitch 与 XSwitch 对接

如果有两套 XSwitch 系统需要对接,可以考虑如下几种方式。注意: 我们在此仅讨论对接的方法和技术手段,关于安全性请参阅我们专门的安全指南相关文档。

通过 IP 直联对接

通过 IP 直联对接是最简单的方式,以下假设两个 XSwitch 分别是 A 和 B。

  • 在 A 上设置相应的路由,路由到 IP 地址,填上 B 的 IP 地址和 B 上public Profile 对应的端口。
  • 这样,A 上的呼叫,如果通过这个路由就可以呼到 B 的public Profile 上。
  • 在 B 上,从public Profile 进来的呼叫一般会关联到public或“外部呼入”呼叫源,针对相应的呼叫源和被叫号码做路由即可。
  • 以上步骤实现了 A 呼 B
  • 如果实现 B 呼 A,反向做同样的操作即可。

除此之外,还可以在路由上做号码变换,以实现主被叫号码的传送规范等。

通过这种方式对接,一般可以在内网上进行,并对路由做严格限制,因为这可能会引起越权呼叫(如在 B 上无法区分是从 A 来的呼叫还是外部呼叫,可能导致外部第三方系统的呼叫进入系统后走了比较高权限的路由,导致越权)。

通过 ACL 鉴权

接上面的配置,由于 A 上的呼叫送到 B 上的public Profile 和端口,导致 B 上无法(不容易)区分呼叫是来自 A 还是来自第三方系统,因而无法针对性的分配呼叫权限。如果对呼叫权限要求比较严格,可以使用 ACL 鉴权方式。

  • 在 B 上配置一个分机,设分机号为 A,并且,将 A 的 CIDR 属性设为 A 的 IP 地址,如:192.168.0.1/32
  • 在 A 上照常增加路由通过 IP 方式路由到 B
  • 从 B 上看,由于已知了 A 的地址在 ACL 地址列表里,所有从 A 这个 IP 来的地址都会关联到分机号 A。
  • 如有需要,可以在分机号 A 上开启主、被叫号码透传。
  • 如果 B 需要呼叫 A,按同样的方法反向配置即可。
  • 这种方法由于使用了 ACL 鉴权,所有来自 A 这个 IP 的呼叫都可以通过对分机号 A 设置相应的权限限制它能呼叫哪些目的地(如可以专门给 A 分机设置呼叫源等)。

通过注册方式

  • 在 B 上配置分机号 A,并且不设置 CIDR 属性
  • 在 A 上配置一个网关,用分机号 A 向 B 的default Profile 相应的端口注册,这时,A 服务器相当于一个普通的分机 A,所有来话按普通分机的来话处理
  • 在 B 呼 A 时,可以直接通过呼叫 A 分机号呼通(本地分机),也可以使用“分机网关”方式改变被叫号码。
  • 使用上述方式可以实现 AB 互通,如有需要也可以进一步在 B 上做类似的配置,但不是必须的。

会议

XSwitch 提供音视频会议功能,功能强大而灵活,但在使用前需要做一些基本的配置。

  • 立即会议接入码:默认为*86
  • 立即会议字冠:默认为72,位长9
  • 预约会议字冠:默认为71,位长9
  • 以上信息需要在全局变量及路由中进行相关设置

最好选一个专用号段作为会议号段以免与系统冲突。如果直拨本地网号码(外线不加0),一般来说本地网号码都是7-8位,因此可以设置更严格的路由,与位长为9的会议字冠区分。

如果需要邀请,则还需要进行邀请相关的接入设置,如规划 DID 等,详询系统支持工程师。

其它

IP 与 IP 对接需要根据使用场景考虑是否对对端的 IP 进行验证,以保证呼叫的安全性。一般来说,对通比较容易,但是安全性要充分考虑及论证。XSwitch 有专门的安全指南文档,详情请咨询我们的商务和技术支持人员。

使用场景说明