Zum Inhalt springen
Aurabase-Logo
Aurabasis

Authentifizierung

OAuth mit 15 Anbietern, TOTP MFA, Magic Links, Einmalcodes per E-Mail und SMS und rollenbasierter Zugriffskontrolle aus einem einzigen SDK.

Erklärung7 Min. gelesenEbene MittelstufeÜberarbeitet am 15.04.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Was Aura-Auth macht#

Der Dienst aura-auth gibt JWTs für Benutzer in einem Projekt aus und validiert sie. Die Signatur lautet standardmäßig ES256, mit einem vom Projekt abgeleiteten-Geheimnis; RS256 (und das Offenlegen eines JWKS) wird nur verwendet, wenn ein RSA-Schlüssel konfiguriert ist – dies ist ein Opt-In, nicht das Standardverhalten. Es verwaltet den gesamten Lebenszyklus: Registrierung, E-Mail-Verifizierung, MFA, Aktualisierungstokenrotation, serverseitige Sperrung.

Jedes Token bettet sub, project_id, role (anon oder authenticated), email und ein app_metadata-Objekt ein, das Ihre serverseitigen Ansprüche trägt (tenant, roles). Das Gateway fügt diese Ansprüche über request.jwt.claims in Postgres-Verbindungen ein, sodass RLS-Richtlinien direkt für auth.uid(), auth.role(), auth.tenant() zugänglich sind.

Infos

Benutzertabellen leben in project_{uuid}_auth: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.

Drei Akteure, drei Verantwortlichkeiten#

Der Client signiert eine Challenge, der Dienst fragt die Datenbank ab, das Gateway validiert jede nachfolgende Anfrage.

Anmeldevorgangtext
# 1. Client → aura-auth: Anmeldeinformationen
POST /v1/auth/login  { email, password }

# 2. aura-auth: Argon2id verify + MFA, falls erforderlich (Status bleibt 200)
if password OK && mfa_required  →  data = { mfa_required: true, mfa_token }
else                            →  data = { access_token, refresh_token, user, ... }

# 3. Nachfolgende Anfragen laufen über das Gateway
apikey: <anon_key>   +   Authorization: Bearer <jwt>
gateway vérifie le JWT  →  claims injectés → Postgres RLS

Acht Mechanismen bereit#

  • E-Mail + Passwort. Argon2id, optionale E-Mail-Verifizierung, sichere Rotation.
  • OAuth 2.1 · PKCE. 15 Anbieter – Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat.
  • MFA TOTP. Authy, 1Password, Google Authenticator. Fallback-SMS.
  • Magische Links und OTP. E-Mail ohne Passwort, i18n-Vorlagen, Ratenbegrenzung nach Adresse.
  • Granulares RBAC. Rollen, Berechtigungen, Organisationshierarchien. Selbstgenerierte RLS-Richtlinien.
  • Sitzungsbindung. Gerätefingerabdruck, IP-Prüfung, Rotationsaktualisierungstoken.

Vier Streams, ein SDK#

app/actions/auth.tstypescript
'use server'
import { aura } from '@/lib/aurabase'

export async function signUp(email: string, password: string) {
  const { data, error } = await aura.auth.signUp({
    email,
    password,
    options: { emailRedirectTo: '/auth/callback' },
  })
  if (error) return { error }
  return { user: data.user }
}
Serverseitige Sitzung

Verwenden Sie im Next.js App Router immer den createServerClient-Helfer von @aurabase/aurabase-js/ssr in Serveraktionen und Routenhandlern. Das Cookie-Aktualisierungstoken ist httpOnly und sollte niemals vom Client-JS gelesen werden.

Wenn Sie das SDK nicht verwenden#

Alle Abläufe werden auch in rohem REST mit denselben serverseitigen Validierungen bereitgestellt. Die vollständige Liste finden Sie unter /docs/api-rest.

MethodeEndpunktBeschreibung
POST/v1/auth/registerErstellen Sie ein Konto mit E-Mail und Passwort
POST/v1/auth/loginMelden Sie sich mit einem Passwort an
GET/v1/auth/oauth/{provider}/startStarten Sie einen OAuth-Flow (PKCE).
POST/v1/auth/magic-linkSenden Sie einen magischen Link
POST/v1/auth/email-otp/sendSenden Sie einen Einmalcode per E-Mail
POST/v1/auth/mfa/setupRegistrieren Sie einen TOTP-Faktor
POST/v1/auth/refreshAktualisieren Sie das Token-Paar
GET/v1/auth/meGibt den aktuellen Benutzer zurück
GET/v1/auth/sessionsAktive Sitzungen auflisten
DELETE/v1/auth/sessions/{session_id}Eine Sitzung widerrufen
POST/v1/auth/logoutBeenden Sie die aktuelle Sitzung

Um weiter zu gehen#