Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

2.1 The background of SIP Trunk

The SIP Trunks serve connecting PrivateServer to a local PBX or to a SIP Voice provider. The above statement implies that a Trunk can be used both for receiving and placing calls in a bidirectional way.

Note
By Secure Call design the SIP Trunks are available only for the PrivateGSM Enterprise Edition. PrivateGSM Professional Edition can't place calls on a Trunk.

The PrivateServer is designed to perform always as a client when configuring a SIP Trunk. This means that PrivateServer itself can not act as a Trunk Provider.

Even if a SIP Trunk can receive and place calls PrivateServer has to be configured to act in a bidirectional way. The Trunk setup should be done for the incoming calls first and after this function is enabled you can setup it for outgoing calls as well.

The incoming calls Trunks are configured in the Inbound entry that you access under Main Menu -> PBX INTEGRATION. Outgoing calls are configured into the Outbound entry that is under the Inbound one.

2.2 Inbound Configuration

Click on the "Inbound" link in menu on the left side to go to the "Sip Trunk List" pageAs stated in the SIP Trunk introduction, from the authentication point of view there's no difference between encrypted or unencrypted SIP Trunks. 

 

Warning

There's no way to perform an unauthenticated SIP INVITE on PrivateServer! You can have different authentication models but you cannot choose to enable an unauthenticated SIP Trunk.

 

The two configurations are parallel meaning that the Authentication method is not related with the encryption of the Trunk itself.
Subtitle
Prefixfigure
SubtitleTextThe "Sip Trunk List" pageDetail of the SIP Trunk form about the registration
AnchorNameemptytrunk_trunkregistration_listdetail

Image AddedImage Removed

There are two types of trunk that you can create

 In 

Xref
AnchorNameemptytrunk_trunkregistration_list
illustrates this page, with an empty table and a "New Sip Trunk" icon above it. This is the default empty configuration.

2.2.1 Create an Inbound Trunk

Click on the New Sip Trunk to go to the Edit Sip Trunk page:
Subtitle
Prefixfigure
SubtitleText"Edit Sip Trunk" form
AnchorNameedit sip trunk form

Image Removed

Tip

detail
 you have a magnification of the SIP Trunk form that shows the registration fields. Usually in order to perform the authentication you have two ways, depending on the authentication type

:
  1. username and password: you must insert username and password
  2. IP based: leave the username and password fields blank and fill in the HOST parameter.

The fields have to be configured as follows:

  • NAME: a meaningful name for this trunk
  • HOST: IP address of the SIP server provided by ITSP
  • OUTBOUND PROXY: IP address of the outbound proxy server provided by ITSP
  • VIRTUAL PHONE NUMBER: associated virtual number
  • USERNAME: login username
  • PASSWORD: password for the username entered above
  • PORT: registration port of the service
  • REGISTER: select if you want to have only outgoing calls or incoming (see below for deeper explanation)
  • CONCURRENT CALLS: maximum number of calls on a single trunk
  • NAT: enable/disable the Network Address Translation configuration
  • DIRECTMEDIA: experimental sound management in P2P mode without routing the audio stream through the server
  • SENDRPID: the Remote Party ID, used to interconnect with VoIP Provider for the management of privacy
  • DTMFMODE: tone signaling technology used for this SIP interconnection
  • ALLOW: voice codecs used in this trunk
  • DISALLOW: voice codecs denied in this trunk
Tip

The called number in inbound calls passing through the trunk should match the number of an internal account or a virtual phone number associated with an account. This way the correct SIP phone will ring.

The default values for PortAllow and Disallow are usually work well, however feel free to change them to suite your needs better.

Mandatory fields are:

  • Host
  • Port
  • Allow/Disallow

Register option

If the trunk is going to be also used for OUTBOUND calls (external calls) you need to be sure that the "Register" checkbox is checked. In this case the "Name" and "Secret" fields are mandatory as well. Otherwise you can uncheck the "Register" checkbox so the above fields will become optional.

Fill out the fields accordingly to the guidelines above and when you are done click on the "Update" icon at the bottom of the page.

Subtitle
Prefixfigure
SubtitleTextThe new SipTrunk List Table
AnchorNamenew trunk list

Image Removed

You can get back to the "Sip Trunk List" page where the Sip Trunk table is now filled based on your settings (

Xref
AnchorNamenew trunk list
).

A notification will inform you about the progress of the operation. The number shown in the notification is an internal identifier in the database and thus can be ignored. 
To check the entered data of the SIP Trunk click on the "Host" value into the table (for example in this case you should click on "10.0.0.101"). This will open again the Edit Sip Trunk page with the previously entered data.

2.2.2 Change Inbound Trunk settings

On the Edit Sip Trunk page you can change the values of the Inbound Trunk fields. When you are done commit the changes by clicking on the Update icon.
Click again on the "Host" value and verify the values of the fields are actually changed.

2.2.3 Delete an Inbound Trunk

To delete a trunk you need to select it in the trunk list. Click on the selected trunk and you'll be taken to the Edit Sip Trunk page. Click on the Delete icon at the bottom of the page to delete the Sip Trunk.exposed by your peer PBX:

  1. SIP Account
  2. IP based

4.3.1 SIP Account authentication

If your PBX peer on the other end of the Trunk has given to you a SIP Account to be used for the Authentication, then you need to insert login and password in Username and Password fields. Plus you should enable the Register option (check 

Xref
AnchorNametrunk_registration_detail
). The Register option force PrivateServer to act like a VoIP client and thus operate an explicit registration to the other end as soon as the internal Asterisk has been restarted.

Typically this configuration is used by public SIP providers because they can't rely just on the IP authentication (the customer's PBX could be behind an ADSL, for instance) and they need to be sure you're just the one who has the right to be connected despite the IP address you are using. 

4.3.2 IP Address Authentication

In an enterprise scenarios the authentication is generally based on IP address, because inside enterprise's infrastructure all the structural elements use to have both private and static IP addresses. 

Subtitle
Prefixfigure
SubtitleTextThe Sip Trunk List after the Trunk deletion Send Keep Alive field
AnchorNamesip trunk deleted

Image Removed

A warning pop-up window will ask you for confirmation. After you click on the Ok button or press the Enter key on your keyboard you'll be taken back again to the "Sip Trunk List" page which will show an empty list and a notice as in
Xref
AnchorNamesip trunk deleted
.

2.3 Outbound Configuration

Click on the "Outbound" link in menu on the left side so you get to the "Dialling Rule List" page. Here you can choose the default outbound trunk or set up the dialling rule to route the calls on a specific one.

2.3.1 Set the default Outbound Trunk

Subtitle
Prefixfigure
SubtitleTextDefault Outbound view
AnchorNamebasic outbound view

Image Removed

As soon as the page is presented to you, you can see it as in 

Xref
AnchorNamebasic outbound view
. The upper side is about the Default Trunk used for outbound calls. By default any outbound call is Blocked and this behaviour stills until a SIP Trunk is chosen.

Subtitle
Prefixfigure
SubtitleTextchoose the default outbound trunk
AnchorNamechoose default outbound

Image Removed

To choose the default Trunk you just need to click on the "BLOCKED" tag and then you can use the drop down menu as in 

Xref
AnchorNamechoose default outbound

Note

If no Inbound Trunk has been configured, then the drop-down menu is empty.

Once you're done you can press the "Update" button to confirm your choice. You return to the "Dialling Rule List" page and this time the "Default Outbound" option is set to the trunk you choose.

2.3.2 Create Outbound routing by dialling rules

The Outbound Trunks can also be selected by dialling a prefix. If you need to create conditional routing rules for Outbound calls, then you need to use the lower section of the "Dialling Rule List" page (cfr. 

Xref
AnchorNamebasic outbound view
). 

Subtitle
Prefixfigure
SubtitleTextThe "New Dialling Rule" button
AnchorNamenew dialling rule link

Image Removed

After you press the "New Dialling Rule" button (which is shown in 

Xref
AnchorNamenew dialling rule link
) you are redirected to the "Create Dialling Rule" form (shown below).

Subtitle
Prefixfigure
SubtitleText"Create Dialling Rule" form
AnchorNamecreate dialling rule

Image Removed

 

2.3.2 Read Outbound routing by dialling rules

If your need is to set up a distinct rule

2.3.2 Update Outbound routing by dialling rules

If your need is to set up a distinct rule

2.3.2 Delete Outbound routing by dialling rules

...

qualify_option

Image Added

In this case the IP address is most likely an internal one and it should be fixed: these features make it a reliable source for the authentication. 

The IP Address Authentication is based on the Host field in the form of the Trunk creation. 

Plus you need to enable the Send keep alive option (please see 

Xref
AnchorNamequalify_option
). This option is going to send to the other party a scheduled SIP OPTIONS message and would measure the roundtrip time to assess if the Trunk is fine or degraded or unable to carry messages. 

Note

The downside of this option is that there will be some more traffic on the socket (each passage of the request is 1.8 KiloByte, thus you can count almost 3.6 KB of traffic every 3 minutes)

The actual default value for the keep-alive interval is 60 seconds. You can configure the general keep-alive timeout in the NAT configuration form. Please read PSAM 2.4 Advanced configurations to get informations about it.

 

Info

Note that the keep alive option can be safely set up even on the SIP account authenticated trunk where it's optional. Instead it considered mandatory for an IP Address Authentication.info

 

Navbar