Next.js ऐप राउटर और एसएसआर गाइड
सर्वर घटकों, सर्वर क्रियाओं, मिडलवेयर और सुरक्षित सत्रों के साथ Next.js 15/16 ऐप राउटर एप्लिकेशन में Aurabase को एकीकृत करने के लिए चरण-दर-चरण वास्तुशिल्प मार्गदर्शिका।
Aurabase SSR मॉडल#
आधुनिक सर्वर-साइड रेंडर किए गए अनुप्रयोगों में, उपयोगकर्ता की प्रमाणीकरण स्थिति को ब्राउज़र के localStorage (सर्वर द्वारा पहुंच योग्य नहीं) में संग्रहीत नहीं किया जा सकता है। Aurabase सुरक्षित HTTP कुकीज़ में सत्र को स्वचालित रूप से सिंक्रनाइज़ करता है।
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
}
मल्टी-चंकिंग का स्वचालित प्रबंधन#
वेब ब्राउज़र कुकी का आकार लगभग 4 KB तक सीमित करते हैं। जब JWT टोकन या उपयोगकर्ता मेटाडेटा इस सीमा से अधिक हो जाता है, तो @aurabase/aurabase-js/ssr मॉड्यूल स्वचालित रूप से लोड को कई क्रमांकित कुकीज़ में विभाजित कर देता है:
aura-<scope>-auth.0(पहले 3600 बाइट्स)aura-<scope>-auth.1(शेष सत्र)
पढ़ने पर, सर्वर बिना किसी डेटा हानि या सत्र रुकावट के स्थिति को पुनर्स्थापित करने के लिए ईमानदारी से टुकड़ों को फिर से जोड़ता है।
उत्पादन में सुनहरे नियम#
केवल Http और सेमसाइट विशेषताएँ
XSS हमलों को रोकने के लिए रिफ्रेश टोकन कुकीज़ को कभी भी क्लाइंट जावास्क्रिप्ट के संपर्क में नहीं लाया जाना चाहिए।
भूमिका कुंजी सेवा सख्ती से सर्वर
अपने AURABASE_SERVICE_ROLE_KEY को कभी भी createBrowserClient या घटकों में "क्लाइंट का उपयोग करें" निर्देश के साथ पास न करें।
मिडलवेयर में रिफ्रेश करें
प्रॉक्सी में getUser() को कॉल करें (Next.js 15 पर middleware.ts): यह टोकन को समाप्त होने से पहले नवीनीकृत करता है और सर्वर से पूछता है कि उपयोगकर्ता कौन है। कभी भी सर्वर अनुरोध को getSession() से अधिकृत न करें: सर्वर पर यह केवल कुकी पढ़ता है, जिसे ब्राउज़र बना सकता है।