Vai al contenuto
Logo Aurabase
aurabase

Router dell'app Next.js e guida SSR

Guida architettonica dettagliata per l'integrazione di Aurabase in un'applicazione App Router Next.js 15/16 con componenti server, azioni server, middleware e sessioni sicure.

Guida pratica10 min lettoLivello intermedioRevisionato il 19 ago 2026

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

Il modello SSR Aurabase#

Nelle moderne applicazioni renderizzate lato server, lo stato di autenticazione dell'utente non può essere archiviato nel localStorage del browser (inaccessibile dal server). Aurabase sincronizza automaticamente la sessione in modo sicuro cookie HTTP.

Isolamento completo delle query

createServerClient è senza stato condiviso in memoria. Ogni richiesta del server istanzia un client isolato collegato agli header HTTP della richiesta, garantendo assoluta tenuta tra gli utenti (zero rischi di perdite di sessione).

L'App Router a 3 pilastri#

proxy.tstypescript
import { createServerClient } from '@aurabase/aurabase-js/ssr'
import { NextResponse, type NextRequest } from 'next/server'

// Next.js 16: questo file è "proxy.ts" e la funzione si chiama "proxy".
// Next.js 15: denominare il file `middleware.ts` e la funzione `middleware`.
export async function proxy(request: NextRequest) {
  const response = NextResponse.next({ request })
  const aura = createServerClient(
    process.env.NEXT_PUBLIC_AURABASE_URL!,
    process.env.NEXT_PUBLIC_AURABASE_ANON_KEY!,
    {
      cookies: {
        getAll() { return request.cookies.getAll() },
        setAll(cookies) {
          cookies.forEach(({ name, value, options }) => {
            request.cookies.set(name, value)
            response.cookies.set(name, value, options)
          })
        },
      },
    })

  const { data: user } = await aura.auth.getUser()
  if (!user && request.nextUrl.pathname.startsWith('/dashboard')) {
    return NextResponse.redirect(new URL('/login', request.url))
  }
  return response
}

Gestione automatica del Multi-Chunking#

I browser Web limitano la dimensione di un cookie a circa 4 KB. Quando un token JWT o metadati utente supera questo limite, il modulo @aurabase/aurabase-js/ssr suddivide automaticamente il carico in diversi cookie numerati:

  • aura-<scope>-auth.0 (primi 3600 byte)
  • aura-<scope>-auth.1 (resto della sessione)

Durante la lettura, il server riassembla fedelmente i blocchi in modo da ripristinare lo stato senza alcuna perdita di dati o interruzione della sessione.

Regole d'oro nella produzione#

Attributi HttpOnly e SameSite

I cookie del token di aggiornamento non devono mai essere esposti al JavaScript del client per impedire attacchi XSS.

Ruolo Servizio chiave strettamente server

Non passare MAI il tuo AURABASE_SERVICE_ROLE_KEY in createBrowserClient o componenti con la direttiva "use client".

Aggiorna nel middleware

Chiama getUser() nel proxy (middleware.ts su Next.js 15): rinnova i token prima che scadano e chiede al server chi è l'utente. Non autorizzare mai una richiesta al server con getSession(): sul server legge solo il cookie, che il browser può falsificare.

Per andare oltre#