Cisco Unified Border Element (Enterprise) SIP Support Configuration Guide, Cisco IOS XE Release 3S
Conditional Header Manipulation of SIP Headers
Downloads: This chapterpdf (PDF - 1.25MB) The complete bookPDF (PDF - 4.13MB) | The complete bookePub (ePub - 690.0KB) | Feedback

Conditional Header Manipulation of SIP Headers

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.

With CSCty41575, the Conditional Header Manipulation of SIP Headers feature provides the following enhancements to Cisco UBE:

  • SIP copy-profile functionality for dial-peer rotary calls.
  • Enhanced SIP profile feature support for forked SIP leg to copy data from the initial INVITE received for a normal SIP-SIP call.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and 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 module.

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 3.6S or a later release must be installed and running on your Cisco ASR 1000 Series Router.

Restrictions for Conditional Header Manipulation of SIP Headers

  • 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:
    Device> enable
     

    Enables privileged EXEC mode.

    • Enter your password if prompted.
     
    Step 2 configure terminal


    Example:
    Device# configure terminal
     

    Enters global configuration mode.

     
    Step 3 voice class sip-copylist tag


    Example:
    Device(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:
    Device(config-class)# sip-header From
     

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

     
    Step 5 exit


    Example:
    Device(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:
      Device> enable
       

      Enables privileged EXEC mode.

      • Enter your password if prompted.
       
      Step 2 configure terminal


      Example:
      Device# configure terminal
       

      Enters global configuration mode.

       
      Step 3 voice class sip-profiles tag


      Example:
      Device(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:
      Device(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:
      Device(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:
      Device(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:
        Device> enable
         

        Enables privileged EXEC mode.

        • Enter your password if prompted.
         
        Step 2 configure terminal


        Example:
        Device# configure terminal
         

        Enters global configuration mode.

         
        Step 3 voice class sip-profiles tag


        Example:
        Device(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:
        Device(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:
        Device(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:
        Device(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.

        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.

        In Cisco IOS Release 15.1(3)T, this feature was implemented on the Cisco Unified Border Element.

        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.

        Support for Conditional Header Manipulation of SIP Headers

        Cisco IOS XE Release 3.6S

        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.

        In Cisco IOS XE Release 3.6S, this feature was implemented on the Cisco Unified Border Element (Enterprise).

        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.