Маршрутизатор приложений Next.js и руководство по SSR
Пошаговое архитектурное руководство по интеграции Aurabase в приложение Next.js 15/16 App Router с серверными компонентами, действиями сервера, промежуточным программным обеспечением и безопасными сеансами.
Модель Aurabase SSR#
В современных приложениях, отображаемых на стороне сервера, состояние аутентификации пользователя не может храниться в localStorage браузера (недоступно для сервера). Aurabase автоматически синхронизирует сеанс в безопасных файлах cookie HTTP.
createServerClient не имеет общего состояния в памяти. Каждый запрос сервера создает экземпляр изолированного клиента, подключенного к HTTP-заголовкам запроса, гарантируя абсолютную герметичность между пользователями (нулевой риск утечки сеанса).
Три столпа App Router#
import { createServerClient } from '@aurabase/aurabase-js/ssr'
import { NextResponse, type NextRequest } from 'next/server'
// Next.js 16: этот файл называется «proxy.ts», а функция называется «proxy».
// Next.js 15: назовите файл «middleware.ts» и функцию «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
}
Автоматическое управление многофрагментацией#
Веб-браузеры ограничивают размер файла cookie примерно 4 КБ. Когда токен JWT или метаданные пользователя превышают этот предел, модуль @aurabase/aurabase-js/ssr автоматически разделяет нагрузку на несколько пронумерованных файлов cookie:
aura-<scope>-auth.0(первые 3600 байт)aura-<scope>-auth.1(оставшаяся часть сеанса)
После чтения сервер добросовестно собирает фрагменты, чтобы восстановить состояние без потери данных или прерывания сеанса.
Золотые правила в производстве#
Атрибуты HttpOnly и SameSite
Файлы cookie токена обновления никогда не должны предоставляться клиентскому JavaScript для предотвращения XSS-атак.
Служба ролевых ключей строго серверная
НИКОГДА не передавайте свой AURABASE_SERVICE_ROLE_KEY в createBrowserClient или компоненты с директивой «use client».
Обновление в промежуточном программном обеспечении
Вызовите getUser() в прокси-сервере (middleware.ts в Next.js 15): он обновляет токены до истечения срока их действия и спрашивает сервер, кто является пользователем. Никогда не авторизуйте запрос к серверу с помощью getSession(): на сервере он только считывает файлы cookie, которые браузер может подделать.