Versions Compared

Old Version 5

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version Current

changes.mady.by.user Ribbon Communications

Saved on

Key

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

Add_workflow_for_techpubs
AUTH1UserResourceIdentifier{userKey=8a00a0c880e94aad0181077fa2530009, userName='null'}
JIRAIDAUTHSBX-124027131158
REV5UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb8305e98a00a02355cd1c2f0155cd26cd5909df, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb8305e98a00a02355cd1c2f0155cd26cd5909df, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cbfd06f68a00a02355cd1c2f0155cd26ce1a0af8, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb1f05538a00a02355cd1c2f0155cd26ce1a0af8, userName='null'}

Include Page
Transparency_Profile_Note
Transparency_Profile_Note

This section lists the CLI to configure the following SIP egress IP attributes involved in sending a call in the forward direction to the peer.



Panel

SIP egress IP attributes:

Table of Contents
maxLevel2
minLevel2



Info
iconfalse

Related articles:



BCI

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes bci 
	bciInterworkEncountered <disable | enable> 
	bciIsdnAddess <disable | enable>

Command Parameters

Caption0Table1BCI

Parameters

ParameterDescription

bci

Use this object to configure Backward Call Indicator (BCI) for Egress IP attributes.

  • bciInterworkEncountered – Enable flag to indicate that ISUP is interworking with a network which is not capable of providing as many services as ISUP does. ISUP networks will therefore not employ certain features they otherwise normally would, including potentially the use of ISDN cause codes in failure conditions .
    • disable (default)
    • enable
  • bciIsdnAddess – Enable flag to enable ISDN Address in the BCI parameter of backward SS7 messages (e.g. ACM or ANM).
    • disable (default)
    • enable
 


Domain Name

Use this object to specify use of domain names. 

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes domainName 
	useIpSignalingPeerDomainInRequestUri <disable | enable>
	useSipDomainInPAIHeader <disable | enable>
	useSipDomainNameInFromField <disable | enable> 
		preserveIngressFromDomainName <disable | enable> 
		useLowerCaseDomainNames <disable | enable> 
	useSipDomainNameInRequestUri <disable | enable> 
		preserveIngressRUriDomainName <disable | enable> 
		useLowerCaseDomainNames <disable | enable> 
	useZoneLevelDomainNameInContact <disable | enable>
	useZoneLevelDomainNameInPathHdr <disable | enable>

Command Parameters

Caption0

Table1Domain Name Parameters3Domain Name Parameters

Parameter

Description

useIpSignalingPeerDomainInRequestUri 

Enable this flag to use IP Signaling Peer Domain in Request URI.

  • disable (default)

  • enable

useSipDomainInPAIHeader

Enable this flag to set the value of the host port of the PAI URI equivalent to the value of the SIP domain name configured on the ingress trunk group of the Policy Exchange Server (PSX).

  • disable (default)

  • enable

 useSipDomainNameInFromField

By default, the 

Spacevars
0product
uses its IP address as the host-port of the FROM URI in the outgoing INVITE message. Enable flag to use the originating gateway information returned in the policy response as the host-port of the FROM URI in the outgoing INVITE message.  

  • disable (default)
  • enable

When useSipDomainNameInFromField is enabled, the following flags are available:

  • preserveIngressFromDomainName – If a SIP domain is configured for the ingress trunk group and this flag is enabled, the default gateway associated with that SIP domain will be the originating gateway. Otherwise, the originating gateway will be the default gateway associated with the SIP domain associated with the Softswitch entity.
    • disable (default)

    • enable

  • useLowerCaseDomainNames – Set flag to allow lower case domain name.
    • disable (default)

    • enable

NOTE: The above two flags only apply when a Domain Name is configured for this zone (refer to Zone - CLI).

 useSipDomainNameInRequestUri

Use this flag to indicate how to treat SIP Domain name in outgoing SIP INVITE.

  • disable – The
    Spacevars
    0product
    includes the IP address in the host-port portion of the Request-URI in outgoing SIP INVITE messages.
  • enable – The
    Spacevars
    0product
    includes the trunk group domain associated with egress trunk group as destination domain name in outgoing SIP INVITE messages.

When useSipDomainNameInRequestUri is enabled, the following parameters are available:

  • preserveIngressRUriDomainName – Preserve Ingress R-URI Domain Name Flag. When enabled, the ERE/
    Spacevars
    0product
    uses domain name received in the Request-URI as destination domain name in outgoing SIP INVITE messages. Normally, outgoing SIP INVITE messages contain the trunk group domain assigned to egress trunk group.
    • disable (default)
    • enable
  • useLowerCaseDomainNames – Set flag to allow lower case domain names.
    • disable (default)
    • enable

useZoneLevelDomainNameInContact

Enable this flag to use Zone level domain name in the Contact header.

  • disable (default) 
  • enable
useZoneLevelDomainNameInPathHdr

Enable this flag to send the Domain Name configured at the Zone level in the Path Header of the outgoing REGISTER message.

  • disable (default) 
  • enable


Flags

Use this object to set egress IP attribute flags.

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes flags
	addLoopBackRouteHeader <disable | enable>
	bgcfTargetSchemeTransparency <disable | enable>
	convertInactiveToSendrecv <disable | enable> 
	disable2806Compliance <disable | enable> 
	disableOptionalRegisterParameters <disable | enable>
	ignoreSdpAfterOfferAnswerCompleted <disable | enable>
	includeEnumParameters <disable | enable>
	map3xxContactUrlToRouteHeader <disable | enable>
	map181Or182MessageTo183 <disable | enable> 
	mapContractorNumberInPSigInfoHeader <disable | enable>
	monitorRtpOnEgressUpdate <disable | enable>
    qosBasedRouting <disable | enable> 
	sameCallIdForRequiredAuthorization <disable | enable>
	suppressUnregister <disable | enable>
	transitPAIFromUnregisteredPeer <disable | enable>
	ttcIsupMapping <disable | enable> 
	useCalledPartyInRequestUri <disable | enable> 
	useColonInSdpMediaTypeParameter <disable | enable> 
	validateIsubAddress <disable | enable>

Command Parameters

Caption
0Table
1Flags Parameters
3Flags Parameters
ParameterDescription
addLoopBackRouteHeader

Enable flag to add the SBC URI as the second top-most Route header in the INVITE towards EATF.

  • disable (default)
  • enable
bgcfTargetSchemeTransparency
Enable flag to preserve the scheme used by the SIP INVITE Request-URI when the INVITE is routed by the
Spacevars
0product
, acting as a BGCF supporting Tel-URL. When disabled, the SBC changes the scheme used by the Request-URI parameter to SIP in the egress INVITE message.
  • disable (default)
  • enable
convertInactiveToSendrecv
Enable flag to control the a-line in the SDP of an egress SIP INVITE message by converting a=inactive to a=sendrecv. When disabled, the 
Spacevars
0product
continues to use a=inactive, when appropriate, in the egress INVITE message.
  • disable (default)
  • enable
disable2806Compliance

If enabled, the 2806 Compliance Code is disabled and no phone context or user=phone parameters are signaled in egress messages.

  • disable (default)
  • enable
disableOptionalRegisterParameters
Enable flag to prevent 
Spacevars
0product
from sending the DTG (Destination Trunk Group) parameter in the Contact header of egress REGISTER messages.
  • disable (default)
  • enable
ignoreSdpAfterOfferAnswerCompletedEnable flag to allow the SBC to ignore the new SDP at the egress leg in subsequent 1xx-rel or final 200 OK messages after the Offer Answer for the initial Invite dialog was completed by an earlier 1xx-rel (and does not trigger a new offer or answer).
  • disable (default)
  • enable
includeEnumParametersUse this flag to specify how to handle ENUM parameters in outgoing INVITE.
  • disabled (default) – SBC drops ENUM parameters received from ENUM server.
  • enabled – SBC sends ENUM parameters in the outgoing INVITE
map3xxContactUrlToRouteHeader

When map3xxContactUrlToRouteHeader  flag is enabled,  SBX adds 3XX contact header as second route header in the outgoing INVITE message.

This flag is enabled on a IBCF TG because when a call is routed by ECSCF to IBCF, the 3xx contact URI need to be added as second route header for subsequent routing to IP-PSAP.

  • disable (default)
  • enable
map181Or182MessageTo183
Enable flag to allow 
Spacevars
0product
to map 181 or 182 response messages to 183. When disabled, the SBC handles 1xx response messages normally.
  • disable (default)
  • enable
mapContractorNumberInPSigInfoHeaderEnable flag to map the Contractor Number parameter into the outgoing SIP P-Sig-Info header. The P-Sig-Info header is a customer-specific SIP header used to convey ISUP information in SIP messages.
  • disable (default)
  • enable 
monitorRtpOnEgressUpdate

This flag is used to decide whether to start tone and monitor RTP or not.

  • disable (default)
  • enable
qosBasedRouting

Enable flag to allow QoS-based routing.

  • disable (default)
  • enable
sameCallIdForRequiredAuthorization

Enable this flag to support sending an INVITE with credentials on receiving a 401 (Unauthorized) or 407 (Proxy Authentication Required) response to initial INVITE with the same call ID as in the original INVITE.

  • disable (default)

  • enable

 NOTE: To view and configure this flag, you must first enable both 'authCodeHeaders' transparency flag and 'statusCode4xx6xx' relay flag. Refer to Transparency Flags - CLI and Relay Flags - CLI for additional details.

suppressUnregister

Enable flag to prevent 

Spacevars
0product
from sending an unregister message (Register=0) to the registrar upon expiration of a SIP UA registration. When disabled, the 
Spacevars
0product
generates unregister messages on the egress leg if the UA does not refresh the registration on time.

  • disable (default)
  • enable 

transitPAIFromUnregisteredPeer

Enable flag to transparently pass the received PAI to the INVITE if the default PUI procedure cannot add a PAI header.

  • disable (default)
  • enable 

NOTE: To use this flag, you must enable the enableDefaultPUIProcedures flag and disable the 'privacy transparency' flag (See Privacy section below).

ttcIsupMapping
When enabled, and when the IP protocol type of the IP signaling profile entry is SIP or SIP-I, the application that receives the 
Spacevars
0product
policy response (which can be either the SIP signaling gateway application on the 
Spacevars
0product
or the SIP core proxy on the
Spacevars
0product
) applies the mapping necessary for TTC-ISUP signaling.
  • disable (default)
  • enable 
 useCalledPartyInRequestUri
When enabled, the 
Spacevars
0product
copies the username selected for the "To" header to the Request URI instead of the registered username. When disabled, the 
Spacevars
0product
includes the registered username in the Request URI. This flag is used when interoperating with IP-PBXs that require the real end station number in the Request URI in order to do proper routing of calls terminating on them.
  • disable (default)
  • enable
useColonInSdpMediaTypeParameter

When enabled, a colon (:) is used as the separator between the SDP Media Type parameter key and value. When disabled, an equal sign (=) is used as the separator between the SDP Media Type parameter key and value.

  • disable (default)
  • enable
validateIsubAddress

When enabled, the 

Spacevars
0product
validates ISUB digits for called and calling parties. When isabled, the 
Spacevars
0product
will not validate ISUB digits.

 

ISUB

Use this object to configure ISDN Calling Party Subaddress (ISUB) parameters:

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes isub 
	allowNsapIsub <disable | enable> 
	allowUserSpecifiedIsub <disable | enable> 
	includeCalledPartyIsub <disable | enable> 
	includeCallingPartyIsub <disable | enable>

Command Parameters

Caption0Table1ISUB

Parameters

3ISUB Parameters
ParameterDescription
allowNsapIsubEnable to allow NSAP ISUB parameter.
  • disable (default)
  • enable
allowUserSpecifiedIsubAllow user-specified ISUB.
  • disable (default)
  • enable
includeCalledPartyIsub Include called party ISUB.
  • disable (default)
  • enable
includeCallingPartyIsub

Include calling party ISUB.

  • disable (default)
  • enable

 

Media QOS KPI Profile

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes mediaQosKpiProfile <profile_name>

Command Parameter

caption
Parameter
0
Description
Table

mediaQosKpiProfile

1

The Media

QOS KPI Profile Parameter3Media QOS KPI Profile ParametersParameterDescription

mediaQosKpiProfile

The Media QoS KPI (

QoS KPI (Key Performance Indicator) Profile name.

 

Number Globalization Profile

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes numberGlobalizationProfile <profile_name>

Command Parameters

Caption0Table1Number Globalization Profile Parameter3Number Globalization Profile Parameter

ParameterDescription

numberGlobalizationProfile

The Number Globalize Profile name. This profile converts numbers to SIP global number format.

 

Number Portability Attributes

Number portability attributes configuration.

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes numberPortabilityAttributes 
	disableRn <disable | enable> 
	npdiOptions <doNotIncludeNpdi | includeNpdi | includeNpdiYes>

Command Parameters

caption

0Table
1Number Portability Attributes Parameters
3Number Portability Attributes Parameters
ParameterDescription
disableRn

Enable flag to prevent the 

Spacevars
0product
and ERE SIP proxy/redirector from sending the SIP rn parameter in the egress INVITE message when an LNP translated number is present. When the flag is disabled, the 
Spacevars
0product
and ERE SIP proxy/redirector send "rn=NNNN" in the userinfo portion of the Request URI, where "NNNN" is the LNP translated number.

  • disable (default)
  • enable
npdiOptions

Use the following options to specify whether the 

Spacevars
0product
and ERE SIP proxy/redirector send the SIP NPDI parameter in the egress INVITE message when LNP translation is performed by ERE call processing or the preceding switch.

  • doNotIncludeNpdi – Do not send the NPDI parameter.
  • includeNpdi – Send "npdi" in the userinfo portion of the Request URI.
  • includeNpdiYes – (default) Send "npdi=yes" in the userinfo portion of the Request URI.

 

P-Charge Info

Use this parameter to configure egress P-Charge-Info header in INVITE message behavior.

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes pChargeInfo
	includeNOA <disable | enable>
	includeNPI <disable | enable>
	pChargeInfoTransparency <disable | enable>
	pChargeInfoType <headerParameter | uriParameter | userParameter>

Command Parameters

Caption0Table1P-Charge Info Parameters3P-Charge Info

Parameters

ParameterDescription
includeNOA

Enable flag to include Nature of Address Indicator in egress P-Charge-Info header in INVITE message.

  • disable (default)
  • enable
includeNPIEnable flag to include Number Plan Indicator in egress P-Charge-Info header in INVITE message.
  • disable
  • enable (default)
pChargeInfoTransparency

Enable flag to transparently pass egress P-Charge-Info header in INVITE message.

  • disable (default)
  • enable
pChargeInfoType

The format types for which NPI/NOA are encoded in P-Charge-Info header. Options include:

  • headerParameter – NPI and NOA are sent in header parameter format. For example, P-Charge-Info: <sip:123456@10.54.69.140>;npi=ISDN;noa=3
  • uriParameter (default) – NPI and NOA are sent in uri parameter format. For example, P-Charge-Info: sip:123456@10.54.69.144;npi=ISDN;noa=3
  • userParameter – NPI and NOA are sent in user info parameter format. For example, P-Charge-Info: <sip:12345;npi=ISDN;noa=3@10.54.69.144>

 

Phone Context Parameter Length

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes phoneContextParameterLength (0-31)

Command Parameter

Caption0Table1Phone Context Parameter Length Parameters3Phone Context
Parameter
Length Parameters
Parameter
Length/RangeDescription
phoneContextParameterLength0-31

Use this attribute to specify the length of phone-context parameter sent in RURI and To headers of the egress message (default = 0).

When a value greater than "0" is configured, and the called number is globalized using the existing globalization profile, the PSX sends the configured value in a policy response to the

Spacevars
0product
. The
Spacevars
0product
uses this configured value to insert phone-context parameter of received length in RURI and To headers.

  AnchorPrivacy


Privacy

Privacy

Use this object to specify Privacy parameters.

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes privacy
	anonymizeHostIpPortion <disable | enable>
	flags 
		includeEmbeddedPAIheaderInRedirectedInvite <disable | enable> 
		includePrivacy <disable | enable> 
		msLyncPrivacySupport <disable | enable> 
		privacyRequiredByProxy <disable | enable> 
	privacyInformation 
			<pAssertedId | pPreferredId | remotePartyId> 
	transparency <disable | enable>

Command Parameters

Caption
0Table
1Privacy Parameters
3Privacy Parameters


ParameterDescription

anonymizeHostIpPortion

When the flag is set to enable, the

Spacevars
0product
anonymizes the incoming host IP portion of the private headers (P-AID, P-PID, RPID) by replacing it with the IP address of the
Spacevars
0product
before sending it to the egress leg of a call.

  • disable (default)
  • enable

Note: This flag is available for configuration only when the transparency flag (below) is enabled. For more information on Privacy Transparency of Egress IP Attributes, see Privacy section.

This feature supports in-dialog messages only, plus the following message types:

  • INVITE
  • BYE
  • OPTIONS
  • SUBSCRIBE
  • NOTIFY
  • UPDATE
  • PUBLISH
  • MESSAGE
flags

Privacy flags:

  • includeEmbeddedPaiHeaderInRedirectedInvite – Enable this flag to include the embedded PAI header in the redirected Invite message.
    • disable (default)
    • enable
  • includePrivacy – Use this flag to specify whether the SBC includes privacy information in outgoing SIP INVITE messages.
    • disable – The 
      Spacevars
      0product
      does not include a P-Preferred-Identity header or a P-Asserted-Identity header, an Anonymous identifier in the SIP From field, or a Privacy header that contains a Critical token in outgoing SIP INVITE messages, and the 
      Spacevars
      0product
      will not include a P-Asserted-Identity header or a Privacy header that contains a Critical token in outgoing SIP INVITE messages.
    • enable (default) – The 
      Spacevars
      0product
      includes either a P-Preferred- Identity header or a P-Asserted-Identity header (provisioned in Privacy Information above) in outgoing SIP INVITE messages. The 
      Spacevars
      0product
      will include a P-Asserted-Identity header in outgoing SIP INVITE messages. The 
      Spacevars
      0product
      will also insert an Anonymous identifier in the SIP From field and the 
      Spacevars
      0product
      will include a Privacy header that contains a Critical token.
  • msLyncPrivacySupport – Backward compatibility for the Caller Privacy feature. The Caller privacy feature only works if this flag is enabled.
    • disable (default)
    • enable
  • privacyRequiredByProxy – Enable flag to indicate that privacy service is mandated for any calls to the SIP trunk (proxy). In this case, the 
    Spacevars
    0product
    includes a Proxy-Require header with a privacy value, and a critical token in the Privacy header of the INVITE message. The privacy service must be applied by the proxy or the call is rejected. If disabled, the 
    Spacevars
    0product
    does not include a Proxy-Require header with privacy value. The proxy accepts the call even if it cannot provide privacy service.
    • disable (default)
    • enable
privacyInformation

Use this object to specify which of the following headers the 

Spacevars
0product
uses when sending privacy information in outgoing SIP INVITE messages:

  • pAssertedId – Used among trusted SIP entities (typically intermediaries) to carry the identity of the caller as it was verified by authentication.
  • pPreferredId – Used by a User Agent (UA) to carry the identity the caller wishes to be used, and sent to a trusted proxy to be inserted in the P-Asserted-Identity field.
  • remotePartyId – Used among trusted SIP entities (typically intermediaries) to carry the identity of the caller as it was verified by authentication. This header is specified in an earlier RFC that continues to be supported.
transparency

 Enable flag to allow ingress Privacy information to pass through unchanged.

  • disable (default)
  • enable


 


Redirect

Use this object to configure Redirect parameters.

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes redirect 
	contactHandling <mergeReceivedContacts | purgeExistingContacts> 
	flags 
		forceRequeryForRedirection <disable | enable>
		honorEmbeddedHeadersin3xx <disable | enable>
		relayUnusedContactParams <disable | enable>
		skipCrankbackProfileAndAlwaysCrankback <disable | enable> 
	mode <acceptRedirection | allowSingleRedirectAttempt | rejectRedirection | stopHunt>

Command Parameters

Caption0

Table1Redirect Parameters3Redirect Parameters
ParameterDescription
contactHandlingSelect one of the following to control processing of contacts received in SIP Redirects:
  • mergeReceivedContacts – Contacts received in Redirects are ordered by q-value and inserted at the head of the list of untried contacts.
  • purgeExistingContacts – Contacts received in Redirects are ordered by q-value and replace untried contacts.
flags

Redirect flags:

  • forceRequeryForRedirection – (applies to Invite requests only) Use flag to re-query ERE with contact information received in a 3xx response for redirection-type scenarios.
    • disable (default)
    • enable
  • honorEmbeddedHeadersin3xx –Enable flag to allow the processing of embedded headers in 3xx Contact headers for the trunk group that received the 3xx.
    • disable (default)
    • enable
  • relayUnusedContactParams – When enabled, Contact parameters received in 3xx responses that are not consumed/processed locally by the SBC (see NOTE below) can now be passed through to the R-URI of subsequent INVITE request.
    • disable (default)
    • enable 
  • skipCrankbackProfileAndAlwaysCrankback – Enable this flag to force any 4xx–6xx SIP response code to cause crankback so the next potential contact or 3xx response is tried. If disabled, only the response codes specified in default SBC crankback profile cause the call to crank back.
    • disable (default)
    • enable

mode

Use this object to control SIP redirection:

  • acceptRedirection (default)– Multiple redirections are allowed.
  • allowSingleRedirectAttempt – Only a single Redirect is allowed per route. Additional Redirects cause crankback to be performed.
  • rejectRedirection – If a Redirect is received, crank back is performed.
  • stopHunt – Prevent call attempts on subsequent trunk groups if 3xx is received following an Invite and the SBC fails to establish the call with all the contacts from 3xx.
Info
titleNote

You must use stopHunt in conjunction with the egress IP Signaling Profile control forceRequeryForRedirection.

Available_since
TypeAvailable Since
Release10.1.4


Info
titleNote

Parameters consumed/processed locally by the

Spacevars
0product
and excluded from relayUnusedContactParams command include:

  •  dtg
  •  tgrp
  •  trunk-context
  •  cic
  •  npdi
  •  npi
  •  rn
  •  bgid
  •  bgt
  •  user
  •  phone-context


Signaling QOS KPI Profile

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes signalingQosKpiProfile <profile_name>

Command Parameter

Caption0Table1Signaling QOS KPI Profile Parameters3Signaling QOS KPI Profile 
 <profile_name>

Command Parameter

Parameter

Description

signalingQosKpiProfile <profile name>

The Signaling QoS KPI (Key Performance Indicator) Profile name.

 

SIP Cause Mapping

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <IPSP name> egressIpAttributes sipCauseMapping 
	sipToInternalCauseMappingProfileName <sipToInternalProfile_Name>
	internalToSipCauseMappingProfileName <internalToSIPProfile_Name>

Command Parameters

Caption
0Table
1SIP Cause Mapping Parameters
3SIP Cause Mapping Parameters Parameters

Parameter

Description

sipCauseMapping

Use this object in a SBC ERE configuration to create Internal-to-SIP and SIP-to-Internal SIP Cause Mapping Profile names for this IP Signaling Profile.

  • internalToSipCauseMappingProfileName– The name of the Internal-to-SIP cause mapping profile.
  • sipToInternalCauseMappingProfileName – The name of the SIP-to-Internal cause mapping profile.
 


Info

To create a profile to map CPC and SIP, refer to CPC to SIP Cause Map Profile - CLI and SIP CPC Cause Code Mapping Profiles - CLI.

To associated these profiles with Ingress/Egress trunk groups, refer to SIP Trunk Group - Signaling - CLI.

For configuration examples and external PSX considerations, refer to Configuring SIP Cause Code Mapping.


SIP Headers and Parameters

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes sipHeadersAndParameters 
	callForwarding 
		dataMapping <diversion | none | pkHeader> 
		diversionHeaderTransparency <disable | enable> 
		diversionHistoryInfoInterworking <disable | enable>
		historyInformation 
			includeHistoryInformation <disable | enable>
				causeParameterInRFC4458 <disable | enable> 
				reasonWithCauseValueAsPerRFC4244 <disable | enable>
 	destinationTrunkGroupOptions <includeDtg | includeNone | includeTgrpWithDomainName | includeTgrpWithIpAddress>
	flags 
		endToEndAck <disable | enable>
		includeCic <disable | enable> 
		includeCpcInformation <disable | enable> 
		includeNpi <disable | enable> 
		includeOlip <disable | enable> 
		includePKAdn <disable | enable> 
		includePstnParameters <disable | enable> 
		includeQvalue <disable | enable> 	
		skipCSeqCheckInEarlyDialog <disable | enable> 
		transparencyForDestinationTrunkGroupParameter <disable | enable>
	generateCallIdUsing <doNotUseIngressCallId | useIngressCallIdByAddingStaticString | useIngressCallIdByPrepending>
	includeChargeInformation <includeNone | includePChargeInfo> 
	originatingTrunkGroupOptions <includeNone | includeOtg | includeTgrpWithDomainName | includeTgrpWithIpAddress>
   	sessionExpiresRefresher <notSend | uac | uas>
    sipToHeaderMapping <calledNumber | gapDialedNumber | none | originalCalledNumberOcn>

Command Parameters

Div
classpdf6pttext
Caption
0Table
1sipHeadersAndParameters Parameters
3sipHeadersAndParameters

Parameter

Description

callForwarding

This parameter is used to control the call forwarding data mapping method in egress SIP signaling.

  • dataMapping – Use this parameter to define how to map the diversion or redirecting data. Options are:
    • none – No Diversion information is egressed.
    • diversion – Diversion information is sent out as SIP Diversion Header.
    • pkHeaders – Diversion information is sent out as proprietary PK Headers.
  • diversionHeaderTransparency – When enabled, the ingress Diversion header is passed through unchanged. Call forwarding data mapping transparency applies to Diversion header only
    • disable (default)
    • enable
  • diversionHistoryInfoInterworking – Enable flag to allow interworking between Diversion and History-Info header as per RFC 6044. The 
    Spacevars
    0product
    supports up to 12 History-Info entries and 10 Diversion entries. When this flag is disabled, only the first and last entries are maintained when History-Info or diversion transparency is disabled.
    • disable (default)
    • enable
      NOTE: This flag is only visible when either Diversion or History-Info header is selected as the egress call forwarding header. Diversion and History-Info Transparency configuration
controls are
    • controls are ignored when it is enabled. This parameter has precedence over the others, as well as the TG Signaling flag acceptHistoryInfo.
  • historyInformation includeHistoryInformation – Use this parameter to specify how to treat call forwarding history information. Enable this flag to include History-Info in INVITE egress message.
    • disable (default)
    • enable
    • causeParameterInRFC4458 – Enable this flag to include the History-Info cause value in egress message as per RFC 4458 recommendation. When the flag is enabled, the output is similar to the following example:
      History-Info: <sip:1234567890@P1.interwork.com?Privacy=none>;index=1, <sip: last_diverting_target;cause=408>;index=1.1
      • disable (default)
      • enable
    • reasonWithCauseValueAsPerRFC4244 – Enable this flag to include History-Info cause value with Reason Header as per RFC 4244 recommendation. When the flag is enabled, the output is similar to the following example:
      History-Info: <sip:1234567890@P1.interwork.com?Privacy=none>;index=1, <sip: last_diverting_target?Reason=SIP%3Bcause%3D408>;index=1.1
      • disable (default)
      • enable
destinationTrunkGroupOptions

Use this parameter to specify destination trunk group options.

  • includeDtg – Include the destination trunk group parameter in SIP headers sent over associated trunk group.
  • includeNone (default) – Do not include any trunk group information.
  • includeTgrpWithDomainName – Include trunk group with domain name.
  • includeTgrpWithIpAddress – Include the destination trunk group, and include the trunk context as domain name.
flags

Use this object to configure the SIP Headers and Parameters flags.

  • endToEndAck – Enable flag to send the ACK towards egress for the initial invite after receiving it from the ingress (remote) entity. The application retransmits the 200 OK towards the ingress side based on the configuration, and terminates the call if no ACK is received for the corresponding 200 OK.
    • disable (default)
    • enable
  • includeCic – If enabled, the 
    Spacevars
    0product
    includes the Carrier Identification Code in a cic= parameter in outgoing INVITE messages.
    • disable (default)
    • enabl
  • includeCpcInformation – If enabled, the 
    Spacevars
    0product
    includes the Calling Party Category (CPC) parameter value in the From header of outgoing SIP INVITE messages.The CPC parameter characterizes the station used to originate a call, such as ordinary, priority, data, test, operator, pay phone, prison, hotel or unknown.
    • disable (default)
    • enable
  • includeNpi – If enabled, the 
    Spacevars
    0product
    includes the Numbering Plan Indicator in a npi= parameter in outgoing INVITE messages.
    • disable (default)
    • enable
  • includeOlip – If enabled, the 
    Spacevars
    0product
    includes the Originating Line Information Parameter in a oli= parameter in outgoing INVITE messages.
    • disable (default)
    • enable
  • includePKAdn – When enabled, the 
    Spacevars
    0product
    includes the P-K-Adn header in egress SIP messages. When disabled, the 
    Spacevars
    0product
    does not include the P-K-Adn header. The P-K-Adn header is a customer-specific SIP header used for ISUP-to-SIP interworking and contains the Translation Source Number (TSN) used in Number to SIP URL translation via the Number Username Translation screen (Generic variant only).
    • disable (default)
    • enable
  • includePstnParameters – If enabled, the 
    Spacevars
    0product
    includes a set of specific PSTN parameters in a pstn-params= entry in outgoing INVITE messages. The PSTN parameters currently included in pstn-params are Screening Indicator, ISDN Indicator, and Transmission Medium Requirement (TMR).
    • disable (default)
    • enable
  • includeQvalue – If enabled, the ERE SIP proxy/redirector includes the qvalue parameter (for example, q=0.9) in the Contact header of outgoing 3xx messages.
    • disable (default)
    • enable
  • skipCSeqCheckInEarlyDialog – When enabled, the 
    Spacevars
    0product
    accepts multiple SIP requests in which the CSeq number in a later request is of a lesser value than the CSeq number received in earlier requests.
    • disable (default)
    • enable
  • transparencyForDestinationTrunkGroupParameter – When enabled, if ERE receives both tgrp parameter and trunk-context in an ingress INVITE Request-URI, ERE as proxy transparently passes the tgrp parameter and trunk-context in the egress INVITE Request-URI. Values selected for the "Destination Trunk Group Option" are ignored.
    • disable (default)
    • enable
generateCallIdUsing

Use this parameter to control ingress and egress Call-ID behavior.

  • doNotUseIngressCallId – Generates egress Call-ID independent of ingress Call-ID.
  • useIngressCallIdByAddingStaticString – Generates egress Call-ID using ingress Call-ID and a static string (egressCallIdStaticString) configured in the SIP trunk group.
    Egress Call-ID is the aggregate of ingress Call-ID and static string.
  • useIngressCallIdByPrepending – Generates egress Call-ID using ingress Call-ID and locally generated string. Egress Call-ID is the aggregate of ingress Call-ID and locally generated string.
includeChargeInformation

Select the includePChargeInfo option to map charge information in a call setup message (i.e., the charge number parameter of an IAM) to egress P-Charge-Info header in INVITE message. If the ERE returns billing information in a policy response, the 

Spacevars
0product
ensures that the egress P-Charge-Info header in INVITE message is populated with the indicated data. If the 
Spacevars
0product
receives a SIP INVITE message for a call destined to the PSTN, the 
Spacevars
0product
populates the charge number parameter of the outgoing IAM based on the egress P-Charge-Info header in INVITE message.

  • includeNone (default)
  • includePChargeInfo
originatingTrunkGroupOptions

Use this parameter to specify originating trunk group options.

  • includeNone (default) – Do not include any trunk group information.
  • includeOtg – Include the originating trunk group parameter in SIP headers sent over the associated trunk group.
  • includeTgrpWithDomainName – Include the originating trunk group, and include the trunk context as domain name.
  • includeTgrpWithIpAddress – Include the originating trunk group, and include the trunk context as IP address
sessionExpiresRefresher

Controls whether the refresher parameter is sent in the Session-Expires header and is enabled when the Customized Session Timer Behavior flag is selected. Options include:

  • notSend (default) – The Session-Expires refresher parameter is not sent in the initial outgoing INVITE message, re-INVITE message, and UPDATE message.
  • Uac – When selected, the parameter refresher uac (User-Agent Client) is sent in the Session-Expires header.
  • Uas – When selected, the parameter refresher uas (User-Agent Server) is sent in the Session-Expires header.

sipToHeaderMapping

This parameter indicates which number is mapped and returned in the outgoing SIP To header. Options include:

  • calledNumber – The TO header is mapped using the called number.
  • gapDialedNumber – The TO header is mapped using the Generic Address Parameter from mime, if applicable.
  • none (default) – The TO header user part is mapped from the Original Called Number, if present. Otherwise, it is mapped from the Called Number. The Original Called Number may be taken from the Diversion or the History-Info header, if present, in a SIP Invite.
  • originalCalledNumberOcn – The TO header is mapped using the redirecting original Called number OCN parameter. This is filled from the SIP Invite using the Diversion or the History-Info header, if present.

Transport

Include Page
_Controlling transport protocols for SIP
_Controlling transport protocols for SIP

Command Syntax

Code Block
languagenone
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes transport type1...type4 
	none
	sctp
	tcp
	tlsOverTcp
	udp

Command Parameters

Caption
0Table
1Transport Parameters

Parameter

Length/Range

Description

transport

N/A

Use this object to set up to four transport parameter types:

  • type1
  • type2
  • type3 
  • type4

Each transport type above can be set to any one of the following transport protocols:

  • none (default)
  • sctp
  • tcp
  • tlsOverTcp
  • udp


 pagebreak