08 Asterisk-Configuracion

Asterisk
Configuracin
Primeros Pasos Poder hablar entre 2 extensiones SIP

Una vez que asterisk est instalado, podemos configurar los archivos necesarios. En este caso seleccionamos como protocolo (de sealizacin) a SIP. Es necesario: configurar los dispositivo SIP (en sip.conf) Configurar un plan de marcacin bsico (en extensions.conf Todos estos archivos de configuracin de Asterisk, se encuentran en el directorio /etc/asterisk
Julin Dunayevich, Lzaro Baca, Andrs Brassara
Primeros pasos Configuracin de dispositivo (SIP) (sip.conf)

[pedro] ;Nombre del usuario type=friend ;Permite generar y recibir ;llamados secret=drope ;Clave de pedro host=dynamic ;El telfono puede tener una ip ;dinmica context=internos; El contexto asocia el usuario ;al plan de numeracin
Primeros pasos Plan de marcacin (extensions.conf)
[internos] exten => 101,1,Dial(SIP/pedro) exten => 101,2,Hangup()
Primeros pasos Lab 1
Laboratorio 1: Interconectar 2 telfonos utilizando el protocolo de sealizacin SIP
Archivos de configuracin
Asterisk se configura desde mltiples archivos de configuracin, cada uno para una determinada rea. Los ms importantes son:

Archivo de configuracin maestro: asterisk.conf Archivo de configuracin de mdulos: modules.conf Archivos de configuracin de canales:
iax.conf: canales IAX (Inter Asterisk eXchange). sip.conf: canales SIP. zaptel.conf/system.conf: telefona analgica y digital. h323.conf: canales H323. mgcp.conf: canales MGCP. unicall.conf: canales R2
Configuracin bsica de Asterisk
Asterisk puede ser configurado desde varios puntos. Los ms importantes son:
desde
el propio CLI desde los archivos de configuracin (.conf) en /etc/asterisk
La configuracin se carga al iniciar Asterisk, por lo que para aplicar cualquier cambio ser necesario recargarla. Para ello basta con ejecutar el comando reload en el CLI:
CLI> reload
Archivos de configuracin
Dialplan: extensions.conf: el propio Dialplan. features.conf: dialplan para mtodos. complementarios (transferencias, call parking, grabacin de llamadas bajo demanda, etc.). Configuracin de aplicaciones del dialplan: meetme.conf: para salas de conferencias. musiconhold.conf: config. de la msica en espera. queues.conf: configuracin de colas de llamadas. voicemail.conf: configuracin de los buzones de voz.
Comunicacin entre dispositivos

Configuracin
de los canales: Parmetros generales. Definicin de canales. del plan de marcacin: Definicin de contextos. Configuracin de extensiones.
Configuracin
SIP.CONF: seccin general

En primer lugar existe la seccin [general], donde se definen variables globales y aspectos por defecto para todos los canales SIP.
La
sintaxis es la siguiente: [general] variable1=valor1 variable2=valor2 .... register => usuario : password @ servidorregistrar register => ....
SIP.CONF: seccin general Register
Register permite a Asterisk registrar su presencia en el otro extremo. De esta forma, el proveedor sabr la localizacin del cliente. En ningn caso es suficiente para poder hacer llamadas. El comando Register slo es necesario si:
1. 2.
Se necesita ser llamado (lo cul implica ser localizado). Se aparece en el otro extremo con una configuracin de IP dinmica.
SIP.CONF: seccin general

Las variables generales ms importantes son: allow y disallow: indican los codecs permitidos / no permitidos. dtmfmode: especifica el mtodo por el cual se enviarn los tonos (dgitos pulsados durante la conversacin); inband/rfc2833/info nat: informa a Asterisk el tipo de NAT en el que se encuentra; yes/no/never/route externip: direccin pblica si esta atrs de un NAT. context: contexto por defecto donde entrarn las llamadas entrantes por SIP. port: puerto en el que escuchar (5060 ).
SIP.CONF: type
user: enva llamadas a Asterisk. peer: recibe llamadas de Asterisk. friend: recibe y enva llamadas.
La sintaxis para definir un type es:

[nombre] ; contexto type = friend / peer / user variable1 = valor variable2 = valor ....
SIP.CONF: variable de canales

Las variables ms importantes son: type: peer / friend context: contexto donde entrarn las llamadas generadas. nat: indica si el usuario o peer se encuentra tras un NAT. host: IP remota o dynamic (en el caso en que la IP no sea fija). username: nombre de usuario. secret: contrasea de acceso en texto plano. allow y disallow: configuraciones de codecs especficas para cada peer / friend. qualify: evala el estado del extremo SIP para conocer su accesibilidad y latencia (tener cuidado si el otro extremo no esta configurado para responder). canreinvite: permite que el trfico de voz pase por el asterisk o bien directamente entre las partes.
SIP.CONF: Ej.1 Canal in/out

[pepe] ; usuario pepe type=friend secret=clavepepe context=interno host=dynamic nat=yes
SIP.CONF: Ej.2 de Canal in/out

[juan] type=friend secret=clavejuan callerid="juan perez" <1002> context=internos host=dynamic nat=yes canreinvite=no disallow=all allow=gsm allow=ulaw mailbox=1002@default
SIP.CONF: Ej.3 de Canal saliente

[sip.internetcalls.com] type = peer host = sip.internetcalls.com username = miusuario secret = miclave dtmfmode = rfc2833 disallow = all allow = g729 allow = g726
SIP.CONF: Ej.3 de Canal entrante

[miDID] type = user host = miDID.com secret = miclave dtmfmode = rfc2833 disallow = all allow = g729 allow = gsm context=interno
sip.conf
[pepe] ; usuario type=friend ; IN/OUT secret=pepin ; clave context=internos ; rela dial plan callerid="pepe perez" <1001> host=dynamic ; IP del device nat=yes ; soporte NAT device canreinvite=no ;disallow=all ;allow=gsm ;allow=ulaw ;allow=alaw mailbox=1001@default [juan] type=friend secret=juanin callerid="juan perez" <1002> context=internos host=dynamic nat=yes canreinvite=no ;disallow=all ;allow=gsm ;allow=ulaw ;allow=alaw mailbox=1002@default
extensions.conf
[internos] exten => 101,1,Dial(SIP/pepe) exten => 101,2,Voicemail(1002,u) exten => 101,3,Hangup() exten => 101,102,Voicemail(1002,b) exten => 101,103,Hangup() exten => 102,1,Dial(SIP/juan,10) exten => 102,2,Voicemail(1002,u) exten => 102,3,Hangup() exten => 102,102,Voicemail(1002,b) exten => 102,103,Hangup() exten => 850,1,VoiceMailMain
Ejercicio: iax.conf
[juan] host=dynamic type=friend transfer=no disallow=all allow=gsm allow=ulaw secret=juanin context=internos qualify=yes [pedro] host=dynamic type=friend transfer=no disallow=all allow=gsm allow=ulaw secret=clavepedro context=internos qualify=yes
Ejercicio: voicemail.conf
[default] 1001 => 4242,Juan 1002 => 4242,Pepe
SIP.CONF: verificacin con el CLI
Mediante el comando reload en el CLI de Asterisk, se indica que recargue la configuracin. Aunque es posible recargar de forma independiente slo la conf. SIP:
CLI> sip reload
Una vez recargada, puede comprobarse los users que se han definido con el comando: sip show users Para ver los peers definidos: sip show peers Es importante notar que los friends son peers y users a la vez, ya que pueden recibir y enviar llamadas. Puede consultarse si Asterisk se ha registrado correctamente en los registars configurados en la seccin general con el comando: sip show registry Pueden verse los canales sip activos (comunicaciones activas), va el comando: sip show channels
Aplicaciones en el dialplan: IAX.CONF

En el archivo IAX.CONF se definen todos los enlaces que se establecern usando el protocolo IAX. El archivo IAX.CONF tiene la misma estructura que el SIP.CONF: una seccin general y otras por canales. IAX tiene pequeas diferencias que sern explicadas a continuacin.
IAX.CONF: Ej. Canal in/out

[juan] type=friend secret=miclave qualify=yes port=4569 transfer=no host=dynamic context=interno callerid=device <1234> El valor transfer=no es el equivalente a canreinvite=no del sip.conf, hace que el servidor Asterisk quede situado en medio de la comunicacin entre clientes.
IAX.CONF: Ej. Canal in/out

[itsp] ; saliente type=peer qualify=yes host=189.146.226.134 [itsp-in] ; entrante type=user host=189.146.226.134 context=interno
Separa la definicin del canal entrante y del saliente.

IAX.CONF: Trunking
El protocolo IAX permite el trunking de llamadas, es decir, que mltiples streams de voz compartan un nico trunk con otro servidor, reduciendo el overhead creado por los paquetes IP. Luego de 4 llamadas concurrentes comienza a haber ganancia de ancho de banda.
Para pasar un canal IAX a modo trunk, incluir en la definicin del archivo iax.conf: trunk=yes
EXTENSIONS.CONF
El archivo extensions.conf es la parte central de toda la configuracin, dado que es donde se define el dialplan de Asterisk. Se compone de 4 partes principales: contextos, extensiones, prioridades y aplicaciones.
EXTENSIONS.CONF: CONTEXTOS
El dialplan se divide en secciones denominadas contextos, que estn rotuladas y contienen un grupo de extensiones. Los contextos se definen colocando su nombre entre corchetes ([]). Este nombre puede contener caracteres alfanumricos adems del guin y el guin bajo. Por ej: [interno] Todas las instrucciones son parte del contexto hasta que el prximo contexto es definido. Existen dos contextos especiales: [general] (variables predefinidas) y [globals] (variables no predefinidas).
EXTENSIONS.CONF: EXTENSIONES
Una extensin es una instruccin que ser seguida por Asterisk, luego de ser disparada por una llamada entrante o bien por dgitos discados en un canal, definida en el marco de un contexto. La sintaxis de una extensin es la siguiente: exten => nombre,prioridad,aplicacion() Ejemplo: exten => 123,1,Answer()
EXTENSIONS.CONF: EXTENSIONES
Extensin s (start): es una extensin especial que es utilizada si una llamada entra a un contexto sin una extensin destino especfica (por ejemplo una llamada en un puerto FXO); la llamada trata de entrar automticamente a la extensin s.
exten => s,1,Answer()
EXTENSIONS.CONF: PRIORIDADES

Una extensin puede tener varios pasos, denominados prioridades. Las prioridades comienzan con 1 y se ejecutan en orden numrico. Si no existe la prioridad N + 1, Asterisk no salta a la siguiente prioridad (N+2). Cada prioridad ejecuta una nica aplicacin. Ejemplo: exten => 123,1,Answer() exten => 123,2,Hangup()
EXTENSIONS.CONF: PRIORIDADES
Prioridades sin numerar: Asterisk introduce el uso de la prioridad n (next). Cada vez que Asterisk encuentra una prioridad n, toma el nmero de la prioridad anterior y le suma 1. Simplifica el proceso de escritura del dialplan, evitando tener que volver a numerar las prioridades al insertar una prioridad para la misma exten. Ejemplo: exten => 123,1,Answer() exten => 123,n,hago algo exten => 123,n,Hangup()
Prioridades n
exten => 555,1,Answer() exten => 555,n(LlamaPepe),Dial(SIP/pepe,20) exten => 555,n,Voicemail(44) exten => 555,n,Hangup ;Va a n+101 en caso de que el canal est ocupado: exten => 555,LlamaPepe+101,Voicemail(44,u) ;Tambin puede tener una etiqueta esta prioridad: exten => 555,LlamaPepe+101(PepeNoDisponible),
Prioridades n
exten => _044.,1,Answer exten => _044.,n(Director),GotoIf($[${CALLERID( num)} = pepe]?LlamaCelular:) exten => _044.,n,Set(TIMEOUT(absolute)=300) exten => _044.,n(LlamaCelular),Dial(Zap/1Dahdi/1/${EX TEN}) exten => _044.,n,Hangup
EXTENSIONS.CONF:APLICACIONES
Las aplicaciones realizan una accin determinada en el canal actual, controlando el comportamiento de la llamada y del sistema en s. Algunos ejemplos: Answer(): contesta una llamada. Hangup(): cuelga una llamada. Dial(): realiza una llamada saliente. Playback(): reproduce un archivo de sonido. Ciertas aplicaciones requieren del pasaje de parmetros, estos se incluyen dentro de los parntesis, separados por ,.
Nuestro primer dialplan: hola mundo!!

Definir
canal SIP. Definir pasos para llamadas entrantes: Contestar la llamada. Reproducir un archivo. Colgar la llamada.
El primer dialplan: agregar las extensiones

Aplicaciones: Answer(), Playback() y Hangup() Cmo hacer un dialplan? Answer() constesta un canal al que est entrando una llamada. No toma ningn argumento. Playback() reproduce un archivo previamente grabado. Recibe como parmetro el nombre del archivo sin extensin, el archivo debe estar en /var/lib/asterisk/sounds Hangup() cuelga el canal actual.
dialplan: extensions.conf
[interno] exten => 100,1,Answer( ) exten => 100,2,Playback(hello-world) exten => 100,3,Hangup( )
Ms aplicaciones
Background(). Similar a playback, pero si el usuario presiona dgitos, la aplicacin lo captura y trata de enviarlo a la extensin presionada. exten => 123,1,Background(hello-world)
Goto(). Nos permite mandar una llamada a otro contexto, extensin y prioridad: exten => 123,1,Goto(contexto,extension,prioridad)
Agregar lgica al dialplan: Background()

[interno]
exten => 101,1,Answer( ) ; contesta la llamada exten => 101,2,Background(enter-ext-of-person) ; espera digitos y pasa a la extension en el mismo contexto exten => 1,1,Playback(digits/1) ; reproduce el dgito 1 exten => 2,1, Playback(digits/2) ; reproduce el dgito 2
Agregar lgica al dialplan: Goto()

[interno] exten => 4000,1,Answer( ) exten => 4000,2,Background(enter-ext-of-person) exten => 1,1,Playback(digits/1) exten => 1,2,Goto(4000,1) ; vuelve al inicio de la extension 4000 exten => 2,1, Playback(digits/2) exten => 2,2,Goto(4000,1)
Si se pasa 1 argumento a Goto(), se asume que es la prioridad dentro de la misma extensin, si se pasan 2, se asume que es otra extensin y la prioridad en el mismo contexto, y si se pasan 3, se asume que es un contexto diferente, extensin y priorida al que se quiere enviar la llamada.
Manejo de entradas invlidas y timeouts
Cuando el usuario teclea una entrada invlida, la llamada es enviada a la extensin i. Cuando el usuario no teclea ninguna opcin, es necesario tener una extensin que nos permita manejar esta situacin. Por defecto, si no se teclea nada despus de 10 segundos de haberse terminado de reproducir el archivo la llamada es enviada a la extensin t. Si se teclea un digito, espera 5 segundos hasta el siguiente, o numeral (#) para terminar de tipear numeros.
Agregar extensin i y t
[interno]
exten => 4000,1,Answer( ) exten => 4000,2,Background(enter-ext-of-person)

exten => 1,1,Playback(digits/1) exten => 1,2,Goto(4000,1) exten => 2,1, Playback(digits/2) exten => 2,2,Goto(4000,1) exten => i,1,Playback(pbx-invalid) ; llega en caso de digito invalido exten => i,2,Goto(4000,1) exten => t,1,Playback(vm-goodbye) ; llega en caso de no recibir digitos luego de un tiempo (10 seg) exten => t,2,Hangup()
Flujo en el dialplan: flujo con salto de prioridades
Aplicacin Dial()

Permite conectar 2 ms canales. Es especialmente til cuando los dispositivo usan tecnologas diferentes(SIP,IAX,etc). Puede tomar hasta 4 parmetros:
El
primero es el destino de la llamada en el formato tecnologia/canal (Sip/juan, Iax2/180, Zap/1Dahdi/1) exten => 4002,1,Dial(Sip/juan) Se puede hacer que la llamada suene en varios canales a la vez exten => 4002,1,Dial(Sip/juan&Zap/1Dahdi/1&Iax/4010)
Aplicacin Dial()
El segundo argumento es el tiempo que se intentar llamar al destino. Si en ese tiempo no contestan, se pasa a la siguiente prioridad. Si no se especifica este parmetro, la llamada contina marcando el canal, hasta que el canal es contestado o hasta que el emisor de la llamada cuelga. exten => 102,1,Dial(Sip/juan,10) Si el usuario donde est sonando la llamada contesta antes de 10 segundos, se conectan ambos dispositivo y el dialplan termina. Si el usuario no contesta se contina en la siguiente prioridad. Si el canal al que se quiere comunicar est ocupado, Dial() salta a la prioridad n+101, si es que existe.
Ejemplo de Dial
[interno] exten => 4002,1,Dial(Sip/juan,10) exten => 4002,n,Playback(vm-nobodyavail) ; no contesto exten => 4002,n,Hangup() exten => 4002,102,Playback(tt-allbusy) ; por ocupado exten => 4002,n,Hangup()
Aplicacin Dial()
El tercer parmetro es una cadena que puede estar compuesta por varios caracteres que brindan algunas caractersticas especficas al momento de hacer la llamada. Algunos ejemplos: T. Permite que quien llama pueda transferir la llamada con # t. Permite que quien contesta pueda transferir la llamada con # r. Genera un ring tone al que llama y espera a generar el canal de audio cuando conteste. m. A diferencia de r, genera msica en espera. w. Permite al que llama grabar la comunicacion con *1 En CLI, core show application dial, muestra todas las opciones de Dial()
Llamar a los canales declarados

[interno] exten => 4000,1,Answer( ) exten => 4000,2,Background(enter-ext-of-person) exten => 4001,1,Dial(Sip/juan,10) exten => 4001,2,Playback(vm-nobodyavail) exten => 4001,3,Hangup() exten => 4001,102,Playback(tt-allbusy) exten => 4001,103,Hangup()
exten => 4002,1,Dial(Iax2/4010,10) exten => 4002,2,Playback(vm-nobodyavail) exten => 4002,3,Hangup() exten => 4002,102,Playback(tt-allbusy) exten => 4002,103,Hangup() exten => i,1,Playback(pbx-invalid) exten => i,2,Goto(4000,1) exten => t,1,Playback(vm-goodbye) exten => t,2,Hangup() Julin Dunayevich, Lzaro Baca, Andrs Brassara
Aplicacin Dial()
exten => 123,1,Dial(Zap/4Dahdi/4/2235980)
Llama va el canal nmero 4 de ZapDahdi al nmero especificado 2235980
Variables
En el dialplan de Asterisk existen variables, que pueden ser modificadas por el propio Asterisk en su ejecucin lgica o por comandos expresos (aplicaciones) del dialplan. Las variables reducen la escritura, agregan claridad al dialplan y le aportan lgica. Los tipos de variables son: Globales: declaradas en extensions.conf (o por comando). Canal: asociadas con un canal particular. Entorno: variables de entorno (UNIX Like). La sintaxis de una variable es: ${variable}
Manejo de variables
Asignacin de variables:
Set(Variable=valor)
Global(Variable=valor)
Manejo de cadenas:
Subcadenas:
${Variable : offset : longitud }
Devuelve la subcadena de variable que comienza en offset y con la longitud especificada. Ejemplos: ${123456789:2:3} devuelve 345
Longitud:
${LEN(Variable)} Concatenacin: ${Variable1}${Variable2}

Variables globales
Permite que se pueda hacer referencia a ellas en todos los contextos, en todas las extensiones, a diferencia de las variables convencionales que slo tienen validez en el canal actual. Es til para tener claridad manejabilidad en el dialplan. Se pueden definir en el contexto [globals] al inicio de extensions.conf
[globals]
JUAN=Sip/juan PEDRO=Iax2/4010
Agregar variables al dialplan

[globals] JUAN=Sip/juan PEDRO=Iax2/4010 ; define la variable JUAN
[interno] exten => 4000,1,Answer( ) exten => 4000,2,Background(enter-ext-of-person) exten => 4001,1,Dial(${JUAN},10) ; hace referencia a la variable JUAN exten => 4001,2,Playback(vm-nobodyavail) exten => 4001,3,Hangup() exten => 4001,102,Playback(tt-allbusy) exten => 4001,103,Hangup()
Agregar variables al dialplan

exten => 4002,1,Dial(${PEDRO},10) exten => 4002,2,Playback(vm-nobodyavail) exten => 4002,3,Hangup() exten => 4002,102,Playback(tt-allbusy) exten => 4002,103,Hangup() exten => i,1,Playback(pbx-invalid) exten => i,2,Goto(4000,1) exten => t,1,Playback(vm-goodbye) exten => t,2,Hangup()
Variables de canal definidas automticamente
Listado de variables ms importantes:

${CALLERID}:
caller ID actual, nombre y nmero. ${CONTEXT}: contexto actual. ${EXTEN}: extensin actual. ${CHANNEL}: canal actual. ${DIALSTATUS}: estado de la llamada: unavailable, congestion, busy, noanswer, answer, cancel, hangup. ${DATETIME}: hora actual.
Un comando til para ver el contenido es NoOp:

NoOp
( ${VARIABLE} )
Mostrar en el CLI el valor.
Variable ${EXTEN}
Permite saber cul es la extensin que fue marcada. Se utiliza comunmente para eliminar dgitos marcados: ${EXTEN:x}
Si x es positivo, quita los primeros x dgitos marcados exten => _XXX,1,SayDigits(${EXTEN:1}) Si x es negativo, devuelve los ltimos x dgitos marcados exten => _XXX,1,SayDigits(${EXTEN:-1})
Patrones

Se utilizan principalmente para llamadas salientes. Comienzan con el signo _ Le dicen a Asterisk que haga match con un patrn y no con un nmero de extensin. X. Hace match con cualquier dgito de 0 a 9. Z Hace match con cualquier dgito de 1 a 9. N Hace match con cualquier dgito del 2 al 9. [15-7] Hace match con el rango de dgitos especificados, en este ejemplo matchea los nmeros 1,5,6,7. . (punto) Hace match con uno o mas caracteres.
exten => _NXX,1,Playback(auth-thankyou)
Si Asterisk encuentra ms de 1 patrn para una extensin marcada, se usa la ms especfica: exten => _555XXXX,1,Playback(digits/1) exten => _55512XX,1,Playback(digits/1)
Habilitar salida de llamadas

Se generan contextos especificos para llamadas locales a la PSTN. Con ello se regula y controla quines tienen permiso de hacer llamadas y qu tipo de llamadas pueden hacer: [globals] JUAN=Sip/juan PEDRO=Iax2/4010 TRUNKDESALIDA=Zap/1Dahdi/1 [llamadas-locales] exten => _9NXXXXXX,1,Dial(${TRUNKDESALIDA}/${EXTEN}:1) exten => _9NXXXXXX,2,Congestion() exten => _9NXXXXXX,102,Congestion() [llamadas-larga-distancia] exten => _901XXXXXXXXXX,1,Dial(${TRUNKDESALIDA}/${EXTEN}:1) exten => _901XXXXXXXXXX,2,Congestion() exten => _901XXXXXXXXXX,102,Congestion()
Include

Puede utilizarse un contexto dentro de otro contexto a travs de la directiva include Permite habilitar derechos de acceso a las diferentes secciones del dialplan. Por ejemplo, que los dispositivo del contexto [internos] puedan hacer llamadas por la red PSTN
include => context
Primero trata de encontrar las extensiones en el contexto actual. Si no la encuentra, trata de encontrarla en el primer contexto incluido, y despus en el segundo y as sucesivamente.
Agregar include al dialplan
[internos] include => llamadas-locales include => llamadas-larga-distancia
Manipulacin de expresiones y variables
Las expresiones son una combinacin de variables, operadores y valores que arrojan un resultado. Sintaxis: $[expr1 operador expr2] Operadores lgicos: |(or) , &(AND) Operadores de comparacin: =, !=, <, >, <=, >= Operadores aritmticos: +, -, *, /, % [...] , Ejemplo: exten => 4003,1,Set(COUNT=3) exten => 4003,2,Set(NEWCOUNT=$[${COUNT} + 1]) exten => 4003,3,SayNumber(${NEWCOUNT})
Bifurcacin condicional

Permite tomar desiciones dentro del dialplan. Aplicacin GotoIf() GotoIf(expresion1?destino1:destino2) Si la expresin evaluada es verdadera, la llamada es enviada a destino1, de lo contrario es enviada a destino2. Una cadena vaca y el nmero 0 son evaluados con falso, cualquier otro valor es verdadero. Cualquiera de los destinos puede ser omitido, pero debe estar alguno de los 2. Si el destino omitido es el camino que debe seguir la llamada, el flujo que se sigue es la siguiente prioridad dentro de la extensin actual.
Ejemplo de GotoIf()
exten => 104,1,Set(TEST=1) exten => 104,2,GotoIf($[${TEST} = 1]?10,20) exten => 104,10,Playback(weasels-eaten-phonesys) exten => 104,20,Playback(office-iguanas) exten => 105,1,Set(COUNT=10) exten => 105,2,GotoIf($[${COUNT} > 0 ]?:10) exten => 105,3,SayNumber(${COUNT}) exten => 105,4,Set(COUNT=${COUNT} - 1) exten => 105,5,Goto(2) exten => 105,10,Hangup()
exten => 106,1,GotoIf($[${CALLERIDNUM} = 8842374]?20:10) exten => 106,10,Dial(Sip/Juan) exten => 106,20,Playback(abandon-all-hope) exten => 106,21,Hangup()
Bifurcacin condicional basada en tiempo

Verifica la hora actual del servidor, permitiendo tomar decisiones basadas en tiempo. Se utiliza cuando se quiere dar una bienvenida diferente en horarios de trabajo y fuera de trabajo.
GotoIfTime(hora,dias_de_semana,dias_del_mes,meses?etiqueta)
Enva la llamada a etiqueta si la fecha y hora actual concuerdan con el criterio especificado por los parmetros.
Bifurcacin condicional basada en tiempo

hora. Lista de uno o ms rangos de horario en formato de 24 horas. 09:00-17:00 dias_de_semana. Lista de uno o ms das de la semana mon, tue dias_del_mes. Da numrico del mes 7-12,15 meses. Lista de uno o ms meses del ao jun, apr, jul * Matchea con cualquier valor Etiqueta puede ser una prioridad dentro de una misma extensin, una prioridad y extensin dentro del mismo contexto o un contexto, extensin y prioridad. Exten => s, 1, GotoIfTime(*,*,2, nov?open,s,1) ; se enva al contexto open, extensin s, prioridad 1
Correo de voz

Se permite un nmero ilimitado de buzones. Notificacin por correo: Puede anexar el mensaje de voz (.wav) Indicador luminoso o seal de mensaje en espera. Indicador auditivo de mensaje en espera al levantar el telfono. Manejo de mensajes va telefnica. Los contextos de voicemail son definidos de igual manera que en dialplan.
Correo de Voz

mailbox => password, nombre [,e-mail [, pager-email [, opciones]]] mailbox: nmero de mailbox, generalmente asociado al nmero de extensin. password: clave numrica del buzn. nombre: nombre del propietario del buzn. Se utiliza para permitir incorporar en el directorio de Asterisk. e-mail: correo electrnico adonde se enva la notificacin. pager-email: correo electrnico para enviar la notificacin. Opciones: hay varias como attach=yes Voicemail() enva al emisor al buzn especificado para dejar un mensaje. El nmero de buzn puede ser proseguido por la letra b o u. Con la letra b, se le informa al emisor que el usuario est ocupado. Con u que no esta disponible.
voicemail
Voicemail.conf
[default] 4001
=> 1234,Juan Perez,juan@dominio.com,
Extensions.conf
exten
=> 4001,1,Dial(${JUAN},10) ; hace referencia a la variable JUAN exten => 4001, 2,voicemail(4001@default,u) exten => 4001,102,voicemail(4001@default,b)
Acceso al buzn de voz

Exten
=> *98, 1, voicemailMain()
Sala de conferencias

Permite crear conferencias protegidas por clave. Administrar conferencias. Callar o expulsar a un miembro de la conferencia. Crear conferencias estticas (en el meetme.conf). Crear conferencias dinmicas (utilizando el plan de marcacin). Meetme.conf [rooms] Conf => 600 extensions.conf exten => 600,1,meetme(600, i, 54321) Se anuncia cuando alguien entra o sale de la conferencia. exten => 601,1,playBack(conf-thereare) exten => 601,2,meetmeCount(600) exten => 601,3, playBack(conf-peopleinconf)
Interconexin entre Asterisk IAX
Una conexin IAX entre dos Asterisk se establece en los siguientes pasos: Configurar en ambos servidores el archivo iax.conf, uno como peer y otro como user. - Modificar el dialplan del user para que se puedan efectuar llamadas desde el user al peer. - En el caso que la IP sea dinmica, se debe registrar el peer con el user. - Repetir los pasos anteriores en la direccin opuesta (intercambiar peer y user), para que ambos pueden enviar y recibir llamadas. En el prximo ejemplo se conectarn dos servidores Asterisk A y B, de manera tal que ambos puedan llamarse entre s, utilizando autenticacin con clave simtrica.
IAX Autenticacin con clave simtrica

Configuracin para el servidor A: iax.conf [serverB_in] type=user ; llamadas del serv B al * auth=md5 secret=passwordA context=from-iax ; conexto que entran las llamadas de B [serverB_out] type=peer host=serverB.domain.com auth=md5 secret=passwordB username=serverA_in
La seccin [serverB_in] permite al servidor A recibir llamadas por parte del servidor B. El user indicado por el servidor B debe hacer match con el nombre de esta seccin. En secret se indica el password para realizar la autenticacin y en context el contexto al cul sern derivadas las llamadas entrantes del servidor B va este canal. La seccin [serverB_out] permite al servidor A realizar llamadas al servidor B. En host se debe indicar la direccin IP o nombre DNS del servidor B, o bien, la palabra dynamic si la IP es dinmica. En este timo caso, el peer debe realizar un comando register para poder ser localizado por el cliente. extensions.conf exten => _7XXX,1,Dial(IAX2/serverB_out/${EXTEN:1},30) exten => _7XXX,2,Congestion Esta configuracin permite que al discar 7XXX en el servidor A, se haga una llamada al servidor B con ese nmero pero quitndole el prefijo 7.

Configuracion para el servidor B: iax.conf [serverA_in] type=user auth=md5 secret=passwordB context=from-iax [serverA_out] type=peer host=serverA.domain.com auth=md5 secret=passwordA username=serverB_in extensions.conf exten => _8XXX,1,Dial(IAX2/serverA_out/${EXTEN:1},30) exten => _8XXX,2,Congestion
IAX Autenticacin con RSA
El protocolo IAX2 soporta autenticacin fuerte con claves de encripcin asimtricas, utilizando RSA. Esto permite tanto la autenticacin de un usuario con Asterisk como tambin la de Asterisk con algn proveedor. La generacin de claves RSA es realizada con la utilidad astgenkey provista por Asterisk. Para crearlas simplemente ejecutar en la lnea de comandos: # astgenkey n nombre_clave Se generarn dos archivos nombre_clave.pub y nombre_clave.key en el directorio actual. Estas claves deben copiarse a /var/lib/asterisk/keys, dado que all Asterisk busca las claves para realizar la autenticacin.
IAX Autenticacin con RSA: Ej
En este caso, el proveedor (peer) slo recibe llamadas. En el archivo iax.conf del mismo se debe colocar la siguiente informacin del usuario para permitir la autenticacin del cliente:
[usuario_in] type=user auth=rsa inkeys=clave_usuario context=from-iax
En el valor inkeys, se debe poner el nombre de la clave pblica del usuario. Esta clave debe copiarse previamente al proveedor.
Asimismo, en este caso, el cliente (user) slo realiza llamadas. En el archivo iax.conf del mismo se debe colocar la siguiente informacin del usuario para permitir la autenticacin con el proveedor:
[proveedor_out] type=peer host=proveedor.dominio.com auth=rsa outkey=clave_usuario username=usuario_in
En el valor outkey, se debe poner el nombre del set de claves del usuario.
Los siguientes comandos del CLI estn relacionados con el manejo de claves:
init
keys: inicializa las claves RSA y pregunta por las passphrases si es necesario. show keys: muestra informacin sobre las claves RSA instaladas.
Curso elaborado por Jlian Dunayevich, Lzaro Baca, Andrs Brassara y Santiago Alberch julian@dunayevich.com lazaro.baca@gmail.com abrassara@gmail.com salberch@gmail.com
Detalles de la licencia: http://creativecommons.org/licenses/by-nc-sa/2.5/deed.es_AR Autores: Julin Dunayevich, Lzaro Baca, Andrs Brassara, Santiago Alberch (cc) Creative Commons - Attribute Non-Commercial Share-Alike 2.5
Basndose en: Irontec: contacto@irontec.com (CC)
Asterisk, The Future of Telephony, Jim Meggelen, Jared Smith, and Leif Madsen, OREILLY, 2005

08 Asterisk-Configuracion

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

08 Asterisk-Configuracion

Cargado por

Copyright:

Formatos disponibles

Asterisk

Primeros Pasos Poder hablar entre 2 extensiones SIP

Primeros pasos Configuracin de dispositivo (SIP) (sip.conf)

Primeros pasos Plan de marcacin (extensions.conf)

[internos] exten => 101,1,Dial(SIP/pedro) exten => 101,2,Hangup()

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Primeros pasos Lab 1

Laboratorio 1: Interconectar 2 telfonos utilizando el protocolo de sealizacin SIP

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Configuracin bsica de Asterisk

el propio CLI desde los archivos de configuracin (.conf) en /etc/asterisk

Comunicacin entre dispositivos

SIP.CONF: seccin general

SIP.CONF: seccin general Register

SIP.CONF: seccin general

Julin Dunayevich, Lzaro Baca, Andrs Brassara

La sintaxis para definir un type es:

SIP.CONF: variable de canales

SIP.CONF: Ej.1 Canal in/out

Julin Dunayevich, Lzaro Baca, Andrs Brassara

SIP.CONF: Ej.2 de Canal in/out

SIP.CONF: Ej.3 de Canal saliente

SIP.CONF: Ej.3 de Canal entrante

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Julin Dunayevich, Lzaro Baca, Andrs Brassara

[default] 1001 => 4242,Juan 1002 => 4242,Pepe

Julin Dunayevich, Lzaro Baca, Andrs Brassara

SIP.CONF: verificacin con el CLI

Aplicaciones en el dialplan: IAX.CONF

Julin Dunayevich, Lzaro Baca, Andrs Brassara

IAX.CONF: Ej. Canal in/out

IAX.CONF: Ej. Canal in/out

Separa la definicin del canal entrante y del saliente.

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Nuestro primer dialplan: hola mundo!!

Julin Dunayevich, Lzaro Baca, Andrs Brassara

El primer dialplan: agregar las extensiones

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Agregar lgica al dialplan: Background()

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Agregar lgica al dialplan: Goto()

Manejo de entradas invlidas y timeouts

Julin Dunayevich, Lzaro Baca, Andrs Brassara

exten => 4000,1,Answer( ) exten => 4000,2,Background(enter-ext-of-person)

Flujo en el dialplan: flujo con salto de prioridades

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Julin Dunayevich, Lzaro Baca, Andrs Brassara

Llamar a los canales declarados

Llama va el canal nmero 4 de ZapDahdi al nmero especificado 2235980

Julin Dunayevich, Lzaro Baca, Andrs Brassara

${Variable : offset : longitud }

${LEN(Variable)} Concatenacin: ${Variable1}${Variable2}

Agregar variables al dialplan

Agregar variables al dialplan

Variables de canal definidas automticamente

Listado de variables ms importantes:

Un comando til para ver el contenido es NoOp:

Mostrar en el CLI el valor.

Julin Dunayevich, Lzaro Baca, Andrs Brassara