Cisco-Telefon an Asterisk anschließen: DHCP, TFTP und SEP-Datei

Gebrauchte Cisco-Tischtelefone (z. B. CP-7841, CP-8841) gibt es günstig. Mit der SIP-Firmware lassen sie sich auch ohne Cisco-Telefonanlage an Asterisk betreiben. Anders als ein Softphone tippt man dabei aber keine Zugangsdaten ins Telefon. Das Telefon holt sich seine komplette Konfiguration beim Start selbst aus dem Netz. Dieser Beitrag zeigt den Ablauf und die typischen Stolpersteine.

Was beim Einschalten passiert

1. Strom per PoE              Telefon startet
2. DHCP                       IP-Adresse + Option 150 = Adresse des TFTP-Servers
3. TFTP                       ITLSEP<MAC>.tlv, CTLSEP<MAC>.tlv (Vertrauensdateien, optional)
                              SEP<MAC>.cnf.xml           (Konfiguration dieses Telefons)
                              dialplan.xml               (Wählvorlage)
4. SIP REGISTER               Anmeldung bei Asterisk mit Nebenstelle und Passwort
BausteinWo
PoE-Port im richtigen VLANSwitch
DHCP-Option 150 (TFTP-Server)DHCP-Server
TFTP-Server mit SEP<MAC>.cnf.xmlz. B. auf der Asterisk-Maschine
Nebenstelle (Endpoint, AOR, Auth)pjsip.conf

Schritt 1: Nebenstelle in Asterisk anlegen

; /etc/asterisk/pjsip.conf  (Vorlagen siehe Beitrag "Asterisk einrichten")
[204](telefon)
auth=204-auth
aors=204
callerid=Arbeitsplatz <204>
[204-auth]
type=auth
auth_type=userpass
username=204
password=HIER_LANGES_ZUFALLSPASSWORT
[204](aor-vorlage)
openssl rand -hex 16                       # Passwort erzeugen
asterisk -rx "module reload res_pjsip.so"
asterisk -rx "pjsip show endpoint 204"     # Status: Unavailable, bis das Telefon sich meldet

Schritt 2: TFTP-Server

apt install tftpd-hpa
# /etc/default/tftpd-hpa:  TFTP_DIRECTORY="/srv/tftp"
systemctl restart tftpd-hpa
journalctl -u tftpd-hpa -f                 # zeigt jede Anfrage: "RRQ from 192.0.2.24 filename ..."

TFTP kennt weder Benutzer noch Passwort. Jeder im Netz kann jede Datei abrufen, deren Namen er kennt. Deshalb gehört der Server nur ins interne Telefonnetz.

Schritt 3: DHCP-Option 150

Option 150 ist eine Cisco-Option und enthält die IP-Adresse des TFTP-Servers, nicht die des DHCP-Servers oder des Gateways.

DHCP-ServerEinstellung
Windows ServerIPv4 → Vordefinierte Optionen → Hinzufügen: Code 150, Typ IP-Adresse, Array. Danach im Bereich, in der Richtlinie oder in der Reservierung aktivieren.
Kea / ISC DHCPEigene Option mit Code 150, Typ ipv4-address, im Subnetz des Telefonnetzes
OPNsenseDHCP-Dienst → Zusätzliche Optionen → Nummer 150, Typ IP-Adresse

Ob die Option ankommt, zeigt das TFTP-Log. Fragt das Telefon nach dem Einstecken nach SEP<MAC>.cnf.xml, stimmt alles bis hierhin. Ganz nebenbei verrät diese Anfrage auch die MAC-Adresse.

Schritt 4: SEP-Datei erstellen

Der Dateiname ist SEP plus die MAC-Adresse in Großbuchstaben ohne Trennzeichen, z. B. SEP001122AABBCC.cnf.xml. Eine bewährte Minimalfassung:

<?xml version="1.0" encoding="UTF-8"?>
<device>
  <deviceProtocol>SIP</deviceProtocol>
  <devicePool>
    <dateTimeSetting>
      <dateTemplate>D.M.Y</dateTemplate>
      <timeZone>W. Europe Standard/Daylight Time</timeZone>
      <ntps><ntp><name>192.0.2.1</name><ntpMode>Unicast</ntpMode></ntp></ntps>
    </dateTimeSetting>
    <callManagerGroup><members><member priority="0"><callManager>
      <processNodeName>192.0.2.10</processNodeName>
      <ports><sipPort>5060</sipPort></ports>
    </callManager></member></members></callManagerGroup>
  </devicePool>
  <sipProfile>
    <sipProxies><registerWithProxy>true</registerWithProxy></sipProxies>
    <preferredCodec>g711alaw</preferredCodec>
    <phoneLabel>Arbeitsplatz 204</phoneLabel>
    <sipLines>
      <line button="1">
        <featureID>9</featureID>
        <featureLabel>204</featureLabel>
        <proxy>USECALLMANAGER</proxy>
        <port>5060</port>
        <name>204</name>
        <displayName>Arbeitsplatz</displayName>
        <authName>204</authName>
        <authPassword>HIER_DAS_PASSWORT_VON_204</authPassword>
        <messagesNumber>*97</messagesNumber>
      </line>
    </sipLines>
    <dialTemplate>dialplan.xml</dialTemplate>
  </sipProfile>
  <vendorConfig>
    <webAccess>0</webAccess>
    <settingsAccess>1</settingsAccess>
  </vendorConfig>
</device>

Dazu eine Wählvorlage dialplan.xml, die nach 5 Sekunden ohne Eingabe wählt:

<DIALTEMPLATE>
  <TEMPLATE MATCH="*" Timeout="5"/>
</DIALTEMPLATE>
xmllint --noout /srv/tftp/SEP001122AABBCC.cnf.xml && echo "XML gueltig"
chown root:tftp /srv/tftp/*.xml
chmod 644 /srv/tftp/*.xml

Weitere Telefone entstehen am einfachsten, indem man eine funktionierende SEP-Datei kopiert und nur Nebenstelle, Beschriftung und Passwort ändert.

Schritt 5: Neu starten und prüfen

asterisk -rx "pjsip show contacts"
#  Contact:  204/sip:204@192.0.2.24:5060   Avail   12.3

Im SIP-Mitschnitt (pjsip set logger on) sieht man die Anmeldung: REGISTER → 401 Unauthorized → REGISTER mit Zugangsdaten → 200 OK. Das erste 401 ist kein Fehler, so funktioniert die Digest-Anmeldung.

Stolpersteine

SymptomUrsacheLösung
Keine TFTP-Anfrage im LogKein Strom (Port ohne PoE), falsches VLAN oder Option 150 fehltAm Telefon unter Einstellungen → Netzwerk die IP und den TFTP-Server prüfen
Telefon fragt nur nach .sgn-DateienVertrauensliste (ITL/CTL) einer früheren Cisco-Anlage ist noch gespeichert, das Telefon akzeptiert nur signierte DateienAm Telefon unter Admin-Einstellungen die Sicherheitskonfiguration bzw. Vertrauensliste löschen, notfalls Werksreset
„Error Verifying Config Info“XML ist gültig, enthält aber Elemente, die die Firmware nicht kenntAuf die Minimalfassung oben reduzieren, Erweiterungen einzeln testen
Hängt bei „Registrierung wird ausgeführt“Passwort in SEP-Datei und pjsip.conf verschieden, oder falsche Server-IPpjsip set logger on: dauerhaft 401 bedeutet falsches Passwort
Fehlversuche, danach ist die Anlage gar nicht mehr erreichbarfail2ban hat die IP gesperrtfail2ban-client status, IP mit unbanip freigeben

Das SIP-Passwort steht im Klartext in der SEP-Datei, und die kann jeder im Netz per TFTP abrufen. Deshalb: Telefone in ein eigenes Voice-VLAN, TFTP nur dort erreichbar, Webzugang am Telefon aus (webAccess 0) und je Telefon ein eigenes, langes Passwort. Die SEP-Dateien gehören nicht in eine öffentliche Dokumentation oder ein öffentliches Repository.

Strom, VLAN, Option 150, SEP-Datei, Anmeldung: Das TFTP-Log und pjsip show contacts zeigen in dieser Reihenfolge, bis wohin das Telefon gekommen ist.