Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Add_workflow_for_techpubs
AUTH1UserResourceIdentifier{userKey=8a00a0c85b2726c2015b58aa779d0003, userName='null'}
JIRAIDAUTHCHOR-3579
REV5UserResourceIdentifier{userKey=8a00a0c85b2726c2015b58aa779d0003, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a0c85b2726c2015b58aa779d0003, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cef30cd0, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cc5207f0, userName='null'}

Overview

The SBC Edge is certified to offer Microsoft Teams Direct Routing services; the SBC Edge can be used to connect any Teams client to:

  • A PSTN trunk, whether based on TDM (e.g. PRI, BRI, etc.), CAS, or SIP
  • 3rd-party, non-Teams-certified SIP/TDM based PBXs, analog devices, and SIP clients

These instructions detail how to configure the SBC Edge (SBC 1000/2000 and SBC SWe Lite) deployed with a Microsoft partner (sells telephony services delivered to Microsoft Teams) to connect Microsoft Teams Direct Routing services for multiple independent enterprise customers (Tenants). A tenant Tenant is used within the Microsoft environment as a single independent enterprise that has subscribed to Office 365 services; through this tenantTenant, administrators manage projects, users, and roles. Refer to Configure a Session Border Controller for multiple tenantsTenants for Microsoft partner requirements in support of multiple tenantsTenants.

Network Topology - SBC Edge Deployed in a Microsoft Partner Network to Connect Microsoft Teams Direct Routing for Multiple Tenants

The network diagram below shows an SBC Edge device deployed at the Microsoft partner data center, including communication between:

  • Tenants and the enterprise's legacy PBX based clients, and
  • Tenants and the PSTN supported by the Microsoft partner.

 

Pagebreak
Caption
0Figure
1Ribbon SBC Edge at Microsoft Partner Data Center Supporting Multiple Tenants

 


Microsoft offer an advanced solution called "Carrier/Derived Trunk" that allows the Partner to control specific parameters on the end-user Tenants (list of codecs, port to use, Media Bypass activation, and such). This advance solution requires the following:

  • Requires all the Derived Trunks (used by end customer) being a subdomain of the Carrier Trunk.
  • Requires all Derived Trunks (used by end customer) to use Carrier Wild card certificate.
  • Requires all the Derived Trunk (used by end customer) being configured with the same PSTN Gateway parameter (Codec, Max Call allowed, Media Bypass, and such).

For more information, refer to: https://docs.microsoft.com/en-us/microsoftteams/direct-routing-sbc-multiple-tenants.

How Call Traffic Routes between the SBC Edge and Microsoft Teams Tenants

Each Microsoft Teams Tenant requires a dedicated Egress SIP Signaling Group configured with a SIP Profile to match the Microsoft Online PSTN Gateway created on the Microsoft Teams Tenant. This Signaling Group is only used for call traffic directed to Microsoft Teams, and specifically configured not to accept incoming SIP Requests.

Call traffic from Microsoft Teams to the SBC Edge is aggregated onto single Ingress SIP Signaling Group for all Tenants. The Call Routing Table associated with this Ingress SIP Signaling Group is configured to distribute the traffic to specific ITSP, based on the call parameters (such as the Called Address/Number)

The network topology supported are detailed below.

Topology 1 - ITSP Aggregation for all Teams Tenants

This network topology is referred to as "Microsoft Teams Direct Routing Carrier." This topology enables the partner to offer Microsoft Teams external calling capability to the end customer. Usually the partner owns the ITSP contract. For lower cost routing, the partner can choose to have more than one ITSP; routing is then decided based on destination, time of the day, and such.

Caption
0Figure
1Routing Summary for ITSP Aggregation

Image AddedImage Added

 

Topology 2 - ITSP Segregation per Teams Tenant

This network topology is referred to as "Teams Direct Routing Bring your Own Trunk." This topology enables the partner to offer the SBC management to the end customer. Usually the end customer owns the ITSP contract; only a specific Tenant can use the associated ITSP.

Caption
0Figure
1ITSP Segregation per Teams Tenant

Image AddedImage Added

 

Topology 3 - Teams Tenant Segregation

This network topology splits the inbound Teams traffic. For example, it can be useful to limit the number of sessions allowed per Teams Tenant from the SBC side or use a different certificate per Tenant. This topology requires an SBC configuration that limits the number of Tenants that can be supported on the SBC. Since this implementation requires one signaling port per Tenant, it does not support the Carrier/Derived Trunk capability.

Info

This topology is not detailed in this Best Practice.


Caption
0Figure
1Multi-Tenant Routing Call Routes

Image Removed

pagebreak
Teams Tenant Segregation

Image AddedImage Added

 

Step 1: Install SBC Edge (if required)

Excerpt Include
Connect SBC Edge to Microsoft Teams Direct Routing
Connect SBC Edge to Microsoft Teams Direct Routing
nopaneltrue

Multiexcerpt include
MultiExcerptNameInstallation
PageWithExcerptConnect SBC Edge to Microsoft Teams Direct Routing

Pagebreak

Step 2: Prerequisites

Include Page
_Teams_Routing_Prerequisites_New
_Teams_Routing_Prerequisites_New

Wildcard Certificate

Microsoft Teams Direct Routing in support of multiple tenants Tenants requires wildcard certificate support to protect the Microsoft partner's SBC FQDN and Tenant's SBC FQDN (i.e.that is, SAN=myMicrosoftPartner.com, SAN=*.myMicrosoftPartner.com). The SBC Edge products fully support wildcard certificates.

SBC Edge Configuration for Microsoft Teams Direct Routing 

Info
  • For SBC Edge Not configured for Microsoft Teams Routing: If the SBC Edge has not been configured for Microsoft Teams Direct Routing through the Easy Configuration Wizard, configure the SBC Edge per Connect SBC Edge to Microsoft Teams Direct Routing. Once complete, move to Step 3 below.

OR

  • For SBC Edge Previously Configured for Microsoft Teams Direct Routing: Move to Step 3.

Step 3: Configure each Tenant

The SBC Easy Configuration wizard configures the SBC Edge for one Tenant; additional Tenants subscribed to Microsoft Office 365 services (Microsoft Teams Direct Routing) must be configured manually with the configuration items below. For documentation purposes, the following terms are used in the configuration examples.

Caption
0FigureTable
1Configuration Used in This Document
ConfigurationExample used in this document
SBC FQDN for Microsoft partnermyMicrosoftPartner.com
SBC FQDN for Tenanttenant1tenant2.myMicrosoftPartner.com
Microsoft descriptionMicrosoft Phone System
Tenant Name

Microsoft Phone System Tenant 12

Access the WebUI

You must access the SBC Edge's WebUI to configure the items below. To access the WebUI, refer to: Logging into the SBC Edge.

Create a New SIP Profile for each Tenant

The SIP Profile controls how the SBC Edge communicates with SIP devices; the profiles control important characteristics such as: session timers, SIP header customization, SIP timers, MIME payloads, and option tags. The SIP Profile must match the information in

Topology 1 - Configure the SBC for ITSP Aggregation for all Teams Tenants

To implement ITSP Aggregation, the SBC configuration must contain the following:

  • Call traffic from the ITSP to Microsoft Teams uses a single SIP Signaling Group to Teams Direct Routing. The destination Tenant is included in the Transformation table; each Microsoft Teams Tenant requires a dedicated Transformation Entry that matches the Microsoft Online PSTN Gateway created on the Microsoft Teams Tenant.
  • Call traffic from Microsoft Teams to ITSP uses the default call route to the ITSP.

 

Caption
0Figure
1Multi Tenant Routing on SBC Edge with ITSP Aggregation

Image Added

Create a Transformation entry for the call from ITSP to the new Tenant

In the SBC, configure a Transformation table entry for Teams Direct Routing (Entry #2 on previous diagram). This entry will match the input of the new end customer number and configure the proper Teams Tenant output.

  1. In the WebUI, click
  2. Access the WebUI. Refer to Logging into the SBC Edge.
  3. Click the Settings tab.
  4. In the left navigation

    pane

    page, access

     SIP

    Call Routing >

    SIP Profiles. For details on parameter definitions, refer to Creating and Modifying SIP Profiles.
  5. Click the (Image Removed) icon at the top of left corner and add a new SIP profile.

  6. Transformation.

  7. Select the Transformation Table called From Microsoft Teams: Passthrough (the entry created in the Easy Configuration Wizard).
  8. Click the (Image Added) icon.
  9. Configure the parameters as shown below. Leave all other parameters as default.

  10. Click OK. Configure parameters shown below:
    pagebreak

    Caption
    0Table
    1SIP Profile Transformation Entry Tenant 2 Configuration - Example Values
    ParameterExample Value

    Description

    To Microsoft Phone System Tenant

    1

    FQDN in From Header

    Static
    Static Host<Tenant's SBC FQDN> tenant1.myMicrosoftPartner.com

    FQDN In Contact Header

    Static

    2 (example name)

    Match TypeOptional

    Input Type

    Called Address/Number

    Input Value

    <Enter Tenant 2 Phone Number > (\+151048512\d{2})

    Output Type

    SIP: Contact Domain

    Output Value

    tenant2

    Origin Field name

    <Tenant's SBC FQDN> tenant1.myMicrosoftPartner.com
    Caption
    0Figure
    1SIP Profile Transformaton Entry Tenant 1 2 - Example

    Image Removed

Create a New Transformation Table for each Tenant

  • In the WebUI, click the Settings tab.
  • In the left navigation page, access SIP > Transformation Tables.
  • Click the (Image Removed) icon at the top left corner to add a new Transformation Table.

  • Configure the parameters as shown below and click OK. For details on parameter definitions, refer to Creating and Modifying Transformation Tables
    1. Image Added


    Topology 2 - Configure the SBC for ITSP Segregation per Teams Tenant

    To implement ITSP Segregation, the SBC configuration must contain the following:

    • Call traffic from the ITSP to Microsoft Teams uses the single SIP Signaling Group to Teams Direct Routing. The destination Tenant is used in the Transformation table. Each Microsoft Teams Tenant requires a dedicated Transformation Entry that matches the Microsoft Online PSTN Gateway created on the Microsoft Teams Tenant.
    • Call traffic from Microsoft Teams to the SBC Edge is aggregated onto the single SIP Signaling Group for all Tenants. The Call Routing Table associated with this SIP Signaling Group is configured to distribute the traffic to a specific ITSP, based on the original tenant (SIP: R-URI Domain).

    Caption
    0

    Table

    Figure
    1Multi Tenant Routing on SBC Edge with ITSP Segregation

    Image Added

    Info

    The instructions below require that you have created the SIP Signaling Group, SIP Server Table, Call Routing Table, and Transformation Table for the new ITSP. For details, refer to the following:

     

    Create a Transformation entry for the call from ITSP to the new Tenant

    1. In the WebUI, click the Settings tab.
    2. In the left navigation page, access Call Routing > Transformation.

    3. Click on the Transformation Table > From SIP Trunk 2: Passthrough (the entry created when you added your ITSP 2 configurationTransformation Table - Example Values
      ParameterExample Value

      Row ID

      Assigned by the system

      Description

      Microsoft Phone System Tenant 1

      Caption
      0Figure
      1Create Transformation Table

      Image Removed

      From the left navigation pane, click on the Transformation Table> Microsoft Phone System Tenant 1 (the entry created in the last step).
    4. Click the (Image Modified) icon.
    5. Configure the parameters as shown below. Leave all other parameters as default.

    6. Click OK. 

      Caption
      0FigureTable
      1Transformation Entry Tenant 1 2 Configuration - Example
      ParameterExample Value

      Description

      From ITSP 2 To Microsoft Phone System Tenant 1 2 (example name)

      Match TypeMandatoryOptional

      Input Type

      Called Address/Number

      Input Value

      <Enter Tenant 1 Phone Number > (\+151048512\d{2}(.*)

      Output Type

      Called Address/Number
      SIP: Contact Domain

      Output Value

      \1
      pagebreak
      tenant2.myMicrosoftPartner.com
      Caption
      0Figure
      1Transformation Entry Tenant 12 - Example

      Image Added

       Image Removed

    Create a New

    Signaling Group for Each Tenant

    Two Signaling Group types are required for call traffic between Teams and the SBC's SIP Trunk:

    Ingress Signaling Group (For Calls From Teams). Calls are routed on a Single ingress SIP Signaling Group for all Tenants. Calls are then distributed by the Call Routing Table to the specific ITSP. The From Microsoft Teams Signaling Group is created during Easy Configuration.

    Transformation Table for the call from the new Tenant to ITSP 2

    Egress Signaling Group (For Calls from the PSTN SIP Trunk to a Tenant). Each Microsoft Teams Tenant requires a dedicated egress SIP Signaling Group. This Signaling Group is used only for call traffic directed to Microsoft Teams; this Signaling Group is configured not to accept incoming SIP requests. The calls are then distributed by the Call Routing Table to the specific Tenant. The maximum number of tenants is limited to the maximum number of signaling groups (this assumes one signaling group per tenant). This signaling group must be created new for each Tenant.

    Create the egress Signaling Group as follows:

    1. In the WebUI, click the Settings tab.
    2. In the left navigation page, access Signaling Groups.
      Call Routing > Transformation.
    3. Click the (Image Added) icon at the top left corner to add a new Transformation TableFrom the Create Signaling Group drop down box, select SIP Signaling Group.

    4. Configure the parameters as shown below . Leave the default values for all other parameters. and click OK. For details on parameter definitions, refer to Creating and Modifying SIP Signaling GroupsTransformation Tables..Click OK. 

      Caption
      0Table
      1Signaling Group Tenant 1 Configuration Transformation Table - Example Values
       ParameterParameterExample Value

      Row ID

      Assigned by the system

      Description

      From Microsoft Phone System Tenant 2 To ITSP 2

      Caption
      0Figure
      1

      SIP Profile

      Create Transformation Table

      Image Added

    5. From the left navigation pane, click on the Transformation > From Microsoft Phone System Tenant 1 (2 To ITSP 2 (the entry created in previous stepsthe last step)

      Media List ID

      SIP Trunk Routing List (automatically created in Easy Configuration)

      Signaling Media/Source IP

      Ethernet 1 (example, pick the interface which faces the Microsoft Phone System)

      SIP server table

      SIP Trunk Server (automatically created in Easy Configuration) 

      Load Balancing

      Priority: Register All

      Call Routing Table

      From SIP Trunk (automatically created in Easy Configuration)  

      Outbound NAT Traversal*

      Static NAT

      NAT Public IP*

      Example: X.XX.XX.X (Only required if Outbound NAT Traversal is selected)Federated IP/FQDNThis field must stay empty.
      NOTE: In Easy Configuration, the signaling Group from From Teams (Calls from Teams Signaling Group to PSTN SIP Trunk) generates sip-all.pstnhub.microsoft.com as the Federated IP/FQDN. This FQDN accepts all IP addresses from Teams Signaling Group. As a result, all incoming traffic from Teams is accepted..
    6. Click the (Image Added) icon.
    7. Configure the parameters as shown below. Leave all other parameters as default.

    8. Click OK. 

      Caption
      0Table
      1Transformation Entry Tenant 1 Configuration - Example
      ParameterExample Value

      Description

      To ITSP 2 (example name)

      Match TypeMandatory

      Input Type

      SIP: R-URI Domain

      Input Value

      (tenant2.myMicrosoftPartner.com):5061

      Output Type

      SIP: R-URI Domain

      Output Value

      \1

      *Outbound NAT Traversal and the NAT Public IP is required when the SBC is behind a NAT (the pubic IP address of NAT device is required when the SBC has Private IP). The Public IP address specified in the screen graphic is an example only

      Caption
      0Figure
      1

      Signaling Group

      Transformation Entry Tenant

      1

      2 - Example

      Image Added

      Image Removed

       

    Add

    Tenant Entry to Call Routing Table

    New Routing Table Entry for the Call from the new Tenant to ITSP 2

    The Easy Configuration process (used for initial configuration) creates the first connection to Teams Direct Routing. This configuration also creates two Call Routing Tables for transporting calls between the SBC's SIP Trunk and Microsoft Teams:

    From SIP Trunk

    (

    . Calls from SIP Trunk to Teams

    ) and

    .

    From Microsoft

    Teams (

    Team. Calls from Teams to SIP Trunk

    )

    .

    For calls to be routed properly from the SIP Trunk from the SIP Trunk to an individual Tenant to the proper ITSP, an entry must be added to the the From SIP Trunk Microsoft Teams Routing table (this Routing Table was created as part of Easy Configuration) for each Tenant. Add an entry in the From Microsoft Teams Call Routing table for each Tenant as follows:

    1. In the WebUI, click the Settings tab.
    2. From the left navigation pane, click on the Call Routing table. Click on the From SIP Trunk From Microsoft Teams Call Routing Table.  

    3. Click the (Image Modified) icon to add an entry.
    4. Configure the parameters as shown below. Leave all other parameters as default. For details on parameter definitions, refer to Creating and Modifying Entries to Call Routing Tables.

    5. Click OK. 

      Caption
      0FigureTable
      1Call Routing Tenant 1 - Routing Table configurationEntry - Example Values

      Parameter

      Example Value

      DescriptionFrom Microsoft Phone System Tenant 1

      To ITSP 2

      Number/Name Transformation Table

      From Microsoft Phone System Tenant 12 To ITSP 2

      Destination Signaling Groups

      Microsoft Phone System Tenant 1 ITSP 2 (from the previous steps)

      NOTE: This is the dedicated egress Signaling Group created above; the Routing Table must have a corresponding entry for each dedicated egress Signaling Group created for each Tenant.

      Pagebreak
      Caption
      0Figure
      1Create Call Routing Table Entry - Example

      Image Removed

    pagebreak
    1. Image Added

    Step 4: Confirm SBC Edge Links to Microsoft Teams

    Multiexcerpt include
    MultiExcerptNameConfirmLinks
    PageWithExcerptConnect SBC Edge to Microsoft Teams Direct Routing

    Pagebreak

    Step 5: Place a Test Call

    Multiexcerpt include
    MultiExcerptNameTestCall
    PageWithExcerptConnect SBC Edge to Microsoft Teams Direct Routing

    Pagebreak