Next.js アプリルーターと SSR ガイド
サーバー コンポーネント、サーバー アクション、ミドルウェア、安全なセッションを備えた Next.js 15/16 App Router アプリケーションに Aurabase を統合するためのステップバイステップのアーキテクチャ ガイド。
Aurabase SSR モデル#
最新のサーバー側でレンダリングされるアプリケーションでは、ユーザーの認証状態をブラウザーの localStorage に保存できません (サーバーからアクセスできません)。 Aurabase は、セキュア HTTP Cookie でセッションを自動的に同期します。
createServerClient にはメモリ内に共有状態がありません。各サーバー要求は、要求の HTTP ヘッダーに接続された分離されたクライアントをインスタンス化し、ユーザー間の絶対的な緊密性を保証します (セッション リークのリスクがゼロ)。
アプリルーターの 3 つの柱#
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
}
マルチチャンクの自動管理#
Web ブラウザでは、Cookie のサイズが約 4 KB に制限されています。 JWT トークンまたはユーザー メタデータがこの制限を超えると、@aurabase/aurabase-js/ssr モジュールは負荷を番号付きのいくつかの Cookie に自動的に分割します。
aura-<scope>-auth.0(最初の 3600 バイト)aura-<scope>-auth.1(セッションの残り)
読み取り時に、サーバーはデータの損失やセッションの中断なしに状態を復元するために、チャンクを忠実に再構築します。
制作における黄金律#
HttpOnly および SameSite 属性
XSS 攻撃を防ぐために、リフレッシュ トークン Cookie をクライアント JavaScript に公開しないでください。
役割キーサービスは厳密にサーバーです
「use client」ディレクティブを使用して、AURABASE_SERVICE_ROLE_KEY を createBrowserClient またはコンポーネントに決して渡さないでください。
ミドルウェアで更新
プロキシで getUser() を呼び出します (Next.js 15 のmiddleware.ts)。有効期限が切れる前にトークンを更新し、サーバーにユーザーが誰であるかを尋ねます。 getSession() を使用してサーバー リクエストを許可しないでください。サーバー上ではブラウザが偽造できる Cookie のみが読み取られます。