Ribbon - Metaswitch Interop Guide for STIR/SHAKEN Testing (PSX and CLI)

Document Overview

This document provides a configuration guide for Ribbon Solution (SBC/PSX) with METASWITCH Server.

• For additional information on Ribbon SBC, refer to https://ribboncommunications.com/
  
  

This document outlines the configuration:

• with PSX: Configuring Ribbon PSX for HTTPS service
• with EMA: Configuring STI profile on the SBC

Scope

This document provides the Ribbon Solution (SBC/PSX) Core configuration with METASWITCH for documented products and their versions. This is a general reference document that requires user input during the configuration. For PSX/SBC configurations, the screen captures in this document are limited to only necessary provisioning areas.

Non-Goals

This document does not provide the test cases details, the success criteria, processes and execution steps of testing that were performed. Also, this document does not focus on general EMA/PSX configurations and provisioning areas for the METASWITCH server. 

Introduction

STIR/SHAKEN Interop testing is performed between Ribbon’s Solution (SBC/PSX) and METASWITCH AS/VS servers. This document outlines the SBC and PSX configurations required to achieve this purpose.

Audience

This is a technical document intended for telecommunications engineers with the purpose of configuring both the Ribbon SBC and PSX. Navigating the third-party product as well as the Ribbon SBC Command Line Interface (CLI) is required. Understanding the basic concepts of TLS/TCP/UDP, IP/Routing, and SIP/SRTP is also necessary to complete the configuration and any required troubleshooting.

Requirements

The sample configuration uses the following equipment and software:

Reference Configuration

The following figure illustrates connectivity between the METASWITCH SVS and Ribbon PSX.

Support

For any questions regarding this document or the content herein, contact your maintenance and support provider.

Global Configuration

Profile

Enable the STI services under the profile.

set profiles services stiProfile stiProfile1 state enabled
commit

Trunk Group

All the Trunk Groups which require STI services needs to be configured with the above mentioned STI profile.

set addressContext default zone <zone> sipTrunkGroup <TG> services stiProfile stiProfile1
commit

PSX Configuration

This section provides the configuration aspects required for STIR/SHAKEN interop only. For any other configurations, please refer the standard configuration guide.

DNS Related

Configure the DNS zone and LWRESD profiles. These are required for DNS resolution towards the METASWITCH Server.

Softswitch Device

Softswitch Device should have the following devices created.

STI Server Device

Create STI Server device. 

STI Server Device

Process Configuration

Update the Process Configurations for HTTPC, SLWRESD and PES.

Process Management

Activate httpc and slwresd process under Process Management used by Softswitch. Set log level to 4 if all logging is required. Argument "-C 1" is an optional argument required for curl log generation. 

Process Management

Number Translation Criteria

Create Number Translation Criteria tables with Lookup Type set to either Signing or Verification.

Trigger Type Priority

Check the Trigger Type priority table, if the Call processing Element created in the above step is not present, then create it.

Trigger Type Priority

Error Mapping Profile

Create the Error Mapping Profile with Error code, corresponding SIP reason code and Reason Text. 

Error Mapping Profile

STI Service Definition

Create Service Definitions for Signing and Verification. Set Error Mapping Profile if required.

STI Profile

Create the STI Signing and Verification profiles and add them to the corresponding Egress TGs.

Routing Label

Create routing label with either the Signing or Verification flag enabled.

Routing Label

Trunk Group

Select the corresponding STI Profile under the Trunk Group.

Trunk Group

IP Signaling Profile

Enable the P-Asserted-ID under Privacy for the IPSP which is used by the TG triggering Signing Request.

IP Signaling Profile

Packet Service Profile

"Enable DTLS" and "Relay DTLS SRTP" flags should be enabled under PSP, if the "Fingerprint" attributes need to be processed.

Packet Service Profile

Conclusion

This document describes the configuration steps required for the Ribbon Solution to successfully test interop with METASWITCH AS/VS.  All feature and serviceability test cases were completed and passed.