Connecting Audiocodes SBC To Microsoft Teams Direct Routing Enterprise Model Configuration Note
Connecting Audiocodes SBC To Microsoft Teams Direct Routing Enterprise Model Configuration Note
Version 7.2
Configuration Note Contents
Table of Contents
1 Introduction ......................................................................................................... 9
1.1 About Microsoft Teams Direct Routing .................................................................... 9
1.2 Validated AudioCodes Version ................................................................................ 9
1.3 About AudioCodes SBC Product Series .................................................................. 9
1.4 Infrastructure Prerequisites .................................................................................... 10
2 Configuring AudioCodes' SBC ........................................................................ 11
2.1 Prerequisites .......................................................................................................... 12
2.1.1 About the SBC Domain Name .................................................................................12
2.2 Validate AudioCodes' License ............................................................................... 13
2.3 Configure LAN and WAN IP Interfaces .................................................................. 14
2.3.1 Validate Configuration of Physical Ports and Ethernet Groups ...............................14
2.3.2 Configure LAN and WAN VLANs ............................................................................15
2.3.3 Configure Network Interfaces ..................................................................................15
2.4 Configure TLS Context........................................................................................... 17
2.4.1 Create a TLS Context for Microsoft Phone System Direct Routing ........................17
2.4.2 Generate a CSR and Obtain the Certificate from a Supported CA .........................19
2.4.3 Deploy the SBC and Root / Intermediate Certificates on the SBC ..........................20
2.5 Alternative Method of Generating and Installing the Certificate ............................. 22
2.6 Deploy Baltimore Trusted Root Certificate ............................................................. 22
2.7 Configure Media Realm ......................................................................................... 22
2.8 Configure a SIP Signaling Interface ....................................................................... 24
2.9 Configure Proxy Sets and Proxy Address .............................................................. 26
2.9.1 Configure Proxy Sets ...............................................................................................26
2.9.2 Configure a Proxy Address ......................................................................................27
2.10 Configure a Coder Group ....................................................................................... 27
2.11 Configure an IP Profile ........................................................................................... 28
2.12 Configure an IP Group ........................................................................................... 29
2.13 Configure the Internal SRV Table .......................................................................... 31
2.14 Configure SRTP ..................................................................................................... 33
2.15 Configure SIP Options ........................................................................................... 33
2.15.1 Configure FQDN in Contact Header of Options Message using Message
Manipulations Sets ...............................................................................................................34
2.16 Configuring Message Condition Rules ................................................................... 36
2.17 Configuring Classification Rules ............................................................................ 36
2.18 Configure IP to IP Routing ..................................................................................... 36
2.19 Configuring an SBC to Suppress Call Line ID........................................................ 39
3 Verify the Pairing between the SBC and Direct Routing................................ 41
4 Make a Test Call ................................................................................................ 43
A Syntax Requirements for SIP Messages 'INVITE' and 'Options' ................... 45
A.1 Terminology ........................................................................................................... 45
A.2 Syntax Requirements for 'INVITE' Messages ........................................................ 45
A.3 Requirements for 'OPTIONS' Messages Syntax .................................................... 46
A.4 Connectivity Interface Characteristics .................................................................... 47
B SIP Proxy Direct Routing Requirements ......................................................... 49
B.1 Failover Mechanism ............................................................................................... 49
List of Figures
Figure 2-1: Connection Topology - Network Interfaces..........................................................................11
Figure 2-2: Example of Registered DNS Names....................................................................................13
Figure 2-3: Physical Ports Configuration Interface .................................................................................14
Figure 2-4: Ethernet Groups Configuration Interface .............................................................................14
Figure 2-5: Configured VLANs in the Ethernet Device Table.................................................................15
Figure 2-6: Configured IP Interfaces ......................................................................................................16
Figure 2-7: Configuration of TLS Context for Direct Routing .................................................................18
Figure 2-8: Configured TLS Context for Direct Routing and Interface to Manage the Certificates ........18
Figure 2-9: Example of Certificate Signing Request Page .....................................................................19
Figure 2-10: Uploading the Certificate Obtained from the Certification Authority ..................................20
Figure 2-11: Message Indicating Successful Upload of the Certificate ..................................................20
Figure 2-12: Certificate Information ........................................................................................................21
Figure 2-13: Configured Trusted Certificates Page................................................................................21
Figure 2-14: Configured Media Realms .................................................................................................23
Figure 2-15: Configured SIP Interface....................................................................................................25
Figure 2-16: Configured Proxy Set .........................................................................................................26
Figure 2-17: Configured Proxy Address .................................................................................................27
Figure 2-18: Configured Coder Group....................................................................................................28
Figure 2-19: Configured IP Group ..........................................................................................................30
Figure 2-20: Configured Internal SRV Table ..........................................................................................32
Figure 2-21: Configured Media Security Parameter ...............................................................................33
Figure 2-22: Configured Manipulation Rules ............................................................................................35
Figure 2-23: Activating 'OPTIONS' Manipulation Set .............................................................................35
Figure 2-24: Privacy Restriction Mode ...................................................................................................39
Figure 2-25: P-Asserted-Identity Header Mode......................................................................................39
Figure 3-1: Proxy Set Status ..................................................................................................................41
Figure A-1: Example of an 'INVITE' Message ........................................................................................45
Figure A-2: Example of 'OPTIONS' message ........................................................................................46
List of Tables
Table 1-1: Infrastructure Prerequisites ...................................................................................................10
Table 2-1: DNS Names Registered by an Administrator for a Tenant ...................................................12
Table 2-2: Adding VLAN ID 2 for the WAN Side ....................................................................................15
Table 2-3: Configuration Example: Network Interfaces..........................................................................16
Table 2-4: Adding a Network Interface for the WAN for Teams .............................................................16
Table 2-5: New TLS Context ..................................................................................................................17
Table 2-6: Configuration Example: Media Realm for the LAN ...............................................................23
Table 2-7: Configuration Example: Media Realm for the WAN ..............................................................23
Table 2-8: Configuration Example: SIP Interface ...................................................................................24
Table 2-9: Configuration Example: Proxy Set - Teams – Global FQDNs ..............................................26
Table 2-10: Configuration Example: Proxy Address ..............................................................................27
Table 2-11: Configuration Example: IP Profile .......................................................................................28
Table 2-12: Configuration Example: IP Group - Teams Global FQDNs ................................................29
Table 2-13: Configuration Example: Internal SRV Table .......................................................................31
Table 2-14: Configuration Example: Media Security ..............................................................................33
Table 2-15: Configuration Example ........................................................................................................34
Table 2-16: Activating 'OPTIONS' Manipulation Set ..............................................................................35
Table 2-17: Condition Table ...................................................................................................................36
Table 2-18: Classification Rules .............................................................................................................36
Table 2-19: Configuration Example: Options Terminate ........................................................................37
Table 2-20: Configuration Example: Refer Terminate............................................................................37
Table 2-21: Configuration Example: Routing from the Direct Routing Service to the SIP Trunk ...........37
Table 2-22: Configuration Example: Routing from the SIP Trunk to Direct Routing ..............................38
Table A-1: Syntax Requirements for an 'INVITE' Message ...................................................................46
Table A-2: Syntax Requirements for an 'OPTIONS' Message ...............................................................47
Table A-3: Teams Direct Routing Interface - Technical Characteristics ................................................47
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: June-18-2018
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 Web site at
https://www.audiocodes.com/services-support/maintenance-and-support.
Related Documentation
Document Name
LTRT Description
12776 Fixes
12777 Configuration Example: IP Profile; new IP-to-IP routing rules; Configuration Example: Refer
Terminate; removed figure 'Configured IP-to-IP Routing'. Appendix B.
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 Web site at https://online.audiocodes.com/documentation-feedback.
1 Introduction
This Configuration Note describes how to connect AudioCodes' SBC to Microsoft Teams
Direct Routing. The document is intended for IT or telephony professionals.
Note: This document shows how to configure the Microsoft Teams side. To configure
other entities in the deployment such as the SIP Trunk Provider and the local IP PBX,
see AudioCodes' SIP Trunk Configuration Notes (in the interoperability suite of
documents).
2.1 Prerequisites
Before you begin the 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 (see Table A-3 for more details
about supported Certification Authorities).
Users can be from any SIP domain registered for the tenant. For example, you can provide
users [email protected] with the SBC FQDN sbc1.hybridvoice.org so long as both
names are registered for this tenant.
The following IP address and FQDN are used as examples in this guide:
96.66.240.132 sbc.ACeducation.info
The certificate in the example is from DigiCert. Figure 2-2 shows the high-level configuration
flow. Detailed steps are covered later in the document.
Note: Based on your configuration, you might have more than two ports.
To configure VLANs:
1. Open the Ethernet Device Page (Setup > IP Network > Core Entities > Ethernet
Devices); there'll be a VLAN ID for the underlying interface Group 1 (Lan).
2. Add VLAN ID 2 for the WAN side as follows:
Table 2-2: Adding VLAN ID 2 for the WAN Side
Parameter Value
Index 1
Name vlan 2
VLAN ID 2
Underlying Interface GROUP_2 (Ethernet port group)
Tagging Untagged
The table below shows a configuration example; your network parameters might be different.
Table 2-3: Configuration Example: Network Interfaces
Parameter Value
3. Add a network interface for the WAN side for Teams. Use the table below as reference.
Table 2-4: Adding a Network Interface for the WAN for Teams
Parameter Value
2.4.1 Create a TLS Context for Microsoft Phone System Direct Routing
1. Open TLS Contexts (Setup > IP Network >Security>TLS Contexts).
2. Create a new TLS Context by clicking +New at the top of the interface, and then
configure the parameters using the table below as reference.
Table 2-5: New TLS Context
Parameter Value
Index 1 (default)
Name Teams (arbitrary descriptive name)
TLS Version TLSv1.0 TLSv1.1 and TLSv1.2
DTLS version Any (default)
Cipher Server RC4:AES128 (default)
Cipher Client DEFAULT (default)
Strict Certificate Extension Validation Disable (default)
DH Key Size 1024 (default)
OCSP All parameters default
Note: 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; you should see the new TLS Context and option to manage the certificates
at the bottom of 'TLS Context' table
Figure 2-8: Configured TLS Context for Direct Routing and Interface to Manage the Certificates
To generate a Certificate Signing Request (CSR) and obtain the certificate from a
supported Certification Authority:
1. Click Change Certificate>> in the TLS Contexts page. In the 'Certificate Signing
Request', enter your company's data.
Note: The domain portion of the SN must match the SIP suffix configured for Office
365 users.
2. Change the 'Private Key Size' based on the requirements of your Certification Authority.
Many CAs do not support private key of size 1024. In this case, you must change the
key size to 2048.
3. To change the key size on TLS Context, go to: Change Certificate > Generate New
Private Key and Self-signed Certificate', change the 'Private Key Size' to 2048 and then
click Generate Private-Key. To use 1024 as a Private Key Size value, you can click
Generate Private-Key without changing the default key size value.
4. Under 'Certificate Signing Request' click Generate CSR, copy it and request a Standard
SSL Certificate.
5. Obtain Trusted Root and Intermediary Signing Certificates from your Certification
Authority.
Figure 2-9: Example of Certificate Signing Request Page
2.4.3 Deploy the SBC and Root / Intermediate Certificates on the SBC
After receiving the certificates from the Certification Authority, install the
SBC certificate
Root / Intermediate certificates
a. Validate that the certificate was uploaded correctly: A message indicating that the
certificate was uploaded successfully is displayed lowermost in the page.
Figure 2-11: Message Indicating Successful Upload of the Certificate
b. Go to Setup > IP Network > Security > TLS Contexts > Direct Connect >
Certificate Information and then validate the certificate Subject Name.
3. To install the root and the intermediate certificate, go to Setup > IP Network > Security
> TLS Contexts > Direct Connect > Trusted Root Certificates and then click Import and
upload all root and intermediate certificates obtained from your Certification Authority.
Figure 2-13: Configured Trusted Certificates Page
Note: Before importing the Baltimore 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 else
you'll receive the error message 'Failed to load new certificate'. To convert to PEM
format, use Windows local store on any Windows OS and then export it as 'Base-64
encoded X.509 (.CER) certificate'.
Parameter Value
Index 0 (default)
Name LAN (arbitrary descriptive name)
Topology Location Down (default)
IPv4 Interface Name #0 [LAN]
Port Range Start 6000
Number of media session legs 100 (example value)
Default Media Realm Yes (default)
Parameter Value
Index 1 (default)
Name Teams (arbitrary descriptive name)
Topology Location Down (default)
IPv4 Interface Name #1 [WAN]
Port Range Start 7000
Number of media session legs 100 (example value)
Default Media Realm No (default)
Note: 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.
3. Click Save.
Table 2-8: Configuration Example: SIP Interface
Parameter Value
Note:
• All other parameters can be left unchanged at their default values.
• Remember to configure SIP interfaces for the PSTN trunks and other PSTN
equipment you may have.
Parameter Value
Index 1
Name Teams – Global FQDNs (arbitrary descriptive name)
SBC IPv4 SIP Interface [Teams]
TLS Context Name [Teams]
Proxy Keep Alive Using OPTIONS
Proxy Hot Swap Enable
Proxy Load Balancing Method Random Weights
DNS Resolve Method SRV
3. Click Save.
Note: All other parameters can be left unchanged at their default values.
Parameter Value
Note: All other parameters can be left unchanged at their default values.
3. Click Apply and confirm the configuration change in the prompt that pops up.
To configure an IP Profile:
1. Open the Proxy Sets table (Setup > Signaling and Media > Coders and Profiles > IP
Profiles).
2. Click +New to add the IP Profile for the Direct Routing interface. Configure the
parameters using the table below as reference.
Table 2-11: Configuration Example: IP Profile
Parameter Value
To configure an IP Group:
1. Open the IP Groups table (Setup > Signaling and Media > Core Entities > IP Group).
2. Click +New to add an IP Group for the Direct Routing interface. Configure the
parameters using the table below as reference.
Table 2-12: Configuration Example: IP Group - Teams Global FQDNs
Parameter Value
Parameter Value
To enable SRTP:
Open the Media Security page (Setup > Signaling and Media > Media > Media
Security).
Set the parameter 'Media Security' to Enable; configure the other parameters using
the table below as reference.
Table 2-14: Configuration Example: Media Security
Parameter Value
Click Save.
Click Reset to reset the device.
It's mandatory, however, that the 'CONTACT' field contains the FQDN of the SBC. More
information about the requirements can be found at Requirements for 'OPTIONS' messages
syntax.
Use the Message Manipulation Rules to configure sending the FQDN in the 'CONTACT'
header of SIP Options.
Parameter Value
Manipulation 2 (arbitrary; you can use any number, but the same for both rules)
Set ID
Message Options
Type
Condition param.message.address.dst.sipinterface=='1' (The ID assigned to the SIP Interface by the
system; view the SIP interfaces and identify the Index value assigned to Teams)
Action header.contact.url.host
Subject
Action Type Modify
Action Value ‘sbc.ACeducation.info’
Note: If modification of the Options request header itself is required, for example,
instead of sending OPTIONS 99.66.240.132 SIP/2.0 it's required to send OPTIONS
sip:[email protected] SIP/2.0, you must specify the Action Subject
header.request-uri.url
For a detailed description of the syntax used for configuring Message Manipulation
rules, refer to the SIP Message Manipulations Quick Reference Guide on AudioCodes'
website.
These rules will not apply automatically. For them to work, you must activate this set.
Parameter Value
Teams-
1 Teams WAN sbc.ACeducation.info Allow Teams
Contact
To configure a route from the Direct Routing Service to the SIP trunk:
Open the IP-to-IP Routing table (Setup > Signaling and Media > SBC > Routing > IP-
to-IP Routing).
Click +New.
Configure the rule using the example in the table below as reference. Note that this
example is only a basic routing example. For detailed information on configuring voice
routing rules, see AudioCodes' manuals.
Table 2-19: Configuration Example: Options Terminate
Parameter Value
Parameter Value
Table 2-21: Configuration Example: Routing from the Direct Routing Service to the SIP Trunk
Parameter Value
Table 2-22: Configuration Example: Routing from the SIP Trunk to Direct Routing
Parameter Value
A.1 Terminology
Recommended Not required, but to simplify troubleshooting it's recommended to configure as
shown in the examples below.
Must Strictly required. The deployment does not function correctly without the correct
configuration of these parameters.
Request-URI
• Recommended: Configure the SBC FQDN in the URI hostname when sending
calls to the Direct Routing interface
• Syntax: INVITE sip: <phone number>@<FQDN of the SBC> SIP/2.0
Contact header
• Must: When placing calls to the Direct Routing interface, the 'CONTACT' header
must have the SBC FQDN in the URI hostname
• Syntax: Contact: <phone number>@<FQDN of the SBC>:<SBC Port>;<transport
type>
• If the parameter is not configured correctly, calls are rejected with a '403
Forbidden' message.
To header
• Recommended: When placing calls to the Direct Routing interface, the 'To'
header can have the SBC FQDN in the URI hostname
• Syntax: To: INVITE sip: <phone number>@<FQDN of the SBC>
The table below shows where in the Web interface the parameters are configured and where in this
document you can find the configuration instructions.
Table A-1: Syntax Requirements for an 'INVITE' Message
Request-URI Setup > Signaling and Media > Core Entities > IP See AudioCodes' SIP Message
Group> <Group Name> > SIP Group Name Manipulation Reference Guide.
To Signaling and Media > Message Manipulations > See AudioCodes' SIP Message
Manipulation Set Manipulation Reference Guide.
Note that the Manipulation Set must be applied to
the Teams IP Group as an Outbound Message
Manipulation Set.
Contact Setup > Signaling and Media > Core Entities > IP See Section 2.12.
Group> <Group Name> > Local Host Name
In IP Groups, 'Contact' must also be configured. In
this field, define the local host name of the SBC as
a string, for example, sbc.ACeducation.info. The
name changes the host name in the call received
from the IP group. For outbound calls, configure
'Local Host Name' in the IP Group setting.
Contact header
• Must: When placing calls to the Direct Routing interface, the 'CONTACT' header
must have the SBC FQDN in the URI hostname
• Syntax: Contact: <phone number>@<FQDN of the SBC>:<SBC Port>;<transport
type>
• If the parameter is not configured correctly, the calls are rejected with a '403
Forbidden' message
AudioCodes Inc.
27 World’s Fair Drive,
Somerset, NJ 08873
Tel: +1-732-469-0880
Fax: +1-732-469-2298
©2018 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 and CloudBond 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-12777