CSS Stylesheet |
---|
.wiki-content h1 { border-top: 1px solid rgb(145,150,153); } |
Section | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
© 2024 Ribbon Communications Operating Company, Inc. © 2024 ECI Telecom Ltd. All rights reserved. The compilation (meaning the collection, arrangement and assembly) of all content on this site is protected by U.S. and international copyright laws and treaty provisions and may not be used, copied, reproduced, modified, published, uploaded, posted, transmitted or distributed in any way, without prior written consent of Ribbon Communications Inc.
The trademarks, logos, service marks, trade names, and trade dress (“look and feel”) on this website, including without limitation the RIBBON and RIBBON logo marks, are protected by applicable US and foreign trademark rights and other proprietary rights and are the property of Ribbon Communications Operating Company, Inc. or its affiliates. Any third-party trademarks, logos, service marks, trade names and trade dress may be the property of their respective owners. Any uses of the trademarks, logos, service marks, trade names, and trade dress without the prior written consent of Ribbon Communications Operating Company, Inc., its affiliates, or the third parties that own the proprietary rights, are expressly prohibited.
This document outlines the configuration best practices for Ribbon SBC SWe Edge interworking with Google Voice SIP Link.
Ribbon’s Edge 8000 is the newest, high-performance member of our line of services gateway routers that combines security, routing, switching, and 10 Gbps WAN interfaces with next-generation voice and data services where the combination of broadband connectivity and advanced threat mitigation capabilities are required. By consolidating fast, highly available routing, security, and next-generation SBC capabilities in a single device. A Session Border Controller (SBC) is a network element deployed to protect SIP-based Voice over Internet Protocol (VoIP) networks.
Google Voice is a telephone service that provides a U.S. phone number to Google Account customers in the U.S. and Google Works customers in Canada, Denmark, France, Netherlands, Portugal, Spain, Sweden, Switzerland and United Kingdom. Calls are forwarded to the phone number that each user must configure in the account web portal. Users can answer and receive calls on any of the phones configured to ring in the web portal. While answering a call, the user can switch between the configured phones. Subscribers in the United States can make outgoing calls to domestic and international destinations. The service is configured and maintained by users in a web-based application, similar in style to Google's email service Gmail, or Android and iOS applications on smartphones or tablets.
This document provides configuration best practices for deploying Ribbon's Edge 8000 for Google Voice SIP Link interop. Note that these are configuration best practices and each customer may have unique needs and networks. Ribbon recommends that customers work with network design and deployment engineers to establish the network design which best meets their requirements.
It is not the goal of this guide to provide detailed configurations that 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.
This is a technical document intended for telecommunications engineers with the purpose of configuring the Ribbon SBC.
To perform this interop, you need to
Info | ||
---|---|---|
| ||
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. |
The following aspects are required before proceeding with the interop:
The configuration uses the following equipment and software:
Product | Equipment/Service | Software Version |
---|---|---|
Ribbon Edge 8000 | Edge 8100/8300 | 24.1.0 build 231 |
SBC SWe Edge | 12.2.0 build 30 | |
Google Voice SIP Link | Telephone Service | NA |
Third-party Equipment | Cisco Unified Communications Manager | 14.0.1.13900-155 |
Administration and Debugging Tools
| Wireshark | 3.4.9 |
LX Tool | 2.1.0.6 |
The sections in this document follow the sequence below. The reader is advised to complete each section for successful configuration.
To deploy Ribbon SBC SWe Edge instance, refer to Installing Edge 8000.
Navigate to System Startup Configuration > BR2 VNF Management, to configure Edge 8000's management IP under IPv4 Address and enter "OK".
Info | ||
---|---|---|
| ||
Configure any 2 bridges among br1/br4/br5 for assigning 2 Ethernet in SWe Edge. In this interop guide br4 and br5 is used for Google Voice SIP Link Interop. BR1 VNF Private is mapped to Ethernet 1 of SBC. BR4 VNF Public and BR5 VNF Additional can be mapped to Ethernet 3 and Ethernet 4, based on the bridge (br4 or br5) assigned to Extra Interface 1 and Extra Interface 2 under Swe-Edge Settings. |
Navigate to System Startup Configuration > BR4 VNF Public, to configure Ethernet 3 of SWe Edge. Members can be assigned with any of the free and unassigned ge ports or sfp ports. In this Interop guide ge4 is assigned to br4 and IPv4 Address as 0.0.0.0.
Navigate to System Startup Configuration > BR5 VNF Additional, to configure Ethernet 4 of SWe Edge. Members can be assigned with any of the free and unassigned ge ports or sfp ports. In this Interop guide ge8 is assigned to br5 and IPv4 Address as 0.0.0.0.
Info | ||
---|---|---|
| ||
It is recommended to configure br4 and br5 as 0.0.0.0 when it is assigned to Extra Interface under Swe-Edge Settings or br4/br5 IP should be different from the corresponding ethernet IPs of SWe Edge. |
Navigate to System Startup Configuration > Default Gateway, to configure the default gateway for the host.
Navigate to System Startup Configuration > Swe-Edge Settings, to configure the Extra interface 1 and Extra Interface 2.
Once all the required configuration is done in setupwizard, enter SAVE to configure the setupwizard.
For more details, refer Running Setup Wizard.
After the Setup Wizard is configured, open any browser and enter the Edge 8000 management IP (https://<br2_IP>) address.
Click Enter and log in with a valid User ID and Password.
This section describes how to view the status of each license along with a copy of the license keys installed on your SBC. The Feature Licenses panel enables you to verify whether a feature is licensed, along with the number of remaining licenses available for a given feature at run-time.
From the Settings tab, navigate to System > Licensing > Current Licenses.
For more details on Licenses, refer to SWe Edge License.
From the Settings tab, navigate to System > Security > SBC Certificates > Generate SBC Edge Certificates.
After generating the CSR on Ribbon SBC, provide it to the Certificate Authority. CA generally provides the following certificates:
There are two ways to import SBC Primary Certificate as described below:
To import an X.509 signed certificate:
To import a PKCS12 Certificate and Key:
A Trusted CA Certificate is a certificate issued by a Trusted Certificate Authority. Trusted CA Certificates are imported to the SBC SWe Edge to establish its authenticity on the network.
Info | ||
---|---|---|
| ||
Refer to Google Voice SIP Link documentation for other compatible CAs. |
From the Settings tab, navigate to System > Security > SBC Certificates > Trusted CA Certificates.
This section describes the process of importing Trusted Root CA Certificates using either the File Upload or Copy and Paste method.
Use the steps above to import GTS Root R1 and GlobalSign Root CA certificates from Google Voice.
Info | ||
---|---|---|
| ||
When the Verify Status field in the Certificate panel indicates Expired or Expiring Soon, replace the Trusted CA Certificate. You must delete the old certificate before importing a new certificate successfully. |
Warning | ||
---|---|---|
| ||
Most Certificate Vendors sign the SBC Edge certificate with an intermediate certificate authority. There is at least one, but there could be several intermediate CAs in the certificate chain. When importing the Trusted Root CA Certificates, import the root CA certificate and all Intermediate CA certificates. Failure to import all certificates in the chain causes the import of the SBC Edge certificate to fail. Please refer to Unable To Get Local Issuer Certificate for more information. |
The SBC SWe Edge supports five system created logical interfaces known as Administrative IP, Ethernet 1 IP, Ethernet 2 IP, Ethernet 3 IP, and Ethernet 4 IP. In addition to the system created logical interfaces, the Ribbon SBC SWe Edge supports user created VLAN logical sub-interfaces.
Ethernet 3 IP and Ethernet 4 IP are used for this interop.
From the Settings tab, navigate to Networking Interfaces > Logical Interfaces.
Ethernet 3 IP
Configure the Primary Address for Ethernet 3 as shown in the below snapshot.
Ethernet 4 IP
Configure the Primary Address for Ethernet 4 as shown in the snapshot below.
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 another network that you can only access through one point or one interface (single path access or default route).
Destination IP
Specifies the destination IP address.
Mask
Specifies the network mask of the destination host or subnet. If the 'Destination IP Address' field and 'Mask' field are both 0.0.0.0, the static route is called the 'default static route'.
Gateway
Specifies the IP address of the next-hop router to use for this static route.
Metric
Specifies the cost of this route and therefore indirectly specifies the preference of the route. Lower values indicate more preferred routes. The typical value is 1 for most static routes, indicating that static routes are preferred to dynamic routes.
From the Settings tab, navigate to SBC > Protocols > IP > Static Routes. Click the icon to add the entries.
Media Profiles allow you to specify the individual voice and fax compression codecs and their associated settings, for inclusion in a Media List. Different codecs provide varying levels of compression, allowing one to reduce bandwidth requirements at the expense of voice quality.
From the Settings tab, navigate to SBC > Media > Media Profiles. From the Create Media Profile drop-down, select Voice Codec Profile.
The codecs G711A and G711U are configured on the SBC SWe Edge by default. Configure OPUS and G722 by following the steps provided below:
For OPUS:
For G722:
Transformation Tables facilitate the conversion of names, numbers and other fields when routing a call. They can, for example, convert a public PSTN number into a private extension number, or into a SIP address (URI). Every entry in a Call Routing Table requires a Transformation Table. In addition, Transformation tables are configurable as a reusable pool that Action Sets can reference.
From the Settings tab, navigate to SBC > Call Routing > Transformation. Click the icon to create a Transformation Table.
Transformation Table Entry
Anchor | ||||
---|---|---|---|---|
|
From the Settings tab, navigate to SBC > Media > Media List. Click the icon at the top of the Media List View page.
Anchor | ||||
---|---|---|---|---|
|
The Message Manipulation feature comprises two primary components that work in concert to modify SIP messages. Those component are Condition Rules and Rule Tables. SIP Message rules per table include all SIP rule types: Header, Request, Status and Raw.
The Message Manipulation PSTN_RULE is used for the following purposes:
Message Rule Table
Message Rule can be added to: all messages, all requests, all responses or selected messages.
From the Settings tab, navigate to SBC > SIP > Message Manipulation > Message Rule Table. Click the to create a Message Rule Table.
Message Rule Table Entry
Raw Message Rule:
Raw rules allow you to manipulate any string in the entire message: request, headers and payload. If the condition rule evaluates true, the MME will search the message for content matching the "Match Regex" and replace it with the content specified in the "Replace Regex".
Header Rule:
Anchor | ||||
---|---|---|---|---|
|
SIP Profiles control how SBC Edge communicates with SIP devices. They control important characteristics such as Session Timers, SIP Header Customization, SIP Timers, MIME Payloads and Option Tags.
From the Settings tab, navigate to SBC > SIP > SIP Profiles. Click the to create a new SIP Profile.
Anchor | ||||
---|---|---|---|---|
|
SIP Server Tables contain information about the SIP devices connected to the SBC Edge. The entries in the tables provide information about the IP Addresses, ports and protocols used to communicate with each server. The Table Entries also contain links to counters that are useful for troubleshooting. The SIP Server supports either an FQDN or IP Address (V4 or V6).
From the Settings tab, navigate to SBC > SIP > SIP Server Tables. Click the to create a new SIP Server Table.
SIP Server Table Entry
Anchor | ||||
---|---|---|---|---|
|
Call Routing allows calls to be carried between Signaling Groups, thus allowing calls to be carried between ports and between protocols (like ISDN to SIP). Routes are defined by Call Routing Tables, which allow flexible configuration of how calls are to be carried and how they are translated. These tables are the central connection points of the system, linking Transformation Tables, Message Translations, Cause Code Reroute Tables, Media Lists and the Signaling Groups.
From the Settings tab, navigate to SBC > Call Routing > Call Routing Table. Click the to create a Call Routing Table.
Anchor | ||||
---|---|---|---|---|
|
Signaling groups allow telephony channels to be grouped together for the purposes of routing and shared configuration. They are the entity to which calls are routed, as well as the location from which Call Routes are selected. They are also the location from which Tone Tables and Action Sets are selected.
From the Settings tab, navigate to Signaling Groups. Click Add SIP SG.
From the Settings tab, navigate to System > Node-Level Settings.
Info | ||
---|---|---|
| ||
Make sure the DNS server is reachable from the Edge 8000 host. |
Anchor | ||||
---|---|---|---|---|
|
TLS Profiles are used by SIP Signaling Groups when the TLS transport type is selected for incoming and outgoing SIP trunks (Listen Ports), and in SIP Server Tables when TLS is selected as the Server Host protocol.
From the Settings tab, navigate to SBC > SBC Security > TLS Profiles. Click the to create a new TLS profile.
Anchor | ||||
---|---|---|---|---|
|
SDES-SRTP Profiles define a cryptographic context which is used in SRTP negotiation. SDES-SRTP Profiles are required for enabling media encryption and are applied to Media Lists.
From the Settings tab, navigate to SBC > Media > SDES-SRTP Profiles. Click the to create a new SDES-SRTP profile.
Info | ||
---|---|---|
| ||
Google Voice does not support MKI, hence the Key Identifier Length must be set to 0 on the Ribbon SBC SWe Edge. |
Anchor | ||||
---|---|---|---|---|
|
From the Settings tab, navigate to Media > Media List. Click the icon at the top of the Media List View page
Anchor | ||||
---|---|---|---|---|
|
The Message Manipulation GOOGLE_RULE is used for the following purposes:
Message Rule Table
From the Settings tab, navigate to SBC > SIP > Message Manipulation > Message Rule Table. Click the to create a Message Rule Table.
Message Rule Table Entry
Header Rule:
Request Line Rule:
Header Rule:
Anchor | ||||
---|---|---|---|---|
|
From the Settings tab, navigate to SBC > SIP > SIP Profiles. Click the to create a new SIP Profile.
Info | ||
---|---|---|
| ||
The session will always be refreshed by Ribbon SBC SWe Edge as per the Google Voice requirement. |
Anchor | ||||
---|---|---|---|---|
|
From the Settings tab, navigate to SBC > SIP > SIP Server Tables. Click the to create a new SIP Server Table.
Info | ||
---|---|---|
| ||
For production, the Google Voice (GV) hostname is siplink.telephony.goog. |
Anchor | ||||
---|---|---|---|---|
|
From the Settings tab, navigate to SBC > Call Routing > Call Routing Table. Click the to create a Call Routing Table.
Anchor | ||||
---|---|---|---|---|
|
From the Settings tab, navigate to Signaling Groups. Click Add SIP SG.
Warning | ||
---|---|---|
| ||
Ensure the "TLS Listen Port" towards the Google Voice Server is always set to 5061 in order to accept the incoming messages from Google Voice Server using an already established TLS connection with the Ribbon SBC. |
Call Routing entries must be created after creating SIP Signaling Groups as Destination SGs need to be attached to these entries.
PSTN to GV:
GV to PSTN:
For configuration on Google Voice, visit support.google.com/a?p=siplink.
The following checklist depicts the set of services/features covered through the configuration defined in this Interop Guide.
Sr. No. | Supplementary Services/ Features | Coverage |
---|---|---|
1 | Auto Attendant | |
2 | DTMF - RFC2833 | |
3 | Basic Call Setup & Termination | |
4 | Calls to/from GV Android Client, Web Client and Desk-phone (OBi based) | |
5 | Long Duration Calls | |
6 | Session Timers | |
7 | Voice Mail Deposit and Retrieval | |
8 | 4xx/5xx Response Handling | |
9 | Ring Group | |
10 | Call Hold/Resume | |
11 | Call Transfer (Attended) | |
12 | Call Transfer (Blind/ Unattended) | |
13 | Call Forwarding Unconditional | |
14 | Call Forward No Answer | |
15 | Call Cancel/Reject | |
16 | Short Code Dialing |
Legend
Supported | |
Not Supported |
The following items should be noted in relation to this Interop - these are either limitations, untested elements, or useful information pertaining to the Interoperability.
These issues will be addressed by GV/Ribbon in their upcoming releases.
For any support related queries about this guide, please contact your local Ribbon representative, or use the details below:
For detailed information about Ribbon products & solutions, please visit:
https://ribboncommunications.com/products
This Interoperability Guide describes successful configuration for Google Voice SIP Link interop involving the Ribbon Edge 8000.
All features and capabilities tested are detailed within this document - any limitations, notes, or observations are also recorded in order to provide the reader with an accurate understanding of what has been covered, and what has not.
Configuration guidance is provided to enable the reader to replicate the same base setup - there may be additional configuration changes required to suit the exact deployment environment.
© 2024 Ribbon Communications Operating Company, Inc. © 2024 ECI Telecom Ltd. All rights reserved.