Libro A2Billing - Version 3.9

A2Billing v. 3.9 A2Billing 2.2.0 CentOS 6.8 64bit Asterisk 11.23.1 Octubre 2016

By

VozToVoice

www.voztovoice.org

Convenciones tipográficas. Negrita = comandos escritos en la consola de Linux NegritaCursiva: Lineas que hay que añadir/modificar en los archivos de configuración Nombreprograma = Indica el nombre de un programa o librería Cursiva: respuesta del servidor Linux a los comandos CLI> indica que se está trabajando en la consola de Asterisk mysql> indica que se está trabajando en la consola del cliente MySQL redis 127.0.0.1:6379> indica que se está trabajando en la consola del cliente Redis

Este documento se publica bajo la GNU Free Documentation License, versión 1.3 o sucesivas, publicadas por la Free Software Foundation. Está permitido copiar, distribuir y/o modificar este documento bajo los términos indicados en la licencia. Una copia integral de la licencia es presente en la apéndice A de este libro.

Copyright (C)

2014-2020

Andrea Sannucci

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

INDICE Capitulo I – VPS Linode …........................................................................................................... 1 1.1 Preparación del VPS 1.1.1 Servidor Linux CentOS 6.6 Local 1.2 SSH y Clave RSA 1.2.1 Clave RSA en Windows 1.2.2 Clave RSA en Linux 1.2.3 Configuración servidor SSH 1.3 Configuración del VPS

1 7 10 10 14 15 17

Capitulo II - Instalación de Asterisk …...................................................................................... 23 2.1 Utilidades, librerías, dependencias 2.2 DAHDI 2.3 LibPRI 2.4 App_fax, GoogleTalk, LibiCAL y SRTP 2.5 Instalación de Asterisk

23 26 27 28 30

Capitulo III – Instalación de A2Billing ….................................................................................. 38 3.1 Preparación del sistema 3.2 Instalación del demonio Callback 3.3 Configuración de Asterisk 3.3.1 sip.conf 3.3.2 extensions.conf 3.3.3 Asterisk Realtime 3.4 Configuración del Firewall 3.5 Primer acceso

38 45 47 47 50 52 55 59

Capitulo IV – Configuración Base A2Billing............................................................................ 63 4.1 System Settings 4.2 Configuración de los Proveedores 4.3 Creación de los planes de llamadas y de las tarifas 4.4 Configuración de los métodos de pago 4.5 Configuración para la facturas 4.6 Plantillas de los correos electrónicos 4.7 Creación de un cliente 4.8 Registro de un nuevo cliente desde la pagina Web 4.9 Creación de una cuenta POSTPAGO 4.10 Crear Revendedores i

64 96 100 109 111 113 114 129 134 137

Capitulo V - Configuración Avanzada A2Billing …............................................................... 5.1 Distintos CallPlan 5.2 El sistema de soporte 5.3 Callback (Rellamada) 5.3.1 Rellamada desde la pagina personal del cliente 5.3.2 Rellamada con numero de acceso 5.4 A2Billing como sistema de tarjetas prepago 5.5 Paquetes de llamadas 5.6 El Parámetro LCR Mode 5.7 Añadir extensiones a un cliente 5.8 El sistema de facturación 5.9 Subscription services 5.10 Account Service 5.11 Números geográficos 5.11.1 Didx.Net 5.11.2 Configurar Numero DID 5.12 A2Billing en dos servidores 5.12.1 Primer Servidor – Asterisk PBX 5.12.2 Segundo Servidor – Parte Web 5.13 Conteo de canales

145 145 154 157 159 161 165 180 186 189 191 194 197 201 201 204 210 210 218 222

Capitulo VI – Seguridad del servidor ….................................................................................... 232 6.1 Poner en seguridad el servidor Web 6.1.1 Creación y configuración de un certificado para el Servidor Web 6.2 Seguridad en Asterisk 6.2.1 Fail2ban 6.2.2 Bloquear IP por países

232 236 240 241 244

Capitulo VII – Monitoreo del sistema …................................................................................... 251 7.1 Monitoreo desde A2Billing 7.1.1 Monitoreo calidad llamadas 7.1.2 Monitoreo con script y un sistema de TTS 7.2 Monitoreo con Nagios y SNMP 7.2.1 Asterisk y SNMP 7.2.2 Nagios 7.2.3 NDOutils 7.2.4 PNP4NAGIOS 7.3 Monitoreo calidad de las llamadas con pre-dial handlers y hangup-handlers 7.4 Monitoreo calidad de las llamadas con VoIPMonitor

ii

251 251 253 260 260 262 274 277 283 289

Capitulo VIII – Trucos y consejos ….......................................................................................... 293 8.1 Cambiar la moneda predefinida 8.2 Rellamada sin cobrar en ningún caso la primera llamada 8.3 Nginx en lugar de Apache 8.4 Guardar la IP del llamante en el CDR 8.5 Cambiar el numero de las tarjetas 8.6 Modificar el tamaño del campo destination en los reportes de las llamadas 8.7 Campo destination en la tabla cc_call 8.8 Registros de Asterisk 8.9 Cambio nombre pestaña Navegador 8.10 Aumentar el numero de decimales en los reportes de llamadas 8.11 Autenticación sobre IP 8.12 Actualizar A2Billing a una nueva versión

293 294 297 302 303 304 305 306 307 308 308 311

Capitulo IX – Resolución de problemas …................................................................................. 316 9.1 Pagina Web en blanco 9.2 Recuperar password administrador A2Billing 9.3 Tarificación errada de las llamadas

316 317 317

Apéndice A – GNU Free Documentation License

320

iii

Capitulo I VPS Linode La parte que se presenta a seguir es valida solamente para un VPS Linode. Para una instalación en un servidor local o un servidor remoto dedicado (no virtualizado), véase el párrafo 1.1.1. 1.1 Preparación del VPS Los VPS de Linode, utilizan como sistema de virtualización Xen y desde el mes de Junio de 2015 también KVM; los dos vienen con un Kernel personalizado. Para poder trabajar con el ultimo Kernel disponible de la versión de CentOS instalada, se modificará la configuración del servidor instalando el sistema de arranque GRUB y luego iniciando el servidor con la opción (GRUB (Legacy)). De esta forma el servidor se iniciará con el Kernel configurado en el archivo menu.lst que habrá que crear. Una vez creada una cuenta en Linode, se accede a la pagina de administración y se adquiere un nuevo VPS:

El nuevo VPS estará disponible:

Se selecciona el enlace indicado en la imagen y en la nueva ventana el enlace “Deploy an Image”:

Se selecciona el tamaño de la RAM del VPS (2048) y el centro de datos que lo hospedará (Dallas). Se confirma la compra presionando el botón “Add This Linode!”.

Terminada la configuración se presiona el botón “Deploy”. Empezará el proceso de instalación y configuración del sistema operativo. Una vez que termine ya se puede iniciar el servidor presionando el botón “Boot”.

Como se puede ver en la imagen, el Kernel que se instala es la versión “Latest 64 bit (4.7.0-x86_64linode72). De esta versión no hay las fuentes disponibles y eso imposibilita la instalación de DAHDI y, en general, de todos los programas que se instalan como módulos del Kernel. Por eso en los próximos párrafos se verá como instalar en el servidor Linode, la ultima versión disponible del Kernel Linux y el sistema de arranque GRUB.

2

Una vez que el servidor esté corriendo, como indicado en la imagen que sigue, que aparece en el lado derecho de la pagina de administración de Linode, se puede acceder al servidor con el programa PuTTy (un cliente SSH):

Para conocer la dirección IP del servidor Linode, se entra en la siguiente pagina, donde aparecen todos los datos de configuración de red del servidor:

Se descarga el programa PuTTy para Windows desde esta pagina: http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Una vez descargado se ejecuta. Aparecerá la siguiente ventana:

3

En “Host Name (or IP address) se pone la dirección IP publica del servidor Linode, en “Port” 22 y en “Saved Sessions” un nombre que identifique la conexión al VPS. Terminada la configuración se presiona el botón “Save” y luego el botón “Open” que aparece más abajo. Se abrirá una nueva ventana donde en “login as” se pone root y en “password” la contraseña que se ha escogido al momento de la instalación del sistema operativo. Si se está utilizando Linux en lugar de Windows, se abre una ventana terminal y para conectarse al servidor remoto se ejecuta el siguiente comando: ssh root@IPservidor El resultado será:

La primera cosa que hay que hacer es actualizar el sistema: yum update -y Se instalan los repositorios de Fedora que se utilizarán más adelante para instalar algunos paquetes que no vienen con los repositorios estándar de CentOS: yum install epel-release -y Se desactivan los nuevos repositorios para activarlos solamente cuando se necesiten: 4

nano /etc/yum.repos.d/epel.repo En el primer bloque del archivo se modifica el parámetro: enabled=1 para que quede: enable=0 Se guardan los cambios. Se instala la ultima versión disponible del Kernel y el sistema de arranque GRUB: yum install kernel grub -y Se averigua la versión del Kernel que se ha instalado: rpm -q kernel kernel-2.6.32-642.4.2.el6.x86_64 y con esos datos se configura GRUB: nano /boot/grub/grub.conf Se copian las lineas que siguen: #boot=/dev/sda default=0 timeout=5 title CentOS (2.6.32-642.4.2.el6.x86_64) root (hd0) kernel /boot/vmlinuz-2.6.32-642.4.2.el6.x86_64 root=/dev/sda console=ttyS0 initrd /boot/initramfs-2.6.32-642.4.2.el6.x86_64.img Se guardan las modificaciones y se crea un enlace simbólico del archivo que se acaba de crear: ln -s /boot/grub/grub.conf /boot/grub/menu.lst IMPORTANTE: como la versión del Kernel puede cambiar en el tiempo, hay que modificar el archivo grub.conf, con los datos de la versión realmente instalada. El paso a seguir es modificar la configuración del servidor Linode. Desde la pagina de administración se selecciona el enlace que aparece en la imagen:

5

En la nueva pagina se modifican los parámetros como indicado en la siguiente imágen:

Para terminar se guardan los cambios presionando el botón “Save Changes” que aparece al final de la pagina. Se regresará a la pagina principal del servidor Linode y de ahí se reinicia:

Para averiguar que efectivamente el sistema arranca utilizando el Kernel Linux instalado y el gestor de arranque GRUB, en la pagina de Linode se entra en el menú “Remote access” y luego se sigue el enlace “Launch Lish Ajax Console” que permite acceder al servidor desde una consola local. Se abrirá una nueva ventana y después de unos segundos aparecerá esta imagen:

6

1.1.1 Servidor Linux CentOS 6.8 Local En el caso de un servidor Linux local, la instalación se realiza desde cero partiendo de un CD de instalación que contenga el sistema operativo CentOS 6.8 64bit. La imagen se puede descargar desde esta pagina. Al momento de escoger el tipo de instalación, se selecciona “minimal”. A lo largo de la instalación se configurará el idioma, el país del teclado, la zona horaria, la contraseña de root, etc. Una vez terminada la configuración se reiniciará el servidor y se podrá acceder con el mismo programa (PuTTY) indicado en el párrafo anterior. Normalmente cuando CentOS se instala en local, el cortafuegos viene configurado por defecto y arranca con una configuración básica. Si se quiere, se puede mover la configuración predefinida: mv /etc/sysconfig/iptables /etc/sysconfig/iptables.old y reiniciar iptables: service iptables restart Otra opción es desactivar el cortafuegos y utilizar el router para definir los puertos que se querrá dejar abiertos. Otra operación que hay que ejecutar es desactivar Selinux. Primero se instala el editor NANO: yum install nano -y luego se abre el archivo de configuración de Selinux:

7

nano /etc/selinux/config Modificar las dos opciones presentes de forma que el archivo quede de la siguiente manera: SELINUX=disabled SELINUXTYPE=targeted Se guardan los cambios y se actualiza el sistema: yum update -y Si se quiere configurar el servidor con una IP estática se instala la relativa utilidad: yum install system-config-network-tui y se ejecuta: system-config-network En la ventana que aparece se escoge “device configuration”:

Se selecciona la tarjeta de red instalada en el servidor:

8

Se configura la IP estática:

Static IP: dirección IP que se quiere asignar al servidor (tiene que estar dentro del rango configurado en el router) Netmask: normalmente el valor es 255.255.255.0 Default Gateway IP: dirección IP del router Primary DNS Server: dirección IP del router Secondary DNS Server: se puede dejar en blanco Se presiona el botón Ok y se vuelve a la pagina anterior donde se escoge el botón Save y en la pagina principal se escoge DNS configuration:

En la pagina que sigue se escoge un nombre de dominio y se configura nuevamente el DNS primario:

9

Se presiona el botón OK y en la pagina que sigue el botón Save&Quit. De esta forma se sale de la aplicación. Se reinicia el servidor: reboot 1.2 SSH y clave RSA RSA es un sistema de cifrado de clave publica che permite la configuración de conexiones seguras. Como en todo sistema de clave pública, cada usuario posee dos claves de cifrado: una pública y otra privada. Cuando se quiere enviar un mensaje, el emisor busca la clave pública del receptor, cifra su mensaje con esa clave, y una vez que el mensaje cifrado llega al receptor, este se ocupa de descifrarlo usando su clave privada. 1.2.1 Clave RSA en Windows Para crear la clave RSA se descarga el programa PuTTygen: http://the.earth.li/~sgtatham/putty/latest/x86/puttygen.exe Se ejecuta:

10

En “Number of bits in a generated key” se pone 2048 y luego se presiona el botón “Generate”. Para la creación de la clave se necesita generar una serie aleatoria de números y esto se realiza moviendo el ratón en el cuadro que aparece bajo la linea “Key”:

11

Hay que seguir moviendo el ratón hasta que la barra que aparece no llegue al final de la linea. Terminada la operación se tendrá disponible la clave RSA (publica y privada):

IMPORTANTE: para aumentar la seguridad de la clave privada, se puede asociar una contraseña. La contraseña se escribe en la casilla “Key passphrase” y se repite en “Confirm passphrase”. Se guarda la clave privada en una carpeta del ordenador local presionando el botón “Save private key”(en este caso se nombra claveprivada):

Para continuar se selecciona todo el texto que aparece en la imagen que sigue, se presiona el botón derecho del ratón y se escoge en el menú “copiar”:

12

El texto copiado es la clave publica. Se accede nuevamente con PuTTy al servidor remoto y se sigue este procedimiento para utilizar la clave publica; se crea la carpeta ssh: mkdir .ssh se permite el acceso a la carpeta creada solamente al usuario root: chmod 700 .ssh se entra en la carpeta: cd .ssh se crea el archivo authorized_keys que es donde el sistema operativo buscará las claves RSA publicas del sistema (en este caso para el usuario root): nano authorized_keys se pega el contenido copiado desde PuTTygen que debe quedar todo en la misma linea:

13

Se guarda el archivo presionado la tecla CTRL junto a la tecla X. Se asigna al archivo recién creado los permisos de lectura y escritura solamente para el usuario root: chmod 600 /root/.ssh/authorized_keys Ya se puede continuar con la configuración del servidor SSH (párrafo 1.2.3). 1.2.2 Clave RSA en Linux Se accede al servidor Linux LOCAL como usuario root y e la ventana terminal se escribe: cd /root mkdir .ssh se permite el acceso a la carpeta creada solamente al usuario root: chmod 700 .ssh se entra en la carpeta: cd .ssh Se crea la clave RSA ssh-keygen -t rsa Enter file in which to save the key (/root/.ssh/id_rsa): Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /root/.ssh/id_rsa. Your public key has been saved in /root/.ssh/id_rsa.pub. The key fingerprint is: 2e:86:eb:d0:8e:2d:49:1f:0e:83:a8:b2:45:e7:2b:26 root@li215-240 The key's randomart image is: +--[ RSA 2048]----+ |... . S | |o.++.. . | |..o*+.o . | |E.==o+ . | |o+.+* | 14

+-----------------+ [root@li215-240 .ssh]# ls -l total 8 -rw------- 1 root root 1675 Mar 11 20:06 id_rsa -rw-r--r-- 1 root root 396 Mar 11 20:06 id_rsa.pub Cuando el sistema lo solicita (lineas en negrita), se puede configurar la clave con una contraseña. Se crearán dos archivos: • •

id_rsa que contiene la clave privada id_rsa.pub que contiene la clave publica

El segundo archivo se copia en el servidor Linode remoto: scp id_rsa.pub root@IPservidorremoto:/tmp Con este comando se copia la clave publica en la carpeta /tmp del servidor remoto. Luego se añade la clave al archivo authorized_keys en la carpeta /root/.ssh cat /tmp/id_rsa.pub >> /root/.ssh/authorized_keys Se borra la clave publica: rm /tmp/id_rsa.pub y se cambian los permisos del archivo authorized_keys: chmod 600 /root/.ssh/authorized_keys 1.2.3 Configuración servidor SSH Terminada la operación de creación y configuración de las claves RSA, hay que modificar algunos parámetros del servidor SSH para permitir el acceso al VPS solamente al usuario root si se autentica con la clave RSA; además, para aumentar la seguridad, se cambia el puerto predefinido para el acceso SSH (22 TCP), escogiendo otro (15000 TCP). Esto se realiza modificando el archivo de configuración del servidor SSH: nano /etc/ssh/sshd_config Se buscan estas lineas (para buscar un texto con el editor NANO hay que presionar la tecla CTRL junto a la tecla W): #Port 22 #RSAAuthentication yes PasswordAuthentication yes 15

y se modifican para que queden: Port 15000 RSAAuthentication yes PasswordAuthentication no Se guardan los cambios y se reinicia el servidor SSH: /etc/init.d/sshd restart Se abre otra instancia del cliente SSH:

Se pone la IP del servidor Linode, come puerto el 15000 y se asigna un nuevo nombre a esta nueva conexión.

16

En la barra izquierda se busca el menú “SSH”, luego “Auth” y se presiona el botón “Browse”. Se busca la clave privada en la carpeta donde se ha guardado anteriormente y se selecciona. Se vuelve al menú Session (en la izquierda) y se guarda esta nueva configuración hundiendo el botón “Save”. Ahora hay dos sesiones disponibles en el cliente SSH: Linode y Linode2. Para acceder al servidor Linux se utilizará la sesión Linode2, botón “Load” y luego botón “Open”. Debe aparecer esta ventana:

Una vez que se haya escrito el nombre de usuario root en “login as:”, automáticamente el cliente se conectará al servidor autenticándose con la clave RSA creada. 1.3 Configuración del VPS Para iniciar la configuración del VPS, se modifica la hora predefinida del servidor: rm /etc/localtime rm: remove regular file `/etc/localtime'? Y 17

Se crea un enlace simbólico a la hora de Colombia (personalizar según su país): ln -s /usr/share/zoneinfo/America/Bogota /etc/localtime se averigua que la hora esté correctamente configurada con el comando: date Mon Oct 6 10:50:52 COT 2014 IMPORTANTE: cada vez que se actualizan los paquetes del sistema (yum update), revisar siempre si la hora del servidor ha cambiado. Si así fuera volver a configurar la de su país Para que la hora se sincronice de manera automática se instala el servidor NTP (Network Time Protocol): yum install ntp -y Se configura para que se inicie automáticamente al arrancar el servidor Linux: chkconfig ntpd on y se inicia: service ntpd start Starting ntpd:

[ OK ]

Para modificar el idioma predefinido (ingles) y ponerlo en español (de Colombia): nano /etc/sysconfig/i18n se modifica esta linea: LANG="en_US.UTF-8" para que quede: LANG="es_CO.iso88591" Para ver la lista de idiomas disponibles y de esta forma personalizar la configuración, el comando es: locale -a Para activar el nuevo idioma basta salir y volver a entrar al servidor con PuTTy. Como la IP publica en Linode se asigna a través de un servidor DHCP y esto puede causar problemas si hay modificaciones de la configuración del servidor por parte de Linode, es buena practica configurar 18

la IP publica de forma estática. Para realizar este cambio, se modifica el siguiente archivo: nano /etc/sysconfig/network-scripts/ifcfg-eth0 Se comenta el contenido previo y se añaden las siguiente lineas de forma que el archivo quede: #DEVICE="eth0" #BOOTPROTO="dhcp" #IPV6INIT="yes" #IPV6_AUTOCONF="yes" #ONBOOT="yes" #TYPE="Ethernet" DEVICE=eth0 BOOTPROTO=none IPV6INIT="no" IPV6_AUTOCONF="no" ONBOOT=yes IPADDR=50.116.16.112 NETMASK=255.255.255.0 GATEWAY=50.116.16.1 50.116.16.112 es la IP publica del servidor Linode (personalizar). Se guardan los cambios. En el servidor Linode es posible crear una IP privada que se puede utilizar para intercambiar datos y conexiones entre distintos VPS Linode presentes en el mismo centro de datos. Esto puede ser muy útil, por ejemplo, cuando se quiera compartir un servidor MySQL entre dos servidores y/o cuando algunos servicios se configuran en un servidor y los demás servidores acceden a ellos utilizando la IP privada. Hay que tener en cuenta que todo el trafico que pase por la IP privada no viene contabilizado en el consumo mensual de banda.. Para configurar la IP privada se entra nuevamente en el menú “Remote Access” y se crea:

Aparecerá (por ejemplo):

Con esos datos se configura una tarjeta de red virtual de la siguiente manera:

19

nano /etc/sysconfig/network-scripts/ifcfg-eth0:1 Se pegan las siguientes lineas: DEVICE=eth0:1 BOOTPROTO=none ONBOOT=yes IPADDR=192.168.146.30 NETMASK=255.255.128.0 Personalizar la linea IPADDR con la IP privada asignada por Linode. Se guardan los cambios. Se continua configurando el subdominio asociado al Linode. Este dato aparece siempre en el menú “Remote Access”:

Se abre este archivo: nano /etc/sysconfig/network y se modifica esta linea: HOSTNAME=localhost.localdomain para que quede: HOSTNAME=li403-112.members.linode.com Personalizar con el dominio asignado por Linode. Para terminar se configuran algunos parámetros y alias para los comandos que más se utilizarán a lo largo del libro: nano .bash_profile al final del archivo se pegan las lineas que siguen: export EDITOR=/usr/bin/nano export PS1='\[\033[0;35m\]\H\[\033[0;33m\] \w\[\033[00m\]: ' alias free="free -m" alias aste="asterisk -rvvvvvvvvvvvvvvvvvv" alias sip="nano /etc/asterisk/sip.conf" alias ext="nano /etc/asterisk/extensions.conf" Se guardan los cambios y se recarga la configuración de la consola Linux:

20

source .bash_profile Ya se puede reiniciar el servidor remoto: reboot

21

CAPITULO II Instalación de Asterisk En este libro no se abordarán todas las configuraciones de Asterisk por motivos de espacio y porque las funcionalidades que se utilizarán para la instalación y configuración de A2Billing son mínimas. Para aquellos que quieran profundizar el tema, aconsejo el libro dedicado a Asterisk 11.X presente en el sitio web de VozToVoice. 2.1 Utilidades, librerías, dependencias Antes de la compilación e instalación de Asterisk, se instalarán una serie de librerías y dependencias que permitirán obtener una instalación de casi todos los módulos disponibles en la PBX. Se empieza con VORBIS que es una librería para la compresión/descompresión audio: yum install libvorbis libvorbis-devel vorbis-tools libogg libogg-devel -y Para el formato audio GSM se instalan los relativos paquetes: yum install gsm gsm-devel gsm-tools -y se sigue con CURL que es un cliente que permite recibir o enviar archivos utilizando los protocolos HTTP, HTTPS, FTP, GOPHER, DICT, TELNET: yum install curl curl-devel libidn-devel -y se instalan todas las librerías y dependencias que se necesitan para compilar las fuentes: yum install gcc ncurses-devel make gcc-c++ compat-libtermcap zlib-devel libtool bison \ bison-devel openssl-devel bzip2-devel wget newt-devel subversion flex gtk2-devel -y a seguir para crear y gestionar las bases de datos, MySQL: yum install mysql mysql-server mysql-devel -y Si en lugar de MySQL se quiere utilizar POSTGRESQL: yum install postgresql postgresql-devel postgresql-docs postgresql-libs postgresql-odbc postgresql-server -y

Como la base de datos interna de Asterisk desde la versión 11.X se basa en SQLite, se instala el paquete del programa y el paquete de desarrollo:

yum install sqlite sqlite-devel -y UNIXODBC que es la implementación Linux de los API ODBC que permiten conectarse a muchos sistemas de gestión de base de datos (ej: MySQL): yum install unixODBC unixODBC-devel mysql-connector-odbc libtool-ltdl-devel -y Se instala FESTIVAL, que es un sistema de text to speech (disponible con las voces en español): yum install festival festival-devel hispavoces-pal-diphone hispavoces-sfl-diphone -y Para las librerías de pjproject incluidas en Asterisk 11.X, se instala libuuid: yum install libuuid libuuid-devel uuid uuid-devel -y Se continua con la instalación de otros formatos audio: SPEEX y WAW: yum install speex speex-devel wavpack wavpack-devel -y Una vez terminada esta parte se empieza a instalar una serie de programas desde las fuentes. IMPORTANTE: Para todos los programas que se instalan desde las fuentes, antes de descargarlos, averiguar si hay una versión más reciente disponible. El primero es LAME que es utiliza para codificar archivos audio en formato MP3: cd /usr/src wget http://ufpr.dl.sourceforge.net/sourceforge/lame/lame-3.99.5.tar.gz Se descomprime: tar -xf lame-3.99.5.tar.gz Se entra en la carpeta creada: cd lame-3.99.5 Se inicia la compilación: ./configure --prefix=/usr --libdir=/usr/lib64 La mayoría de los programas que se compilan desde las fuentes se instalan por defecto en la carpeta /usr/local. Es por eso que en la linea del configure se especifica que la carpeta donde se quiere que se 24

instalen es la /usr. Lo mismo pasa con las librerías del programa. Como el sistema es 64bit se especifica la carpeta donde se quiere que se instalen las librerías make el comando make compila las fuentes creando todos los archivos ejecutables y librerías que luego se instalarán con el comando que sigue: make install con make install se instala el programa y las librerías compiladas. Se continua con LIBMAD que es un MPEG audio decodificador de alta calidad: cd /usr/src wget http://prdownloads.sourceforge.net/mad/libmad-0.15.1b.tar.gz tar -xf libmad-0.15.1b.tar.gz cd libmad-0.15.1b ./configure --prefix=/usr --libdir=/usr/lib64 Para que la compilación tenga éxito hay que modificar una linea del Makefile: nano +129 Makefile CFLAGS = -Wall -g -O -fforce-mem -fforce-addr -fthread-jumps -fcse-follow-jumps -fcse-skipblocks -fexpensive-optimizations -fregmove -fschedule-insns2 para que quede: CFLAGS = -Wall -g -O -fforce-addr -fthread-jumps -fcse-follow-jumps -fcse-skip-blocks -fexpensive-optimizations -fregmove -fschedule-insns2 se continua con la compilación e instalación: make make install Se termina esta primera parte con SOX que es un programa que permite la manipulación de archivos audio y la posibilidad de transformarlos de un formato a otro: cd /usr/src

25

wget http://downloads.sourceforge.net/project/sox/sox/14.4.2/sox-14.4.2.tar.gz tar -xf sox-14.4.2.tar.gz cd sox-14.4.2 ./configure --prefix=/usr --libdir=/usr/lib64 Al finalizar el configure aparecerá esta tabla donde se encontrarán todos los formatos audio que se podrán manipular con SOX:

Se termina con la compilación e instalación: make make install 2.2 DAHDI El paquete DADHI (Digium Asterisk Hardware Device Interface) permite cargar los drivers y configurar distintos tipos de tarjetas en Asterisk (analógicas, digitales, RDSI/ISDN, cancelador de ECHO). Asterisk además se apoya en DAHDI para las conferencias audio (modulo app_meetme). Aunque su instalación ya no es indispensable ya que para las conferencias audio existe la aplicación ConfBridge que es mucho más completa, se instalará para tener todos los módulos disponibles. Se instala el paquete de desarrollo del Kernel: yum install kernel-devel -y Se continua con la ultima versión disponible de DAHDI-Linux: 26

cd /usr/src wget http://downloads.asterisk.org/pub/telephony/dahdi-linux/dahdi-linux-current.tar.gz tar -xf dahdi-linux-current.tar.gz cd dahdi-linux-2.11.1 make make install Se termina con la ultima versión disponible de DAHDI-Tools: cd /usr/src wget http://downloads.asterisk.org/pub/telephony/dahdi-tools/dahdi-tools-2.10.2.tar.gz tar -xf dahdi-tools-2.10.2.tar.gz cd dahdi-tools-2.10.2 ./configure Se termina con la compilación e instalación: make make install make config Como no se van a instalar tarjetas (en el caso del servidor remoto), se pueden comentar todo los controladores que aparecen el el archivo /etc/dahdi/modules. Luego se puede iniciar DAHDI: /etc/init.d/dahdi start Loading DAHDI hardware modules: Running dahdi_cfg:

[ OK ]

2.3 LIBPRI En el caso que se quiera instalar tarjetas digitales en el servidor Asterisk (E1, T1, ISDN), después de instalar DAHDI, hay que instalar la librería libpri: cd /usr/src wget http://downloads.asterisk.org/pub/telephony/libpri/libpri-1.5.0.tar.gz 27

se descomprime: tar -xf libpri-1.5.0.tar.gz se entra en la carpeta: cd libpri-1.5.0 se compila y se instala: make make install 2.4 App_fax, GoogleTalk, LibiCAL y SRTP En este párrafo se verá como instalar SpanDSP, un procesador de señales digitales que en Asterisk permite la instalación del modulo res_fax para la recepción y envío de FAX, IKSEMEL que permite implementar el protocolo XMPP en Asterisk y de esta forma conectarse a GoogleTalk y/o a cualquier servidor con protocolo XMPP (otro ejemplo es Openfire), LibiCAL que permite conectar Asterisk a los calendarios que utilizan el protocolo iCAL y libSRTP que permite cifrar el flujo media de las llamadas. Para SpanDSP se necesita instalar primero las librerías libtiff y libxml2: yum install libtiff libtiff-devel libxml2 libxml2-devel -y se continua con SpanDSP desde los repositorios EPEL: yum --enablerepo=epel install spandsp spandsp-apidoc spandsp-devel -y El protocolo XMPP permite conexione seguras entre cliente y servidor utilizando el protocolo TLS; para ese efecto se instala, antes de IKSEMEL las relativas librerías: yum install gnutls gnutls-devel gnutls-utils -y se continua con IKSEMEL (desde los repositorios EPEL): yum --enablerepo=epel install iksemel iksemel-devel iksemel-utils -y Se continua con la preparación del sistema con unos programas más. Primero un servidor de correo electrónico, SENDMAIL: yum install sendmail sendmail-devel sendmail-cf -y 28

Se remueve el servidor de correo electrónico predefinido POSTFIX: service postfix stop yum remove postfix -y Se configura para que arranque en automático: chkconfig sendmail on El subdominio configurado en el párrafo 1.3, se utilizará también para el envío de los correos electrónicos. Por defecto el servidor de correo electrónico escucha solamente en la puerto TCP 25 local. Solamente si se necesita que sea alcanzable desde remoto (para recibir correos electrónicos) hay que abrir el archivo de configuración de Sendmail: nano /etc/mail/sendmail.mc buscar esta linea (para buscar un texto con el editor Nano hay que presionar la combinación de teclas CTRL-W): DAEMON_OPTIONS(`Port=smtp,Addr=127.0.0.1, Name=MTA')dnl y modificar como sigue: DAEMON_OPTIONS(`Port=smtp,, Name=MTA')dnl se guardan los cambios y se vuelve a compilar la configuración de Sendmail: make -C /etc/mail se inicia el servidor de correo: /etc/init.d/sendmail start OpenLDAP es la versión open source del protocolo Lightweight Directory Access. Normalmente se utiliza para crear un directorio de usuarios que puede ser consultado y/o modificado desde remoto. Muchos programas implementan la posibilidad de conectarse a un servidor OpenLDAP y Asterisk, desde la versión 1.6.X, presenta esta posibilidad: yum install compat-openldap openldap openldap-clients openldap-devel openldap-servers -y SNMP es el Protocolo Simple de Administración de Red y sirve para controlar y monitorear el desempeño del servidor Linux. En Asterisk permite monitorear, entre otras cosas, los canales y las llamadas. Se utilizará junto a NAGIOS para controlar el servidor Asterisk y enviar avisos cuando se verifique algún tipo de problema:

29

yum install net-snmp net-snmp-devel net-snmp-libs net-snmp-utils -y En Asterisk existe la posibilidad de guardar los registros de las llamadas en un servidor RADIUS a través de un cliente RADIUS que hay que instalar. En este caso se instala desde las fuentes: yum --enablerepo=epel install radiusclient-ng radiusclient-ng-devel radiusclient-ng-utils -y Se continua la preparación del servidor con la instalación del lenguaje de programación LUA que permite escribir el dialplan (o plan de marcado) utilizando este lenguaje. Al terminar la instalación de Asterisk se encontrará un archivo de ejemplo en la carpeta /etc/asterisk. yum install lua lua-devel -y Para terminar se compilan los paquetes que permiten utilizar las nuevas funcionalidades de Asterisk. Primero LIBICAL que permite la implementación del protocolo iCalendar (RFC5546) en Asterisk a través del modulo res_calendar: yum install libical libical-devel -y Luego NEON que es una librería que permite la implementación del protocolo WebDAV en Asterisk: yum install neon neon-devel -y Por ultimo la librería LIBSRTP que permite implementar el cifrado del flujo media en Asterisk a través del protocolo SRTP (RFC3711): yum --enablerepo=epel install libsrtp libsrtp-devel -y 2.5 Instalación de Asterisk Terminada la preparación del servidor, se inicia con la instalación de Asterisk. Se descarga la ultima versión 11.X disponible: cd /usr/src wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-11.23.1.tar.gz tar -xf asterisk-11.23.1.tar.gz cd asterisk-11.23.1 ./configure --libdir=/usr/lib64 make menuselect

30

Desde la versión 1.8.X lo que antes era un paquete a parte (asterisk-addons) ahora es presente en el paquete principal de Asterisk. Como se puede notar, los módulos relacionados con MySQL (menos res_mysql) son “deprecated” y en las versiones futuras de Asterisk serán eliminados. Se entra en el menú “Add-ons” y se activan los paquetes que siguen:

Desde la versión 11.X, la aplicación MeetMe (conferencias audio) está desactivada. Asegurarse seleccionarla para que el modulo sea compilado (menú izquierdo Applications):

En “Resource modules” se controla que el modulo relacionado con el cifrado del flujo media esté activado:

Para servidores virtualizados, en el menú “Compiler Flags” de desactiva el parámetro BUILD_NATIVE (si está activado):

Se seleccionan todos los módulos en el menú “Utilities” y “AGI Samples”:

31

En “Core Sound Packages”, “Music On Hold File Packages” y “Extra Sound Packages” se seleccionan todos los paquetes disponibles. Se guarda la configuración presionando la tecla tabulador hasta posicionarse sobre “Save & Exit”. Se termina con la compilación e instalación: make Si a lo largo de la compilación aparece este error: make[1]: *** [format_mp3.o] Error 1 make: *** [addons] Error 2 se resuelve con: contrib/scripts/get_mp3_source.sh y se continua otra vez con el make: make se instala Asterisk: make install se instalan los archivos de configuración predefinidos: make samples 32

se configura el script de arranque de Asterisk: make config Terminada la instalación, se procede con la configuración de MySQL para crear la base de datos y la tabla donde se guardarán los registros de las llamadas. /etc/init.d/mysqld start se configura para que arranque en automático: chkconfig mysqld on y se crea una contraseña para el usuario root de MySQL (sesamo): IMPORTANTE: para un sistema en producción utilizar siempre contraseñas fuertes mysqladmin -u root password sesamo Para poner en seguridad el servidor MySQL se ejecuta el programa: mysql_secure_installation Se contestan las preguntas somo sigue: Enter current password for root (enter for none): sesamo OK, successfully used password, moving on... Change the root password? [Y/n] n ... skipping. Remove anonymous users? [Y/n] y ... Success! Disallow root login remotely? [Y/n] y ... Success! Remove test database and access to it? [Y/n] y - Dropping test database... Reload privilege tables now? [Y/n] y ... Success! Cleaning up... 33

All done! If you've completed all of the above steps, your MySQL installation should now be secure. Thanks for using MySQL! Se configura la zona horaria en MySQL: mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -psesamo mysql Warning: Unable to load '/usr/share/zoneinfo/iso3166.tab' as time zone. Skipping it. Warning: Unable to load '/usr/share/zoneinfo/zone.tab' as time zone. Skipping it. nano /etc/my.cnf Bajo la etiqueta [mysqld] se añade (personalizar): default-time-zone = America/Bogota Se reinicia el servidor MySQL: service mysqld restart Se crea la base de datos para guardar los registros de las llamadas de Asterisk. Se entra en el cliente de MySQL: mysql -u root -psesamo se crea la base de datos asteriskcdr: mysql> create database asteriskcdr; se selecciona: mysql> use asteriskcdr se crea la tabla cdr (copiando y pegando las lineas que siguen): mysql> CREATE TABLE cdr ( calldate datetime NOT NULL default '0000-00-00 00:00:00', clid varchar(80) NOT NULL default '', src varchar(80) NOT NULL default '', dst varchar(80) NOT NULL default '', dcontext varchar(80) NOT NULL default '', channel varchar(80) NOT NULL default '', dstchannel varchar(80) NOT NULL default '', lastapp varchar(80) NOT NULL default '', lastdata varchar(80) NOT NULL default '', 34

duration int(11) NOT NULL default '0', billsec int(11) NOT NULL default '0', disposition varchar(45) NOT NULL default '', amaflags int(11) NOT NULL default '0', accountcode varchar(20) NOT NULL default '', peeraccount varchar(20) NOT NULL default '', uniqueid varchar(32) NOT NULL default '', linkedid varchar(80) NOT NULL default '', userfield varchar(255) NOT NULL default '', KEY callerid (clid) ); Con la versión 1.8 de Asterisk se han añadido dos nuevos campos a la tabla CDR: • •

linkedid peeraccount

que permiten tener informaciones más detalladas de cada llamada. Se otorgan los permisos de acceso a la base de datos creada al usuario asterisk, desde local: mysql> GRANT ALL PRIVILEGES ON asteriskcdr.* TO 'asterisk'@'localhost' IDENTIFIED BY 'sesamo'; desde remoto (solamente si se necesita acceder a la base de datos desde otro servidor): mysql> GRANT ALL PRIVILEGES ON asteriskcdr.* TO 'asterisk'@'%' IDENTIFIED BY 'sesamo'; se actualizan los permisos: mysql> flush privileges; se sale del cliente: mysql> quit En Asterisk la conexión a la base de datos y la tabla de los registros de las llamadas, se configura en el archivo cdr_mysql.conf. Se renombra el predefinido: mv /etc/asterisk/cdr_mysql.conf /etc/asterisk/cdr_mysql.conf.old se crea uno nuevo: nano /etc/asterisk/cdr_mysql.conf se añaden las siguientes lineas: 35

[global] hostname=127.0.0.1 dbname=asteriskcdr table=cdr password=sesamo user=asterisk port=3306 sock=/var/lib/mysql/mysql.sock Los datos: 1. 2. 3. 4. 5. 6. 7. 8.

[global] – etiqueta inicial del bloque hostname - nombre de dominio o IP del servidor MySQL (en este caso local) dbname - nombre de la base de datos table - nombre de la tabla password - contraseña del usuario que tiene los permisos para acceder a la base de datos user - nombre del usuario que tiene los permisos para acceder a la base de datos port – puerto donde MySQL recibirá las conexiones (predefinido 3306) sock – archivo que se crea cuando se inicia MySQL. Se necesita indicar para una correcta conexión en el caso en que en hostname se indique “localhost”.

Se guardan los cambios y se inicia Asterisk: /etc/init.d/asterisk start se averigua que esté corriendo: /etc/init.d/asterisk status asterisk (pid 2403) is running... se entra en la consola: asterisk -rvvvvvvvvvvvvvvvv se controla que la conexión a la base de datos esté activa: CLI> cdr mysql status Connected to asteriskcdr@localhost, port 3306 using table cdr for 59 seconds. Wrote 0 records since last restart. Se sale de la consola: CLI> quit Asterisk cleanly ending (0). Executing last minute cleanups

36

Capitulo III Instalación A2Billing A2billing es un Softswitch de clase 4 y clase 5. Un softswitch de clase 4 es un sistema capaz de enrutar una gran cantidad de llamadas y permite la conexión entre distintos operadores; un softswitch de clase 5 es un sistema utilizado para brindar servicios de valor añadido a los usuarios finales. A2Billing es el único sistema de facturación para Asterisk distribuido bajo una licencia Open Source (GNU GPL) basado en MySQL o PostgreSQL para las base de datos y PHP como lenguaje de programación. Se puede utilizar: • • • • •

Como sistema de tarjetas telefónicas a través de números de acceso telefónicos; Como sistema de venta de trafico telefónico al por mayor (Wholesale) Como sistema para la facturación de las llamadas Como sistema de venta de números geográficos (DID) Como sistema para la gestión de revendedores

3.1 Preparación del sistema A2billing requiere por lo menos la versión 5.3 de PHP. En la versión de CentOS 6.8 esta versión está disponible pues se instalará junto al servidor Web Apache y el modulo SSL (para conexiones seguras hacia el servidor Web): yum install php php-gd php-mysql php-process httpd mod_ssl php-cli php-soap php-xml -y Luego se instala php-mcrypt activando el repositorio epel: yum --enablerepo=epel install php-mcrypt -y Terminada esta operación, se configura la zona horaria en el archivo de configuración de PHP (php.ini) nano +946 /etc/php.ini Se modifica la linea para que quede (en el caso de Colombia): date.timezone = America/Bogota En el mismo archivo se busca esta linea: upload_max_filesize = 2M

y se modifica para que quede: upload_max_filesize = 8M De esta forma se podrán cargar los archivos de las tarifas que tengan un tamaño de hasta 8 MegaBytes Siempre en el mismo archivo, se busca esta linea: error_reporting = E_ALL & ~E_DEPRECATED y se modifica para que quede: error_reporting = E_ALL & ~E_NOTICE de esta forma en los LOG del servidor web aparecerán solamente los errores, si presentes, relacionados con el lenguaje PHP. Se guardan los cambios y se descarga la ultima versión disponible de A2Billing: cd /usr/local/src wget https://github.com/Star2Billing/a2billing/archive/v2.2.0.tar.gz Se descomprime: tar -xf v2.2.0.tar.gz se renombra la carpeta creada: mv a2billing-2.2.0 a2billing cd a2billing A partir de la versión 2.1.1 de A2Billing se utiliza Composer para instalar toda las dependencias; como algunas se instalan utilizando el programa GIT: yum install git -y Se continua utilizando Composer para instalar las dependencias: curl -sS https://getcomposer.org/installer | php php composer.phar update php composer.phar install Se entra en el cliente MySQL: mysql -u root -psesamo se crea la base de datos a2billing: 39

mysql> create database a2billing; Query OK, 1 row affected (0.00 sec) se otorgan los permisos de acceso a la base de datos creada al usuario a2user identificado con la contraseña sesamo desde local: mysql> GRANT ALL PRIVILEGES ON a2billing.* TO 'a2user'@'localhost' IDENTIFIED BY 'sesamo'; Query OK, 0 rows affected (0.00 sec) se actualizan los permisos: mysql> flush privileges; Query OK, 0 rows affected (0.00 sec) se sale del cliente MySQL: mysql> quit Bye Se crean las tablas en la base de datos a2billing utilizando el script presente en la siguiente carpeta: cd DataBase/mysql-5.x/ se ejecuta: ./install-db.sh Se insertan los datos como mostrado en la imagen que sigue:

40

Para resumir: Database Name: a2billing Hostname: localhost Username: root Password: sesamo Se instalan las locuciones distribuidas con el programa (ingles, francés, español, portugués y ruso): cd /usr/local/src/a2billing/addons/sounds/ utilizando el siguiente script: ./install_a2b_sounds.sh La verdad la calidad de las locuciones en español no son muy buenas y algunas faltan del todo. En la misma carpeta se encuentra el archivo Audio_text.info que contiene todos los nombres de las locuciones disponibles con relativas frases. Puede ser una buena ayuda para grabar las propias. Se continua la instalación copiando el archivo de configuración de a2billing en la carpeta /etc: cp /usr/local/src/a2billing/a2billing.conf /etc/ se abre con el editor: nano /etc/a2billing.conf se modifican estas lineas: [database] hostname = localhost port = user = a2billing_dbuser password = a2billing_dbpassword dbname = a2billing_dbname dbtype = mysql para que queden: [database] hostname = localhost port = 3306 user = a2user password = sesamo dbname = a2billing dbtype = mysql

41

Se guardan los cambios. Por defecto A2billing trabaja con Asterisk en Realtime, es decir que las extensiones SIP y IAX2 se guardan en la base de datos a2billing y Asterisk accede a ellas a través de la configuración del modulo de Realtime. Existe también la posibilidad de guardar la configuración de las extensiones en archivos de texto. Para este tipo de configuración se crean dos archivos que son los que a2billing utilizará para guardar las extensiones SIP y IAX2: touch /etc/asterisk/additional_a2billing_iax.conf touch /etc/asterisk/additional_a2billing_sip.conf se asignan los permisos de escritura/lectura para estos dos archivos al usuario y grupo apache, es decir el servidor Web: chown -Rf apache:apache /etc/asterisk/additional_a2billing_iax.conf chown -Rf apache:apache /etc/asterisk/additional_a2billing_sip.conf A2Billing para recargar la configuración de Asterisk (en el caso que las extensiones se guarden en los archivos que se acaban de crear) y para generar las llamadas de callback se apoya al AMI (Asterisk Manager Interface) de la PBX. Es por eso que hay que configurar el archivo manager.conf. Se abre: nano /etc/asterisk/manager.conf Se cambian las siguientes tres lineas: enabled = no ;allowmultiplelogin = yes ;displayconnects = yes para que queden: enabled=yes allowmultiplelogin = yes dislplayconnects=yes El usuario predefinido en la configuración de A2billing para conectarse al AMI de Asterisk es myasterisk con contraseña mycode. Para evitar de trabajar con configuraciones predefinidas, se cambiaran estos datos respectivamente con asterisk y sesamo: [asterisk] secret=sesamo deny=0.0.0.0/0.0.0.0 permit=127.0.0.1/255.255.255.255 read = system,call,log,verbose,agent,user,config,dtmf,reporting,cdr,dialplan write = system,call,agent,user,config,command,reporting,originate Se guardan los cambios y se continua con los script AGI presentes en el paquete de A2Billing. Uno se 42

utiliza para realizar las llamadas (a2billing.php) y el segundo para monitorear el servidor (a2billing_monitoring.php). Se entra en la carpeta que contiene los AGI: cd /usr/local/src/a2billing/AGI se crean dos enlaces simbólicos de los dos AGI en la carpeta /var/lib/asterisk/agi-bin que es donde Asterisk los busca de manera predefinida: ln -s /usr/local/src/a2billing/AGI/a2billing.php /var/lib/asterisk/agi-bin/a2billing.php ln -s /usr/local/src/a2billing/AGI/a2billing_monitoring.php /var/lib/asterisk/agi-bin/a2billing_monitoring.php

Como los AGI se apoyan en una serie de librerías contenidas en la carpeta /lib, se crea un enlace simbólico también a esta carpeta: ln -s /usr/local/src/a2billing/AGI/lib /var/lib/asterisk/agi-bin/lib Se vuelven ejecutables los dos archivos: chmod +x /var/lib/asterisk/agi-bin/a2billing.php chmod +x /var/lib/asterisk/agi-bin/a2billing_monitoring.php Una vez terminada esta parte se crean una series de carpetas. La primera es donde se guardarán los archivos temporales y los script de A2Billing: mkdir -p /var/lib/a2billing/script la segunda donde se guardará el proceso del servicio de callback: mkdir -p /var/run/a2billing Ahora ya se puede crear un enlace simbólico a las carpetas que se necesitan para la parte Web de A2billing que son: • • • •

admin (para la conexión de los administradores) customer (para la conexión de los clientes) agent (para la conexión de los agentes/revendedores) common (librerías compartidas por los tres tipos de usuarios)

ln -s /usr/local/src/a2billing/admin/ /var/www/html/admin ln -s /usr/local/src/a2billing/agent/ /var/www/html/agent ln -s /usr/local/src/a2billing/customer/ /var/www/html/customer ln -s /usr/local/src/a2billing/common/ /var/www/html/common Se cambian los permisos en las tres carpetas que siguen que es donde se guardarán los archivos temporales para cada tipo de usuario: chmod 755 /usr/local/src/a2billing/admin/templates_c 43

chmod 755 /usr/local/src/a2billing/customer/templates_c chmod 755 /usr/local/src/a2billing/agent/templates_c Se cambia el usuario y grupo que tiene acceso a todas las carpetas creadas (el servidor Web Apache): chown -R apache:apache /var/www/html/ chown -R apache:apache /var/www/html/admin/ chown -R apache:apache /var/www/html/agent/ chown -R apache:apache /var/www/html/customer/ chown -R apache:apache /var/www/html/common/ Los registros de las actividades de A2Billing se guardan en una serie de archivos que hay que crear antes de acceder por primera vez al programa. Primero se crea la carpeta: mkdir /var/log/a2billing se entra en la carpeta y se crean los archivos: cd /var/log/a2billing touch cront_a2b_alarm.log cront_a2b_autorefill.log cront_a2b_batch_process.log \ cront_a2b_archive_data.log cront_a2b_bill_diduse.log cront_a2b_subscription_fee.log \ cront_a2b_currency_update.log cront_a2b_invoice.log cront_a2b_check_account.log \ a2billing_paypal.log a2billing_epayment.log a2billing_api_ecommerce_request.log \ a2billing_api_callback_request.log a2billing_api_card.log a2billing_agi.log Se cambian los permisos para que el usuario apache (el servidor Web) pueda escribir en ellos: chown apache:apache /var/log/a2billing/* A2biblling necesita que se ejecuten una serie de script para monitorear el sistema y para elaborar algunas funciones (ejemplo: pagos, facturas, etc.). Estos script se añaden al cron del sistema para el usuario root: crontab -e Se pegan las siguientes lineas: # A2Billing # Para actualizar la tasa de cambio de las monedas 0 6 * * * php /usr/local/src/a2billing/Cronjobs/currencies_update_yahoo.php # Para el pago se servicios subscritos 0 6 1 * * php /usr/local/src/a2billing/Cronjobs/a2billing_subscription_fee.php # Para notificaciones cuando el credito del cliente es más bajo de lo indicado 0 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_notify_account.php # Para el pago de los numeros geograficos asociados a los clientes 0 2 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_bill_diduse.php 44

# Para el pago de servicios periódicos 0 12 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_process.php # Para la generación de las facturas de los clientes 0 6 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_billing.php # Para la generación de llamadas automáticas utilizadas en las campañas # */5 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_autodialer.php # Para la gestión de las alarmas que se pueden configurar en A2Billing 0 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_alarm.php # Para archivar los datos de las llamadas más viejos de lo indicado en la configuración de A2Billing 0 12 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_archive_data_cront.php # Para recargar el crédito de un cliente en automático 0 6 1 * * php /usr/local/src/a2billing/Cronjobs/a2billing_autorefill.php Se deja comentada la linea a2billing_batch_autodialer.php ya que no se pueden realizar las campañas de llamadas con A2Billing. Se guardan las modificaciones e se reinicia Cron: /etc/init.d/crond restart 3.2 Instalación del demonio CallBack El demonio para el Callback es el que permite utilizar el sistema de rellamada de A2Billing. El programa es escrito en el lenguaje de programación Python y es por eso que primero hay que instalar unos paquetes que se necesitan para su compilación: yum install python-setuptools MySQL-python python-devel -y Luego, a través de easy_install, se instala el programa sqlalchemy: easy_install sqlalchemy Una vez satisfechas estas dependencias, se puede empezar con la compilación y instalación del programa de callback: cd /usr/local/src/a2billing/CallBack/callback-daemon-py/dist/ tar -xf callback_daemon-1.0.prod-r1528.tar.gz cd callback_daemon-1.0.prod-r1528 se compila: python setup.py build python setup.py bdist_egg easy_install dist/callback_daemon-1.0.prod_r1528-py2.6.egg

45

Compilado el programa se instala come servicio a través de uno script presente en el paquete de A2Billing: cd /usr/local/src/a2billing/CallBack/callback-daemon-py/callback_daemon Se copia el script: cp a2b-callback-daemon.rc /etc/init.d/a2b-callback-daemon Se vuelve ejecutable: chmod +x /etc/init.d/a2b-callback-daemon Se añade a la lista de servicios: chkconfig --add a2b-callback-daemon Por defecto el servicio guarda los registros en la carpeta /var/log y tiene que arrancar después de MySQL y Asterisk. Para ese efecto hay que abrir el archivo: nano /etc/init.d/a2b-callback-daemon y cambiar estas lineas: # chkconfig: 2345 40 60 LOG='/var/log/a2b-callback-daemon.log' para que queden: # chkconfig: 2345 95 60 LOG='/var/log/a2billing/a2b-callback-daemon.log' Se guardan las modificaciones y se configura para que arranque en automático con el sistema: chkconfig a2b-callback-daemon on Ahora ya se puede iniciar el servicio: /etc/init.d/a2b-callback-daemon start a2b_callback_daemon está parado Starting a2b-callback-daemon:

[ OK ]

y controlar que esté funcionando: tail -f /var/log/a2billing/a2b-callback-daemon.log "2011-04-23 19:10:52,297 - root - MainThread - INFO - waiting..." 46

"2011-04-23 19:10:57,308 - root - MainThread - INFO - waiting..." "2011-04-23 19:11:02,322 - root - MainThread - INFO - waiting..." "2011-04-23 19:11:07,355 - root - MainThread - INFO – waiting..." Se sale del comando tail con CTRL-C IMPORTANTE: cada vez que se reinicia Asterisk hay que reiniciar el servicio de callback ya que pierde la conexión a la AMI de Asterisk. 3.3 Configuración de Asterisk Como ya se ha dicho anteriormente, en esta guía no se explicarán las configuraciones de Asterisk de forma detallada pero es importante saber que los archivos que se modifican son solamente los que se necesitan para que A2Billing funcione. 3.3.1 sip.conf En el archivo sip.conf se configurará la/s troncal/es para sacar las llamadas hacia el proveedor VoIP. Se renombra el sip.conf predefinido: mv /etc/asterisk/sip.conf /etc/asterisk/sip.conf.old se crea uno nuevo: nano /etc/asterisk/sip.conf se pegan las siguientes lineas: [general] context=default allowguest=no allowtransfer=no match_auth_username=yes realm=asterisk udpbindaddr=0.0.0.0:5060 tcpenable=no tcpbindaddr=0.0.0.0:5060 tcpauthtimeout=30 tcpauthlimit=100 transport=udp srvlookup=yes pedantic=yes maxexpiry=3600 minexpiry=60 47

defaultexpiry=120 mwiexpiry=3600 maxforwards=70 qualifyfreq=20 qualifygap=200 keepalive=yes disallow=all allow=ulaw allow=alaw mohinterpret=default mohsuggest=default language=es relaxdtmf=no sendrpid = yes prematuremedia=no progressinband=no useragent=LibroA2Billing promiscredir=no dtmfmode = rfc2833 videosupport=yes maxcallbitrate=384 callevents=yes alwaysauthreject=yes rtptimeout=60 rtpholdtimeout=300 allowsubscribe=yes subscribecontext=subscribe notifyringing=yes notifyhold=yes callcounter = yes t38pt_udptl = yes,fec,maxdatagram=400 faxdetect=yes directmedia=no sdpsession=A2Billing sdpowner=a2billing externaddr=IPservidor localnet=192.168.146.0/255.255.255.0 Antes de guardas los cambio, personalizar las siguientes Lineas: • • •

useragent: nombre que se quiere dar a la PBX externaddr: IP publica del servidor localnet: rango de IP locales en el caso en que en el servidor se haya configurado la IP privada (como es el caso del VPS Linode)

Siempre en el mismo archivo se añaden los datos para configurar las troncales. En este caso se crean dos de ejemplo con el mismo proveedor; una utilizando un servidor/dominio, otra utilizando otro 48

servidor/dominio de respaldo. En las dos la autenticación será con usuario y contraseña. Para un sistema en producción configurar las troncales de sus proveedores). Si quieren utilizar una cuenta de prueba, pueden abrir una con la empresa VozToVoice. Recibirán un dólar de crédito para las pruebas. [voztovoice1] type=peer port=5060 host=sip.voztovoice.eu defaultuser=usuario fromuser=usuario secret=contraseña dtmfmode=rfc2833 disallow=all context=from-trunk canreinvite=no allow=ulaw allow=alaw qualify=yes [voztovoice2] type=peer port=5060 host=sip1.voztovoice.eu defaultuser=usuario fromuser=usuario secret=contraseña dtmfmode=rfc2833 disallow=all context=from-trunk canreinvite=no allow=ulaw allow=alaw qualify=yes • • •

defaultuser: nombre de usuario de la cuenta creada fromuser: nombre de usuario de la cuenta creada secret: contraseña asociada al nombre de usuario de la cuenta creada

En el caso que el proveedor permita la autenticación sobre IP, un ejemplo típico y bastante general de configuración sería: [voztovoice1] type=peer qualify=yes host=sip.voztovoice.eu disallow=all allow=g729,alaw 49

nat=no Para terminar, se incluye el archivo que se ha creado en el primer párrafo y que contendrá las extensiones creadas en A2Billing en el caso en que no se utilice el Realtime: #include additional_a2billing_sip.conf Se guardan los cambios y se hace lo mismo con el archivo iax.conf en el caso en que se quiera configurar también extensiones IAX2 (no recomendado): echo "#include additional_a2billing_iax.conf" >> /etc/asterisk/iax.conf 3.3.2 extensions.conf Se sigue con el dialplan. Se renombra el archivo extensions.conf predefinido: mv /etc/asterisk/extensions.conf /etc/asterisk/extensions.conf.old Se crea uno nuevo: nano /etc/asterisk/extensions.conf se pegan las lineas que siguen: [general] static = yes writeprotect = no autofallthrough = yes extenpatternmatchnew = true clearglobalvars = no userscontext=default [globals] ; Variables globales y se incluye el contexto para las llamadas con el AGI de a2billing: [a2billing] exten => _X.,1,NoOp(A2Billing Start) same => n,Agi(a2billing.php,1) same => n,Hangup exten => h,1,Hangup Si se quisiera brindar la posibilidad de marcar los números como se haría en el país de la empresa/clientes (en este caso Colombia), se añaden los tres bloques que siguen: [colombia] 50

exten => _09[12,4-9]XXXXXXX,1,NoOp(Llamadas a Fijos de Colombia con 09) same => n,Goto(a2billing,57${EXTEN:2},1) same => n,Hangup exten => _[12,4-9]XXXXXXX,1,NoOp(Llamadas a Fijos de Colombia sin) same => n,Goto(a2billing,57${EXTEN:2},1) same => n,Hangup exten => _3XXXXXXXXX,1,NoOp(Llamadas a Celulares de Colombia) same => n,Goto(a2billing,57${EXTEN},1) same => n,Hangup Se guardan los cambios y se averigua que efectivamente el dialplan englobado esté presente. Se entra en la consola de Asterisk: asterisk -rvvvvvvvvvvvvvv se recarga el dialplan: CLI> dialplan reload aparecerán muchas lineas porque hay partes de dialplan escritas en otros lenguajes que son leídas por Asterisk. Si no se van a utilizar, es mejor desactivar los respectivos módulos. Se sale de la consola de Asterisk: CLI> quit Se abre el siguiente archivo: nano /etc/asterisk/modules.conf y al final se añaden las lineas que siguen: noload => pbx_lua.so noload => pbx_ael.so Se guardan los cambios y se reinicia Asterisk y luego el sistema de callback: service asterisk restart service a2b-callback-daemon restart Se revisa uno de los contextos recien creados. Para acceder a la consola de Asterisk se utiliza el alias creado a lo largo del párrafo 1.3: aste CLI> dialplan show a2billing 51

debe aparecer: [ Context 'a2billing' created by 'pbx_config' ] 'h' => 1. Hangup() [pbx_config] '_X.' => 1. NoOp(A2Billing Start) [pbx_config] 2. Agi(a2billing.php,1) [pbx_config] 3. Hangup() [pbx_config] -= 2 extensions (4 priorities) in 1 context. =CLI> quit Se sale de la consola de Asterisk. 3.3.3 Asterisk Realtime Las extensiones creadas a través del sistema de facturación se guardarán en la base de datos de A2Billing. Para que Asterisk las pueda leer y actualizar, hay que configurar Asterisk utilizando su funcionalidad, llamada Realtime, que le permite interaccionar con base de datos para la configuración, en este caso, de las extensiones SIP e IAX. En este libro la configuración se realizará utilizando ODBC en lugar de utilizar directamente MySQL. Esto con el objetivo de obtener un mejor rendimiento y una más alta estabilidad. El primer paso es configurar ODBC para la conexión a MySQL: mv /etc/odbcinst.ini /etc/odbcinst.old nano /etc/odbcinst.ini se añaden las siguientes lineas: [MySQL] Description = ODBC for MySQL Driver = /usr/lib64/libmyodbc5.so Setup = /usr/lib64/libodbcmyS.so FileUsage = 1 Se guardan los cambios y se continua con la conexión a la base de datos a2billing: nano /etc/odbc.ini se añaden las siguientes lineas: [a2billing] Description = MySQL a2billing 52

Driver = MySQL Database = a2billing Server = localhost User = a2user Password = sesamo Port = 3306 Option = 3 Se guardan los cambios y se prueba la conexión utilizando los datos configurados en odbc.ini (base de datos, usuario, contraseña del usuario): isql a2billing a2user sesamo Tiene que aparecer: +---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ SQL> Para salir: SQL> quit Se pasa a Asterisk. En la PBX la configuración Realtime con ODBC se efectúa en dos archivos: • •

extconfig.conf res_odbc.conf

El el primero se define que las extensiones SIP e IAX deberán ser configuradas en Realtime utilizando ODBC y la base de datos a2billing: nano /etc/asterisk/extconfig.conf se modifican estas lineas: ;iaxusers => odbc,asterisk ;iaxpeers => odbc,asterisk ;sippeers => odbc,asterisk para que queden:

53

iaxusers => odbc,a2b,cc_iax_buddies iaxpeers => odbc,a2b,cc_iax_buddies sippeers => odbc,a2b,cc_sip_buddies Se guardan los cambios. cc_iax_buddies y cc_sip_buddies son las tablas de la base de datos A2billing donde están guardadas las extensiones creadas en el sistema de facturación. A2b es el nombre de la etiqueta que se configurará en el archivo res_odbc.conf. Para terminar se configura el archivo res_odbc.conf: nano /etc/asterisk/res_odbc.conf al final del archivo se añaden las siguientes lineas: [a2b] enabled => yes dsn => a2billing username => a2user password => sesamo pre-connect => yes sanitysql => select 1 idlecheck => 3600 connect_timeout => 10 La conexión funciona de la siguiente manera. En el archivo extconfig.conf se define la conexión a la base de datos utilizando el nombre que aparece como etiqueta del bloque presente en el archivo res_odbc.onf (en este caso el nombre es a2b). En el archivo res_odbc.conf en el parámetro dsn se pone el nombre de la etiqueta del bloque configurado en el archivo odbc.ini (a2billing). En el archivo odbc.ini se define la conexión a la base de datos MySQL (en este caso la base de datos se llama a2billing). Se reinicia Asterisk, el sistema de callback y se averigua que la conexión esté funcionando: /etc/init.d/asterisk restart service a2b-callback-daemon restart asterisk -rvvvvvvvvvvvvvvvvv CLI> odbc show la respuesta debe ser: ODBC DSN Settings ----------------Name: a2b DSN: a2billing Last connection attempt: 1969-12-31 19:00:00 54

Pooled: No Connected: Yes Se sale de la consola de Asterisk: CLI> quit 3.4 Configuración del Firewall Para proteger el servidor Linux de accesos no autorizados hay que instalar un firewall (cortafuegos) y abrir los puertos que A2Billing necesita para aceptar conexiones externas. Esta es la parte más delicada de la configuración del servidor porque es donde se definen los puertos y los servicios que son accesibles desde Internet. En el caso del VPS Linode se instalará y Configurará IPtables. Si A2Billing se encuentra instalado en un computador local conectado a Internet a través de un router hay dos opciones: • •

Abrir los puertos desde la pagina de administración del router. Configurar una DMZ en el router y luego gestionar los puertos directamente con IPtables

Para instalar iptables: yum install iptables -y IPtables se encarga de gestionar todos los paquetes que entren y salgan del servidor Linux. Para eso se utilizan tres tipos de tablas: •

la tabla filter donde pasan todos los paquetes en entrada y salida. La tabla filter acepta tres tipos de opciones (cadenas) • INPUT para los paquetes en entrada • OUTPUT para los paquetes en salida • FORWARD para redireccionar los paquetes

• •

la tabla NAT se utiliza para rescribir las direcciones y/o los puertos de los paquetes la tabla MANGLE se utiliza para modificar algunos parámetros de los paquetes (un ejemplo es marcar los paquetes para que vengan procesados y enviados con una prioridad más alta)

Las reglas se definen una por linea y serán procesadas por IPtables siguiendo la misma secuencia. Cuando no se especifica diversamente, todas las reglas aplicarán a la tabla filter. Se acepta todo el trafico en entrada con destino la interfaz lookpack: iptables -A INPUT -i lo -j ACCEPT Se rechaza (REJECT) todo el trafico entrante con destino las IP 127.0.0.0/127.255.255.255 menos los 55

paquetes para la interfaz -lo: iptables -A INPUT ! -i lo -d 127.0.0.0/8 -j REJECT Se aceptan todos los paquetes en entrada de conexiones ya establecidas, o relacionados con conexiones establecidas. Véase protocolo TCP: iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT Se dejan pasar todos los paquetes salientes: iptables -A OUTPUT -j ACCEPT Se deja pasar todo el trafico en entrada para el protocolo SSH (puerto 15000 tcp): iptables -A INPUT -p tcp -m state --state NEW -m tcp --dport 15000 -j ACCEPT Se deja pasar todo el trafico en entrada para el protocolo SMTP (puerto 25 tcp) solamente si se ha configurado el acceso desde remoto al programa SendMail: iptables -A INPUT -p tcp -m state --state NEW -m tcp --dport 25 -j ACCEPT Se deja pasar todo el trafico en entrada para el protocolo HTTP (puerto 80 tcp): iptables -A INPUT -p tcp -m state --state NEW -m tcp --dport 80 -j ACCEPT Se deja pasar todo el trafico en entrada para el protocolo HTTPs (puerto 443 tcp): iptables -A INPUT -p tcp -m state --state NEW -m tcp --dport 443 -j ACCEPT Se deja pasar todo el trafico en entrada destinado al puerto udp 4569 (protocolo IAX2); Solamente si se va a utilizar el protocolo IAX2: iptables -A INPUT -p udp --dport 4569 -j ACCEPT Se bloquea el trafico sobre el puerto 5060 para los más conocidos programas de escaneo de servidores SIP utilizados para ataques y fraudes de llamadas: iptables -A INPUT -p udp -m udp --dport 5060 -m string --string "friendly-scanner" --algo bm -j DROP

iptables -A INPUT -p udp -m udp --dport 5060 -m string --string "sipcli" --algo bm -j DROP iptables -A INPUT -p udp -m udp --dport 5060 -m string --string "VaxSIPUserAgent" --algo bm -j DROP

iptables -A INPUT -p udp -m udp --dport 5060 -m string --string "sipvicious" --algo bm -j DROP iptables -A INPUT -p udp -m udp --dport 5060 -m string --string "sundayddr" --algo bm -j DROP

56

iptables -A INPUT -p udp -m udp --dport 5060 -m string --string "iWar" --algo bm -j DROP iptables -A INPUT -p udp -m udp --dport 5060 -m string --string "sipsak" --algo bm -j DROP Solamente ahora se deja pasar todo el trafico en entrada destinado al puerto udp 5060 (protocolo SIP) utilizado por Asterisk: iptables -A INPUT -p udp --dport 5060 -j ACCEPT Se deja pasar todo el trafico en entrada destinado a los puertos udp que van de 10000 a 20000 (protocolo RTP): iptables -A INPUT -p udp --dport 10000:20000 -j ACCEPT Se dejan pasar las solicitudes de ping iptables -A INPUT -p icmp -m icmp --icmp-type 8 -j ACCEPT A este punto, ya que se han definido los puertos base que se necesitan abiertos, se bloquea todo el trafico restante. iptables -A INPUT -j REJECT iptables -A FORWARD -j REJECT Se averigua el estado de las reglas definidas con el comando: iptables -L -v Chain INPUT (policy ACCEPT 0 packets, 0 bytes) pkts bytes target prot opt in out source 0 0 ACCEPT all -- lo any anywhere 0 0 REJECT all -- !lo any anywhere unreachable 88 11870 ACCEPT all -- any any anywhere RELATED,ESTABLISHED 0 0 ACCEPT tcp -- any any anywhere 0 0 ACCEPT tcp -- any any anywhere 0 0 ACCEPT tcp -- any any anywhere 0 0 ACCEPT tcp -- any any anywhere 0 0 ACCEPT udp -- any any anywhere 0 0 DROP udp -- any any anywhere "friendly-scanner" ALGO name bm TO 65535 0 0 DROP udp -- any any anywhere "sipcli" ALGO name bm TO 65535 0 0 DROP udp -- any any anywhere "VaxSIPUserAgent" ALGO name bm TO 65535 57

destination anywhere loopback/8 anywhere

reject-with icmp-portstate

anywhere anywhere anywhere anywhere anywhere anywhere

state NEW tcp dpt:hydap state NEW tcp dpt:smtp state NEW tcp dpt:http state NEW tcp dpt:https udp dpt:iax udp dpt:sip STRING match

anywhere

udp dpt:sip STRING match

anywhere

udp dpt:sip STRING match

0 0 DROP udp -- any any anywhere "sipvicious" ALGO name bm TO 65535 0 0 DROP udp -- any any anywhere "sundayddr" ALGO name bm TO 65535 0 0 DROP udp -- any any anywhere "iWar" ALGO name bm TO 65535 0 0 DROP udp -- any any anywhere "sipsak" ALGO name bm TO 65535 0 0 ACCEPT udp -- any any anywhere 0 0 ACCEPT udp -- any any anywhere 0 0 ACCEPT icmp -- any any anywhere 0 0 REJECT all -- any any anywhere unreachable

anywhere

udp dpt:sip STRING match

anywhere

udp dpt:sip STRING match

anywhere

udp dpt:sip STRING match

anywhere

udp dpt:sip STRING match

anywhere anywhere anywhere anywhere

udp dpt:sip udp dpts:ndmp:dnp icmp echo-request reject-with icmp-port-

Chain FORWARD (policy ACCEPT 0 packets, 0 bytes) pkts bytes target prot opt in out source destination 0 0 REJECT all -- any any anywhere anywhere unreachable

reject-with icmp-port-

Chain OUTPUT (policy ACCEPT 0 packets, 0 bytes) pkts bytes target prot opt in out source destination 71 13822 ACCEPT all -- any any anywhere anywhere Para guardar los cambios: service iptables save iptables: Guardando las reglas del cortafuegos en /etc/sysconfig/iptables [ OK ] Se inicia el servicio: service iptables start Para iniciar IPtables automáticamente: chkconfig iptables on Se configura el inicio automático también para el servidor Web: chkconfig httpd on Ahora que se ha terminado con la configuración del servidor y de A2Billing se reinicia el sistema para averiguar que todos los servicios arranquen correctamente: reboot

58

3.5 Primer acceso Reiniciado el servidor se vuelve a entrar con el cliente SSH y se accede a la consola de Asterisk: asterisk -rvvvvvvvvvvvvvv desde un navegador web se entra a la pagina de administración de A2Billing: http://IPservidor/admin o la pagina segura (mejor). Más adelante veremos como instalar un certificado para el servidor Web utilizando la autoridad de certificación Let's Encrypt: https://IPservidor/admin Debe aparecer:

Los datos por defecto para acceder son: User: root Password: changepassword Lo primero que hay que hacer es crear un nuevo administrador y borrar el predefinido. Se entra en el menú ADMINS y luego en “Add Search”:

En la pagina que aparece se escoge “ADD Administrator”. En la nueva pagina se rellenan los campos indicados (personalizar):

59

Se guardan las modificaciones presionando el botón “Confirm Data”. Se regresará a la pagina anterior y ya se podrá borrar el usuario root:

y confirmando con el botón “DELETE” en la pagina siguiente:

60

Ya se puede salir del programa:

y volver a entrar con los datos del nuevo administrador:

61

Capitulo IV Configuración base A2Billing Una vez en la pagina de administración de A2Billing, se tendrán disponibles dos bloques de menú. Uno en la parte de arriba de la pagina:

• •

•

HOME: para volver a la pagina de inicio de A2Billing DASHBOARD: es una pagina compuesta de distintos bloques: • ACCOUNT INFO: informaciones relacionadas con las cuentas de los clientes • REFILLS INFO: informaciones sobre las recargas realizadas • CALL INFO TODAY: informaciones sobre las llamadas, costes y ganancias • SYSTEM INFO: informaciones del sistema • PAYMENTS INFO: informaciones de los pagos realizados por los clientes • LATEST NEWS: un canal de noticias gestionado por los desarrolladores de A2Billing donde se pueden leer las ultimas novedades relacionadas con los programas. NOTIFICATION: es este bloque aparecerá la palabra “New” cada vez que se verifique un determinado evento. Ejemplos: • Se ha registrado un nuevo usuario • Se ha creado un nuevo tiquete de soporte • Un revendedor ha solicitado el pago de su comisión

Uno en la parte derecha:

La parte más tediosa y al mismo tiempo más importante de la configuración de A2Billing es la que tiene que ver con las variables globales del sistema de facturación. A través de estas variables se configuran, entre otras cosas, el sistema de pago, el callback (rellamada), la interfaz del cliente y algunos datos de configuración de Asterisk. Para simplificar esta parte, se presentarán las variables como aparecen en los distintos grupos del menú “SYSTEM SETTINGS” de A2Biling. La configuración inicial que se adoptará es para un sistema Wholesale, es decir para la venta de trafico telefónico a clientes y revendedores. En el capitulo V dedicado a la configuración avanzada, se verá como configurar A2Billing como sistema de tarjetas telefónicas; este tipo de configuración se utiliza normalmente a través de números de acceso telefónicos. 4.1 System Settings Desde la pagina de administración de A2Biling se selecciona el menú “System Settings” y luego “Global List” come aparece en la imagen que sigue:

En la nueva pagina se empieza la configuración escogiendo en el menú desplegable “Global” y presionando el Botón “Search”:

64

Aparecerá la lista de las variables globales. En la tabla que sigue el significado de cada una y el valor a configurar. En negrita las variables que hay que modificar. Titulo

Valor

Descripción

Card Number length

5-20

Longitud numérica de la Tarjeta de llamada que es también el PIN che se utilizará con la configuración de tarjetas telefónicas de llamadas.

Card Alias length

5

Longitud Alias tarjeta. El alias lo utiliza el cliente para acceder a su pagina personal y para las llamadas entre clientes configurados en A2Billing

Voucher length

15

Longitud de los Voucher. Los voucher se utilizan para recargar las cuentas de los clientes

Base Currency

usd

Moneda predefinida (en este caso dolares estadounidenses)

Invoice Image

asterisk01.jpg

Logo para las facturas (no aplica). Se verá más adelante como se configura correctamente.

Admin Email

[email protected]

e-Mail del administrador del sistema (personalizar con una cuenta real).

7

Días disponibles para renovar un DID antes de eliminarlo de la cuenta del cliente.

Manager Host

localhost

Host/IP para conectarse a la AMI de Asterisk

Manager User ID

asterisk

Usuario para la conexión a la AMI de Asterisk (como se ha configurado en el archivo manager.conf)

DID Billing Days to pay

65

Titulo

Valor

Descripción

Manager Password

sesamo

Contraseña para la conexión a la AMI de Asterisk (como se ha configurado en el archivo manager.conf)

Use SMTP Server

no

Se utiliza el servidor de correo electrónico interno en lugar de un servidor externo.

localhost

Dirección IP o nombre de dominio del servidor de correo electrónico. En este caso se utilizará Sendmail instalado en el sistema

SMTP Host

SMTP UserName

Se deja en blanco

SMTP Password

Se deja en blanco

Use Realtime

Go To Customer

yes

Se usará Asterisk Realtime para guardar la configuración de las extensiones SIP/IAX2 en una base de datos

https://IPservidor/customer

URL pagina clientes (en lugar de IPservidor poner la IP del servidor asignado). Este parámetro permite acceder a la cuenta del cliente directamente desde la pagina de administración de A2Billing.

SMTP Secure

Para enviar los correos electrónicos no se utilizará una conexión segura. Esto porque el servidor reside en el mismo servidor Linux.

SMTP Port

25

Server GMT

GMT-05:00

Invoice Template Path Outstanding Template Path Sales Template Path Enable CDR local cache

66

../invoice/

Puerto del servidor de correo electrónico. Predefinido 25 Zona horaria (para Colombia) Plantilla para facturas

../outstanding/

Carpeta de las plantillas para facturas pendientes

../sales/

Carpeta de las plantillas para facturas pagadas

No

Se activa en el caso se quiera guardar los datos de las llamadas

Titulo

Valor

Descripción en una base de datos SQLite

Path for the CDR cache file

/etc/asterisk/cache_a2billing

Archivo donde se guardarían los datos de las llamadas en el caso se utilice una base de datos SQLlite

COL

País de la empresa (personalizar)

Base Country Base Language

es

Asterisk Version Global Days to bill anniversary

before

1_11 month

3

Idioma predefinido del sistema Versión de Asterisk No aplica

En el caso en que se quiera utilizar un servidor de correo electrónico externo en lugar del SENDMAIL, los parámetros que hay que cambiar son (para Gmail): Use SMTP Server

Yes

SMTP Host

smtp.gmail.com

SMTP UserName

[email protected]

SMTP Password

password

SMTP Secure

ssl

SMTP Port

465

Se sigue con callback. En este menú se configura todo lo relacionado con el sistema de rellamada de A2Billing:

Titulo

Valor

Descripción

Context Callback

a2billing-callback

Contexto que hay que configurar en el dialplan de Asterisk para la rellamada

Extension

1000

Extensión que el sistema utilizará en una llamada de

67

callback Wait before callback

10

Segundos que el sistema esperará antes de iniciar la rellamada

Avoid Repeat Duration

30

Numero de segundos antes que una rellamada pueda ser enviada nuevamente desde la pagina Web del cliente

Time out

60

Si dentro de 20 segundos la rellamada no se establece, se considera terminada sin éxito

Answer on Call

No

Para gestionar la respuesta de una rellamada se pone en no. De esta forma la segunda llamada no se iniciará hasta que la primera no sea contestada.

No of Predictive Calls

10

Numero de llamadas que se lanzan cuando un Agente presiona el botón de llamada (no aplica)

Delay for Availability

1

Numero de días para que un numero llamado sea nuevamente disponible en una campaña (no aplica)

PD Context

a2billing-predictivedialer

Contexto que hay que configurar en el dialplan de Asterisk para el sistema de llamadas automático (no aplica)

Max Time to call

5400

Numero máximo de segundos de duración de una llamada generada con el sistema predictivo (no aplica)

PD Caller ID

123456

Identificador de llamada saliente para las rellamadas y las campañas (personalizar)

Callback CallPlan ID

1

El ID del Callplan que se utilizará para las rellamadas

Server Group ID

1

Para las rellamadas se puede configurar más de un grupo de servidores Asterisk. Si se utiliza solamente uno se pone la ID del grupo como aparece en el menú CALLBACK → Server Group.

68

Si se utiliza más de un grupo de servidores se indican los ID separados por un coma. Audio Intro

prepaid-callback_intro

Locución que se escuchará cuando se inicia una rellamada

Context Campaign's Callback

a2billing-campaign-callback

Contexto para la rellamadas de una campaña (no aplica)

Default Context forward Campaign's Callback

campaign

Contexto donde transferir las llamadas de una campaña (no aplica)

Terminada la configuración de este grupo se continua con webcustomerui:

Titulo

Valor

Return URL distant Forget Password

Se puede indicar una dirección Web donde enviar el usuario si se ha presentado un problema con la recuperación de la contraseña.

WebPhone Server

localhost

Antes en la pagina personal de los clientes, había un webphone que se podía utilizar para realizar llamadas. Ya no está presente

CallerID Limit

5

Numero máximo de identificativos de llamada que un cliente puede configurar en su cuenta

Return URL distant Login

Notifications Modules

69

Descripción

Se puede indicar una dirección Web donde enviar el usuario si se ha presentado un problema durante el acceso. Yes

Visualiza un menú que permite al cliente configurar una alerta cuando su crédito está por debajo del valor definido

Se sigue con sip-iax-info donde se define la configuración de los parámetros de configuración de la cuenta SIP que los clientes pueden ver en su pagina personal y que les permite configurar su teléfono SIP/IAX2 o su PBX:

Titulo

Valor

Descripción

Trunk Name

a2billing

Nombre de la troncal como aparecerá al cliente (personalizar con el nombre de su empresa, por ejemplo)

Codecs Allowed

alaw,ulaw

Codec audio disponibles para los clientes

Host

li403-112.members.linode.com Nombre de dominio del servidor. El nombre de dominio es preferible a la IP del servidor porque si en cualquier momento se traslada la instalación del servidor, con solo modificando los DNS, será posible asociar el dominio a la nueva IP (en el caso de Linode)

IAX Parms

canreinvite = no

Parámetros adicionales para IAX

SIP Parms

trustrpid = yes | sendrpid = yes | canreinvite = no

Parámetros adicionales para SIP

Para los últimos dos parámetros el cambio hay que realizarlo directamente desde la base de datos ya que en la ultimas versiones de A2Billling se han implementado toda una serie de controles de seguridad que no permiten modificar parámetros donde aparezcan caracteres especiales (en este caso el símbolo de =). se accede a MySQL: mysql -u root -psesamo se selecciona la base de datos a2billing:

70

mysql> use a2billing y se modifican los dos parámetros finales del grupo: mysql> update cc_config set config_value='directmedia = yes' where id='54'; mysql> update cc_config set config_value='trustrpid = yes | sendrpid = yes | directmedia = yes ' where id='55'; Se sale de cliente MySQL: mysql> quit Se continua con epayment_method donde se configuran todos los parámetros relacionados con los métodos de pago disponibles. En esta parte se configuran también los accesos a las paginas seguras del portal de los clientes.

Titulo Enable

Valor Yes

HTTP Server Customer

Descripción Se activa el modulo de pago que permite a los clientes efectuar recargas directamente desde su pagina personal utilizando distintos métodos de pago (ej: PayPal) En producción se deja el parámetro en blanco. Se utiliza solamente la Web segura

HTTPS Server Customer

https://IPservidor

Se pone la IP del servidor asignado y la carpeta donde se encuentra a2billing

Server Customer IP/Domain

IPservidor

Dirección IP servidor asignado

Secure Server Customer IP/Domain

IPservidor

Dirección IP servidor asignado

Application Customer Path

/customer/

Carpeta web clientes

Secure Application Customer Path

/customer/

Carpeta web clientes

71

Application Customer Physical Path

/customer/

Carpeta web clientes

Secure Application Customer Physical Path

/customer/

Carpeta web clientes

Enable SSL

Yes

Acceso seguro activado para el proceso de pago.

HTTP Domain

IPservidor

Dirección IP servidor asignado

Directory Path

/customer/

Carpeta web clientes

Payment Amount

5:10:20:25:50

Valores que los clientes pueden recargar en su cuenta (se pueden indicar hasta 5)

Item Name

Compra Recarga

Un nombre para la operación de recarga

Currency Code

USD

Moneda utilizada para los pagos (se puede personalizar)

Paypal Payment URL

https://www.paypal.com/cgibin/webscr

Gateway PayPal para los pagos

Paypal Verify URL

ssl://www.paypal.com

URL de verifica para PayPal

Authorize.NET Payment URL

https://secure.authorize.net/gate way/transact.dll

URL para los pagos con Authorize.Net

PayPal Store Name

LibroA2Billing

Nombre de la tienda que aparecerá al momento del pago con PayPal (personalizar)

Transaction Key

asdf1212fasd121554sd4f5s45sdf Clave de seguridad aleatoria para los pagos

Secret Word

Si para los pagos se utiliza Moneybookers (ahora Skrill), aquí hay que indicar la clave secreta de la cuenta

Payment Amount

100:200:500:1000

Valores que lo revendedores tienen disponibles para realizar recargas.

Charge for the paypal extra fees

Yes

Con No se asumen los gastos de las comisiones de PayPal. Con Yes se cobran a los clientes

PlugnPay Payment URL

https://pay1.plugnpay.com/paym URL para pagos con el servicio ent/pnpremote.cgi PlugnPay

HTTP Server Agent HTTPS Server Agent 72

En producción de deja en blanco https://IPservidor

Se pone la IP del servidor

asignado y la carpeta donde se encuentra a2billing Secure Server Agent IP/Domain

IPservidor

Dirección IP del servidor asignado

Application Agent Path

/agent/Public/

Carpeta web acceso revendedores

Secure Application Agent Path

/agent/Public/

Carpeta web acceso revendedores

Application Agent Physical Path /agent/Public/

Carpeta web acceso revendedores

Secure Application Agent Physical Path

/agent/Public/

Carpeta web acceso revendedores

Paypal Amount Subscription

10

PayPal permite pagos de forma recurrente. Este parámetro y los 4 que siguen permiten configurar este servicio.

Paypal Subscription Time period 1 number

Este numero es asociado al que sigue y se utiliza para definir cada cuanto tiempo se repite el pago recurrente.

Paypal Subscription Time period M

M = mes. En este caso se repite cada mes.

Enable PayPal subscription

Yes

No se habilitan los pagos recurrentes

Paypal Subscription account

[email protected]

Correo Electrónico para recibir pagos recurrentes en PayPal (personalizar)

En en próximo menú, signup, se configuran todos los parámetros relacionados con la creación de nuevos clientes. Es aquí que se define si los clientes se pueden registrar desde una pagina Web, que tipo de datos se les pedirá, que planes de llamadas pueden escoger y si se les regala un crédito de prueba inicial. A diferencia de los clientes, los revendedores no se pueden registrar por su cuenta. Solo los administradores pueden crear las cuentas de los revendedores.

73

Titulo

74

Valor

Descripción

Enable

Yes

Los clientes se pueden registrar desde una pagina Web

Captcha Security

Yes

Se añade un bloque de seguridad para evitar registros no deseados

Credit

1

Se le obsequia un dólar de crédito a cada nuevo cliente para que pueda probar las rutas

CallPlan ID List

1,2

Numero ID de los planes de llamadas que un cliente puede escoger al momento de registrarse

Card Activation

No

Las cuentas de los clientes tendrán que ser activadas por un administrador. Con yes se activarán automáticamente

Access Type

0

Con 0 se le brinda al cliente un canal (una llamada a la vez) con 1 más de un canal

Paid Type

0

Tipo de cuenta que se creará 0 = prepago 1= postpago

Credit Limit

0

Utilizado solo para tarjetas postpago. Indica el crédito disponible que tendrá cada nueva cuenta PostPago hasta que no se genere una nueva factura

Run Service

0

No se aplican cargos adicionales de forma predefinida

Enable Expire

0

Tarjeta. 0 = no se vence 1 = se vence

Date Format

DD-MM-YYYY HH:MM:SS

Fecha en que las nuevas cuentas creadas se vencen. El formato es: YYYY-MM-DD HH:MM:SS Ejemplo: 2030:12:31 00:00:01. Se deja vacío.

Expire Limit

0

Numero de días después de los cuales la tarjeta se vence. 0 = nunca

Create SIP

Yes

Se creará una cuenta SIP

Create IAX

No

No se creará una cuenta IAX de forma predefinida

Activate Card

No

Para confirmar la cuenta, el

75

cliente recibirá un correo electrónico con un enlace para que demuestre que es dueño del correo electrónico indicado al momento del registro. Si es Yes se activa sin confirmación Customer Interface URL

https://IPservidor/customer/

Dirección web que aparecerá al cliente una vez que se haya registrado. Modificar IPServidor con la IP asignada

Asterisk Reload

No

Como las extensiones SIP se guardan en una base de datos no hace falta recargar la configuración de Asterisk una vez creada la cuenta

Language field

Yes

El cliente puede escoger el idioma

Currency field

Yes

El cliente puede escoger el tipo de moneda

Last Name Field

Yes

Se le pedirá el apellido

First Name Field

Yes

Se le pedirá el nombre

Address Field

Yes

Se le pedirá la dirección

City Field

Yes

Se le pedirá la ciudad

State Field

Yes

Se le pedirá la región/departamento

Country Field

Yes

Se le pedirá el País

Zipcode Field

No

No se le pedirá el código Postal

Timezone Field

Yes

Podrá escoger la zona horaria

Phone Field

Yes

Se le pedirá el teléfono

Fax Field

No

No se le pedirá el numero del FAX

Company Name Field

No

No se le pedirá el nombre de su compañía

Company Website Field

No

Ni la Web

VAT Registration Number Field

No

Ni el numero para el pago de impuestos de la empresa

Traffic Field

No

No se le mostrará el campo para definir el tipo de trafico que tiene planeado hacer

76

Traffic Target Field

No

Sobre que tipo de destinaciones

Si se quiere efectuar una primera prueba, en una nueva pestaña del navegador, se pone la siguiente dirección (sostituir IPServidor con la IP de su servidor Linode o servidor local): https://IPservidor/customer y cuando aparece esta pagina:

Se presiona el enlace en la linea “To sign up Click here”. Aparecerá la pagina para registrarse: Como se puede ver, a los nuevos clientes se les pedirán solamente los datos que se acaban de configurar en el menu “signup”. Como faltan algunas partes de la configuración de A2Billing, el cliente no puede todavía registrarse.

77

Se regresa a la pestaña del navegador donde se estaba anteriormente configurando A2Billing y se continua con el menú backup. En este menú se configurarán todos los parámetros relacionados con las copias de seguridad de la base de datos a2billing y con el archivo de los registros de las llamadas.

Titulo

Valor

Descripción

Backup Path

/tmp

Carpeta donde se guardarán las copias de backup de la base de datos a2billing

GZIP Path

/bin/gzip

Posición del programa gzip

GunZip Path

/bin/gunzip

Posición del programa gunzip

MySql Dump Path

/usr/bin/mysqldump

Posición del programa

78

mysqldump PGSql Dump Path

/usr/bin/pg_dump

Posición del programa pg_dump

MySql Path

/usr/bin/mysql

Posición del programa MySQL

PSql Path

/usr/bin/psql

Posición del programa PostgreSQL

Archive Calls

12

Los archivos de las llamadas anteriores a los 12 meses se archivarán en otra tabla de la base de datos “a2billing” y no podrán ser consultados más por los clientes. En el caso que el sistema tenga mucho trafico, es aconsejado bajar este valor a 6 meses

Se sigue con el menú webui donde se configuran, entre otras cosas, la grabación de las llamadas, la música de espera personalizada, como exportar algunos tipos de datos en archivos con formato CSV y la configuración de la venta de DID en el caso se tenga una cuenta con el proveedor DIDX.net, que el único proveedor de números geográficos cuyas API están implementadas en A2Billing.

Titulo

Valor

Descripción

SIP File Path

/etc/asterisk/additional_a2billing_sip.conf Carpeta y nombre del archivo donde se guardarán las extensiones SIP creadas en A2Billing si no se utiliza el Asterisk Realtime

IAX File Path

/etc/asterisk/additional_a2billing_iax.conf Como el anterior para las extensiones IAX2

API Security Key

Ae87v56zzl34v

A2billing suporta unas API para consultas web. Esta es la clave para utilizar las API.

Authorized IP

127.0.0.1

Direcciones IP que

79

pueden acceder a las API (separadas con un punto y coma). En esta caso solamente localhost o 127.0.0.1 Admin Email

[email protected]

Correo electrónico del administrador (personalizar)

MOH Directory

/var/lib/asterisk/mohmp3

Carpeta para la música de espera personalizada (No aplica)

MOH Classes

10

Clases de música en espera que se utilizarán. (No aplica).

Display Help

No

No se mostrarán las ayudas en las paginas de A2Billing

Max File Upload Size

8192000

Tamaño máximo (en Byte) de los archivos de las tarifas que se cargan en A2Billing. En el caso que se quiera aumentar el valor, hay que modificar este parámetro: upload_max_filesize en el archivo de configuración de PHP (php.ini) que se encuentra en la carpeta /etc. Una vez efectuado el cambio hay que reiniciar el servidor Web. service httpd restart

Audio Directory Path

/var/lib/asterisk/sounds/a2billing

No se utiliza (obsoleto)

Max Audio File Size

8192000

Tamaño máximo de los archivos audio que se podrán cargar en el sistema

Extensions Allowed

gsm, mp3, wav

Formatos audio permitidos

Music Files Allowed

mp3

Formato audio de los archivos musicales cargados para la música

80

de espera. Link Audio

No

No se creará un enlace en los registros de las llamadas a los archivos de las llamadas grabadas

Monitor Path

/var/spool/asterisk/monitor

Carpeta donde se guardarán las llamadas grabadas

Monitor Format

gsm

Formato audio de las llamadas grabadas

Currency

usd, eur, cad, hkd

Monedas predefinidas brindadas a los clientes

Card Export Fields

card.id, username, useralias, lastname, Si se exportan las tarjetas credit, tariff, activated, language, inuse, de los clliente en un currency, sip_buddy, iax_buddy archivo CSV, estos son los campos que aparecerán en el archivo exportado.

Voucher Export Fields

voucher, credit, tag, activated, usedcardnumber, usedate, currency

Campos exportados de los vouchers

Advance Mode

No

Si activado se mostrarán campos adicionales en la creación de los RATECARD

SIP/IAX Delete

Yes

Cuando se elimina un cliente, automáticamente se borrarán las extensiones SIP/IAX2 asociadas.

Card Show Fields

id:,username:, useralias:, lastname:,id_group:, id_agent:, credit:, tariff:, status:, language:, inuse:, sip_buddy:, iax_buddy:, nbused:,

Orden de los campos mostrados en la pagina de administración de los clientes

PNL Pay Phones

(8887798764,0.02,0.06)

Para crear reportes de llamadas a números de pago, se puede indicar aquí los números completos (o solamente el prefijo) y el costo de compra y de venta

PNL Toll Free Numbers

(6136864646,0.1,0),(6477249717,0.1,0)

Lo mismo para los números gratuitos

81

DIDX ID

708XXX

Si se dispone de una cuenta con DIDx, aquí se indica la ID de la cuenta (para la compra de los números geográficos)

DIDX PASS

XXXXXXXXXX

En este parámetro se indica la contraseña de la cuenta DIDX.net

DIDX MIN RATING

3

El rating mínimo (calidad) que tiene que tener el vendedor del DID según la clasificación de DIDX (de 1 a 5)

DIDX RING TO

didx

Extensión donde enviar las llamadas entrantes de los números adquiridos con DIDX

Card Serial Pad Length

3

Números de 0 de relleno para las tarjetas creadas como pertenecientes a una serie. Si se pone 3 el resultado será 001. Véase menú CUSTOMERS → Card Series

Rate Export Fields

destination,dialprefix,buyrate,rateinitial Campos de las tarifas que ,initblock se exportará en el archivo CSV

El el próximo menú se configurarán algunos valores básicos de las extensiones. Estos valores serán los predefinidos cada vez que se creará una nueva extensión SIP y/o IAX

Titulo

Valor

Descripción

Type

friend

Puede ser user, peer y friend

Allow

alaw,ulaw

Codec audio permitidos

Context

a2billing

Contexto que por defecto será

82

asociado a cada extensión creada El mismo que se ha creado en el archivo extensions.conf y es donde llegará cualquier llamada efectuada por un cliente del sistema. Nat

force_rport,comedia

Como la mayoría de las extensiones se conectarán desde remoto y detrás de un router, se pone NAT=force_rport,comedia (Desde la versión 11.X de Asterisk estos son los dos nuevos parámetros)

AMA Flag

billing

Parámetro que se guardará en los registros de las llamadas y identificará todas las llamadas efectuadas utilizando A2Billing

Qualify

no

En Asterisk Realtime este parámetro se pone en no

Host

dynamic

Para extensiones remotas sin autenticación sobre IP

DTMF Mode

RFC2833

Protocolo para el envío de los tonos (DTMF) a lo largo de una llamada

En el menú log-files se definen los nombres de todos los archivos donde se guardarán los distintos tipos de registros relacionados con la actividad de A2Billing. No se necesita ningún tipo de cambio ya que así se han definidos durante la instalación de A2Billing. Se presentan solamente para tener un cuadro completo de la configuración de A2Billing.

Titulo

Valor

Alarm Log File

/var/log/a2billing/cront_a2b_alarm.log

Auto refill Log File

/var/log/a2billing/cront_a2b_autorefill.log

Bactch Process Log File

/var/log/a2billing/cront_a2b_batch_process.log

83

Descripción

Archive Log File

/var/log/a2billing/cront_a2b_archive_data.log

DID Billing Log File

/var/log/a2billing/cront_a2b_bill_diduse.log

Subscription Fee Log File /var/log/a2billing/cront_a2b_subscription_fee.log Currency Cront Log File

/var/log/a2billing/cront_a2b_currency_update.log

Invoice Cront Log File

/var/log/a2billing/cront_a2b_invoice.log

Cront Log File

/var/log/a2billing/cront_a2b_check_account.log

Paypal Log File

/var/log/a2billing/a2billing_paypal.log

EPayment Log File

/var/log/a2billing/a2billing_epayment.log

ECommerce Log File

/var/log/a2billing/a2billing_api_ecommerce_request.log

Callback Log File

/var/log/a2billing/a2billing_api_callback_request.log

Webservice Card Log File /var/log/a2billing/a2billing_api_card.log AGI Log File

/var/log/a2billing/a2billing_agi.log

La parte más importante de la configuración de A2Billing es el menú agi-conf1 donde se definirán todos los parámetros que utilizará el AGI de A2Billing para las llamadas.

Titulo Call to free DID Command Params

Valor Dial ,60,L(%timeout%:61000:30000)

Descripción Opciones para la aplicación Dial de Asterisk para las llamadas a números geográficos configurados en el sistema por los cuales no se cobran las llamadas entrantes.

Description

Wholesale

Un nombre para este perfil

Asterisk Version

1_11

Versión de Asterisk utilizada

Answer Call

No

El AGI no contestará la llamada

Play Audio

No

Se deshabilita el utilizo de las locuciones audio

Say GoodBye

No

No se utilizará la locución Goodbye al terminar una

84

Titulo

Valor

Descripción llamada

Play Language Menu

No

No se presentará el IVR para escoger el idioma

Force Language

Fuerza el uso de un idioma para las locuciones. No aplica para Wholesale

Intro Prompt

Locución de personalizada.

introducción

Min Call Credit

0.5

Crédito mínimo para iniciar una llamada. Ayuda a no tener saldos negativos

Min Bill Duration

0

Duración mínima para que la llamada sea cobrada. 0 = se cobra a partir del momento en que es contestada.

Not Enough Credit

No

Con yes; si el cliente no tiene suficiente crédito en la tarjeta que está utilizando, se le permitirá seleccionar otra. No, no se le permite

New Caller ID

No

Si el precedente parámetro está en Yes y este parámetro también, se asocia el CallerID del cliente a la nueva tarjeta

Use DNID

Yes

Con Yes: si la variable DNID contiene el numero marcado (en Asterisk es así), al cliente no se le pide que ingrese el numero a marcar

Not Use DNID

2400,2300

Lista de números que si marcados enviarán la llamada a la locución que solicitará el numero a marcar seguido de la tecla numero aunque el parámetro anterior esté configurado con Yes.

Try Count

1

Numero de intentos permitidos al cliente para marcar un numero (para Wholesale tiene que ser 1)

85

Titulo

Valor

Force CallPlan

Descripción Para forzar el utilizo de un Callplan determinado (no se utiliza en este caso)

Say Balance After Auth

No

No se anuncia el crédito disponible después de la autenticación

Say Balance After Call

No

No se anuncia el crédito disponible al terminar la llamada

Say Rate

No

No se anuncia el costo de la llamada

Say Duration

No

No se anuncia la duración máxima de la llamada en base al crédito disponible

Auto Set CLID

No

No se configura el CallerID en automático

Force CLID

CLID Sanitize

86

Si el parámetro anterior está en yes y este contiene un numero, ese numero se utiliza como identificativo de llamada para las llamadas salientes. CID

Si el parámetro anterior no está configurado, en este parámetro se configura cual numero se utilizará para el identificativo de las llamadas salientes del cliente: • NO: desactivado • CID: uno de los números configurados por el cliente como identificativos de llamada • DID: uno de los números geográficos adquiridos por el cliente • BOTH: el identificativo de llamada puede ser o un DID del cliente o uno de los números configurados por el cliente.

Titulo

Valor

Descripción

CLID Enable

No

No se autentica el cliente en base a su CallerID

Ask PIN

No

No se le pide al cliente de introducir su PIN

FailOver LCR/LCD Prefix

No

Si en un CallPlan están presentes dos tarifas distintas para terminar la llamada (ejemplo prefijos 573 y 57) y se llama a un celular de Colombia, el sistema intentará sacar la llamada con la primera tarifa (573). Si no tiene éxito, se intentará utilizar la segunda tarifa (57). Con No se desactiva esta funcionalidad

Auto CLID

No

Si el cliente no se puede autenticar con el CallerID se le pedirá su numero de tarjeta e automáticamente se asociará al numero de tarjeta el CallerId del teléfono de donde está llamando el cliente. Con NO se desactiva.

Auto CLID Security

No

Con yes se controla que el CallerID del cliente esté asociado con la tarjeta que está utilizando para la llamada.

SIP Call

No

Se habilita para permitir llamadas entre las extensiones SIP/IAX2 configuradas en el sistema y asociadas a los clientes.

SIP Call Prefix

555

Prefijo que hay que anteponer al numero de extensión SIP/IAX2 que se quiere llamar (funciona si SIP CALL = Yes)

Direct Call

No

Si se habilita no se presentará una locución para marcar un numero. Si este numero empieza por 555 la llamada sera cursada hacia la extensión

87

Titulo

Valor

Descripción SIP/IAX marcada; de otra forma se cursará normalmente

IVR Voucher Refill

No

Si está en Yes se permite recargar las tarjetas utilizando un voucher

IVR Voucher Prefix

8

Dígito a marcar desde el menú de tarjetas prepago para recargar la cuenta con un voucher

IVR Low Credit

No

Si está en Yes y el crédito disponible del cliente es menor que el valor definido en el parámetro “Min Call Credit”, se presentará en automático el IVR para recargar la tarjeta utilizando un voucher

Dial Command Params

,60,rL(%timeout%:61000:30000) Opciones para el comando Dial de Asterisk. La opción r que aparece en la linea genera un timbrado falso. En algunos dispositivos este timbrado puede generar problemas de facturación de la llamada. En esos casos, se quita la r de la linea de configuración del parámetro.

SIP/IAX Params

Dial

Command ,60,L(3600000:61000:30000)

Opciones para el comando Dial para llamadas entre extensiones:Duración máxima de este tipo de llamadas 3600000 mili segundos = 1 hora

Outbound Call

No

Forma de marcar el numero: No = SIP/Proveedor/numero – Yes = SIP/numero@IPProveedor

Failover Retry Limit

1

Numero de intentos de cursar la llamada utilizando las troncales de respaldo

Max Time

3600

Numero máximo de segundos de duración de una llamada cuya tarifa es igual o inferior a 0

88

Titulo

Valor

Descripción

Send Reminder

No

Yes = se envía un correo electrónico al cliente cuando su crédito es inferior al valor del parámetro “ Min Call Credit”

Record Call

No

Yes = se grabará el audio de todas las llamadas

Monitor File Format

gsm

Formato audio utilizado para grabar las llamadas

AGI Force Currency

Indicando una moneda el crédito disponible se anunciará en la moneda indicada en este parámetro en lugar de la moneda configurada por el cliente en su pagina personal

Currency Associated

usd:dollars,mxn:pesos,eur:euros, Locuciones para las monedas cop:pesos,all:credit configuradas

Option Local Dialing

No

No añadir el prefijo internacional del cliente si el numero marcado contiene un 0 inicial. Con Yes se añade

Max time to Call a DID no 3600 billed

Tiempo de duración de una llamada a un Numero geográfico configurado en el sistema para el cual no se cobran las llamadas entrantes. 3600 segundos = 1 hora.

File Enter Destination

prepaid-enter-dest

Locución utilizada para pedir al cliente el numero a marcar

Menu Language Order

es:en:fr

Lista de idiomas disponibles en el IVR que permite escoger un idioma para las locuciones

Bill Callback

Yes

Se cobrará la llamada de Callback del primer canal aunque el segundo canal no ha contestado o no se ha podido establecer la llamada

International prefixes

011,00,09

Prefijos internacionales que se quitarán del numero marcado por el cliente si el CallPlan lo prevea

89

Titulo

Valor

Descripción

Extra charge DIDs

1800,1900

Cargos adicionales para DID que empiecen con 1800 0 1900 (por minuto)

Extra charge DID fees

0,0

Se indican los costos, por minuto, de llamadas a los números que empiecen con el prefijo indicado en el parámetro anterior.

Extra charge DID buy fees

0,0

Se indican los costos adicionales para la compra de números cuyo prefijo está presente en el parámetro “Extra charge DIDs”

Max Time For Unlimited Calls 3600

Tiempo máximo de duración de una llamada incluida en un paquete de minutos gratuitos cuyo paquete tiene configurado en el parámetro PACKAGE TYPE el valor “Unlimited calls”

Max Time For Free Calls

Tiempo máximo de duración de una llamada incluida en un paquete de minutos gratuitos cuyo paquete tiene configurado en el parámetro PACKAGE TYPE el valor “Number of Free calls”.

3600

CallPlan threshold Deck switch

Este parámetro se utiliza para pasar un cliente de un Call Plan a otro en el momento en que haya utilizado n segundos del primero. Los valores se indican de la siguiente forma: ID Call Plan : segundos (coma) ID segundo Call Plan : segundos. Ejemplo: 1:3600,2:7200

Disable annoucement the No second of the times that the card can call

Yes = no anuncia el numero de segundos si el cliente tiene disponible para la llamada más de un minuto

Currency Cents Association

Define las locuciones que se utilizarán para los centavos

90

usd:prepaid-cents,eur:prepaidcents,gbp:prepaid-pence,all:credit

Titulo

Valor

Descripción según la moneda.

Default Accountcode

Si en este parámetro se indica el numero de un cliente, o ACCOUNTCODE, todas las llamadas que utilizarán este agiconf se cobrarán a ese cliente. Esto dependiendo de la configuración del parámetro “Default Accountcode Behaviour” que aparece más adelante. Se deja vacío

Verbosity

3

Configura el nivel de verbosidad de los registros de A2Billling 3 = INFO

Logging

3

Lo mismo para lo registros de LOG 3 = INFO

Dial Balance reservation

0.25

Crédito que se reserva para cada llamada en el caso de clientes que pueden utilizar más de una canal a la vez. Ayuda a prevenir la presencia de saldos negativos

Option CallerID update

No

Yes = Se permite al cliente de actualizar su CallerID antes de realizar una llamada.

Auto Create Card

No

Si está en yes y el CallerID del cliente se captura, se generará una nueva tarjeta de llamadas con asociado ese CallerID

Auto Create Card Length

10

Longitud del numero de tarjeta generado automáticamente

Auto Create Card Type

PREPAID

Tipo de tarjeta generada automáticamente (PREPAID = prepago; POSTPAID = postpago)

Auto Create Card Credit

0

Crédito disponible en la tarjeta creada automáticamente (si es prepago)

Auto Create Card Limit

0

Si es una tarjeta postpago, aquí se fija el limite de crédito disponible para la tarjeta

91

Titulo

Valor

Descripción generada automáticamente

Auto Create Card TariffGroup

1

ID del Call Plan que se utilizará para la tarjeta generada automaticamente

Busy Timeout

3

Tiempo, en segundos, de duración del tono de ocupado

Callback Reduce Balance

1

Monto que se quitará al crédito disponible del cliente para asegurarse que la llamada de callback tenga crédito suficiente.

IVR Locking option

No

Si está en Yes permite al cliente configurar un segundo código para acceder a su cuenta

IVR Account Information

No

Si está en Yes permite al cliente consultar una serie de datos relacionados con su cuenta

IVR Speed Dial

No

Si está en Yes permite al cliente configurar los números de marcado rápido

Play rate lower one

0

Si está en Yes anuncia el valor de la llamada aunque el costo sea menor de un centavo

Callback Beep for Destination

No

= Yes a lo largo de una llamada de callback, el cliente escuchará un beep cuando la llamada se establece.

Callback CID Prompt Confirm No PhoneNumber

Si está en Yes a quien inicia una llamada de callback se le pedirá de confirmar su numero

LCR Mode

Este parámetro ha sido añadido desde la versión 2.0 de A2Billing. Si el valor es 0 A2billing busca el prefijo que más se acerca al numero marcado en todas las RateCard presentes en un CallPlan y escoge la ruta más barata. Si el valor es 1 A2Billing busca en cada RateCard presente en un CallPlan el prefijo que más se

92

1

Titulo

Valor

Descripción acerca al numero marcado y entre todos los encontradas, escoge la ruta más barata. Más adelante se mostrará como se utiliza esta nueva funcionalidad.

Default Accountcode Behaviour No

Si está en Yes utiliza el ACCOUNTCODE definido en el parámetro “Default Accountcode” aunque la llamada tenga asociado un ACCOUNTCODE. Si está en no aplicará este ACCOUNTCODE solamente para las llamadas que no tengan uno.

Si se quiere activar la configuración para permitir las llamadas entre extensiones. En el agi-conf1 se modifican estos parámetros:

SIP Call

No

Se habilita para permitir llamadas gratuitas entre las extensiones SIP/IAX

SIP Call Prefix

555

Prefijo que hay que anteponer al numero de extensión SIP/IAX que se quiere llamar

Direct Call

No

Si se habilita no se presentará una locución para marcar un numero. Si este numero empieza por 555 la llamada sera cursada hacia la extensión SIP/IAX marcada; de otra forma se cursará normalmente

Yes

Se habilita para permitir llamadas gratuitas entre las extensiones SIP/IAX

Para que queden:

SIP Call

93

SIP Call Prefix

555

Prefijo que hay que anteponer al numero de extensión SIP/IAX que se quiere llamar

Direct Call

Yes

Si se habilita no se presentará una locución para marcar un numero. Si este numero empieza por 555 la llamada sera cursada hacia la extensión SIP/IAX marcada; de otra forma se cursará normalmente

Para llamar de una extensión a otra habrá que marcar 555 + el parámetro que aparece en esta columna de cada cliente:

Si por ejemplo el primer cliente de la lista quiere llamar el segundo, tendrá que marcar: 555 837943829751935 El parámetro LOGIN que se llama también ALIAS, se puede modificar en cualquier momento y esto permite simplificar los números que deben marcar los clientes para llamarse entre ellos. En el menú notifications, se configurará la parte relacionada con los avisos que se enviarán a los clientes cuando su crédito se está agotando. Aquí se definen los distintos valores que el cliente puede escoger y cada cuando enviar los avisos. Para que este modulo sea activo, el cliente tiene que configurarlo en su pagina personal.

Titulo List of possible values to notify 94

Valor 1:3:5:10:20:50:100:500:1000

Descripción Valores que el cliente puede

escoger (1 dólar, 3 dolares, etc) Notications Cron Module

1

Con 0 se deshabilita el modulo

Notications Delay

1

Cada cuantos días enviar la notifica. Si se configura con 0, la notifica se enviará cada vez que se ejecute el cron relativo (por defecto a la medianoche de cada día)

En dashboard se configura la posición de distintos cuadros que aparecerán en la pagina de administración de A2Bbilling cuando se presione el siguiente menú:

Titulo

Valor

Descripción

Enable info module about customers

LEFT

Modulo clientes

Enable info module about refills

CENTER

Modulo recargas

Enable info module about payments

CENTER

Modulo Pagos

Enable info module about calls

RIGHT

Modulo Llamadas

Enable info module about system

LEFT

Modulo Info sistema

Enable news module

NONE

Modulo novedades acerca del programa

Para terminar en el ultimo menú, webagentui, se configuran dos parámetros que definen lo que puede o no puede hacer un agente desde su pagina personal.

95

Titulo

Valor Descripción

Personal Info

1

El revendedor puede modificar sus datos personales. Con 0 no puede

Authorize Remittance Request

1

Con 1 se habilita en la pagina del revendedor el enlace para solicitar el pago de sus comisiones. Con 0 se deshabilita.

Terminada la configuración de los parámetros del sistema de facturación, se puede empezar con la creación de los proveedores que se utilizarán para terminar las llamadas con sus relativas tarifas. 4.2 Configuración de los Proveedores Para poner en marcha A2Billing hay que seguir este orden: • • • • • • •

Configurar los proveedores Configurar las troncales Configurar los Callplan Configurar los RateCard Asociar los Ratecards a los Callplan Importar las tarifas Crear los clientes

Siguiendo la lista, se empieza configurando los proveedores: En el menú de la izquierda de la pagina de administración de A2Billing se selecciona Providers → Providers:

En la pagina que aparece, se selecciona “Add Provider” y se rellenan los campos con los siguientes valores:

96

Se confirma la creación del nuevo proveedor presionando el Botón “Confirm Data”. Luego se pasa a la configuración de las troncales utilizando el siguiente menú:

En la pagina que aparece, se selecciona “Add Trunk” y se rellenan los campos con los siguientes valores:

97

Una pequeña explicación de los valores: VOIP PROVIDER: el nombre del proveedor como se ha configurado en PROVIDERS → Providers LABEL: una etiqueta que identifique esta troncal ADD PREFIX: como se verá al momento de configurar las tarifas, normalmente estas se añaden utilizando los códigos de los países sin el 00 por delante. Cuando se marca un numero para que el AGI pueda buscar en la base de datos una ruta para el destino, se quita al numero marcado (si presentes) los prefijos definidos en este parámetro del grupo agi-conf1: International prefixes

011,00,09

Prefijos internacionales que se quitarán si el CallPlan lo prevea

Una vez que a2billing haya encontrado la ruta para la llamada, hay que volver a poner los dos 00 si el proveedor exige que las sintaxis para marcar un numero sea: 00 + código país + numero. Es por eso que en este campo se pone 00. En el caso que el proveedor venda distintos tipos de rutas (Oro, Platino) será el mismo proveedor que indicará que tipo de prefijo hay que poner delante del numero marcado para salir con una tarifa en lugar de otra. PROVIDER TECH: aquí se define que tipo de protocolo se utiliza para la troncal que se está configurando. En este caso SIP. Puede ser SIP, IAX2, DAHDI PROVIDER IP: en este campo se indica la IP del proveedor o mejor aun la etiqueta inicial de la troncal como se ha definido en el archivo sip.conf. En este caso voztovoice1 es la troncal configurada FAILOVER TRUNK: como esta es la primera troncal que se define, no se puede seleccionar ninguna troncal de respaldo MAXIMUM CONNECTIONS: numero máximo de canales que brinda el proveedor. En este caso 30 STATUS: La troncal está activada Se guarda la configuración presionando el botón “Confirm data”. Se vuelve nuevamente al menú Trunks y se configura la segunda troncal de la siguiente forma:

98

Los únicos dos campos que varían son: LABEL y PROVIDER IP. En el primero se pone una etiqueta para la segunda troncal y en el segundo el nombre voztovoice2 como configurado en el sip.conf. Se presiona el botón “Confirm Data”. Ahora en la lista de troncales aparecerá:

Se borra la que venía con la instalación de A2Billing y se confirma presionando el botón Delete:

99

Es siempre una buena practica tener configurada una troncal de respaldo en el caso que la primera no esté funcionando. Algunos proveedores proveen este servicio brindando dos troncales con distintas IP. La primera se utiliza como principal y la segunda como respaldo. En este caso se utilizará la segunda troncal como respaldo de la primera. Se vuelve al menú Trunks y se selecciona el icono para modificar la primera troncal:

En la pagina que aparece, en el campo: FAILOVER TRUNK se selecciona voztovoice2:

Se guardan los cambios presionando el botón “Confirm Data”. 4.3 Creación de los planes de llamadas y de las tarifas Siguiendo la lista indicada en el párrafo anterior, se continua con la creación de los Callplan, Ratecard y la importación de las tarifas. Para crear un Callplan se entra en el menú RATES → Callplan

100

En la nueva pagina se selecciona “Add Callplan”. Aparecerá la siguiente ventana:

Los campos: NAME: nombre del Callplan. En este caso Base. LCR TYPE: en este campo se define si se escogerán las tarifas más baratas desde el punto de vista del vendedor o del cliente. En este caso desde el punto de vista del vendedor. PACKAGES: se puede añadir al Callplan un paquete de minutos gratuitos o de llamadas gratuitas. En este caso se deja el valor predefinido ya que todavía no se han creados paquetes de este tipo. REMOVE INTER PREFIX: como ya se ha dicho anteriormente, antes de buscar una ruta hay que quitar los prefijos si están presentes en el numero marcado, como definido en este parámetro del agiconf1: International prefixes

011,00,09

Prefijos internacionales que se quitarán si el CallPlan lo prevea

Esto para que A2billing pueda buscar en la tabla de las tarifas la ruta para la llamada que se está cursando. Una vez encontrada la ruta, se volverá a poner los dos 00 como indicado en la configuración de las dos troncales. Se termina presionando el botón “Confirm Data” Se pasa al menú RateCards y se escoge “Add RateCard”. En la ventana que aparece se configura la RateCard: 101

Los campos: TARIFFNAME: el nombre que se asigna a la tarifa. Como esta tarifa se asociará al CallPlan Base que se acaba de crear, se escoge el nombre Base1 para acordarse que la Ratecard está asociada con ese CallPlan START DATE: fecha de inicio de vigencia de las tarifas. Si no se cambia será la fecha en que se ha creado. EXPIRY DATE: fecha de vencimiento de la tarifa. Como los proveedores suelen actualizar las tarifas periódicamente, cuando se carga una nueva RateCard con las nuevas tarifas, habrá que indicar la fecha exacta en que la RateCard se vencerá (caducará). DESCRIPTION: en este campo se puede añadir una descripción de la tarifa. DNID PREFIX: si se quiere que esta tarifa se utilice solamente para determinados prefijos (ejemplo 573 para los celulares colombianos), hay que indicarlo aquí. Predefinido es el valor all (todos los prefijos). CALLERID PREFIX: parecido al campo precedente pero desde el punto de vista del identificador de llamada. Si por ejemplo se quiere que solo los clientes cuyo CALLERID empieza con 57 (Colombia) puedan utilizar esta tarifa hay que indicarlo en este campo. Predefinido es el valor all (todos los CALLERID) Para guardar los cambios se presiona el botón “Confirm Data”. Ahora para indicar a A2Billing que esta Ratecard se debe utilizar con el Callplan Base que se ha creado anteriormente, se vuelve al menú Call plan y se modifica el CallPlan: 102

Aparecerá:

Se selecciona la RateCard Base1 y se presiona el botón “ADD RATECARD”. La pagina cambiará de esta forma:

La RateCard Base1 será parte del Callplan Base. Para guardar los cambios se presiona el botón “Confirm Data”. Se ha configurado un Callplan para los clientes y una RateCard para el Callplan. Falta solamente ingresar las tarifas. Para hacerlo hay dos métodos: • •

el manual (una a una) importando un archivo en formato CSV con todas las tarifas configuradas.

Este archivo debe contener por lo menos los siguientes datos: • • •

Prefijo Nombre del destino Tarifa de venta

Estos tres valores aunque sean suficientes para poder empezar a vender trafico telefónico, no son la 103

mejor opción en los siguientes casos: 1. si se quiere ver en las estadísticas de las llamadas el valor de lo que se está ganando 2. si para algunos destinos la tarificación no es por segundo 3. si se quiere diferenciar la tarificación que aplica el proveedor de la que se aplica a los clientes. Por esta serie de motivos el archivo debe tener las siguientes columnas: • • • • • • • •

prefijo nombre destino tarifa de venta tarifa de compra duración mínima de la llamada que cobra el proveedor tarificación que aplica el proveedor duración mínima de la llamada que se cobrará al cliente tarificación que se aplica al cliente

Para cargar las tarifas en A2billing se utilizará LibreOffice y se buscará un proveedor de llamadas que permite descargar las tarifas desde su pagina web. En este caso se ha escogido SipTraffic. Se entra en la pagina de SipTraffic: se sigue el enlace “View our Rates”, se selecciona “See USD rates“ y para terminar se bajan las tarifas (Bronze):

Se guarda el archivo en el computador local. Antes de abrirlo hay que modificar la configuración de LibreOffice de forma que la división entre enteros y decimales se realice con el punto en lugar de la coma. Para eso se abre LibreOffice Calc y se selecciona el menú “Herramientas → Opciones”. En la ventana que aparece, se escoge “Configuración de idioma → Idiomas”. En el lado derecho de la ventana la configuración debe ser:

Se presiona el botón aceptar y se abre el archivo bajado del sitio web de SipTraffic. En la parte baja aparecen dos hojas: 104

• •

Rates Numberplan

Se selecciona la hoja numberplan y se modifica de la siguiente forma:

En la primera columna se ponen los prefijos, en la segunda los nombres de los destinos, en la tercera la siguiente formula =(D1*1.15) que luego se copia en todas las celdas de la columna C. De esta forma se aumenta el valor de las llamadas de un 15% que representará la ganancia. En la columna D aparecerá el costo de las llamadas que aplica el proveedor. Las columnas C y D deben tener cinco cifras decimales (Si se utiliza como moneda el dolar). En las columnas E,F,G,H, respectivamente: • • • •

duración mínima de la llamada que cobra el proveedor tarificación que aplica el proveedor duración mínima de la llamada que se cobrará al cliente tarificación que se aplica al cliente

Como la tarificación para México es por minuto, en la hoja hay que buscar las lineas donde aparecen los distintos destinos de México y modificar la ultima cuatros columnas como da imagen:

Terminadas las modificaciones, se selecciona el menú “Archivo → Guardar como” y selecciona el formato CSV:

Se presiona el botón Guardar. En la nueva ventana:

105

Se presiona el botón “Usar formato Text CSV”. En la siguiente ventana las opciones deben quedar de la siguiente forma:

Se presiona el botón Aceptar. De esta forma ya se tiene listo el archivo para cargarlo en A2Billing. En la pagina de administración se escoge el menú “RATES → Import”. Se seleccionan los distintos valores como se muestra en la imagen que sigue:

106

Se continua en la parte más abajo de la pagina presionando el botón Examinar:

y en la ventana que aparece se escoge el archivo que se acaba de guardar en formato CSV. Una vez seleccionado se presiona “Import RateCard”. El sistema empezará a importar las tarifas en la base de datos. Después de algunos segundos aparecerá esta pagina:

107

Donde se podrá comprobar si las tarifas se están importando correctamente. Una vez que se haya hecho este tipo de control se continua presionando el botón “Continue to import the RateCard”. Si aparece este error:

Significa que el archivo tiene un tamaño de más de 8Mb que es el limite que se ha configurado en el parámetro: Max File Upload Size en SYSTEM SETTINGS → Global List → webui. Para que se puedan cargar las tarifas se modifica el parámetro y se pone un valor más alto. Luego se modifica la siguiente linea del archivo php.ini: nano +878 /etc/php.ini Cambiando el parámetro: upload_max_filesize = 8M Con el numero de MegaBytes configurados en A2Billing. Se guardan los cambio y se reinicia el servidor Web: 108

service httpd restart Se vuelve a la pagina de administración de A2Billing y se intenta cargar las tarifas nuevamente. Si no aparecen más errores, en el menú Rates:

estarán todas las tarifas que se acaba de importar. Si aparece este error en el navegador:

Hay que abrir el archivo CSV con un editor de texto y guardar el contenido en formato TXT sin ningún tipo de formateo. Luego se vuelve a importar las tarifas al sistema. 4.4 Configuración de los métodos de pago Terminada la parte dedicada a las tarifas y los planes de llamadas, para poner en marcha el sistema de facturación, faltan todavía unos pasos: • • • •

configurar los sistemas de pago modificar las plantillas de los correos que utiliza el sistema modificar los datos que aparecerán en las facturas de los clientes crear por lo menos un cliente

Se entra en el menú BILLING → Payment Methods:

109

En la nueva pagina estará la lista de métodos soportados por A2Biling:

El único que se utilizará para los fines de este libro, es PayPal. Por eso hay que desactivar todos los demás. Se entra en la configuración del primero de la lista presionando el botón “View Detail”:

En la nueva pagina se desactiva el método de pago seleccionando el botón “False”:

y confirmando la modifica presionando el botón “Update” que aparece al final de la pagina. Se sigue el mismo procedimiento para los pagos con Moneybookers (ahora Skrill). Para terminar se entra en el método de pago con PayPal y se añade el correo electrónico que se ha utilizado al momento de registrarse en PayPal. Ejemplo:

110

Se guardan las modificaciones presionando el botón “Update”. 4.5 Configuración para la facturas Cada vez que un cliente realice un pago/recarga, se emitirá una factura. En la factura aparecerán los datos de la empresa que está facturando. Para definir estos datos hay que entrar en el menú INVOICES → Configuration:

En la nueva pagina se rellenan los campos con los datos de la empresa que va a facturar. En la imagen que sigue un ejemplo de como se debe hacer:

111

Se guardan los cambios presionando el botón “Save”. Para añadir un logo a las facturas de la pagina de administración de A2Billing, se copia la imagen en la carpeta: /var/www/html/admin/Public/templates/default/images/ Luego se modifica el siguiente archivo: nano /var/www/html/admin/Public/A2B_invoice_view.php y después de esta linea: