Setup: auth.ts, Route-Handler, Env

Vier Dateien, dann läuft Login. Wir installieren das Paket, schreiben die zentrale auth.ts, hängen den Zwei-Zeilen-Route-Handler ein und setzen die AUTH_-Umgebungsvariablen. Beispiel- Provider ist GitHub — jeder andere OAuth-Provider geht genauso.

Schritt für Schritt

• Installieren. Das @beta-Tag zieht v5.
• auth.ts anlegen. Provider rein, vier Helfer raus.
• Route-Handler einhängen. Damit OAuth-Callbacks eine URL haben.
• Env setzen. AUTH_SECRET plus die Provider-Credentials.

1 · Installieren

npm install next-auth@beta
# erzeugt direkt ein Secret und schreibt es in .env.local:
npx auth secret

2 · Die zentrale Konfiguration

import NextAuth from "next-auth";
import GitHub from "next-auth/providers/github";

export const { handlers, signIn, signOut, auth } = NextAuth({
  providers: [GitHub],
});

Kein AUTH_GITHUB_ID/AUTH_GITHUB_SECRET im Code — Auth.js liest die passend benannten Env-Variablen automatisch. Mehr dazu unten.

3 · Der Route-Handler

Der OAuth-Flow braucht eine Callback-URL. Auth.js bringt die Logik mit; du exportierst sie nur an die richtige Stelle im App Router:

import { handlers } from "@/auth";

export const { GET, POST } = handlers;

4 · Umgebungsvariablen

AUTH_SECRET=dein-generiertes-secret

AUTH_GITHUB_ID=...
AUTH_GITHUB_SECRET=...

AUTH_SECRET

Pflicht. Signiert/verschlüsselt das Session-JWT. Mit npx auth secret generiert.

AUTH_<PROVIDER>_ID / _SECRET

Auto-erkannt: GitHub liest AUTH_GITHUB_ID und AUTH_GITHUB_SECRET von selbst.

AUTH_URL

Optional. Wird normalerweise aus den Request-Headern erkannt — nur bei eigenartigen Proxy-Setups manuell nötig.