Authentifizierung
OAuth mit 15 Anbietern, TOTP MFA, Magic Links, Einmalcodes per E-Mail und SMS und rollenbasierter Zugriffskontrolle aus einem einzigen SDK.
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.
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.
# 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#
'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 }
}
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.
| Methode | Endpunkt | Beschreibung |
|---|---|---|
POST | /v1/auth/register | Erstellen Sie ein Konto mit E-Mail und Passwort |
POST | /v1/auth/login | Melden Sie sich mit einem Passwort an |
GET | /v1/auth/oauth/{provider}/start | Starten Sie einen OAuth-Flow (PKCE). |
POST | /v1/auth/magic-link | Senden Sie einen magischen Link |
POST | /v1/auth/email-otp/send | Senden Sie einen Einmalcode per E-Mail |
POST | /v1/auth/mfa/setup | Registrieren Sie einen TOTP-Faktor |
POST | /v1/auth/refresh | Aktualisieren Sie das Token-Paar |
GET | /v1/auth/me | Gibt den aktuellen Benutzer zurück |
GET | /v1/auth/sessions | Aktive Sitzungen auflisten |
DELETE | /v1/auth/sessions/{session_id} | Eine Sitzung widerrufen |
POST | /v1/auth/logout | Beenden Sie die aktuelle Sitzung |