Connecting Cisco Cucm14 With Teams Direct Routing Using Mediant SBC Configuration Note
Connecting Cisco Cucm14 With Teams Direct Routing Using Mediant SBC Configuration Note
Configuration Note
AudioCodes Professional Services – Interoperability Lab
Version 7.4
Contents SBC with CUCM and Teams DR
Table of Contents
Notice ................................................................................................................................ iv
WEEE EU Directive ......................................................................................................................... iv
Customer Support ......................................................................................................................... iv
Stay in the Loop with AudioCodes ................................................................................................. iv
Abbreviations and Terminology ..................................................................................................... iv
Document Revision Record ............................................................................................................ iv
Documentation Feedback .............................................................................................................. iv
1 Introduction .................................................................................................................1
1.1 Intended Audience ............................................................................................................... 1
1.2 About Microsoft Teams Direct Routing ................................................................................ 1
1.3 About AudioCodes SBC Product Series ................................................................................. 1
2 Component Information ...............................................................................................2
2.1 AudioCodes SBC Version ...................................................................................................... 2
2.2 Cisco CUCM Version ............................................................................................................. 2
2.3 Microsoft Teams Direct Routing Version .............................................................................. 2
2.4 Interoperability Test Topology ............................................................................................. 3
2.4.1 Enterprise Model Implementation ..................................................................................... 3
2.4.2 Environment Setup............................................................................................................. 4
2.4.3 Infrastructure Prerequisites................................................................................................ 4
2.4.4 Known Limitations.............................................................................................................. 4
- ii -
Contents SBC with CUCM and Teams DR
- iii -
Notices SBC with CUCM and Teams DR
Notice
Notice
Information contained in this document is believed to be accurate and reliable at the time of
printing. However, due to ongoing product improvements and revisions, AudioCodes cannot
guarantee accuracy of printed material after the Date Published nor can it accept responsibility for
errors or omissions. Updates to this document can be downloaded from
https://www.audiocodes.com/library/technical-documents.
This document is subject to change without notice.
Date Published: July-25-2023
WEEE EU Directive
Pursuant to the WEEE EU Directive, electronic and electrical waste must not be disposed of with
unsorted waste. Please contact your local recycling authority for disposal of this product.
Customer Support
Customer technical support and services are provided by AudioCodes or by an authorized
AudioCodes Service Partner. For more information on how to buy technical support for AudioCodes
products and for contact information, please visit our website at
https://www.audiocodes.com/services-support/maintenance-and-support.
Documentation Feedback
AudioCodes continually strives to produce high quality documentation. If you have any comments
(suggestions or errors) regarding this document, please fill out the Documentation Feedback form
on our website at https://online.audiocodes.com/documentation-feedback.
- iv -
1. Introduction SBC with CUCM and Teams DR
1 Introduction
This Configuration Note describes how to set up the AudioCodes Session Border Controller
(hereafter, referred to as SBC) for interworking between Cisco CUCM and Microsoft's Teams Direct
Routing environment.
You can also use AudioCodes' SBC Wizard tool to automatically configure the SBC based on this
interoperability setup. However, it is recommended to read through this document to better
understand the various configuration options. For more information on AudioCodes' SBC Wizard
including the download option, visit AudioCodes website at
https://www.audiocodes.com/partners/interoperability-list.
-1-
2. Component Information SBC with CUCM and Teams DR
2 Component Information
2.1 AudioCodes SBC Version
Table 1: AudioCodes SBC Version
SBC Vendor AudioCodes
Models ◼ Mediant 500/L Gateway & E-SBC
◼ Mediant 800B/C Gateway & E-SBC
◼ Mediant 1000B Gateway & E-SBC
◼ Mediant 2600 E-SBC
◼ Mediant 4000/B SBC
◼ Mediant 9000/9030/9080 SBC
◼ Mediant Software SBC (VE/SE/CE)
Software Version 7.40A.500.017 or later
Protocol ◼ SIP/UDP or SIP/TCP (to the Cisco CUCM SIP Trunk)
◼ SIP/TLS (to the Teams Direct Routing)
Additional Notes None
-2-
2. Component Information SBC with CUCM and Teams DR
DMZ
Management
Station (OAMP) Internet Phone System
LAN
Firewall
CUCM14
-3-
2. Component Information SBC with CUCM and Teams DR
-4-
3. Configuring Teams Direct Routing SBC with CUCM and Teams DR
3.1 Prerequisites
Before you begin configuration, make sure you have the following for every SBC you want to pair:
◼ Public IP address
◼ FQDN name matching SIP addresses of the users
◼ Public certificate, issued by one of the supported CAs
Users can be from any SIP domain registered for the tenant. For example, you can provide users
[email protected] with the SBC FQDN int-sbc1.audctrunk.aceducation.info so long as both
names are registered for this tenant.
-5-
3. Configuring Teams Direct Routing SBC with CUCM and Teams DR
During creation of the Domain, you will be forced to create public DNS record
(int-sbc1.audctrunk.aceducation.info in our example.)
-6-
3. Configuring Teams Direct Routing SBC with CUCM and Teams DR
3. Configure SBC.
Figure 5: Configure new SBC
-7-
3. Configuring Teams Direct Routing SBC with CUCM and Teams DR
You can use the following PowerShell command for creating a new Online PSTN Gateway:
New-CsOnlinePSTNGateway -Identity int-
sbc1.audctrunk.aceducation.info -SipSignalingPort 5061 -
ForwardCallHistory $True -ForwardPai $True -MediaBypass $True -
Enabled $True
-8-
3. Configuring Teams Direct Routing SBC with CUCM and Teams DR
2. Create a new Voice Route and associate it with the SBC, configured in the previous step.
Figure 7: Associate SBC with new Voice Route
-9-
3. Configuring Teams Direct Routing SBC with CUCM and Teams DR
2. Create a new Voice Routing Policy and associate it with PSTN Usage, configured in the
previous step.
- 10 -
3. Configuring Teams Direct Routing SBC with CUCM and Teams DR
Figure 10: Associate PSTN Usage with New Voice Routing Policy
The commands specified in Sections 3.3.4 and 3.3.5, should be run for each Teams user in
the company tenant.
- 11 -
4. Configuring Cisco CUCM SBC with CUCM and Teams DR
- 12 -
4. Configuring Cisco CUCM SBC with CUCM and Teams DR
5. In the Device Name field, enter a unique SIP Trunk name and optionally provide a description.
6. From the Device Pool drop-down list, select a device pool.
Figure 14: SIP Trunk Settings Page
8. Enter the Destination Address and Destination Port of the AudioCodes SBC.
Figure 16: SIP Information Section
- 13 -
4. Configuring Cisco CUCM SBC with CUCM and Teams DR
- 14 -
4. Configuring Cisco CUCM SBC with CUCM and Teams DR
5. Click Save.
Figure 19: Added Route Pattern
- 15 -
4. Configuring Cisco CUCM SBC with CUCM and Teams DR
- 16 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
For implementing Microsoft Teams Direct Routing and Cisco CUCM based on the
configuration described in this section, AudioCodes SBC must be installed with a License
Key that includes the following software features:
◼ MSFT (general Microsoft license).
By default, all AudioCodes media gateways and SBCs are shipped with this license
(except MSBR products, Mediant 500 SBC, and Mediant 500 Media Gateway).
◼ SW/TEAMS (Microsoft Teams license).
◼ Number of SBC sessions (based on requirements).
◼ Transcoding sessions (only if media transcoding is needed).
◼ Coders (based on requirements).
For more information about the License Key, contact your AudioCodes sales representative.
If your SBC is deployed in a virtual environment and transcoding is required, your virtual
machine must have a minimum of two vCPUs. For more information, please refer to the
appropriate Installation Manual, which can be found on AudioCodes website.
The scope of this document does not cover all security aspects for configuring this topology.
Comprehensive security measures should be implemented per your organization's security
policies. For security recommendations on AudioCodes’ products, refer to the
Recommended Security Guidelines document, which can be found at AudioCodes website.
SIP SIP
Proxy Set IP Group
Interface SBC Interface
IP Group Proxy Set
- 17 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
Vlan ID 1 Vlan ID 2
LAN DMZ
Management
Station (OAMP)
WAN
Phone System
Firewall
CUCM14
- 18 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
- 19 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
All other parameters can be left unchanged with their default values.
The table above exemplifies configuration focusing on interconnecting SIP and media. You
might want to configure additional parameters according to your company's policies. For
example, you might want to configure Online Certificate Status Protocol (OCSP) to check if
SBC certificates presented in the online server are still valid or revoked. For more
information on the SBC's configuration, see the User's Manual, available for download from
https://www.audiocodes.com/library/technical-documents.
3. Click Apply.
To configure a certificate:
1. Open the TLS Contexts page (Setup menu > IP Network tab > Security folder > TLS Contexts).
2. In the TLS Contexts page, select the required TLS Context index row, and then click the
Change Certificate link located below the table; the Context Certificates page appears.
3. Under the Certificate Signing Request group, do the following:
a. In the 'Subject Name [CN]' field, enter the SBC FQDN name
(based on example above, int-sbc1.audctrunk.aceducation.info).
b. In the ‘1st Subject Alternative Name [SAN]’ field, change the type to ‘DNS’ and enter the
SBC FQDN name (based on example above, int-sbc1.audctrunk.aceducation.info).
The domain portion of the Common Name [CN] and 1st Subject Alternative Name [SAN]
must match the SIP suffix configured for Office 365 users.
c. Fill in the rest of the request fields according to your security provider's instructions.
- 20 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
d. Click the Create CSR button; a textual certificate signing request is displayed in the area
below the button.
4. Copy the CSR from the line "----BEGIN CERTIFICATE" to "END CERTIFICATE REQUEST----" to a
text file (such as Notepad), and then save it to a folder on your computer with the file name,
for example certreq.txt.
5. Send certreq.txt file to the Certified Authority Administrator for signing.
6. After obtaining an SBC signed and Trusted Root/Intermediate Certificate from the CA,
in the SBC's Web interface, return to the TLS Contexts page and do the following:
a. In the TLS Contexts page, select the required TLS Context index row, and then click the
Change Certificate link located below the table; the Context Certificates page appears.
b. Scroll down to the Upload certificates files from your computer group, click the Choose
File button corresponding to the 'Send Device Certificate...' field, navigate to the
certificate file obtained from the CA, and then click Load File to upload the certificate to
the SBC.
7. Confirm that the certificate was uploaded correctly. A message indicating that the certificate
was uploaded successfully is displayed in blue in the lower part of the page.
8. In the SBC's Web interface, return to the TLS Contexts page, select the required TLS Context
index row, and then click the Certificate Information link, located at the bottom of the TLS.
Then validate the Key size, certificate status and Subject Name.
9. In the SBC's Web interface, return to the TLS Contexts page.
a. In the TLS Contexts page, select the required TLS Context index row, and then click the
Trusted Root Certificates link, located at the bottom of the TLS Contexts page; the
Trusted Certificates page appears.
b. Click the Import button, and then select all Root/Intermediate Certificates obtained
from your Certification Authority to load.
10. Click OK; the certificate is loaded to the device and listed in the Trusted Certificates store.
- 21 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
Microsoft 365 is updating services powering messaging, meetings, telephony, voice, and
video to use TLS certificates from a different set of Root Certificate Authorities (CAs). For
more details of the new Root CAs, refer to Microsoft technical guidance at Office TLS
Certificate Changes. Services began transitioning to the new Root CAs (e.g., DigiCert)
beginning in January 2022 and will continue through October 2022. During this migration
period, it’s possible to load both the old (Baltimore) and the new (DigiCert) Root certificate
to the same TLS Context.
The DNS name of the Teams Direct Routing interface is sip.pstnhub.microsoft.com. In this
interface, a certificate is presented which is signed by
DigiCert with Serial Number: 0x033af1e6a711a9a0bb2864b11d09fae5, SHA-1
Thumbprint: DF3C24F9BFD666761B268073FE06D1CC8D4F82A4 and
SHA-256 Thumbprint:
CB3CCBB76031E5E0138F8DD39A23F9DE47FFC35E43C1144CEA27D46A5AB1CB5F.
To trust this certificate, your SBC must have the certificate in Trusted Certificates storage.
Download the DigiCert Global Root G2 (df3c) certificate in PEM format from
https://www.digicert.com/kb/digicert-root-certificates.htm and follow the steps above to import
the certificate to the Trusted Root storage.
Before importing the DigiCert Root Certificate into AudioCodes' SBC, make sure it's in .PEM
or .PFX format. If it isn't, you need to convert it to .PEM or .PFX format. Otherwise, you will
receive a 'Failed to load new certificate' error message. To convert to PEM format, use the
Windows local store on any Windows OS and then export it as 'Base-64 encoded X.509
(.CER) certificate'.
- 22 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
The Direct Routing interface can only use TLS for a SIP port. It does not support using TCP
due to security reasons. The SIP port might be any port of your choice. When pairing the
SBC with Office 365, the chosen port is specified in the pairing command.
- 23 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
- 24 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
3. Click Apply.
3. Click Apply.
- 25 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
6. Click Apply, and then confirm the configuration change in the prompt that pops up.
The procedure below describes how to configure an Allowed Coders Group to ensure that voice sent
to the Cisco CUCM uses the dedicated coders list whenever possible. Note that this Allowed Coders
Group ID will be assigned to the IP Profile belonging to the CUCM in the next step.
6. Open the Media Settings page (Setup menu > Signaling & Media tab > Media folder > Media
Settings).
7. From the 'Extended Coders Behavior' drop-down list, select Include Extensions.
8. Click Apply.
- 26 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
Parameter Value
General
Index 0
Name CUCM (arbitrary descriptive name)
Media Security
SBC Media Security Mode Not Secured
SBC Media
Allowed Audio Coders AllowedCoders_CUCM
Allowed Coders Mode Restriction and Preference
Allowed Media Types audio
SBC Forward and Transfer
Remote REFER Mode Handle Locally
Remote Replaces Mode Handle Locally
Remote 3xx Mode Handle Locally
3. Click Apply.
- 27 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
Parameter Value
General
Index 1
Name Teams (arbitrary descriptive name)
Media Security
SBC Media Security Mode Secured
SBC Early Media
Remote Early Media RTP Detection By Media (required, as Microsoft Teams Direct
Mode Routing does not send RTP immediately to
remote side when it sends a SIP 18x response)
SBC Media
Extension Coders Group AudioCodersGroups_Teams
RFC 2833 Mode Extend
ICE Mode Lite (required only when Media Bypass enabled
on Microsoft Teams)
SBC Signaling
Remote Update Support Not Supported
Remote re-INVITE Support Supported Only With SDP
Remote Delayed Offer Support Not Supported
SBC Forward and Transfer
Remote REFER Mode Handle Locally
Remote Replaces Mode Handle Locally
Remote 3xx Mode Handle Locally
SBC Hold
Remote Hold Format Inactive (some SIP Trunk may answer with
a=inactive and IP=0.0.0.0 in response to the Re-
Invite with Hold request from Teams. Microsoft
Media Stack doesn’t support this format. So, SBC
will replace 0.0.0.0 with its IP address)
3. Click Apply.
- 28 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
To configure IP Groups:
1. Open the IP Groups table (Setup menu > Signaling & Media tab > Core Entities folder > IP
Groups).
2. Configure an IP Group for the Cisco CUCM:
Parameter Value
Index 1
Name CUCM
Type Server
Proxy Set CUCM
IP Profile CUCM
Media Realm MR-LAN
SIP Group Name According to requirement.
(based on our example, int-sbc1.audctrunk.aceducation.info)
IP Profile Teams
Local Host Name < FQDN name of your SBC in the Microsoft Teams tenant >
(based on our example, int-sbc1.audctrunk.aceducation.info)
Always Use Src Address Yes
- 29 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
Parameter Value
Index 0
Name Teams-Contact (arbitrary descriptive name)
Condition header.contact.url.host contains 'pstnhub.microsoft.com'
3. Click Apply.
- 30 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
1 Teams_52_113 Teams 52.113.*.* <FQDN name of your SBC in the Teams- Allow Teams
(arbitrary name) Microsoft Teams tenant> Contact
(e.g., int-sbc1.audctrunk.aceducation.info)
2 Teams_52_114 Teams 52.114.*.* <FQDN name of your SBC in the Teams- Allow Teams
(arbitrary name) Microsoft Teams tenant> Contact
(e.g., int-sbc1.audctrunk.aceducation.info)
3 Teams_52_115 Teams 52.115.*.* <FQDN name of your SBC in the Teams- Allow Teams
(arbitrary name) Microsoft Teams tenant> Contact
(e.g., int-sbc1.audctrunk.aceducation.info)
4 Teams_52_120 Teams 52.120.*.* <FQDN name of your SBC in the Teams- Allow Teams
(arbitrary name) Microsoft Teams tenant> Contact
(e.g., int-sbc1.audctrunk.aceducation.info)
5 Teams_52_121 Teams 52.121.*.* <FQDN name of your SBC in the Teams- Allow Teams
(arbitrary name) Microsoft Teams tenant> Contact
(e.g., int-sbc1.audctrunk.aceducation.info)
6 Teams_52_122 Teams 52.122.*.* <FQDN name of your SBC in the Teams- Allow Teams
(arbitrary name) Microsoft Teams tenant> Contact
(e.g., int-sbc1.audctrunk.aceducation.info)
7 Teams_52_123 Teams 52.123.*.* <FQDN name of your SBC in the Teams- Allow Teams
(arbitrary name) Microsoft Teams tenant> Contact
(e.g., int-sbc1.audctrunk.aceducation.info)
3. Click Apply.
- 31 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
The routing configuration may change according to your specific deployment topology.
- 32 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
Be aware, that if in your configuration, connectivity to SIP Trunk (or other entities) is
performed through the same IP Interface as Teams (WAN_IF in our example), you must add
rules to allow traffic from these entities. See an example in the row of index 3.
- 33 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
For example, for this interoperability test topology, a manipulation is configured to remove the "+"
(plus sign) from the destination number for calls from the Teams Direct Routing IP Group.
- 34 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
Parameter Value
Index 0
Name Change Max-Forwards from CUCM
Manipulation Set ID 0
Message Type Options
Condition Header.Max-Forwards=='0'
Action Subject Header.Max-Forwards
Action Type Modify
Action Value ‘10’
3. Configure another manipulation rule (Manipulation Set 2) for Cisco CUCM. This rule applies to
messages sent to the Cisco CUCM IP Group. This replaces the host part of the SIP Request-URI
Header with the Cisco CUCM IP address.
Parameter Value
Index 1
Name Change R-URI host toward CUCM
Manipulation Set ID 2
Condition Any.Request
Action Subject Header.Request-URI.URL.Host
Action Type Modify
Action Value Param.Message.Address.Dst.IP
- 35 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
4. Configure another manipulation rule (Manipulation Set 3) for Teams Direct Routing IP Group.
This rule applies to messages received from the Teams IP Group. This rule replaces user part
of the second index (in the SIP URI format) of the SIP P-Asserted-Identity Header with the
value from the first index (in the telephone format).
Parameter Value
Index 2
Name Build 1 PAI from 2
Manipulation Set ID 3
Action Subject Header.P-Asserted-Identity.1.URL.User
Action Type Modify
Action Value Header.P-Asserted-Identity.0.URL.User
5. Configure another manipulation rule (Manipulation Set 3) for Teams Direct Routing IP Group.
This rule applies to messages received from the Teams IP Group. This rule removes the first
index (in the telephone format) of the SIP P-Asserted-Identity Header.
Parameter Value
Index 3
Name Remove PAI tel
Manipulation Set ID 3
Action Subject Header.P-Asserted-Identity.0
Action Type Remove
6. Configure another manipulation rule (Manipulation Set 3) for Teams Direct Routing IP Group.
This rule applies to messages received from the Teams IP Group. This removes the SIP Privacy
Header in all messages, except of call with presentation restriction.
Parameter Value
Index 4
Name Remove Privacy Header
Manipulation Set ID 3
Condition Header.Privacy exists And Header.From.URL
!contains 'anonymous'
Action Subject Header.Privacy
Action Type Remove
- 36 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
The table displayed below includes SIP message manipulation rules which are grouped together
under Manipulation Set IDs (Manipulation Set IDs 2 and 3) and which are executed for messages sent
to and from the Cisco CUCM IP Group as well as the Teams Direct Routing IP Group. These rules are
specifically required to enable proper interworking between Cisco CUCM and Teams Direct Routing.
Refer to the User’s Manual for further details concerning the full capabilities of header manipulation.
- 37 -
5. Configuring AudioCodes SBC SBC with CUCM and Teams DR
5.17.2 Optimizing CPU Cores Usage for a Specific Service (relevant for Mediant
9000 and Software SBC only)
This section describes how to optimize the SBC's CPU cores usage for a specified profile to achieve
maximum capacity for that profile. The supported profiles include:
◼ SIP profile – improves SIP signaling performance, for example, SIP calls per second (CPS).
◼ SRTP profile – improves maximum number of SRTP sessions.
◼ Transcoding profile – enables all DSP-required features, for example, transcoding and voice
in-band detectors.
3. Click Apply, and then reset the device with a burn-to-flash for your settings to take effect.
- 38 -
International Headquarters
1 Hayarden Street,
Airport City
Lod 7019900, Israel
Tel: +972-3-976-4000
Fax: +972-3-976-4040
AudioCodes Inc.
80 Kingsbridge Rd
Piscataway, NJ 08854, USA
Tel: +1-732-469-0880
Fax: +1-732-469-2298
©2023 AudioCodes Ltd. All rights reserved. AudioCodes, AC, HD VoIP, HD VoIP Sounds Better, IPmedia,
Mediant, MediaPack, What’s Inside Matters, OSN, SmartTAP, User Management Pack, VMAS,
VoIPerfect, VoIPerfectHD, Your Gateway To VoIP, 3GX, VocaNom, AudioCodes One Voice, AudioCodes
Meeting Insights, and AudioCodes Room Experience are trademarks or registered trademarks of
AudioCodes Limited. All other products or trademarks are property of their respective owners. Product
specifications are subject to change without notice.
Document #: LTRT-29314