Asterisk
========

Acá hay algunas notas sobre Asterisk pero no mucho más.

Para iniciar/parar el servidor::

  service asterisk status
  service asterisk start
  service asterisk stop
  service asterisk restart
  service asterisk reload

Tipos de usuario
----------------

- user: Solo llamadas salientes
- peer: Solo llamadas entrantes
- friend: Entradas salientes y entrantes

Otras opciones para el usuario
------------------------------

- ``canreinvite``: Permite que las conexiones RTP de audio ocurran punto a punto
  entre los usuarios, si se desactiva pasan por el servidor, si se activa
  generalmente va por el servidor pero generalmente va punto a punto.

- ``qualify``: Algo del retardo, no se.

- ``nat``: Indica si el usuario esta atrás de un NAT.

Configuración
-------------

Tiene un montón de archivos de configuración en ``/etc/asterisk``. Los que más
importan me parece que son:

- ``/etc/asterisk/asterisk.conf``: Es el archivo principal pero no tiene nada
  interesante.

- ``/etc/asterisk/extensions.conf``: Establece cómo serán manejadas y ruteadas
  las llamadas entrantes y salientes.

- ``/etc/asterisk/sip.conf``: Configuración para los canales SIP.

extensions.conf
~~~~~~~~~~~~~~~

Este archivo establece cómo serán manejadas y ruteadas las llamadas entrantes y
salientes. Es muy largo, tiene varias secciones:

- ``[general]``: Define algunas opciones generales.

- ``[globals]``: Acá se pueden definiar variables globales que se podrán usar en
  otros contextos.

- Las demás secciones son contextos, llevan el nombre entre corchetes.

Acá pongo varias definiciones teóricas:

- Dialplan: Es el conjunto de contextos.

- Contexto: Permite separar funcionalidades, cada contexto tiene extensiones.

- Extensión: Es un conjunto de aplicaciones que se ejecutarán cuando el número
  de esa extensión es marcado.

- Aplicación: Es una acción.

Los usuarios se colocan en contextos (puede que en más de un contexto al mismo
tiempo), y los contextos pueden incluir a otros contextos.

La sintaxis de la extensión es simple pero se complejiza cuando se empiezan a
usar variables y ese tipo de cosas. Sintaxis general:: 

  exten => number,priority,application([parameter[,parameter2...]])

El ``number`` indica el número a marcar para que se ejecute esta extensión,
``priority`` indica el orden a usar al ejecutar varias extensiones con el mismo
número. Ejemplo que llama al número 1234 cuando se marca 5000::

  exten => 5000,1,Dial(SIP/1234,20)
  exten => 5000,2,Hangup()

Una configuración normal sería la que pongo ahora::

  [general]
  ; por razones de seguridad
  static = yes
  writeprotect = yes

  [default]
  ; poner un echotest al llamar al numero 999
  exten => 999,1,Answer()
  exten => 999,n,Playback(demo-echotest)
  exten => 999,n,Echo()
  exten => 999,n,Playback(demo-echodone)
  exten => 999,n,Hangup()

  [internos]
  ; incluir al contexto default y permitir llamar a numeros que sean 1XX.
  ; 30s de timeout. "Tt" permite transferir llamadas y el "m" pone musica.
  include => default
  exten => _1XX,1,Dial(SIP/${EXTEN},30,Ttm)
  exten => _1XX,n,Hangup()

Si la extensión empieza con ``_`` el número será interpretado como un patrón
donde por ejemplo ``X`` vale por cualquier dígito entre 0 y 9. En vez de numerar
las prioridades se puede poner prioridad ``1`` al primero y después poner los
siguientes en ``n``.

``${EXTEN}`` es una variable que se reemplaza por el ``number`` de la extensión,
es útil para cuando este número consiste de un patrón.

sip.conf
~~~~~~~~

Este archivo configura los canales SIP. Lo que nos interesa es registrar acá a
todos los usuarios. La sección ``[general]`` se aplica a todos los usuarios,
luego se pueden hacer templates para usuarios similares::

  [general]
  context=default
  ; bindport=5060
  ; bindaddr=0.0.0.0
  udpbindaddr=0.0.0.0:5060 ; Escuchar en todas las IP, puerto 5060
  tcpbindaddr=0.0.0.0:5060 ; Escuchar en todas las IP, puerto 5060
  tcpenable=no
  transport=udp ; Transporte por defecto
  srvlookup=yes
  ; registertimeout=20 ; Si el registro demora más de 20ms se da de baja al usuario o algo así

  [estandar](!)
  type=friend
  context=internos
  disallow=all ; Deshabilitar todos los codecs
  allow=ulaw ; Habilitar codec
  allow=gsm
  host=dynamic ; IP dinamica
  canreinvite=no ; Impide a los usuarios hacer conexiones RTP punto a punto sin
                 ; pasar por el servidor, si se pone en "no" va a pasar todo por
                 ; el servidor
  qualify=300 ; Cortar si la latencia es mayor a 300ms
  nat=no ; No dar tratamiento especial para nat, puede que funcione igual

  [101](estandar)
  callerid=Martin <101> ; No tiene ningun formato en especial, se le pone el numero porque queda lindo
  secret=password101

  [102](estandar)
  callerid=Juan <102>
  secret=password102

  [103](estandar)
  callerid=Francisco <103>
  secret=password103

Si ``type`` es ``friend`` el usuario puede enviar y recibir llamadas, también es
posible utilizar ``user`` para permitir sólo llamadas entrantes o ``peer`` para
sólo llamadas salientes.