المستخدمون والأمان

API مفتوح للجميع يعني أن أي شخص يستطيع حذف بياناتك. في هذا الفصل تضيف المستخدمين وتسجيل الدخول، وتحمي المسارات، وتغلق أشهر الثغرات.

التسجيل وتشفير كلمات المرور

لا تحفظ كلمة المرور كما هي أبدًا. احفظ «بصمتها» (Hash) بخوارزمية بطيئة مصممة لذلك:

npm install bcryptjs
create table users (
  id serial primary key,
  email text not null unique,
  password_hash text not null,
  created_at timestamptz not null default now()
);
import bcrypt from "bcryptjs";

app.post("/api/register", async (req, res) => {
  const email = String(req.body?.email ?? "").trim().toLowerCase();
  const password = String(req.body?.password ?? "");
  if (password.length < 8) return res.status(400).json({ error: "كلمة المرور 8 أحرف على الأقل" });

  const hash = await bcrypt.hash(password, 12);
  try {
    await pool.query("insert into users (email, password_hash) values ($1, $2)", [email, hash]);
    res.status(201).json({ ok: true });
  } catch {
    res.status(409).json({ error: "هذا البريد مسجّل من قبل" });
  }
});

إذا تسرّبت قاعدة البيانات يومًا، لن يحصل المهاجم على كلمات المرور نفسها.

تسجيل الدخول بـ JWT

بعد التحقق من كلمة المرور يعطي الخادم المستخدم «تذكرة» موقّعة (JWT) يرسلها مع كل طلب:

npm install jsonwebtoken
import jwt from "jsonwebtoken";

app.post("/api/login", async (req, res) => {
  const email = String(req.body?.email ?? "").trim().toLowerCase();
  const { rows } = await pool.query("select * from users where email = $1", [email]);
  const user = rows[0];
  const valid = user && (await bcrypt.compare(String(req.body?.password ?? ""), user.password_hash));

  if (!valid) return res.status(401).json({ error: "البريد أو كلمة المرور غير صحيحة" });

  const token = jwt.sign({ sub: String(user.id) }, process.env.JWT_SECRET, { expiresIn: "7d" });
  res.json({ token });
});

لاحظ أن الرسالة واحدة سواء كان البريد غير موجود أو كلمة المرور خاطئة؛ لا تخبر المهاجم أي البريدين مسجّل عندك.

والبديل عن JWT هو الجلسات (Sessions) مع ملفات تعريف الارتباط؛ مناسبة جدًا عندما تكون الواجهة والخادم على نفس النطاق.

حماية المسارات

function requireUser(req, res, next) {
  const header = req.headers.authorization ?? "";
  const token = header.startsWith("Bearer ") ? header.slice(7) : "";
  try {
    req.userId = Number(jwt.verify(token, process.env.JWT_SECRET).sub);
    next();
  } catch {
    res.status(401).json({ error: "سجّل الدخول أولًا" });
  }
}

app.get("/api/tasks", requireUser, async (req, res) => {
  const { rows } = await pool.query("select * from tasks where user_id = $1", [req.userId]);
  res.json(rows);
});

كل مستخدم يرى مهامه فقط، لأن الاستعلام مقيد بـ user_id. انسَ هذا الشرط في مسار واحد، فيرى الجميع بيانات الجميع.

أساسيات الأمان: CORS وحدود الطلبات

npm install cors express-rate-limit helmet
import cors from "cors";
import helmet from "helmet";
import { rateLimit } from "express-rate-limit";

app.use(helmet()); // ترويسات أمان افتراضية
app.use(cors({ origin: "https://your-frontend.com" })); // واجهتك فقط

const loginLimiter = rateLimit({ windowMs: 15 * 60 * 1000, limit: 10 });
app.post("/api/login", loginLimiter, loginHandler);
  • CORS يحدد أي مواقع يُسمح لها باستدعاء الـ API من المتصفح.
  • حدود الطلبات تمنع تجربة آلاف كلمات المرور على حساب واحد.
  • وHTTPS إلزامي في الإنتاج؛ من دونه تمر التذكرة وكلمة المرور مكشوفة.

مهمتك

أضف التسجيل وتسجيل الدخول، واجعل كل مسارات المهام محمية ومقيدة بصاحبها. جرّب بـ Thunder Client: طلب دون تذكرة يعيد 401، ومستخدم لا يرى مهام غيره، وإحدى عشرة محاولة دخول خاطئة متتالية تعيد 429.