Friends¶

La sección Amigos permite a los administradores de empresa conectar su PBX virtual con otras centralitas SIP por medio de trunks SIP. El caso de uso habitual es el de conectar IvozProvider a otra centralita SIP de la empresa, otra sede, etc.

Advertencia

Es importante entender la diferencia entre los Contratos de peering definidos por el operador de marca para conectar con la red pública y los Amigos, definidos por el administrador de empresa para conectar su PBX con otras PBXs.

¿Qué permite?¶

Esta sección permite comunicar los usuarios de ambos extremos del trunk SIP, pero también permite:

Que los usuarios del “otro lado” llamen a la red pública igual que los Usuarios nativos.
Que llamadas de la red pública se puedan dirigir a usuarios del otro extremo del trunk SIP

Tipos de amigos¶

Se pueden unir 2 tipos de centralitas SIP a IvozProvider:

Centralitas con conectividad directa: Esto implica que IvozProvider tiene la posibilidad de hablar SIP directamente sin más que dirigir su tráfico a una IP pública a un puerto concreto.
Centralitas tras NAT, no accesibles directamente. Este tipo de centralitas tendran que registrarse en IvozProvider (exactamente igual que lo hacen los Terminales).

¿Qué llamadas se envían al friend?¶

IvozProvider tiene que saber qué llamadas envía por los distintos friends que se definan. Para ello, el administrador de empresa definirá por medio de tantas expresiones regulares como desee los destinos que son alcanzables por medio del amigo.

Nota

Las extesiones internas tienen prevalencia sobre las expresiones regulares de los friends.

Es decir, IvozProvider encamina una llamada recibida por un usuario o por un amigo aplicando esta lógica:

¿Coincide con una extensión definida en la sección Extensiones?
Si no, ¿coincide con alguna expresión regular vinculada a alǵun friend?
Si no, se considera una llamada externa.

Configuración¶

La configuración de un Amigo es una fusión de la configuración de un Usuario y un Terminal.

Consejo

La equivalencia Amigo <-> Usuario es tal, que los Amigos hablarán SIP con el Proxy de Usuarios.

Estos son los parámetros a configurar a la hora de definir un amigo:

Nombre: Nombre del Amigo, equivalente al nombre del Terminal. Se utiliza en los mensajes SIP (From User enviado).
Descripción: No se utiliza más que para describir el amigo
Prioridad: Sirve para resolver conflictos a la hora de dirigir llamadas hacia un amigo u otro. Si una llamada matchea expresiones regulares más de un friend, se encaminará la llamada al que tenga menor valor de prioridad.
Contraseña: Cuando el friend nos envíe peticiones, IvozProvider le autenticará utilizando esta contraseña. Es obligatorio el uso de contraseña.
Conectividad directa: En caso de seleccionar ‘Sí’, se pedirá el protocolo, la IP y el puerto en el que se puede contactar con el friend.
Permisos de llamada: Un friend, al igual que un usuario interno, puede llamar a usuarios internos (todo lo que esté en Extensiones + Friends). Además, puede llamar a los destinos externos que permita este parámetro (igual que los usuarios).
DDI de salida alternativo: Este DDI se empleará si el mostrado por el friend no coincide con ninguno de la compañía.
Código de país y Area Code: Las cabeceras de origen/destino se esperarán y enviarán en estos formatos.
Codecs rechazados/permitidos: Al igual que un Terminal, un friend habla el codec seleccionado.
From domain: IvozProvider utilizará este valor en el From Domain de las peticiones al friend.

Nota

Las llamadas a los friends no atraviesan ACLs. Es decir, se consideran internas, por lo que todos los usuarios/amigos pueden llamar a todos los usuarios/amigos.

Configuración Asterisk remoto¶

Al otro lado puede haber entidades SIP muy diversas, pero añadimos la configuración ejemplo para conectar IvozProvider con una centralita Asterisk:

register¶

En caso de no estar directamente visible, el Asterisk tendrá que registrarse en IvozProvider (al igual que hacen los terminales).

La configuración sería tal que:

register => friend-name:friend-password@ivozprovider-company.sip-domain.com

peer¶

[nombre-friend]
type=peer
host=ivozprovider-company.sip-domain.com
context=XXXXXX
disallow=all
allow=alaw
defaultuser=friend-name
secret=friend-password
fromdomain=ivozprovider-company.sip-domain.com
insecure=port,invite

Advertencia

El friend no puede desafiar a IvozProvider, al igual que un terminal no desafía a IvozProvider cuando éste le llama. De ahí el insecure.

Resumen final¶

Lo vital para entender esta sección es pensar que un friend tiene una relación directa con el trío extension-usuario-terminal:

Puede realizar llamadas a todas las extensiones internas y a otros amigos.
Pueden realizar las llamadas que le permita su grupo de permisos.
Presentan el DDI saliente que tengan configurado en sus llamadas salientes.
No desafían a IvozProvider (no hay autenticación SIP en las peticiones hacia ellos).
Responden a los desafíos de IvozProvider (hay autenticación SIP obligatoria en las peticiones desde ellos).
Hablan al Proxy de usuarios, igual que los terminales. De hecho, el tráfico SIP de una llamada de un friend es indistinguible al tráfico SIP de una llamada de un terminal.