Table of Contents


 

Document Overview

This document outlines the configuration best practices for the Ribbon-EdgeMarc 2900A when deployed with Zoom BYOC (Bring Your Own Carrier).

A ​Session Border Controller​ (​SBC​) is a network element deployed to protect​ ​SIP​ based Voice over Internet Protocol​ (VoIP) networks. ​Early deployments of SBCs were focused on the borders between two service provider networks in a peering environment. This role has now expanded to include significant deployments between a service provider's access network and a backbone network to provide service to residential and/or enterprise customers. ​The interoperability compliance testing focuses on verifying inbound and outbound calls flows between Ribbbon EdgeMarc 2900A and Zoom cloud. Ribbon Edgemarc 2900 SBC is deployed on the customer site to resolve any potential numbering format issue between Zoom and the customer's existing carrier dial plan numbering. 

This guide contains the following sections: 

References

For additional information on Zoom, visit https://zoom.us 

For additional information on the Ribbon SBC, visit https://ribboncommunications.com/

Non-Goals

It is not the goal of this guide to provide detailed configurations that will meet the requirements of every customer. Use this guide as a starting point and build the SBC configurations in consultation with network design and deployment engineers. 

Audience

This is a technical document intended for telecommunications engineers with the purpose of configuring both the Ribbon SBCs and the third-party product. Steps will require navigating the third-party product as well as the Ribbon SBC Command Line Interface (CLI). Understanding of the basic concepts of TCP/UDP, IP/Routing, and SIP/RTP is needed to complete the configuration and any necessary troubleshooting.

Note

This configuration guide is offered as a convenience to Ribbon customers. The specifications and information regarding the product in this guide are subject to change without notice. All statements, information, and recommendations in this guide are believed to be accurate but are presented without warranty of any kind, express or implied, and are provided “AS IS”. Users must take full responsibility for the application of the specifications and information in this guide.

Product and Device Details

The following equipment and software were used for the sample configuration provided:

Requirements


Equipment

Software Version

Ribbon Communications

Ribbon EdgeMarc 2900A

V15.8.0

ZoomZoom app Desktop4.6.10(20033.0407)
Zoom app Mobile4.6.11(20553.0413)

Third-party Equipment



Kapanga Softphone

1.00
Phonerlite2.77
Zoiper5.3.8

Network Topology Diagram

The following topology diagram shows connectivity between Zoom and Ribbon EdgeMarc 2900A.

Zoom EdgeMarc network topology diagram


Section A: EdgeMarc Configuration

The following EdgeMarc configurations are included in this section:

  1. Ribbon EdgeMarc SBC Configuration with Zoom BYOC#Network
  2. Ribbon EdgeMarc SBC Configuration with Zoom BYOC#Static Routes
  3. Ribbon EdgeMarc SBC Configuration with Zoom BYOC#VoIP
  4. Ribbon EdgeMarc SBC Configuration with Zoom BYOC#B2BUA

Network

Login to the EdgeMarc as root user and click Network to configure the LAN and WAN interfaces.

EdgeMarc Network LAN Interface

 


EdgeMarc Network WAN Interface and DNS configuration

Static Routes

Static routes are used to create communication to remote networks. In a production environment, static routes are mainly configured for routing from a specific network to a network that can only be accessed through one point or one interface (single path access or default route).

  • For smaller networks with just one or two routes, configuring static routing is preferable. This is often more efficient since a link is not being wasted by exchanging dynamic routing information.
  • For networks that have a LAN side Gateway on Voice VLAN or Multi-Switch Edge Devices (MSEs) with voice VLAN towards EdgeMarc, static routing configurations are not required.

Static routes need to be added towards LAN interface 172.16.X.X(IP-PBX) and WAN interface 162.12.X.0(Zoom), as Zoom uses multiple IP's in this subnet.

172.16.X.X is the IP of the phone behind IP-PBX. Add the static route so that media also works.

  • Go to Network > Static Routes to configure the routes.

Static Routes


VoIP

Go to VoIP and check whether the LAN and WAN interfaces configured earlier are reflected accordingly.

VoIP

Check the following 2 options "Route all SIP signalling through B2BUA" and "Enable Comfort Noise Generation(CNG)"

B2BUA Options

SIP Settings

  1. Go to VoIP > SIP to configure the SIP settings.
  2. Configure the SIP server address as the Zoom SIP server IP (for example, 162.12.X.X in our case)
  3. The B2BUA, UDP and TCP settings are to be kept as default configuration.

SIP

 

B2BUA Options

UDP TCP default settings

SDP - default settings

B2BUA

  1. Go to VoIP > SIP  > B2BUA 
  2. Configure the IP address of the IP-PBX (for example, 172.16X.X in our case)

B2BUA


E.164 Country code Mapping

Example: A customer has an existing carrier that only accepts U.S.A. domestic 10 digit dial plan numbering format, for example: (XXX) YYY-ZZZZ. Where XXX=area code, YYY-ZZZZ=7-digit phone number. While Zoom is using the E.164 numbering format: +(country code)(phone number). This has created a phone number format incompatibility issue between Zoom and the customer carrier. Zoom expects to receive calls in E.164 numbering format, while the customer carrier expects the USA 10-digit domestic numbering format. Edgemarc SBC is introduced to solve the numbering interop issue between the 2 entities. Edgemarc SBC inserts a “+1” for all U.S. phone numbers destined for Zoom, and removes “+1” for all U.S. phone numbers destined for customer carrier(s). 

Note

Ribbon Edgemarc 2900A SBC can be programmed for different country E.164 code mapping in addition to the U.S. dial plan.

This rule is required to "Add +1" to outgoing call towards Zoom.

  1. Name the Rule as "AddPlusOne"
  2. Check all headers and set the Country Code to "Canada/USA"

AddPlusOne


This rule is required to "Remove +1" to call towards IP-PBX.

  1. Name the Rule as "MinusPlusOne"
  2. Check all headers and set the Country Code to "Canada/USA"

MinusPlusOne

Actions - ToZoomCloud

Actions - ToOrigPBX

Match - Outbound

Match - Inbound

Section B: Zoom Web BYOC Configuration

Prerequisites:

  • Zoom Go BYOC account: A special type of Zoom account that has outbound/inbound SIP trunk that peers between the Zoom Phone Cloud and the customer’s PSTN carrier connection.
  • Customer's existing carrier/carrier equipment: Any carrier offering PSTN services. Carrier equipment can be router/gateway or another SBC that supports SIP trunk connectivity. IP-PBX was used to simulate customer carrier router/gw. Carrier has provided several DID’s to use as external BYOC numbers.
  • Trunk Registration:  BYOC is a “static” trunk between 2 static IP endpoints, therefore no trunk registration is done here.
Note

Ensure a Zoom BYOC SIP trunk is built between Zoom SBC and Edgemarc SBC deployed on a customer site.

Once the Zoom Go account is available, Login to Zoom Web BYOC portal at https://go.zoom.us/.

The following Zoom BYOC configurations are included in this section:

  1. Ribbon EdgeMarc SBC Configuration with Zoom BYOC#Add External Number
  2. Ribbon EdgeMarc SBC Configuration with Zoom BYOC#Create Zoom Users
  3. Ribbon EdgeMarc SBC Configuration with Zoom BYOC#Supplementary services configuration on Zoom

Add External Number

Go to Phone Systems Management > Phone Numbers > External

Select Add to ​add external phone numbers provided by your carrier into Zoom portal. These numbers are the DID numbers provided by your carrier.

Add External Number

External


Select BYOC as carrier, enter the customer existing phone numbers (from carrier) separated by commas. Click Submit.

Add External Number


Check the external numbers have been created successfully as shown below.

External Number created successfully

Create Zoom Users

Zoom Users are created in order to login to Zoom clients on desktop or mobile. The steps for creating a user are as follows:

  1. Go to User Management > Users. Click Add to create new Zoom users.
  2. Go to Phone System Management > Users & Rooms. Check for the User status "Active".
  3. Go to Assign Calling Plan > Assign BYOC Calling Plan. Click on "Confirm and Assign Numbers".

Create Zoom User


Assign BYOC calling plan


     4. Assign the External Numbers created previously in the Add External Number section.

Choose from Unassigned Numbers


    5. Click Confirm to finish. Once the User is assigned with a Calling Plan and Number, it should look like the following example.

Configured User

Supplementary Services Configuration on Zoom

Zoom supports multiple supplementary services. To configure different supplementary services in Zoom, refer to the following links:

      1. Auto Receptionist: https://support.zoom.us/hc/en-us/articles/360001297663-Getting-started-with-Zoom-Phone-admin-#h_a625f531-94c6-4291-909e-3d68ad685b68

      2. Call Flip: https://support.zoom.us/hc/en-us/articles/360034613311-Using-Call-Flip

      3. Shared Line Appearance (SLA) or Call Delegation: https://support.zoom.us/hc/en-us/articles/360032881731

      4. Shared Line Group/SLG: https://support.zoom.us/hc/en-us/articles/360038850792/

Section C: TLS/SRTP Configuration between Ribbon EdgeMarc 2900A and Zoom

Prerequisites:

  • As the TLS needs to performed on the WAN side,  a trusted CA (Certificate Authority) is needed. In this scenario, GoDaddy is used as a Trusted CA.
  • Zoom BYOC trunk should be enabled with TLS/SRTP.

Generate a CSR from EdgeMarc SBC

  1. Go to Security > Certificates.

    Create CSR on EdgeMarc

  2. Fill in the details as specified below:
    1. Common name: should be the valid fqdn, here "trials.com" is given as a sample configuration.

    2. Email: Provide the valid Email ID.

      Certificates


  3. Download the CSR certificate from SBC and get it signed from a Trusted CA.

    Download CSR

  4. Get the Root certificate and EdgeMarc SBC signed certificate from the Trusted CA and upload as follows:
    Key file and Password is not required.

    Upload Root certificate

  5. Upload the Signed certificate from CA as follows:

    1. Certificate Name: SBCpem (in our case).

    2. Certificate Type: SSL.

    3. Select certificate file: Signed SBC certificate from Trusted CA.

    4. Select Key file: Private key of SBC.

      Upload the Signed certificate from CA


  6. Go to VoIP > SIP.
    1. Apply the following settings as mentioned below.

      SIP Settings

  7. Choose the SBCpem certificate that was uploaded in a previous step.

    TLS cipher and WAN certificate

  8. SRTP calls need the following configuration:
    1. Go to VoIP > Media Security.

      SRTP config