SIP Param Based Action Profile - CLI

Overview

Use the SIP Param Based Action profile object in conjunction with SIP Message Manipulation (SMM) processing to enable secondary trunk group selection.  

By default, the SBC selects the ingress trunk group for an incoming SIP request based on its source IP address and port. However, using SMM, you can extract a value from the incoming message and use the value to select a new ingress trunk group. This secondary trunk group selection enables applying trunk group policies and profiles on a more granular basis in subsequent processing of the session.

The SIP Param Based Action profile maps values that might be extracted from incoming messages, using the SMM storeSipParam operation, to specific SIP trunk group names. If the extracted storeSipParam value matches an entry configured in a SIP Param Based Action profile specified with the SMM storeProfileName operation, the SBC selects the trunk group specified by the matching entry as the new ingress trunk group.

When you define entries within a SIP Param Based Action profile you specify the type of matching to perform. The options include: 

• full - entries using the full option include a list of one or more specific parameter values. The extracted value must match one of the entry's specified values exactly to be considered a match. For example, the list might consist of a set of host names.    
•  range - entries using the range option define a starting value and an ending value in the entry. The extracted value must fall within the range to be considered a match. For example, the range might consist of numeric range for the username.
• regexp - entries using the regexp option define the entry using a regular expression. The extracted value must match the regular expression to be considered a match.

If a match occurs, in all subsequent processing, the SBC considers the profiles and configurations called for by the new ingress trunk group. This includes CAC, SMM, Emergency profiles, and so on. If the extracted value does not match any of the entries in the profile, the SBC does not select a new ingress trunk group and continues using the original ingress trunk group.

Command Syntax

Use following CLI syntax to configure a SIP Param Based Action profile.

%   set profiles signaling sipParamBasedActionProfile <profileName> 
          action <none | selectTG>
		  operation <none | storeIpTg>
          entry <0 to 2056>
             trunkGroupName <trunk group name>
             matchType 
               full 
                 param <parameter value>
               none
               range 
                 rangeEnd <end of parameter range>
                 rangeStart <start of parameter range>
               regexp
                 paramRegexp <regular expression>

Command Parameters

Command Example

The following commands create a sipParamBasedActionProfile named "PROFILE" that defines three entries to compare against the parameter extracted with the storeSipParam operation. The first entry uses full matching and specifies that if the extracted parameter is "username1," "username2," or "username3," then the new ingress trunk group is "TG1." The second entry uses regular expression matching and specifies that if the extracted parameter matches the regular expression "02*" then the new ingress trunk group is "TG2." The third entry uses range matching and if the extracted parameter is within the range 8000000000 and 9999999999, then the new ingress trunk group is "TG3."

% set profiles signaling sipParamBasedActionProfile PROFILE action selectTG
% set profiles signaling sipParamBasedActionProfile PROFILE operation storeIpTg
% set profiles signaling sipParamBasedActionProfile PROFILE 
% set profiles signaling sipParamBasedActionProfile PROFILE entry 1 trunkGroupName TG1 matchType full param username1
% set profiles signaling sipParamBasedActionProfile PROFILE entry 1 param username2
% set profiles signaling sipParamBasedActionProfile PROFILE entry 1 param username3
% set profiles signaling sipParamBasedActionProfile PROFILE entry 2 trunkGroupName TG2 matchType regexp paramRegexp 02*
% set profiles signaling sipParamBasedActionProfile PROFILE entry 3 trunkGroupName TG3 matchType range rangeStart 8000000000 rangeEnd 9999999999
% commit