Authentifizierung

Überblick

Das Modul client.auth übernimmt die Benutzerauthentifizierung, die Token-Verwaltung und die Persistenz von Sitzungen. Sobald sich ein Benutzer anmeldet, enthalten alle nachfolgenden Datenanfragen automatisch das JWT.

Das SDK persistiert Sitzungen standardmäßig im localStorage und aktualisiert Tokens automatisch, bevor sie ablaufen.

E-Mail / Passwort

Anmelden

const { user, accessToken, refreshToken } = await client.auth.signInWithEmail(
    "user@example.com",
    "password"
);
console.log(user.uid, user.email);

Registrieren

const { user } = await client.auth.signUp(
    "user@example.com",
    "password",
    "Jane Doe"   // optional displayName
);

OAuth-Anbieter

Das SDK enthält dedizierte Methoden für gängige OAuth-Anbieter sowie ein generisches signInWithOAuth() für jeden benutzerdefinierten Anbieter.

Google

Unterstützt drei Aufrufvarianten:

// ID-token flow (One Tap / Sign In With Google button)
await client.auth.signInWithGoogle({ idToken: googleIdToken });

// Access-token flow (popup)
await client.auth.signInWithGoogle({ accessToken: googleAccessToken });

// Authorization code flow (most secure, server-side exchange)
await client.auth.signInWithGoogle({ code: authCode, redirectUri: "https://..." });

Andere Anbieter

Jeder Anbieter folgt dem Authorization-Code-Flow mit (code, redirectUri):

await client.auth.signInWithGitHub(code, redirectUri);
await client.auth.signInWithMicrosoft(code, redirectUri);
await client.auth.signInWithFacebook(code, redirectUri);
await client.auth.signInWithLinkedin(code, redirectUri);
await client.auth.signInWithDiscord(code, redirectUri);
await client.auth.signInWithGitLab(code, redirectUri);
await client.auth.signInWithBitbucket(code, redirectUri);
await client.auth.signInWithSlack(code, redirectUri);
await client.auth.signInWithSpotify(code, redirectUri);

Apple und Twitter erfordern zusätzliche Parameter:

// Apple — optional user info from first sign-in
await client.auth.signInWithApple(code, redirectUri, {
    name: { firstName: "Jane", lastName: "Doe" },
    email: "jane@example.com"
});

// Twitter — requires PKCE code verifier
await client.auth.signInWithTwitter(code, redirectUri, codeVerifier);

Generisches OAuth

Für jeden im Backend registrierten Anbieter:

await client.auth.signInWithOAuth("custom-provider", {
    code: authCode,
    redirectUri: "https://myapp.com/callback"
});

Abmelden

await client.auth.signOut();

Dies widerruft das Refresh-Token auf dem Server, löscht die lokale Sitzung und löst ein SIGNED_OUT-Ereignis aus.

Sitzungsverwaltung

Aktuelle Sitzung abrufen

const session = client.auth.getSession();
// { accessToken, refreshToken, expiresAt, user } | null

Aktuellen Benutzer abrufen (servergeprüft)

const user = await client.auth.getUser();
// Fetches the user from the backend (GET /auth/me)

Benutzerprofil aktualisieren

const updatedUser = await client.auth.updateUser({
    displayName: "Jane Doe",
    photoURL: "https://example.com/avatar.jpg"
});

Token aktualisieren

Die Token-Aktualisierung erfolgt automatisch, Sie können sie aber auch manuell auslösen:

const session = await client.auth.refreshSession();

Listener für den Authentifizierungsstatus

Reagieren Sie in Ihrer gesamten Anwendung auf Authentifizierungsänderungen:

const unsubscribe = client.auth.onAuthStateChange((event, session) => {
    // event: "SIGNED_IN" | "SIGNED_OUT" | "TOKEN_REFRESHED" | "USER_UPDATED"
    console.log("Auth event:", event);
    console.log("Session:", session?.user?.email);
});

// Stop listening
unsubscribe();

Passwortverwaltung

Passwort vergessen

const { success, message } = await client.auth.resetPasswordForEmail(
    "user@example.com"
);

Passwort zurücksetzen (mit Token)

const { success, message } = await client.auth.resetPassword(
    resetToken,
    "newSecurePassword"
);

Passwort ändern (authentifiziert)

const { success, message } = await client.auth.changePassword(
    "oldPassword",
    "newPassword"
);

E-Mail-Verifizierung

// Send verification email to the current user
await client.auth.sendVerificationEmail();

// Verify with the token from the email link
await client.auth.verifyEmail(token);

Sitzungsverwaltung (mehrere Geräte)

// List all active sessions
const sessions = await client.auth.getSessions();

// Revoke a specific session
await client.auth.revokeSession(sessionId);

// Revoke ALL sessions (logs out everywhere)
await client.auth.revokeAllSessions();