Vai al contenuto
Logo Aurabase
aurabase

Autenticazione

OAuth con 15 provider, TOTP MFA, collegamenti magici, codici monouso tramite e-mail e SMS e controllo degli accessi basato sui ruoli, da un singolo SDK.

Spiegazione7 min lettoLivello intermedioRevisionato il 15 apr 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Cosa fa aura-auth#

Il servizio aura-auth emette e convalida i JWT per gli utenti in un progetto. La firma è ES256 per impostazione predefinita, con un segreto derivato dal progetto; RS256 (ed esponendo un JWKS) viene utilizzato solo se è configurata una chiave RSA: si tratta di un consenso esplicito, non del comportamento predefinito. Gestisce l'intero ciclo di vita: registrazione, verifica email, MFA, rotazione token di aggiornamento, revoca lato server.

Ogni token incorpora sub, project_id, role (anon o authenticated), email e un oggetto app_metadata che trasporta le tue attestazioni lato server (tenant, roles). Il gateway inserisce queste attestazioni nelle connessioni Postgres tramite request.jwt.claims, rendendo le policy RLS direttamente accessibili a auth.uid(), auth.role(), auth.tenant().

Informazioni

Le tabelle utente risiedono in project_{uuid}_auth: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.

Tre attori, tre responsabilità#

Il client firma una sfida, il servizio interroga il database, il gateway valida ad ogni richiesta successiva.

flusso di accessotext
# 1. Cliente → aura-auth: credenziali
POST /v1/auth/login  { email, password }

# 2. aura-auth: verifica Argon2id + MFA se richiesto (lo stato rimane 200)
if password OK && mfa_required  →  data = { mfa_required: true, mfa_token }
else                            →  data = { access_token, refresh_token, user, ... }

# 3. Le richieste successive passano attraverso il gateway
apikey: <anon_key>   +   Authorization: Bearer <jwt>
gateway vérifie le JWT  →  claims injectés → Postgres RLS

Otto meccanismi pronti#

  • E-mail + password. Argon2id, verifica email opzionale, rotazione sicura.
  • OAuth 2.1 · PKCE. 15 fornitori: Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat.
  • MFA TOTALE. Authy, 1Password, Google Authenticator. SMS di riserva.
  • Collegamenti magici e OTP. Email senza password, modelli i18n, limite di velocità per indirizzo.
  • RBAC granulare. Ruoli, autorizzazioni, gerarchie organizzative. Politiche RLS autogenerate.
  • Associazione della sessione. Impronta digitale del dispositivo, controllo IP, token di aggiornamento rotazione.

Quattro flussi, un 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 }
}
Sessione lato server

In Next.js App Router, utilizza sempre l'helper createServerClient di @aurabase/aurabase-js/ssr nelle azioni del server e nei gestori di route. Il token di aggiornamento del cookie è httpOnly e non dovrebbe mai essere letto dal client JS.

Se non stai utilizzando l'SDK#

Tutti i flussi sono esposti anche in REST non elaborato, con le stesse convalide lato server. Vedi /docs/api-rest per l'elenco completo.

MetodoPunto finaleDescrizione
POST/v1/auth/registerCrea un account con email e password
POST/v1/auth/loginAccedi con una password
GET/v1/auth/oauth/{provider}/startAvvia un flusso OAuth (PKCE)
POST/v1/auth/magic-linkInvia un collegamento magico
POST/v1/auth/email-otp/sendInvia un codice monouso tramite e-mail
POST/v1/auth/mfa/setupIscrivi un fattore TOTP
POST/v1/auth/refreshAggiorna la coppia di token
GET/v1/auth/meRestituisce l'utente corrente
GET/v1/auth/sessionsElenca le sessioni attive
DELETE/v1/auth/sessions/{session_id}Revoca una sessione
POST/v1/auth/logoutTermina la sessione corrente

Per andare oltre#