Entwicklungssupport - Schnittstellen
AVM Inhalt
Herzlich willkommen auf unserer Informationseite zu Schnittstellen und Protokollen rund um FRITZ!Box.
Wir freuen uns sehr über Ihr Interesse an einer möglichen Produktentwicklung im Umfeld der FRITZ!Box-Produktfamilie. Zu diesem Thema sind Projekte mit verschiedenen Ansätzen und unterschiedlicher technischer Expertise im Markt aktiv, zu denen AVM grundsätzlich immer eine neutrale Position einnimmt.
Die FRITZ!Box-Linie bietet in der aktuellen Ausprägung bereits Unterstützung für Entwicklungsvorhaben von unabhängigen Anbietern. Genutzt werden offene bzw. standardisierte Schnittstellen, die AVM im Rahmen der Systemarchitektur der FRITZ!Box unterstützt.
Darüber hinaus bietet AVM auf diesen Seiten für ausgewählte Realisierungsansätze eine erweiterte Unterstützung als Download an. Hier finden Sie die aktuelle Zusammenstellung von Informationen und Links.
Wichtige Information: Änderung des Anmeldeverfahrens an einer FRITZ!Box
Ab FRITZ!OS 7.25 kommt es bei der Anmeldung mit dem FRITZ!Box-Kennwort zu einer Änderung, die von Entwicklern für FRITZ!Box berücksichtigt werden muss. Die Änderung ist außerdem Bestandteil der Laborversion FRITZ!OS 7.24.
Das folgende Dokument beschreibt die Änderungen und gibt Empfehlungen zur Benutzerführung bei der Anmeldung an einer FRITZ!Box. Das Dokument richtet sich an Entwickler, die Drittanwendungen für die FRITZ!Box programmieren. Aus Usability-Gesichtspunkten wird Entwicklern von Drittanwendungen stark empfohlen, die Benutzerführung und die Begriffe an das für den Anwender gewohnte Verhalten der FRITZ!Box-Oberfläche
anzugleichen.
Empfehlungen zur Benutzerführung bei der Anmeldung an einer FRITZ!Box_v1.1.pdf
Important: Change to FRITZ!Box login process
Starting with FRITZ!OS 7.25, there is a change when logging in with the FRITZ!Box password, which app developers will need to take into account. The change is also part of the FRITZ!OS 7.24 Lab version.
The document below describes the changes and provides recommendations for user guidance for logging into a FRITZ!Box. The document is intended for developers who program third-party applications for FRITZ!Box. From a usability point of view, developers of third-party applications are strongly recommended to adapt their user interface and terms to the behavior of the FRITZ!Box interface, which is familiar to the user.
Recommendations for user guidance for logging in to a FRITZ!Box_v1.1_EN.pdf
Apps / TR-064
TR-064 ist ein vom DSL-Forum entwickeltes Protokoll, um DSL-Internetzugangsgeräte aus dem lokalen Netz zu konfigurieren. Es basiert auf dem UPnP-Standard (Universal Plug and Play), der allgemein zur herstellerübergreifenden Ansteuerung von Geräten in IP-basierten Netzwerken dient. Die bei UPnP und somit auch bei TR-064 zum Einsatz kommenden Multicast-Adressen stammen aus einem Adressbereich, der nicht geroutet wird. Ein Zugriff auf die FRITZ!Box mit TR-064 ist daher nur aus dem eigenen lokalen Netzwerk möglich.
Generell wird für die Kommunikation ein Software-Client benötigt, der TR-064 unterstützt. Dieser kann beispielsweise vom Internetanbieter auf einer CD mitgeliefert werden. Über diesen Client können Statusabfragen der FRITZ!Box erfolgen sowie manuell oder über eine Konfigurationsdatei bestimmte Parameter der FRITZ!Box gesetzt werden, beispielsweise die Zugangsdaten für die Internetverbindung.
Einen Überblick über die angebotenen Funktionen finden Sie hier: AVM Technical Note - Konfiguration über TR-064.pdf
Dieses Dokument liefert eine Übersicht über die ersten Schritte bei der Umsetzung eines Entwicklungsvorhabens: AVM TR-064 first_steps.pdf (Stand 20.01.2021)
Dieses Dokument listet die von AVM unterstützten Dokumente zum TR-064-Protokoll auf: AVM_TR-064_overview.pdf
Alle Erweiterungen für die FRITZ!Box beziehen sich auf den TR-064 Standard: http://www.broadband-forum.org/technical/trlist.php
Bereich | Service | Beschreibung | Datum | Download |
WAN | ||||
WANIPConnection | WAN Konfiguration, TR-064-Service im Verbindungsmodus IP (zB. Cable, IP-Client)) Verbindungsstatus, Auf- und Abbau der Internetverbindung, Internetzugangsdaten, Portfreigaben, externe IP-Adresse, DNS Server | 09.04.19 | ||
WANPPPConnection | WAN Konfiguration, TR-064-Service im Verbindungsmodus PPPoE (z.B. DSL) Verbindungsstatus, Auf- und Abbau der Internetverbindung, Internetzugangsdaten, Portfreigaben, externe IP-Adresse, DNS Server | 09.04.19 | ||
WANCommonInterfaceConfig | WAN-Statistiken, Online Monitor, physikalischer WAN Zugangstyp und Status | 05.09.18 | ||
WANEthernetLinkConfig | Ethernet-Linkstatus | 15.07.09 | ||
WANDSLInterfaceConfig | DSL-Informationen (CRC, Datenraten, SNR, ...), DSL-Diagnose (zB. Detektion von Kabelbrüchen) | 01.11.19 | ||
WANDSLLinkConfig | VCC-Einstellungen, ATM-Statistiken | 20.11.15 | ||
X_AVM-DE_Speedtest | Datendurchsatzmessungen | 06.02.15 | ||
X_AVM-DE_RemoteAccess | Dynamic DNS, Fernwartung | 22.11.17 | ||
15.08.18 | ||||
X_AVM-DE_MyFritz | Fernzugang, MyFritz, Dynamic DNS | 16.05.17 | ||
X_AVM-DE_HostFilter | Kindersicherung, Internetsperre | 01.04.20 | ||
Layer3Forwarding | IP Netzwerkrouten, WAN Verbindungstyp | 15.07.09 | ||
Telefonie | ||||
X_AVM-DE_OnTel | Telefonbuch, Online-Telefonbuch, Anrufliste, Rufsperren, Rufweiterleitung | 09.02.21 | ||
X_AVM-DE_TAM | Anrufbeantworter, Anrufliste | 15.06.19 | ||
X_VoIP | Einrichtung Internettelefonie-Anbieter, Einrichtung LAN/IP-Telefon, Wählhilfe, SIP-Nebenstellen | 14.08.19 | ||
Heimnetz | ||||
LanDeviceHosts | Heimnetzgeräte, Wake-on-LAN, FRITZ!Mesh | 01.12.20 | ||
WLANConfiguration | WLAN Konfiguration und Statistik, WLAN Netzwerkgeräte | 02.11.20 | ||
LANHostConfigManagement | Netzwerkeinstellungen, DHCP-Server, IP-Adressbereiche, Subnetzmaske | 20.11.17 | ||
LANEthernetInterfaceConfig | LAN-Schnittstelle und Statistiken (Paketzähler) | 15.07.09 | ||
X_AVM-DE_Dect | DECT-Geräte | 02.06.17 | ||
X_HomeAuto | SmartHome-Geräte | 25.09.18 | ||
X_HomePlug | Powerline-Geräte | 06.01.17 | ||
Speicher/NAS | ||||
X_AVM-DE_Storage | Einstellungen für SMB, FTP | 21.02.19 | ||
X_AVM-DE_UPnP | UPnP AV Mediaserver | 22.09.09 | ||
Einrichtung Online-Speicher/WebDAV | 18.09.09 | |||
X_AVM-DE_Filelinks | Dateifreigaben | 07.07.16 | ||
System | ||||
DeviceInfo | Produktinformation, Ereignisse, TR-069 Provisioning Code, Security Port für TR-064 | 15.07.09 | ||
DeviceConfig | Einstellungen sichern/wiederherstellen, Werkseinstellungen, Neustart, SID Generierung | 20.01.21 | ||
LANConfigSecurity | Benutzerlisten und FRITZ!Box Kennwort | 17.02.20 | ||
X_AVM-DE_AppSetup | Verwalten von Apps (VPN, Messagefilter, Rechte, Remotezugriff) | 03.09.20 | ||
ManagementService | TR-069-Konfiguration | 23.01.13 | ||
X_AVM-DE_Auth | 2-Faktor-Authentisierung | 06.10.17 | ||
Time | Zeitserver (NTP) | 15.07.09 | ||
UserInterface | Firmwareinformationen und Update, Spracheinstellungen | 15.01.19 | ||
Informationen über UPnP abrufbar | ||||
Internet Gateway Device Spec v1.0 | Das Endgerät stellt über UPnP Informationen zur WAN-Verbindung bereit die ohne Authentisierung abgefragt werden können. | 18.08.18 | ||
Internet Gateway Device Spec v2.0 | 18.08.18 |
SIP
Die Übertragung der relevanten QoS-Parameter erfolgt mittels X-RTP-Stat Header Information in der SIP-BYE Message. In diesem Dokument sind die erforderlichen Details zusammengefasst.
Format of the Transmission of QoS-Parameters via SIP-Bye-Message - xrtpv32.pdf
PPP
Einstellungen, die ein Provider nutzen kann, um die QoS-Parameter (Quality of Service) für eine FRITZ!Box optimal zu konfigurieren.
HTTP
Session ID
Die Verwendung von Session-IDs bietet einen wirksamen Schutz vor sogenannten Cross-Site Request Forgery-Angriffen, bei denen ein Angreifer unberechtigt Daten in einer Webanwendung verändert. Das folgende Dokument beschäftigt sich mit der Verwendung von Session-IDs und richtet sich an Entwickler, die Tools für die FRITZ!Box programmieren.
AHA-HTTP-Interface
Die Dokumentation der HTTP-Schnittstelle zur Ansteuerung von AVM-Produkten zur Hausautomation (z.B. FRITZ!DECT 200 und FRITZ!Powerline 546E) ermöglicht die Steuerung dieser Produkte durch eine externe Applikation. Die Geräte müssen dazu im Heimnetz der FRITZ!Box vorhanden und über die Benutzeroberfläche schaltbar sein. Um alle Funktionen der Schnittstelle nutzen zu können, ist der Einsatz von FRITZ!OS 5.59 (oder neuer) erforderlich.
Nr. | Datum | Beschreibung | Download |
| Session ID | ||
1 | 14.12.20 | Deutsch | |
2 | 03.02.21 | Englisch | |
AHA-HTTP-Interface | |||
1 | 20.09.20 | Version 1.36 |
IPv6
IPv6-Unterstützung in der FRITZ!Box
Hinweise zu den auf dieser Seite zur Verfügung gestellten Dokumenten nehmen wir gerne unter Entwicklungssupport@avm.de auf. Wir wünschen Ihnen viel Erfolg bei der Umsetzung.
Falls Sie uns über diese Adresse anschreiben, bitten wir darum, Ihre Geräte vorher auf einen aktuellen Firmwarestand zu bringen und die unter http://fritz.box/support.lua erzeugte Datei im Anhang mitzusenden.
Hinweise zu Marken- und Urheberrechten
Bitte beachten Sie im Vorfeld einer eigenen Entwicklung auch die Marken- und Urheberrechte von AVM. Wir möchten an dieser Stelle empfehlen, den Aussagen des Markenrechts zu folgen und eine eigenständige Produktbezeichnung zu wählen, mit der beispielsweise "AVM" oder "FRITZ!" / "F!" nicht als Hersteller, Partner, Förderer o. ä. im Rahmen einer solchen Entwicklung/Anwendung angesehen werden können. Sichergestellt sein muss ferner, dass keine negativen Auswirkungen auf AVM, AVM-Produkte und -Dienstleistungen oder AVM-Marken erfolgen (z.B. Rufschädigungen). Weiterhin sind die Verwendung von grafischen Elementen, wie AVM-Logo, FRITZ!-Logo und F!-Logo , sowie die Übernahme von grafischen Elementen aus AVM-Produkten, wie der FRITZ!Box-Benutzeroberfläche, ausgeschlossen. In der konkreten Umsetzung betrifft dies unter Anderem sowohl die Verwendung von FRITZ!-Logos als auch die Nennung unserer Marken, insbesondere "FRITZ!" / "F!" oder "FRITZ!Box", im Produktnamen einer Produktentwicklung durch einen anderen Inverkehrbringer als AVM. Als reine Angabe über bestimmte Merkmale oder Eigenschaften kann die Nutzung vergleichbarer Zeichen im Einzelfall und in bestimmtem Umfang zulässig sein. Auch ein Hinweis auf die Eignung des neu entwickelten Produkts (Beispiel: "Produktnamen-der-Muster-App, Adressverwaltung für FRITZ!Box") in einer Unterzeile oder einem Fließtext ist im Einzelfall und in bestimmtem Umfang zulässig.
Haftungs- und Gewährleistungsausschluss
Für alle genannten Funktionen sowie die Richtigkeit der zugehörigen Dokumentation wird von AVM keine Haftung oder Gewährleistung übernommen. AVM behält sich vor, jederzeit und ohne vorherige Ankündigung Funktionen ganz oder teilweise zu ändern oder entfallen lassen zu können.
Deutschland
International (English)
Österreich
Nederland
España
Italia
Polska
België (Nederlands)
Luxemburg (Deutsch)
Schweiz (Deutsch)