SIP Parameter Modification

The SIP Parameter modificationfeature allow customers to add, remove, or modify the SIP parameters in the SIP messages going out of a border element. The SIP message is generated from the standard signaling stack, but runs the message through a parser which can add, delete or modify specific parameters. This allows interoperability with additional third party devices that require specific SIP message formats. All SIP methods and responses are supported, profiles can be added either in dial-peer level or global level. Basic Regular Expression support would be provided for modification of header values. SDP parameters can also be added, removed or modified.

This feature is applicable only for outgoing SIP messages. Changes to the messages are applied just before they are sent out, and the SIP SPI code does not remember the changes. Because there are no restrictions on the changes that can be applied, users must be careful when configuring this feature - for example, the call might fail if a regular expression to change the To tag value is configured.

The all keyword is used to apply rules on all requests and responses.

Before You Begin

Cisco Unified Border Element

  • Cisco IOS Release 12.4(15)XZ or a later release must be installed and running on your Cisco Unified Border Element.

Cisco Unified Border Element (Enterprise)

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

Note


  • This feature applies to outgoing SIP messages.
  • This feature is disabled by default.
  • Removal of mandatory headers is not supported.
  • This feature allows removal of entire MIME bodies from SIP messages. Addition of MIME bodies is not supported.
>

SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    voice service number voip

    4.    voice-class sip-profiles group-number

    5.    response option sip-header option ADD word CR

    6.    exit

    7.    end


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 service number voip


    Example:
    Router(config)# voice service 1 voip
     

    Enters VoIP voice-service configuration mode.

     
    Step 4 voice-class sip-profiles group-number


    Example:
    Router(config)# voice-class sip profiles 42
     

    Establishes individual sip profiles defined by a group-number. Valid group-numbers are from 1 to 1000.

     
    Step 5 response option sip-header option ADD word CR


    Example:
    Router(config)# request INVITE sip-header supported remove
     

    Add, change, or delete any SIP or SDP header in voice class or sip-profile submode.

     
    Step 6 exit


    Example:
    Router(config-dial-peer)# exit
     

    Exits the current mode.

     
    Step 7 end


    Example:
    Router(config-voi-srv)# end
     

    Returns to privileged EXEC mode.

     

    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.

    Example

    !
    !
    !
    voice service voip
    allow-connections sip to sip
    redirect ip2ip
    sip
    early-offer forced
    midcall-signaling passthru
    sip-profiles 1
    !
    !
    !
    voice class sip-profiles 1
    request INVITE sip-header Supported remove
    request INVITE sip-header Min-SE remove
    request INVITE sip-header Session-Expires remove
    request INVITE sip-header Unsupported modify "Unsupported:" "timer"
    !
    !
    !

    Feature Information for Configuring SIP Parameter Modification

    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.

    Feature History Table entry for the Cisco Unified Border Element.

    Table 1 Feature Information for Configuring SIP Parameter Modification

    Feature Name

    Releases

    Feature Information

    SIP Parameter Modification

    12.4(15)XZ 12.4(20)T

    Allows users to change the standard SIP messages sent from the Cisco SIP stack for better interworking with different SIP entities.

    This feature introduces or modifies the following commands: voice class sip-profiles, voice-class sip profiles

    Feature History Table entry for the Cisco Unified Border Element (Enterprise) .

    Table 2 Feature Information for Configuring SIP Parameter Modification

    Feature Name

    Releases

    Feature Information

    SIP Parameter Modification

    Cisco IOS XE Release 2.5

    Allows users to change the standard SIP messages sent from the Cisco SIP stack for better interworking with different SIP entities.

    This feature introduces or modifies the following commands: voice class sip-profiles, voice-class sip profiles