Erfahren Sie in diesem Artikel,
- wie die Zugangsdaten für die radixAPI bereitgestellt werden,
- wie Profil und Passwort geändert werden und
- wie die Zwei-Faktor-Authentifizierung eingerichtet wird.
1. Einführung
Für die Nutzung von der radixAPI ist ein eigenes Benutzerkonto erforderlich. Da die radixAPI pro Benutzer lizenziert wird, sollte jede Person bzw. jede angebundene Anwendung ein eigenes Benutzerkonto erhalten. Gemeinsam genutzte Benutzerkonten sind für den produktiven Einsatz nicht vorgesehen, da sich Aufträge und Protokolle sonst keiner Person oder Anwendung eindeutig zuordnen lassen.
Zu jedem Benutzerkonto können zwei E-Mail-Adressen hinterlegt werden:
- Anmelde-E-Mail – diese Adresse dient zur Identifikation des Benutzers. Bei einer Registrierung über das Backend-UI wird diese Adresse per E-Mail bestätigt. Jede Anmelde-E-Mail darf nur einem Benutzerkonto zugeordnet sein.
- Benachrichtigungsadresse – an diese Adresse werden Benachrichtigungen sowie Links zum Zurücksetzen des Passworts gesendet. Sofern keine Benachrichtigungsadresse hinterlegt ist, wird stattdessen die Anmelde-E-Mail verwendet. Mehrere Benutzer können dieselbe Benachrichtigungsadresse verwenden.
Die Benachrichtigungsadresse kann jederzeit im eigenen Profil geändert werden. Da an diese Adresse auch Links zum Zurücksetzen des Passworts gesendet werden, sollte ausschließlich eine Adresse verwendet werden, auf die nur berechtigte Personen Zugriff haben.
2. Zugangsdaten erhalten
Das Benutzerkonto wird in der Regel im Rahmen der Einrichtung durch den Anbieter angelegt. Benutzername und Passwort werden dabei getrennt voneinander übermittelt. Mit diesen Zugangsdaten erfolgt die Anmeldung in das Backend-UI bzw. über die Schnittstelle.
Sofern die Registrierung vom Anbieter freigeschaltet ist, kann ein Benutzerkonto auch selbst über die Backend-UI angelegt werden. Nach der Registrierung wird eine Bestätigungs-E-Mail an die Anmelde-E-Mail gesendet. Erst nachdem der darin enthaltene Link aufgerufen wurde, ist das Benutzerkonto aktiv und die Anmeldung möglich. Der Link ist 48 Stunden gültig. Sofern die Bestätigungs-E-Mail nicht angekommen ist, kann sie erneut angefordert werden.
Welche Funktionen nach der Anmeldung zur Verfügung stehen, hängt von der Lizenz des Benutzers ab. Weitere Informationen dazu finden Sie im Artikel Lizenzierung.
2.1. Profil und Passwort ändern
Im eigenen Profil werden die persönlichen Angaben, die Benachrichtigungsadresse und das Passwort geändert. Das Profil wirdü ber das Benutzersymbol rechts oben und My Profile geöffnet.
Gehen Sie wie folgt vor, um das Passwort zu ändern:
- Öffnen Sie über das Benutzersymbol rechts oben My Profile [1].
- Geben Sie das neue Passwort in die Felder Password und Confirm Password [2] ein.
- Klicken Sie auf Submit [3].
Sofern kein neues Passwort vergeben werden soll, bleiben die beiden Felder leer. Ein Passwort, das von einem Administrator vergeben wurde, sollte nach der ersten Anmeldung umgehend auf diesem Weg geändert werden.
Abbildung 1: Profil im Backend-UI
2.2. Passwort zurücksetzen
Sofern das Passwort vergessen wurde, kann es über die Anmeldeseite zurückgesetzt werden. Dazu wird entweder der Benutzername oder die Anmelde-E-Mail angegeben. Anschließend wird ein Link zum Zurücksetzen des Passworts an die Benachrichtigungsadresse gesendet, sofern diese hinterlegt ist, andernfalls an die Anmelde-E-Mail. Der Link ist eine Stunde gültig.
Mit dem Zurücksetzen des Passworts wird zugleich eine eingerichtete Zwei-Faktor-Authentifizierung zurückgesetzt. Bei der nächsten Anmeldung muss die Authenticator-App daher neu eingerichtet werden. Dadurch ist die Anmeldung auch dann wieder möglich, wenn das Smartphone mit der Authenticator-App verloren gegangen ist.
Sofern die Anmeldung auf diesem Weg nicht möglich ist, kann ein Administrator das Benutzerkonto in der Backend-UI unter User wiederherstellen. Dort wird über Reset Password ein neues Passwort vergeben bzw. ber den Schalter in der Spalte 2FA die Zwei-Faktor-Authentifizierung für den jeweiligen Benutzer deaktiviert. Ein vom Administrator vergebenes Passwort sollte nach der Anmeldung umgehend geändert werden
3. Zwei-Faktor-Authentifizierung einrichten
Mit der Zwei-Faktor-Authentifizierung wird bei jeder Anmeldung zusätzlich zum Passwort ein sechsstelliger Code abgefragt. Dieser Code wird von einer Authenticator-App auf dem Smartphone erzeugt und ändert sich alle 30 Sekunden. Gängige Authenticator-Apps werden unterstützt. Die Zwei-Faktor-Authentifizierung steht ausschließlich für Administrator- und Client-Konten zur Verfügung.
Gehen Sie wie folgt vor, um die Zwei-Faktor-Authentifizierung einzurichten:
- Öffnen Sie ber das Benutzersymbol rechts oben My Profile [1] (Abbildung 1).
- Aktivieren Sie im Bereich Two-Factor Authentication [4] die Option für die Zwei-Faktor-Authentifizierung.
- Es öffnet sich nun ein Sicherheitsdialog, in dem die Aktivierung der Zwei-Faktor-Authentifizierung nochmals bestätigt werden muss.
- Klicken Sie auf Submit [5] und bestätigen Sie die Abfrage.
- Melden Sie sich ab und erneut mit Benutzername und Passwort an.
- Scannen Sie den auf der Anmeldeseite angezeigten QR-Code mit der Authenticator-App. Alternativ geben Sie den angezeigten Schlüssel manuell in der Authenticator-App ein.
- Geben Sie den sechsstelligen Code aus der Authenticator-App ein.
Nach erfolgreicher Eingabe ist die Einrichtung abgeschlossen. Ab diesem Zeitpunkt wird bei jeder Anmeldung nach dem Passwort der aktuelle Code aus der Authenticator-App abgefragt. Der Code muss innerhalb von 10 Minuten eingegeben werden. Nach fnf falschen Eingaben muss die Anmeldung erneut gestartet werden.
Abbildung 2: Einrichtung der Zwei-Faktor-Authentifizierung
Artikel Update: radixAPI 2.4.0 – 10/2026