Recommendations for user guidance for logging in to a FRITZ!BoxVersion: 1.1
Date: 20/10/2020

This document gives developers of third-party applications recommendations for userguidance for logging in to a FRITZ!Box. From a usability point of view, developers ofthird-party applications are strongly recommended to adapt their user interface andterms to the behavior of the FRITZ!Box interface, which is familiar to the user.

FRITZ!Box interfaces

FRITZ!OS offers a number of options for accessing the configuration of the FRITZ! device oraccessing statistics and live data:The TR-064 protocol
The UPnP IGD protocol
The graphic web interface

If third-party applications want to access the FRITZ!Box's configuration or live values, it isstrongly recommended to use the standardized TR-064 or UPnP IGD methods. Extensive
documentation on these protocols is available at avm.de/schnittstellen.

Access to the configuration via the http interface, which the FRITZ!Box interface itself uses,
is not recommended. Its parameters are not documented, interrelationships between
individual parameters are not known and AVM reserves the right to make changes at any
time as part of updates, which may not be backward compatible.

Login types from the home network

Before FRITZ!OS 7.24, there were three ways to log in to the FRITZ!Box web interface fromthe home network:
With user name and password
Only with FRITZ!Box password (factory settings, FRITZ!Box password on sticker on bottomof device)Without a password (not recommended)With FRITZ! OS 7.24, the available login types have been reduced. On a technical level, alogin from the home network is always done with a user name and a password fromFRITZ!OS 7.24 and later.

When logging in from the Internet, only login with a user name and password is supported,even in versions prior to 7.24.

Automatically configured FRITZ! user

If the login type "Login only with FRITZ!Box password" was used up until now, a FRITZ! user
will be created automatically during the update. This FRITZ! user has a randomly chosenname based on the scheme fritz[0-9] {4}, for example fritz1234, fritz1337 or fritz0042.

User guidance if user only logged in with the FRITZ!Box password prior to updating toFRITZ!OS 7.24

To make it easier for users to log in who have not yet set a user name (FRITZ!Box factorysettings), the FRITZ!Box often only asks for the FRITZ!Box password. The user may noteven know the name of the automatically created user.

To map this functionality, third-party applications starting with FRITZ!OS 7.24 and later canretrieve a user list and the last logged in FRITZ!Box user via login_sid.lua?version=2 (theuser list is located here under <Users> in the response XML, the last logged in user ismarked with <User last=1>) or via TR-064 (urn:LANConfigSecuritycom:serviceId:LANConfigSecurity1). If the user list is empty, access to it has been blocked,e.g. because it is being accessed from the Internet and not from the home network.

1) If there is only one FRITZ! user and this user is the one that was created automatically(with the naming scheme as described above), the user name is automatically added whenlogging in to the FRITZ!Box web interface and the user is only asked for their FRITZ!Boxpassword.

2) If, in addition to other FRITZ!Box users, there is exactly one automatically created
FRITZ!Box user, and this was the last user to log in, the user name is automatically added tothe FRITZ!Box web interface when logging in, and the user is only asked for their FRITZ!Boxpassword. In addition, another link allows the complete user list to be displayed and selected.

3) If there are several users and the last user logged in did not correspond to the namescheme of the automatically created user, a selection list for the user name and a link to thealternative login option is offered only with the FRITZ!Box password.

4) In all other cases you will be asked for the user name and password and a selection list for
the user name will be displayed when accessing from the home network.

Status after updating to FRITZ!OS 7.24 if no login was set before the update

If the "Login without password" mode was previously active and there is no successful login
procedure after updating to FRITZ!OS 7.24, you will first be asked to log in by pressing a key
on the FRITZ!Box. Access to login_sid.lua? Version = 2 is disabled until a password is set.