Zphone check dacl.agi

Allgemeine Info

zphone_check_dacl.agi ist ein AGI Script welches die Rufberechtigungen für einen Teilnehmer prüft, ob er eine Verbindung aufbauen/wählen kann oder nicht. Der klassische Einsatzzweck ist die Amtsberechtigung.

Syntax

zphone_check_dacl.agi ZIEL TEILNEHMER

ZIEL ist das gerufene Ziel, also in den meisten Fällen ${EXTEN}
TEILNEHMER ist der Anrufer, i.d.r ${CALLERID(num)}

Besitzt der Anrufer nicht die nötige Berechtigung, so wird der Ruf einfach beendet! ( hangup )

Beispiel

exten => _0X.,1,AGI(zphone_check_dacl.agi,${EXTEN:1},${CALLERID(num)})
exten => _0X.,2,Dial(SIP/${EXTEN:1}@trunk)
exten => _0X.,3,Hangup

Im oben beschriebenen Beispiel wird über eine führende Null (0) das Amt angewählt.
An erster Position prüft das AGI Script, ob der Anrufer die nötigen Rechte für diesen Anruf besitzt.
Bedingt durch die "Amtsnull" muss dem AGI die EXTEN Variable um eine Stelle gekürzt übergeben werden!!!
Wenn der Anrufer das Ziel anwählen kann, wird an zweiter Position der Ruf über SIP aufgebaut. Im anderen Fall endet der Ruf an dieser Stelle.

Code

#!/usr/bin/php4-cgi -q
<?php
/*
 *      AGI Script for checking dialout permissions
 *      (c) Lukas Ziaja <lz@metasec.de>
 */

include_once("/var/www/zphone/etc/config.inc.php");
include_once($CCBOX["INC"]."ccbox.inc.php");
include_once($CCBOX["INC"]."func_sql.inc.php");
include_once($CCBOX["INC"]."func_voip_system.inc.php");

$in = fopen("php://stdin", "r" );

/*
 *      clean up the parameterstrings
 */
foreach ( $argv as $key => $val )
    $argv[$key] = trim($val);

/*
 *      just do some debug output
 */
echo "noop DST:".$argv[1]." SRC:".$argv[2]."\n";

if ( !zphone_check_dial_out_acl( $argv[1], $argv[2] ) ) {
    print("hangup\n");
}

fclose($in);
return true;
?>

Debug

Das Script kann zu Debugzwecken auf der Konsole ausgeführt werden

/var/lib/asterisk/agi-bin/zphone_check_dacl.agi 004912345678 13
noop DST:004912345678 SRC:139
hangup

Hier prüfen wir, ob der Teilnehmer 13 die Nummer 004912345678 anrufen kann.
Der Teilnehmer darf es nicht und wird aufgelegt...