Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Ast e r isk
I n g. Robe r t o Sá n ch e z
V e r sión de l docu m e n t o: 0 .1 2
docum ent o es dar los prim eros pasos en el uso básico de Ast erisk.
I n st a la ción
Pasos a seguir:
1) Ej ecut ar
# t ar - zxvf ast erisk- 1.2.9.1.t ar.gz
# rm - f ast erisk- 1.2.9.1.t ar.gz
# cd ast erisk- 1.2.9.1
Si es la prim era vez que inst ala Ast erisk es recom endable inst alar los ej em plos con
el com ando siguient e:
Se ven m uchos m ensaj es en la pant alla cuando Ast erisk se inicializa. ( las vvv
pert enecen al m odo " very very verbose" y la ´ c´ que m ost rará al final una línea de
com andos en form a consola) ... a m ayor cant idad de “ v” m ayor cant idad de niveles
de logueos se act ivan.
* CLI >
A part ir de est e m om ent o ya est á Ast erisk inst alado y funcionando. Se puede
ut ilizar el com ando " help" para ayuda
Los archivos de configuración de Ast erisk se habrán inst alado en el direct orio
/ et c/ ast erisk donde podrás encont rar m ucha inform ación.
Se configura un soft phone com o el Xlit e, que es grat uit o ( para m ás inform ación
visit ar ht t p: / / www.count erpat h.com ) , para poder acceder al Ast erisk. La
configuración pensada cuent a con dos usuarios que se pueden ut ilizar:
Una vez que se t iene configurado el soft phone, y el usuario se ha regist rado
correct am ent e en el servidor se pu e de lla m a r a a lgu n os n um e r os de pr u e ba
qu e vie ne n por de fe ct o e n e l pla n de n um e r a ción :
Una vez inst alado Ast erisk en Windows o Linux se puede ver con un ej em plo
sencillo de las prim eras cosas que se pueden hacer. Est e ej em plo consist e en crear
dos nuevas ext ensiones con sus buzones de voz.
Por ej em plo los usuarios " 20000" y " 20100" con cont raseñas " a20000b" y
" b20100a"
Para ello se va al archivo sip.conf y se añade las siguient es líneas al final del
archivo:
[ 20000]
t ype= friend
secret = a20000b
qualify= yes
nat = no
host = dynam ic
canreinvit e= no
cont ext = m iprim erej em plo
m ailbox= 20000@m iprim erbuzon
[ 20100]
t ype= friend
secret = b20100a
qualify= yes
nat = no
host = dynam ic
canreinvit e= no
cont ext = m iprim erej em plo
m ailbox= 20100@m iprim erbuzon
Se crean las ext ensiones para esos usuarios en el archivo ext ensions.conf de
m anera que si se m arca el 20000 hablarem os con el usuario 20000 y en cam bio se
m arca el 20100 hablarem os con el usuario 20100. Tam bién se crea el núm ero del
buzón de voz para consult ar los m ensaj es para que sea el 30000.
Más inform ación del archivo ext ensions.conf puede encont rarse en
ht t p: / / www.voipforo.com / ast erisk/ configuracion- sip- conf.php.
Se van a crear lus buzones de voz de am bos usuarios y t am bién a asignarles una
cont raseña en el archivo voicem ail.conf .Al buzón 20000 se le va a dar la
cont raseña 1234 y al buzón 20100 la cont raseña 4321.
[ m iprim erbuzon]
20000 = > 1234,Pedro,pedro@m idom inio.com
20100 = > 4321,Juan,j uan@m idom inio.com
Más inform ación del archivo voicem ail.conf puede verse en los enlaces ( “ links” )
m encionados ant eriorm ent e.
Se configura uno o dos soft phones y se prueba llam ar ent re am bos usuarios o a
dej ar m ensaj es en el cont est ador cuando no est án disponibles. Tam bién se puede
llam ar al núm ero 30000 para escuchar los m ensaj es.
Ar ch ivos im por t a n t e s
El archivo sip.conf sirve para configurar t odo lo relacionado con el prot ocolo SI P y
añadir nuevos usuarios o conect ar con proveedores SI P.
Aquí hay un e j e m plo bá sico del archivo sip.conf com ent ado con la funcionalidad
de cada línea:
[ general]
cont ext = default
port = 5060 ; puert o UDP en el que responderá el Ast erisk
bindaddr= 0.0.0.0 ; Si querem os especificar que Ast erisk est é en una I P ( si un
equipo t iene 3 I Ps por ej .) 0.0.0.0 vale para cualquiera
srvlookup= yes ; habilit a servidor DNS SRV
[ pedro]
t ype= friend ; soport e bidireccional de llam adas.
secret = welcom e ; es el password ( cont raseña) .
qualify= yes ; t iem po de lat encia no superior a 2000 m s.
nat = no ; el t elefono no usa NAT
host = dynam ic ; el disposit ivo se regist ra con una I P variant e
canreinvit e= no ; Ast erisk por defect o t rat a de redirigir. Est o condiciona el paso del
audio por el Ast erisk o sino de ext rem o a ext rem o ( peer t o peer) .
cont ext = int ernal ; el cont ext o al que est á asociado pedro.
El archivo sip.conf com ienza con una sección [ general] que cont iene la
configuración por defect o de t odos los usuarios y " peers" . Se puede sobreescribir
los valores por defect o en las configuraciones de cada usuario o peer.
DNS es una form a de configurar una dirección lógica para que pueda ser resuelt a.
Est o perm it e que las llam adas sean enviadas a diferent es lugares sin necesidad de
cam biar la dirección lógica. Usando el DNS SRV se ganan las vent aj as del DNS
m ient ras que deshabilit andolo no es posible enrut ar llam adas en base a nom bre de
dom inios. Conviene t enerlo act ivado, por t ant o se pone la direct iva srvlookup= yes
Cada ext ensión est á definida por un user o usuario, un peer o proveedor o un friend
o am igo y viene definida con un nom bre ent re corchet es [ ] . El t ipo ( t ype) " user" se
usa para aut ent icar llam adas ent rant es, " peer" para llam adas salient es y " friend"
para am bas. En est e caso se ha definido una ext ensión pedro com o " friend" . Puede
realizar y recibir llam adas.
Secret es la cont raseña usada para la aut ent icación. En est e caso será " welcom e" .
Se puede m onit orizar la lat encia ent re el servidor Ast erisk y el t eléfono con
qualify= yes para det erm inar cuando el disposit ivo puede ser alcanzado En est e
caso Ast erisk considera por defect o que que un disposit ivo est á present e si su
lat encia es m enor de 2000 m s ( 2 segundos) . Se puede cam biar est e valor poniendo
el núm ero de m ilisegundos en vez de yes.
Si se pone host = dynam ic quiere decir que el t eléfono se podrá conect ar desde
cualquier dirección I P. Se puede lim it ar a que dicho usuario solo pueda acceder con
una I P o con un nom bre de dom inio si se pone host = st at ic.
Tam bién en est e ej em plo se ha puest o canreinvit e= no. En SI P los invit es se ut ilizan
para est ablecer llam adas y redirigir el audio o video. Cualquier invit e después del
invit e inicial en la m ism a conversación se considera un reinvit e.
Cuando dos usuarios han est ablecido la com unicación con canreinvit e= yes ( por
defect o) los paquet es RTP de audio podrían ser enviados ext rem o a ext rem o sin
pasar por el servidor Ast erisk. Est o, norm alm ent e, no suele ser convenient e en
casos en los que haya NAT en alguno de los client es ( NAT= yes) .
Usando canreinvit e= no se fuerza a Ast erisk a est ar en m edio no perm it iendo que
los punt os finales int ercam bien m ensaj es RTP direct am ent e.
De t odos m odos, exist en num erosas condiciones en que Ast erisk no perm it e el
reinvit e a pesar de que no pongam os est a condición ya que necesit a cont rolar el
fluj o RTP. Por ej em plo: Si los client es usan codecs diferent es, si hay opciones de
Music On hold o t em porizadores en la llam ada, et c..
Por últ im o cont ext = int ernal indica el cont ext o donde est á las inst rucciones para
dicha ext ensión. Est o est á relacionado con el cont ext o del archivo ext ensions.conf
que m arca el plan de num eración para ese cont ext o. Por t ant o el cont ext o int ernal
debe exist ir en el fichero ext ensions.conf o de lo cont rario deberiam os crearlo.
Varias ext ensiones pueden t ener el m ism o cont ext o.
Opciones avanzadas:
En las siguient es colum nas se t ienen las posibilidades de configuración para los
t ipos " user" y " peer" . En el caso de " friend" valen las dos t ablas ya que un " friend"
es a la vez am bos
Ejemplos típicos:
[grandstream1]
t ype= friend ; es peer y user a la vez
cont ext = m icont ext o ; nom bre del cont ext o
usernam e= grandst ream 1 ; suele ser el m ism o que el t it ulo de la seccion
from user= grandst ream 1 ; sobreescribe el callerid
callerid= Jose Dos< 1234>
host = 192.168.0.23 ; se t iene una I P privada dent ro de una LAN
nat = no ; no hay NAT
canreinvit e= yes ;
dt m fm ode= info ; puede ser RFC2833 o I NFO
m ailbox= 1234@default ; m ailbox 1234 en el cont ext o " default " del fichero
voicem ail.conf
disallow= all ; deshabilit am os t odo
allow= ulaw ; Perm it im os el codec ulaw
; allow= alaw
; allow= g723.1 ; se pueden seleccionar codecs com ent ando los que no se desean
habilit ar
; allow= g729 ;
[xlite1]
; Xlit e m anda paquet es NAT keep- alive, por t ant o qualify= yes no es necesario
t ype= friend
usernam e= xlit e1
callerid= " j uan Perez " < 5678>
host = dynam ic ; el soft phone xlit e puede est ar en cualquier I P
nat = yes ; X- Lit e est á det rás de un disposit ivo NAT
canreinvit e= no ; Se suele poner NO si est á det rás de un disposit ivo que hace NAT
disallow= all
allow= gsm ; GSM consum e m enos ancho de banda que alaw o ulaw
allow= ulaw
allow= alaw
[user1_snomsip]
t ype= friend
secret = blah ; en est e caso es la cont raseña para regist rarse
host = dynam ic
dt m fm ode= inband ; las posibilidades son inband ( en banda) , rfc2833, o info
default ip= 192.168.0.59 ; la I P del disposit ivo
m ailbox= 1234; Cont est ador para m ensaj es
disallow= all
allow= ulaw
allow= alaw
[user2_pingtel]
t ype= friend
usernam e= user2_pingt el
[user3_cisco]
t ype= friend
usernam e= user3_cisco
secret = blah
nat = yes ; El t eléfono est á “ nat eado”
host = dynam ic
canreinvit e= no ;
qualify= 200 ; Tiem po de 200 m s para recibir respuest a
default ip= 192.168.0.4
disallow= all
allow= ulaw
allow= alaw
allow= g729
[user4_cisco1]
t ype= friendusernam e= user4_cisco
from user= pedro ;
secret = blah
default ip= 192.168.0.4 ;
am aflags= default ; Las posibilidades son default , om it , billing o docum ent at ion
account code= pedro ; Para propósit os de t arifación
disallow= all
allow= ulaw
allow= alaw
allow= g729
allow= g723.1
El archivo ext ensions.conf es el m ás im port ant e del Ast erisk y t iene com o m isión
principal definir el dialplan o plan de num eración que seguirá la cent ralit a para cada
cont ext o y por t ant o para cada usuario.
El archivo ext ensions.conf se com pone de secciones o cont ext os ent re corchet es [ ]
Hay dos cont ext os especiales que est án siem pre present es que son [ general] y
[ globals] .
Pueden seguirse los det alles de cada inst rucción de las líneas de los archivos
cot ej ando con los ej em plos list ados luego.
Con t e x t o [ ge n e r a l]
El cont ext o [ ge ne r a l] configura unas pocas opciones generales com o son:
Re st o de Con t e x t os [ ]
Est o es lo m ás im port ent e de est e fichero. Vam os a indicar ahora com o crear un
cont ext o especifico y asignar un plan de num eración. Todas las líneas de un
det erm inado cont ext o t ienen el m ism o form at o:
En est e caso al llam ar al int erno 3000 se usa el com ando Dial ( dest ino, t iem po de
t im eout , opciones)
El dest ino es el usuario 3000 del archivo sip.conf, 30 segundos de t im eout . El
usuario 3000 debería exist ir en sip.conf
las opciones hacen referencia a opciones del com ando dial:
la " T" perm it e al usuario llam ant e t ransferir la llam ada pulsando #
la " t " perm it e al usuario llam ado t ransferir la llam ada pulsando #
la " m " indica que vam os a oir una m úsica especial m ient ras esperam os a que el
ot ro cont est e; para experim ent ar de puede probar a quit arla.
Si el usuario 3000 no est á conect ado salt a a la prioridad + 101 ( en est e caso a la
102= 1+ 101 ya que se est aba en la prioridad 1) y salt a al cont est ador para dej ar un
m ensaj e.
Es im port ant e que por cada ram a siem pre se cierre el cam ino y se cuelgue la
llam ada con un Hangup.
En est e caso llam ando al 600 se va a repet ir lo m ism o que se dij o al hablar. Se
podrá com probar de est a m anera la lat encia del sist em a en form a em pírica.
Ej e m plo 4 : Ex t e n sión st a r t
ext en = > s,1,Wait ,1 ; se espera un segundo.
ext en = > s,2,Answer ; respondem os. El Ast erisk responde la llam ada.
ext en = > s,3,Digit Tim eout ,5 ; se pone Digit Tim eout a 5 segundos.
ext en = > s,4,ResponseTim eout ,10 ; se pone Response Tim eout a 10 segundos.
ext en = > s,5,BackGround( dem o- congrat s) ; se ej ecut a un archivo de voz
ext en = > s,6,hangup ; se cuelga.
En est e caso se present a la ext ensión st art s que es la que t om a las llam adas
cuando se est a en ese cont ext o pero no se sabe la ext ensión. Tam bién se puede
ent rar desde ot ra ext ensión com o en est e caso m arcando la ext ensión 1000. Con
Got o se puede ir al cont ext o, ext ensión y prioridad que se quiera.
En est e caso lo que se hace es que siem pre que se m arque el 340 seguido de
cualquier num ero ( el 340 com o perfij o) llam arem os a una ext ension SI P. Por
ej em plo en el prim er caso si se m arca al 340600600 se llam ará al 600600 a la
dirección I P del " proveedorsip" definido en sip.conf. ( EXTEN: 3 significa que se quit a
los t res prim eros núm eros)
En el segundo caso si se m arca 2060600 t am bién se est ará llam ando al m ism o
núm ero 600600 del " proveedorsip" ( EXTEN: 2)
En los casos ant eriores el “ .” sust it uye a cualquier caract er pero se podía haber
ut ilizado t am bién
X - Acept a un núm ero de 0 al 9
Z - Acept a un núm ero de 1 al 9
N - Acept a un núm ero de 2 al 9
[ 1,5- 7] - Acept a el 1, el 5, el 6 o el 7