راهنمای کامل احراز هویت در Node.js

آیا تا به حال به این فکر کرده‌اید که چگونه وب‌سایت‌ها کاربران خود را می‌شناسند؟ چگونه اطلاعات شخصی و داشبوردهای مدیریتی را فقط به افراد مجاز نمایش می‌دهند؟ پاسخ در یک مفهوم کلیدی نهفته است: احراز هویت. 🔐 پیاده‌سازی سیستم ثبت نام کاربر یکی از اولین و حیاتی‌ترین قدم‌ها در ساخت اکثر برنامه‌های وب مدرن است. در این راهنمای جامع، ما به صورت گام به گام، فرایند احراز هویت در Node.js را با استفاده از ابزارهای قدرتمندی مانند Express، MongoDB و Passport.js بررسی خواهیم کرد. بیایید شروع کنیم!

چرا احراز هویت در Node.js حیاتی است؟

احراز هویت (Authentication) صرفاً یک ویژگی فنی نیست؛ بلکه سنگ بنای اعتماد و امنیت در دنیای دیجیتال است. بدون یک سیستم ثبت نام و ورود امن، برنامه شما در برابر انواع تهدیدات آسیب‌پذیر خواهد بود. در ادامه به مهم‌ترین مزیت‌های آن اشاره می‌کنیم:

🛡️ امنیت داده‌ها: مهم‌ترین دلیل، حفاظت از اطلاعات حساس کاربران و جلوگیری از دسترسی‌های غیرمجاز است.
👤 شخصی‌سازی تجربه کاربری: با شناسایی کاربران، می‌توانید محتوا، پیشنهادات و داشبوردهای شخصی‌سازی شده به آن‌ها ارائه دهید.
📊 تحلیل رفتار کاربر: شما می‌توانید فعالیت‌های کاربران ثبت‌نام شده را ردیابی کرده و برای بهبود سرویس خود از این داده‌ها استفاده کنید.
🔒 کنترل دسترسی: امکان تعریف سطوح دسترسی مختلف (مانند کاربر عادی، ویرایشگر، مدیر) را فراهم می‌کند.

پیش‌نیازهای شروع پروژه

قبل از اینکه وارد کدنویسی شویم، مطمئن شوید که ابزارهای زیر روی سیستم شما نصب شده‌اند:

Node.js و npm: هسته اصلی پلتفرم ما.
MongoDB: پایگاه داده NoSQL برای ذخیره‌سازی اطلاعات کاربران.
یک ویرایشگر کد: مانند VS Code.

گام به گام تا ساخت سیستم احراز هویت در Node.js

حالا به بخش جذاب ماجرا می‌رسیم. ما یک پروژه از صفر ایجاد می‌کنیم و تمام مراحل را با هم طی می‌کنیم.

گام اول: راه‌اندازی پروژه و نصب پکیج‌ها

ابتدا یک پوشه جدید برای پروژه خود بسازید (مثلاً site-auth) و در ترمینال دستور زیر را اجرا کنید تا فایل package.json ایجاد شود:

bash

npm init -y

سپس، پکیج‌های مورد نیاز را با دستور زیر نصب می‌کنیم. هر یک از این پکیج‌ها وظیفه خاصی را بر عهده دارند.

bash

npm install express mongoose bcryptjs passport passport-local express-session connect-flash joi

express: فریمورک وب برای ساخت سرور.
mongoose: ابزاری برای مدل‌سازی داده‌ها در MongoDB.
bcryptjs: برای هش کردن امن رمزهای عبور.
passport: میان‌افزار قدرتمند برای احراز هویت در Node.js.
joi: برای اعتبارسنجی داده‌های ورودی کاربر.

گام دوم: پیکربندی اولیه سرور Express

یک فایل به نام app.js ایجاد کرده و کدهای زیر را برای راه‌اندازی اولیه سرور در آن قرار دهید.

javascript

// app.js
const express = require('express');
const mongoose = require('mongoose');
const session = require('express-session');
const flash = require('connect-flash');
const passport = require('passport');

// ۱. اتصال به پایگاه داده MongoDB
mongoose.connect('mongodb://localhost:27017/site-auth')
    .then(() => console.log('MongoDB Connected!'))
    .catch(err => console.log(err));

const app = express();

// ۲. تنظیمات میان‌افزارها (Middlewares)
app.use(express.json()); // جایگزین جدید برای body-parser
app.use(express.urlencoded({ extended: false }));

// ۳. تنظیمات Session
app.use(session({
    secret: 'a-very-secret-key', // یک کلید محرمانه برای امضای session
    resave: false,
    saveUninitialized: false,
    cookie: { maxAge: 60000 * 15 } // انقضای کوکی پس از ۱۵ دقیقه
}));

// ۴. راه‌اندازی Passport
app.use(passport.initialize());
app.use(passport.session());

// ۵. راه‌اندازی Flash Messages
app.use(flash());
app.use((req, res, next) => {
    res.locals.success_message = req.flash('success');
    res.locals.error_message = req.flash('error');
    next();
});

// ۶. تعریف روت‌ها (به زودی اضافه می‌شود)
app.use('/users', require('./routes/users'));

const PORT = process.env.PORT || 5000;
app.listen(PORT, () => console.log(`Server started on port ${PORT}!`));

توضیح کد: در این بخش، ما سرور Express را راه‌اندازی، به MongoDB متصل و میان‌افزارهای ضروری مانند session و passport را پیکربندی کردیم.

گام سوم: طراحی مدل کاربر (User Model) با Mongoose

برای ذخیره اطلاعات کاربران، به یک مدل یا Schema نیاز داریم. یک پوشه به نام models و درون آن فایلی به نام User.js بسازید.

javascript

// models/User.js
const mongoose = require('mongoose');
const bcrypt = require('bcryptjs');

const UserSchema = new mongoose.Schema({
    username: {
        type: String,
        required: true
    },
    email: {
        type: String,
        required: true,
        unique: true // هر ایمیل باید یکتا باشد
    },
    password: {
        type: String,
        required: true
    }
}, { timestamps: true }); // زمان ساخت و به‌روزرسانی را ثبت می‌کند

// هش کردن رمز عبور قبل از ذخیره‌سازی
UserSchema.pre('save', async function(next) {
    if (!this.isModified('password')) {
        return next();
    }
    try {
        const salt = await bcrypt.genSalt(10);
        this.password = await bcrypt.hash(this.password, salt);
        next();
    } catch (error) {
        next(error);
    }
});

const User = mongoose.model('User', UserSchema);
module.exports = User;

💡 نکته مهم: ما هرگز رمز عبور را به صورت متن ساده ذخیره نمی‌کنیم. تابع pre('save') قبل از هر بار ذخیره‌سازی، رمز عبور را با استفاده از bcryptjs به یک رشته درهم‌سازی شده (Hashed) تبدیل می‌کند.

گام چهارم: ایجاد روت‌ها (Routes) و منطق ثبت نام

اکنون زمان ساخت مسیرها برای دریافت درخواست‌های کاربر است. یک پوشه routes و درون آن فایل users.js را ایجاد کنید.

javascript

// routes/users.js
const express = require('express');
const router = express.Router();
const Joi = require('joi');
const User = require('../models/User'); // مدل کاربر را وارد می‌کنیم

// ۱. اسکیمای اعتبارسنجی با Joi
const userSchema = Joi.object({
    username: Joi.string().min(3).required(),
    email: Joi.string().email().required(),
    password: Joi.string().min(6).required(),
    confirmationPassword: Joi.any().valid(Joi.ref('password')).required()
});

// ۲. روت نمایش فرم ثبت‌نام (GET)
router.get('/register', (req, res) => {
    res.send('This is the registration form page.'); // در عمل اینجا یک فایل view رندر می‌شود
});

// ۳. روت پردازش اطلاعات فرم ثبت‌نام (POST)
router.post('/register', async (req, res) => {
    try {
        // اعتبارسنجی ورودی کاربر
        const { error, value } = userSchema.validate(req.body);
        if (error) {
            req.flash('error', error.details[0].message);
            return res.redirect('/users/register');
        }

        // بررسی تکراری نبودن ایمیل
        const userExists = await User.findOne({ email: value.email });
        if (userExists) {
            req.flash('error', 'این ایمیل قبلاً ثبت‌نام کرده است.');
            return res.redirect('/users/register');
        }

        // ایجاد کاربر جدید
        const newUser = new User({
            username: value.username,
            email: value.email,
            password: value.password // هش کردن به صورت خودکار توسط Mongoose hook انجام می‌شود
        });

        await newUser.save(); // ذخیره کاربر در دیتابیس

        req.flash('success', 'ثبت‌نام با موفقیت انجام شد! لطفاً وارد شوید.');
        res.redirect('/users/login');

    } catch (err) {
        console.error(err);
        res.status(500).send('Server Error');
    }
});

module.exports = router;

در این بخش، ما دو مسیر تعریف کردیم: یکی برای نمایش فرم ثبت نام و دیگری برای پردازش داده‌های ارسالی. منطق کد کاملاً واضح است: ابتدا داده‌ها را اعتبارسنجی می‌کنیم، سپس از عدم وجود کاربر با ایمیل مشابه مطمئن می‌شویم و در نهایت کاربر جدید را در پایگاه داده ذخیره می‌کنیم.

کاربردهای سیستم احراز هویت

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

🛒 فروشگاه‌های اینترنتی: ذخیره سوابق خرید، آدرس‌ها و لیست علاقه‌مندی‌های کاربر.
🎓 پلتفرم‌های آموزشی: ارائه دوره‌های خریداری شده و پیگیری پیشرفت دانشجو.
✍️ سیستم‌های مدیریت محتوا (CMS): تعریف نقش‌های مختلف مانند نویسنده، ویرایشگر و مدیر.
💬 شبکه‌های اجتماعی: ایجاد پروفایل کاربری، ارتباط با دوستان و انتشار محتوا.
💼 داشبوردهای مدیریتی: نمایش اطلاعات و ابزارهای خاص به مدیران و کارمندان یک سازمان.

ثبت‌نام سریع و امن با API

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

مراحل ثبت‌نام و استفاده از یک سرویس API احراز هویت:

✅ ثبت‌نام در پلتفرم: به وب‌سایت ارائه‌دهنده سرویس مانند p.api.ir مراجعه و یک حساب کاربری ایجاد کنید.
🔑 دریافت کلید API: پس از ثبت‌نام، یک کلید API منحصر به فرد دریافت خواهید کرد.
🔗 اتصال به برنامه: با استفاده از مستندات سرویس، SDK یا درخواست‌های HTTP، سیستم احراز هویت را به برنامه Node.js خود متصل کنید.

این روش به شما اجازه می‌دهد تا روی منطق اصلی کسب‌وکار خود تمرکز کنید و دغدغه‌های امنیتی را به متخصصان بسپارید.

جمع‌بندی و گام‌های بعدی

تبریک می‌گوییم! 🎉 شما با موفقیت اصول اولیه و مراحل عملی پیاده‌سازی سیستم ثبت نام کاربر در Node.js را یاد گرفتید. ما یک پروژه را از صفر راه‌اندازی کردیم، مدل کاربر را طراحی نمودیم، رمز عبور را به صورت امن هش کردیم و منطق اعتبارسنجی و ذخیره‌سازی کاربر را نوشتیم.

این تنها اولین قدم در دنیای بزرگ احراز هویت است. گام بعدی شما می‌تواند پیاده‌سازی سیستم ورود کاربر (Login) با استفاده از Passport.js و استراتژی Local باشد.

آیا این آموزش برای شما مفید بود؟ اگر سوال یا نظری دارید، حتماً در بخش دیدگاه‌ها با ما در میان بگذارید.