FRITZ!Box-Router stellen im lokalen Netzwerk eine TR-064-Schnittstelle bereit. Über das auf UPnP basierende Protokoll können Programme Statusinformationen abfragen und ausgewählte Funktionen automatisieren. AVM dokumentiert die unterstützten Schnittstellen und Dienste in einer eigenen Übersicht.
TR-064 arbeitet nur im lokalen Netz
TR-064 ist für den Zugriff aus dem eigenen Netzwerk vorgesehen. Ein Client spricht die SOAP-Dienste der FRITZ!Box an und übermittelt dazu authentifizierte Anfragen. AVM weist darauf hin, dass die Schnittstelle nicht als frei erreichbarer Internetdienst gedacht ist. Benutzerkonto und Kennwort der FRITZ!Box bleiben deshalb Bestandteil jeder Anwendung.
Die offiziellen Dokumente führen Dienste für Geräteinformationen, Internetverbindung, WLAN, Telefonie und weitere Funktionen auf. Für eine eigene Automatisierung werden zunächst die Dienstbeschreibung, die erlaubten SOAP-Aktionen und die Antwortstruktur benötigt. Die TR-064-Erste-Schritte-Dokumentation von AVM beschreibt den grundlegenden Aufbau.
Automatisierung mit Bash und anderen Clients
Bash-Skripte können XML-Anfragen mit Werkzeugen wie curl und xmllint an die lokalen Endpunkte senden. Für wiederkehrende Aufgaben wie das Auslesen von Leitungswerten oder das Erkennen eines Geräts im Heimnetz sollten Antworten geprüft und Zugangsdaten nicht direkt im Skript abgelegt werden. Ein praktischer Anwendungsfall ist Wake-on-LAN: Die MAC-Adresse eines Rechners kann ermittelt und anschließend zum Aufwecken genutzt werden.
Vor Änderungen an Routerdiensten empfiehlt AVM eine aktuelle FRITZ!OS-Version und eine eingeschränkte Berechtigung des verwendeten Kontos. Die Schnittstelle eignet sich damit für kontrollierte Netzwerkautomatisierung, nicht für ungeprüfte Fernzugriffe.