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.
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.
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#
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.