better-auth-best-practices

Überblick

Was ist better-auth-best-practices?

better-auth-best-practices ist ein praxisorientierter Leitfaden und Konfigurations-Skill zur Integration von Better Auth in Ihr TypeScript-Backend. Er umfasst die wesentlichen Schritte zur Einrichtung von Authentifizierungsservern und -clients, zur Konfiguration von Datenbankadaptern, zur Verwaltung von Sessions, zum Hinzufügen von Plugins und zum Umgang mit Umgebungsvariablen. Dieser Skill richtet sich an Backend-Entwickler, die robuste Authentifizierungsabläufe benötigen, einschließlich E-Mail/Passwort, OAuth und pluginbasierte Setups.

Für wen ist dieser Skill geeignet?

• Backend-Entwickler, die mit TypeScript arbeiten
• Teams, die Authentifizierung in Node.js-Projekten implementieren
• Projekte, die sichere und flexible Authentifizierung mit Better Auth benötigen
• Alle, die Auth-Konfiguration, Umgebungsvariablen und Datenbankadapter verwalten müssen

Welche Probleme werden gelöst?

• Vereinfachte Einrichtung von Better Auth in neuen oder bestehenden Projekten
• Klare Anleitung zu Umgebungsvariablen und Dateipfaden
• Optimierte Verwaltung von Datenbankadaptern und Sessions
• Schnelle Referenzen für CLI-Befehle und Plugin-Integration

Verwendung

Installationsschritte

1. Installieren Sie Better Auth in Ihrem Projekt:

   npm install better-auth
   

2. Legen Sie die erforderlichen Umgebungsvariablen fest:
   • BETTER_AUTH_SECRET (mindestens 32 Zeichen; erzeugen mit openssl rand -base64 32)
   • BETTER_AUTH_URL (Ihre Basis-URL, z. B. https://example.com)
3. Erstellen Sie eine Datei auth.ts im Projektstammverzeichnis, lib, utils oder src. Diese Datei sollte Ihren Datenbankadapter und die Authentifizierungsoptionen konfigurieren.
4. Fügen Sie in Ihrem bevorzugten Backend-Framework einen Routen-Handler für Authentifizierungsendpunkte hinzu.
5. Führen Sie den Migrationsbefehl aus, um das Datenbankschema einzurichten:

   npx @better-auth/cli@latest migrate
   

6. Überprüfen Sie Ihre Einrichtung, indem Sie den Health-Check-Endpunkt aufrufen:
   • GET /api/auth/ok sollte { status: "ok" } zurückgeben

Konfigurationstipps

• Definieren Sie baseURL und secret in Ihrer Konfiguration nur, wenn die entsprechenden Umgebungsvariablen nicht gesetzt sind.
• Die CLI sucht auth.ts an Standardorten; für benutzerdefinierte Pfade verwenden Sie die --config-Option.
• Nach dem Hinzufügen oder Ändern von Plugins immer den Migrationsbefehl erneut ausführen.

Nützliche CLI-Befehle

• npx @better-auth/cli@latest migrate — Eingebautes Schema anwenden
• npx @better-auth/cli@latest generate — Schema für Prisma oder Drizzle generieren
• npx @better-auth/cli mcp --cursor — MCP-Integration für KI-Tools hinzufügen

FAQ

Ist better-auth-best-practices für alle Backend-Projekte geeignet?

Dieser Skill ist ideal für TypeScript- und Node.js-Backends, die sichere und flexible Authentifizierung benötigen. Er ist nicht für reine Frontend- oder Nicht-TypeScript-Umgebungen gedacht.

Welche Umgebungsvariablen sind erforderlich?

Sie müssen BETTER_AUTH_SECRET (ein sicherer, zufälliger String) und BETTER_AUTH_URL (die Basis-URL Ihrer Anwendung) setzen. Diese sind entscheidend für den sicheren Betrieb.

Wo sollte ich meine auth.ts-Datei ablegen?

Die CLI sucht auth.ts im Projektstammverzeichnis, lib, utils oder src. Für einen benutzerdefinierten Speicherort verwenden Sie die --config-Option.

Wie aktualisiere ich meine Einrichtung nach dem Hinzufügen von Plugins?

Führen Sie nach dem Hinzufügen oder Ändern von Plugins immer den Migrationsbefehl (npx @better-auth/cli@latest migrate) erneut aus, um das Datenbankschema aktuell zu halten.

Wo finde ich weitere Beispiele und Dokumentation?

Besuchen Sie better-auth.com/docs für aktuelle Codebeispiele, API-Referenzen und erweiterte Konfigurationsanleitungen.