freeswitch的多租户模式

 

概述

freeswitch是一款简单好用的VOIP开源软交换平台。

现在的VOIP服务越来越倾向于云端服务，包括呼叫中心云服务，线路云平台。

而云平台对多个客户的服务就需要做好隔离，包括数据隔离、线路隔离、服务隔离等。

freeswitch内部的多租户模式根据不同用户SIP域的配置，来实现呼叫的服务隔离。

环境

centos：CentOS  release 7.0 (Final)或以上版本

freeswitch：v1.10.7

GCC：4.8.5

多租户模式

云端的服务不可能只提供给一个客户使用，如何在服务上区分客户，做到数据和资源的隔离。

服务中的多租户模式意味着多个客户可以同时使用一套服务，但又要求不会互相影响。

对于VOIP服务来说，多租户代表在整个服务系统中，多家公司通过一定的规则实现号码、路由规则、资源的互相隔离，同时又互不影响，最大程度的利用好有限的资源。

对于云端PBX来说，多个客户甚至可以使用相同的sip账号注册和呼叫，又各自独立。

fs已经实现了通过SIP域的方式，达到多租户模式的效果。

配置方案

复制并修改注册端口文件conf/sip_profile/internal5062.xml，不再强制修改用户注册SIP域为"$${domain}"。

<!-- <param name="force-register-domain" value="$${domain}"/> -->

<!-- <param name="force-subscription-domain" value="$${domain}"/> -->

<!-- <param name="force-register-db-domain" value="$${domain}"/> -->

修改sip终端10011账户注册信息，使用“test123.com”的SIP域注册。

domain修改为”test123.com”。

domain proxy的send outbound via设置为”10.55.55.138:5062”。

10011终端的注册信令如下。

REGISTER sip:test123.com SIP/2.0

Via: SIP/2.0/UDP 10.9.0.16:14542;branch=z9hG4bK-d87543-ef1e50670e66bb09-1--d87543-;rport

Max-Forwards: 70

Contact: <sip:10011@10.9.0.16:14542;rinstance=1937ab4fc61e1076>

To: "10011"<sip:10011@test123.com>

From: "10011"<sip:10011@test123.com>;tag=0479973d

Call-ID: MzU2MjgzMmI2NWM3ZmM2YTE5YTJmYzZmM2E2NTdlZjM.

CSeq: 1 REGISTER

Expires: 3600

Allow: INVITE, ACK, CANCEL, OPTIONS, BYE, REFER, NOTIFY, MESSAGE, SUBSCRIBE, INFO

User-Agent: eyeBeam release 1004p stamp 31962

Content-Length: 0

freeswitch注册告警信息，注册失败，因为还没有设置”test123.com”对应的SIP域信息。

2022-12-12 16:05:17.568684 [WARNING] sofia_reg.c:2973 Can't find user [10011@test123.com] from 10.9.0.16

You must define a domain called 'test123.com' in your directory and add a user with the id="10011" attribute

and you must configure your device to use the proper domain in it's authentication credentials.

复制并修改conf/directory/default5062.xml，设置”test123.com”对应的SIP域信息，域用户的user_context使用test123.com。

<domain name="test123.com">

...

<variables>

  <variable name="user_context" value="test123.com"/>

</variables>

...

  <group name="default">

    <users>

      <X-PRE-PROCESS cmd="include" data="default5062/*.xml"/>

    </users>

  </group>

复制并修改conf/directory/default5062/10011.xml，删除账户默认的user_context设置，统一使用SIP域设置的user_context。

删除行<variable name="user_context" value="default"/>

修改conf/dialplan/test.xml拨号计划，增加context为test123.com的呼叫流程。

<context name="test123.com">

    <extension name="test123">

           <condition field="destination_number" expression="^(\d+)$">

            <action application="bridge" data="user/$1@test123.com"/>

        </condition>

    </extension>

</context>

测试

使用10011呼叫1002，测试日志如下。

2022-12-12 17:29:03.375298 [INFO] mod_dialplan_xml.c:637 Processing 10011 <10011>->1002 in context test123.com

Dialplan: sofia/internal5062/10011@test123.com parsing [test123.com->test123] continue=false

Dialplan: sofia/internal5062/10011@test123.com Regex (PASS) [test123] destination_number(1002) =~ /^(\d+)$/ break=on-false

Dialplan: sofia/internal5062/10011@test123.com Action bridge(user/1002@test123.com)

10011账户的呼出流程使用“context test123.com”的拨号计划。

总结

freeswitch可以通过不同的SIP域配置实现多租户模式，针对云端服务的用户配置有一定的参考意义。

多租户模式的呼出流程通过注册SIP域实现隔离，回呼流程则需要根据号码或端口的方式来区分目标SIP域。

空空如常

求真得真