Entwicklungssupport - Schnittstellen

Entwicklungssupport

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 dem kommenden Release 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 wird absehbar Ende 2020 wirksam und vorab im FRITZ!Labor in der Version 7.24 bereit gestellt werden.

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

With the upcoming release of FRITZ!OS 7.25, there will be a change when logging in with the FRITZ!Box password, which developers for FRITZ!Box will need to take into account. The change is expected to take effect at the end of 2020, as well in version 7.24, available in advance in the FRITZ! Lab.

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 27.02.2020)

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

wanipconnSCPD.pdf

 

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

wanpppconnSCPD.pdf

 

WANCommonInterfaceConfig

WAN-Statistiken, Online Monitor, physikalischer WAN Zugangstyp und Status

05.09.18

wancommonifconfigSCPD.pdf

 

WANEthernetLinkConfig

Ethernet-Linkstatus

15.07.09

wanethlinkconfigSCPD.pdf

 

WANDSLInterfaceConfig

DSL-Informationen (CRC, Datenraten, SNR, ...), DSL-Diagnose (zB. Detektion von Kabelbrüchen)

14.03.18

wandslifconfigSCPD.pdf

 

WANDSLLinkConfig

VCC-Einstellungen, ATM-Statistiken

20.11.15

wandsllinkconfigSCPD.pdf

 

X_AVM-DE_Speedtest

Datendurchsatzmessungen

06.02.15

x_speedtestSCPD.pdf

 

X_AVM-DE_RemoteAccess

Dynamic DNS, Fernwartung

22.11.17

x_remoteSCPD.pdf

     

15.08.18

AVM_TR-064_remote.pdf

 

X_AVM-DE_MyFritz

Fernzugang, MyFritz, Dynamic DNS

16.05.17

X_myfritzSCPD.pdf

 

X_AVM-DE_HostFilter

Kindersicherung, Internetsperre

01.04.20

x_hostfilterSCPD.pdf

 

Layer3Forwarding

IP Netzwerkrouten, WAN Verbindungstyp

15.07.09

layer3forwardingSCPD.pdf

Telefonie

       
 

X_AVM-DE_OnTel

Telefonbuch, Online-Telefonbuch, Anrufliste, Rufsperren, Rufweiterleitung

10.01.19

x_contactSCPD.pdf

 

X_AVM-DE_TAM

Anrufbeantworter, Anrufliste

06.03.19

x_tam.pdf

 

X_VoIP

Einrichtung Internettelefonie-Anbieter, Einrichtung LAN/IP-Telefon, Wählhilfe, SIP-Nebenstellen

29.01.18

x_voip-avm.pdf

Heimnetz

       
 

LanDeviceHosts

Heimnetzgeräte, Wake-on-LAN, FRITZ!Mesh

15.08.18

hostsSCPD.pdf

 

WLANConfiguration

WLAN Konfiguration und Statistik, WLAN Netzwerkgeräte

12.03.19

wlanconfigSCPD.pdf

 

LANHostConfigManagement

Netzwerkeinstellungen, DHCP-Server, IP-Adressbereiche, Subnetzmaske

20.11.17

lanhostconfigmgmSCPD.pdf

 

LANEthernetInterfaceConfig

LAN-Schnittstelle und Statistiken (Paketzähler)

15.07.09

lanifconfigSCPD.pdf

 

X_AVM-DE_Dect

DECT-Geräte

02.06.17

x_dectSCPD.pdf

 

X_HomeAuto

SmartHome-Geräte

25.09.18

x_homeauto.pdf

 

X_HomePlug

Powerline-Geräte

06.01.17

x_homeplugSCPD.pdf

Speicher/NAS

       
 

X_AVM-DE_Storage

Einstellungen für SMB, FTP

21.02.19

x_storageSCPD.pdf

 

X_AVM-DE_UPnP

UPnP AV Mediaserver

22.09.09

X_upnp.pdf

   

Einrichtung Online-Speicher/WebDAV

18.09.09

X_webdavSCPD.pdf

 

X_AVM-DE_Filelinks

Dateifreigaben

07.07.16

x_filelinksSCPD.pdf

System

       
 

DeviceInfo

Produktinformation, Ereignisse, TR-069 Provisioning Code, Security Port für TR-064

15.07.09

deviceinfoSCPD.pdf

 

DeviceConfig

Einstellungen sichern/wiederherstellen, Werkseinstellungen, Neustart, SID Generierung

23.01.13

deviceconfigSCPD.pdf

 

LANConfigSecurity

Benutzerlisten und FRITZ!Box Kennwort

26.05.14

lanconfigsecuritySCPD.pdf

 

X_AVM-DE_AppSetup

Verwalten von Apps (VPN, Messagefilter, Rechte, Remotezugriff)

08.04.19

x_appsetup.pdf

 

ManagementService

TR-069-Konfiguration

23.01.13

mgmsrvSCPD.pdf

 

X_AVM-DE_Auth

2-Faktor-Authentisierung

06.10.17

x_auth.pdf

 

Time

Zeitserver (NTP)

15.07.09

timeSCPD.pdf

 

UserInterface

Firmwareinformationen und Update, Spracheinstellungen

15.01.19

userifSCPD.pdf

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

IGD1.pdf

 

Internet Gateway Device Spec v2.0

 

18.08.18

IGD2.pdf

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.

PPP-controlled Settings for AVM's FRITZ!OS v1.2.pdf

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

04.11.20

Deutsch

AVM Technical Note - Session ID_deutsch.pdf

2

04.11.20

Englisch

AVM Technical Note - Session ID_english.pdf

   

AHA-HTTP-Interface

 

1

24.04.20

Version 1.33

AVM Technical Note - AHA-HTTP-Interface.pdf

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.