Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Add_workflow_for_techpubs
AUTH1
REV5
REV6
REV3
REV4
REV1
REV2
Noprint
Panel
borderColorgreen
bgColortransparent
borderWidth2

Back to Table of Contents

Back to CLI Configure Mode

Back to Profiles - CLI

Back to Services - CLI

Panel

In this section:

Table of Contents
maxLevel4

Info
iconfalse

 Related articles:

 

Include Page
Transparency_Profile_Note
Transparency_Profile_Note

Excerpt Include
Transparency Profile
Transparency Profile
nopaneltrue

Note
iconfalse
titleNote

Headers may be configured in compact form and transparently passed using a Transparency Profile. It is advisable to configure both compact and long formats to ensure both types of received headers in the PDU are transparently passed.

 

...

Command Syntax

The CLI syntax to configure a Transparency Profile is shown below:

Code Block
languagenone
% set profiles services transparencyProfile <tpName>
	sipHeader <name of SIP header, or 'all'>
		excludedMethods <bye | info | invite | message | notify | options | publish | refer | register | subscribe | update>
		ignoreTransparency <no | yes> 
	sipMessageBody <content-type, or 'all'>
		excludedMethods <bye | info | invite | message | notify | options | publish | refer | register | subscribe | update>
		ignoreTransparency <no | yes>
	state <disabled | enabled>

 

The CLI syntax to assign the Transparency Profile to an egress Trunk Group is shown below:

Code Block
languagenone
% set addressContext <addressContextName> zone <zoneName> sipTrunkGroup <trunkGroupsName> services transparencyProfile <tpName>

Command Parameters

Caption
0Table
1Transparency Profile Parameters
 
ParameterLength/RangeDescription
transparencyProfile1-23 characters

<Transparency Profile name> – This profile contains a list of SIP headers and/or SIP message bodies to pass transparently. Enter a name for the profile

sipHeader1-31 characters

<SIP header name, or 'all'> – Enter the name of SIP header to transparently pass, or enter 'all' to transparently pass all SIP headers.

  • excludedMethods – Enter method(s) to exclude from this Transparency Profile configuration.
    <bye | info | invite | message | notify | options | publish | refer | register | subscribe | update>
  • ignoreTransparency – Set to 'yes' to ignore transparency for this Transparency Profile configuration.
    • no (default)
    • yes
Note
iconfalse
titleNote

If a specific header is configured, ignoreTransparency and excludedMethods are exclusive. Once ignoreTransparency is configured, excludedMethods no longer displays. Likewise, once excludedMethods is configured, ignoreTransparency no longer displays.

Note
iconfalse
titleNote

The ignoreTransparency flag applies in the following scenarios:

  • when combined with a configuration to allow all SIP headers
    -or-
  • when one of the SIP header transparency flags is enabled in the IP Signaling Profile
sipMessageBody 1-127 characters

<content-type, or 'all'> – Enter the name of the content-type to transparently pass, or enter 'all' to transparently pass all SIP message body types. The value used for content-type must match the actual content type received in the SIP request or response (e.g. application/dialog-info+xml).

  • excludedMethods – Enter method(s) to exclude from this Transparency Profile configuration.
    <bye | info | invite | message | notify | options | publish | refer | register | subscribe | update>
  • ignoreTransparency – Set to 'yes' to not pass through the specified content-type defined within the Transparency Profile configuration.
    • no (default)
    • yes

 

Note
iconfalse
titleNote

The ignoreTransparency flag applies in the following scenarios:

  • when combined with a configuration to allow all types of content
    -or-
  • when one of the SIP message body transparency flags is enabled in the IP Signaling Profile


stateN/A

Enable this flag to use this Transparency Profile.

  • disabled (default)
  • enabled

Command Examples

Info
titleInfo

To see a step-by-step configuration example, see Configuring a Transparency Profile.

To configure transparency of all headers for a Transparency Profile and view the results:

Code Block
languagenone
% set profiles services transparencyProfile TP_E sipHeader all
% commit

% show profiles services transparencyProfile TP_E
state enabled;
sipHeader all;

To exclude select methods from a SIP header:

Code Block
languagenone
% set profiles services transparencyProfile TP_F sipHeader SH1 excludedMethods invite,info,register

 

To exclude transparency for a specific SIP header:

Code Block
languagenone
% set profiles services transparencyProfile TP_G sipHeader SH1 ignoreTransparency yes

 

To assign transparency profile to a trunk group:

Code Block
languagenone
% set addressContext ADDR_CONTEXT_1 zone ZONE_AS sipTrunkGroup TG_ASX_MERCURY services transparencyProfile TP_E

 

To allow a specific type of content through:

Code Block
languagenone
% set profiles services transparencyProfile testProfile sipMessageBody application/foo

 

To allow all types of content through in all SIP messages except certain select SIP methods:

Code Block
languagenone
% set profiles services transparencyProfile testProfile sipMessageBody all excludedMethods info,invite

Pagebreak