Contents

List of Figures

List of Tables

Title and Copyright Information

About This Guide

1 Header Manipulation Rules

• HMR Fundamentals
  • Audience
  • When to Use HMR
  • Managing HMR Impact on Performance
  • Applying HMRs to Traffic
    • Outbound HMR
    • Inbound HMR
    • Order of Header Rule Application
    • HMR Store Actions and Boolean Results
    • Routing Decisions
  • Static and Dynamic HMR
    • Static HMR
    • Dynamic HMR
  • Sample HMR
• HMR Components
  • Relationship Between Rulesets and Its Rules
  • Ruleset Guidelines
  • Ruleset Components
  • Guidelines for Header and Element Rules
  • Guidelines for Header Rules
  • Guidelines for Element Rules
  • Duplicate Header Names
  • SIP Header Pre-Processing HMR
  • Back Reference Syntax
  • Dialog Matching
    • About Dialog-Matching Header Manipulations
      • Inbound HMR Challenge
      • Outbound HMR Challenge
      • Dialog-matching Header Manipulation Configuration
  • Built-In HMRs
    • Built-In Variables
    • Built-In SIP Manipulation Configuration
  • Unique Regex Patterns Per Peer/Trunk
  • Rejecting SIP Requests
  • HMR Information in Logs
• Using Regular Expressions
  • Example of HMR with Regex
  • Regex Characters
    • Literal (Ordinary)
    • Special (Metacharacters)
    • Regex Tips
    • Matching New Lines
    • Escaped Characters
    • Building Expressions with Parentheses
    • Boolean Operators
    • Equality Operators
    • Normalizing EBNF ExpressionString Grammar
  • Storing Regex Patterns
  • Performance Considerations
  • Additional References
• HMR Configuration
  • Testing Pattern Rules
  • Creating Header Manipulation Rulesets
  • Configuring SIP Header Manipulation Rules
  • Configuring SIP Header Manipulation Element Rules
  • Status-Line Manipulation and Value Matching
    • Set the Header Name
    • Set the Element Type
    • Set the Match Value
      • Set the Header Rules Match Value
      • Set the Element Rules Match Value
      • Set the Response Code Block
  • Configuring SIP HMR Sets
  • Configuring a Session Agent
  • Configuring a SIP Interface
  • Example 1 Stripping All Route Headers
  • Example 2 Stripping an Existing Parameter and Adding a New One
• Unique HMR Regex Patterns and Other Changes
  • The Default Expression
  • Manipulation Pattern Per Remote Entity
  • Reject Action
    • Reject Action Configuration
    • About Counters
    • SNMP Support
  • Log Action
  • Changes to Storing Pattern Rule Values
  • Removal of Restrictions
  • Name Restrictions for Manipulation Rules
  • New Value Restrictions
• MIME Support
  • Manipulating MIME Attachments
    • About the MIME Value Type
    • SIP Message-Body Separator Normalization
    • Configuring MIME Support
  • HMR for SIP-ISUP
    • MIME Rules Overview
    • Identifying a MIME Rule
    • About MIME Rules
    • MIME Rules Configuration
    • Working with MIME Rules
    • MIME ISUP Manipulation
    • Adding an ISUP Body to a SIP Message
    • MIME ISUP Manipulation Configuration
    • Configuration Example
  • Header Manipulation Rules for SDP
    • SDP Manipulation
      • sdp-session-rule
      • sdp-media-rule
      • sdp-line-rule
    • Regular Expression Interpolation
    • Regular Expressions as Boolean Expressions
    • Moving Manipulation Rules
    • Rule Nesting and Management
    • ACLI Configuration Examples
      • Remove SDP
      • Remove Video from SDP
      • Add SDP
      • Manipulate Contacts
      • Remove a Codec
      • Change Codec
      • Remove Last Codec and Change Port
      • Remove Codec with Dynamic Payload
• HMR Import-Export
  • Exporting
  • Importing
  • Using SFTP to Move Files
  • Removing Files
• HMR Development
  • Development Overview
    • Development Tips
  • Planning Considerations
    • Traffic Direction
    • Order of Application Precedence
    • Order of HMR Execution
    • Applying HMR to a Specific Header
    • HMR Sets
  • Create Pseudocode
  • Test HMRs
    • test-sip-manipulation
  • Development Example
    • Writing the Psuedo Code
    • Testing the Pattern Rule
    • Constructing the HMR
    • Loading Test SIP Message
    • Configuring Testing
    • Executing Testing
    • Log File Analysis
• Configuration Examples
  • Example 1 Removing Headers
  • Example 2 Manipulating the Request URI
  • Example 3 Manipulating a Header
  • Example 4 Storing and Using URI Parameters
  • Example 5 Manipulating Display Names
  • Example 6 Manipulating Element Parameters
  • Example 7 Accessing Data from Multiple Headers of the Same Type
  • Example 8 Using Header Rule Special Characters
  • Example 9 Status-Line Manipulation
  • Example 10 Use of SIP HMR Sets
  • Example 11 Use of Remote and Local Port Information
  • Example 12 Response Status Processing
  • Example 13 Remove a Line from SDP
  • Example 14 Back Reference Syntax
  • Example 15 Change and Remove Lines from SDP
  • Example 16 Change and Add New Lines to the SDP