Authenticatie
OAuth met 15 providers, TOTP MFA, magische links, eenmalige codes per e-mail en sms, en op rollen gebaseerde toegangscontrole, vanuit één SDK.
Wat aura-auth doet#
De service aura-auth geeft JWT's uit en valideert ze voor gebruikers in een project. De handtekening is standaard ES256, met een project-afgeleid geheim; RS256 (en het beschikbaar stellen van een JWKS) wordt alleen gebruikt als er een RSA-sleutel is geconfigureerd. Dit is een opt-in, niet het standaardgedrag. Het beheert de volledige levenscyclus: registratie, e-mailverificatie, MFA, vernieuwingstokenrotatie, intrekking aan de serverzijde.
Elk token bevat sub, project_id, role (anon of authenticated), email en een app_metadata-object dat uw claims aan de serverzijde draagt (tenant, roles). De gateway injecteert deze claims in Postgres-verbindingen via request.jwt.claims, waardoor RLS-beleid rechtstreeks toegankelijk wordt voor auth.uid(), auth.role(), auth.tenant().
Gebruikerstabellen zijn beschikbaar in project_{uuid}_auth: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.
Drie actoren, drie verantwoordelijkheden#
De klant tekent een uitdaging, de dienst bevraagt de database, de gateway valideert bij elk volgend verzoek.
# 1. Klant → aura-auth: inloggegevens
POST /v1/auth/login { email, password }
# 2. aura-auth: Argon2id verificatie + MFA indien nodig (status blijft 200)
if password OK && mfa_required → data = { mfa_required: true, mfa_token }
else → data = { access_token, refresh_token, user, ... }
# 3. Volgende verzoeken gaan via de gateway
apikey: <anon_key> + Authorization: Bearer <jwt>
gateway vérifie le JWT → claims injectés → Postgres RLS
Acht mechanismen klaar#
- E-mailadres + wachtwoord. Argon2id, optionele e-mailverificatie, beveiligde rotatie.
- OAuth 2.1 · PKCE. 15 providers: Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat.
- MFA TOTP. Authenticatie, 1Password, Google Authenticator. Terugval-sms.
- Magische links en OTP. E-mail zonder wachtwoord, i18n-sjablonen, tarieflimiet op adres.
- Granulaire RBAC. Rollen, machtigingen, organisatiehiërarchieën. Zelf gegenereerd RLS beleid.
- Sessiebinding. Apparaatvingerafdruk, IP-controle, tokens voor rotatievernieuwing.
Vier streams, één 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 }
}
Gebruik in Next.js App Router altijd de createServerClient-helper van @aurabase/aurabase-js/ssr bij serveracties en route-handlers. Het cookievernieuwingstoken is httpOnly en mag nooit door client JS worden gelezen.
Als u de SDK niet gebruikt#
Alle stromen worden ook weergegeven in onbewerkte REST, met dezelfde validaties aan de serverzijde. Zie /docs/api-rest voor de volledige lijst.
| Methode | Eindpunt | Beschrijving |
|---|---|---|
POST | /v1/auth/register | Maak een account aan met e-mailadres en wachtwoord |
POST | /v1/auth/login | Meld u aan met een wachtwoord |
GET | /v1/auth/oauth/{provider}/start | Een OAuth-stroom starten (PKCE) |
POST | /v1/auth/magic-link | Stuur een magische link |
POST | /v1/auth/email-otp/send | Stuur een eenmalige code per e-mail |
POST | /v1/auth/mfa/setup | Schrijf een TOTP-factor in |
POST | /v1/auth/refresh | Vernieuw het tokenpaar |
GET | /v1/auth/me | Retourneer de huidige gebruiker |
GET | /v1/auth/sessions | Lijst actieve sessies |
DELETE | /v1/auth/sessions/{session_id} | Een sessie intrekken |
POST | /v1/auth/logout | Beëindig de huidige sessie |