2FA bei Appwrite: So richtest du eine Authenticator-App für dein Console-Konto ein

Appwrite hat zwei Arten von Multi-Faktor-Authentifizierung (MFA), und man landet leicht auf der falschen Seite. Die eine ist eine Funktion, die du in deine eigene App für deine Nutzer einbaust. Die andere schützt dein eigenes Entwicklerkonto, mit dem du dich bei der Appwrite Console anmeldest und deine Organisationen und Projekte verwaltest. In dieser Anleitung geht es um die zweite (Appwrite). Wenn du MFA für die Nutzer deiner App möchtest, behandelt Appwrite das stattdessen in seiner Auth-Dokumentation.

Für dein Console-Konto ist MFA freiwillig. Die Dokumentation von Appwrite nennt einen zeitbasierten Code aus einer Authenticator-App (TOTP) als unterstützte Methode und kündigt weitere Faktoren für später an (Appwrite). In den folgenden Schritten verwenden wir Authenticator App - Novaz auf dem iPhone. Jede Authenticator-App funktioniert genauso.

Wie wir diese Anleitung geprüft haben: Die Schritte für Appwrite stammen aus der Dokumentation von Appwrite und ihren Bildschirmfotos (unten verlinkt), die wir am 21. Oktober 2026 gelesen haben. Wir haben sie nicht mit einem Appwrite-Konto getestet, daher kann ein Label leicht abweichen. Die Schritte für Novaz sind mit der App in Version 1.0.5 geprüft.

MFA mit einer Authenticator-App einschalten

Die Seite von Appwrite ist kurz, und Text und Bildschirmfotos verwenden leicht unterschiedliche Labels. Diese Schritte folgen beiden (Appwrite):

1. Melde dich bei der Appwrite Console an. Öffne oben rechts dein Kontomenü und wähle Your account (Dein Konto).
2. Gehe zu den Sicherheitseinstellungen. Auf dem Bildschirmfoto von Appwrite ist das Security (Sicherheit) in der linken Liste, mit einer Karte Multi-factor authentication (Multi-Faktor-Authentifizierung) auf der Seite.
3. Schalte den Schalter Multi-factor authentication ein.
4. Füge die Authenticator-App hinzu. Der Text nennt die Schaltfläche Add authentication factor (Authentifizierungsfaktor hinzufügen), das Bildschirmfoto zeigt eine Zeile Authenticator app (Authenticator-App) mit einer Schaltfläche Add (Hinzufügen).
5. Ein Fenster Scan QR code (QR-Code scannen) öffnet sich. Tippe in Novaz auf + und dann auf QR-Code scannen und richte die Kamera auf den Code. Wenn die Console auf demselben iPhone geöffnet ist, mach ein Bildschirmfoto und nutze stattdessen Foto auswählen. Siehe QR-Code auf demselben iPhone scannen.
6. Wenn du nicht scannen kannst, zeigt dasselbe Fenster einen Manual entry code (Code zur manuellen Eingabe) mit einer Kopieren-Schaltfläche. Tippe in Novaz auf + und dann auf Schlüssel manuell eingeben, gib unter Dienst einen Namen wie Appwrite ein und füge den Code unter Einrichtungsschlüssel ein. Siehe Was ist ein 2FA-Einrichtungsschlüssel?
7. Wähle Continue (Weiter) und gib den aktuellen Code aus Novaz ein, um die Einrichtung abzuschließen.
8. Sichere deine Wiederherstellungscodes (nächster Abschnitt).

Die Dokumentation sagt nicht, wie viele Ziffern die Codes haben oder wie oft sie sich ändern. Den QR-Code zu scannen ist die sicherere Wahl, weil er diese Einstellungen an deine App übergibt. Ein von Hand eingetippter Schlüssel ergibt 6-stellige Codes alle 30 Sekunden.

Die Wiederherstellungscodes sind dein einziger Weg zurück

Appwrite ist hier ungewöhnlich deutlich. Die Dokumentation nennt die Wiederherstellungscodes „the only way to access your account if you lose access to your authenticator app“ (den einzigen Weg in dein Konto, wenn du keinen Zugriff mehr auf deine Authenticator-App hast) (Appwrite). Einen Supportweg für ein gesperrtes Console-Konto beschreibt sie nicht.

Das Bildschirmfoto zeigt auf derselben Einstellungsseite eine Zeile Recovery codes (Wiederherstellungscodes) mit einer Schaltfläche View (Anzeigen), sodass du sie dir erneut ansehen kannst, solange du angemeldet bist. Bewahre eine Kopie an einem anderen Ort als deinem Handy auf, etwa in einem Passwort-Manager oder ausgedruckt. Wenn du kein Backup von Novaz hast oder es älter als dein Appwrite-Konto ist, sind diese Codes dein Weg zurück. Mehr dazu unter 2FA-Backup-Codes.

Dasselbe Bildschirmfoto führt auch Email (E-Mail) als Faktor auf, mit Einmalcodes an die bestätigte Adresse des Kontos. Der Text der Seite erwähnt nur die Authenticator-App, daher können wir dir anhand der Dokumentation nicht sagen, ob E-Mail-Codes bei der Anmeldung als Ausweichlösung funktionieren.

Wenn Appwrite deinen Code ablehnt

Die Dokumentation von Appwrite geht nicht auf abgelehnte Codes ein. Die häufigste Ursache ist die Uhr des iPhone: Öffne Einstellungen › Allgemein › Datum & Uhrzeit und schalte Automatisch einstellen ein. Novaz warnt dich außerdem, wenn die Uhr um 15 Sekunden oder mehr abweicht. Wenn du den Schlüssel von Hand eingetippt hast, prüfe, ob du ihn vollständig kopiert hast. Weitere Ursachen findest du unter Authenticator-Code funktioniert nicht?

Handy wechseln

Appwrite dokumentiert nicht, wie du MFA auf ein neues Handy überträgst, die Authenticator-App ersetzt oder MFA ausschaltest. Erledige all das, solange du dich mit dem alten Handy noch anmelden kannst, über dieselbe Karte Multi-factor authentication. Wenn du das iCloud-Backup von Novaz eingeschaltet oder eine Backup-Datei exportiert hast, kannst du Appwrite auf dem neuen Handy wiederherstellen. Ohne Backup fügst du es auf dem neuen Handy als neues Konto hinzu. Siehe So überträgst du deine Authenticator-App auf ein neues iPhone.

Wenn du deine Authenticator-App verlierst

Melde dich mit einem deiner Wiederherstellungscodes an und richte die Authenticator-App dann auf deinem neuen Handy neu ein. Ohne die Wiederherstellungscodes bietet die Dokumentation von Appwrite keinen anderen Weg zurück in das Konto. Mehr dazu unter Handy mit der Authenticator-App verloren?

Offizielle Hilfe von Appwrite

• Multi-factor authentication (dein Console-Konto)
• Multi-factor authentication (Appwrite Auth, für die Nutzer deiner App)
• Security