コンテンツへスキップ
オーラベースのロゴ
オーラベース

Next.js アプリルーターと SSR ガイド

サーバー コンポーネント、サーバー アクション、ミドルウェア、安全なセッションを備えた Next.js 15/16 App Router アプリケーションに Aurabase を統合するためのステップバイステップのアーキテクチャ ガイド。

ハウツーガイド10 分 読み取りレベル 中間2026/08/19 に改訂

このページは自動翻訳されました。英語版が正式です。

Aurabase SSR モデル#

最新のサーバー側でレンダリングされるアプリケーションでは、ユーザーの認証状態をブラウザーの localStorage に保存できません (サーバーからアクセスできません)。 Aurabase は、セキュア HTTP Cookie でセッションを自動的に同期します。

完全なクエリ分離

createServerClient にはメモリ内に共有状態がありません。各サーバー要求は、要求の HTTP ヘッダーに接続された分離されたクライアントをインスタンス化し、ユーザー間の絶対的な緊密性を保証します (セッション リークのリスクがゼロ)。

アプリルーターの 3 つの柱#

proxy.tstypescript
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 のみが読み取られます。

さらに進むには#