For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /de/docs/modules/auth.md (or send Accept: text/markdown).
Authentifizierung
Identität und Sitzungen mit Better Auth.
Erstellen und verifizieren Sie ein echtes Konto
Unter Authentifizierung versteht man den Nachweis, wer die App nutzt. Starten Sie Postgres und führen Sie Migrationen zunächst mithilfe des Datenbankhandbuchs durch. Lassen Sie dann den Webserver laufen. Öffnen Sie http://localhost:3000/auth,, wählen Sie E-Mail-/Passwort-Anmeldung, geben Sie Ihren Namen, Ihre E-Mail-Adresse und Ihr Passwort ein und senden Sie es ab. Behalten Sie EMAIL_PROVIDER=local für diesen ersten Test.
Wenn ein Flow einen E-Mail-Code anfordert, öffnen Sie http://localhost:3000/mail-preview in einem anderen Browser-Tab, suchen Sie die aktuellste Nachricht für diese Adresse und kopieren Sie den Code zurück in das Anmeldeformular. Fordern Sie einen neuen Code an, wenn dieser abläuft. Diese Nachrichten bleiben im lokalen Postausgang; Durch wiederholtes Überprüfen eines externen Posteingangs werden sie nicht gefunden. Melden Sie sich ab und dann erneut an, um zu bestätigen, dass das datenbankgestützte Konto funktioniert.
Wenn bei der Anmeldung ein Datenbankverbindungs- oder ein fehlender Tabellenfehler gemeldet wird, schließen Sie die Datenbankeinrichtung ab, anstatt die soziale Anmeldung zu aktivieren. Für die Schaltflächen Google, GitHub, Apple, X und Microsoft sind eigene Anbieteranwendungen und Rückrufeinstellungen erforderlich. Aktivieren Sie eines erst, nachdem der Anbieterleitfaden vollständig ist. Better Auth ist die mitgelieferte Standard-Engine und benötigt kein kostenpflichtiges Authentifizierungskonto für die lokale E-Mail-Anmeldung.
Aktive Anmeldemethoden auswählen
Die Grundlage umfasst E-Mail/Passwort, OTP und konfigurierbare Social-Authentifizierung. Better Auth verwaltet Identität und Sitzungen; die Anwendung setzt die Provider-Konfiguration und den transaktionalen OTP-Versand zusammen.
Aktivieren Sie nur Social-Provider, die Sie konfiguriert haben. Provider-Client-Secrets und das Authentifizierungs-Secret bleiben auf dem Server.
Identität mit einem Workspace verknüpfen
Authentifizierte Handler lösen zuerst den Sitzungsstatus auf und greifen erst danach auf Workspace-Datensätze zu. Die Bereitstellung eines Workspace muss idempotent bleiben, damit ein wiederholter Lifecycle-Hook keine doppelten Besitzdatensätze erstellt.
Sitzungsverhalten überprüfen
Testen Sie Anmeldung, ungültige oder abgelaufene OTPs, einmalige Verwendung, Abmeldung und die Ablehnung anonymer Zugriffe. Tests mit dem Speicheradapter prüfen das Verhalten der Handler; dauerhafte Speicherung in der Produktionsdatenbank und echte Provider-Callbacks müssen separat abgenommen werden.
Wenn du die Einrichtung fortsetzen möchtest, lies KI einrichten.