Introducción
Este documento describe cómo configurar las políticas de proxy en BW AS, para proxy encabezados SIP desconocidos o parámetros Require/Supported.
Prerequisites
- Conocimiento básico del protocolo de inicio de sesión (SIP)
- Conocimiento básico de Application Server (AS)
- Conocimiento bwcli de Basic Broadworks (BW)
Requirements
Cisco recomienda que tenga conocimiento sobre estos temas:
- Poder utilizar AS bwcli como usuario administrador
- Poder revisar los AS XSLogs
- Genere una INVITE (mediante un cliente o simulador) que permita configurar los encabezados y los parámetros Require/Supported.
Componentes Utilizados
La información que contiene este documento se basa en las siguientes versiones de software y hardware.
La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.
Antecedentes
Como agente de usuario adosado (B2BUA), el AS normalmente no realiza proxy de los encabezados o parámetros SIP en los encabezados Require y Supported, si se consideran desconocidos.
Por ejemplo, si el AS recibe este SIP INVITE, descarta todo el encabezado MyUnknownHeader y el parámetro MyUnknownParameter en el encabezado 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
La configuración de ProxyPolicy en el AS permite configurar encabezados y parámetros desconocidos para que el AS los procese como proxy de forma transparente.
La Guía de Interconexión de la Interfaz de Acceso SIP de Cisco BroadWorks contiene una lista de los encabezados y parámetros conocidos, que nunca se pueden procesar de manera transparente, a medida que el AS los procesa.
Los encabezados y parámetros conocidos se procesan y pueden o no ser procesados (dependiendo del resultado del procesamiento de AS), y no pueden ser controlados con la configuración explicada en este artículo.
Configurar
Toda la configuración necesaria para ProxyPolicy se puede encontrar en bwcli en AS_CLI/Interface/SIP/ProxyPolicy>.
Para permitir que el AS proxy el encabezado MyUnknownHeader, primero navegue hasta AS_CLI/Interface/SIP/ProxyPolicy/Rule> desde el AS bwcli y agregue una nueva regla:
AS_CLI> cd /Interface/SIP/ProxyPolicy/Rule
AS_CLI/Interface/SIP/ProxyPolicy/Rule> add MyUnknownHeaderRule true true true true true true true true
...Done
Ejecute el comando get para mostrar la configuración actual.
La configuración ahora tiene este aspecto (debido a las muchas opciones, el ancho de la salida de este comando es muy grande; desplazar horizontalmente para verla por completo):
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
Una vez completado, debe crear el HeaderPolicy. Navegue hasta AS_CLI/Interface/SIP/ProxyPolicy/HeaderPolicy> y ejecute este comando:
AS_CLI/Interface/SIP/ProxyPolicy/HeaderPolicy> add MyUnknownHeader MyUnknownHeaderRule
...Done
En este ejemplo, la regla se ha configurado para conservar el encabezado en todas las direcciones, para todos los servicios y en los URI de redireccionamiento, pero esta configuración depende de su caso real.
Las opciones disponibles se explican en esta lista:
- keepOnRedirection: Este parámetro determina si el encabezado se mantiene en el caso de una redirección.
- keepOnEgressAccess: Este parámetro determina si el encabezado se mantiene para los mensajes salientes al lado de acceso.
- keepOnEgressNetworkOnNet: Este parámetro determina si el encabezado se propaga para los mensajes salientes en la red enlazados a la red.
- keepOnEgressNetworkOffNet: Este parámetro determina si el encabezado se propaga para los mensajes salientes fuera de la red enlazados a la red.
- keepOnEgressAccessSharedCallAppearance: Este parámetro determina si el encabezado se mantiene para los mensajes salientes en una ubicación secundaria de Shared Call Appearance.
- keepOnEgressNetworkBroadWorksAnywhereOnNet: Este parámetro determina si el encabezado se mantiene para los mensajes salientes en la red a una ubicación de BroadWorks Anywhere.
- keepOnEgressNetworkBroadWorksAnywhereOffNet: Este parámetro determina si el encabezado se mantiene para los mensajes salientes fuera de la red a una ubicación de BroadWorks Anywhere.
- acceptFromRedirectToURI: Este parámetro determina si un encabezado desconocido incrustado en un URI de destino de redirección puede aceptarse para su inserción en un mensaje saliente.
El parámetro desconocido se puede configurar de la misma manera, pero el parámetro se configura en AS_CLI/Interface/SIP/ProxyPolicy/OptionTagPolicy> .
En primer lugar, cree una regla.
Nota: En este ejemplo, el primer switch se establece en false.
AS_CLI/Interface/SIP/ProxyPolicy/Rule> add MyUnknownParameterRule false true true true true true true true
Ésta es la regla resultante, con el valor de Keep On Redirection establecido en false, de modo que MyUnknownHeader no se agrega al mensaje INVITE saliente en caso de redirecciones.
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
Para completar la configuración, agregue OptionTagPolicy.
AS_CLI/Interface/SIP/ProxyPolicy/OptionTagPolicy> add MyUnknownParameter MyUnknownParameterRule
El AS ahora hace proxy del encabezado desconocido MyUnknownHeader y del parámetro desconocido MyUnknownParameter.
Nota: El AS no entiende la semántica ni procesa de ninguna manera los encabezados y parámetros desconocidos.
Verificación
Envíe al AS el mensaje INVITE que contiene el encabezado SIP desconocido y la etiqueta de opción que ha configurado en la política de proxy, y asegúrese de que el mensaje INVITE saliente ha conservado el encabezado desconocido, según la configuración de regla.
Troubleshoot
En caso de que la INVITE saliente no contenga el encabezado o la etiqueta de opción como se esperaba, puede comprobar esta lista:
- Asegúrese de que el encabezado o parámetro que ha configurado no está incluido en la lista de encabezados o parámetros conocidos.
- Compruebe que el encabezado o el parámetro de INVITE coincide exactamente con los configurados en bwcli (no distingue entre mayúsculas y minúsculas).
- Compruebe que la regla configurada permite que el encabezado o el parámetro se convierta en proxy.