Das Capi2Text-Paket Die Einleitung Dieses Paket wurde initial von Andreas Pohl (E-MAIL [1]apohl@ibp-consult.com) zusammengestellt und von Jürgen Edner (E-MAIL [2]juergen@eisfair.org) weiter entwickelt. Die Web-Anrufliste wurde von Rolf Bensch (E-MAIL [3]rolf@bensch-net.de) erstellt und weiter gepflegt. Capi2Text überwacht ankommende Anrufe auf dem ISDN-Bus, versucht deren Namen mittels lokaler Suche, Suche in einem LDAP-Verzeichnis oder einer Websuche aufzulösen. Auf Wunsch kann die Rufnummer in einer Textdatei protokolliert und/oder per UDP-Broadcast an alle Nutzer im lokalen Subnetz gemeldet werden, die dann die Anrufe z.B. mittels Respond-Programm auf den Windows-Clients angezeigt bekommen. Ab der Version 1.2.5 kann alternativ das Listen2Fritz-Programm verwendet werden um Anrufe direkt von einer AVM-Fritzbox^TM mittels UPnP auszulesen. Details hierzu finden sich im Absatz [4]AVM-Fritzbox^TM -Anrufmonitor Die Funktionen Das Capi2Text-Paket besteht aus folgenden Komponenten: * Capi2Text - Stellt die CAPI-Schnittstelle zum Ermitteln der Telefonnummer eines Anrufers zur Verfügung. * Listen2Fritz - Stellt die Schnittstelle zum Ermitteln der Telefonnummer eines Anrufers zur Verfügung. ([5]https://github.com/gromeck/Listen2Fritz) * Capi2Text Web-Anrufliste - Stellt eine Weboberfläche zur Anzeige der ein- und ausgegangenen Anrufe zur Verfügung. (Rolf Bensch E-MAIL [6]rolf@bensch-net.de) Die Voraussetzungen Dieses Paket benötigt die folgenden Pakete um funktionieren zu können: capi, perl. Für die LDAP-Suche wird ein installiertes LDAPclient-Paket benötigt, für die Websuche wird ein installiertes Lynx-Paket benötigt. Die Installation Das Capi2Text-Paket wird über das Setup-Menü installiert. Wird eine ältere Paketversion vorgefunden, so wird diese deinstalliert bevor die neuen Programmdateien installiert werden. Nach dem Installieren der Programmdateien wird direkt der Konfigurationseditor gestartet um die Konfiguration anzupassen. Nach Beendigung dieses Schrittes werden die Konfigurationsdateien generiert und alle benötigten Programme gestartet. Das Menü im Setup-Programm Das Menü im Setup-Programm ist wie folgt aufgebaut: * Capi2Text-Configuration + View documentation: Anzeigen der Dokumentation + Edit configuration: Bearbeiten der Konfiguration + Advanced configuration file handling: Konfigurationen verwalten + Show status: Status des Capi2Text-Daemon anzeigen + Start service: Starten des Capi2Text-Daemon + Stop service: Stoppen Capi2Text-Daemon + Restart service: Neustarten des Capi2Text-Daemon + Phone number lookup: Suchen einer Telefonnummer + Test BROADCAST function: Sendet eine Testnachricht per Broadcast + Test LDAP function: Sendet eine LDAP-Testabfrage + Test phone number settings: Prüft die Rufnummerneinstellungen + Download flag icons for Web-GUI: Icon-Dateien für den Web-GUI aus dem Internet laden + View log file: Anzeigen der Logdatei + Return: Untermenü verlassen Die Menüpunkte dürften selbsterklärend sein, da sie keinerlei weitere Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter eingegangen. Die Änderung der Konfiguration Die Konfiguration kann über den Menüpunkt 'Edit configuration' geändert werden. Standardmäßig wird der Editor aufgerufen, der in der Environment-Konfiguration über die Variable 'EDITOR' festgelegt wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die Konfiguration aktiviert werden soll. Wird dies bestätigt, werden über ein Skript die Anpassungen umgehend wirksam gemacht. Die Konfigurationsdatei In der Konfigurationsdatei, die über das Menü zugänglich ist, sind folgende Parameter vorhanden; wer sie von Hand editieren will findet sie unter /etc/config.d/capi2text. Die Parameter START_CAPI2TEXT Zur Aktivierung des Capi2Text-Programms muss dieser Parameter lediglich auf den Wert 'yes' gestellt werden. Die Einstellung 'no' deaktiviert das Programm. Gültige Werte: yes, no Standardeinstellung: START_CAPI2TEXT='no' CAPI2TEXT_DEFAULT_CCODE (optional) Optionaler Parameter: Über diesen Parameter kann eine vom Standard abweichende Landesvorwahl festgelegt werden. Wird dieser Parameter nicht gesetzt, so wird automatisch die deutsche Landesvorwahl '49' verwendet. Gültige Werte: Landesvorwahlen ohne führende Nullen, z.B. 31, 32, 33, 34, 351, 352, 41, 420, 423, 43, 44, 48, 49 Standardeinstellung: CAPI2TEXT_DEFAULT_CCODE=” CAPI2TEXT_DEFAULT_ACODE (optional) Optionaler Parameter: Über diesen Parameter kann eine Ortsvorwahl festgelegt werden, die vom Programm Listen2Fritz verwendet wird, falls eine eingehende Rufnummer unvollständig übertragen wird. Gültige Werte: Ortsvorwahl entsprechend der Auswahl der Landesvorwahl ohne führende Null Standardeinstellung: CAPI2TEXT_DEFAULT_ACODE=” CAPI2TEXT_ISDN_CONTROLLER (optional) Optionaler Parameter: Über diesen Parameter kann festgelegt werden, an welchen ISDN-Kontroller das Capi2Text-Programm gebunden werden soll. Wird dieser Parameter nicht gesetzt, so wird automatisch der erste ISDN-Kontroller verwendet. Gültige Werte: Nummer des ISDN-Kontroller Standardeinstellung: CAPI2TEXT_ISDN_CONTROLLER=” CAPI2TEXT_ISDN_MSN (optional) Optionaler Parameter: Über diesen Parameter kann eine oder mehrere durch Komma getrennte MSN angegeben werden für welche das Capi2Text-Programm eingehende Anrufe annehmen soll. Wird dieser Parameter nicht gesetzt, so werden Anrufe für alle MSN ausgewertet. Gültige Werte: Eine oder mehrere MSN Standardeinstellung: CAPI2TEXT_ISDN_MSN=” CAPI2TEXT_NUMBER_UNKNOWN (optional) Optionaler Parameter: Über diesen Parameter können vom Standard abweichende Texte festgelegt werden, welcher ausgegeben werden wenn vom Anrufer keine Rufnummer übermittelt wurde. Wird dieser Parameter nicht gesetzt, so wird folgender Kurz- bzw. Langtext verwendet: 'unbekannt|Nr. unbekannt'. Gültige Werte: Kurztext|Langtext Standardeinstellung: CAPI2TEXT_NUMBER_UNKNOWN=” CAPI2TEXT_NUMBER_NOTFOUND (optional) Optionaler Parameter: Über diesen Parameter kann ein vom Standard abweichender Text festgelegt werden, welcher ausgegeben wird wenn die vom Anrufer übermittelte Rufnummer nicht aufgelöst bzw. nicht gefunden werden konnte. Wird dieser Parameter nicht gesetzt, so wird der Text 'Kein Eintrag' ausgegeben. Gültige Werte: Text Standardeinstellung: CAPI2TEXT_NUMBER_NOTFOUND=” CAPI2TEXT_SOURCE (optional) Optionaler Parameter: Über diesen Parameter kann man festlegen welches Programm für die Anrufüberwachung verwendet werden soll. Zur Auswahl stehen 'capi2text', 'listen2fritz' und 'nodaemon'. Wird dieser Parameter nicht gesetzt, so wird standardmäßig 'capi2text' verwendet. Hinweis Damit das Listen2Fritz-Programm verwendet werden kann muss sicher gestellt werden, dass zuvor der Anrufmonitor der AVM-Fritzbox aktiviert wurde. Details hierzu finden sich im Absatz [7]AVM-Fritzbox^TM -Anrufmonitor Gültige Werte: capi2text, listen2fritz, nodaemon Standardeinstellung: CAPI2TEXT_SOURCE=” CAPI2TEXT_SOURCE_HOST (optional) Optionaler Parameter: Wurde der Parameter CAPI2TEXT_SOURCE='listen2fritz' gesetzt, so kann man über diesen Parameter den Hostnamen oder die IP-Adresse der zu verwendenden Fritzbox^TM festlegen. Wird dieser Parameter nicht gesetzt, so wird eine Verbindung über den Namen `fritzbox' (Port 1012/tcp) initiiert. Gültige Werte: Hostname oder IP-Adresse Standardeinstellung: CAPI2TEXT_SOURCE_HOST=” CAPI2TEXT_WEB_ACCESS Über diesen Parameter wird der Webzugriff auf die Anrufliste aktiviert. Siehe auch den Parameter [8]CAPI2TEXT_WEB_ROOT. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_WEB_ACCESS='no' CAPI2TEXT_WEB_EDIT_SUPPORT Über diesen Parameter wird eine Bearbeitung der Anrufliste über die Weboberfläche ermöglicht. Hinweis Es gilt zu bedenken, dass sich die Möglichkeit der Dateibearbeitung durch eine Ausweitung der Dateizugriffsrechte, der über die Parameter CAPI2TEXT_LOG2FILE_FILENAME und CAPI2TEXT_LOCALCACHE_FILENAME definierten Dateien, erkauft wird! Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_WEB_EDIT_SUPPORT='no' CAPI2TEXT_WEB_RSS_ACCESS Über diesen Parameter wird der RSS-Zugriff auf die Anrufliste aktiviert. Weitere Informationen finden sich im Absatz RSS-Anrufliste. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_WEB_RSS_ACCESS='no' CAPI2TEXT_WEB_ROOT (optional) Optionaler Parameter: Über diesen Parameter wird das Dokumentenstammverzeichnis festgelegt, in welchem die Datei 'index.php' abgelegt wird. Falls der Parameter individuell gesetzt wird ist darauf zu achten, dass die Dateien in einem eigenen Unterverzeichnis abgelegt werden, welches nicht bereits anderweitig verwendet wird, da es bei einer Deinstallation oder Umkonfiguration automatisch entfernt wird. Wird dieser Parameter nicht gesetzt, so wird die Datei standardmäßig in folgendem Verzeichnis abgelegt: http:////capi2text/ Gültige Werte: absolute Pfadangabe Beispiel: CAPI2TEXT_WEB_ROOT='/var/www/htdocs/capi2text' CAPI2TEXT_WEB_MSNREPLACE_FILENAME (optional) Optionaler Parameter: Über diesen Parameter wird der Name der MSN-Ersetzungsdatei festgelegt, aus welcher der an Stelle einer MSN in der Weboberfläche anzuzeigende Text gelesen werden soll. Pro Zeile muss jeweils einer MSN ein durch ein TAB-Zeichen getrennter Text zugeordnet werden. Optional können als dritter und vierter Parameter, ebenfalls durch ein TAB-Zeichen getrennt, noch individuelle HTML-Farbkodes für vom Standard abweichende Vordergrund- und/oder Hintergrundfarben angegeben werden. Beispiel: 21Wohnzimmer 22Arbeitszimmer#0000f0yellow Um darüber hinaus bei eingehenden Anrufen von internen Rufnummern zu verhindern dass automatisch eine Vorwahl voran gestellt wird, können diese durch Einträge in folgender Notation kenntlich gemacht werden: #:11 #:225 Gültige Werte: absolute Pfadangabe Beispiel: CAPI2TEXT_WEB_MSNREPLACE_FILENAME='/public/msn-replace.txt' CAPI2TEXT_DB_TYPE (Optionaler Parameter) Über diesen Parameter kann auf Wunsch, ein vom Standard 'file' abweichender Datenbanktyp angegeben werden. Folgende Datenbanken werden unterstützt: + file Dateien (Standard) + mysql MySQL/MariaDB + sqlite SQLite3 Gültige Werte: gültiger Datenbanktyp Standardeinstellung: CAPI2TEXT_DB_TYPE=” CAPI2TEXT_DB_HOST (Optionaler Parameter) Über diesen Parameter kann bei Bedarf der FQDN-Name des Servers festgelegt werden, auf sich die Capi2Text-Datenbank befindet. Standardmäßig wird die Datenbank auf dem gleichen Server erstellt, auf welchem auch ownCloud betrieben wird. Gültige Werte: FQDN-Name eines Servers Beispiel: CAPI2TEXT_DB_HOST= 'db - server.privat.lan' CAPI2TEXT_DB_USER (Optionaler Parameter) Über diesen Parameter kann bei Bedarf ein Datenbankanwender festgelegt werden, welcher für den Zugriff auf die interne Capi2Text-Datenbank verwendet werden soll. Dies ist üblicherweise der Fall, wenn MySQL als zu verwendende Datenbank ausgewählt wurde. Gültige Werte: Name eines Datenbankanwenders Standardeinstellung: CAPI2TEXT_DB_USER=” CAPI2TEXT_DB_PASS (Optionaler Parameter) Über diesen Parameter kann bei Bedarf ein Datenbankkennwort festgelegt werden, welches für den Zugriff auf die interne Capi2Text-Datenbank verwendet werden soll. Dies ist üblicherweise der Fall, wenn MySQL als zu verwendende Datenbank ausgewählt wurde. Gültige Werte: Kennwort Standardeinstellung: CAPI2TEXT_DB_PASS=” CAPI2TEXT_LOG2FILE Um eingehende Anrufe in einer Datei zu speichern muss der Wert dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no' deaktiviert das Speichern von Anrufen. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LOG2FILE='yes' CAPI2TEXT_LOG2FILE_FILENAME Über diesen Parameter kann das Verzeichnis und der Name der Logdatei festgelegt werden in welcher eingehende Anrufe gespeichert werden sollen. Wird diese Datei auf einer Samba-Freigabe abgelegt, so kann die Datei auch mittels des Windows-Respond-Programms ausgelesen werden. Dateiformat (Beispiel): 2021-11-1111:11:0002212210223344Stadt K"olnHistorisches Rathaus, 50667 K"oln, DeutschlandIN11:11 Gültige Werte: Dateiname inkl. absoluter Pfadangabe Standardeinstellung: CAPI2TEXT_LOG2FILE_FILENAME='/public/anrufe.txt' CAPI2TEXT_LOG2FILE_ARCHIVE_KEEP Über diesen Parameter kann angegeben werden, ob Logeinträge für eine Anzahl von Tagen von der Archivierung ausgeschlossen werden sollen oder nicht. Hierdurch wird sicher gestellt, dass z.B. bei der Verwendung des Web-GUI, immer eine ausreichende Anzahl von Einträgen angezeigt werden kann. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LOG2FILE_ARCHIVE_KEEP='yes' CAPI2TEXT_LOG2FILE_ARCHIVE_KEEP_DAYS Über diesen Parameter wird die Anzahl der Tage angegeben, für die Logeinträge von der Archivierung ausgeschlossen werden sollen, um z.B. bei der Verwendung des Web-GUI, eine ausreichende Anzahl von Einträgen anzeigen zu können. Gültige Werte: Zahl Standardeinstellung: CAPI2TEXT_LOG2FILE_ARCHIVE_KEEP_DAYS='14' CAPI2TEXT_LOG2FILE_ARCHIVE_CRON Um die Anrufdatei regelmäßig zu archivieren muss der Wert dieses Parameters auf 'yes' gesetzt werden, 'no' deaktiviert die Archivierungsfunktion. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LOG2FILE_ARCHIVE_CRON='no' CAPI2TEXT_LOG2FILE_ARCHIVE_PATH Optionaler Parameter: Über diesen Parameter kann auf Wunsch ein vom Standard abweichender Archivierungspfad für die Anrufdatei angegeben werden, welche über den Parameter [9]CAPI2TEXT_LOG2FILE festgelegt wurde. Falls dieser Parameter nicht gesetzt wird, erfolgt die Speicherung im Verzeichnis der Anrufdatei. Gültige Werte: absolute Pfadangabe Beispiel: CAPI2TEXT_LOG2FILE_ARCHIVE_PATH=” CAPI2TEXT_LOG2FILE_ARCHIVE_CRON_SCHEDULE Über diesen Parameter wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall die Anrufdatei archiviert werden soll. Die fünf Teilparameter haben dabei folgende Bedeutung: 1 - Minuten, 2 - Stunden, 3 - Tag des Monats, 4 - Monat, 5 - Wochentag D.h. bei Verwendung der Standardeinstellung wird an jedem ersten Tag eines Monats um 00:01h die Archivierung durchgeführt. Wer näheres über die verwendete Befehlssyntax erfahren möchte, sollte über eine Internet-Suchmaschine nach 'man' und 'crontab' suchen. Gültige Werte: Crontab-spezifischer Parametereintrag Standardeinstellung: CAPI2TEXT_LOG2FILE_ARCHIVE_CRON_SCHEDULE='1 0 1 * *' CAPI2TEXT_LOCALCACHE Sollen die mittels einer LDAP- oder Websuche ermittelten Namen bzw. Adressen von Anrufern zur Geschwindigkeitssteigerung in einer lokalen Cache-Datei zwischengespeichert werden, so muss der Wert dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no' deaktiviert das Speichern von Anrufen. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LOCALCACHE='yes' CAPI2TEXT_LOCALCACHE_FILENAME Über diesen Parameter kann das Verzeichnis und der Name der Cache-Datei festgelegt werden in welcher Namen und Adressen von Anrufern gespeichert werden sollen. Wird diese Datei auf einer Samba-Freigabe abgelegt, so kann der Dateiinhalt bei Bedarf manuell über das Netzwerk angepasst werden. Dateiformat (Beispiel): 00492212210Stadt K"olnHistorisches Rathaus, 50667 K"oln, Deutschland Gültige Werte: Dateiname inkl. absoluter Pfadangabe Standardeinstellung: CAPI2TEXT_LOCALCACHE_FILENAME='/public/phonelist.txt' CAPI2TEXT_LOCALCACHE_MAIN_SEARCH Über diesen Parameter legt man fest, ob bei einer Suche die Telefonnummer, entsprechend dem Parameters [10]CAPI2TEXT_NUMBER_MIN_LENGTH, gekürzt werden soll um z.B. nach einer Firmenzentralnummer zu suchen. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LOCALCACHE_MAIN_SEARCH='no' CAPI2TEXT_CALL2RESPOND Um eingehende Anrufe an das Respond-Programm zu melden muss der Wert dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no' deaktiviert diese Funktion. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_CALL2RESPOND='no' CAPI2TEXT_CALL2RESPOND_UDPPORT Mittels diesen Parameters kann der UDP-Port festgelegt werden über welchen eingehende Anrufe an das Respond-Programm gemeldet werden sollen. Gültige Werte: UDP-Port Standardeinstellung: CAPI2TEXT_CALL2RESPOND_UDPPORT='5555' CAPI2TEXT_CALL2RESPOND_BROADCAST Mittels diesen Parameters kann die Broadcast-Adresse festgelegt werden über welche eingehende Anrufe in das lokale Netzwerk gemeldet werden sollen. Sollte kein Broadcast möglich sein, so sollte die Broadcast-Adresse nach folgendem Schema eingetragen werden: Bei einer Server-IP 192.168.2.1 lautet die Broadcast-Adresse 192.168.2.255 . Um einen eingehenden Anruf zu simulieren und an einen Windows-Client zu melden kann man wie folgt vorgehen: netcat -v 192.168.2.60 5555 -u Die IP-Adresse entspricht dem des gewünschten Windows-Client. netcat -v 192.168.2.60 5555 Gültige Werte: Broadcast-Adresse Standardeinstellung: CAPI2TEXT_CALL2RESPOND_BROADCAST='255.255.255.255' CAPI2TEXT_LOCALECHO Um eingehende Anrufe auf der Systemkonsole zu melden muss der Wert dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no' deaktiviert diese Funktion. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LOCALECHO='no' CAPI2TEXT_LDAP_SEARCH Um bei eingehenden Anrufen den Namen und die Adresse des Anrufers mittels Anfrage bei einem LDAP-Server zu ermitteln muss der Wert dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no' deaktiviert diese Funktion. Bei der LDAP-Suche wird nach der Telefonnummer in den Feldern 'homePhone', 'telephoneNumber', 'mobile', 'facsimileTelephoneNumber' gesucht. Die Telefonnummer muss in folgendem Format vorliegen: '+49 (211) 445566' Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LDAP_SEARCH='no' CAPI2TEXT_LDAP_HOSTURI Über dieser Parameter legt man den Namen des LDAP-Servers und den zu verwendenden TCP-Port fest. Gültige Werte: LDAP URI inkl. Port Beispiel: CAPI2TEXT_LDAP_HOSTURI='ldap://meinserver.local.lan:389' CAPI2TEXT_LDAP_BASEDN Über diesen Parameter wird die base-dn für den Zugriff auf ein LDAP-Adressbuch festgelegt. Gültige Werte: base-dn Beispiel: CAPI2TEXT_LDAP_BASEDN='ou=public,ou=Addresses,dc=local,dc=lan' CAPI2TEXT_LDAP_AUTH Falls eine Authentifikation am LDAP-Server erforderlich ist, so muss dieser Parameter lediglich auf den Wert 'yes' gestellt werden. Bei der Einstellung 'no' wird keine Authentifizierung durchgeführt. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LDAP_AUTH='no' CAPI2TEXT_LDAP_BINDDN Über diesen Parameter wird die bind-dn für die Authentifizierung am LDAP-Server festgelegt. Gültige Werte: bind-dn Beispiel: CAPI2TEXT_LDAP_BINDDN='cn=ldapadmin,dc=domain,dc=lan' CAPI2TEXT_LDAP_BINDPASS Über diesen Parameter wird das bind-Kennwort für die Authentifizierung am LDAP-Server festgelegt. Gültige Werte: Kennwort Beispiel: CAPI2TEXT_LDAP_BINDPASS='my-secret' CAPI2TEXT_LDAP_FIELD_NAME (optional) Optionaler Parameter: Über diesen Parameter können ein oder mehrere LDAP-Felder festgelegt werden, welche dem Anrufernamen zugeordnet werden sollen. Die Feldnamen müssen in geschweiften Klammern '{}' angegeben werden. Werden Feldnamen zusätzlich von '|'-Zeichen eingeschlossen, so werden diese nacheinander geprüft bis ein Ergebnis zurückgegeben wird. Standardmäßig werden folgende LDAP-Felder verwendet: '{givenName} {sn}' Beispiel: '|{cn}{o}|' Gültige Werte: zulässige LDAP-Feldnamen Standardeinstellung: CAPI2TEXT_LDAP_FIELD_NAME=” CAPI2TEXT_LDAP_FIELD_DETAILS (optional) Optionaler Parameter: Über diesen Parameter können ein oder mehrere LDAP-Felder festgelegt werden, welche dem Adressdetails eines Anrufers zugeordnet werden sollen. Die Feldnamen müssen in geschweiften Klammern '{}' angegeben werden. Werden Feldnamen zusätzlich von '|'-Zeichen eingeschlossen, so werden diese nacheinander geprüft bis ein Ergebnis zurückgegeben wird. Standardmäßig werden folgende LDAP-Felder verwendet: '{street}, {postalCode} {l}' Beispiel: '|{mozillaHomeStreet}{street}|' Gültige Werte: zulässige LDAP-Feldnamen Standardeinstellung: CAPI2TEXT_LDAP_FIELD_NAME=” CAPI2TEXT_LDAP_MAIN_SEARCH Über diesen Parameter legt man fest, ob bei einer Suche die Telefonnummer, entsprechend dem Parameters [11]CAPI2TEXT_NUMBER_MIN_LENGTH, gekürzt werden soll um z.B. nach einer Firmenzentralnummer zu suchen. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_LDAP_MAIN_SEARCH='yes' CAPI2TEXT_CARDDAV_SEARCH Um bei eingehenden Anrufen den Namen und die Adresse des Anrufers mittels einer Anfrage bei einem CardDAV-Server zu ermitteln muss der Wert dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no' deaktiviert diese Funktion. Die Telefonnummer muss in folgendem Format vorliegen: '+49 (211) 445566' Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_CARDDAV_SEARCH='no' CAPI2TEXT_CARDDAV_URL Über diesen Parameter legt man die URL fest mittels der auf den CardDAV-Server zugegriffen werden soll. Im Beispiel wird die URL für den CardDAV-Zugriff auf ein ownCloud Adressbuch des Anwenders 'frank' verwendet. Gültige Werte: URL Beispiel: CAPI2TEXT_CARDDAV_URL='https://myserver.local.lan/owncloud/remot e.php/carddav/addressbooks/frank/contacts' CAPI2TEXT_CARDDAV_CERT_NAME Über diesen Parameter legt man das Serverzertifikat des Servers fest, auf den man mittels des WebDAV-Protokoll per HTTPS zugreifen will. Gültige Werte: Serverzertifikat Beispiel: CAPI2TEXT_CARDDAV_CERT_NAME='myserver.local.lan' CAPI2TEXT_CARDDAV_AUTH Falls eine Authentifikation am CardDAV-Servers erforderlich ist, so muss dieser Parameter lediglich auf den Wert 'yes' gestellt werden. Bei der Einstellung 'no' wird keine Authentifizierung durchgeführt. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_CARDDAV_AUTH='no' CAPI2TEXT_CARDDAV_USER Über diesen Parameter wird der Anmeldename für den Zugriff auf das CardDAV-Adressbuch angegeben. Gültige Werte: Anmeldename Beispiel: CAPI2TEXT_CARDDAV_NAME='frank' CAPI2TEXT_CARDDAV_PASS Über diesen Parameter wird das Anmeldekennwort für den Zugriff auf das CardDAV-Adressbuch angegeben. Gültige Werte: Kennwort Beispiel: CAPI2TEXT_CARDDAV_PASS='geheim' CAPI2TEXT_CARDDAV_MAIN_SEARCH Über diesen Parameter legt man fest, ob bei einer Suche die Telefonnummer, entsprechend dem Parameters [12]CAPI2TEXT_NUMBER_MIN_LENGTH, gekürzt werden soll um z.B. nach einer Firmenzentralnummer zu suchen. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_CARDDAV_MAIN_SEARCH='no' CAPI2TEXT_WEB_SEARCH Um bei eingehenden Anrufen den Namen und die Adresse des Anrufers mittels Rückwärtssuche zu ermitteln muss der Wert dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no' deaktiviert diese Funktion. Aktuell wird versucht Rufnummern aus Deutschland, Liechtenstein, Österreich und der Schweiz aufzulösen. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_WEB_SEARCH='no' CAPI2TEXT_WEB_SEARCHURL (optional) Optionaler Parameter: Über diesen Parameter kann bei Bedarf eine vom Standard abweichende Such-URL angegeben werden. Durch Verwendung der folgenden Platzhalter können Informationen an diese URL übergeben werden: + {ACODE} - Ortsvorwahl + {ANAME} - Ortsnetzname + {CCODE} - Ländervorwahl + {CNAME} - Ländername + {DETAILS} - Weitere Details des Anrufers + {DIRECTION} - Anrufrichtung, IN-eingehender, OUT-ausgehender Anruf + {DURATION} - Anrufdauer in [HH:]MM:SS + {INFO} - Information über den Fundort, C-Cache, L-LDAP, W-Web, s-gekürzte Rufnummer, Beispiel: [Ws] + {INTCALLNR} - Rufnummer des Anrufers inkl. Orts- und Ländervorwahl, z.B. 0049... + {INTCALLNR+} - Rufnummer des Anrufers inkl. Orts- und Ländervorwahl, z.B. +49... + {LOCCALLNR} - lokale Rufnummer des Anrufers + {MSN} - Die angerufene MSN + {NAME} - Der Namen des Anrufers + {NATCALLNR} - Rufnummer des Anrufers inkl. Ortsvorwahl + {ORGCALLNR} - Originalrufnummer des eingehenden Anrufs + {TYPE} - Typ der Anrufnummer, 0-unbekannt, 1-international, 2-national + {SERVICE} - Dienstekennung des Anrufs, z.B. 1-Sprache, 17-Fax G2/G3 etc. Gültige Werte: URL Standardeinstellung: CAPI2TEXT_WEB_SEARCHURL=” CAPI2TEXT_WEB_MAIN_SEARCH Über diesen Parameter legt man fest, ob bei einer Suche die Telefonnummer, entsprechend dem Parameters [13]CAPI2TEXT_NUMBER_MIN_LENGTH, gekürzt werden soll um z.B. nach einer Firmenzentralnummer zu suchen. Gültige Werte: yes, no Standardeinstellung: CAPI2TEXT_WEB_MAIN_SEARCH='yes' CAPI2TEXT_CMD_N Über diesen Parameter kann die Anzahl der bei einem Anruf auszuführenden Befehle festgelegt werden. Gültige Werte: Zahl Standardeinstellung: CAPI2TEXT_CMD_N='0' CAPI2TEXT_CMD_x_ACTIVE Wird dieser Parameter auf den Wert 'yes' gesetzt, so wird der über den Parameter [14]CAPI2TEXT_CMD_x_EXEC aktiviert, 'no' deaktiviert sie. Gültige Werte: yes oder no Beispiel: CAPI2TEXT_CMD_1_ACTIVE='no' CAPI2TEXT_CMD_x_DIRECTION Über diesen Parameter legt man fest, ob der über den Parameter [15]CAPI2TEXT_CMD_x_EXEC festgelegte Befehl für eingehende, ausgehende oder ein- und ausgehende Anrufe ausgeführt werden soll. Gültige Werte: in, out oder both Standardeinstellung: CAPI2TEXT_CMD_1_DIRECTION='in' CAPI2TEXT_CMD_x_EXEC Über diesen Parameter legt man das auszuführende Programm fest, welches bei einem eingehenden Anruf ausgeführt werden soll. Siehe auch die Parameter [16]CAPI2TEXT_CMD_x_MSN und [17]CAPI2TEXT_CMD_x_CALLNR. Durch Verwendung der folgenden Platzhalter können Informationen an diesen Befehl bzw. ein Skript übergeben werden: + {ACODE} - Ortsvorwahl + {ANAME} - Ortsnetzname + {CCODE} - Ländervorwahl + {CNAME} - Ländername + {DETAILS} - Weitere Details des Anrufers + {DIRECTION} - Anrufrichtung, IN-eingehender, OUT-ausgehender Anruf + {DURATION} - Anrufdauer in [HH:]MM:SS + {INFO} - Information über den Fundort, C-Cache, L-LDAP, W-Web, s-gekürzte Rufnummer, Beispiel: [Ws] + {INTCALLNR} - Rufnummer des Anrufers inkl. Orts- und Ländervorwahl, z.B. 0049... + {INTCALLNR+} - Rufnummer des Anrufers inkl. Orts- und Ländervorwahl, z.B. +49... + {LOCCALLNR} - lokale Rufnummer des Anrufers + {MSN} - Die angerufene MSN + {NAME} - Der Namen des Anrufers + {NATCALLNR} - Rufnummer des Anrufers inkl. Ortsvorwahl + {ORGCALLNR} - Originalrufnummer des eingehenden Anrufs + {TYPE} - Typ der Anrufnummer, 0-unbekannt, 1-international, 2-national + {SERVICE} - Dienstekennung des Anrufs, z.B. 1-Sprache, 17-Fax G2/G3 etc. Gültige Werte: auszuführender Befehl Beispiel: CAPI2TEXT_CMD_1_EXEC='echo ”Hurra Nr. {ORGCALLNR} ruft mich auf MSN {MSN} an!”' Beispiel: CAPI2TEXT_CMD_1_EXEC='/tmp/meinscript.sh {ORGCALLNR} {MSN}' CAPI2TEXT_CMD_x_MSN Über diesen Parameter legt man fest beim Anruf welcher MSN der über den Parameter [18]CAPI2TEXT_CMD_x_EXEC festgelegte Befehl ausgeführt werden soll. Mehrere Einträge sind mittels Komma zu trennen. Bei Eingabe von '*' wird der Befehl unabhängig von der MSN ausgeführt. Optional können bei Verwendung von '*' auch MSN angegeben werden, bei welchen kein Befehl ausgeführt werden soll. Solchen MSN ist dann ein '!' voran zu stellen. Gültige Werte: gültige MSN oder '*' Standardeinstellung: CAPI2TEXT_CMD_1_MSN='*' CAPI2TEXT_CMD_x_CALLNR Über diesen Parameter legt man fest beim Anruf welcher Rufnummer der über den Parameter [19]CAPI2TEXT_CMD_x_EXEC festgelegte Befehl ausgeführt werden soll. Mehrere Einträge sind mittels Komma zu trennen. Bei Eingabe von '*' wird der Befehl unabhängig von der Rufnummer ausgeführt. Optional können bei Verwendung von '*' auch Rufnummern angegeben werden, bei welchen kein Befehl ausgeführt werden soll. Solchen Rufnummern ist dann ein '!' voran zu stellen. Gültige Werte: gültige Rufnummer oder '*' Standardeinstellung: CAPI2TEXT_CMD_1_CALLNR='*' CAPI2TEXT_NUMBER_MIN_LENGTH Über diesen Parameter legt man die Minimallänge, auf die eine Telefonnummer bei einer Websuche gekürzt werden darf, um nach z.B. nach einer Firmenzentralnummer zu suchen, fest. Wird dieser Parameter auf eine große Zahl, z.B. 15, gesetzt, so wird die Zentralnummernsuche praktisch abgeschaltet. Gültige Werte: Zahl Standardeinstellung: CAPI2TEXT_NUMBER_MIN_LENGTH='2' CAPI2TEXT_NUMBER_TRIMLEADING Über diesen Parameter legt man fest wie viele Ziffern vom Anfang einer Telefonnummer entfernt werden sollen. Wird dem Wert des Parameters der Buchstabe 'Z' vorangestellt, so wird nur die definierte Anzahl führender Nullen von der Rufnummer abgeschnitten. Das Setzen dieses Parameters ist normalerweise nur bei Verwendung von Telefonanlagen sinnvoll. Gültige Werte: Zahl mit optional vorangestelltem 'Z' Standardeinstellung: CAPI2TEXT_NUMBER_TRIMLEADING='0' CAPI2TEXT_NUMBER_ADDCHARS Über diesen Parameter legt man fest welche Ziffern einer Telefonnummer vorangestellt werden sollen. Gültige Werte: Zahl(en) Standardeinstellung: CAPI2TEXT_NUMBER_ADDCHARS=” Verschiedenes Dienstekennungen bei CAPI 2.0 im Euro-ISDN Bei eingehenden Anrufen wird normalerweise auch die Dienstekennung ({SERVICE}) eines Anrufs übermittelt, damit ein Programm bei Bedarf entsprechend reagieren kann. Folgende Dienstekennungen werden zur Zeit übergeben. Die in Klammern bzw. fett geschriebenen Dienstekennungen sind üblicherweise in Gebrauch: + 1 - Sprache + 2 - Daten (standard) + 3 - Daten (eingeschränkt) + 4 - Sprache 3,1kHz + 5 - Sprache 7kHz + 6 - Video + 7 - Paket Modus + 8 - Adaptive 56kbit/s + 9 - Daten und Ansagen + 16 - Sprache Digital + 17 - Fax G2/G3 + 18 - Fax G4-I + 19 - Fax G4-II/III + 20 - Telex + 21 - Telex + 22 - Telex + 23 - Videotext + 24 - X.400/E-Mail + 25 - X.200/OSI + 26 - Sprache 7kHz + 27 - Videotelefon L1 + 28 - Videotelefon L2 + 99 - Fehlerfall: unbekannte Dienstekennung AVM-Fritzbox^TM -Anrufmonitor Um Anrufe mittels des Listen2Fritz-Programms erkennen zu können, muss zuvor der Anrufmonitor der AVM-Fritzbox^TM , welcher UPnP zur Kommunikation nutzt, aktiviert werden. Mittels folgender Wahlsequenz wird die Funktion aktiviert bzw. deaktiviert: #96*5* - Anrufmonitor einschalten #96*4* - Anrufmonitor ausschalten Falls die automatische Amtsholung in der AVM-Fritzbox^TM eingeschaltet ist, muss unter Umständen *0 vorangestellt werden. Rufnummerntypen Bei eingehenden Anrufen wird normalerweise auch der Typ ({TYPE}) einer Rufnummer übermittelt, damit ein Programm bei Bedarf entsprechend reagieren kann. Folgende Typen werden zur Zeit ausgewertet bzw. übergeben: + 0 - unbekannter Rufnummerntyp + 1 - internationale Rufnummer + 2 - nationale Rufnummer Respond2-Programm Um mit dem Respond2-Programm eingehende Anrufe auf einem Windows-PC anzuzeigen müssen folgende Dinge beachtet werden: + Firewall - Falls die Windows-Firewall aktiv ist, muss eine Ausnahme konfiguriert werden welche eingehende Verbindungen, typischerweise auf Port 5555/udp, zulässt. + ISDN-Respond - Folgende Parameter müssen standardmäßig im Respond2-Programm konfiguriert werden, damit die Rufnummernanzeige korrekt erfolgt: UDP-Port für Capi2Text: 5555 Log-Datei...: \\ \Public \anrufe.txt Telefonliste: \\ \Public \phonelist.txt Abschließend muss man die Rufnummernannahme, durch einen Rechtsklick auf das in der Traybar angezeigte Icon und dem Markieren des Punktes 'Aktiv', aktivieren. KDE-/Gnome-Anzeigeprogramm Will man sich eingehende Anrufe auf einem KDE- oder Gnome-Desktop eines Linux-PC anzeigen lassen, so kann man hierzu das Skript 'capi2text-kde-udp-listen.pl' verwenden, welches im Verzeichnis /usr/share/doc/capi2text mitgeliefert wird. Das Skript kopiert man z.B. in das Verzeichnis /usr/sbin und ruft es dann als User 'root' wie folgt auf: /usr/share/doc/capi2text/capi2text-kde-udp-listen.pl & Zuvor sollte man die folgenden beiden Parameter m Skript anpassen um die Bildschirmausgabe zum gewünschten Anwender umzulenken: my $output_user = 'root'; # su-user to switch to my $output_display = ':0'; # unix display my $output_desktop = 'kde'; # desktop to use: kde or gnome RSS-Anrufliste Will man sich die eingehenden Anrufe über einen RSS-Feed anzeigen lassen, so muss man erst den Parameter CAPI2TEXT_WEB_RSS_ENABLED='yes' setzen und danach die folgende URL aufrufen: http:////capi2text/rss.php Will man darüber hinaus Anpassungen am RSS-Feed durchführen, wie z.B. die Texte anpassen, so ist hierzu kein Eingriff in die eigentliche Skriptdatei `capi2text-rss.php' nötig. Statt dessen fügt man die zu modifizierenden Parameter der Datei `capi2text-params.inc' hinzu, welche sich im gleichen Verzeichnis befindet. Liste der verfügbaren Parameter: // the following parameters could be customized using // the capi2text-params.inc file $rss_encoding = 'ISO-8859-1'; $rss_title = 'Capi2Text Anrufliste'; $rss_specific_msn = 'fuer MSN'; $rss_name = 'Name:'; $rss_address = 'Adresse:'; $rss_extension = 'Nebenstelle:'; $rss_protocol = 'http'; $rss_docs_path = 'capi2text/capi2text-rss.php'; $rss_description = 'Liste der eingegangenen Anrufe'; $rss_language = 'de-de'; $rss_generator = 'Capi2Text Feed Engine'; $rss_editor = 'webmaster@beispiel.de (Editor in Charge)'; $rss_webmaster = 'webmaster@beispiel.de'; $rss_call_from = 'Anruf von'; $rss_no_msn = false; $rss_no_loginfo = false; $rss_filter_msn = 'all'; $rss_ttl = 5; $rss_skip_days = ”; $rss_skip_hours = '0 1 2 3 4 5'; Web-Anrufliste Will man sich die eingehenden Anrufe über eine Weboberfläche anzeigen lassen, so muss man erst den Parameter CAPI2TEXT_WEB_ACCESS='yes' setzen und danach die folgende URL aufrufen: http:////capi2text/ Wurde darüber hinaus auch noch der Parameter CAPI2TEXT_WEB_EDIT_SUPPORT='yes' gesetzt, so ist es möglich Anruferdetails manuell einzufügen, falls automatisch keine Daten ermittelt werden konnten (Kein Eintrag). In diesem Fall wird hinter dem zu bearbeitenden Eintrag ein Stiftsymbol angezeigt über welches der Bearbeitungsdialog gestartet werden kann. In der Webanzeige kann man auf Wunsch auch die Herkunft eines Anrufes durch eine Flaggen kenntlich gemacht werden. Da die benötigten Flaggenbilder aus Copyright-Gründen nicht im Paket enthalten sind, muss diese zuvor jedoch einmal über den Menüpunkt 'Download flag icons for Web-GUI' herunterladen. Kann die Herkunft eines Anrufes nicht festgestellt werden, so wird stellvertretend für die Flagge ein Fragezeichen angezeigt. Will man darüber hinaus Anpassungen am Web-GUI durchführen, wie z.B. die Schriftart oder Schriftgröße anpassen, so ist hierzu kein Eingriff in die eigentliche Skriptdatei `capi2text-index.php' nötig. Statt dessen fügt man die zu modifizierenden Parameter der Datei `capi2text-params.inc' hinzu, welche sich im gleichen Verzeichnis befindet. Liste der verfügbaren Parameter: // the following parameters could be customized using // the capi2text-params.inc file $capi2text_title = 'Capi2Text-Anrufliste'; $call_date = 'Datum/Uhrzeit'; $call_country = 'Land'; $call_from = 'Von'; $call_to = 'An'; $call_name = 'Anrufer'; $call_unknown = 'unbekannt'; $selection = 'Auswahl'; $selection_msn = 'MSN'; $selection_msn_all = '- alle MSN -'; $last_seven_days = 'letzten 7 Tage'; $last_fourteen_days = 'letzten 14 Tage'; $curr_month = 'letzten 30 Tage'; $all_data_prefix = 'alle'; $all_data_suffix = 'Daten'; $date_format = 'd.m.Y'; $default_filterdays = [1|7|14|30|9999]; $no_loginfo = false; $font_face = 'arial, verdana'; $font_size = '12pt'; $color_body_background = 'white'; $color_body_front = 'black'; $color_th_background = '#dcdcdc'; $color_th_front = 'black'; $color_tr_background1 = 'white'; $color_tr_background2 = '#f0f8ff'; $color_tr_front = 'black'; $capi2text_edit_title = 'Capi2Text: Phonelist-Eintrag bearbeiten'; $frm_name = 'Name'; $frm_street = 'Straße'; $frm_street_nbr = 'Nr.'; $frm_zip = 'PLZ'; $frm_city = 'Ort'; $frm_country = 'Land'; $btn_abort = 'Abbrechen'; $btn_save = 'Speichern'; $enter_name = "Bitte einen 'Namen' eintragen"; $enter_street = "Bitte eine 'Straße' eintragen"; $enter_zip = "Bitte die 'Postleitzahl' eintragen"; $enter_city = "Bitte einen 'Ort' eintragen"; $enter_country = "Bitte ein 'Landeskürzel' eintragen"; $input_for_nbr = 'Eintrag für'; $server_error = "Der Server meldet einen Fehler"; $missing_number = 'Keine Rufnummer gefunden.'; $program_error = 'fehlende Rufnummer -> falscher Programmaufruf'; $save_successful = 'Die Daten wurden erfolgreich gespeichert. Das Eingabefenster wird jetzt geschlossen.'; $comms_error = 'Ihr Browser kann keine direkte Kommunikation mit dem Webserver aufbauen (AJaX) oder die Funktion (ActiveX) wurde explizit abgeschaltet.'; Beispieleintrag: // meine persoenlichen Anpassungen $font_face = 'verdana, arial'; $font_size = '10pt';