Zum Inhalt springen
Aurabase-Logo
Aurabasis

Next.js App Router und SSR-Leitfaden

Schritt-für-Schritt-Architekturanleitung zur Integration von Aurabase in eine Next.js 15/16 App Router-Anwendung mit Serverkomponenten, Serveraktionen, Middleware und sicheren Sitzungen.

Anleitung10 Min. gelesenEbene MittelstufeÜberarbeitet am 19.08.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Das Aurabase SSR-Modell#

In modernen serverseitig gerenderten Anwendungen kann der Authentifizierungsstatus des Benutzers nicht im localStorage des Browsers gespeichert werden (für den Server nicht zugänglich). Aurabase synchronisiert die Sitzung automatisch in sicheren HTTP-Cookies.

Vollständige Abfrageisolation

createServerClient hat keinen gemeinsamen Status im Speicher. Jede Serveranfrage instanziiert einen isolierten Client, der mit den HTTP-Headern der Anfrage verbunden ist, wodurch absolute Sicherheit zwischen Benutzern gewährleistet wird (kein Risiko von Sitzungslecks).

Der 3-Säulen-App-Router#

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

// Next.js 16: Diese Datei heißt „proxy.ts“ und die Funktion heißt „proxy“.
// Next.js 15: Benennen Sie die Datei „middleware.ts“ und die Funktion „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
}

Automatische Verwaltung von Multi-Chunking#

Webbrowser begrenzen die Größe eines Cookies auf etwa 4 KB. Wenn ein JWT-Token oder Benutzermetadaten diesen Grenzwert überschreiten, teilt das @aurabase/aurabase-js/ssr-Modul die Last automatisch in mehrere nummerierte Cookies auf:

  • aura-<scope>-auth.0 (erste 3600 Bytes)
  • aura-<scope>-auth.1 (Rest der Sitzung)

Beim Lesen setzt der Server die Blöcke originalgetreu wieder zusammen, um den Zustand ohne Datenverlust oder Sitzungsunterbrechung wiederherzustellen.

Goldene Regeln in der Produktion#

HttpOnly- und SameSite-Attribute

Aktualisierungstoken-Cookies sollten niemals Client-JavaScript ausgesetzt werden, um XSS-Angriffe zu verhindern.

Rollenschlüsseldienst ausschließlich Server

Übergeben Sie Ihren AURABASE_SERVICE_ROLE_KEY NIEMALS an createBrowserClient oder Komponenten mit der Anweisung „use client“.

Aktualisieren Sie in der Middleware

Rufen Sie getUser() im Proxy auf (middleware.ts auf Next.js 15): Es erneuert die Token, bevor sie ablaufen, und fragt den Server, wer der Benutzer ist. Autorisieren Sie niemals eine Serveranfrage mit getSession(): Auf dem Server wird nur das Cookie gelesen, das der Browser fälschen kann.

Um weiter zu gehen#