Support De Cours Asterisk

  • Published on
    24-Jun-2015

  • View
    1.026

  • Download
    3

DESCRIPTION

Avant propos
Ce document est basé sur la version de développement (Asterisk SVN-trunk-r30630M futur 1.4) d'Asterisk passé en 1.4-beta en octobre 2006. Bien que beaucoup de précautions aient été prise lors de la préparation de ce document, il est plus que possible que des erreurs, omissions, incorrections y soit décelés. Il y a certainement un grand nombre de fautes de français, alors corrigeons tous ensemble s'il vous plait.

Table des matières
Avant propos......................................

Transcript

Avant propos Ce document est basé sur la version de développement (Asterisk SVN-trunk-r30630M futur 1.4) d'Asterisk passé en 1.4-beta en octobre 2006. Bien que beaucoup de précautions aient été prise lors de la préparation de ce document, il est plus que possible que des erreurs, omissions, incorrections y soit décelés. Il y a certainement un grand nombre de fautes de français, alors corrigeons tous ensemble s'il vous plait. Table des matières Avant propos..................................................................................................................1 Introduction....................................................................................................................5 Matériel......................................................................................................................5 Distribution GNU/Linux et Serveurs de Régression.................................................5 Téléphonie..............................................................................................................5 Digium Inc..........................................................................................................6 Cartes numériques zaptel-compatible................................................................6 Cartes analogiques zaptel-compatible...............................................................6 Adaptateurs de TéléphonesAnalogiques (ATA)....................................................6 Autres Fournisseurs matériel..............................................................................7 Sangoma............................................................................................................7 Xorcom...............................................................................................................7 Grandstream......................................................................................................7 Architecture................................................................................................................7 Canaux et Pilotes de Canaux..................................................................................7 Applications............................................................................................................8 Dialplan..................................................................................................................8 Démarrer Asterisk..................................................................................................8 Syntaxe générique de Configuration........................................................................10 Pense-bête Codecs...................................................................................................11 Les principaux Canaux.................................................................................................11 Le Canal Zap.............................................................................................................11 FXO et FXS............................................................................................................12 zconfig.h...............................................................................................................12 zaptel.conf............................................................................................................12 zapata.conf...........................................................................................................13 Commandes CLI...................................................................................................13 IAX2..........................................................................................................................13 SIP............................................................................................................................14 ALSA / OSS................................................................................................................15 Pseudo canal Agent..................................................................................................15 Pseudo canal Local...................................................................................................16 Jingle.........................................................................................................................16 H.323........................................................................................................................16 Skinny/SCCP.............................................................................................................16 UNISTIM....................................................................................................................16 CAPI/MISDN...............................................................................................................16 VPB...........................................................................................................................17 MGCP........................................................................................................................17 Dialplan........................................................................................................................17 extensions.conf........................................................................................................17 Commandes CLI...................................................................................................17 Exstensions..........................................................................................................17 Extensions et priorités spéciales..........................................................................20 switch...................................................................................................................20 Variables et expressions.......................................................................................21 Fonctions prédéfinitet Macro................................................................................21 extensions.ael (version 2)........................................................................................22 Commande CLI.....................................................................................................23 Utilitaires AEL.......................................................................................................23 Syntaxe du 'langage'............................................................................................23 Mots clés du 'langage'..........................................................................................24 Commentaires......................................................................................................24 Contextes.............................................................................................................25 Extensions............................................................................................................25 Inclusions..............................................................................................................25 Switches...............................................................................................................26 Variables...............................................................................................................26 Boucles.................................................................................................................27 Macro....................................................................................................................27 Goto et Labels......................................................................................................28 Infrastructure « RealTime » (ARA).................................................................................28 extconfig.conf...........................................................................................................28 res_odbc.conf...........................................................................................................29 Structures de tables.................................................................................................29 DUNDI...........................................................................................................................31 Commanes CLI..........................................................................................................31 Crypto.......................................................................................................................31 dundi.conf.................................................................................................................31 Voicemail......................................................................................................................33 AGI................................................................................................................................33 Commandes AGI.......................................................................................................34 AGI en Python...........................................................................................................36 Debugger les AGI......................................................................................................37 AMI...............................................................................................................................37 Applications et fonctions..............................................................................................38 Ressources...................................................................................................................38 Introduction La première chose que j'ai apprise en écrivant ce guide est que définir une infrastructure aussi versatile qu'Asterisk peut être un exercice périlleux. Subitement, j'ai réalisé ce que voulait vraiment dire l'angoisse de la page blanche. Les télécommunications, comme disait Mark Spencer ont été l'une des contrés les moins explorés dans le monde du libre, aussi peu que ne le sont les techniques de protection contre la copie dans ce monde. Asterisk est l'une des première expérience retentissante pour combler ce vide si confortable pour cette vieille grosse industrie léthargique rompue à la tâche de la livraison de PC cadencés à 700Mhz embarquant une version de VxWorks vieille de 15 ans et Windows NT 4 pour pas moins de 15.000€ pour faire office de Commutateur. Asterisk est une plat-forme libre et flexible constituant un point de convergence de diverses technologies autour de la téléphonie. Matériel Les fournisseurs de matériels fonctionnant avec Asterisk sont très nombreux, nous ne citeront ici que les plus populaires. Vous trouverez pléthores d'informations sur http://www.voip-info.org/wiki/view/Asterisk+hardware et la liste ne cesse de croître tous les jours. Distribution GNU/Linux et Serveurs de Régression Il faut noter que Digium Inc. effectue des tests de Régression pour la version « Asterisk Business Edition » et les distributions testée avec « Asterisk Business Edition » sont: λ λ RedHat Enterprise 3 (ES) Fedora Core 3 Les serveurs utilisés à ce propos sont: λ λ Dell Poweredge 2850 HP Proliant DL360 Téléphonie Dans cette section nous parlons de cartes TDM numériques et analogiques ainsi que de quelques terminaux (Adaptateurs ATA et postes IP). Digium Inc. Cartes numériques zaptel-compatible λ TE405P et TE410P: Cartes T1/E1 de quatre ports supportant les technologies voix et données sur T1 et E1 avec une configuration de port indépendante. Il s'agit de cartes pour des slots 5-vols et 3,3 volts respectivement. TE407P et TE412P: Cartes T1/E1 de quatre ports supportant les technologies voix et données sur T1 et E1 avec une configuration de port indépendante. Il s'agit de cartes pour des slots 5-vols et 3,3 volts respectivement. Elles disposent en plus, d'un module matériel de suppression d'écho λ λ TE205P et TE210P: Cartes T1/E1 de deux ports supportant les technologies voix et données sur T1 et E1 avec une configuration de port indépendante. Il s'agit de cartes pour des slots 5-vols et 3,3 volts respectivement. TE207P et TE212P: Cartes T1/E1 de deux ports supportant les technologies voix et données sur T1 et E1 avec une configuration de port indépendante. Il s'agit de cartes pour des slots 5-volts et 3,3 volts respectivement avec module de suppression d'echo. TE110P: Carte T1/E1 d'un port avec les mêmes fonctionnalités que les cartes de la série TE ci-dessus. B410P et B405P: Cartes de quatre ports RNIS accès de base. λ λ λ Cartes analogiques zaptel-compatible λ TDM400P: Carte supportant jusqu'à quatre ports FXS ou FXO via des modules permettant de se connecter aux téléphones analogues. TDM2400P: Carte supportant jusqu'à 24 ports FXS ou FXO en groupe de 4 pour un total de six modules par carte. Module FXS: Module vert FXS utilisé avec la TDM400P Module FXO: Module rouge utilisé avec la TDM400P λ λ λ Adaptateurs de TéléphonesAnalogiques (ATA) λ IAXy S101I: Adaptateur de téléphone analogique utilisant le protocole IAX. Il existe en trois variante avec des alimentation (Européenne, Nord-Américaine et Anglaise). Notons que le choix de ce type de matériel peut se révéler périlleux. Il peut être bon de recourir à la revue de la communauté avant d'acquérir du nouveau matériel (e.g. lisez les commentaires utilisateurs sur http://www.asteriskguru.com/tutorials/st_302_ip_phone_hardphone.html ). Autres Fournisseurs matériel Sangoma Les cartes produites par Sangoma sont devenu très populaires dans la communauté Asterisk. Ils produisent des cartes A101, A102, A104 et A104d qui sont respectivement des cartes T1/E1 à un, deux et quatre ports. La A104d est une carte quatre port avec un module de suppression d'écho à 128ms. Des cartes à 8 ports T1/E1 haute densité sont également disponible (http://www.sangoma.com/press/corporate/2006_04_05_A108_Card ). De plus ils fournissent les cartes A200 et A200d qui sont des cartes analogiques extensibles FXS/FXO de 2 à 24 ports. Les pilotes de ces cartes sont disponibles sur le site de Sangoma (http://wiki.sangoma.com/ ) Xorcom Xorcom (http://www.xorcom.com ) produit Astribank-{8,16,32} spécialement conçu pour Asterisk. Ce Channel Bank dispose entre autre de huit, seize ou trente-deux ports FXS et se connecte à Asterisk via une connections USB-2 directe. Le pilote est fournit avec le paquetage zaptel. Grandstream Grandstream produit des channels bank GXW-41 (http://www.grandstream.com/ygxw.htm ) avec une interface réseau WAN et une interface réseau LAN toutes 10/100. Il fournit entre 4 et 8 ports FXO et expose les lignes via SIP. Architecture Les blocs essentielles à la constitution d'Asterisk sont: Les pilotes de canaux, les applications et le dialplan. Canaux et Pilotes de Canaux Un canal est l'unité atomique qui transporte un appel au sein d'Asterisk. Il peut s'agir d'une connection physique à une ligne téléphonique ou à un poste téléphonique comme il peut s'agir d'une connection logique induite par un appel en provenance d'un réseau de données. Avec Asterisk, chaque Canal est géré par un pilote (channel driver) qui en connaît les moindres détails et qui n'expose que le strict nécessaire à la couche supérieure du PBX. Généralement, un pilote de Canal lit dans un fichier de configuration les informations concernant le matériel/protocole qu'il doit gérer puis entre en attente de modification d'états sur les canaux physiques/logiques. Dés qu'un changement d'état survient, (Sonnerie par exemple), le pilote crée une structure de données de type channel et y attache tous les callbacks nécessaires à la communication. Le pilote démarre ensuite le PBX (ast_pbx_start ) en passant la référence à la structure de données crée. ast_pbx_start démarre alors un thread pour la gestion du canal. Ainsi, tant que l'appel n'est pas raccroché, le pilote ne s'occupera pas de ce canal en particulier. Le thread du PBX utilisera le canal, lisant, écrivant, multiplexant ce canal avec d 'autres canaux (en utilisant l'appel système select sur le descripteur de fichier du canal). Dés que le canal est raccroché, le pilote reprendra la surveillance du canal dans l'attente du prochain changement d'état. Applications Les applications rendent des services lorsqu'un appel est traité dans le système. Pour chaque appel, une suite d'applications est exécuté en série dans l'ordre dans lequel elles sont défini dans le diaplan. Une application très utile est l'application Dial . Certaines applications utilisent un fichier de configuration comme l'application VoiceMail Dialplan Le dialplan définit les instructions de traitement d'appel, il est configuré à travers extensions.conf et/ou extensions.ael. Nous les décrirons un plus en détails dans une autre section. Démarrer Asterisk Asterisk s'intègre parfaitement au schéma de démarrage classiques et des exemples de scripts init SYSV sont fourni dans la distribution (contrib/init.d). Chaque distribution fournissant Asterisk l'intègre à son système de démarrage et définit un mechanisme générique de configuration de démarrage permettant d'activer telle ou telle autre option. Nous listerons les paramètres utilisés dans la distribution officielle. Option -V Description Affiche la version d'Asterisk puis quitte (e.g Asterisk SVN-trunk-r30630M ou Asterisk 1.2.8) Utiliser un fichier de configuration autre que celui par défault (généralement /etc/asterisk/asterisk.conf) Exécute Asterisk avec les privilèges du -C -G groupe -U -c Exécute Asterisk avec les privilèges de l'utilisateur Fournit une console. Cette option implique -f et elle force Asterisk à ne pas se détacher du terminal de control Active le debug (spécifier plusieurs d pour plus de debug) Instruit à Asterisk de ne pas se dupliquer (fork) Génèrer un fichier core en cas de plantage Une fenêtre décrivant les options décrites ici Initialise les clé cryptographiques au démarrage Active la synchronisation d'horloge interne si Zaptel est disponible Définit la charge maximale du système au delà de laquelle les appels sont rejetés. Définit le nombre maximal d'appels géré par le système à un moment donné Supprime l'affichage des messages debug/verbose de la console Désactive la colorisation de la console S'exécuter comme processus pseudo temps réel si le système hôte supporte un tel méchanisme (et si le démarrage est effectué par root). Cela se passe au détriment des autres programmes s'exécutant sur la même machine. Réduit l'affichage des messages par défaut de la console Se connecter à Asterisk sur cette machine même Se connecter à Asterisk et tenter la reconnections en cas de déconnections. Enregistrer les fichiers audio sous /var/tmp avant de les déplacer vers leurs destinations finales Afficher la date au format [Mmm dd -d -f -g -h -i -I -L -M -m -n `-p -q -r -R -t -T hh:mm:ss] pour chaque ligne affiché à la console -v -x Accroître le verbose (plusieurs v pour plus de verbose) Exécute la commande (valable uniquement avec -r) Syntaxe générique de Configuration Asterisk utilise principalement des fichiers de configuration pour son opération. Il esiste un certain nombre de convention qu'on retrouve dans tous les fichiers de configuration d'Asterisk: λ La plupart des fichiers de configuration supporte l'inclusion d'autres fichiers de même nature à travers la directive #include (#include ). Il est généralement possible dans ces cas de recourir à des jokers comme '*' (#include ) Lorsque le paramètre execincludes est à yes dans la section options du fichier asterisk.conf , il est possible de verser la sortie d'une commande dans un fichier (#exec ) Le point-virgule est utilisé et conseillé pour les commentaires dans les fichiers de configuration. Il est possible de faire des commentaires multi-ligne en utilisant la syntaxe ;-- --; λ λ La plupart des fichiers de configuration utilisent un découpage par section et chaque section contient des éléments d'assignation (option=valeur). Pour certains fichiers (zapata.conf notamment), la configuration est légèrement différente: Les options sont globalement défini, puis dés qu'un objet est spécifié, les options défini lui sont appliquées: context=incoming callerid=8647288 channel=>1-2 λ Il existe également un mécanisme de définition de templates: [section](options) option=valeur Par exemple: [section] option1=valeur [section](+) option2=valeur Cette syntaxe instruit que la section en (+) est la continuité de la première section généralement défini dans un autre fichier et inséré avec #include. [section](!) option=valeur Cette configuration en point d'exclamation instruit l'analyseur qu'il s'agit juste d'une template et ne devrait pas être utilisé par Asterisk en l'état. On peut alors faire réfèrence à ce template dans d'autres section fonctionnelles en utilisant la syntaxe [section](nomSection1, [nomSection2]) [sectionA] option1=valeur [sectionB] option2=valeur [sectionX](sectionA,sectionB) option3=valeur se traduirait par: [sectionX] option1=valeur option2=valeur option3=valeur Pense-bête Codecs Codec G.711 G.726 G.723.1 G.729A iLBC Speex Taux de transfert (kbps) 64 16,24,32 5.3 ou 6.3 8 13,3 entre 1.15 et 22.4 Les principaux Canaux Le Canal Zap Il s'agit généralement d'interface physique au RTC. Nombre de ces cartes sont produites par Digium Inc.. Certains fabriquant de carte produisent également des wrapper permettant plus ou moins de traiter leurs équipements comme des canaux zap (e.g. http://www.junghanns.net/en/home.html ). Ces cartes sont généralement de type FXS, FXO, PRI et BRI. Certaines de ces cartes sont des cartes de haute densité modulaires permettant de disposer de plusieurs ports sur le même slot PCI 2.2. La configuration des canaux zap s'effectue principalement au moyen du fichier zapata.conf1 . Les configurations bas niveau des cartes se fait par le fichier /etc/zaptel.conf, partie du paquetage zaptel. FXO et FXS Pour faire la différence entre FXS et FXO il faut chercher la partie de la connections qui génère la tonalité. Une carte FXO ne génère pas de tonalité. Un port fournit la tonalité et le voltage nécessaire à la sonnerie alertant le terminal connecté lors de l'arrivée d'un appel. zconfig.h Certaines options de configuration sont accessible par la modification du fichier zconfig.h du paquetage zaptel. Certains paramètres peuvent être modifiés lors du chargement des pilotes de cartes dont vous disposez (modprobe wctdm boostringer=1). Parmi ces options on peut citer: λ BOOST_RINGER permet d'augmenter le voltage envoyé à un téléphone de 70 à 89V. Ceci peut être utile lorsque certains téléphones connectés au canal zap ont du mal a détecter la sonnerie. CONFIG_ZAPTEL_MMX pour les optimisations MMX Choix de l'algorithme de suppression de l'écho (ECHO_CAN_KB1, ECHO_CAN_MG2, etc) λ λ λ λ Suppression agressive de résidu d'écho: AGGRESSIVE_SUPPRESSOR ZapRAS pour trnsformer Asterisk en RAS. zaptel.conf Ce fichier est analysé par l'outil de configuration des interfaces zaptel ztcfg. On y définit les spans, la liste de périphériques regroupant les canaux et les tonalités. span=1,0,0,cas,hdb3,yellow,crc4 Il faut noter que les framing utilisés pour les E1 (à moins qu'il ne s'agisse d'un channel Bank) sont cas ou ccs et le coding est ami ou hdb3. On peut utiliser le mot clé crc4 pour activer la vérification du CRC4 sur la ligne. fxsks=25,27,28,29 fxoks=1-12,19 Une carte FXS est définit par le fait qu'elle connecte un terminal/station, donc elle doit se comporter comme une CO en utilisant une signalisation FXO. defaultzone=fr loadzone=fr zapata.conf Ce fichier contient essentiellement deux section qui sont [trunkgroups] et [channels]. La section trunkgroups est utilisé pour les liaisons NFAS et GR-303 de Bellcore. La section [channels] contient toutes les définitions des attributs de canaux utilisés par Asterisk. language=fr context=nomades internationalprefx=00 nationalprefix=9 localprefix=8 signalling=fxs_ks sendcalleridafter=2 cancallforward=yes (*72+Numéros active et *73 désactive) group=3 stripmsd=1 callerid=asreceived channel => 1-13 Commandes CLI reload chan_zap.so zap show cadences zap show channel zap show channels zap show status pri show span pri show spans pri show debug pri debug span pri intense debug span pri set debug file IAX2 IAX2 est le protocole de téléphonie sur IP standard de fait (et pas encore standard de jurée) dans la communauté Asterisk. Il possède des caractéristiques intéressantes comme le 'trunk' ou une excellente immunité aux réseaux à translation d'adresse/port. Contrairement aux protocoles effectuant la signalisation sur un port différent de celui qui transporte le média, IAX utilise le même port pour la signalisation et pour le transport du média. reload chan_iax2.so ou iax2 reload iax2 debug iax2 show netstats|threads|stats iax2 trunk debug iax2 jb debug SIP SIP est un standard de jurée (IETF 02/1996 draft-ietf-mmusic-sip-00 ) de Téléphonie sur IP, il utilise RTP pour le transport du média. Il s'agit d'un protocole de signalisation au niveau de la couche application (c'est même la principale source de ses problèmes). SIP peut utiliser TCP ou UDP pour le transport même si l'implémentation Asterisk n'est pas encore TCP capable. dans channels/chan_sip.c on peut lire: * * * * * * * * * * * * * * * * * * * * * Implementation of RFC 3261 - without S/MIME, TCP and TLS support Configuration file \link Config_sip sip.conf \endlink \todo \todo \todo \todo \todo SIP over TCP SIP over TLS Better support of forking VIA branch tag transaction checking Transaction support \ingroup channel_drivers \par Overview of the handling of SIP sessions The SIP channel handles several types of SIP sessions, or dialogs, not all of them being "telephone calls". - Incoming calls that will be sent to the PBX core - Outgoing calls, generated by the PBX - SIP subscriptions and notifications of states and voicemail messages - SIP registrations, both inbound and outbound - SIP peer management (peerpoke, OPTIONS) - SIP text messages Bien que SIP ne soit pas le seul protocole de voix sur IP du marché, il semble bénéficier d'une large adoption aussi bien par les constructeurs de terminaux que par les développeurs, cela est en partie du à la disponibilité des spécifications. Une configuration de base sip.conf ressemble à ceci: [general] context=Hell srvlookup=yes tos_sip=cs3 tos_audio=ef tos_video=af41 useragent=AUFSIPUA Pwrd by Asterisk PBX externip = 1.2.3.4 externhost=foo.baz.bar localnet=192.168.0.0/255.255.0.0 localnet=10.0.0.0/255.0.0.0 localnet=172.16.0.0/12 localnet=169.254.0.0/255.255.0.0 [tom] type=friend secret=s3cr3t qualify=10 disallow=all allow=speex allow=gsm allow=alaw nat=no host=dynamic canreinvite=no context=hackers reload chan_sip.so ou sip reload sip list objects sip list peers sip list settings|domains|channels|subscriptions sip list peers ALSA / OSS Il s'agit du pilote de canal console permettant entre autre de tester la configuration. Pseudo canal Agent Ce canal est principalement utilisé pour l'identification des agents (télé-acteurs, téléconseillers, télé-spameurs, télé-marketeurs, etc). Pseudo canal Local Ce canal permet pour créer une boucle sur le PBX lui même. Il est utilisé pour le routage récursif. Jingle Le support de Jingle sous Asterisk se décline en deux variantes qui sont en ce moment (1.4.0-beta) assez semblables: Le pilote de canal Jingle vise à supporter les spécifications JEP-166, 167, etc, alors que le pilote de canal Gtalk se focalise sur le protocole propriétaire de Google très semblable à Jingle. L'objectif c'est de focaliser le développement de chan_gtalk aux particularitées non-jingle de GTalk alors que chan_jingle va converger vers le standard de jurée. H.323 Protocole de téléphonie IP de jurée de l'ITU H.323. Il existe Trois implémentations H.323 pour Asterisk: Une implémentation inclus dans la distributions officielle d'Asterisk, une autre produite par Objective Systems et distribuée avec asteriskaddons (asterisk-addons/asterisk-ooh323c) et enfin une dernière produite par inaccessnetworks λ (http://www.inaccessnetworks.com/projects/asterisk-oh323 ) Skinny/SCCP Skinny est un protocole propriétaire de Cisco utilisé avec le PBX Cisco Call Manager. Asterisk supporte ce protocole via chan_skinny UNISTIM Il s'agit d'un protocole propriétaire de Nortel (voir http://mlkj.net/UNISTIM/ ) CAPI/MISDN Il s'agit des principaux pilote de canaux utilisé pour l'accès aux cartes RNIS d'accès de base. Ils supportent toutes les cartes gérées par les infrastructure du noyau (CAPI2 et MISDN). chan_misdn commençe à s'imposer et fournit déjà une ensemble impressionnant de fonctionnalités (mode NT/TE, Crypto (Blowfish), app_sendText, détection DTMF, etc). VPB Asterisk supporte les cartes Voicetronix (http://www.voicetronix.com/index.htm ) à travers chan_vpb MGCP MGCP est aussi un standard de jurée de l'IETF de plus en plus supplanté par SIP et IAX. Asterisk supporte MGCP à travers chan_mgcp Dialplan Les contextes sont utilisés par Asterisk pour diviser le Dialplan en unités logiques, chacune avec la possibilité de traitement différent pour les mêmes extensions. Les contextes peuvent avoir leurs propres modèle de sécurité et peuvent inclure d'autres contextes. Les contextes sont souvent vu comme des unités organisationnelles d'entreprise avec les mêmes droits d'accès à des ressources que le contexte permet de regrouper. Les mécanisme d'inclusion de contexte peuvent dépendre de date/heure particulière extensions.conf Le premier outil de configuration du dialplan est le fichier extensions.conf. Commandes CLI core list hints|switches dialplan show [[exten@]contexte] dialplan reload dialplan add extension ,,, into contexte [replace] dialplan remove extension [priorité] include in dont include in dialplan save Exstensions Une extension Asterisk n'est pas liée à une interface, elle est constituée d'un ensemble d'application dont la séquence est déterminée par la priorité attaché à l'application. exten => extension,priorité[+offset][(alias)],Application(args) [default] exten => 205,1,Goto(phrase-menu,s,1) [phrase-menu] exten => s,1,Answer exten => s,2,DigitTimeout,5 ; Délai d'attente de DTMF exten => s,3,ResponseTimeout,10 ; Délai d'attente de réponse exten => s,4,BackGround(custom/phrase-menu) ; Menu principal play. ; Enregistrement des Phrases exten => 1,1,Wait(1) exten => 1,2,Read(PHRASEID|custom/entrer-num-phrase) exten => 1,3,Wait(2) exten => 1,4,Record(custom/${PHRASEID}:gsm) exten => 1,5,Wait(2) exten => 1,6,Playback(custom/${PHRASEID}) exten => 1,7,Wait(1) exten => 1,8,Goto(s,2) ; Re-lecture des phrases exten => 2,1,Wait(1) exten => 2,2,Read(PHRASEID|custom/entrer-numm-phrase) exten => 2,3,Wait(1) exten => 2,4,Playback(custom/${PHRASEID}) exten => 2,5,Wait(1) exten => 2,6,Goto(s,2) exten => t,1,Hangup exten => i,1,Playback(custom/option-invalide) exten => i,2,Goto(s,2) La modification d'une extension peut être pénible puisqu'il faut généralement réordonner les priorités des applications mise en jeu. Asterisk fourni les priorités n et s qui signifient: λ s (same) même priorité que la précédente n (next) prochaine priorité disponible [phrase-menu] exten => s,1(entree),Answer exten => s,n,DigitTimeout,5 ; Set Digit Timeout to 5 seconds exten => s,n,ResponseTimeout,10 ; Set Response Timeout to 10 seconds exten => s,n,BackGround(custom/phrase-menu) ; Play main menu. ; Phrase exten => exten => exten => exten => exten => exten => exten => exten => Recording 1,1,Wait(1) 1,n,Read(PHRASEID|custom/enter-phrase-num) 1,n,Wait(2) 1,n,Record(custom/${PHRASEID}:gsm) 1,n,Wait(2) 1,n,Playback(custom/${PHRASEID}) 1,n,Wait(1) 1,s+1,Goto(s,entree) Asterisk fournit un mécanisme de groupage sous la forme de modèle permettant d'exprimer un groupe d'extension de façon concise: exten => _0[8,9]XXXX,1,Dial(Zap/g1/${EXTEN:1}|20|tT) X Z N [25-7] . ! Tous les chiffres entre 0 et 9 Tous les chiffres entre 1 et 9 Tous les chiffres entre 2 et 9 2, 5, 6, 7 Joker peut être n'importe quoi Joker permettant à la correspondance d'être résolu dés qu'il n'y a plus d'ambiguïté Il est important de noter qu'une extension peut être résolue par plusieurs modèles, auquel cas le mécanisme de tri d'Asterisk effectuera l'arbitrage. Pour éviter de subir ce tri, on peut utiliser le mécanisme d'inclusion qui donne la priorité aux extensions directes (non inclues) Au lieu de : [exemple] exten => _918.,1,Dial(Zap/g1/${EXTEN}) exten => _.,1,Dial(Zap/g2/${EXTEN}) exten => h,1,Hangup Utilisez [exemple] include => sous-exemple exten => h,1,Hangup exten => _918.,1,Dial(Zap/g1/${EXTEN}) [sous-exemple] exten => _.,1,Dial(Zap/g2/${EXTEN}) Extensions et priorités spéciales Les extensions ne sont pas que numériques, Asterisk fournit des extensions spéciales permettant d'effectuer certaines tâches prédéfinies: o s h i t T a failed fax talk Utilisé avec VoiceMailet Directory, elle est utilisé lorsque l'appelant appui sur 0 Extension utilisé lorsqu'un appel arrive dans un contexte sans extension associé. Extension de raccroché. Extension invalide, elle est utilisée lorsqu'une extension invalide est saisie Délai d'attente dépassé (Attente de DTMF généralement) Extension invoquée lorsque la valeur de TIMEOUT(ABSOLUTE) est atteinte Elle est utilisé pour parler à un opérateur sous VoiceMail et Directory utilisé lorsque les appels automatiques échouent (/var/spool/asterisk/outgoing) Utilisé lorsque qu'un FAX est détecté (tonalité 2100Hz lors de la négociation) Utilisé avec l'application BackGroundDetect (généralement pour la détection des répondeurs) Il existe une priorité spéciale 'hint' permettant à Asterisk de communiquer l'état d'un canal à un équipement externe sans révéler la nomenclature externe qui s'avère inutile dans nombre de cas (voir http://www.voipinfo.org/wiki/view/Asterisk+standard+extensions ) exten => 200,hint,SIP/tom exten => 200,1,Dial(SIP/tom) switch Asterisk utilise le mot clé pour la résolution d'extensions inconnues au PBX local. switch => IAX2/utilisateur:passe@montreal/contextext il existe deux variantes de switch qui se distinguent essentiellement par le moment où les substitutions de variables (interpolations) s'opèrent: Il s'agit de lswitch et de eswitch. Variables et expressions Des variables peuvent être défini en utilisant la fonction Set: Set(variable=valeur) ; variable accessible par ${variable} Il existe nombre de variables prédéfinies par Asterisk et définies à plusieurs niveau (variables de canaux, variable défini par certaines applications, variables de CDR, etc). Il est possible d'extraire des sous chaînes de variables avec la syntaxe: ${variable:offset:longueur} Des variables statiques peuvent être définies dans la section [globals] du fichier extensions.conf [globals] CONSOLE=/dev/sound/dsp IAXINFO=utilisateur:passe TRUNK=IAX2/utilisateur:passe@quebec GTIMEOUT=37 Asterisk est capable d'évaluer des expressions et reconnaît un grand nombre d'opérateurs: exten => 1,1,Set(variable1=$[1+102]) exten => 1,2,Set(variable2=$[${EXTEN}+${variable1}+200]) Fonctions prédéfinitet Macro ${IF(?:)} ${EXISTS()} ${ISNULL()} ${REGEX("" )} Les macros sont implémentés comme des contextes particuliers avec des noms de type: [macro-NomMacro] [macro-BoiteVocale] exten => s,1,Set(LANGUAGE()=fr) exten => s,n,Set(TIMEOUT(absolute)=60) exten => s,n,Voicemail(u${ARG1}) exten => s,n,Macro(fastbusy) exten => s,s+100,Voicemail(b${ARG1}) [home] exten => 600,1,Dial(IAX2/tom|${GTIMEOUT}tT) exten => 600,2,Macro(BoiteVocale|600@home) extensions.ael (version 2) AEL est un langage de description du dialplan d'Asterisk. On a souvent reproché au dialplan d'Asterisk de ne pas être lisible, certains prétendent qu'AEL est une sorte de poudre aux yeux pour visuellement parer à cette limitation s'il en est. En tous les cas, extensions.ael est 'compilé' et la sortie est identique à la syntaxe extensions.conf. Le module pbx_ael.so qui analyse le fichier extensions.ael est complétement différent de l'analyseur du fichier extensions.conf (pbx_config.so). La sortie de pbx_ael.so est injectée dans le dialplan comme ceci: SALAM*CLI> show dialplan inter2 [ Context 'inter2' created by 'pbx_ael' ] '123456789' => 1. Set(x=$[ 0 ]) 2. GotoIf($[ ${x} 1. Verbose("Channel isnt available") 2. Goto(123456789|12) '_sw-11-.' => 1. Verbose(${DIALSTATUS}) [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] [pbx_ael] Le fichier extensions.ael produisant ce dialplan est le suivant: context inter2 { 123456789 => { for(x=0; ${x} { begin: NoOp(Boucle infini!); Wait(1); goto begin; }; 3 => { goto s|begin; }; 4 => { goto gotoexemple|s|begin; }; }; context gotoexemple2 { s => { end: goto gotoexemple|s|begin }; }; Pour plus de détails sur AEL2 lisez le document doc/ael.txt dont cette section est extraite. Infrastructure « RealTime » (ARA) En plus des stockage sur fichier classique, Asterisk fournit un mécanisme dynamique permettant d'utiliser des SGBDR. Les pilotes les plus unifiés sont construits sur res_odbc et res_config_odbc et utilisent UnixODBC (htt://www.unixodbc.org). D'autre travaux sont en cours et devraient fournir à terme res_config_pgsql, res_config_ldap (voir l'une des branches de développement de Olle E. Johansson sur http://svn.Digium Inc..com/view/asterisk/team/oej/res_config_ldap/ ). extconfig.conf La configuration ARA s'opère au moyen du fichier avec une syntaxe semblable à celle- ci: => , [,] [settings] extensions => odbc,telephonie,extensions iaxpeers => odbc,telephonie,iax iaxusers => odbc,telephonie,iax sipusers => odbc,telephonie,sip sippeers => odbc,telephonie,sip voicemail => odbc,telephonie,voicemail2 jingle.conf => odbc,telephonie ; (table ast_config utilisée) res_odbc.conf [ENV] [telephonie] enabled => yes dsn => telephonie username => tom password => s3cr3t pre-connect => yes Structures de tables Voici quelques exemple de schéma PostgreSQL de base: CREATE TABLE iax ( name character varying(30) NOT NULL, username character varying(30), type character varying(6) NOT NULL, secret character varying(50), md5secret character varying(32), dbsecret character varying(100), notransfer character varying(10), inkeys character varying(100), outkeys character varying(100), auth character varying(100), accountcode character varying(100), amaflags character varying(100), callerid character varying(100), context character varying(100), defaultip character varying(15), host character varying(31) DEFAULT 'dynamic'::character varying NOT NULL, mailbox character varying(50), deny character varying(95), permit character varying(95), qualify character varying(4), disallow character varying(100), allow character varying(100), ipaddr character varying(15), port integer DEFAULT 0, regseconds integer DEFAULT 0, language character varying(5) DEFAULT 'fr'::character varying, add_date timestamp without time zone DEFAULT now(), rent boolean DEFAULT true, acctid bigint DEFAULT 0 ); CREATE TABLE extensions ( id serial NOT NULL, context character varying(20) DEFAULT ''::character varying NOT NULL, exten character varying(20) DEFAULT ''::character varying NOT NULL, priority smallint DEFAULT 0 NOT NULL, app character varying(20) DEFAULT ''::character varying NOT NULL, appdata character varying(128)); CREATE TABLE voicemail ( customer_id bigint DEFAULT (0)::bigint NOT NULL, context character varying(50) DEFAULT ''::character varying NOT NULL, mailbox bigint DEFAULT (0)::bigint NOT NULL, password character varying(4) DEFAULT '0'::character varying NOT NULL, fullname character varying(50) DEFAULT ''::character varying NOT NULL, email character varying(50) DEFAULT ''::character varying NOT NULL, pager character varying(50) DEFAULT ''::character varying NOT NULL, stamp timestamp(6) without time zone NOT NULL, uniqueid serial NOT NULL ); Une table config standard MySQL CREATE TABLE ast_config ( id int(11) NOT NULL auto_increment, cat_metric int(11) NOT NULL default 0, var_metric int(11) NOT NULL default 0, commented int(11) NOT NULL default 0, filename varchar(128) NOT NULL default '', category varchar(128) NOT NULL default 'default', var_name varchar(128) NOT NULL default '', var_val varchar(128) NOT NULL default '', PRIMARY KEY (id), KEY filename_comment (filename,commented) ); DUNDI DUNDI est un protocole P2P utilisé pour localiser les passerelles Internet vers des services de téléphonie. Il s'agit d'un protocole distribué sans autorité centrale. DUNDI permet de déterminer des chemin d'accès qui sont ensuite utilisés pour accéder aux ressources localisées à travers les standards de téléphonie sur IP. Commanes CLI dundi dundi dundi dundi dundi dundi dundi dundi dundi dundi dundi dundi show peer show peers show transaction show requests show precache show mappings|identité query [@contexte] lookup [@contexte] [bypass] precache [@contexte] flush store history debug Crypto DUNDI est un protocole crypté, les pairs de clé doivent être générés sur les systèmes Asterisk qui veulent l'utiliser. dundi.conf [general] autoanswer=yes department=Infrstructures Techniques organization=Fongibilité Asymétrique locality=Dakar country=SN mail=dundi@courriel.com phone=+2215555555 bindaddr=0.0.0.0 port=4520 entityid=00:50:BA:1E:64:BC [mappings] contexte_dundi => contexte_local,poids,tech,dest[,options] Les correspondances 'mapping' fournissent la relation entre les contextes DUNDI et les contextes locaux au PBX: Mot clé contexte_dundi contexte_local poids Description Il s'agit du contexte spécifié dans la requête DUNDI. Le nom du contexte dans le dialplan local utilisé pour effectuer la recherche Entre 0 et 60000 il permet de faire la discrimination sur les multiples résultats obtenu pour une même recherche La technologie utilisée (IAX, SIP, MGCP, H.323) La destination à fournir pour joindre le numéro. Les variables ${NUMBER}, $ {IPADDR} et ${SECRET} peuvent être utilisées mobile, nounsolicited, residential, commercial, nopartial, nocomunsolicit tech dest options senegal => local,0,IAX2,dundi:${SECRET}@dakar.example.com/${NUMBER}, nounsolicited,nocomunsol icit,nopartial Le fichier dundi.conf définit également les homologues sous la forme: [00:11:22:44:88:FF] model = symmetric host = montreal.example.com inkey = montreal outkey = dakar include = senegal permit = senegal qualify = yes dynamic=yes Les derniers aspects consistent à définir les accès aux ressources pointées par les correspondances 'mappings' (iax.conf pour permettre les appels, auquel cas on peut utiliser le mot de passe généré par Asterisk toutes les heures et stocké dans dundi/secret dans la base BerkeleyDB d'Asterisk) et à définir les contextes dans lesquels des recherches DUNDI peuvent s'effectuer (switch => DUNDI/montreal par exemple). Voicemail La configuration statique du système de messagerie vocale s'effectue au travers du fichier voicemail.conf. Les paramètres les plus utilisés sont: [default] 3131 => 0000,Tom Tom,tomy@exemple.com 3132 => 0000,Jr Sant,jrstan@exemple.com,jrsant@pagerexemple.com L'accès à la messagerie vocale se fait par les applications VoiceMail() et VoiceMailMain() dans le dialplan. AGI Les AGI peuvent être écrit dans n'importe quel langage de programmation. Ils communiquent avec Asterisk à travers les descripteurs de fichier standards STDIN, STDOUT et STDERR.. Les AGI sont invoqués directement dans le dialplan comme toutes les applications (AGI(), EAGI(), DeadAGI() et FastAGI()). Au démarrage, Asterisk envoie une liste de variables ainsi que leurs valeurs à l'AGI qu'il a démarré, ces pairs ressemblent à ceci: agi_request: Dial.py agi_channel: Zap/2-1 agi_language: fr agi_callerid: agi_context: topsecret agi_extension: 313 agi_priority: 1 Ces pairs sont suivi d'une ligne vide pour signifier à l'AGI qu'Asterisk attend des commandes pour le contrôle du dialplan. Commandes AGI Les commandes AGI peuvent être obtenu avec la commnde show agi en console: Commande answer channel status database del database deltree database get database put exec get data get full variable get option get variable hangup noop receive char receive text record file say alpha say digits say number say phonetic say date say time say datetime send image Description Décroche le canal Renvoie le statut du canal connecté Supprime clé/valeur de la base Supprime une arborescence de la base Renvoie la valeur dans la base Définit la valeur dans la base Exécute une application Récupère des DTMF sur le canal Evalue une expression du canal Lit un fichier, demande des DTMF avec un timeout Récupère une variable de canal Raccroche la canal Ne fait rien du tout Reçois un caractère à partir d'un canal qui le supporte Reçois du texte à partir d'un canal qui le supporte Enregistre dans un fichier Lit une chaîne de caractère Lits des digits Lit un nombre Lit une chaîne de caractère avec phonétique Lit une date Lit une heure Lit une date avec un format spécifié Envoie une image à un canal qui le supporte send text set autohangup set callerid set context set extension set music set priority set variable stream file control stream file tdd mode verbose wait for digit Envoie du texte à un canal qui le supporte Définit l'auto-raccroché pour un moment déterminé Définit le callerid pour le canal Définit le contexte du canal dans le dialplan Modifie l'extension du canal Active/Désactive la musique d'attente Définit la priorité du canal dans le dialplan Définit une variable de canal Lit un fichier sur le canal Envoie un fichier audio sur le canal et fournit un moyen de navigation Active/Désactive le mode TDD (pour les sourds) Envoie un message au journal verbose d'Asterisk Attend qu'une touche soit pressée. Pour chaque commande envoyée, Asterisk répondra dans un style http et la réponse détermine le statut de la commande. Les réponses ressemblent à ceci: 200 result=1 (VariableTest) Voici une routine Perl permettant de traiter la réponse d'Asterisk aux commandes, ce type de sous routine est généralement fournit par les wrappers AGI: sub checkresult { my ($res) = @_; my $retval; $tests++; chomp $res; if ($res =~ /^200/) { $res =~ /result=(-?\d+)/; if (!length($1)) { print STDERR "FAIL ($res)\n"; $fail++; } else { print STDERR "PASS ($1)\n"; $pass++; } } else { print STDERR "FAIL (unexpected result '$res')\n"; $fail++; } Perl est très populaire pur l'écriture des AGI et James Golovich a produit une excellent wrapper permettant d'accéder aux commandes AGI d'Asterisk d'une façon beaucoup plus simple (Asterisk::AGI). Vous trouverez cette bibliothèque sur http://asterisk.gnuinter.net . Il existe également une bibliothèque AGI PHP sur http://phpagi.sourceforge.net . AGI en Python Dans cet exemple nous allons utiliser http://sourceforge.net/projects/pyst pour écrire un petit AGI remplaçant la commande Dial. Cet AGI va vérifier dans une table de la base, parmi une liste de fournisseurs, laquelle elle devra choisir pour envoyer l'appel en fonction de la capacité de la route. Il est trivial de l'améliorer pour générer des pondérations dynamiques en fonctions des statistiques sur la qualité des route créant ainsi un système de routage dynamique convergeant. Table CREATE TABLE fournisseurs ( id serial NOT NULL, peer character varying(256), capacite integer, proto character varying(16) DEFAULT 'IAX2'::character varying, occurrence integer DEFAULT 0, dernierefois timestamp without time zone ); #!/usr/bin/python import psycopg, sys, time from asterisk import agi lcAGI = agi.AGI() db = psycopg.connect("user=test dbname=s3cr3t") curs = db.cursor() def getFournisseurs(): # Chercher les fournisseurs en évitant les plus récent curs.execute("SELECT id, peer FROM fournisseurss WHERE occurrence < capacity ORDER BY dernierefois") return curs.fetchone() def INCoccurrence(id): curs.execute("UPDATE fournisseurss SET occurrence = occurrence + 1, dernierefois = now() WHERE id=%s" % id) db.commit() return 0 def DECoccurrence(id): curs.execute("UPDATE fournisseurs SET id=%s" % id) db.commit() return 0 dest = lcAGI.env['agi_extension'] try: (id, name) = getFournisseurs() except: id = 0 if id: occurrence = occurrence - 1 WHERE INCoccurrence(id) #TODO: Utiliser le protocole pour construire le paramètre du Dial lcAGI.set_variable("PeerId", id) lcAGI.appexec("Dial", "SIP/%s@%s|70" % (dest, name)) else: # Plus de ligne, à inscrire dans le journal fd = open('/var/log/NoLines','a') fd.write('%s | %s | %s | Plus de ligne\n' % (time.ctime(), exten, lcAGI.env['agi_calleridname'])) fd.close() curs.close() db.close() Debugger les AGI Les AGI peuvent être difficile à debugger. Une technique simple consiste à simuler le comportement d'Asterisk en console en exécutant directement l'AGI. Vous pouvez également activer le debug des AGI en console (agi debug ) AMI Asterisk fournit un autre mécanisme puissant pour exposer les routines internes du PBX et envoyer des événements (abonnement aux événement) sur un port TCP (5038 par défaut) déterminé. Cette interface acceptera également des commandes une fois l'authentification établie. Vous pouvez vous connecter sur cet interface à partir de votre application pour recevoir les événements et envoyer des commandes. Il est même possible de s'abonner aux CDR. Un excellent exemple utilisant cet interface est Mozphone (http://www.sysnux.pf/sections/telephonie ). En plus de l'interface brute (raw) fournit, une interface http(s) est disponible avec une extension AJAX (Asynchronous Javascript Asterisk Manger -- AJAM) RICO compatible. Noton que AJAM fournit un contrôle élémentaire des appels (vue détaillée des canaux en ligne, transfert, raccroché, etc.). Applications et fonctions Asterisk est fourni avec pléthores de fonctions et d'applications traitant de tous les domaines liés de près ou de loin au PBX. Vous aurez un excellent aperçu en scrutant les sorties de commandes suivantes: show show show show applications application functions function Ressources Asterisk: The future of Telephony.: O'Reilly & Associates , Inc., 20052 par :Jared Smith, Jim Van Meggelen et Leif Madsen ISBN: 0-596-00962-3 http://www.oreilly.com/catalog/asterisk/ Le guide de référence Wiki pour Asterisk http://www.voip-info.org/wiki-Asterisk The Asterisk Asterisk Documentation Project http://www.asteriskdocs.org Digium Inc. Issue Tracker http://bugs.digium.com/main_page.php Asterisk.org http://www.asterisk.org Distribution GNU/Linux centré sur Asterisk: AstLinux http://www.astlinux.org/ Astricon http://www.astricon.net Daily Asterisk News http://www.sineapps.com/news.php Documentation en ligne Digium Inc. http://www.digium.com/en/supportcenter/documentation/ Zaptel Under the Hood http://zapteldoc.blogspot.com/ Asterisk SS7 http://www.voip-info.org/wiki-Asterisk+SS7 OpenPBX.org http://www.openpbx.org Freeswitch http://www.freeswitch.org/ Yate (Yet Anothet Telephony Engine) http://yate.null.ro/ Listes de diffusion (svn-commits, asterisk-addons-commits, Asterisk-Announce, asterisk-biz, asterisk-bsd, asterisk-bugs, asterisk-ss7, dundi, asterisk-video, etc) http://lists.digium.com/mailman/listinfo/ 1. Jim Dixon les a ainsi nommé en réfèrence à Emiliano Zapata « Since this concept was so revolutionary, and was certain to make a lot of waves in the industry, I decided on the Mexican revolutionary motif, and named the technology and organization after the famous Mexican revolutionary Emiliano Zapata. I decided to call the card the 'tormenta' which, in Spanish, means 'storm' but contextually is usually used to imply a big storm, like a hurricane or such » 2. Disponible en téléchargement sur http://www.asteriskdocs.org/modules/tinycontent/index.php?id=11