Logiciel de taxation Comtrafic & Cisco : CallManager

Logiciel de taxation Comtrafic & Cisco : CallManager

Configuration du PABX

Dans la configuration la plus courante, le PBX Cisco CallManger (CUCM : Cisco Unified Communications Manager) fournit les tickets (ou CDR : Call Detailed Records) dans des fichiers à un serveur FTP externe, pour cela il faut installer (sur le serveur de taxation) un logiciel serveur FTP type FileZilla (logiciel open source accessible ici : https://filezilla-project.org/download.php?type=server voir installation chapitre suivant).

Il est recommandé d’installer et tester le serveur FTP avant de configurer le PABX.

Pour le PABX :

Munissez vous d’un accès administrateur aux pages Cisco Unified Communications Manager & Cisco Unified Serviceability .

Allez dans Tools > CDR Management.

Cliquez sur le ‘+’ pour ajouter une nouvelle application ‘billing server’.

Saisissez les informations:

  1. Host or IP address: Adresse du serveur FTP
  2. User Name : Nom d’utilisateur du serveur exemple : comtrafic
  3. Password : Mot de passe de l’utilisateur exemple : comtrafic
  1. Protocol : Choisir FTP
  2. Directory Path : Laisser à vide.

Cliquez sur ‘Add’ pour valider, attention il peut arriver que le serveur FTP soit déjà actif pour que la configuration soit prise en compte.

Configuration du serveur FTP

L’installation est donnée ici à titre d’exemple, notamment au sujet des nom d’utilisateur / mot de passe et répertoire de dépose des fichiers.

Installez FileZilla serveur, lancez l’interface, allez dans le menu Edit puis Users et créez avec le bouton ‘Add’ un utilisateur comtrafic

Vérifiez que vous êtes toujours dans la page General , cochez Password et saisissez comtrafic de nouveau.

Allez dans la page Shared Folders et avec le bouton ‘Add’ (celui en dessous de la liste des directories) rajouter le répertoire de dépose des fichiers , par exemple c:\comtrafic\lien_1\ et dans les cases Files cochez ‘Write’ (et ‘Read’).

Validez par le bouton ‘OK’.

Testez impérativement, avec un client FTP (celui de Windows par exemple) si vous pouvez déposer un fichier.

Configuration du logiciel de taxation

Avant de configurer le logiciel de taxation vérifiez que le PABX dépose correctement les fichiers de taxation dans le bon répertoire (ils doivent se nommer cdr_xxxxxxx).

Installer le logiciel par le setup, dans ‘type d’installation’ choisissez ‘Réelle’ et dans ‘Modèle de Pabx’ choisissez ‘Cisco_CallManager’ à la fin du setup lancer ComTrafic pour initialiser la base de données, puis fermez le.

Lancer le logiciel ‘lien.exe’ par le raccourci créé sur le bureau, normalement le PABX est configuré, sauf pour la récupération des fichiers, donc cliquez sur l’onglet paramétrage, vérifiez que vous avez Cisco_CallManager.pbx dans ‘Type de Pabx’ :


Cliquez sur le bouton ‘Modifier‘ :

Choisissez Fichiers dans le mode de récupération.
Saisissez, dans Répertoire le répertoire (ici C:\ComTrafic\Lien_1) où sont déposés les fichiers.

Saisissez cdr_* dans Nom de fichiers

Cochez Suppression des fichiers après récup.

Validez par ‘OK’ puis ‘Valider’ dans le menu précédent.

Remarque :

Une configuration similaire du Cisco en mode de commande est décrite ici : https://www.cisco.com/c/en/us/td/docs/ios/voice/cdr/developer/manual/cdrdev/cdrcsv.html#71395

Raccordement taxation externe à une base de données Asterisk : exemple Xivo

Raccordement taxation externe à une base de données Asterisk : exemple Xivo

 Asterisk est un logiciel IPBX libre (et propriétaire) sous GNU Linux de plus en plus répandu. La mise en place d’un logiciel de taxation externe se heurte pour Asterisk à un problème connu de fragmentation des distributions : en effet il existe des dizaines de distributions diverses, avec, pour chacune des choix différents de base de données, de tables utilisées et de gestion des tickets de communications.

Le but de cet article est de décrire les étapes de connexion d’un logiciel Comtrafic avec un IPBX Asterisk en prenant comme exemple une distribution Xivo.

Démarche, configuration Asterisk et prérequis

 La majorité des manipulations nécessitant des droits conséquents, un accès root au système Linux est quasiment indispensable. La première question est de savoir par quel moyen récupérer les informations sur les communications et d’identifier si et où elle sont stockées. Aujourd’hui la majorité des configurations stockent nativement ces informations dans la base de données de l’IPBX. Il existe encore des cas de figures où les tickets ne sont pas stockés ou stockés sous forme de fichiers. Une fois la ou les tables identifiées, il reste à donner les droits d’accès pour Comtrafic et à déterminer les requêtes de récupérations des communications. Il est parfois plus intéressant de gérer les droits d’abord pour avoir les outils externes qui permettent d’identifier la table.

Étape 1 : Vérifier et gérer les droits d’accès à la base.

Pour Xivo, la base de données est PostgreSQL, d’autres distributions (les plus nombreuses) utiliseront MySQL et ses dérivés voire SQLite3.

Vérifier les accès à la base et identifier des tables

 Connectez vous en root sur l’interface du serveur Linux et lancez l’interface PostgreSQL, tapez :

root@xivo:~# su - postgres
postgres@xivo:~$ psql asterisk
  • PostgreSQL doit répondre une ligne de type:
psql (9.4.19)
  • Liste des tables, taper
asterisk=# \dt
  • Liste des users , taper
asterisk=#SELECT login, passwd from "user";

 

  • Réponse :
 login  |    passwd
 -------+---------------
  root  | Serv98@host727
  • Contenu de la table call_log , taper
asterisk=#SELECT * FROM call_log;
  • Réponse :
id | date | source_name | source_exten | source_line_identity | destination_name | destination_exten | destination_line_identity | duration | user_field | answered
338 | 2019-11-14 19:31:48.794466 | 0471098882 | 0471098882 | sip/rffgg | | 0720672244 | | 00:00:00 | | f

Remarques :

Dans cette phase on identifie les tables, dans la majorité des distributions Asterisk, la table intéressante se nomme CDR, pour Xivo c’est CALL_LOG et CEL.

Donner les droits d’accès à distance

Vous pouvez pour les droits d’accès consulter les docs de la base de données celle de la distribution.

De manière générale il faut :

Créez (ou modifiez) un utilisateur reconnu par la base de données et donnez les droits à cet utilisateur pour le bon accès aux tables et au serveur.

Exemple pour Xivo et un utilisateur/mot de passe comtrafic/comtrafic :

CREATE USER comtrafic WITH PASSWORD 'comtrafic';
GRANT ALL PRIVILEGES ON DATABASE asterisk to comtrafic;
GRANT SELECT ON asterisk."call_log" TO comtrafic;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO comtrafic;
GRANT all privileges ON asterisk."userfeatures" TO comtrafic;

ATTENTION : les commandes précédentes donnent tous les droits à ce user, ce qui est pratique pour démarrer mais ensuite il est impératif de restreindre les droits au minimum utile.

Donner au système externe les droit d’accès au serveur et à la base.

Il faut donc gérer les pare feux et les droits réseau en général, de plus il faut que la base accepte les accès externes. Pour PostgreSQL un bon résumé est donné ici : https://blog.bigbinary.com/2016/01/23/configure-postgresql-to-allow-remote-connection.html.

Testez avec la commande (où 192.168.212.57 est l’adresse IP du serveur)

psql -h 192.168.212.57 -U comtrafic

Étape 2 : Accéder à la base avec Comtrafic.

  • Vérifiez si le PC taxation a accès au serveur via ping, telnet ou http.
  • Utilisez un logiciel de connexion à la base de données : https://www.heidisql.com est excellent et permet l’accès à MySQL & PostgreSQL.
  • Si c’est OK lancer le logiciel ‘lien.exe’ par le raccourci créé sur le bureau, cliquez sur l’onglet paramétrage, cliquez sur le bouton ‘Modifier‘ : et renseignez les paramètres, notamment l’adresse du serveur, le login et mot de passe :

 

taxation Asterisk Xivo

 

  •  Validez par ‘OK‘ puis ‘Valider‘ dans le menu précédent.