Ejemplo de Configuración de Normalización de Session Initiation Protocol (SIP) de Unified Border Element (CUBE) con Perfiles de SIP
Contenido
Introducción
La traducción y reparación de protocolos es una función Cisco Unified Border Element (CUBO). CUBE se puede implementar entre dos dispositivos que soporten el mismo protocolo VoIP (SIP), pero no interfuncionan debido a las diferencias de implementación o interpretación del protocolo. CUBE puede personalizar la mensajería SIP de ambos lados a lo que los dispositivos de ese segmento de la red esperan ver normalizando la mensajería SIP en el borde de la red o entre dos dispositivos no interoperables dentro de la red.
Los proveedores de servicios pueden tener políticas para las que deben estar presentes los campos de mensajería SIP (o lo que constituye valores válidos para los campos de encabezado) antes de que una llamada SIP entre en su red. De forma similar, las empresas y las pequeñas empresas pueden tener políticas para la información que puede entrar o salir de sus redes por motivos de política o seguridad desde un troncal SIP del proveedor de servicios.
Para personalizar la mensajería SIP en ambas direcciones, puede colocar CUBE con una configuración de normalización SIP en el límite de estas redes, como se muestra en esta imagen:
Además del cumplimiento de las políticas de red, las capacidades de normalización de CUBE SIP se pueden utilizar para resolver incompatibilidades entre los dispositivos SIP dentro de la red empresarial. Estas son las situaciones en las que pueden surgir incompatibilidades:
-
Un dispositivo rechaza un encabezado desconocido (valor o parámetro) en lugar de ignorarlo
-
Un dispositivo envía datos incorrectos en un mensaje SIP
-
Un dispositivo no implementa (o implementa incorrectamente) procedimientos de protocolo
-
Un dispositivo espera un valor o parámetro de encabezado opcional o un procedimiento de protocolo opcional que se puede implementar de varias maneras
-
Un dispositivo envía un valor o parámetro que se debe cambiar o suprimir antes de que salga de la red o entre en ella
-
Variaciones en los estándares SIP sobre cómo lograr ciertas funciones
La función de perfiles SIP en CUBE proporciona una solución a estos problemas de normalización y personalización de SIP.
Prerequisites
Requirements
Asegúrese de cumplir estos requisitos antes de intentar esta configuración:
-
Conocimiento básico de cómo configurar y utilizar las funciones de voz de Cisco IOS (como pares de marcado)
-
Conocimientos básicos sobre cómo configurar y utilizar Cisco Unified Border Element (CUBE)
-
Conocimiento intermedio del protocolo SIP y sus mensajes, campos y parámetros
Componentes Utilizados
La información que contiene este documento se basa en las siguientes versiones de software y hardware.
-
Versión de Cisco Unified Border Element en un Cisco ISR, Cisco AS5400XM Access Gateway, Cisco AS5350XM Access Gateway, Cisco 7200 Router o un Cisco 7300 Router que ejecuta Cisco IOS Release 12.4.15XZ o posterior
-
Gateway de Cisco TDM a SIP en una gateway de acceso Cisco AS5400XM ISR o una gateway de acceso Cisco AS5350XM que ejecute la versión 12.4.15XZ o posterior del IOS de Cisco
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. If your network is live, make sure that you understand the potential impact of any command.
Convenciones
Consulte Convenciones de Consejos Técnicos de Cisco para obtener más información sobre las convenciones sobre documentos.
Configurar
La configuración de la función de perfiles SIP permite agregar, modificar o quitar cualquier valor de encabezado SIP o SDP en un mensaje SIP saliente en CUBE. En la sección Mensajes SIP admitidos de este documento se proporciona una lista de los mensajes y encabezados exactos admitidos. Los perfiles SIP se pueden configurar en el nivel de par de marcado o a nivel global.
La sintaxis para la modificación de mensajes utiliza la notación de expresión regular para coincidir y reemplazar campos en los mensajes. Las subcadenas coincidentes se pueden utilizar en patrones de reemplazo. Cuando se aplican varias reglas de expresión regular a la misma combinación [method/response]:header, la segunda regla se aplica a la cadena de resultado de la primera regla.
Los perfiles SIP no le permiten quitar o agregar encabezados SIP obligatorios. Sólo la opción Modify está disponible para los encabezados obligatorios. Los encabezados SIP obligatorios incluyen To, From, Via, CSeq, Call-Id y Max-Forwards. Los encabezados SDP obligatorios incluyen v, o, s, t, c y m.
La palabra clave ANY especial se proporciona en la CLI para indicar que se debe aplicar una regla a cualquier mensaje dentro de la categoría especificada. Las reglas configuradas para un mensaje INVITE se aplican solamente a la primera INVITE en la secuencia de protocolo para la llamada. Se admite una palabra clave REINVITE especial para definir el funcionamiento necesario en las INVITE posteriores en una secuencia de protocolo para la llamada.
Los perfiles SIP también se pueden utilizar para cambiar el nombre de un encabezado del formulario largo al formato compacto; por ejemplo, De a f. Esto se puede utilizar como una forma de reducir la longitud de un mensaje SIP. De forma predeterminada, Cisco IOS SIP nunca envía la forma compacta de los mensajes SIP, aunque recibe la forma larga o la corta.
La función de perfiles SIP afecta sólo a los mensajes SIP salientes. Las reglas se aplican como el último paso antes de que el mensaje abandone el router CUBE; es decir, después de que se haya realizado la coincidencia de dial-peer de destino. La aplicación CUBE no recuerda los cambios en los mensajes SIP ni realiza ninguna acción al respecto.
El campo Content-length se vuelve a calcular después de aplicar las reglas SIP Profiles al mensaje saliente.
Nota: Utilice la herramienta Command Lookup (sólo para clientes registrados) para obtener más información sobre los comandos utilizados en esta sección.
Estructura de Comandos de Configuración General
El comando general que define una regla para agregar un campo a un método/respuesta SIP es:
<request/response> <message code> <sip-header/sdp-header> <header-name> add <add-value>
El comando general que define una regla para quitar un campo a un método/respuesta SIP es:
<request/response> <message code> <sip-header/sdp-header> <header-name> remove
El comando general que define una regla para modificar un campo a un método/respuesta SIP es:
<request/response> <message code> <sip-header/sdp-header> <header-name> modifiquen <match-pattern> <replace-pattern>
Configuration Steps
El primer paso es definir las reglas. Para definir las reglas, utilice la estructura de comandos general dada en la sección anterior. Por ejemplo:
voice class sip-profiles 100 request INVITE sip-header… response 100 sip-header… request INVITE sdp-header…
El segundo paso es aplicar las reglas al nivel global o dial-peer de la configuración CUBE. Para aplicar las reglas globalmente a todas las llamadas que atraviesan CUBE, utilice esta estructura de comandos:
voice service voip
sip
sip-profiles 100
Para aplicar las reglas selectivamente a las llamadas que atraviesan solamente un dial-peer saliente determinado, utilice esta estructura de comandos:
dial-peer voice 555 voip voice-class sip-profiles 100
Si las reglas se configuran tanto en el nivel global como en el de dial-peer, la configuración de dial-peer tiene prioridad sobre la configuración global level.
Estas notas se aplican de forma genérica a todas las funciones de Cisco IOS que utilizan expresiones regulares (que incluyen perfiles SIP):
-
Cuando un valor agregado, match-pattern o replace-pattern contienen caracteres de espacio en blanco, el valor completo se debe incluir entre comillas dobles. Por ejemplo:
response 100 sip-header add "User-Agent: CISCO CUBE"
-
Cuando un valor añadido, coincidencia-patrón o sustitución-patrón contiene comillas dobles ( " ) y caracteres de espacio en blanco, una barra invertida ( \ ) debe anteponer las comillas interiores. Por ejemplo, para agregar "CISCO" CUBE, utilice este comando:
response 100 sip-header add "User-Agent: \"CISCO\" CUBE
Advertencias de configuración
-
Para proporcionar la mayor flexibilidad posible, la comprobación de sintaxis no se realiza en los mensajes SIP que resultan después de aplicar las reglas. Debe asegurarse, mediante pruebas adecuadas, de que los cambios que especifique en las reglas de perfil den lugar a intercambios de protocolos SIP válidos.
-
El tipo de mensaje SIP no se puede cambiar con los perfiles SIP.Es decir, una respuesta 180 timbre no se puede cambiar a una respuesta de progreso de la sesión 183.
-
Los encabezados obligatorios sólo se pueden modificar; no se pueden agregar ni quitar. Los encabezados SIP obligatorios incluyen To, From, Via, CSeq, Call-Id y Max-Forwards. Los encabezados SDP obligatorios incluyen v, o, s, t, c y m.
-
Mientras que las variables de expresión regular se pueden utilizar en las subcadenas match y replace para almacenar y reutilizar valores, la información no se puede extraer de un mensaje y aplicarse a otro. Por ejemplo, el número que llama no se puede extraer de INVITE e insertar en un mensaje REFER posterior. Las reglas especificadas se aplican a un único mensaje cada vez; sólo se manipula la información de ese mensaje.
Ejemplos de Configuración
Esta sección proporciona ejemplos de reglas de perfil SIP para lograr cambios específicos en los mensajes SIP.
Agregar
Esta sección proporciona ejemplos de cómo agregar encabezados SIP y SDP a los mensajes.
Ejemplo 1
Mensaje: INVITAR
Acción: Agregue el encabezado b=AS:4000 SDP a la línea de medios de vídeo
Reglas:
voice class sip-profiles 100 request INVITE sdp-header Video-Bandwidth-Info add "b=AS:4000"
Ejemplo 2
Mensaje: 480 Temporalmente No Disponible
Acción: Agregar el encabezado SIP Retry-After
Reglas:
voice class sip-profiles 100 response 480 sip-header Retry-After add “Retry-After: 60”
Ejemplo 3
Mensaje: INVITADOS y REINVITADOS
Acción: Agregue la etiqueta "user=phone" al encabezado de URI de SIP
Reglas:
voice class sip-profiles 100 request INVITE sip-header SIP-Req-URI modify "; SIP/2.0" ";user=phone SIP/2.0" request REINVITE sip-header SIP-Req-URI modify "; SIP/2.0" ";user=phone SIP/2.0"
Ejemplo 4
Mensaje: Respuesta de 200
Acción: Agregar el encabezado SIP User-Agent
Reglas:
voice class sip-profiles 100 response 200 sip-header User-Agent add "User-Agent: CiscoSystems-SIP-GW-UA"
Eliminar
Esta sección proporciona ejemplos sobre cómo quitar encabezados SIP y SDP a los mensajes.
Ejemplo 5
Mensaje: Todas las solicitudes y respuestas
Acción: Eliminar el encabezado SIP de la guía de Cisco
Reglas:
voice class sip-profiles 100 request ANY sip-header Cisco-Guid remove response ANY sip-header Cisco-Guid remove
Ejemplo 6
Mensaje: BYE and CANCEL
Acción: Eliminar el encabezado de motivo SIP
Reglas:
voice class sip-profiles 100 request BYE sip-header Reason remove request CANCEL sip-header Reason remove
Ejemplo 7
Mensaje: Respuestas de 100 y 180
Acción: Eliminar el encabezado SIP del servidor
Reglas:
voice class sip-profiles 100 response 100 sip-header Server remove response 180 sip-header Server remove
Modificar
Esta sección proporciona ejemplos sobre cómo modificar los encabezados SIP y SDP en los mensajes.
Ejemplo 8
Mensaje: INVITAR
Acción: Modifique el campo Desde: encabezado al formato "gateway@gw-ip-address"; por ejemplo, cambie 2222000020@9.13.24.7 a gateway@9.13.24.7
Reglas:
voice class sip-profiles 100 request INVITE sip-header From modify "(<.*:)(.*@)" "\1gateway@"
Ejemplo 9
Mensaje: INVITAR
Acción: sustituya "CiscoSystems-SIP-GW-UserAgent" por "-" en la línea o= del encabezado SDP
Reglas:
voice class sip-profiles 100 request INVITE sdp-header Session-Owner modify "CiscoSystems-SIP-GW-UserAgent“ "-"
Ejemplo 10
Mensaje: INVITAR
Acción: Convierta "sip url" en "tel url" en los encabezados Req-URI, From y To, por ejemplo de "sip:2222000020@9.13.24.6:5060" a "tel:222200020"
Reglas:
voice class sip-profiles 100 request INVITE sip-header SIP-Req-URI modify "sip:(.*)@[^ ]+" "tel:\1" request INVITE sip-header From modify "<sip:(.*)@.*>" "<tel:\1>" request INVITE sip-header To modify "<sip:(.*)@.*>" "<tel:\1>"
Ejemplo completo de configuración con perfiles SIP
Esta sección proporciona un ejemplo de configuración completo para un router CUBE configurado con perfiles SIP.
| CUBE |
|---|
CUBE#show run Building configuration... Current configuration : 5888 bytes ! ! Last configuration change at 13:16:50 CDT Mon Feb 11 2008 ! NVRAM config last updated at 13:24:35 CDT Mon Feb 11 2008 ! version 12.4 service timestamps debug datetime msec localtime service timestamps log datetime msec localtime service password-encryption ! hostname CUBE ! boot-start-marker boot system flash:c2800nm-ipvoice_ivs-mz.124-18.2.2.PIA1p.bin boot-end-marker ! logging message-counter syslog logging buffered 2000000 no logging console no logging monitor enable lab 0 ! no aaa new-model memory-size iomem 10 clock timezone CDT -6 clock summer-time CDT recurring no network-clock-participate slot 1 ! voice-card 0 no dspfarm ! ip cef ! voice service voip media flow-around allow-connections sip to sip sip sip-profiles 100 ! voice class sip-profiles 100 request INVITE sip-header SIP-Req-URI modify "; SIP/2.0" ";user=phone SIP/2.0" request REINVITE sip-header SIP-Req-URI modify "; SIP/2.0" ";user=phone SIP/2.0" ! interface GigabitEthernet0/0 ip address x.x.x.x 255.255.255.0 duplex full speed 100 ! ip http server ! control-plane ! dial-peer voice 100 voip destination-pattern .T session protocol sipv2 session target ipv4:x.x.x.x dtmf-relay rtp-nte codec g711ulaw no vad ! sip-ua ! line con 0 line aux 0 line vty 0 4 exec-timeout 90 0 ! scheduler allocate 20000 1000 end |
Notas de configuración adicionales
-
La longitud del encabezado (que incluye el nombre del encabezado) no debe superar los 300 caracteres tras la modificación con perfiles SIP. La longitud máxima del encabezado para un valor add es de aproximadamente 220 caracteres. La longitud máxima del encabezado SDP es de 2048 caracteres. Si una longitud de encabezado supera el valor máximo después de aplicar una regla, se ignorará esa regla y no se aplicarán los cambios. Si la longitud total de SDP supera los 2048 caracteres después de las modificaciones, todos los cambios en el SDP se ignoran y no se aplican.
-
La función de perfiles SIP no se puede utilizar para descartar un mensaje SIP completo; sólo se puede utilizar para manipular (agregar, modificar o quitar) el contenido del mensaje
-
Las variables de expresión regular se pueden utilizar para extraer y almacenar parámetros de un encabezado existente, pero los valores almacenados en variables en una regla se pueden utilizar SOLAMENTE en el patrón de reemplazo de la misma regla; NO puede ser utilizado por ninguna otra regla, lo que significa que no puede insertar los valores extraídos por una regla en otra regla.
El contenido especificado entre paréntesis abiertos ( ) y paréntesis cerrados ( ) en un patrón de coincidencia se almacena en las variables indicadas por 1, 2, 3, ... 9 en el orden en que se encuentren. Los valores almacenados de estas variables se pueden volver a insertar en el patrón de reemplazo haciendo referencia a las variables con \1, \2, ...\9, respectivamente.
Por ejemplo, si queremos cambiar:
Remote-Party-ID: “CUBE” <sip:2001@123.123.123.123>;privacy=off;screen=no to P-Asserted-Identity: “CUBE” <sip:2001@123.123.123.123>
Esto puede lograrse mediante la siguiente regla de perfil SIP:
request INVITE sip-header Remote-Party-ID modify "Remote-Party-ID:(.*>).*" "P-Asserted-Identity:\1"
En este ejemplo, la secuencia (.*>) coincide con "CUBE" <sip:2001@123.123.123.123>. Este valor se almacena en la variable 1, a la que se hace referencia en el patrón de reemplazo con \1.
Mensajes SIP admitidos
Esta sección proporciona las opciones CLI de los mensajes SIP que se pueden personalizar con la función de perfiles SIP de CUBE.
Solicitudes SIP
Estas solicitudes SIP son compatibles:
router(config-class)#request ? ACK sip ack ANY any sip request BYE sip bye CANCEL sip cancel COMET sip comet INFO sip info INVITE sip invite NOTIFY sip notify OPTIONS sip options PRACK sip prack PUBLISH sip publish REFER sip refer REGISTER sip register REINVITE sip reinvite SUBSCRIBE sip subscribe UPDATE sip info
Respuestas SIP
Estas respuestas SIP son compatibles:
router(config-class)#response ? 100 Response code 100 180 Response code 180 181 Response code 181 182 Response code 182 183 Response code 183 200 Response code 200 202 Response code 202 300 Response code 300 301 Response code 301 302 Response code 302 305 Response code 305 380 Response code 380 400 Response code 400 401 Response code 401 402 Response code 402 403 Response code 403 404 Response code 404 405 Response code 405 406 Response code 406 407 Response code 407 408 Response code 408 409 Response code 409 410 Response code 410 412 Response code 412 413 Response code 413 414 Response code 414 415 Response code 415 416 Response code 416 417 Response code 417 420 Response code 420 421 Response code 421 422 Response code 422 423 Response code 423 480 Response code 480 481 Response code 481 482 Response code 482 483 Response code 483 484 Response code 484 485 Response code 485 486 Response code 486 487 Response code 487 488 Response code 488 489 Response code 489 491 Response code 491 493 Response code 493 500 Response code 500 501 Response code 501 502 Response code 502 503 Response code 503 504 Response code 504 505 Response code 505 513 Response code 513 580 Response code 580 600 Response code 600 603 Response code 603 604 Response code 604 606 Response code 606 ANY Any Response
Encabezados SIP
Estos encabezados SIP son compatibles:
rtr(config-class)#request INVITE sip-header ? Accept-Contact Accept-Encoding Accept-Header Accept-Language Accept-Resource-Priority Alert-Info Allow-Events Allow-Header Also Authorization CC-Diversion CC-Redirect CSeq Call-ID Call-Info Cisco-Gcid Cisco-Guid Contact Content-Disposition Content-Encoding Content-Id Content-Length Content-Type Date Diversion Event Expires From History-Info Location MIME-Version Max-Forwards Min-Expires Min-SE Orig-dial-plan P-Asserted-Identity P-Preferred-Identity Privacy Proxy-Authenticate Proxy-Authorization Proxy-Require Rack Reason Record-Route Refer-To Referred-By Reject-Contact Remote-Party-ID Replaces Request-Disposition Requested-By Require Resource-Priority Retry-After Route Rseq SIP-ETag SIP-If-Match SIP-Req-URI Server Session-Expires Session-Header Subscription-State Supported Term-dial-plan Timestamp To Unsupported User-Agent Via WWW-Authenticate Warning
Encabezados SDP
Estos encabezados SDP son compatibles:
rtr(config-class)#response 200 sdp-header ? Attribute a= Audio-Attribute a= Audio-Bandwidth-Info b= Audio-Connection-Info c= Audio-Encryption-Key k= Audio-Media m=audio Audio-Session-Info i= Bandwidth-Key b= Connection-Info c= Email-Address e= Encrypt-Key k= Phone-Number p= Repeat-Times r= Session-Info i= Session-Name s= Session-Owner o= Time-Adjust-Key z= Time-Header t= Url-Descriptor u= Version v= Video-Attribute a= Video-Bandwidth-Info b= Video-Connection-Info c= Video-Encryption-Key k= Video-Media m=video Video-Session-Info i=
Verificación
En esta sección se muestran los mensajes INVITE con (y sin) una configuración de perfiles SIP aplicada. Utilice este método para verificar que las reglas de perfil SIP de la configuración afectan a los cambios correctos y deseados en los mensajes SIP.
Este ejemplo muestra una configuración de ejemplo:
voice class sip-profiles 1 request INVITE sdp-header Audio-Bandwidth-Info add "b=AS:1600“ request ANY sip-header Cisco-Guid remove request INVITE sdp-header Session-Owner modify "CiscoSystems-SIP-GW-UserAgent" "-“
Este ejemplo muestra un mensaje SIP INVITE de ejemplo sin la configuración de perfiles SIP aplicada (los campos destacados se resaltan en negrita):
INVITE sip:2222000020@9.13.40.250:5060 SIP/2.0 Via: SIP/2.0/UDP 9.13.40.249:5060;branch=z9hG4bK1A203F From: "sipp " <sip:1111000010@9.13.40.249>;tag=F11AE0-1D8D To: <sip:2222000020@9.13.40.250> Date: Mon, 29 Oct 2007 19:02:04 GMT Call-ID: 4561B116-858811DC-804DEF2E-4CF2D71B@9.13.40.249 Cisco-Guid: 1163870326-2240287196-2152197934-1290983195 Content-Length: 290 v=0 o=CiscoSystemsSIP-GW-UserAgent 6906 8069 IN IP4 9.13.40.249 s=SIP Call c=IN IP4 9.13.40.249 t=0 0 m=audio 17070 RTP/AVP 0 c=IN IP4 9.13.40.249 a=rtpmap:0 PCMU/8000 a=ptime:20
Este ejemplo muestra el mismo mensaje SIP INVITE de ejemplo con la configuración de perfiles SIP aplicada (los campos modificados se resaltan en negrita):
INVITE sip:2222000020@9.13.40.250:5060 SIP/2.0 Via: SIP/2.0/UDP 9.13.40.249:5060;branch=z9hG4bK1A203F From: "sipp " <sip:1111000010@9.13.40.249>;tag=F11AE0-1D8D To: <sip:2222000020@9.13.40.250> Date: Mon, 29 Oct 2007 19:02:04 GMT Call-ID: 4561B116-858811DC-804DEF2E-4CF2D71B@9.13.40.249 Content-Length: 279 v=0 o=- 6906 8069 IN IP4 9.13.40.249 s=SIP Call c=IN IP4 9.13.40.249 t=0 0 m=audio 17070 RTP/AVP 0 c=IN IP4 9.13.40.249 a=rtpmap:0 PCMU/8000 a=ptime:20 b=AS:1600
Troubleshoot
debug ccsip all es un comando de solución de problemas útil para los perfiles SIP.
En este ejemplo, el texto "voice class SIP Profiles" muestra qué perfil SIP se aplica. A continuación se muestra un ejemplo del resultado del comando:
router#debug ccsip all
…
Oct 12 06:51:53.619: //-1/735085DC8F3D/SIP/Info/sipSPIGetShrlPeer:
Try match incoming dialpeer for Calling number:
: sippOct 12 06:51:53.619:
//-1/735085DC8F3D/SIP/Info/sipSPIGetCallConfig:
Peer tag 2 matched for incoming call
Oct 12 06:51:53.619: //-1/xxxxxxxxxxxx/SIP/Info/sipSPIGetCallConfig:
voice class SIP Profiles tag is set : 1
Oct 12 06:51:53.619: //-1/735085DC8F3D/SIP/Info/sipSPIGetCallConfig:
Not using Voice Class Codec
Oct 12 06:51:53.619: //-1/735085DC8F3D/SIP/Info/sipSPIGetCallConfig:
xcoder high-density disabled
Oct 12 06:51:53.619: //-1/735085DC8F3D/SIP/Info/sipSPIGetCallConfig:
Flow Mode set to FLOW_THROUGH
…
En este ejemplo, el texto "sip_profiles" resalta las modificaciones realizadas por la configuración de perfiles SIP. A continuación se muestra un ejemplo del resultado del comando:
router#debug ccsip all
…
Oct 12 06:51:53.647: //-1/xxxxxxxxxxxx/SIP/Info/
sip_profiles_application_change_sdp_line:
New SDP header is added : b=AS: 1600
Oct 12 06:51:53.647: //-1/xxxxxxxxxxxx/SIP/Info/
sip_profiles_update_content_length:
Content length header before modification :
Content-Length: 290
Oct 12 06:51:53.647: //-1/xxxxxxxxxxxx/SIP/Info/
sip_profiles_update_content_length:
Content length header after modification :
Content-Length: 279
…
Información Relacionada
Historial de revisiones
| Revisión | Fecha de publicación | Comentarios |
|---|---|---|
1.0 |
22-Apr-2008 |
Versión inicial |
ComentariosContacte a Cisco
- Abrir un caso de soporte
- (Requiere un Cisco Service Contract)