Parámetros SIP

Permite configurar el comportamiento general del protocolo SIP en Audara

Parámetros Básicos
Parámetros Avanzados
Parámetros Personalizados

Vista general módulo de Parámetros SIP

Estos ajustes controlan cómo se establecen las llamadas, qué dispositivos pueden conectarse y cómo se maneja la comunicación de audio. Esta configuración aplica a nivel general y puede impactar todas las extensiones SIP del sistema.

Desde esta sección puedes:

Definir los codecs de audio permitidos
Controlar el acceso y seguridad SIP
Ajustar tiempos de registro de dispositivos
Configurar el transporte de señalización
Optimizar la calidad de llamadas

Los parámetros están organizados en tres grupos: Básicos, Avanzados, y Personalizados.

Parámetros Básicos

En esta sección se configuran los parámetros fundamentales del comportamiento SIP en Audara.Para facilitar su administración, los parámetros se agrupan por función.

I. Códecs y medios (audio y video)

allow:
Define los codecs de audio permitidos.

disallow:
Bloquea codecs.
Uso común: all para luego permitir solo los necesarios.

preferred_codec_only:
Fuerza el uso exclusivo del codec preferido.

maxcallbitrate:
Limita el ancho de banda máximo por llamada.

videosupport:
Habilita o deshabilita el uso de video.

g726nonstandard:
Activa compatibilidad con variantes no estándar del codec G726.

II. Seguridad y autenticación

allowguest:
Permite conexiones sin autenticación.

alwaysauthreject:
Evita revelar si una extensión existe.

authfailureevents:
Genera eventos cuando falla la autenticación.

auth_message_requests:
Exige autenticación para mensajes SIP.

auth_options_requests:
Exige autenticación para solicitudes OPTIONS.

autocreatepeer:
Crea dispositivos automáticamente al recibir solicitudes.

match_auth_username:
Permite autenticar por nombre de usuario.

domainasrealm:
Usa el dominio como parte del proceso de autenticación.

realm:
Dominio utilizado para autenticación.

checkmwi (implícito en comportamiento MWI):
Controla validaciones de buzón (cuando aplica).

Importante
Desactivar allowguest y autocreatepeer en producción.

III. Red y control de acceso

bindaddr:
IP donde el sistema escucha conexiones SIP.

permit:
Lista de IPs permitidas.

deny:
Lista de IPs bloqueadas.

contactpermit:
Permite contactos según IP.

contactdeny:
Bloquea contactos según IP.

contactacl:
Control adicional sobre direcciones de contacto.

srvlookup:
Permite resolución DNS tipo SRV.

Buenas prácticas
Restringir acceso SIP solo a IPs confiables.

IV. Manejo de llamadas

allowtransfer:
Permite transferencias de llamadas.

allowoverlap:
Permite marcado parcial.

callevents:
Activa eventos de llamadas.

canreinvite (si se gestiona implícitamente):
Controla flujo directo de audio (dependiendo del entorno).

progressinband:
Controla tonos de progreso dentro del audio.

prematuremedia:
Permite media antes de establecer la llamada.

promiscredir:
Permite redirecciones flexibles.

send_diversion:
Envía información de desvío de llamadas.

V. Registro y temporización

defaultexpiry:
Tiempo de registro por defecto.

maxexpiry:
Tiempo máximo de registro.

minexpiry:
Tiempo mínimo de registro.

submaxexpiry:
Máximo tiempo de suscripción.

subminexpiry:
Mínimo tiempo de suscripción.

Recomendación
Valores muy bajos generan tráfico innecesario; muy altos pueden causar desconexiones.

VI. DTMF (tonos)

dtmfmode:
Define cómo se envían los tonos.

Opciones:

rfc2833 (recomendado)
inband
info

relaxdtmf:
Permite mayor tolerancia en la detección de tonos.

VII. Monitoreo y disponibilidad

qualifyfreq:
Frecuencia de verificación de disponibilidad.

qualifygap:
Intervalo entre verificaciones.

qualifypeers:
Controla monitoreo de múltiples dispositivos.

regextenonqualify:
Actualiza estado según disponibilidad.

VIII. Identificación de llamadas

sendrpid:
Envía identificación de llamada.

trustrpid:
Confía en identificación recibida.

rpid_update:
Actualiza identificación durante la llamada.

shrinkcallerid:
Reduce tamaño del identificador.

IX. Música en espera y tonos

mohinterpret:
Define la música en espera utilizada.

mohsuggest:
Sugiere música en espera.

tonezone:
Define la zona de tonos (país).

X. Buzón de voz (MWI)

mwiexpiry:
Tiempo de expiración de notificaciones.

mwi_from:
Origen de notificaciones de buzón.

XI. Mensajería y contexto

accept_outofcall_message:
Controla mensajes fuera de llamada.

outofcall_message_context:
Contexto para esos mensajes.

notifymimetype:
Tipo de contenido en mensajes.

XII. Transporte y conectividad

transport:
Protocolo de transporte:

tcpenable:
Habilita transporte TCP.

tcpbindaddr:
IP para conexiones TCP.

tcpauthlimit:
Límite de autenticaciones TCP.

tcpauthtimeout:
Tiempo de espera en autenticación TCP.

tlsenable:
Habilita transporte TLS.

tlsbindaddr:
IP para TLS.

outboundproxy:
Proxy SIP de salida.

Importante:
Para entornos seguros o WebRTC, usar TLS.

XIII. Calidad de servicio (QoS)

tos_audio / tos_sip / tos_video / tos_text:
Prioridad de tráfico en red.

cos_audio / cos_sip / cos_video / cos_text:
Clase de servicio (nivel de red).

XIV. Compatibilidad y comportamiento SIP

pedantic:
Activa validación estricta de SIP.

compactheaders:
Reduce tamaño de encabezados SIP.

legacy_useroption_parsing:
Compatibilidad con configuraciones antiguas.

dynamic_exclude_static:
Evita conflictos entre dispositivos dinámicos y estáticos.

matchexternaddrlocally:
Controla manejo de direcciones externas.

keepalive:
Mantiene conexiones activas.

XV. Grabación de llamadas

recordonfeature:
Código para iniciar grabación. No usado en Audara.

recordofffeature:
Código para detener grabación. No usado en Audara.

Otros parámetros

useragent:
Identificador del sistema (ej: audara).

disallowed_methods:

Métodos SIP bloqueados.

regcontext:
Contexto de registro dinámico.

refer_addheaders:
Permite agregar encabezados en transferencias.

rtp_engine:
Motor de transmisión de audio.

use_q850_reason:
Incluye códigos de causa en señalización.

user_eq_phone:
Controla formato de numeración.

vmexten:
Extensión de buzón de voz.

Recomendaciones generales

disallow = all
allow = alaw,ulaw
allowguest = no
dtmfmode = rfc2833
Restringir acceso por IP (permit/deny)
Evitar modificar parámetros no comprendidos

💡Nota

La mayoría de estos parámetros no requieren modificación en implementaciones estándar. Se recomienda ajustarlos únicamente cuando exista una necesidad específica y bajo autorización conjunta con el equipo de soporte de Audara.

Parámetros Avanzados

Esta sección contiene configuraciones avanzadas para control fino del comportamiento SIP, incluyendo NAT, media, seguridad, temporización y compatibilidad. Se recomienda modificar estos parámetros solo si se comprende su impacto.

I. Calidad de audio y control de jitter (Jitter Buffer)

jbenable:
Activa el buffer de jitter para estabilizar audio en redes inestables.

jbforce:
Fuerza el uso del buffer incluso si el dispositivo no lo solicita.

jbimpl:
Define el tipo de buffer utilizado.

jbmaxsize:
Tamaño máximo del buffer de jitter.

jbresyncthreshold:
Umbral para resincronización del buffer.

jblog:
Activa registro de eventos del jitter buffer.

jbtargetextra:
Ajuste adicional para el tamaño del buffer.

II. Media directa y flujo de audio

directmedia:
Permite que el audio fluya directamente entre dispositivos sin pasar por el servidor.

directmediaacl:
Lista de control para permitir media directa.

directmediadeny:
Bloquea media directa para ciertas IPs.

directmediapermit:
Permite media directa para ciertas IPs.

directrtpsetup:
Controla establecimiento directo de RTP.

III. Seguridad y cifrado

encryption:
Habilita cifrado de media.

encryption_taglen:
Define longitud de autenticación del cifrado.

avpf:
Activa perfil avanzado de RTP (usado en entornos modernos).

icesupport:
Habilita soporte ICE para negociación de red.

tlsdontverifyserver:
Indica si se valida el certificado del servidor.

tlscipher:
Define cifrados permitidos.

tlscafile / tlscapath:
Ruta de certificados confiables.

tlsclientmethod:
Método TLS utilizado.

IV. NAT y conectividad externa

nat:
Define comportamiento en entornos NAT.

externaddr:
IP pública del servidor.

externhost:
Nombre de host externo.

externrefresh:
Frecuencia de actualización del host externo.

externalport:
Puerto externo.

localnet:
Define redes internas.

media_address:
Dirección usada para media.

V. SDP y negociación de sesión

sdpowner:
Propietario de sesión SDP.

sdpsession:
Identificador de sesión SDP.

ignoresdpversion:
Ignora cambios de versión SDP.

VI. Registro y control de endpoints

registerattempts:
Número de intentos de registro.

registertimeout:
Tiempo de espera para registro.

ignoreregexpire:
Ignora expiración de registro.

subscribe_network_change_event:
Genera eventos al cambiar red.

VII. RTP (audio)

rtptimeout:
Tiempo máximo sin recibir RTP antes de cortar llamada.

rtpholdtimeout:
Tiempo máximo en espera sin RTP.

rtpkeepalive:
Envía paquetes para mantener sesión RTP activa.

rtcachefriends:
Cachea información de dispositivos.

rtupdate:
Actualiza sesiones RTP dinámicamente.

rtautoclear:
Limpia sesiones RTP automáticamente.

rtsavesysname:
Guarda nombre del sistema en RTP.

VIII. Debug y diagnóstico

sipdebug:
Activa depuración SIP.

dumphistory:
Guarda historial de mensajes SIP.

recordhistory:
Registra historial de llamadas SIP.

IX. Dominios y autenticación avanzada

domain:
Dominio SIP.

fromdomain:
Dominio usado en origen.

allowexternaldomains:
Permite dominios externos.

autodomain:
Detecta dominio automáticamente.

X. Sesiones SIP (Timers)

session-expires:
Tiempo máximo de sesión.

session-minse:
Tiempo mínimo de sesión.

session-refresher:
Define quién refresca la sesión.

session-timers:
Activa temporizadores de sesión.

t1min:
Tiempo mínimo de retransmisión.

timerb:
Tiempo máximo de espera de respuesta.

timert1:
Tiempo base de retransmisión.

XI. Subscripciones y notificaciones

allowsubscribe:
Permite suscripciones SIP.

subscribecontext:
Contexto para suscripciones.

notifycid:
Envía identificación en notificaciones.

notifyringing:
Envía estado de timbrado.

notifyhold:
Envía estado de espera.

mailbox:
Asocia buzón de voz.

mwi:
Configuración de notificación de buzón.

XII. Control de llamadas

callcounter:
Cuenta llamadas activas.

Recomendaciones generales

No habilitar media directa si hay NAT complejo.
Configurar correctamente externaddr y localnet en entornos con IP pública.
Mantener desactivado sipdebug en producción.
Usar cifrado solo si todos los dispositivos lo soportan.
Ajustar jitter buffer solo si hay problemas de audio.

💡Nota

Estos parámetros permiten ajustes muy específicos del comportamiento SIP. Una configuración incorrecta puede afectar estabilidad, audio o registro de dispositivos.

Parámetros Personalizados

La sección de Parámetros personalizados permite definir configuraciones SIP adicionales que no están disponibles en las pestañas Básico o Avanzado.

Estos parámetros se agregan manualmente como pares de propiedad / valor, y se aplican directamente a la configuración del dispositivo o troncal.

¿Para qué sirve esta sección?

Permite:

Agregar configuraciones específicas requeridas por proveedores SIP
Ajustar comportamientos avanzados no expuestos en la interfaz
Implementar compatibilidad con dispositivos o escenarios particulares
Aplicar parámetros experimentales o personalizados

¿Cómo agregar un parámetro?

En el campo Propiedad, escribe el nombre del parámetro.

En el campo Valor, define el valor correspondiente.

Haz clic en Guardar.

El parámetro será aplicado junto con el resto de la configuración SIP.