Anmeldung mit einem Einmalcode schützen
XOA-HL kann nach dem Passwort einen sechsstelligen Einmalcode aus einer Authenticator-App verlangen. Der Code ändert sich zeitabhängig (TOTP). Jedes Konto mit lokalem Passwort aktiviert ihn für sich selbst. Probieren Sie dies zuerst mit einem Nicht-Administratorkonto aus, das Sie für diesen Test angelegt haben.
v5.113.2_e281c536-ce47 (ca44911, Xen Orchestra 5.113.2). Anmeldung und Zeitfenster des Codes wurden am 28.10.2026 mit einem einzelnen Wegwerfkonto ohne Administratorrechte im D3-Labordurchlauf getestet. Der Schalter auf der Benutzerseite und der QR-Dialog, die Schaltfläche Remove unter Settings, eine falsche Uhr der Appliance und nach der OTP-Aktivierung erstellte Token wurden in diesem ce47-Durchlauf nicht getestet; die Einrichtungs- und Entfernungsschritte unten beruhen für ce47 auf einer Prüfung des festgelegten Quellcodes. Ein späterer RPM-Validierungslauf mit ce51 hat diese Einzelfälle getestet. Seine Ergebnisse belegen kein Verhalten der ce47-Appliance. Spätere Versionen können abweichen.Vor dem Beginn
| Voraussetzung | Grund |
|---|---|
| Eine TOTP-Authenticator-App auf einem von Ihnen kontrollierten Gerät | Sie erzeugt Codes aus einem gemeinsamen Geheimnis |
| Korrekte Uhrzeit auf Appliance und Gerät | XO akzeptiert den aktuellen Code sowie die Codes des vorherigen und folgenden 30-Sekunden-Zeitschritts |
| Ein zweiter Administrator oder ein gesonderter Wiederherstellungsplan | Andernfalls kann ein verlorenes Gerät den einzigen Administrator aussperren |
| Eine während des Tests offen gehaltene Browsersitzung | Damit können Sie den Einmalcode entfernen, falls die Prüfung scheitert |
Bei der Einrichtung prüft Ihr Browser den eingegebenen Code anhand seiner eigenen Uhr. Bei der Anmeldung prüft die Appliance ihn anhand ihrer Uhr. Ein bei der Einrichtung akzeptierter Code belegt daher nicht, dass die Appliance-Uhr stimmt.
Einmalcode für das eigene Konto aktivieren
- Melden Sie sich mit dem zu schützenden Konto an. Öffnen Sie über das Benutzersymbol im Menü Ihre Benutzerseite (
/#/user). - Aktivieren Sie den Schalter OTP authentication. Der Dialog Add OTP authentication zeigt einen QR-Code und das Geheimnis als Text.
- Scannen Sie den QR-Code oder geben Sie das Geheimnis in Ihrer Authenticator-App ein. Der neue Eintrag hat den Aussteller
Xen Orchestraund die E-Mail-Adresse beziehungsweise den Anmeldenamen des Kontos als Namen. - Geben Sie den aktuellen Code in OTP code ein und bestätigen Sie. Bei einem falschen Code öffnet sich der Dialog erneut: Geben Sie den jetzt angezeigten Code der App ein. Mit Cancel bleibt der Einmalcode deaktiviert.
Fehlt der Schalter, halten Sie an und notieren Sie die installierte Version. Dieser Build verwendet den voreingestellten Open-Source-Plan von XO, der den Schalter anzeigt. Ein fehlendes Abonnement ist daher nicht die Ursache. Melden Sie die Abweichung.
Prüfung: Der Schalter ist eingeschaltet, und die Benutzerseite zeigt daneben das Geheimnis und seinen QR-Code. Jeder, der diese sieht, kann gültige Codes erzeugen: Geben Sie diese Seite nicht weiter und erstellen Sie keine Bildschirmfotos davon. Dieser QR-Code verwendet für dasselbe Geheimnis den Aussteller XenOrchestra (ohne Leerzeichen). Behalten Sie den vorhandenen App-Eintrag; scannen Sie ihn nicht erneut.
Anmeldung in einer neuen Sitzung prüfen
- Lassen Sie die aktuelle Sitzung offen. Öffnen Sie ein privates Browserfenster und melden Sie sich mit Benutzername und Passwort an.
- Eine zweite Seite verlangt einen Code. Geben Sie den aktuellen App-Code ein und wählen Sie Sign in.
- Ein falscher oder abgelaufener Code führt zu
Invalid code. Warten Sie auf den nächsten Code und versuchen Sie es erneut. - Prüfen Sie, dass das richtige Konto angemeldet ist, und schließen Sie das private Fenster.
Das ce47-Labor akzeptierte den aktuellen Code sowie Codes aus dem unmittelbar vorherigen oder nächsten 30-Sekunden-Schritt. Codes zwei Schritte davor oder danach wurden abgelehnt. Das ist ein Zeitfenster, keine Zusage, dass ein Code genau 30 Sekunden ab dem Ablesen gültig ist.
Prüfung: Die Anmeldung hat einen Code verlangt und den richtigen akzeptiert. Scheitert dies weiterhin, entfernen Sie den Einmalcode über die offene Sitzung, prüfen Sie beide Uhren und aktivieren Sie ihn erneut.
Was ein Einmalcode nicht schützt
- Derselbe Code kann innerhalb seines akzeptierten Zeitfensters erneut verwendet werden. Betrachten Sie ihn nach einer erfolgreichen Anmeldung nicht als verbraucht.
- Wiederholt falsche Codes lösen im getesteten ce47-Ablauf keine OTP-Sperre aus: Nach fünf falschen Codes wurde der richtige sofort akzeptiert. Verwenden Sie ein starkes Passwort.
- Seine Aktivierung beendet keine bestehenden Sitzungen und widerruft keine Token. Jedes gültige Authentifizierungstoken überspringt die Codeprüfung, auch später erstellte Token: Token sind eigenständige Zugangsdaten. Öffnen Sie nach der Aktivierung Authentication tokens auf Ihrer Benutzerseite und löschen Sie unbekannte oder nicht mehr benötigte Token. Ein Skript mit einem gelöschten Token funktioniert anschließend nicht mehr.
- Geschützt wird nur die XO-Webanmeldung dieses Kontos. SSH- oder Konsolenzugriff auf die Appliance, XO Lite, das Root-Konto auf dem Host und andere XO-Konten sind nicht geschützt.
- Externe Anmeldeanbieter und ihre eigene Mehrfaktorauthentifizierung werden hier nicht behandelt.
Einmalcode entfernen
- Eigenes Konto: Deaktivieren Sie auf Ihrer Benutzerseite OTP authentication und bestätigen Sie Remove OTP authentication.
- Anderes Konto als Administrator: Öffnen Sie Settings → Users. Wählen Sie in der Spalte OTP für dieses Konto Remove und bestätigen Sie. Prüfen Sie zunächst, wer die Anfrage stellt, beispielsweise über einen anderen Kanal. Der Benutzer kann danach ein neues Gerät einrichten.
Konten ohne Einmalcode zeigen dort Not configured. Verliert der einzige Administrator sein Gerät, bietet die Oberfläche keinen Rückweg. Über die Appliance-Konsole können Sie dennoch den Administratorzugriff wiederherstellen. Ein zweiter Administrator ist einfacher: Halten Sie einen bereit.
Prüfung: Der Schalter ist ausgeschaltet und die OTP-Spalte des Kontos zeigt Not configured. In einem neuen privaten Fenster meldet sich das Konto mit lokalem Benutzername und Passwort ohne Code an. Lassen Sie den Wiederherstellungsadministrator angemeldet, bis Sie dies bestätigt haben.
Quellen
- Benutzerseite und Einrichtung: OTP-Abschnitt der Benutzerseite, Benutzerseite und Token, Einrichtungsdialog, Aktionen zum Aktivieren und Entfernen, OTP-Spalte der Benutzereinstellungen.
- Anmeldung und Token: Anmeldeseiten, Anmeldeformular, Authentifizierung und Token-Ausnahme, TOTP-Zeitfenster, Wiederherstellungsbefehl, Oberflächenbezeichnungen.
- Build und Browsereinrichtung: XO-Standardplan, Browser-Authenticator, API der Benutzereinstellungen, HomeLab-Build.