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.
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.
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#
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.