Cisco-IP-Telefone an Asterisk: ein zentrales Telefonbuch per XML

Cisco-Tischtelefone wie das CP-7841 lassen sich mit SIP-Firmware auch ohne Cisco-Telefonanlage (CUCM) an Asterisk betreiben. Telefonieren klappt dann schnell, aber die Taste „Kontakte“ bleibt leer. Normalerweise liefert die Cisco-Anlage das Firmenverzeichnis. Ohne sie baut man es selbst: zwei kleine XML-Dateien auf einem Webserver und eine Zeile in der Konfiguration des Telefons.

Asterisk ist dafür gar nicht beteiligt. Das Telefon holt das Verzeichnis per HTTP und wählt danach ganz normal über SIP.

Aufbau

Taste "Kontakte"
  └─ HTTP ─> verzeichnis.xml   (CiscoIPPhoneMenu: Liste der Verzeichnisse)
               └─ "Firmen-Telefonbuch"
                    └─ HTTP ─> telefonbuch.xml   (CiscoIPPhoneDirectory: Kontakte)
                                 └─ Anruf ── SIP ──> Asterisk
DateiAufgabe
SEP<MAC>.cnf.xmlKonfiguration des Telefons, lädt es beim Start per TFTP. Enthält die Adresse des Verzeichnis-Menüs.
verzeichnis.xmlMenü, das nach dem Drücken von „Kontakte“ erscheint
telefonbuch.xmlDie eigentlichen Einträge mit Name und Nummer

Im Beispiel läuft der Webserver auf der Telefonanlage selbst (192.0.2.10). Jeder andere Webserver im Netz geht genauso.

Schritt 1: Telefonbuch anlegen

apt install apache2 libxml2-utils
mkdir -p /var/www/html/cisco
nano /var/www/html/cisco/telefonbuch.xml
<CiscoIPPhoneDirectory>
  <Title>Firmen-Telefonbuch</Title>
  <Prompt>Kontakt auswaehlen</Prompt>
  <DirectoryEntry>
    <Name>Empfang</Name>
    <Telephone>100</Telephone>
  </DirectoryEntry>
  <DirectoryEntry>
    <Name>IT-Support</Name>
    <Telephone>200</Telephone>
  </DirectoryEntry>
</CiscoIPPhoneDirectory>
  • Höchstens 32 Einträge pro Datei. Diese Grenze schreibt Cisco für das Objekt vor.
  • Umlaute vermeiden („Buero“ statt „Büro“), denn nicht jede Firmware zeigt sie richtig an.
  • Keine XML-Kopfzeile <?xml …?>. Manche Telefone lehnen die Datei damit ab.

Schritt 2: Verzeichnis-Menü davorschalten

Der naheliegende Weg ist, die Telefonbuch-Datei direkt einzutragen. Der funktioniert nicht: Hinter „Kontakte“ erwartet die Firmware ein Menü mit den verfügbaren Verzeichnissen, so wie es eine Cisco-Anlage liefert.

<CiscoIPPhoneMenu>
  <Title>Verzeichnisse</Title>
  <Prompt>Verzeichnis auswaehlen</Prompt>
  <MenuItem>
    <Name>Firmen-Telefonbuch</Name>
    <URL>http://192.0.2.10/cisco/telefonbuch.xml</URL>
  </MenuItem>
</CiscoIPPhoneMenu>

Gespeichert als /var/www/html/cisco/verzeichnis.xml. Weitere Verzeichnisse, etwa „Lieferanten“ oder „Notfall“, sind einfach zusätzliche <MenuItem>-Blöcke.

chmod 644 /var/www/html/cisco/*.xml
xmllint --noout /var/www/html/cisco/*.xml && echo "XML gueltig"

Schritt 3: Webserver auf text/xml stellen

Apache liefert .xml-Dateien als application/xml aus. Cisco-Telefone erwarten text/xml. Bei anderem Inhaltstyp holen sie die Datei zwar, zeigen aber nichts an.

# /etc/apache2/conf-available/cisco-telefonbuch.conf
<Directory /var/www/html/cisco>
    <FilesMatch "\.xml$">
        ForceType "text/xml; charset=utf-8"
    </FilesMatch>
</Directory>
a2enconf cisco-telefonbuch
apache2ctl configtest
systemctl reload apache2
curl -I http://192.0.2.10/cisco/verzeichnis.xml    # Content-Type: text/xml

Schritt 4: Adresse in die Telefon-Konfiguration eintragen

Das Telefon lädt beim Start seine Datei SEP<MAC>.cnf.xml vom TFTP-Server (DHCP-Option 150). Dort kommt eine Zeile hinzu, und zwar direkt unter <device>:

  <vendorConfig>
    <webAccess>0</webAccess>
    <settingsAccess>1</settingsAccess>
  </vendorConfig>
  <directoryURL>http://192.0.2.10/cisco/verzeichnis.xml</directoryURL>
</device>

Nicht in <vendorConfig>! Dort ignoriert das Telefon die Zeile ohne Fehlermeldung. Es startet normal, fragt das Telefonbuch aber nie ab. Vor jeder Änderung eine Sicherungskopie der SEP-Datei anlegen und mit xmllint --noout prüfen.

Danach das Telefon neu starten. Bei PoE-Telefonen reicht es, das Netzwerkkabel kurz zu ziehen. Die directoryURL liest das Telefon nur beim Start, das Telefonbuch dagegen bei jedem Öffnen neu. Neue Kontakte brauchen also keinen Neustart.

Fehlersuche

Das wichtigste Werkzeug ist das Zugriffsprotokoll des Webservers. Es zeigt, ob und was das Telefon abruft:

tail -f /var/log/apache2/access.log | grep cisco
# 192.0.2.21 - - "GET /cisco/verzeichnis.xml?locale=English_United_States&name=SEP001122AABBCC HTTP/1.1" 200 ...
SymptomUrsacheLösung
Kein Eintrag im LogdirectoryURL fehlt, steht in <vendorConfig>, oder das Telefon wurde nicht neu gestartetZeile direkt unter <device> setzen, neu starten
Abruf mit 200, Telefon hängt bei „Requesting“Inhaltstyp application/xml, oder die Adresse zeigt direkt auf das Telefonbuch statt auf ein MenüSchritt 2 und 3
Abruf mit 404Tippfehler in Pfad oder DateinameMit curl testen
„Error Verifying Config Info“ nach dem NeustartSEP-Datei enthält ein Element, das die Firmware nicht kenntSicherung zurückspielen, Änderung einzeln testen

Den angehängten Teil ?locale=…&name=SEP… fügt das Telefon selbst hinzu. Bei statischen Dateien ignoriert Apache ihn. Mit einem kleinen PHP-Skript ließe sich darüber sogar für jedes Telefon ein eigenes Verzeichnis ausliefern.

Grenzen

  • Nur intern: Das Verzeichnis läuft über unverschlüsseltes HTTP. Den Webserver nicht ins Internet stellen und keine vertraulichen Daten (private Handynummern) ohne Freigabe eintragen.
  • Keine Suche: Ein statisches Verzeichnis zeigt nur eine Liste. Für die Suche nach Namen bräuchte es ein Skript, das CiscoIPPhoneInput auswertet.
  • Firmware-Unterschiede: Ohne Cisco-Anlage ist nicht jedes Element dokumentiert. Neue Einstellungen erst an einem Telefon testen und dann verteilen.

Drei Stellen müssen stimmen: die Zeile unter <device>, der Inhaltstyp text/xml und ein Menü vor dem Telefonbuch. Das Zugriffsprotokoll des Webservers zeigt, an welcher es hakt.