Nella telefonia analogica ci sono due tipi di interfacce (e due tipi di segnalazioni): FXS e FXO

- FXS (Foreign eXchange Station) è la porta che consegna la linea analogica all’utente (la presa sul muro che fornisce il segnale dalla centrale) e quindi prodice il dial-tone.

- FXO (Foreign eXchange Office) è la porta che riceve la linea analogica (la presa sull’apparecchio telefonico) e quindi riceve il dial-tone.

E’ possibile utilizzare la linea analogica che abbiamo a casa con il nostro centralino Asterisk sfruttando una scheda Digium TDM410 (o analoghe) mostrata in figura

Questo tipo di scheda prevede l’espandibilità fino a 4 linee FXS o FXO. In particolare questa ha montato un modulo FXO (colore rosso) sulla porta 4 e un modulo FXS (colore verde) sulla porta 1.

Dalle cose dette prima quindi, sul modulo FXS (verde) che invia il dial-tone, va attaccato un apparato con porta FXO che riceve il dial-tone (telefono, fax, etc), mentre la porta FXO (rossa) va attaccata sulla presa FXS da cui arriva il segnale della centrale (presa muro).

Linea digitale ISDN (BRI/PRI)

Una linea ISDN (Integrated Services Digital Network) viene fornita all’utenza mediante due tipi di connessione verso la centrale pubblica: Basic Rate Interface (BRI) e Primary Rate Interface (PRI). Entrambi Primary Rate Interface e Basic Rate Interface sono costituiti da un certo numero di canali B e D canali. B Channel o il Canale Portatore è utilizzato per la trasmissione dei dati, tra cui voce e il canale D è destinato per la segnalazione e controllo. LA differenza sta nel numero di canali di tipo B:

BRI: 2 canali B da 64 Kbps e 1 canale D da 16 Kbps

PRI: può essere di tipo E1(utlilzzato in Europa e in Australia) o T1 (utlilzzato in Nord America e Giappone).

- PRI E1 –> 30B + D con un bit rate totale di 2,048 Mbit / s

- PRI T1 –> 23B + D con un bit rate totale di 1,544 Mbit / s

La linea telefonica digitale utilizza la tecnica TDM (Time Division Multiplexing) per far passare su un unico flusso più chiamate contemporaneamente.

Di seguito una scheda Digium E1/T1 utilizzabile con Asterisk:

Configurazione DAHDI e Asterisk

Ci sono due file di configurazione da modificare per far funzionare le schede analogiche e digitale con Asterisk.:

- /etc/dahdi/system.conf

- /etc/asterisk/chan_dahdi.conf

— system.conf —

La configurazione hardware viene fatta nel file system.conf

# configurazione relativa al flusso primario
span=1,1,0,ccs,hdb3,crc4 #una riga per ogni flusso: span1,…span2,..
bchan=1-15 #15 canali bearer
dchan=16 #1 canale di controllo
bchan=17-31 #15 canali bearer
# configurazione relativa alla linea analogica
fxoks=32
fxsks=35
# configurazione relativa ad entrambe
loadzone=it
defaultzone=it
echocanceller=mg2,1-15,17-31,32,35

Attenzione alla configurazione delle linee analogiche: nella configurazione devo specificare non il tipo di porta ma il tipo di segnale che mi aspetto. Nel nostro caso i canali liberi per la scheda analogica in figura sono (visto che i primi 31 sono occupati dal primario):  32 (porta 1),33 (porta 2), 34 (porta 3), 35 (porta 4). In particolare:

- sulla porta 1 (canale 32) c’è il modulo verde FXS e quindi mi aspetto un segnale FXO (fxoks=32)

- sulla porta 4 (canale 35) c’è il modulo rosso FXO e quindi mi aspetto un segnale FXS (fxsks=35)

La riga span…

span=Span number,Timing,Line Build Out, Framing, Line Coding

A parte il promo valore che si incrementa per ogni primario che installiamo, il valore a cui dobbiamo fare attenzione è il Timinig (il clock): dovrà essere 0 se collegato al Telco mentre dovrà essere 1 se collegato al centralino.

NB: Dopo ogni modifica fatta al file system.conf va eseguito il comando: dahdi_cfg -vv

— chan_dahdi.conf —

[channels]

group=1
context=local
signaling=fxo_ks ;segnalazione che si aspetta –> ci attacco il telefono
callerid=”Bob Analog”<6003>
mailbox=”6003″
callwaiting=yes
threewaycalling=yes
transfer=yes
channel => 32

group=2
context=from_outside
signaling=fxs_ks ; segnalazione che si aspetta –> ci attacco la linea
callerid=asrecived
callwaiting=mp
channel => 35

group=3
echocancel=yes
echocancelwhenbridge=no
echotraining=yes
switchtype=euroisdn
context=from_outside
signalling=pri_cpe
channel => 1-15
channel => 17-31

Ciascun canale DAHDI (system.conf) può essere assegnato a uno o più channel group (chan_dahdi.conf). E’ necessario utilizzare il numero del gruppo nell’applicaziond Dial():

exten => 123,1,Dial(DAHDI/g2/06555444)

In questo caso su sta utilizzando la linea analogica.

Se scrivo

exten => 123,1,Dial(DAHDI/g1/06555444)

utilizzo il flusso primario. Ma quale sarà il canale occupato? In questo caso (g) i canali verranno occupati in maniera sequenziale (1,2,3,…) ma posso scegliere anche:

l’ordine inverso (G): exten => 123,1,Dial(DAHDI/G1/06555444)

l’ordine casuale (round-robin) ascendente (r) : exten => 123,1,Dial(DAHDI/r1/06555444)

l’ordine casuale (round-robin) dicendente (R) : exten => 123,1,Dial(DAHDI/R1/06555444)

- allowguest (sip.conf)

Il file di configurazione sip.conf  che si ottiene dopo l’installazione del sistema contiene la direttiva “allowguest” che di default (complimenti a quelli della digium ) permette di fare le chiamate senza autenticazione (quindi inventando direttamente lo username…). Questo può avviene quando si utilizza unicamente il contesto di default. Settare quindi il parametro allowguest=no.

- i contesti (sip.conf, extension.conf e chan_dahdi.conf)

E’ importante capire come funzionano i contesti di ingresso e di uscita e fare in modo che siano assolutamente isolati tra loro. La cosa fondamentale è che in un contesto di ingresso delle chiamate non ci sia la possibilità di farne in uscita. Verificare quindi che il contesto di default sia sicuro e non permettere agli utenti non autenticati (nel caso ci sia allowguest=yes) di raggiungere contesti in cui sono permesse chiamate a pagamento.

- alwaysauthreject (sip.conf)

Impostando alwaysauthreject = yes quando qualcuno cerca di connettersi a un interno esistente sbagliando la password non verrà comunicata se l’interno esiste o no e la risposta sarà la stessa usata per un interno inesistente.

- password

Utilizzare password complesse per le utenze SIP. E’ sempre consigliabile usare un mix di simboli, numeri, lettere maiuscole  e lettere minuscole.

- limit-call

Impostare su ciascuna utenza SIP il numero massimo di chiamate contemporanee che l’utente può  fare (se non ci sono particolari esigenze si può impostare limit-call=1)

E’ possibile anche utilizzare software di terze parti…Per esempio Fail2ban , un IDS che attraverso la scansione dei file di registro blocca, utilizzando iptables, i tentativi di registrazione falliti.

Un altro sistema simile al precedente è quello di utilizzare le AGI (degli script esterni richiamabili dal dialplan di Asterisk) che possono essere eseguite in base al verificarsi di certi eventi…

Supponiamo il caso di avere un primario (30 canali) di cui sappiamo che generalmente non viene mai usato più del 50% delle sue capacità. Quindi contemporaneamente non abbiamo mai più di 15 chiamate (tra ingresso e uscita). E’ possibile tramite dialplan fare un controllo del numero di canali occupati contemporaneamente (utilizzando le funzioni GROUP() e GROUP_COUNT() ) e nel caso  questo valore superi una certa soglia, richiamare un AGI che invii un email (o faccia qualsiasi altra cosa tipo bloccare la porta 5060 tramite iptables) che ci avvisi di quello che sta succedendo. Qui di seguito viene riportato come fare questa cosa:

nel file extension.conf

exten => _X.,1,Set(GROUP()=limit)

exten => _X.,2,Noop(${GROUP_COUNT(limit)})

exten => _X.,3,GotoIf($[${GROUP_COUNT(limit)} > 15]?108)

exten => _X.,4,Dial(DAHDI/g1/${EXTEN})

exten => _X.,108,AGI(outgoingcalls.sh)

exten => _X.,109,Busy

exten => _X.,110,Hangup

#!/bin/bash

echo -e “There are more than 15 simultaneous outgoing calls.\n\n\nOutput of ‘tail /var/log/asterisk/cdr-csv/Master.csv:\n\n`tail /var/log/asterisk/cdr-csv/Master.csv`” | mail -s “[ALERT] – Too many outgoing calls from asterisk-pbx” name@domain.com

distinguiamo due tipi di variabili:

• variabili di canale (Channel variables)
• variabili globali (Global vairables)

L’utilizzo delle variabili permette di avere un dialplan più chiaro e semplice da gestire. La sintassi che permette di recuperare il valore di una variabile è ${VARIABILE}. Le variabili sono case sensitive!!!

Le variabili di canale settate da Asterisk sono tutte maiuscole è quindi utile, per evitare “duplicati”, creare variabili con caratteri minuscoli.

Channel variables

Le variabili di canale contengono valori associati con un determinato canale. Sono definite per tutta la durata della chiamata corrente e disponibili solo per il canale che partecipa a quella determinata chiamata. Per settare il valore di una variabile di canale si usa l’applicazione Set(): exten =>123,n,Set(count=3)

Global vairables

Le variabili globali sono disponibili on qualsiasi punto del Dialplan, in qualsiasi chiamata e in qualsiasi contesto. Vengono definite nella sezione [globals] del dialplan.

[globals]
Tom=SIP/ts_xlite
…
nel dialplan:
exten => 601,1,Dial(${Tom})

E’ possibile definire queste variabili anche con l’applicazione Set() all’interno del dialplan aggiungendo però il parametro “g”: Set(count=3,g)

VALORE DELLA VARIABILE {$DIALSTATUS}

- CHANUNAVAIL : canale non disponibile
- CONGESTION
- NOANSWER
- ANSWER
- BUSY
- CANCEL

Esempio: untilizzo delle label non numeriche

exten => 601,1,NoOp(Calling Tom)
exten => 601,n,Dial(${Tom},30)
exten => 601,n,Goto(${DIALSTATUS})
exten => 601,n(NOANSWER),1,Voicemail(601@default,u)
exten => 601,n,Hungup()
exten => 601,n(BUSY),Voicemail(601@default,b)

VALORE DELLA VARIABILE {$EXTEN}

Questa variabile contiene il valore del numero che è stato chiamato:

exten => _XXX,1,SayDigits ({$EXTEN})

Asterisk permette con facilità di manipolare la lunghezza delle variabili:

{$VARIABILE:x} –> x: numero di digits da rimuovere a partire dall’inizio della stringa

• ES: se il valore di {$EXTEN} è 12345, il valore di  {$EXTEN:1} è 2345

{$VARIABILE:-x} –> x: numero di digits da rimuovere a partire dalla fine della stringa

• ES: se il valore di {$EXTEN} è 12345, il valore di  {$EXTEN:-1} è 1234

Si possono anche estrarre parti della stringa utilizzando la sintassi: ${variabile:skip:length}

• ES: se il valore di {$EXTEN} è 12345678, il valore di  {$EXTEN:3:3} è 456 (salto i prime tre e prendo i tre caratteri che seguono

.

L’Applicazione Read()

A volte è possibile voler prendere delle delle informazioni dall’utente e processare tali dati. L’applicazione Read() permette di prendere in input i DTMF (toni della tastiera telefonica) e assegnarli ad una variabile. Questa funzione chiede all’utente di digitare sulla tastiera dei valori e li inserisce dentro una determinata variabile. L’inserimento termina quando scade il timeout o quando l’utente digita “#”. ES:

exten => 621,1,Read(Digits,enter-ext-of-person)
exten => 612,n,SayDigits(${Digits})
exten => 612,n,Goto(1)

Pattern Matching

Il pattern matching inizia sempre con il carattere _ (underscore)

X -> 0-9

N -> 2-9

Z -> 1-9

Range di numeri possono essere descritti racchiudendoli tra parentesi quadre:

_[0-5] matcha numeri tra 0 e 5

Il punto matcha qualsiasi cosa (anche le estenzioni speciali tipo “i”, “h”, etc)-> _.

E’ preferibile usare _X

SIP Service Provider Account

[AGGIORNATO CON ALTRO ESEMPIO]

Si trovano su Internet moltissimi siti che offrono servizio di VoIP Provider.
E’ possibile utilizzare Asterisk sia per quei provider che forniscono solo un numero entrante, sia per quelli che permettono chiamate in uscita e naturalmente per quelli che ti danno entrambe questi servizi.

Asterisk distingue nella configurazione del file sip.conf l’attivazione dei tre tipi di servizi sopra indicati in modo differente.

type=peer –> può solo inviare chiamate

type=user –> può solo ricevere chiamate

type=friend –> può inviare e ricevere

user e peer hanno delle opzioni specifiche che hanno funzionalità differenti, il friend le eredita entrambe. In generale utilizziamo il friend quando uno user agent (per es. un soft phone) si registra ad asterisk, usiamo un peer quando è asterisk che si registra a qualcuno e gestisce le chiamate in uscita, useremo uno user quando dobbiamo ricevere delle chiamate da qualcuno esternamente quando è sempre asterisk che si registra (o quando vogliamo che l’user agnt possa sopo ricevere). In pratica quelli che si comportano come interni saranno dei friend, i trunk saranno dei peer/user.

PEER

Quando si definisce un peer tra [  ] si dovrà mettere un nome che è puramente indicativo e non indica il suo username; il campo host ha lo scopo di specificare dove inviare le chiamate (sarà sempre l’ip del Provider e non sarà dynamic poichè è lui che deve registrare). A differenza dell’ “user” il “peer” non prevederebbe il context, che definisce l’arrivo delle chiamate, visto che può solo uscire. E qui le cose si complicano perchè invece si può utilizzare poichè c’è un’eccezione gestita da asterisk, dove, se non vede uno user abbinato al peer usa il context definito dal peer stesso. Questo molto spesso ci evita di definire lo user e di usare il peer per gestire entrambe le cose, anche se può portare confusione

(I peers) hanno invece il campo “host” per specificare dove inviare le chiamate.

Il “peer” ha un campo username e password dove viene definito lo username e la password che permettono l’autenticazione con il peer remoto. (Nota che quando definisci uno user lo username va dentro le parentesi quadre, mentre quando definisci un peer lo username va messo nel campo username)

Per inviare le chiamate al peer SIP si possono  usare le seguente sintassi:

Dial(SIP/extension@peername) <– il peername è quello tra parentesi quadre:

o

Dial(SIP/peername/extension) <– l’extension è il numero che voglio chiamare

Per inviare le chiamate al peer IAX si può  usare solo al seguente sintassi:

Dial(IAX2/peername/extension)

La registrazione

Se il tuo IP è dinamico o il tuo provider non conosce il tuo indirizzo IP, è necessario registrarsi periodicamente con il server in modo tale che il tuo provider possa sempre conoscere l’indirizzo a cui inviare le chiamate. Per fare questa cosa si deve utilizzare (sia in sip.conf che in iax.conf) il comando “register”

Sintassi:

register => user[:secret]@host[:port][/extension]

Esempio register => nome:password@voipprovider.com

USER

Esempio base:

[test] <– sezione
type=user
secret=password
context=incoming <– Quando arriva la chiamata per l’utente “test” la chiamata viene inviata nel contesto specificato (in questo caso incoming)

network options: E’ possibile permettere o bloccare un range di IP con i comandi “permit” e deny”:

[test]
type=user
secret=password
context=incoming
deny=0.0.0.0/0
permit=192.168.1.5
permit=192.168.2.100
permit=10.16.5.0/24
permit=172.16.100.0/255.255.255.0

codec options: E’ possibile specificare quali e in quale ordine usare determinati codec

[test]
type=user
secret=password
context=incoming
disallow=all
allow=gsm
allow=ulaw

FRIENDS

Un friend è sia un user che un peer

I friends sono una semplice scorciatoia per configurare degli endpoint (telefoni IP). Sono anche utilizzati per i più comuni sip provider (sipgate, sipcall, Gizmo, messagnet)

Altri SIP Provider (come per esempio Eutelia) vogliono come configurazione user e peer separati

Per uno user, Asterisk non richiede l’autenticazione username/password se non è presente la voce “secret=”. Per un friend generalmente dobbiamo specificare una “secret” per le nostre connessioni in uscita. Se il friend è un Provider Voip questo prima di instaurare la connessione manda un invite ad Asterisk il quale a questo punto si aspetta un autenticazione da parte del provider per poter terminare la sissione SIP. Chiaramente nessun provider invia questa informazione. Per questo motivo è possibilie utilizzare il seguente comando per saltare l’autenticazione:

insecure=invite,port (vedi anche questo link)

Esempio TRUNK SIP

Vediamo come configurare i trunk SIP. E’ importante ricordarsi che la registrazione va fatta alla fine del contesto [general]

sip.conf

;*******************************************
;*** GLOBAL SETTING

[general]
;context=default

context=from_outside ; –questo è il context che sta in extensions.conf vale solo per le  chiamate sip in ingresso a meno che non sia specificato un context nel peer o nello user –;
realm=class.digium.com
bindport=5060
bindaddr=0.0.0.0
srvlookup=yes
disallow=all
allow=ulaw
allow=gsm
language=en

;*******************************************
;*** REGISTER STATEMENTS

register => training1:training@192.168.1.100

;*******************************************
;*** FRIENDS, USER AND PEERS…

[6001]
type=friend
host=dynamic
secret=zoiper
context=users
mailbox=6001@default

[6002]
type=friend
host=dynamic
secret=polycom
context=users
mailbox=6002@default

[to_sipprovider]
type=peer
username=training1
fromuser=training1
fromdomain=example.com
secret=training
canreinvite=no
insecure=invite,port
host=192.168.1.100
deny=0.0.0.0/0
permit=192.168.1.100
disallow=all
allow=gsm
allow=ulaw
allow=alaw
qualify=yes
nat=no

NB: il comando insecure=invite,port viene utilizzato perchè Asterisk generalmete richiede la peer di inviargli le credenziali per poter accettare la chiamata ma non tutti i provider mandano tali informazioni. Con questo comando si dice ad Asterisk di non fare tali richieste ed accettare le chiamate in ingresso.

extension.conf


;*******************************************
;*** GLOBAL SETTING FOR EXTENSION

[general]
static=yes
writeprotect=no
autofallthrough=yes
clearglobalvars=no
priorityjumping=no

;*******************************************
;*** GLOBAL SETTING FOR variables

[globals]

;*******************************************
;*** EXTENSION CONTEXT

[from_outside]
include => inside

[users]
include => inside
include => features

[inside]
exten => 6001,1,Dial(SIP/6001,20)
exten => 6001,n,VoiceMail(6001@default)

exten => 6002,1,Dial(SIP/6002,20)
exten => 6002,n,VoiceMail(6002@default)

[features]
exten => 6599,1,Answer()
exten => 6599,n,Playback(hello-world)
exten => 6599,n,wait(2)
exten => 6599,n,Playback(good-evening)
exten => 6599,n,Hangup()
exten => 6598,1,Goto(demo-menu,s,1)

exten => 6601,1,Goto(day-menu,s,1)

;per ascoltare i messaggi
exten => 6500,1,Answer()
exten => 6500,n,VoiceMailMain(@default)

;Outbound extension
exten => 6700,1,Dial(SIP/6000@to_sipprovider)

;Record The Day Menu
exten => 6600,1,Answer()
exten => 6600,n,Wait(0,5)
exten => 6600,n,Record(day-menu.gsm)
exten => 6600,n,Wait(1)
exten => 6600,n,Playback(day-menu)

[demo-menu]

…

[day-menu]

…

IAX2 ITSP Account

Nel file iax.conf aggiungere (dove sono già esistenti e commentati gli esempi di register) la seguente riga:


register => training1:training@192.168.1.100


Per quanto riguarda l’inserimento dell’user account utilizziamo (invece del friend) due utenze separate per chiamate in uscita (peer) e chiamate in ingresso (user):


[to_iaxprovider]
username=training1
secret=training
type=peer
auth=md5
transfer=no
host=192.168.1.100
disallow=all
allow=gsm
allow=ulaw
allow=alaw
qualify=yes
trunk=yes

[training1]
type=user
auth=md5
transfer=no
disallow=all
allow=gsm
allow=ulaw
allow=alaw
secret=training
context=from_outside

In extensions.conf aggiungiamo la chiamata verso il provider IAX


[features]
...
;Outbound extension
exten => 6700,1,Dial(SIP/6000@to_sipprovider)
exten => 6701,1,Dial(IAX2/to_iaxprovider/6000)
...

[AGGIORNAMENTO]

Vediamo un altro esempio in cui il nostro Provider ci fornisce un account voip basato sul proxy sip OpenSER

Dati forniti dal Provider


username: 655
password: pwd655
sip proxy: sip.provider.net

configurazione sip.conf

[general]
language=it
registerattempts=0
registertimeout=80

context=default                 ; Default context for incoming calls

…

register => 633:pwd633@sip.provider.net/633

…

[6001]
;type=user
type=friend
host=dynamic
secret=zoiper
context=supercall

[to_sip]
type=peer
context=from_provider_voip ;per le chiamate in ingresso
username=633
fromuser=633 ;serve per sovrascrivere lo username (qui sarebbe 6001)
secret=pwd633
host=sip.provider.net
fromdomain=sip.provider.net
qualify=yes
insecure=invite,port

se non viene indicato il context allora verrà considerato quello indicato nella sezione general (in questo caso quello di default)

configurazione extension.conf

Vogliamo che le chiamate entranti dall’account VoIP vengano inoltrate sull’interno 6001 e che solo quest’ultimo possa utlizzare il provider in uscita mettendo come prefisso 88

[local]
exten => _600X,1,Dial(SIP/${EXTEN},20)

…

[to_provider_voip]
exten => _88X.,1,Dial(SIP/${EXTEN:2}@to_sip)

…

[from_provider_voip]
exten => 633,1,Dial(SIP/6001,20)

…

[supercall]

include => local
include => to_provider_voip

L’applicazione VoiceMail()

Una delle funzioni più interessanti di Asterisk è quella della VoiceMail. Grazie a questa applicazione ogni utente può avere la propria segreteria telefonica a cui può accedere secondo le specifiche stabilite.

Inoltre è possibile settare Asterisk in modo tale da far inviare alla caselle di posta un email con l’allegato wave del messaggio lasciato in segreteria. Vediamo come implementare tutto questo.

Aggiungiamo la VoiceMail agli interni

voicemail.conf



...

[default]
6001 => 1234,Polycom,pol@iol.it
6002 => 1234,Zoiper,zoip@iol.it

…

sip.conf



;*******************************************
;*** GLOBAL SETTING

[general]
context=default
realm=class.digium.com
bindport=5060
bindaddr=0.0.0.0
srvlookup=yes
disallow=all
allow=ulaw
allow=gsm
language=en

;*******************************************
;*** REGISTER STATEMENTS

;*******************************************
;*** FRIENDS, USER AND PEERS…

[6001]
type=friend
host=dynamic
secret=zoiper
context=users
mailbox=6001@default ; serve solo per mandare la notifica al telefono

[6002]
type=friend
host=dynamic
secret=polycom
context=users
mailbox=6002@defaul

extensions.conf



;*******************************************
;*** GLOBAL SETTING FOR EXTENSION

[general]
static=yes
writeprotect=no
autofallthrough=yes
clearglobalvars=no
priorityjumping=no

;*******************************************
;*** GLOBAL SETTING FOR variables

[globals]

;*******************************************
;*** EXTENSION CONTEXT

[users]
exten => 6001,1,Dial(SIP/6001,20)
exten => 6001,n,VoiceMail(6001@default)

exten => 6002,1,Dial(SIP/6002,20)
exten => 6002,n,VoiceMail(6002@default)

;exten => _600x,1,Dial(SIP/${EXTEN},20)
include => features

[features]
exten => 6599,1,Answer()
exten => 6599,n,Playback(hello-world)
exten => 6599,n,wait(2)
exten => 6599,n,Playback(good-evening)
exten => 6599,n,Hangup()
exten => 6598,1,Goto(demo-menu,s,1)

;per ascoltare i messaggi
exten => 6500,1,Answer()
exten => 6500,n,VoiceMailMain(@default)

[demo-menu]
exten => s,1,Answer()
exten => s,n,Wait(1)
exten => s,n,Background(press-1)
exten => s,n,Background(or)
exten => s,n,Background(press-2)
exten => s,n,WaitExten(3) ;aspetta 3 secondi passati i quali va all’estensione t

exten => 1,1,Playback(you-entered)
exten => 1,n,Playback(digits/1)
exten => 1,n,Goto(s,1) ;

exten => 2,1,Playback(you-entered)
exten => 2,n,Playback(digits/2)
exten => 2,n,Goto(s,1)

exten => h,1,NoOp(Shucks, they hung up!!!)

exten => t,1,Playback(too-low)
exten => t,n,Hangup()

exten => i,1,Playback(pbx-invalid)
exten => i,n,Hangup()

Servizio Directory

Con il servizio Directory è possibile chiedere ad Asterisk l’interno di una persona inserendo da tastiera (come con la modalità T9) le prime tre lettere del cognome. Se ci sono più match corrispondenti alla stessa digitazione il sistema legge l’elenco delle persone matchate e per ciascuna di esse chiede conferma all’utente.

extension.conf



...

[users]
exten => 6001,1,Dial(SIP/6001,20)
exten => 6001,n,VoiceMail(6001@default)

exten => 6002,1,Dial(SIP/6002,20)
exten => 6002,n,VoiceMail(6002@default)

;exten => _600x,1,Dial(SIP/${EXTEN},20)
include => features

[features]
exten => 6599,1,Answer()
exten => 6599,n,Playback(hello-world)
exten => 6599,n,wait(2)
exten => 6599,n,Playback(good-evening)
exten => 6599,n,Hangup()
exten => 6598,1,Goto(demo-menu,s,1)

exten => 6601,1,Goto(day-menu,s,1) ;ACCESS EXTENSION

;Record The Day Menu
exten => 6600,1,Answer()
exten => 6600,n,Wait(0,5)
exten => 6600,n,Record(day-menu.gsm)
exten => 6600,n,Wait(1)
exten => 6600,n,Playback(day-menu)

[day-menu]
exten => s,1,Answer()
exten => s,n,Wait(0.5)
exten => s,n,Background(day-menu)
exten => s,n,WaitExten(5)

exten => 1,1,Goto(users,6001,1)

exten => 2,1,Goto(users,6002,1)

exten => 9,1,Directory(default,users,e)

exten => *,1,Goto(s,1)

exten => t,1,Playbach(goodbay)
exten => t,n,Hangup()

exten => i,1,Playback(pbx-invalid)
exten => i,n,Goto(s,1)

Le applicazioni Authenticate e VMAuthenticate()

Forniscono un modo semplice per autenticare la chiamata (per es per permettere le chiamate internazionali)

exten => 6101,n,Authenticate(1234)

con VMAuthenticate si può usare il PIN della mailbox

exten => => 6101,n,VMAuthenticate([mailbox][@context])

L’applicazione del Dialplan che svolge questo ruolo è Background() (simile all’applicazione Palyback con la differenza che si interrompe quando riceve i DTMF). Vediamo un esempio:

[incoming]

exten => 123,1,Answer()

exten => 123,2,Background(menu)

exten => 1,1,Playback(digits/1)

exten => 2,1,Playback(digits/2)

Dopo la risposta se il chiamante premerà 2 sentirà il Palyback di 2…Alla pressione di un tasto Asterisk aspetta un paio di secondi per essere sicuro dell’azione da eseguire (1 e 123 iniziano con lo stesso numero…)

I Timeout della funzione Background()

Response Timout : tempo di attesa prima che venga inserita la prima cifra (default=10 sec)

Digit Timeout: tempo di attesa tra una cifra e l’altra (default 5 sec)

La funzione WaitExten() permette di modificare “in corsa” il RESPONSE TIMOUT

Estensioni Speciali

Per gestire situazioni speciali Asterisk usa estensioni speciali rappresentate da una singola lettera. Le più comuni sono:

- i : immissione di entry invalide
- t : scadenza response time
- T : durata massima di una chiamata
- h : estensione hangup
- s : estensione start

Estensione i : sta per “invalid”. Quando l’utente digita un numero invalido la chiamata viene passata all’estensione i

Estensione s :  vale per le chiamate analogiche in cui il nella chiamata non viene trasportata l’informazione del numero chiamato (c’è solo “anonymous”)

Estensione t : sta per “timout”. Quando il chiamante aspetta troppo tempo durante l’applicazione Background() o WaitExten() pria di digitare sulla tastiera la chiamata viene inviata all’estensione t

Estensione T : “absolute timeout” rappresenta la durata massima di una chiamata. Quando la lunghezza della chiamata supera il l’absolute timeout la chiamata viene inviata a questa estensione.

Salti e loop

Vediamo ora come implementare sia dei salti tra differenti estensioni sia un sistema che permetta di ripetere più volte (loop) l’esecuzione di uno stesso dialplan

L’applicazione GoTo()

Permette di saltare da un punto ad un altro all’interno del dialplan. Puoi avere da uno a tre parametri:

- un numero di priorità o una label (per salti all’interno della stessa estensione)

GoTo (priority)

- un estenzione ed una priorità (per salti all’interno dello stesso contesto)

GoTo (exten,priority)

- un contesto, un estensione ed una priorità (per salti in qualsiasi punto del dialplan)

Goto (context,exten,priority)

Esempio di GoTo con le label:

exten => 123,1,Answer()
exten => 123,n,Wait(0,5)
exten => 123,n(playit),Playback(tanks-for-calling)
exten => 123,n,Goto(playit)

Altre Applicazioni

Wait() : aspetta per il numero di secondi (o frazione di secondi).

NoOp() : sta per “No Operation”. Viene utilizzata come un tool di debugging. Stama infatti sulla console l’argomento che le viene passato se il livello di verbosità impostato è maggiore/uguale a tre.

Verbose() : come NoOp con in più la possibilità di impostare il livello di verbosità

Vediamo un esempio di un IVR base:




;*******************************************
;*** GLOBAL SETTING FOR EXTENSION

[general]
static=yes
writeprotect=no
autofallthrough=yes
clearglobalvars=no
priorityjumping=no

;*******************************************
;*** GLOBAL SETTING FOR variables

[globals]

;*******************************************
;*** EXTENSION CONTEXT

[users]
exten => 6001,1,Dial(SIP/6001,20)
exten => 6002,1,Dial(SIP/6002,20)
;exten => _600x,1,Dial(SIP/${EXTEN},20)
include => features

[features]
exten => 6599,1,Answer()
exten => 6599,n,Playback(hello-world)
exten => 6599,n,wait(2)
exten => 6599,n,Playback(good-evening)
exten => 6599,n,Hangup()
exten => 6598,1,Goto(demo-menu,s,1)

[demo-menu]
exten => s,1,Answer()
exten => s,n,Wait(1)
exten => s,n,Background(press-1)
exten => s,n,Background(or)
exten => s,n,Background(press-2)
exten => s,n,WaitExten(3) ;aspetta 3 secondi passati i quali va all’estensione t

exten => 1,1,Playback(you-entered)
exten => 1,n,Playback(digits/1)
exten => 1,n,Goto(s,1) ;

exten => 2,1,Playback(you-entered)
exten => 2,n,Playback(digits/2)
exten => 2,n,Goto(s,1)

exten => h,1,NoOp(Shucks, they hung up!!!)

exten => t,1,Playback(too-low)
exten => t,n,Hangup()

exten => i,1,Playback(pbx-invalid)
exten => i,n,Hangup()

L’applicazione Dial()

Permette a un endpoint (telefono) di chiamare un altro endpoint. Dial() processa la chiamata, se la chiamata viene risposta unisce i canali per la conversazione. Questa funzione ha 2 parametri principali

Device(s) – l’endpoint può essere specificato come una tecnologia e canale come SIP/6001 DAHDI/g1
Quando si chiama attraverso un trunk o un service provider la sintassi è tecnologia/canale/numero. Es:

SIP/myprovider/55599123

tecnologia/canale/numerodachiamare

Timeout – per quanto tempo l’endpoint destinazione deve squillare prima di andarà avanti nelle priorità dell’estensione

E’ possibile chiamare più enpoint contemporaneamente

exten => 123,1,Dial(SIP/6001/6002)

E’ possibile anche chiamare un’altra estensione usando il Local channel

exten => 123,1,Dial(Local,456@Incoming)

Fa un dial sull’estensione (è come il GoTo())

Le istruzioni/strutture principali che permettono di creare un Dialpaln sono:

- Contesti

- Estensioni

- Priorità

- Applicazioni

NB: Il dialplan di Asterisk è contenuto nel file principale di tutto il sistema che è extensions.conf

I contesti

I contesti suddividono il dialplan in varie sezioni.

Nota Bene –> Asterisk identifica i tipi d’interfaccia sui quali si può telefonare con il termine canal, canale. Un canale può essere, per esempio, l’interfaccia ISDN (es. chan_dahdi.conf) o l’interfaccia Ethernet per il VoIP (es. sip.conf). La configurazione dei canali è fatta con dei file di configurazione *.conf, che si trovano nella directory /etc/asterisk. Nei vari canali, in base al flusso di ingresso, si può scegliere con quale contesto – presente nel file extension.conf – tale flusso deve essere gestito. (Questo argomento verrà ripreso successivamente).

Il nome di ogni contesto è racchiuso tra parentesi quadre. E’ possibile includere un contesto dentro l’altro utilizzando la funzione include. Es

[users] ; questo è il contesto users
exten => 6001,1,Dial(SIP/6001,20)
exten => 6002,1,Dial(SIP/6002,20)
include => features ; in questo modo includo il contesto features dentro il contesto users

[features]
exten => 6003,1,Dial(SIP/6003,20)
exten => 6004,1,Dial(SIP/6004,20)

Le estensioni

L’estensione (a differenza di quanto accade per un centralino standard) in Asterisk può essere condiderata come un insieme di azioni associate ad un nome

Sintassi:

exten => name, priority, application

exten => : definisco un estensione

name : il nome dell’estensione può essere numerico od alfanumerico

priority : numero sequenziale

application : azione

La priorità

La priorità è essenzialmente un numero sequenziale. Ciascuno step viene processato in ordine sequenziale

exten => 123,1, do something

exten => 123,2, do something else

exten => 123,3, do something different

Quando Asterisk termina di processare tutte le righe riaggancia la chiamata (auto-failthrough)

Dopo la priorità 1 (OBBLIGATORIA) posso mettere la priorità n che si incrementa automaticamente:

exten => 123,1, do something

exten => 123,n, do something else

exten => 123,n(label), do something different

NB: ad ogni n posso associare un etichetta (o label)

Le Applcazioni

Ciascuna priorità invoca un applicazione. Vediamone alcune

Answer() : apre il canale di comunicazione (risponde)

PlayBack() : fa ascoltare un suono che gli passo come argomento e ignora i DTMF. Di default risponde pure alla chiamata. La cartella in cui va a cercare il nome file passato come argomento è /var/lib/asterisk/sounds

NB: se voglio sentire i file in italiano devo modificare in sip.conf la riga language (nella sezione [default] in questo modo: language=it. Naturalmente dovrò a questo punto avere i file in italiano nella directory /var/lib/asterisk/sounds/it. Usare channel(language=it) per cambiare linguaggio dal Dialplan.

Progress() : manda un messaggio al chiamante senza rispondere (quindi tassare) alla chiamata.Può essere usata se l’operatore TELCO lo permette

Hangup() : butta giù la chiamata

Creiamo un dialplan che risponde ad un interno, faccia il play di un file audio e riaggancia la chiamata

extensions.conf



;*******************************************
;*** GLOBAL SETTING FOR EXTENSION

[general]
static=yes
writeprotect=no
autofallthrough=yes
clearglobalvars=no
priorityjumping=no

;*******************************************
;*** GLOBAL SETTING FOR variables

[globals]

;*******************************************
;*** EXTENSION CONTEXT

[users]
exten => 6001,1,Dial(SIP/6001,20)
exten => 6002,1,Dial(SIP/6002,20)
;exten => _600x,1,Dial(SIP/${EXTEN},20)
include => features

[features]
exten => 6599,1,Answer()
exten => 6599,2,Playback(hello-world)
exten => 6599,3,wait(2)
exten => 6599,4,Playback(good-evening)
exten => 6599,5,Hangup()

Ricordarsi sempre di ricaricare il file extensions.conf

# asterisk -vvvr

CLI> dialplan reload

Per vedere se Asterisk a caricato il nuovo dialpan:

CLI> dialplan show 6599@features

In Asterisk qualsiasi conversazione implica 2 chiamate:
dal telefono chiamante ad asterisk e da asterisk al telefono chiamato two legs:

Nel caso che i due telefoni siano degli endpoint sip notiamo che sia ilflusso di segnalazione SIP sia il flusso voce (RTP) passa sempre per Asterisk. Questo comportamento è diverso dallo standard SIP dove il flusso RTP avviene direttamente tra i due telefoni.

Ma entriamo nel dettaglio. Vediamo ora come creare due estensioni (SIP) e come farle paralre tra di loro.
Editiamo il file sip.conf nel seguente modo


;*******************************************
;*** GLOBAL SETTING

[general]
context=default
bindport=5060
bindaddr=0.0.0.0
srvlookup=yes
language=en

;*******************************************
;*** REGISTER STATEMENTS

;*******************************************
;*** FRIENDS, USER AND PEERS…

[6001] ;il nome dell’account. Quando si config il tel sip questo è lo UserName
type=friend ;l’account di tipo friend può fare e ricevere chiamate
host=dynamic ;dice ad * che il tel ha un IP dimnamico e si registrerà all’accenzione
secret=zoiper ;è la password dell’account
context=users ;Quando il telefono farà una chiamata questa chiamata verrà gestita
;in base a come viene indicato nel contesto users del file extension.conf

[6002]
type=friend
host=dynamic
secret=polycom
context=users

NB_1: Il valore tra parenesi quadre rappresenta il nome dell’account voip. Generalmente è utile utilizzare come valore del nome account lo stesso dell”estensione a cui sarà associato l’account. Questo concetto sarà più chiaro quando si definirà il dialplan nel flie extension.conf.

NB_2: Cominciamo con il dire che la variabile type può assumere valore user, peer e friend. Cominciamo con il dire che user si utilizza per ricevere chiamate da quell’account, peer si usa quando di devono fare chiamate con quell’account e friend quando si devono fare entrambe le cose

A questo punto è necessatio far ricaricare ad Asterisk la configurazione modificata. Per fare questo non c’è bisogno si far ripartire il servizio ma è sufficente entrare in modalità CLI e fare il restart solo della parte modificata (in questo caso il file sip.conf)

#asterisk -r
CLI>sip reload
CLI>sip show users
CLI>sip show peers

Ora dobbiamo aggiungere le estensioni che permetteranno di inviare le chiamate ai vari account
editiamo il file extensions.conf nel seguente modo

;*******************************************
;*** GLOBAL SETTING FOR EXTENSION

[general]
static=yes
writeprotect=no
autofallthrough=yes
clearglobalvars=no
priorityjumping=no

;*******************************************
;*** GLOBAL SETTING FOR variables

[globals]

;*******************************************
;*** EXTENSION CONTEXT

[users]
exten => 6001,1,Dial(SIP/6001,20)
exten => 6002,1,Dial(SIP/6002,20) ; –il nome dell’estensione e dell’account sip non devono  essere uguali per forza, lo sono per comodità –;

Se dovessi inserire tante exten per quanti sono gli interni di un grande centralino sarebbe un pò stancante e potrei incorrere in errori. Per riassumere le n estensioni (con n=100 interni da 0 a 99) posso utlilzzare la seguente notazione:

exten => _60XX,1,Dial(SIP/${EXTEN},20

NB: L’underscore (_) prima del nome dell’estensione indica ad Asterisk che la stringa che segue va “interpretata”. La variabile ${EXTEN} prende il valore del nome dell’estensione.

Anche in questo caso facciamo ricaricare ad Asterisk le modifiche apportate al nostro dialplan (al file extensions.conf)

#asterisk -r
CLI>dialplan reload

Con il comando dialplan show users vengono visualizate le estensioni nel contesto user
CLI>dialplan show users

Preparazione del sistema per l’installazione di Asterisk

Prima di installare le varie componenti di Asterisk sono necesari i seguenti paccetti:
- compilatore gcc
- OpenSSL e le relative librerie di sviluppo
- ncurses e ncursers-devel
- Zlib
- librerie newt e newt-devel (per le DAHDI utilities)
- Curl (pre far interagire Asterisk con i siti web)
- Sendmail o Postfix (per far inviare le voicemail all’indorozzo di posta desiderato)

Le componenti di Asterisk

Per l’installazione di Asterisk sono necessarie tre componenti (sorgenti) fondamentali
- libpri: gestisce le interfaccie PRI ISDN (da installare solo se presenti schedwe T1/E1/J1)
- DAHDI: driver per le schede analogiche e/o digitali. Fornisce anche il “system timing” (clock) in assensa delle schede hardware
- Asterisk: codic sorgente di Asterisk
- (opzionale) Asterisk-addons
tutto dal seguente link: http://downloads.digium.com/pub/telephony/

Compiliamo i codici

In questa circostanza è molto importante seguire un ordine ben preciso:

(1) -> libpri

(2) -> DAHDI (ex Zaptel)

(3) -> Asterisk

Cominciamo con lo scompattare i pacchetti:



# tar -zxvf libpri-1.4.x.tar.gz
# tar -zxvf dahdi-linux-complete-2.x.tar.gz
# tar -zxvf asterisk-1.6.x.tar.gz


Installazione delle libpri (per la gestione delle schede dei flussi primari (ISDN PRI)



# cd libpri-1.4.x
# make clean
# make
# make install
# cd ..


i driver delle  schede digium



# cd dahdi-linux-complete-2.x
# make all
# make install
# make config
# cd ..


e infine Asterisk



# cd asterisk-1.6.x
# ./configure
# make menuselect


NB: (quest’ultimo comando permette di aprire un menu che permetterà la selezionare dei moduli da compilare e l’impostazione di aclune opzioni) In questo step sotto la sezione “PBX Modules” va deselezionato pbx_ael (AEL: Asterisk Extention Language-> è linguaggio di programmazione sperimentale) . Questo perchè evitando il bulding di questo modulo si evitaeràad Asterisk di  inviare messaggi di warning o di errore durante lo start-up o durente il reload del file extension.conf



# make
# make install
# make samples
# make config
# cd ..

# reboot

Alla fine dell’installazione dovremmo avere le seguenti directory:
/user/sbin/asterisk/         -> il binario
/etc/asterisk/             -> i file di configurazione
/usr/lib/asterisk/modules     -> i moduli caricati, i codec e i canali
/var/lib/asterisk/sound/     -> gli Asterisk sound prompt
/var/lib/asterisk/moh/         -> musiche di attesa
/var/lib/asterisk/         -> il database AstDB
/var/spool/asterisk/         -> call information
/var/log/asterisk/         -> i log
/var/log/asterisk/cdr-csv/     -> dettagli delle chiamate

A questo punto Asterisk è installato come servizio (/etc/init.d/asterisk stop|start)
per entrare nella modalitaà CLI basta digitare
# asterisk -r

(meglio #asterisk -vvvr dove il numero delle “v” indica il grado di verbosità della CLI)

Componenti e strutture di Asterisk

L’architettura di asterisk può essere suddivisa in tre grandi parti
1) Le componenti del nucleo centrale (Core System Components)
- Dialpaln
- CLI
- Applicazioni
- Risorse
2) Le tecnologie o i protocolli (Channel Drivers) – canali per l’interfacciamento con l’esterno.
Ogni canale è una tecnologia (es scheda primaria) o un protocollo (SIP)
- DAHDI (ex Zaptel)
- SIP
- IAX2
- H323
3) Interfaccia esterna (Drivers & Converters)
- Audio & Video CODEC
- System Configuration Drivers

Configurazione Asterisk

Per default Asterisk carica la sua configurazione da una serie di file di testo che generalmente si trovano nel path /etc/asterisk.
Tutti i file hanno estensione “.conf” e sono degli standard ASCII text file che possono essere modificati con un qualsiasi editor. Ciascuno di questi file (anche se hanno funzioni diverse) ha la stessa struttura: sono infatti divisi in sezioni (o contesti). Le sezioni dei vari file sono identificabili dal fatto che il loro nome viene racchiuso tra parentesi quadre. Un contesto può essere visto come una serie di istruzioni che Asterisk deve eseguire all’arrivo di una chiamata che noi decidiamo di far gestire da questo contesto
[section-heading]
setting=true ; questo è un commento
; questo pure
; – - questo è un commento su
righe diverse – - ;

I cinque file più importanti per la configurazione di asterisk sono (in ordine alfabetico e non di importanza):


asterisk.conf
chan_dahdi.conf (vecchio zaptel.conf)
externsion.conf
iax.conf
sip.conf


asterisk.conf: è il file che dice ad asterisk dove cercare gli altri file di configurazione
Praticamente non va mai editato tranne che per qualche opzione del tipo “nocolor=no/yes” per abilitare/disabilitare l’ANSI color nella CLI

chan_dahdi.conf: contiene le configurazioni per tutte le schede telefoniche (digium) analogiche e/o digitali. Questo file “lavora” in congiunzione con un altro file ->/etc/dahdi/system.conf che rappresenta l’astrazione tra il sistema Linux e l’hardware delle schede

extensions.conf: contiene la configurazione del dialplan. In pratica dice ad asterisk come maneggiare le chiamate (sia in ingresso che in uscita)

iax.conf: contiene la configurazione del canale IAX2 e la configurazione per tutti di device IAX2 attestati su Asterisk

sip.conf: contiene la configurazione del canale SIP e la configurazione per tutti di device (tutti gli interni e i provider esterni) SIP attestati su Asterisk