İçeriğe geç
Aurabase Logosu
aura tabanı

Next.js Uygulama Yönlendiricisi ve SSR Kılavuzu

Aurabase'yi Sunucu Bileşenleri, Sunucu Eylemleri, Ara Yazılımlar ve güvenli oturumlarla Next.js 15/16 Uygulama Yönlendiricisi uygulamasına entegre etmeye yönelik adım adım mimari kılavuz.

Nasıl yapılır kılavuzu10 dk. okuSeviye orta düzey19 Ağu 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

Aurabase SSR modeli#

Sunucu tarafıyla oluşturulan modern uygulamalarda, kullanıcının kimlik doğrulama durumu tarayıcının localStorage (sunucu tarafından erişilemez) konumunda depolanamaz. Aurabase, oturumu güvenli HTTP çerezleri ile otomatik olarak senkronize eder.

Tam sorgu izolasyonu

createServerClient bellekte paylaşılan durum içermez. Her sunucu isteği, isteğin HTTP üstbilgilerine bağlı yalıtılmış bir istemciyi başlatır ve kullanıcılar arasında mutlak sıkılığı garanti eder (sıfır oturum sızıntısı riski).

3 sütunlu Uygulama Yönlendiricisi#

proxy.tstypescript
import { createServerClient } from '@aurabase/aurabase-js/ssr'
import { NextResponse, type NextRequest } from 'next/server'

// Next.js 16: bu dosya `proxy.ts`dir ve işlevin adı `proxy`dir.
// Next.js 15: 'middleware.ts' dosyasını ve 'middleware' işlevini adlandırın.
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
}

Çoklu Parçalamanın otomatik yönetimi#

Web tarayıcıları bir çerezin boyutunu yaklaşık 4 KB ile sınırlar. Bir JWT belirteci veya kullanıcı meta verileri bu sınırı aştığında, @aurabase/aurabase-js/ssr modülü yükü otomatik olarak birkaç numaralı çerezlere böler:

  • aura-<scope>-auth.0 (ilk 3600 bayt)
  • aura-<scope>-auth.1 (oturumun geri kalanı)

Okuduktan sonra sunucu, herhangi bir veri kaybı veya oturum kesintisi olmadan durumu geri yüklemek için parçaları sadık bir şekilde yeniden birleştirir.

Üretimde altın kurallar#

HttpOnly ve SameSite özellikleri

XSS saldırılarını önlemek için belirteç tanımlama bilgilerini yenileyin, hiçbir zaman istemci JavaScript'ine maruz bırakılmamalıdır.

Rol Anahtarı hizmeti kesinlikle sunucu

AURABASE_SERVICE_ROLE_KEY'inizi ASLA createBrowserClient'a veya "istemciyi kullan" direktifiyle bileşenlere aktarmayın.

Ara Yazılımda Yenile

Proxy'de getUser() öğesini çağırın (Next.js 15'te middleware.ts): süreleri dolmadan belirteçleri yeniler ve sunucuya kullanıcının kim olduğunu sorar. Bir sunucu isteğine asla getSession() ile yetki vermeyin: sunucuda yalnızca tarayıcının taklit edebileceği çerezi okur.

Daha ileri gitmek için#