/mcpSIP Copylists are an extension of SIP Profiles which allows the gateway to COPY a header from the in-leg of a call and then PASTE to another spot in the egress SIP message on the out-leg. SIP Copylist support was added in Cisco IOS 15.1(3)T and Cisco IOS XE 3.6S. This is a very powerful way of creating dynamic headers based on other headers from the in-leg of the call. The most common use-case is dynamically copying a FROM header to a different header like diversion or p-asserted-id so that the value of the user portion is the from user. This is mostly done for authentication as well as caller ID purposes. Full Documentation: Cisco Unified Border Element Configuration Guide - Cisco IOS XE 17.6 Onwards SIP Copylist Example
<#root> ! ! Create Copylist to copy the FROM header on the inbound message specified later. ! voice class sip-copylist <number> sip-header From ! ! Apply this to the inbound dial-peer of the call. ! dial-peer voice <tag> voip voice-class sip copy-list <number> ! ! Create SIP Profile to take From (peer-header) stored as variable "u01" and apply to a header of choice ! This example modifies the user portion of the Contact by copying the user portion of the From header t ! voice class sip-profiles <number> request INVITE peer-header sip From copy "<sip:(.*)@" u01 request INVITE sip-header Contact modify "sip:(.*)" "sip:\u01@10.50.244.2" ! ! Apply the SIP profile to an outbound dial-peer ! dial-peer voice <tag> voip voice-class sip profiles <number> !
Debugging SIP Profiles and Copylist
debug voip ccapi inout debug ccsip mess debug ccsip info debug ccsip feature sip-profile
Debug Output From the Example SIP Copylist