Naar de inhoud springen
Aurabase-logo
aurabasis

Authenticatie

OAuth met 15 providers, TOTP MFA, magische links, eenmalige codes per e-mail en sms, en op rollen gebaseerde toegangscontrole, vanuit één SDK.

Uitleg7 min lezenNiveau tussenproductHerzien op 15 apr 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

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().

Info

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.

inlogstroomtext
# 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#

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 }
}
Sessie aan de serverzijde

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.

MethodeEindpuntBeschrijving
POST/v1/auth/registerMaak een account aan met e-mailadres en wachtwoord
POST/v1/auth/loginMeld u aan met een wachtwoord
GET/v1/auth/oauth/{provider}/startEen OAuth-stroom starten (PKCE)
POST/v1/auth/magic-linkStuur een magische link
POST/v1/auth/email-otp/sendStuur een eenmalige code per e-mail
POST/v1/auth/mfa/setupSchrijf een TOTP-factor in
POST/v1/auth/refreshVernieuw het tokenpaar
GET/v1/auth/meRetourneer de huidige gebruiker
GET/v1/auth/sessionsLijst actieve sessies
DELETE/v1/auth/sessions/{session_id}Een sessie intrekken
POST/v1/auth/logoutBeëindig de huidige sessie

Om verder te gaan#