Authenticeer gebruikers met de JavaScript SDK
De dagelijkse stromen van aura.auth, waarbij het gedrag van elke oproep wordt waargenomen tegen een lopende stapel.
Meld u aan en meld u aan#
import { createClient, isMfaChallenge } from '@aurabase/aurabase-js'
const aura = createClient(process.env.NEXT_PUBLIC_AURABASE_URL!, process.env.NEXT_PUBLIC_AURABASE_ANON_KEY!)
// Maak een account aan
const { data, error } = await aura.auth.signUp({ email: 'ada@example.com', password: 'a-long-passphrase' })
// Log in
const login = await aura.auth.signInWithPassword({ email: 'ada@example.com', password: 'a-long-passphrase' })
if (login.error) return showError(login.error.message)
if (login.data && isMfaChallenge(login.data)) return askForTotpCode(login.data.mfa_token)
// anders bestaat er nu een sessie
Beide oproepen retourneren dezelfde vorm. Bij succes bevat data access_token, refresh_token, expires_in (900 seconden) en de user en slaat de client de sessie voor u op. Het volgende verzoek is al geverifieerd.
Wat signUp doet, hangt af van uw projectinstellingen. In ons testproject werd de gebruiker meteen aangemeld met email_verified: false, en voor een project kan eerst bevestiging nodig zijn.
Storingen die u moet aanpakken, zoals opgemerkt:
| Bel | Fout |
|---|---|
| Verkeerd wachtwoord | 401, code: 'INVALID_CREDENTIALS', "Ongeldig e-mailadres of wachtwoord." |
| Ongeldige of verlopen link of code | 401, code: 'INVALID_OTP' |
| Anoniem inloggen wanneer het project dit niet toestaat | 403, FORBIDDEN |
signInAnonymously() maakt een gebruiker aan zonder e-mailadres, maar in een nieuw project is deze uitgeschakeld en retourneert 403 totdat u deze inschakelt in de auth-instellingen van het project. Een anonieme gebruiker heeft de rol authenticated (hij is eigenaar van de rijen: auth.uid() is ingesteld); vertel het los van een permanent account in uw beleid met auth.is_anonymous(), bijvoorbeeld een beperkend beleid using (not auth.is_anonymous()).
De sessie en zijn gebeurtenissen#
const { data: { session } } = await aura.auth.getSession() // geen netwerkoproep: leest de winkel
const { data: user } = await aura.auth.getUser() // vraagt de server
const { data: { subscription } } = aura.auth.onAuthStateChange(({ event, user }) => {
// evenement: 'INITIAL_SESSION' | 'SIGNED_IN' | 'TOKEN_REFRESHED' | 'USER_UPDATED' | 'SIGNED_OUT' | 'MFA_CHALLENGE'
})
subscription.unsubscribe()
Een echte run leverde deze reeks op: INITIAL_SESSION, SIGNED_IN (aanmelding), SIGNED_IN (aanmelding), USER_UPDATED, TOKEN_REFRESHED, SIGNED_OUT.
- De client vernieuwt het toegangstoken voordat het verloopt. Bel
aura.auth.refreshSession()om dit te forceren. getSession()is lokaal en snel: gebruik het voor rendering. GebruikgetUser()als u de huidige serverweergave van de gebruiker nodig heeft.- Om een sessie van elders (een cookie, een server) aan de client over te dragen, gebruikt u
setSession(accessToken, refreshToken). Een ongeldig paar wordt geweigerd en de vorige sessie blijft behouden. - Voor weergave op de server, zie Next.js App Router en SSR.
Profiel en wachtwoord#
// Metadata: geef het door in `data`
await aura.auth.updateUser({ data: { theme: 'dark', plan: 'free' } })
// → user.user_metadata is { plan: 'gratis', thema: 'donker' }, en getUser() retourneert hetzelfde
// Wijzig de e-mail: het adres verandert nog NIET
await aura.auth.updateUser({ email: 'new@example.com' })
// Er gaat een bevestigingslink naar het nieuwe adres. Totdat het wordt gebruikt, behoudt user.email de oude waarde.
// Bevestig met: aura.auth.verifyOtp({ type: 'email_change', token })
// Wijzig het wachtwoord
await aura.auth.updatePassword('a-new-long-passphrase', 'a-long-passphrase')
De server trekt alle sessies in wanneer het wachtwoord verandert. updatePassword wist de lokale sessie en zendt SIGNED_OUT uit: meld u opnieuw aan met het nieuwe wachtwoord. In een echte run was getSession() direct na het gesprek leeg en inloggen met het nieuwe wachtwoord werkte.
Wachtwoord vergeten: aura.auth.resetPasswordForEmail({ email }) verzendt de reset-e-mail. De gebruiker voltooit het vervolgens met verifyOtp({ type: 'recovery', token, password }).
Verwijder het account: aura.auth.deleteUser(password) vraagt om het huidige wachtwoord, verwijdert het account en wist de lokale sessie.
Links, codes en OAuth#
// Magische link per e-mail
await aura.auth.signInWithMagicLink({ email })
// → een algemeen bevestigingsbericht
// Het antwoord is hetzelfde, ongeacht of het account bestaat of niet: er lekken geen accounts.
// Eenmalige codes
await aura.auth.signInWithEmailOtp(email)
await aura.auth.signInWithSmsOtp(phone)
await aura.auth.verifyOtp({ type: 'email', email, code }) // ook: 'sms', 'magiclink', 'aanmelden', 'herstel', 'email_change'
// OAuth: canonieke handtekening of Supabase-compatibele objectvorm
const { data } = await aura.auth.signInWithOAuth('google', { redirectTo: 'https://app.example.com/callback' })
// of: wacht op aura.auth.signInWithOAuth({ provider: 'google', opties: { redirectTo: '...' } })
if (data?.url) window.location.href = data.url
signInWithOAuth retourneert de te openen URL; het navigeert niet vanzelf. De provider moet in het project zijn ingeschakeld en geconfigureerd, anders antwoordt de start-URL PROVIDER_NOT_CONFIGURED.
signInWithOAuth accepteert signInWithOAuth('google', { redirectTo }) of de objectvorm signInWithOAuth({ provider: 'google', options: { redirectTo } }). Beide syntaxis zijn volledig getypt en ondersteund.
Na de terugleiding leest de client de sessie zelf vanaf de URL (detectSessionInUrl). Voor de PKCE-stroom geeft u flowType: 'pkce' door, behoudt u de standaard permanente opslag en wisselt de client de code voor u uit.
Koppel een tweede provider aan een aangemeld account met linkIdentity(provider), vermeld deze met listIdentities() en verwijder er een met unlinkIdentity(identityId).
Authenticatie met meerdere factoren#
// 1. Inschrijven: via de aura.auth.mfa naamruimte of platte methode
const { data: enrol } = await aura.auth.mfa.enroll() // → {geheim, otpauth_url }
// 2. Bevestig met de eerste code uit de authenticator-app: je ontvangt herstelcodes
const { data: confirm } = await aura.auth.mfa.verifySetup(codeFromApp) // → { herstelcodes: [...] }
// 3. Vanaf nu levert inloggen een uitdaging op in plaats van een sessie
const login = await aura.auth.signInWithPassword({ email, password })
if (login.data && isMfaChallenge(login.data)) {
await aura.auth.mfa.verify({ mfa_token: login.data.mfa_token, code: codeFromApp })
}
mfa.unenroll(password) (of mfaUnenroll) schakelt het uit en mfa.regenerateRecoveryCodes(code) geeft nieuwe herstelcodes uit. Een uitdaging zendt MFA_CHALLENGE uit en er wordt geen sessie opgeslagen totdat mfaVerify slaagt.
Apparaten en sessies#
const { data } = await aura.auth.listSessions()
// [{ id, device_info, ip_address, aangemaakt_at, vervalt_at, last_used_at, is_current }, …]
await aura.auth.revokeSession(sessionId) // één apparaat uitloggen
await aura.auth.revokeAllSessions() // overal uitloggen, ook hier
await aura.auth.signOut() // alleen dit apparaat
is_current markeert de sessie die u gebruikt. signOut trekt het vernieuwingstoken op de server in als dat er is, wist de lokale sessie en verzendt SIGNED_OUT.
Gebruikers beheren#
Gebruikersbeheer heeft een service_role sleutel nodig. Het is alleen beschikbaar op de server: het lezen van aura.authAdmin in een browser levert een fout op.
import { createAdminClient } from '@aurabase/aurabase-js'
const admin = createAdminClient(process.env.NEXT_PUBLIC_AURABASE_URL!, process.env.AURABASE_SERVICE_ROLE_KEY!)
const { data: users } = await admin.authAdmin.listUsers({ limit: 20, search: 'ada' })
const { data: created } = await admin.authAdmin.createUser({ email: 'bob@example.com', password: 'a-long-passphrase', email_verified: true })
await admin.authAdmin.banUser(created!.id)
await admin.authAdmin.unbanUser(created!.id)
const { data: link } = await admin.authAdmin.generateLink(created!.id, 'magic') // → { link, token }
await admin.authAdmin.deleteUser(created!.id)
const { data: stats } = await admin.authAdmin.getUserStats() // → { totaal, geverifieerd, verbannen, mfa_enabled, new_7d }
generateLink accepteert 'magic', 'recovery' of 'invite'. De admin-client beheert ook de authenticatie-instellingen van het project (getSettings, updateSettings), e-mailsjablonen, sessies van elke gebruiker en het auditlogboek (getAuditLog). Elke methode wordt vermeld in de authenticatiereferentie.