Conditional Header Manipulation of SIP Headers

Last Updated: December 20, 2011

The Conditional Header Manipulation of SIP Headers feature provides the following enhancements to Cisco Unified Border Element (Cisco UBE):

  • The ability to pass unsupported parameters present in a mandatory Session Initiation Protocol (SIP) header from one call leg to another of Cisco UBE.
  • The ability to copy contents from one header to another in an outgoing SIP message.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Prerequisites for Conditional Header Manipulation of SIP Headers

Cisco Unified Border Element

  • Cisco IOS Release 15.1(3)T or a later release must be installed and running on your Cisco Unified Border Element.

Cisco Unified Border Element (Enterprise)

  • Cisco IOS XE Release <TBD> or a later release must be installed and running on your Cisco ASR 1000 Series Router.

Restrictions

  • You cannot configure more than 99 variables for the SIP profiles copy option.
  • This feature does not support any header other than SIP.

Passing an Unsupported Parameter Present in a Mandatory Header from One Call Leg to Another of Cisco UBE

Perform this task to pass an unsupported parameter present in a mandatory header from one call leg to another of Cisco UBE.

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    voice class sip-copylist tag

4.    sip-header {sip-req-uri | header-name}

5.    exit


DETAILED STEPS
  Command or Action Purpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
configure terminal


Example:

Router# configure terminal

 

Enters global configuration mode.

 
Step 3
voice class sip-copylist tag


Example:

Router(config)# voice class sip-copylist 100

 

Configures a list of entities to be sent to a peer call leg and enters voice class configuration mode.

 
Step 4
sip-header {sip-req-uri | header-name}


Example:

Router(config-class)# sip-header From

 

Specifies the SIP header to be sent to the peer call leg.

 
Step 5
exit


Example:

Router(config-class)# exit

 

Exits voice class configuration mode.

 

Copying Contents from One Header to Another in an Outgoing SIP Message

Copying Contents from One SIP Header to Another in an Outgoing Message

Perform this task to copy contents from one SIP to another in an outgoing message.

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    voice class sip-profiles tag

4.    request method sip-header field {add | copy | modify | remove} string

5.    response option sip-header field {add | copy | modify | remove} string

6.    exit


DETAILED STEPS
  Command or Action Purpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
configure terminal


Example:

Router# configure terminal

 

Enters global configuration mode.

 
Step 3
voice class sip-profiles tag


Example:

Router(config)# voice class sip-profiles 10

 

Enables dial peer-based VoIP SIP profile configurations and enters voice class configuration mode.

 
Step 4
request method sip-header field {add | copy | modify | remove} string


Example:

Router(config-class)# request INVITE sip-header contact copy "(.*)" u01

 

Modifies SIP profiles to copy the contents from one SIP header to another in a SIP request message.

 
Step 5
response option sip-header field {add | copy | modify | remove} string


Example:

Router(config-class)# response 200 sip-header contact copy "(.*)" u01

 

Modifies SIP profiles to copy contents from one SIP header to another in a SIP response message.

 
Step 6
exit


Example:

Router(config-class)# exit

 

Exits voice class configuration mode.

 

Copying Contents from Peer Header to a SIP Header in an Outgoing Message

Perform this task to copy contents from peer header to a SIP header in an outgoing message.

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    voice class sip-profiles tag

4.    request method peer-header sip {sip-req-uri | header-name} copy match-pattern variable

5.    response option peer-header sip {sip-req-uri | header-name} copy match-pattern variable

6.    exit


DETAILED STEPS
  Command or Action Purpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
configure terminal


Example:

Router# configure terminal

 

Enters global configuration mode.

 
Step 3
voice class sip-profiles tag


Example:

Router(config)# voice class sip-profiles 10

 

Enables dial peer-based VoIP SIP profile configurations and enters class configuration mode.

 
Step 4
request method peer-header sip {sip-req-uri | header-name} copy match-pattern variable


Example:

Router(config-class)# request invite peer-header contact copy "(.*)" u01

 

Copies contents from a peer header to a SIP header in an outgoing SIP request message.

 
Step 5
response option peer-header sip {sip-req-uri | header-name} copy match-pattern variable


Example:

Router(config-class)# response 200 peer-header contact copy "(.*)" u01

 

Copies contents from a peer header to a SIP header in an outgoing SIP response message.

 
Step 6
exit


Example:

Router(config-class)# exit

 

Exits voice class configuration mode.

 

Feature Information for Support for Conditional Header Manipulation of SIP Headers

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

The table below lists the release history for the ISR.

Table 1 Feature Information for Support for Conditional Header Manipulation of SIP Headers

Feature Name

Releases

Feature Information

Support for Conditional Header Manipulation of SIP Headers

15.1(3)T

The Support for Conditional Header Manipulation of SIP Headers feature provides the following enhancements to Cisco UBE:

  • The ability to pass unsupported parameters present in a mandatory header from one call leg to another.
  • The ability to copy contents from one header to another header in an outgoing SIP message.

The following commands were introduced or modified: response, response peer-header, request, request peer-header, sip-header, voice-class sip copy-list, voice class sip-copylist.

The table below lists the release history for the ASR.

Table 2 Feature Information for Support for Conditional Header Manipulation of SIP Headers

Feature Name

Releases

Feature Information

Support for Conditional Header Manipulation of SIP Headers

<TBD>

The Support for Conditional Header Manipulation of SIP Headers feature provides the following enhancements to Cisco UBE:

  • The ability to pass unsupported parameters present in a mandatory header from one call leg to another.
  • The ability to copy contents from one header to another header in an outgoing SIP message.

The following commands were introduced or modified: response, response peer-header, request, request peer-header, sip-header, voice-class sip copy-list, voice class sip-copylist.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2011 Cisco Systems, Inc. All rights reserved.