VoIP

FreenetIS umožňuje spravovat VoIP účty. Systém lze napojit na asterisk (popř. na SER a jeho deriváty) a dále na billing.

Obecné informace

V systému FreenetIS si může každý uživatel zaregistrovat právě jedno číslo. Pokud je potřeba další účet je třeba zaregistrovat dalšího uživatele. Uživatel si v prostředí FreenetISu může změnit údaje o VoIP ůčtu jako heslo a nastavení hlasové schránky. Pokud je aktivní modul billingu je možné zobrazit i výpis hovorů popřípadě dobíjet kredit.

Nastavení

Pro správnou funkci VoIP je potřeba v nastavení FreenetISu nastavit rozsah čísel, které si můžou uživatelé registrovat. Dále je možné nastavit sip proxy, která se bude zobrazovat v uživatelském účtu VoIP. Pokud nějaké z rozsahu čísel nemá být nabízeno k registraci je potřeba jej definovat ve vynechaných čísel.

Integrace s asteriskem

Nainstalujeme potřebné balíky(Debian a jeho derivace).

apt-get install mysql asterisk asterisk-mysql

Pro integraci s asteriskem je potřeba vytvořit pohled do tabulky voip_sips:

Nejdříve je potřeba vytvořit databázi pro asterisk:

mysql> create database asterisk;

A pak samotné view do databáze FreenetISu:

 CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `asterisk`.`sip` AS select `freenetis`.`voip_sips`.`id` AS `id`,
`freenetis`.`voip_sips`.`name` AS  `name`,
`freenetis`.`voip_sips`.`amaflags` AS `amaflags`,
`freenetis`.`voip_sips`.`accountcode` AS `accountcode`,
`freenetis`.`voip_sips`.`callgroup` AS `callgroup`,
`freenetis`.`voip_sips`.`callerid` AS `callerid`,
`freenetis`.`voip_sips`.`canreinvite` AS `canreinvite`,
`freenetis`.`voip_sips`.`context` AS `context`,
`freenetis`.`voip_sips`.`defaultip` AS `defaultip`,
`freenetis`.`voip_sips`.`dtmfmode` AS `dtmfmode`,
`freenetis`.`voip_sips`.`fromuser` AS `fromuser`,
`freenetis`.`voip_sips`.`fromdomain` AS `fromdomain`,
`freenetis`.`voip_sips`.`fullcontact` AS `fullcontact`,
`freenetis`.`voip_sips`.`host` AS `host`,
`freenetis`.`voip_sips`.`insecure` AS `insecure`,
`freenetis`.`voip_sips`.`language` AS `language`,
`freenetis`.`voip_sips`.`mailbox` AS `mailbox`,
`freenetis`.`voip_sips`.`md5secret` AS `md5secret`,
`freenetis`.`voip_sips`.`nat` AS `nat`,
`freenetis`.`voip_sips`.`deny` AS `deny`,
`freenetis`.`voip_sips`.`permit` AS `permit`,
`freenetis`.`voip_sips`.`mask` AS `mask`,
`freenetis`.`voip_sips`.`pickupgroup` AS `pickupgroup`,
`freenetis`.`voip_sips`.`port` AS `port`,
`freenetis`.`voip_sips`.`qualify` AS `qualify`,
`freenetis`.`voip_sips`.`restrictcid` AS `restrictcid`,
`freenetis`.`voip_sips`.`rtptimeout` AS `rtptimeout`,
`freenetis`.`voip_sips`.`rtpholdtimeout` AS `rtpholdtimeout`,
`freenetis`.`voip_sips`.`secret` AS `secret`,
`freenetis`.`voip_sips`.`type` AS `type`,
`freenetis`.`voip_sips`.`username` AS `username`,
`freenetis`.`voip_sips`.`disallow` AS `disallow`,
`freenetis`.`voip_sips`.`allow` AS `allow`,
`freenetis`.`voip_sips`.`musiconhold` AS `musiconhold`,
`freenetis`.`voip_sips`.`regseconds` AS `regseconds`,
`freenetis`.`voip_sips`.`ipaddr` AS `ipaddr`,
`freenetis`.`voip_sips`.`regexten` AS `regexten`,
`freenetis`.`voip_sips`.`cancallforward` AS `cancallforward`,
`freenetis`.`voip_sips`.`setvar` AS `setvar`,
`freenetis`.`voip_sips`.`auth` AS `auth` from `freenetis`.`voip_sips`; 

Dále vytvoříme view pro hlasovou schánku:

CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `asterisk`.`voicemail_users` AS select `freenetis`.`voip_voicemail_users`.`id` AS `uniqueid`,
`freenetis`.`voip_voicemail_users`.`customer_id` AS `customer_id`,
`freenetis`.`voip_voicemail_users`.`context` AS `context`,
`freenetis`.`voip_voicemail_users`.`mailbox` AS `mailbox`,
`freenetis`.`voip_voicemail_users`.`password` AS `password`,
`freenetis`.`voip_voicemail_users`.`fullname` AS `fullname`,
`freenetis`.`voip_voicemail_users`.`email` AS `email`,
`freenetis`.`voip_voicemail_users`.`pager` AS `pager`,
`freenetis`.`voip_voicemail_users`.`stamp` AS `stamp` from 
`freenetis`.`voip_voicemail_users` where (`freenetis`.`voip_voicemail_users`.`active` = _utf8'1');

Konfigurace MySQL

Asterisk umí přistupovat přímo k mysq.

V /etc/asterisk/res_mysql.conf přidáme

[general]
dbhost = localhost
dbname = asterisk
dbuser = username
dbpass = password
dbport = 3306
dbsock = /var/run/mysqld/mysqld.sock

Konfigurace Asterisku

Všechny soubory jsou v /etc/asterisk/

V extconfig.conf řekneme, že některé věci se čtou z DB - mělo by tam být

sippeers => mysql,asterisk,sip
voicemail => mysql,asterisk,voicemail_users
;extensions => mysql,asterisk,extensions   - zatím neimplementováno ve FreentISu!!!

Pro otestování připojení k MySql se připojíme ke konzoli

asterisk -rvvv

a spustime realtime mysql status

sip*CLI> realtime mysql status
Connected to asterisk@localhost, port 3306 with username asterisk for 4 seconds.

Tím máme funkčnost spojení otestovanou.

V tento okamžik je asterisk integrován s FreentISem a po přidání VoIP účtu ve FreenetISu by mělo být možné se přihlásit k ústředně pomocí SW nebo HW klienta. Status přihlášení lze sledovat ve FreenetISu v nastavení VoIP učtu

Dále už nastavení asterisku záleží na požadavcích uživatele. Vzorová konfigucace pro prunk od NFX s.z.p.o.:

[general]
static=yes
writeprotect=no
userscontext=default

[default]
;defaultni kontext, spada sem vse co neni v jinem kontextu
exten => s,1,Answer()
exten => s,n,Wait(2)
exten => s,n,Playback(slfree-volane-cislo-neexistuje)
exten => s,n,Hangup()

[internal]
;defaultni kontext pro nase cisla

;pokud volame 11 jdeme do vlastni hlasove shranky
exten => 11,1,Goto(mailbox,s,1)


;pokud volame tisnove linky skaceme do kontextu emergency
exten => 112,1,Goto(emergency,${EXTEN},1)
exten => 150,1,Goto(emergency,${EXTEN},1)
exten => 155,1,Goto(emergency,${EXTEN},1)
exten => 158,1,Goto(emergency,${EXTEN},1)

;konverze dlouhych cisel na kratka - jen pro CR
exten => _00420XXXXXXXXX,1,Goto(internal,${EXTEN:5},1)

;hovor je do slfree, prozkoumame kontext slfree
exten => _951020XXX,1,Goto(slfree,${EXTEN},1)

;hovor je do CR, prozkoumame kontext outgoing-nfx
exten => _XXXXXXXXX,1,Goto(outgoing-nfx,00420${EXTEN},1)

;hovor je do sveta, prozkoumame kontext outgoing-nfx
exten => _XXXXXXXXXXXXXX,1,Goto(outgoing-nfx,${EXTEN},1)

;jinak nezname cislo
exten => _X.,1,Goto(default,s,1)

;vse jde na ustrednu do nfx
[outgoing-nfx]
exten => _XXXXXXXXXXXXXX,1,Set(CALLERID(num)=00420${CALLERID(num)})
exten => _XXXXXXXXXXXXXX,n,Dial(SIP/nfx/${EXTEN})
exten => _XXXXXXXXXXXXXX,n,Hangup

[incomming-nfx]
;konverze dlouhych cisel na kratka
exten => _00420XXXXXXXXX,1,Goto(incomming-nfx,${EXTEN:5},1)

;hovor je do slfree, prozkoumame kontext [slfree]
exten => _951020XXX,1,Goto(slfree,${EXTEN},1)

;jinak nezname cislo
exten => _X.,1,Goto(default,s,1)

[slfree]
;kontext pro cisla z slfree, data bereme z db

exten => _951020XXX,1,Macro(safedial,SIP/${EXTEN},30)

;Realtime integrace zatím není ve FreenetISu implementována!!!
;switch => Realtime

Nakonec nastavíme trunk pro odchozí hovory.

[nfx]
type=peer
host=sip.nfx.czf
qualify=no
language=cz
insecure=port,invite
fromdomain=******
canreinvite=no
context=incomming-nfx
nat=no

Tro jiné trunky (např trunk od Havel nebo 802.cz) je potřeba vlastní řešení...

Billing API

Billing zapišťuje dobíjení kreditu, tarifikaci hovorů, výpis hovorů aj. Do FreenetISu bylo zaintegrováno LBilling API. LBilling API bylo vyvynuto pro potřeby NFX s.z.p.o. a jeho specifinace je dostupná na interních stránkách NFX. Samotný billing byl ale navržen tak, aby byl univerzální a pouze se měnil ovladač billungu.

Aktuálně je implementován pouze driver pro Lbilling API NFX. Další API lze dle potřeby doprogramovat.

Instalace synchronizačního skriptu

Synchronizační skript zproztředkovává pro FreenetIS dobíjení kreditu a synchronizaci VoIP uživatelů.

Před instalací zkontrolujte zda-li máte nainstalovaný na SIP serveru perl.

1) Vytvořte MySQL pojmenovanou lbilling na stejném DB serveru jako máte databázi FreenetISu.

2) Vytvořte pohledy do FreenetIS databáze (pokud se FreenetIS databáze nejmenuje freenetis, změňte všechny hodnoty `freenetis` na jméno Vaší databáze, popřípadě změňte i uživatele, který definuje pohledy).

CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `transfers` AS select `freenetis`.`transfers`.`id` AS      `id`,`freenetis`.`transfers`.`origin_id` AS `origin_id`,`freenetis`.`transfers`.`destination_id` AS  `destination_id`,`freenetis`.`transfers`.`previous_transfer_id` AS `previous_transfer_id`,`freenetis`.`transfers`.`member_id` AS `member_id`,`freenetis`.`transfers`.`user_id` AS `user_id`,`freenetis`.`transfers`.`type` AS `type`,`freenetis`.`transfers`.`datetime` AS `datetime`,`freenetis`.`transfers`.`creation_datetime` AS `creation_datetime`,`freenetis`.`transfers`.`text` AS `text`,`freenetis`.`transfers`.`amount` AS `amount` from `freenetis`.`transfers`;

CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `voip_lbilling_accounts` AS select `voip_lbilling_accounts`.`id` AS `id`,`voip_lbilling_accounts`.`userid` AS `userid`,`voip_lbilling_accounts`.`cid` AS `cid`,`voip_lbilling_accounts`.`state` AS `state`,`voip_lbilling_accounts`.`limit` AS `limit`,`voip_lbilling_accounts`.`tarif` AS `tarif`,`voip_lbilling_accounts`.`descr` AS `descr` from `freenetis`.`voip_lbilling_accounts`;

CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `voip_lbilling_payments` AS select `voip_lbilling_payments`.`id` AS `id`,`voip_lbilling_payments`.`userid` AS `userid`,`voip_lbilling_payments`.`date` AS `date`,`voip_lbilling_payments`.`value` AS `value`,`voip_lbilling_payments`.`state` AS `state`,`voip_lbilling_payments`.`descr` AS `descr` from `freenetis`.`voip_lbilling_payments`;

CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `voip_lbilling_users` AS select `voip_lbilling_users`.`id` AS `id`,`voip_lbilling_users`.`type` AS `type`,`voip_lbilling_users`.`state` AS `state`,`voip_lbilling_users`.`limit` AS `limit`,`voip_lbilling_users`.`currency` AS `currency`,`voip_lbilling_users`.`descr` AS `descr` from `freenetis`.`voip_lbilling_users`;

2) Na SIP server umístěte následující soubory lbilling-synchronization.pl a html.tt do složky /usr/local/bin/lbilling/

3) Nastavte práva pro synchronizační skript:

chmod a+x /usr/local/bin/lbilling/lbilling-synchronization.pl

4) Nakonfigurujte proměnné ve skriptu lbilling-synchronization.pl (sekce configuration).

nano /usr/local/bin/lbilling/lbilling-synchronization.pl

5) Přidejte synchronizační skript (následující řádky) do CRONu (/etc/crontab):

#lBilling synchronization
30 22   * * * root perl /usr/local/bin/lbilling/lbilling-synchronization.pl -s
*/5 *  * * * root perl /usr/local/bin/lbilling/lbilling-synchronization.pl -p