در این دوره‌ی جامع و عملی، به سراغ نسخه پنجم NextAuth می‌رویم و آن را به‌صورت کامل با App Router در Next.js 14 ترکیب می‌کنیم. این دوره مخصوص توسعه‌دهندگانی است که می‌خواهند احراز هویت امن، انعطاف‌پذیر و پیشرفته را با استفاده از تایپ‌اسکریپت به پروژه‌های خود اضافه کنند. از نصب و تنظیم اولیه تا پیاده‌سازی اعتبارنامه‌های سفارشی و اتصال به پایگاه داده، همه مراحل به‌صورت گام‌به‌گام آموزش داده می‌شود.

در پایان این دوره، شما قادر خواهید بود یک سیستم احراز هویت کامل و ایمن بسازید و در انواع پروژه‌های ریل‌تایم یا SSR (Server-Side Rendering) از آن بهره ببرید.

• مفاهیم پایه‌ای احراز هویت در وب و معرفی OAuth, JWT و کوکی‌های امن
• نصب و پیکربندی NextAuth v5 با استفاده از App Router در Next.js 14
• ایجاد اعتبارنامه‌های Credentials Provider برای ورود با ایمیل/رمز عبور
• استفاده از تایپ‌اسکریپت برای تعریف نوع (types) امن و جلوگیری از خطاهای زمان اجرا
• ارتباط با پایگاه داده (PostgreSQL، MongoDB یا Prisma) برای ذخیره‌سازی نشست‌ها و کاربران
• اعمال لایه‌های امنیتی مثل CSRF و rate-limiting
• نمونه عملی ساخت فرم ورود، ثبت‌نام و صفحه پروفایل با بررسی قدیمی بودن نشست
• استفاده از Middleware جدید App Router برای روت‌گاردی و حفاظت از مسیرهای خصوصی

• سرعت بالا در راه‌اندازی سیستم احراز هویت بدون نیاز به نوشتن تمام بخش‌ها از صفر
• پیاده‌سازی الگوهای استاندارد و به‌روز دنیای جاوااسکریپت و تایپ‌اسکریپت
• افزایش امنیت با استفاده از روش‌های مدرن و پیروی از بهترین شیوه‌ها
• کدنویسی تمیز، قابل نگهداری و قابل توسعه توسط تیم‌های بزرگ
• مستندات و مثال‌های عملی برای درک عمیق‌تر مفاهیم
• آمادگی برای گسترش و سفارشی‌سازی راهکار احراز هویت بر اساس نیاز پروژه

• آشنایی پایه با جاوااسکریپت (ES6+)
• دانش اولیه از React و Next.js
• آشنایی مختصر با تایپ‌اسکریپت برای تعریف انواع و اینترفیس‌ها
• درک مفاهیم پایه شبکه، HTTP و کوکی
• نصب Node.js (نسخه LTS یا بالاتر) و npm/yarn

• مقدمه و نصب اولیه: معرفی دوره، تنظیم محیط توسعه، نصب Next.js 14
• آشنایی با App Router: تغییرات جدید روتینگ، تعریف صفحات و API Routes
• نصب و تنظیم NextAuth v5: پیکربندی اولیه، فایل […nextauth].ts
• پیاده‌سازی Credentials Provider: نوشتن تابع authorize، کنترل خطاها و لاگ‌ها
• اتصال به پایگاه داده: استفاده از Prisma یا Mongoose برای ذخیره کاربران و سشن‌ها
• سفارشی‌سازی صفحات احراز هویت: فرم ورود، ثبت‌نام، فراموشی رمز عبور
• امنیت پیشرفته: محافظت از مسیرها، CSRF، Rate-Limiting
• Middleware در App Router: مدیریت Session در سمت سرور، Redirect خودکار
• مثال‌های عملی: پروژه نمونه با داشبورد و پروفایل کاربر
• جمع‌بندی و گام‌های بعدی: نکات بهبود، راه‌اندازی در محیط Production و انتشار

در این بخش، به یک مثال ساده اما کاربردی می‌پردازیم: ایجاد فرم ورود با اعتبارنامه‌های سفارشی. ابتدا یک صفحه به نام /app/login/page.tsx می‌سازیم:

import { getCsrfToken, signIn } from "next-auth/react";

export default async function LoginPage() {
  const csrfToken = await getCsrfToken();
  return (
    <form method="post" action="/api/auth/callback/credentials">
      <input name="csrfToken" type="hidden" defaultValue={csrfToken} />
      <input name="email" type="email" placeholder="ایمیل" required />
      <input name="password" type="password" placeholder="رمز عبور" required />
      <button type="submit">ورود</button>
    </form>
  );
}
  

در فایل /app/api/auth/[...nextauth]/route.ts تنظیمات زیر را اضافه می‌کنیم:

import NextAuth from "next-auth";
import CredentialsProvider from "next-auth/providers/credentials";

export const authOptions = {
  providers: [
    CredentialsProvider({
      name: "Credentials",
      credentials: { email: {}, password: {} },
      async authorize(credentials) {
        const user = await findUserByEmail(credentials.email);
        if (user && verifyPassword(credentials.password, user.hash)) {
          return { id: user.id, email: user.email };
        }
        return null;
      },
    }),
  ],
  session: { strategy: "jwt" },
  secret: process.env.NEXTAUTH_SECRET,
};

export default NextAuth(authOptions);
  

با این تنظیمات، فرم ورود شما بدون دردسر پاسخ داده می‌شود و سشن امن JWT برای کاربر صادر می‌گردد.

پس از پایان این دوره، شما به راحتی قادر خواهید بود سیستم احراز هویت سفارشی خود را توسعه داده، امنیت آن را افزایش دهید و در پروژه‌های پیچیده‌تر پیاده‌سازی کنید. پیشنهاد می‌شود برای گسترش مهارت خود:

• اتصال به سرویس‌های ثالث مانند Google, GitHub یا Discord با استفاده از Providers آماده
• پیاده‌سازی تأیید دو مرحله‌ای (2FA) با ارسال کد به ایمیل یا پیامک
• راه‌اندازی در محیط Production با بررسی نکات امنیتی SSL، CORS و مانیتورینگ
• نوشتن تست‌های واحد و یکپارچه برای پوشش بخش‌های احراز هویت

هم‌اکنون با دانلود این دوره و دنبال کردن مثال‌های عملی، سیستم احراز هویت قدرتمند خود را بسازید و در مسیر تبدیل شدن به یک متخصص Next.js و تایپ‌اسکریپت گام بردارید.