ویرگول
ورودثبت نام
مصطفی رستگار
مصطفی رستگاربرنامه نویس کامپیوتر و ازین جور مسخره بازی ها!
مصطفی رستگار
مصطفی رستگار
خواندن ۷ دقیقه·۳ ماه پیش

راهنمای جامع مدیریت Token و Cache در Next.js 16

فهرست مطالب

  1. مقدمه

  2. معماری کلی

  3. مدیریت Token با Middleware

  4. مدیریت Cache با Next.js Cache

  5. اجرای Refresh در Frontend

  6. نکات امنیتی و بهینهسازی

  7. جمعبندی


مقدمه

در اپلیکیشنهای مدرن Next.js، مدیریت توکنهای احراز هویت و کش دادهها از چالشهای اساسی هستند. در این مقاله، یک راهحل یکپارچه برای مدیریت خودکار refresh token و کش دادهها در Next.js 16 ارائه میدهیم.

پیشنیازها

  • آشنایی با Next.js App Router

  • دانش پایه از React Server Components

  • آشنایی با JWT و مفاهیم احراز هویت


معماری کلی

معماری پیشنهادی شامل سه لایه اصلی است:

text

┌─────────────────────────────────────────────┐ │ Client Components │ │ (UI, Interactions, Refresh Button) │ └──────────────────┬──────────────────────────┘ │ ┌──────────────────▼──────────────────────────┐ │ Server Components │ │ (Data Fetching, Caching) │ └──────────────────┬──────────────────────────┘ │ ┌──────────────────▼──────────────────────────┐ │ Middleware Layer │ │ (Token Management, Authentication) │ └──────────────────┬──────────────────────────┘ │ ┌──────────────────▼──────────────────────────┐ │ External API │ │ (Backend Services) │ └─────────────────────────────────────────────┘

مدیریت Token با Middleware

1. ساختار Middleware

typescript

// middleware.ts import { NextResponse } from 'next/server'; import type { NextRequest } from 'next/server'; export async function middleware(request: NextRequest) { // 1. دریافت توکنها از کوکی const accessToken = request.cookies.get('access_token')?.value; const refreshToken = request.cookies.get('refresh_token')?.value; // 2. بررسی و تمدید توکن if (accessToken && await needsRefresh(accessToken)) { const newTokens = await refreshTokens(refreshToken); if (newTokens) { // 3. بهروزرسانی کوکیها و هدرها return updateRequestWithNewTokens(request, newTokens); } } // 4. ادامه درخواست با توکن موجود return addTokenToRequest(request, accessToken); } export const config = { matcher: ['/api/:path*', '/dashboard/:path*'], };

2. بررسی اعتبار توکن

typescript

async function needsRefresh(token: string): Promise<boolean> { try { // دیکود کردن JWT برای بررسی زمان انقضا const payload = JSON.parse(atob(token.split('.')[1])); const expiryTime = payload.exp * 1000; const timeToExpiry = expiryTime - Date.now(); // اگر کمتر از 5 دقیقه به انقضا باقی مانده، تمدید کن return timeToExpiry < 5 * 60 * 1000; } catch { return true; // در صورت خطا، توکن را نامعتبر در نظر بگیر } }

3. تمدید توکن

typescript

class TokenManager { private static refreshPromises = new Map<string, Promise<any>>(); static async refreshToken(refreshToken: string): Promise<any> { // جلوگیری از درخواستهای همزمان if (this.refreshPromises.has(refreshToken)) { return this.refreshPromises.get(refreshToken); } const promise = this.doRefresh(refreshToken); this.refreshPromises.set(refreshToken, promise); try { return await promise; } finally { this.refreshPromises.delete(refreshToken); } } private static async doRefresh(refreshToken: string) { const response = await fetch(`${process.env.API_BASE_URL}/auth/refresh`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ refresh_token: refreshToken }), }); if (!response.ok) { throw new Error('Failed to refresh token'); } return response.json(); } }

4. به روزرسانی درخواست با توکن جدید

typescript

function updateRequestWithNewTokens( request: NextRequest, newTokens: { access_token: string; refresh_token: string } ) { const response = NextResponse.next(); // تنظیم کوکیهای جدید response.cookies.set('access_token', newTokens.access_token, { httpOnly: true, secure: process.env.NODE_ENV === 'production', sameSite: 'lax', maxAge: 60 * 15, // 15 دقیقه path: '/', }); // اضافه کردن توکن به هدرهای درخواست const requestHeaders = new Headers(request.headers); requestHeaders.set('Authorization', `Bearer ${newTokens.access_token}`); return NextResponse.next({ request: { headers: requestHeaders }, }); }

مدیریت Cache با Next.js Cache

1. کش کردن داده ها با use cache

typescript

// app/dashboard/page.tsx import { cacheLife, cacheTag } from 'next/cache'; export async function getDashboardData(): Promise<Dashboard> { 'use cache'; cacheLife('minutes'); // کش به مدت 5 دقیقه cacheTag('dashboard_data'); // تگ برای invalidate کردن const response = await fetch('API_URL/dashboard', { headers: { 'Authorization': `Bearer ${await getToken()}`, }, }); if (!response.ok) { return {} as Dashboard; } return response.json(); }

2. Invalidate کردن کش

typescript

// app/actions/refresh.ts 'use server'; import { revalidateTag } from 'next/cache'; export async function refreshDashboard() { 'use server'; // پاک کردن کش با تگ مشخص revalidateTag('dashboard_data'); // در صورت نیاز، revalidate مسیرهای خاص // revalidatePath('/dashboard'); return { success: true }; }

3. ترکیب با Suspense برای تجربه کاربری بهتر

typescript

// app/dashboard/page.tsx import { Suspense } from 'react'; import { DashboardContent } from './DashboardContent'; import { DashboardSkeleton } from './DashboardSkeleton'; export default async function DashboardPage() { return ( <Suspense fallback={<DashboardSkeleton />}> <DashboardContent /> </Suspense> ); } // app/dashboard/DashboardContent.tsx async function DashboardContent() { const data = await getDashboardData(); return <DashboardView data={data} />; }

اجرای Refresh در Frontend

1. دکمه Refresh با استفاده از Server Actions

typescript

// app/dashboard/RefreshButton.tsx 'use client'; import { useTransition } from 'react'; import { useRouter } from 'next/navigation'; import { refreshDashboard } from '../actions/refresh'; interface RefreshButtonProps { className?: string; } export function RefreshButton({ className = '' }: RefreshButtonProps) { const router = useRouter(); const [isPending, startTransition] = useTransition(); const handleRefresh = () => { startTransition(async () => { // 1. پاک کردن کش await refreshDashboard(); // 2. ریفرش صفحه برای دریافت دادههای جدید router.refresh(); }); }; return ( <button ={handleRefresh} disabled={isPending} className={`px-4 py-2 bg-blue-500 text-white rounded hover:bg-blue-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors ${className}`} > {isPending ? ( <> <Spinner className="inline-block mr-2" /> Refreshing... </> ) : ( '🔄 Refresh' )} </button> ); } // کامپوننت Spinner ساده function Spinner({ className = '' }) { return ( <svg className={`animate-spin h-4 w-4 ${className}`} viewBox="0 0 24 24"> <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" fill="none" /> <path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z" /> </svg> ); }

2. استفاده در کامپوننت والد

typescript

// app/dashboard/page.tsx import { RefreshButton } from './RefreshButton'; export default async function DashboardPage() { const data = await getDashboardData(); return ( <div className="container mx-auto p-4"> <div className="flex justify-between items-center mb-6"> <h1 className="text-2xl font-bold">Dashboard</h1> <RefreshButton /> </div> <Suspense fallback={<DashboardSkeleton />}> <DashboardView data={data} /> </Suspense> </div> ); }

3. دکمه Refresh در کامپوننت های تو در تو

اگر نیاز دارید دکمه Refresh در کامپوننتهای عمیقتر قرار گیرد، از Context استفاده کنید:

typescript

// app/dashboard/RefreshContext.tsx 'use client'; import { createContext, useContext, useTransition } from 'react'; import { useRouter } from 'next/navigation'; import { refreshDashboard } from '../actions/refresh'; interface RefreshContextType { refresh: () => void; isRefreshing: boolean; } const RefreshContext = createContext<RefreshContextType | undefined>(undefined); export function RefreshProvider({ children }: { children: React.ReactNode }) { const router = useRouter(); const [isRefreshing, startTransition] = useTransition(); const refresh = () => { startTransition(async () => { await refreshDashboard(); router.refresh(); }); }; return ( <RefreshContext.Provider value={{ refresh, isRefreshing }}> {children} </RefreshContext.Provider> ); } export function useRefresh() { const context = useContext(RefreshContext); if (!context) { throw new Error('useRefresh must be used within RefreshProvider'); } return context; }

typescript

// app/dashboard/layout.tsx import { RefreshProvider } from './RefreshContext'; export default function DashboardLayout({ children, }: { children: React.ReactNode; }) { return <RefreshProvider>{children}</RefreshProvider>; }

typescript

// استفاده در هر کامپوننت عمیق 'use client'; import { useRefresh } from '../RefreshContext'; export function DeepComponent() { const { refresh, isRefreshing } = useRefresh(); return ( <button ={refresh} disabled={isRefreshing}> Refresh from deep component </button> ); }

نکات امنیتی و بهینه سازی

1. تنظیمات امنیتی کوکی ها

typescript

const cookieOptions = { httpOnly: true, // جلوگیری از دسترسی JavaScript secure: process.env.NODE_ENV === 'production', // فقط HTTPS sameSite: 'lax' as const, // جلوگیری از CSRF path: '/', maxAge: 60 * 15, // 15 دقیقه برای access token };

2. Rate Limiting برای درخواست های Refresh

typescript

// utils/rateLimit.ts class RateLimiter { private requests: Map<string, number[]> = new Map(); isRateLimited(key: string, limit: number = 5, window: number = 60): boolean { const now = Date.now(); const windowStart = now - window * 1000; const timestamps = this.requests.get(key) || []; const recentRequests = timestamps.filter(t => t > windowStart); if (recentRequests.length >= limit) { return true; } recentRequests.push(now); this.requests.set(key, recentRequests); return false; } } // استفاده در middleware const rateLimiter = new RateLimiter(); if (rateLimiter.isRateLimited(request.ip || 'unknown')) { return new Response('Too many refresh requests', { status: 429 }); }

3. Logging و Monitoring

typescript

// utils/logger.ts export class Logger { static info(message: string, data?: any) { console.log(`[INFO] ${new Date().toISOString()} - ${message}`, data || ''); } static error(message: string, error?: any) { console.error(`[ERROR] ${new Date().toISOString()} - ${message}`, error || ''); } static warn(message: string, data?: any) { console.warn(`[WARN] ${new Date().toISOString()} - ${message}`, data || ''); } } // استفاده در middleware Logger.info('Token refresh successful', { userId: payload.sub });

4. Error Handling جامع

typescript

// middleware.ts async function handleRequest(request: NextRequest) { try { // پردازش اصلی return await processRequest(request); } catch (error) { if (error instanceof TokenExpiredError) { // هدایت به صفحه لاگین return NextResponse.redirect(new URL('/login', request.url)); } if (error instanceof NetworkError) { // تلاش مجدد با backoff return await retryWithBackoff(() => processRequest(request)); } // خطاهای غیرمنتظره Logger.error('Unhandled error in middleware', error); return NextResponse.next(); } }

جمعبندی

در این مقاله، یک راه حل کامل برای مدیریت خودکار توکنها و کش در Next.js 16 ارائه شد:

مزایای این معماری:

  1. مدیریت متمرکز Token: تمام درخواستها از middleware عبور کرده و توکن ها به صورت خودکار تمدید میشوند

  2. کش هوشمند: استفاده از use cache و revalidateTag برای بهینه سازی عملکرد

  3. تجربه کاربری روان: استفاده از Suspense و Server Actions برای به روزرسانی بدون ریلود

  4. امنیت بالا: ذخیره توکنها در کوکی های httpOnly با تنظیمات امنیتی مناسب

  5. قابلیت نگهداری: کد تمیز و ماژولار با جدا بودن لایه ها

بهترین Practices:

  • ✅ توکنها را در کوکیهای httpOnly ذخیره کنید

  • ✅ از revalidateTag برای invalidate کردن کش استفاده کنید

  • ✅ از Suspense برای مدیریت حالتهای loading استفاده کنید

  • ✅ Rate Limiting برای جلوگیری از حملات

  • ✅ Logging مناسب برای دیباگ و مانیتورینگ

  • ✅ استفاده از TypeScript برای type safety

cachenextjs
۰
۰
مصطفی رستگار
مصطفی رستگار
برنامه نویس کامپیوتر و ازین جور مسخره بازی ها!
شاید از این پست‌ها خوشتان بیاید