How can we help? 👋

Mitel - Openscape: Session Border Controller

Prerequisites – Network Configuration & Public Address

This guide assumes your Mitel OpenScape Session Border Controller (SBC) is already installed, licensed and working, with its network, certificates and phone system connection in place. It provides guidance on how to add a Voice AI SIP trunk - but you should establish the best route based on your own requirements.

Before configuring the SBC for Voice AI, the SBC must be reachable from the public internet on a publicly routable IP address, preferably with a DNS name that resolves to it. This is a fundamental networking requirement and is not specific to Voice AI — it applies to any external SIP trunk requiring connectivity across a network boundary.

Voice AI is delivered over a SIP trunk from a cloud platform. The platform sends transfers (SIP REFER) and any new call back into your phone system to the address the SBC presents in its SIP Contact header, so that must be a public address. An internal private address (RFC 1918) is unreachable from the public internet, and signalling, transfers and media would fail. If the SBC sits behind a device that translates addresses (NAT), such as a cloud provider's public IP address mapping, the SBC must be told its public address so that it presents that address to the Voice AI platform. Enter the public address in Security → Firewall → Firewall Settings: select the row for the access IP address and choose Edit. Tick External Firewall and enter the public address in Firewall external IP. Leave the other fields in that section at their defaults unless your signalling and media use different public addresses. With this set, the SBC puts the public address in the From header, the Contact header and the audio connection address that it sends to the platform. Before continuing, also check the following.

  • A DNS (Domain Name System) server is configured on the SBC so that it can resolve the domain name that you are given for the Voice AI trunk.
  • The phone system side is ready. For OpenScape 4000 this means a SIP trunk gateway board that is dedicated to the Voice AI trunk, as described in the OpenScape 4000 setup guide.

Firewall Requirements

You are given the signalling and media addresses of the Voice AI platform for your trunk, with the ports and transport it uses. Allow all of the signalling and media ranges you are given, because a call can use any of them. Apply the rules below to whatever firewall or security group sits in front of the SBC.

Direction
Protocol and port
Remote address
Purpose
Outbound
TCP, the signalling port you were given (typically 5061 for TLS)
Voice AI signalling addresses
Calls from the SBC to Voice AI
Outbound
UDP, the media port range you were given
Voice AI media addresses
Audio from the SBC to the Voice AI platform
Inbound
TCP, the SBC's access-side TLS port (for example 65061)
Voice AI signalling addresses
Calls from Voice AI back into your phone system (SIP dial)
Inbound
UDP, the RTP port range configured on the SBC
Voice AI media addresses
Audio from the Voice AI platform to the SBC

Gateway Boards (Clustered Servers)

The SBC connects to your phone system in one of two modes, set by Comm System Type under VoIP → SIP Server Settings. In Simplex mode the SBC connects to a single gateway board. In Clustered mode it connects to several, and each one is listed as a node.

Voice AI uses its own gateway board (see the prerequisites above), so the SBC connects to at least two boards: the one that carries your existing trunks and the one that carries Voice AI. Set the SBC to Clustered and list every board that has a trunk to the SBC, including the Voice AI board.

If the Voice AI board is not listed, calls to Voice AI can still connect, but the messages that the platform sends later in the same call are delivered to the wrong board. That board has no record of the call and answers 500 Server Internal Error. The transfer (SIP REFER) fails, and the platform's hang-up message (SIP BYE) is refused.

  1. Open VoIP → SIP Server Settings and set Comm System Type to Clustered.
  1. Select Clustered servers, then Add, and enter one row for each gateway board, including the board that carries your existing trunks.
  1. Select OK, then select Apply Changes on the General page. Applying changes ends any calls in progress, so do this when no calls are active.
Column
Value
Group name
A name for your phone system, the same on every row (for example PBX)
Node name
A name for the board (for example Board-Voice-AI)
Priority
1
Routing prefix
Leave blank
IP address or FQDN
The address of the gateway board
Port
The SIP port of the board (typically 5060)
Transport
The SIP transport of the board (typically TCP)
Stick with CommServer
Ticked
No Answer timer, No Reply timer
Leave at their defaults

To check the result, take a network capture on the SBC while you place a test call that Voice AI transfers. The platform's transfer message should be delivered to the address of the Voice AI board, not to the other board.

Trunk Setup

Open the SBC management portal over https. The connection to the Voice AI service is configured under Features and then selecting Configure to the right of Enable Remote Endpoints

Notion image

Changes are only temporary until you select Apply Changes on the General page. Applying changes restarts the SBC's SIP server, so any calls in progress are ended. Group your changes and apply them once.

Notion image

SIP Service Provider Profile

A SIP service provider (SSP) profile controls how the SBC formats SIP messages towards a provider. Create one for Voice AI: in the SIP Service Provider Profile section, select Add. The Default SSP profile list contains presets for named providers. None of them matches Voice AI, so leave it blank. Selecting a preset loads that provider's settings into the page and overwrites anything you have entered. The SIP Service Address options further down decide which headers the SBC fills with the Voice AI domain. The Request-URI and To headers should carry it. The From header should carry your own SBC's address.

Notion image
Option
Value
Name
VoiceAI
Default SSP profile
Leave blank
Enable SSP Privacy and Complementary Flags
Unchecked
Use SIP Service Address for identity headers
Checked. The individual header options below then apply.
SIP service address
The SIP domain name you are given for your Voice AI trunk
Use SIP Service Address in Request-URI header
Checked
Use SIP Service Address in To header
Checked
Use SIP Service Address in From header
Unchecked. If checked, the From header carries the Voice AI domain, the same as the To header. Unchecked, it carries your SBC's address (see the public address prerequisite).
Use SIP Service Address in P-Asserted-Identity header
Unchecked
Use SIP Service Address in Diversion header
Checked
Use SIP Service Address in Contact header
Unchecked
Use SIP Service Address in Via header
Unchecked
Use SIP Service Address in P-Preferred-Identity header
Unchecked
SIP User Agent towards SSP
Passthru (default)
Registration required
Unchecked. The Voice AI service does not register to the SBC, and the SBC does not register to the Voice AI service.
Business identity required
Unchecked
TLS Signaling
Transport=tls. Ask your Voice AI provider whether the platform accepts sips URIs. If it does not, keep this value.
All other options
Leave at their defaults. Read the help text before changing any of them.

Remote Endpoint Configuration

The remote endpoint configuration is the connection to the Voice AI service. In the Remote endpoint configuration section, select Add. The settings are in three groups.

Notion image

Remote Endpoint Settings

Option
Value
Name
VoiceAI
Type
SSP
Profile
VoiceAI (the service provider profile created above)
Signaling address type
IP address or FQDN (fully qualified domain name)
Access realm profile
The realm profile on the side facing the internet (Main-Access-Realm in a default installation)
Core realm profile
The realm profile on the side facing your phone system (Main-Core-Realm in a default installation)

Remote Location Domain List

In the Remote Location domain list, select Add and enter the connection details. You will have been provided the address with your Voice AI service.

Notion image
Option
Value
Remote URL
The SIP address of the Voice AI platform that you were given (it may be regional)
Remote SIP port
5061, or the port you are given
Remote transport
TLS
TLS mode
Server Authentication
Certificate profile
Your SBC's existing SIP-TLS certificate profile (see TLS Certificate Configuration)
Media profile
See Media Profile Configuration

You are given the address of the Voice AI platform for your trunk. Some platforms offer a choice of regions, each with its own addresses. If yours does, ask your Voice AI provider which region to use, and allow the signalling addresses of every region on your firewall so that calls keep working if one region is unavailable. If your call data has to stay in a particular country or region, ask your Voice AI provider what is available. Inbound calls are matched by address. The SBC recognises a call that the Voice AI platform sends to it by the addresses that the Remote URL resolves to, and a platform with several regions can place the call from any of them. A call from an address that the Remote URL does not resolve to is silently ignored: the TLS handshake completes and the INVITE is acknowledged at the network level, but the SBC sends no SIP response and, at the default log level, writes nothing to the log. If you see this, use a Remote URL whose addresses include the region the call comes from (a regional name, if the platform offers one), then apply and retest. If two remote endpoints point at the same platform, they can resolve to the same addresses, and the SBC then picks one of them for every inbound call from those addresses. TLS and encryption must be enabled on the Voice AI side. Please ask your Voice AI provider to confirm that TLS and encrypted audio are enabled on your trunk. Where they are, the platform rejects any call that is not encrypted.

Identification and Routing

Option
Value
Core realm port
A port number that is unique to this endpoint, for example 50012. Use the same port as the proxy port in your phone system's trunk profile.
Default home DN
Leave blank unless required

The SBC identifies which remote endpoint an outgoing call is for by the core realm port on which the call arrives. Every remote endpoint therefore needs its own port, and it must not be used for anything else. This was confirmed in testing with two endpoints on two different ports: a call sent to each port went to the provider of the endpoint that owns that port. The port must be the same on both sides, as the core realm port on the SBC and as the proxy port in the phone system's trunk profile. If the trunk profile uses the port of a different endpoint, calls go to the wrong provider.

Authentication

Voice AI trunks are normally protected by credentials. You are given a user name and password for your trunk. When a call arrives, the platform can answer with a SIP 407 challenge, and the call is then sent again with the credentials. Mitel's SBC guide describes the SBC passing a provider's challenge to the system behind it, which answers from its own configuration, so the credentials belong in the phone system's trunk profile (the account), not on the SBC.

IP address authentication (on request)

IP address authentication can be set up on request, instead of or as well as credentials. Give your Voice AI provider the public IP address that the platform sees when the SBC connects (the address your DNS name resolves to, or the address of your cloud provider's public IP mapping), so that it can be added to the allowed list on your trunk, which is an access control list (ACL). If the address is not on the list, the platform rejects the call, typically with a SIP 403 Forbidden response, and the SBC passes that response back to your phone system. Some platforms state the reason in a response header, so check the headers when a call is refused.

Media Profile Configuration

A media profile controls how the SBC handles the audio streams: whether they are encrypted, how the encryption keys are exchanged, and which codecs are allowed. Because the SBC ends the audio on both sides of a call, the two legs do not have to use the same settings.

⚠️

The administrator should map out the expected media flow for each call scenario, identifying which legs use SRTP and which use RTP. Each profile should then be configured to give the SBC the flexibility to convert between them where necessary.

The settings of the Voice AI leg are set by the Voice AI platform, so ask your Voice AI provider for them: whether the audio must be encrypted (SRTP), how the keys are exchanged, which crypto suites are offered and which codecs are allowed. The PBX leg depends on how your phone system is configured. The values below are the ones that worked in testing with a Voice AI trunk through an OpenScape SBC.

Media profiles are listed under VoIP → Media. The Core Side Media Configuration at the top of that page selects the profile for the phone system side. The profile for the Voice AI side is chosen on the remote endpoint, in the Media profile row of the Remote Location domain list.

Notion image

Voice AI (access side) profile

Option
Value
Media protocol
SRTP only, if your Voice AI provider requires encrypted audio. Create a new profile for this, because none of the standard profiles uses SDES on its own. A profile that offers both SRTP and RTP (Best Effort SRTP) also worked in testing: the platform accepted the offer and used plain RTP on a trunk where encryption was not enforced. Use RTP only if your Voice AI provider confirms the platform accepts unencrypted audio on your trunk.
SRTP crypto context negotiation
sdes. In testing the platform exchanged its encryption keys with the SBC this way.
Crypto suite
Not shown in the profile list. In testing the platform used AES_CM_128_HMAC_SHA1_80 and the SBC accepted it.
Codecs
G.711 (PCMA and PCMU). The Codecs column is empty in the standard profiles. In testing the SBC passed on the codecs that the gateway board offered, and the calls used G.711 A-law (PCMA).
Keypad tones (DTMF)
RTP telephone events (RFC 4733), sent as data inside the audio stream. There is no setting for this in the profile list. In testing the platform and the gateway board both offered telephone events.
Mark SRTP Call-leg as Secure
Unchecked, as in the standard profiles other than the WebRTC one.

Phone system (core side) profile

Option
Value
Media protocol
Best Effort SRTP, the standard default profile, which is selected under Core Side Media Configuration. In testing, the OpenScape 4000 gateway board offered plain RTP, so the call used RTP. The SBC converts between SRTP towards the platform and RTP towards the phone system.
Codecs
G.711 first. In testing, the gateway board offered PCMA, G.729, G.722 and Opus. Keep only the codecs that the platform also supports.
Keypad tones (DTMF)
RTP telephone events (RFC 4733), which the gateway board offered in testing.

TLS Certificate Configuration

Voice AI connects over TLS, so the Voice AI remote endpoint needs a certificate profile. As your SBC is already working, it will already have a profile for the SIP-TLS certificate service, and no new certificate is needed. In Security → General → Certificate Management, find that SIP-TLS entry in the table at the top of the page, and select it as the Certificate profile on the Voice AI remote endpoint. Check the following.

  • The certificate in that profile is issued for the DNS name that the Voice AI platform connects to, which is the name of your SBC.
  • The certificate uses an RSA key, which is the safest choice. Ask your Voice AI provider whether the platform also accepts other key types.
  • The SBC accepts the platform's certificate when it connects to the Voice AI service with the TLS mode set to Server Authentication. In testing no import was needed, because the platform's certificate was issued by a public certificate authority. If the platform uses a private certificate authority, import that authority's certificate into the SBC first.
  • Ask your Voice AI provider what the platform requires of the certificate on your side. In testing, a cloud SIP platform completed the TLS handshake with an RSA certificate from a public certificate authority, without asking the SBC for a client certificate, and an inbound call from it reached the phone system.

Troubleshooting

Symptom
Likely cause
What to do
A call from the Voice AI platform reaches the SBC and the TLS connection completes, but the SBC never answers and nothing appears in the log
The Remote URL resolves to different addresses from the ones the call came from
Use a Remote URL whose addresses include the region the call comes from, select Apply Changes and retest
The platform answers 403 Forbidden to calls from your SBC
With IP address authentication, the SBC's public IP address is not in the trunk's access control list
Send your Voice AI provider the public address that the platform sees, not the SBC's private address. If the response names a reason in a header, include it
The platform refuses the call after sending a challenge
The user name or password in the phone system's trunk profile is wrong, or the trunk profile does not use the account
Check the credentials you were given, and that the trunk profile uses them
The SBC reports TLS protocol errors for the gateway's address
The SIP server entry uses TLS or a TLS port, but the gateway board speaks plain TCP on its SIP port
Set the transport and port under SIP Server Settings to match the board
The From header carries the SBC's private address
The SBC is behind NAT and no external firewall address is set
Tick External Firewall and enter the public address under Security → Firewall → Firewall Settings
The phone system returns 504 Server Time-out for a call that passed through it
The next leg of the call did not answer in time
Look at the leg that follows, using a network capture on the SBC, and check the rows above
A call to Voice AI connects, but the platform's transfer (SIP REFER) or hang-up (SIP BYE) is answered with 500 Server Internal Error
The SBC sends the message to a different gateway board from the one that holds the call, because the Voice AI board is not listed as a clustered server
Set Comm System Type to Clustered and add every gateway board, including the Voice AI board, under Clustered servers. Select OK, then Apply Changes

References

The settings in this guide come from the Mitel document below, and from the phone system guide it works with. Page numbers refer to the PDF.

Used for
Mitel document
Where to look
The public address when the SBC is behind NAT: the External Firewall setting under Security → Firewall
Firewalls, pages 183 to 187
Gateway boards: Comm System Type, clustered servers and Allow Register
OpenScape SBC V11 Configuration Guide
SBC using OpenScape 4000 as SIP Server, pages 264 to 275
The SIP service provider profile: which headers carry the provider's domain
OpenScape SBC V11 Configuration Guide
SIP service provider profiles, pages 130 to 143
The remote endpoint, the remote location domain list, the core realm port, and how inbound calls are matched by address
OpenScape SBC V11 Configuration Guide
Remote endpoints, pages 144 to 152. The core realm port is also described under SBC using OpenScape 4000 as SIP Server, pages 264 to 275
Authentication: the 407 challenge passed to the system behind the SBC
OpenScape SBC V11 Configuration Guide
The credentials section of the service provider profiles chapter, within pages 130 to 143
Media profiles: SRTP, SDES, codecs and telephone events
OpenScape SBC V11 Configuration Guide
Media, pages 96 to 100
TLS certificates and certificate profiles
OpenScape SBC V11 Configuration Guide
Certificate management, pages 168 to 178
Installing and licensing the SBC (this guide assumes both are done)
OpenScape SBC V11 Configuration Guide
Installation: chapter 2, Software Installation, pages 5 to 33. Licensing: section 3.3, Centralized Licensing on CMP, pages 44 to 47, and section 3.4.2.3, Licenses, page 59
The phone system side: the gateway board and its trunk profile
Chapter 14.5, Configuration of SIP Service Provider and SIP Carrier

Glossary of terms

Plain-English meanings of the abbreviations and technical terms used in this guide.

Term
Stands for
What it means
SBC
Session Border Controller
A device at the edge of your network that connects your phone system to an outside network such as the Voice AI service, and protects and translates the traffic between them.
SSP
SIP Service Provider
The provider the SBC connects to. In this guide, the Voice AI platform.
SIP
Session Initiation Protocol
The standard way of starting, managing and ending calls over an IP network.
SIP REFER
(a SIP message type)
A SIP message that asks the other side to start a new call, used to transfer a call.
RTP
Real-time Transport Protocol
The way the voice audio is carried during a call.
SRTP
Secure Real-time Transport Protocol
The encrypted version of RTP.
SDES
Session Description Protocol Security Descriptions
A method for the two ends of a call to agree the encryption keys for the audio.
DTMF
Dual-Tone Multi-Frequency
The keypad tones made when a caller presses keys on a phone.
G.711
(a standard name, not an abbreviation)
The standard telephone voice codec. PCMA (A-law) and PCMU (µ-law) are its two variants.
Telephone events
(a standard feature, RFC 4733)
A way of sending keypad tones as data inside the audio stream instead of as sound.
PBX
Private Branch Exchange
Your phone system.
Realm
(an SBC term)
A group of network settings on the SBC. The core realm faces your phone system and the access realm faces the internet.
Remote endpoint
(an SBC term)
The SBC's definition of a connection to an outside party, here the Voice AI service.
Core realm port
(an SBC setting)
The port that identifies which remote endpoint an outgoing call is for.
NAT
Network Address Translation
A device or service that maps a public IP address to a private one.
ACL
Access Control List
A list of addresses that a service allows. The Voice AI platform uses one to decide which IP addresses may send calls to a trunk.
SIP 407 challenge
(a SIP response)
A reply from the platform that asks the caller to prove who it is. The call is sent again with a user name and password.
DNS
Domain Name System
The service that turns a name, such as the host name of the SBC, into an IP address.
DN
Directory Number
A phone number or extension on the phone system.
FQDN
Fully Qualified Domain Name
A complete host name, for example voiceai.example.com.
Region
(a platform term)
One of the locations from which the Voice AI platform sends and receives SIP traffic. Each can have its own addresses.
Gateway board
(a phone system term)
The part of the phone system that speaks SIP to the SBC. In an OpenScape 4000 it is a SoftGate board.
Comm System Type (Simplex, Clustered)
(an SBC setting)
A setting on the SBC's SIP Server Settings page. Simplex connects the SBC to a single gateway board. Clustered connects it to several boards, each listed as a node.
Clustered servers
(an SBC setting)
The list of gateway boards that the SBC connects to when Comm System Type is Clustered.
SIP BYE
(a SIP message type)
A SIP message that ends a call.
Did this answer your question?
😞
😐
🤩