The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The Inbound Leg Headers for Outbound Dial-Peer Matching feature allows you to match and provision an outbound dial peer for an outbound call leg using the headers from an inbound call leg. The following headers of an incoming call leg can be used for outbound dial-peer matching:
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 Name |
Releases |
Feature Information |
|---|---|---|
|
Inbound Leg Headers for Outbound Dial-Peer Matching |
15.4(2)T, Cisco IOS XE Release 3.12S |
TheInbound Leg Headers for Outbound Dial-Peer Matching feature allows you to match and provision an outbound call leg using the headers of an inbound call leg. The following commands were introduced by this feature: destination provision-policy, destination uri-via, destination uri-to, destination uri-from, destination uri-diversion, destination uri-referred-by, show voice class dial-peer provision-policy The following commands were modified. show command incall, show dialplan dialpeer. |
The existing header-passing command supports modification of SIP headers of INVITE message by the Tool Command Language (TCL) application. If the above SIP headers are modified by the TCL application, they cannot be used for outbound dial-peer provisioning.
If multiple SIP via headers and diversion headers are found in an incoming INVITE or REFER message, only the top-most via header and top-most diversion header of an incoming INVITE or REFER message are used for outbound dial-peer provisioning.
This feature allows you to match headers of an inbound call leg and provision an outbound dial peer for an outbound call leg. The following SIP headers of an incoming call leg can be used for outbound dial-peer matching
The above headers are retrieved from an incoming INVITE or REFER message and used for outbound dial-peer provisioning.
SIP headers of an INVITE message are saved to an associated call leg. For example, an INVITE message is received for a new call leg A. Then, SIP headers are saved to call leg A itself for outbound dial-peer lookup.
On the other hand, SIP headers of a REFER message are saved to the peer call leg of the associated call leg. For example, call leg A and call leg B are connected in CUBE. The party at Call Leg B makes a blind transfer to the party at Call Leg C. A REFER message is received in CUBE for call leg B (transferor). But, SIP headers of the REFER message are saved under call leg A (transferee) for an outbound dial-peer lookup for Party C.
Necessary pattern maps have been configured.
1.
enable
2.
configure terminal
3.
voice class dial-peer provision-policy
tag
4.
(Optional) description
string
5.
preference
preference-order
first-attribute
second-attribute
6.
exit
7.
dial-peer voice
inbound-dial-peer-tag
voip
8.
destination
provision-policy
tag
9.
exit
10.
dial-peer voice
outbound-dial-peer-tag
voip
11. Configure a match command for an outbound dial peer according to the provision policy rule attribute configured.
12.
end
1.
show dialplan incall {sip | h323} {calling |
called}
e164-pattern |
include voice
2.
show dialplan dialpeer
inbound-dial-peer-id
number
e164-pattern
[timeout] | include Voice
3.
show voice class dial-peer
provision-policy
| Step 1 | show dialplan incall {sip | h323} {calling |
called}
e164-pattern |
include voice
Displays inbound dial peers based on an incoming calling or called number. Once you have the dial peer number, you can use it to search for the complete dial-peer details in the running-config. Example: Device# show dialplan incall sip calling 3333 | include Voice
VoiceOverIpPeer1
Device# show dialplan incall sip calling 4444 | include Voice
VoiceOverIpPeer1
Device# show running-config | section dial-peer voice 1 voip
dial-peer voice 1 voip
destination dpg 10000
incoming calling e164-pattern-map 100
dtmf-relay rtp-nte
codec g711ulaw
Device# show dialplan incall sip called 6000 timeout | include Voice
VoiceOverIpPeer100
Device# show running-config | section dial-peer voice 100 voip
dial-peer voice 100 voip
incoming called e164-pattern-map 1
incoming calling e164-pattern-map 1
dtmf-relay rtp-nte
codec g711ulaw
Device# show dialplan incall voip calling 23456
VoiceOverIpPeer1234567
peer type = voice, system default peer = FALSE, information type = voice,
description = `',
tag = 1234567, destination-pattern = `',
destination e164-pattern-map tag = 200 status = valid,
destination dpg tag = 200 status = valid,
voice reg type = 0, corresponding tag = 0,
allow watch = FALSE
answer-address = `', preference=0,
incoming calling e164-pattern-map tag = `200' status = valid,
CLID Restriction = None
|
| Step 2 | show dialplan dialpeer
inbound-dial-peer-id
number
e164-pattern
[timeout] | include Voice
Displays a list of outbound dial peers based on a specified inbound dial peer. This command line will be helpful find a list of outbound dial peer of a destination dial-peer group. Example: Device# show dialplan dialpeer 1 number 23457 timeout | include Voice VoiceOverIpPeer100013 VoiceOverIpPeer100012 Example: voice class dial-peer provision-policy 2000
preference 2 diversion to
!
...
!
dial-peer voice 32555 voip
session protocol sipv2
session target ipv4:1.5.14.9
destination uri-diversion 1
destination uri-to test2
!
dial-peer voice 32991 voip
destination provision-policy 2000
incoming called-number 1234
!
Device# show dialplan dialpeer 32991 number 2234 timeout
Macro Exp.: 2234
Enter Diversion header:sip:1234@cisco.com
Enter To header:sip:2234@10.0.0.0
VoiceOverIpPeer32134
peer type = voice, system default peer = FALSE, information type = voice,
description = `',
|
| Step 3 | show voice class dial-peer
provision-policy
Displays a list of configured provision policies and associated rules. Example: Device# show voice class dial-peer provision-policy Voice class dial-peer provision-policy: 100 AdminStatus: Up Description: match only called Pref Policy Rule ---- ----------- 1 called Voice class dial-peer provision-policy: 101 AdminStatus: Up Description: match both calling and called Pref Policy Rule ---- ----------- 1 called calling Voice class dial-peer provision-policy: 102 AdminStatus: Up Description: match calling first; if no match then match called Pref Policy Rule ---- ----------- 1 calling 2 called Voice class dial-peer provision-policy: 200 AdminStatus: Up Description: match referred-by and via uri; if no match then match request- uri Pref Policy Rule ---- ----------- 1 referred-by via 2 uri voice class dial-peer provision-policy: 300 AdminStatus: Up Description: match only request-uri Pref Policy Rule ---- ----------- 1 uri Voice class dial-peer provision-policy: 400 AdminStatus: Up Description: match only request uri; if no match then match called Pref Policy Rule ---- ----------- 1 uri 2 called |
Device> enable Device# configure terminal Device(config)# voice class dial-peer provision-policy 200 Device(voice-class)# description match both calling and called Device(voice-class)# preference 2 calling called Device(voice-class)# exit Device(config)# voice class e164-pattern-map 300 Device(voice-class)# description patterns Device(voice-class)# e164 5557123 Device(voice-class)# e164 5558123 Device(voice-class)# e164 5559123 Device(voice-class)# exit !Associating the Provision Policy with an Inbound Dial Peer Device(config)# dial-peer voice 100 voip Device(config-dial-peer)# destination provision-policy 200 Device(config-dial-peer)# end !Associates a Pattern Map with an Outbound Dial Peer. ! The called number in the SIP headers of the inbound leg is matched to select the below outbound dial peer. Device(config)# dial-peer voice 200 voip Device(config-dial-peer)# destination e164-pattern-map 300 Device(config-dial-peer)# end
Device> enable Device# configure terminal Device(config)# voice class dial-peer provision-policy 200 Device(voice-class)# description match both calling and called Device(voice-class)# preference 2 via from Device(voice-class)# exit !Associating the Provision Policy with an Inbound Dial Peer Device(config)# dial-peer voice 100 voip Device(config-dial-peer)# destination provision-policy 200 Device(config-dial-peer)# end Device(config)# voice class uri 200 sip Device(config-voice-uri-clas)# pattern 25054.. !Associates a Provision Policy with an Outbound Dial Peer. The FROM SIP headers of the inbound leg is matched to select the below outbound dial peer. Device(config)# dial-peer voice 200 voip Device(config-dial-peer)# destination uri-from 200 Device(config-dial-peer)# end
Feedback