Naar de inhoud springen
Aurabase-logo
aurabasis

Next.js App Router & SSR-handleiding

Stapsgewijze architectuurgids voor het integreren van Aurabase in een Next.js 15/16 App Router-applicatie met servercomponenten, serveracties, middleware en beveiligde sessies.

Handleiding10 min lezenNiveau tussenproductHerzien op 19 aug 2026

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

Het Aurabase SSR-model#

In moderne server-side gerenderde applicaties kan de authenticatiestatus van de gebruiker niet worden opgeslagen in de localStorage van de browser (niet toegankelijk voor de server). Aurabase synchroniseert de sessie automatisch in beveiligde HTTP-cookies.

Volledige query-isolatie

createServerClient heeft geen gedeelde status in het geheugen. Bij elk serververzoek wordt een geïsoleerde client geïnstantieerd die is verbonden met de HTTP-headers van het verzoek, waardoor een absolute dichtheid tussen gebruikers wordt gegarandeerd (geen risico op sessielekken).

De 3 pijlers App Router#

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

// Next.js 16: dit bestand is `proxy.ts` en de functie heet `proxy`.
// Next.js 15: noem het bestand `middleware.ts` en de functie `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
}

Automatisch beheer van Multi-Chunking#

Webbrowsers beperken de grootte van een cookie tot ongeveer 4 KB. Wanneer een JWT-token of gebruikersmetagegevens deze limiet overschrijdt, splitst de @aurabase/aurabase-js/ssr-module de belasting automatisch op in verschillende genummerde cookies:

  • aura-<scope>-auth.0 (eerste 3600 bytes)
  • aura-<scope>-auth.1 (rest van sessie)

Bij het lezen stelt de server de chunks getrouw opnieuw samen om de status te herstellen zonder enig gegevensverlies of sessieonderbreking.

Gouden regels in de productie#

HttpOnly- en SameSite-kenmerken

Vernieuwingstokencookies mogen nooit worden blootgesteld aan client-JavaScript om XSS-aanvallen te voorkomen.

Rol Key-service strikt server

Geef NOOIT uw AURABASE_SERVICE_ROLE_KEY door aan createBrowserClient of componenten met de instructie "use client".

Vernieuwen in Middleware

Roep getUser() aan in de proxy (middleware.ts op Next.js 15): het vernieuwt de tokens voordat ze verlopen en vraagt de server wie de gebruiker is. Autoriseer nooit een serververzoek met getSession(): op de server leest het alleen de cookie, die de browser kan vervalsen.

Om verder te gaan#