Parámetros SIP

El comportamiento general del protocolo SIP en tu instalación

This page has not been translated yet, so you are seeing it in Spanish.

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:

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:

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:
  • udp
  • tcp
  • tls
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

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

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:

¿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.