Introduction
Ce document décrit comment configurer des stratégies de proxy sur le système autonome BW, pour proxy des en-têtes SIP inconnus ou des paramètres Require/Supported.
Conditions préalables
- Connaissances de base du protocole SIP (Session Initiation Protocol)
- Connaissances de base sur les serveurs d'applications (AS)
- Connaissances bwcli Basic Broadworks (BW)
Exigences
Cisco vous recommande de prendre connaissance des rubriques suivantes :
- Pouvoir utiliser l'interface bwcli AS en tant qu'utilisateur admin
- Pouvoir vérifier les XSLogs AS
- Générez un message INVITE (via un client ou un simulateur) qui permet de configurer les en-têtes et les paramètres Require/Supported.
Composants utilisés
Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Informations générales
En tant qu'agent utilisateur back-to-back (B2BUA), le système autonome n'utilise normalement pas de proxy pour les en-têtes SIP ou les paramètres des en-têtes Require et Supported, s'ils sont considérés comme inconnus.
Par exemple, si le système autonome reçoit cette invitation SIP, il ignore l'en-tête complet MyUnknownHeader et le paramètre MyUnknownParameter dans l'en-tête Supported.
INVITE sip:+1555123456@cisco.com;user=phone SIP/2.0
Via: SIP/2.0/TCP 10.1.2.3:5060;branch=z9hG4bKva8in830cgv4i2mj6m20.1
Max-Forwards: 69
To: <sip:+1555123456@cisco.com;user=phone>
From: <sip:+1555654321@cisco.com;user=phone>;tag=SDq4k7b01-1
Contact: <sip:+155565432@172.16.0.1:5060;transport=tcp>
Call-ID: Testcall-456000001
CSeq: 101 INVITE
Supported: 100rel,MyUnknownParameter
MyUnknownHeader: MyStuff
Allow: INVITE, OPTIONS, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY, INFO, REGISTER
Content-Length: 0
Les paramètres ProxyPolicy du système autonome vous permettent de configurer des en-têtes et des paramètres inconnus pour qu'ils soient mis en proxy de manière transparente par le système autonome.
Le Guide d'interfonctionnement de l'interface d'accès SIP de Cisco BroadWorks contient une liste des en-têtes et des paramètres connus, qui ne peuvent jamais être mis en proxy de manière transparente, car le système autonome les traite.
Les en-têtes et paramètres connus sont traités et peuvent ou ne peuvent pas être mis en proxy (selon le résultat du traitement AS), et ne peuvent pas être contrôlés avec la configuration expliquée dans cet article.
Configurer
Tous les paramètres requis pour ProxyPolicy sont disponibles dans la bwcli à l'adresse AS_CLI/Interface/SIP/ProxyPolicy>.
Afin de permettre au système autonome d'envoyer un proxy à l'en-tête MyUnknownHeader, naviguez d'abord vers AS_CLI/Interface/SIP/ProxyPolicy/Rule> à partir de l'interface bwcli du système autonome et ajoutez une nouvelle règle :
AS_CLI> cd /Interface/SIP/ProxyPolicy/Rule
AS_CLI/Interface/SIP/ProxyPolicy/Rule> add MyUnknownHeaderRule true true true true true true true true
...Done
Exécutez la commande get afin d'afficher la configuration actuelle.
La configuration ressemble maintenant à ceci (en raison des nombreuses options, la largeur du résultat de cette commande est très grande ; faites défiler horizontalement pour l'afficher entièrement) :
AS_CLI/Interface/SIP/ProxyPolicy/Rule> get
Rule Name Keep On Redirection Keep On Egress Access Keep On Egress Network On-net Keep On Egress Network Off-net Keep On Egress Access Shared Call Appearance Keep On Egress Network BroadWorks Anywhere On-net Keep On Egress Network BroadWorks Anywhere Off-net Accept From Redirect-to URI
============================================================================================================================================================================================================================================================================================================
MyUnknownHeaderRule true true true true true true true true
Une fois cette opération terminée, vous devez créer le HeaderPolicy. Accédez à AS_CLI/Interface/SIP/ProxyPolicy/HeaderPolicy> et exécutez cette commande :
AS_CLI/Interface/SIP/ProxyPolicy/HeaderPolicy> add MyUnknownHeader MyUnknownHeaderRule
...Done
Dans cet exemple, la règle a été configurée pour conserver l'en-tête dans toutes les directions, pour tous les services et dans les URI de redirection, mais ce paramètre dépend de votre situation réelle.
Les options disponibles sont expliquées dans cette liste :
- keepOnRedirection : Ce paramètre détermine si l'en-tête est conservé en cas de redirection.
- keepOnEgressAccess : Ce paramètre détermine si l'en-tête est conservé pour les messages sortants vers le côté accès.
- keepOnEgressNetworkOnNet : Ce paramètre détermine si l'en-tête est propagé pour les messages sortants sur le réseau liés au réseau.
- keepOnEgressNetworkOffNet : Ce paramètre détermine si l'en-tête est propagé pour les messages sortants hors réseau liés au réseau.
- keepOnEgressAccessSharedCallAppearance : Ce paramètre détermine si l'en-tête est conservé pour les messages sortants vers un emplacement secondaire d'affichage d'appel partagé.
- keepOnEgressNetworkBroadWorksAnywhereOnNet : Ce paramètre détermine si l'en-tête est conservé pour les messages sortants sur le réseau vers un emplacement BroadWorks Anywhere.
- keepOnEgressNetworkBroadWorksAnywhereOffNet : Ce paramètre détermine si l'en-tête est conservé pour les messages sortants hors réseau vers un emplacement BroadWorks Anywhere.
- acceptFromRedirectToURI : Ce paramètre détermine si un en-tête inconnu incorporé dans un URI de destination de redirection peut être accepté pour insertion dans un message sortant.
Le paramètre inconnu peut être configuré de la même manière, mais le paramètre est configuré dans AS_CLI/Interface/SIP/ProxyPolicy/OptionTagPolicy> .
Commencez par créer une règle.
Remarque : Dans cet exemple, le premier commutateur est défini sur false.
AS_CLI/Interface/SIP/ProxyPolicy/Rule> add MyUnknownParameterRule false true true true true true true true
Il s'agit de la règle résultante, avec Keep On Redirection défini sur false, de sorte que MyUnknownHeader n'est pas ajouté à l'invitation sortante en cas de redirections.
AS_CLI/Interface/SIP/ProxyPolicy/Rule> get
Rule Name Keep On Redirection Keep On Egress Access Keep On Egress Network On-net Keep On Egress Network Off-net Keep On Egress Access Shared Call Appearance Keep On Egress Network BroadWorks Anywhere On-net Keep On Egress Network BroadWorks Anywhere Off-net Accept From Redirect-to URI
===================================================================================================================================================================================================================================================================================================================
MyUnknownHeaderRule true true true true true true true true
MyUnknownParameterRule false true true true true true true true
Pour terminer la configuration, ajoutez OptionTagPolicy.
AS_CLI/Interface/SIP/ProxyPolicy/OptionTagPolicy> add MyUnknownParameter MyUnknownParameterRule
Le système autonome proxie maintenant l'en-tête inconnu MyUnknownHeader et le paramètre inconnu MyUnknownParameter.
Remarque : L'AS ne comprend pas la sémantique et ne traite en aucune façon les en-têtes et paramètres inconnus.
Vérifier
Envoyez au système autonome l'invitation contenant l'en-tête SIP inconnu et la balise d'option que vous avez configurés dans la stratégie proxy, et assurez-vous que l'invitation sortante a conservé l'en-tête inconnu, conformément à la configuration de la règle.
Dépannage
Si le message INVITE sortant ne contient pas l'en-tête ou la balise Option comme prévu, vous pouvez vérifier cette liste :
- Assurez-vous que l'en-tête ou le paramètre que vous avez configuré ne figure pas dans la liste des en-têtes/paramètres connus.
- Vérifiez que l'en-tête ou le paramètre de l'invite correspond exactement à ceux configurés dans l'interface bwcli (non-respect de la casse).
- Vérifiez que la règle configurée autorise le proxy de l'en-tête ou du paramètre.