Przewodnik po routerze aplikacji Next.js i SSR
Przewodnik architektoniczny krok po kroku dotyczący integracji Aurabase z aplikacją routera aplikacji Next.js 15/16 ze składnikami serwera, akcjami serwera, oprogramowaniem pośredniczącym i bezpiecznymi sesjami.
Model Aurabase SSR#
W nowoczesnych aplikacjach renderowanych po stronie serwera stan uwierzytelnienia użytkownika nie może być przechowywany w localStorage przeglądarki (niedostępny dla serwera). Aurabase automatycznie synchronizuje sesję w bezpiecznych plikach cookie HTTP.
createServerClient nie ma w pamięci stanu współdzielonego. Każde żądanie serwera tworzy instancję izolowanego klienta podłączonego do nagłówków HTTP żądania, gwarantując absolutną szczelność między użytkownikami (zero ryzyka wycieków sesji).
Router aplikacji z trzema filarami#
import { createServerClient } from '@aurabase/aurabase-js/ssr'
import { NextResponse, type NextRequest } from 'next/server'
// Next.js 16: ten plik to `proxy.ts`, a funkcja nosi nazwę `proxy`.
// Next.js 15: nazwij plik `middleware.ts` i funkcję `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
}
Automatyczne zarządzanie Multi-Chunkingiem#
Przeglądarki internetowe ograniczają rozmiar pliku cookie do około 4 KB. Kiedy token JWT lub metadane użytkownika przekraczają ten limit, moduł @aurabase/aurabase-js/ssr automatycznie dzieli obciążenie na kilka ponumerowanych plików cookie:
aura-<scope>-auth.0(pierwsze 3600 bajtów)aura-<scope>-auth.1(reszta sesji)
Po odczycie serwer wiernie ponownie składa fragmenty, aby przywrócić stan bez utraty danych lub przerwania sesji.
Złote zasady w produkcji#
Atrybuty HttpOnly i SameSite
Pliki cookie tokenu odświeżania nigdy nie powinny być udostępniane JavaScriptowi klienta, aby zapobiec atakom XSS.
Usługa Role Key ściśle serwerowa
NIGDY nie przekazuj swojego AURABASE_SERVICE_ROLE_KEY do createBrowserClient lub komponentów z dyrektywą „use client”.
Odśwież w oprogramowaniu pośrednim
Wywołaj getUser() w proxy (middleware.ts w Next.js 15): odnawia tokeny przed ich wygaśnięciem i pyta serwer, kim jest użytkownik. Nigdy nie autoryzuj żądania serwera za pomocą metody getSession(): na serwerze odczytuje ona jedynie plik cookie, który może sfałszować przeglądarka.