المحاضرة 8: التحكم بالوصول وأمن واجهات البرمجة
شرح المحاضرة + العرض التقديمي
المحاضرة 8 — التحكم بالوصول وأمن واجهات البرمجة ورفع الملفات
المساق: أمن الويب · المدة: ساعتان · المخرجات: مـ2، مـ3، مـ4
المختبر المرافق: المختبر 8 (التحكم بالوصول)
أهداف المحاضرة
- يفهم ثغرات التحكّم بالوصول (IDOR، تصعيد الصلاحيات).
- يميّز Path Traversal وSSRF.
- يطبّق رفع ملفات آمناً.
- يميّز مخاطر واجهات البرمجة وفق OWASP API Security Top 10 (2023)، ويحمي نقاط نهاية REST من BOLA وMass Assignment والاستهلاك غير المقيّد وأخطاء JWT وCORS.
بعد هذه المحاضرة يجب أن يستطيع الطالب: أن يكتب استعلاماً يتحقق من ملكية المورد على الخادم، وأن يضيف فحص الدور قبل الوظائف الإدارية، وأن يقرأ ملفاً من القرص دون السماح بالخروج من المجلد المسموح، وأن يبني صفحة رفع ملفات بطبقات حماية متعددة، وأن يشرح خطر SSRF وطرق الحدّ منه، وأن يراجع نقطة نهاية في واجهة برمجة (API) فيتحقق من الملكية والحقول المسموحة وحدود الاستهلاك والمصادقة.
تمهيد: من المصادقة إلى التفويض
في المحاضرة السابقة تعلّمنا المصادقة (Authentication): «من أنت؟». اليوم نتعلّم التفويض (Authorization) أو التحكم بالوصول (Access Control): «ماذا يحق لك أن تفعل، وعلى أي بيانات؟».
تشبيه يومي: في فندق، بطاقة الغرفة تثبت أنك نزيل (مصادقة)، لكنها يجب ألّا تفتح إلا غرفتك أنت (تفويض). لو فتحت البطاقة كل الغرف، فالمشكلة ليست في التحقق من هويتك، بل في قرار الباب: «هل هذا الشخص صاحب هذه الغرفة؟».
القاعدة الذهبية للمحاضرة: كل قرار صلاحية يُتَّخذ على الخادم، في كل طلب، ومن بيانات الجلسة الموثوقة — لا من شيء يرسله المتصفح ويستطيع المستخدم تعديله (رابط، حقل مخفي، كوكي غير موقّع، زر مخفي).
1. كسر التحكّم بالوصول (Broken Access Control)
أكثر الفئات شيوعاً في OWASP Top 10. يحدث عندما يستطيع المستخدم الوصول لموارد أو عمليات ليست من حقّه.
تحتل هذه الفئة المرتبة الأولى A01 — Broken Access Control في إصدارَي OWASP Top 10 لعامَي 2021 و2025، وفي إصدار 2025 أُدمجت فيها ثغرة SSRF (القسم 3) بعد أن كانت فئة مستقلة (A10) في إصدار 2021.
نماذج التحكم بالوصول باختصار
| النموذج |
الفكرة |
مثال |
| حسب الدور (RBAC — Role-Based Access Control) |
الصلاحيات مرتبطة بالدور |
طالب، مدرّس، مسجّل، مدير |
| حسب الملكية |
المستخدم يصل لما يملكه فقط |
الطالب يرى فواتيره هو |
| حسب الخصائص (ABAC — Attribute-Based Access Control) |
قرار مبني على خصائص متعددة |
المدرّس يعدّل علامات مساقاته فقط وخلال فترة الرصد |
مبادئ أساسية
- الرفض افتراضياً (Deny by Default): كل شيء ممنوع ما لم يُسمح به صراحة.
- أقل صلاحية (Least Privilege): امنح المستخدم أو الخدمة أقل صلاحيات تكفي لعملها.
- مركزية الفحص: اكتب منطق الصلاحيات في مكان واحد (Middleware أو دالة مشتركة) بدل تكراره في كل صفحة، فالتكرار يعني أن صفحة ما ستُنسى.
IDOR (الإشارة المباشرة غير الآمنة للكائنات)
عندما يُستخدَم معرّف يمكن التنبؤ به دون التحقّق من الملكية:
GET /invoice?id=123 ← فاتورتي
GET /invoice?id=124 ← فاتورة شخص آخر! (إن لم يُتحقَّق من الصلاحية)
الحماية: تحقّق دائماً على الخادم أن المورد المطلوب يخصّ المستخدم الحالي. لا تعتمد على إخفاء الروابط أو الأزرار.
الاسم بالإنجليزية: Insecure Direct Object Reference. «مباشرة» لأن المعرّف يشير مباشرة إلى سجل في قاعدة البيانات، و«غير آمنة» لأن الخادم لا يسأل: «هل هذا السجل لك؟».
كيف تحدث خطوة بخطوة:
- الطالب يسجّل الدخول ويفتح فاتورة رسومه:
/invoice?id=123.
- يلاحظ أن الرقم متسلسل، فيغيّره في شريط العنوان إلى
124.
- الخادم يتحقق فقط أن المستخدم «مسجّل دخول»، ثم ينفّذ
SELECT * FROM invoices WHERE id = 124.
- تظهر فاتورة طالب آخر باسمه ورقمه الجامعي وعنوانه.
سيناريو — متجر إلكتروني: صفحة «تفاصيل الطلب» تستخدم /api/orders/5001. بتغيير الرقم يمكن لأي عميل رؤية أسماء العملاء الآخرين وأرقام هواتفهم وعناوين التوصيل. لا يحتاج الأمر أي أداة متقدمة — مجرد تعديل رقم — ومع ذلك فهو تسريب بيانات شخصية لكل عملاء المتجر.
الكود الضعيف والآمن (PHP):
<?php
// ❌ ضعيف: يتحقق أن المستخدم مسجّل فقط، لا أن الفاتورة له
session_start();
if (!isset($_SESSION['user_id'])) { http_response_code(401); exit; }
$stmt = $pdo->prepare("SELECT * FROM invoices WHERE id = ?");
$stmt->execute([$_GET['id']]);
$invoice = $stmt->fetch();
<?php
// ✅ آمن: شرط الملكية داخل الاستعلام نفسه، وهوية المستخدم من الجلسة لا من الطلب
session_start();
if (!isset($_SESSION['user_id'])) { http_response_code(401); exit; }
$stmt = $pdo->prepare("SELECT * FROM invoices WHERE id = ? AND user_id = ?");
$stmt->execute([$_GET['id'], $_SESSION['user_id']]);
$invoice = $stmt->fetch();
if (!$invoice) {
http_response_code(404); // 404 بدل 403 حتى لا نؤكد وجود فاتورة لغيره
exit('غير موجود');
}
ملاحظة: استخدام معرّفات عشوائية طويلة (UUID) بدل الأرقام المتسلسلة يصعّب التخمين، لكنه ليس بديلاً عن فحص الملكية؛ فالمعرّف قد يتسرّب في رابط أو بريد أو سجل. الفحص على الخادم هو الحماية الحقيقية.
تصعيد الصلاحيات
- أفقي: الوصول لبيانات مستخدم آخر بنفس المستوى.
- رأسي: مستخدم عادي يصل لوظائف مدير.
تصعيد الصلاحيات (Privilege Escalation) بالتفصيل:
| النوع |
المثال |
سبب الثغرة |
| أفقي (Horizontal) |
طالب يرى علامات طالب آخر |
غياب فحص الملكية (IDOR غالباً) |
| رأسي (Vertical) |
طالب يفتح /admin/grades/edit ويعدّل العلامات |
غياب فحص الدور على الخادم، والاكتفاء بإخفاء الرابط من القائمة |
| عبر الحقول الإضافية (Mass Assignment) |
إرسال حقل role=admin مع نموذج تعديل الملف الشخصي |
الخادم يحفظ كل الحقول القادمة دون قائمة سماح |
لماذا لا يكفي إخفاء الزر؟ الواجهة الأمامية (HTML و JavaScript) موجودة كاملة على جهاز المستخدم، ويستطيع رؤية الروابط في الكود المصدري أو في أدوات المطوّر، أو إرسال الطلب مباشرة بأداة مثل Burp أو curl. إخفاء الزر تحسين لتجربة الاستخدام وليس حماية.
الكود الضعيف والآمن (Node.js / Express):
// ❌ ضعيف: المسار الإداري محمي فقط بعدم ظهور رابطه في القائمة
app.post('/admin/grades', async (req, res) => {
await db.updateGrade(req.body.studentId, req.body.grade);
res.send('تم');
});
// ❌ ضعيف: Mass Assignment — كل ما يرسله المستخدم يُحفظ، بما فيه role
app.post('/profile', async (req, res) => {
await db.users.update(req.session.userId, req.body);
});
// ✅ آمن: دالة وسيطة مركزية تفحص الدور من الجلسة في كل طلب
function requireRole(...roles) {
return (req, res, next) => {
const user = req.session.user; // من الجلسة الموثوقة، لا من الطلب
if (!user) return res.status(401).send('سجّل الدخول أولاً');
if (!roles.includes(user.role)) return res.status(403).send('غير مسموح');
next();
};
}
app.post('/admin/grades', requireRole('registrar', 'admin'), async (req, res) => {
await db.updateGrade(req.body.studentId, req.body.grade);
res.send('تم');
});
// ✅ آمن: قائمة سماح بالحقول القابلة للتعديل فقط
app.post('/profile', requireRole('student', 'teacher'), async (req, res) => {
const { phone, address } = req.body; // نتجاهل role وأي حقل آخر
await db.users.update(req.session.user.id, { phone, address });
res.send('تم الحفظ');
});
أخطاء شائعة
- الاعتماد على إخفاء الأزرار أو الروابط أو على فحص في JavaScript داخل المتصفح.
- أخذ هوية المستخدم أو دوره من معامل في الطلب (
?user_id= أو حقل مخفي) بدل الجلسة.
- حماية صفحة العرض ونسيان واجهة API التي تجلب البيانات نفسها.
- حماية
GET ونسيان POST أو PUT أو DELETE على المسار نفسه.
- قبول كل الحقول في نماذج التعديل (Mass Assignment).
أفضل الممارسات
- الرفض افتراضياً، وفحص مركزي في Middleware يُطبَّق على كل المسارات.
- شرط الملكية داخل الاستعلام (
AND user_id = ?).
- تسجيل محاولات الوصول المرفوضة (403) ومراقبة تكرارها.
- كتابة اختبارات آلية: «هل يستطيع المستخدم (أ) قراءة مورد المستخدم (ب)؟» يجب أن تفشل.
- المراجع: OWASP Authorization Cheat Sheet و OWASP Insecure Direct Object Reference Prevention Cheat Sheet.
2. Path Traversal (اجتياز المسار)
استغلال مدخل يُستخدم في مسار ملف للوصول لملفات خارج المجلد المسموح:
GET /download?file=../../../../etc/passwd
الحماية: تحقّق صارم من اسم الملف، قوائم سماح، منع ../، استخدام مسارات مطلقة آمنة.
كيف يحدث اجتياز المسار (Path Traversal) خطوة بخطوة
الرمز ../ في أنظمة الملفات يعني «اصعد مجلداً واحداً للأعلى».
- الموقع يعرض روابط تنزيل مثل
/download?file=syllabus.pdf.
- الكود يبني المسار هكذا:
"/var/www/files/" . $_GET['file'].
- إذا أُرسلت قيمة تحتوي
../ متكررة، يصبح المسار النهائي خارج مجلد files.
- الخادم يقرأ ملفاً من مكان آخر في النظام (ملف إعدادات فيه كلمة مرور قاعدة البيانات مثلاً) ويرسله.
/var/www/files/ + ../../../etc/passwd
│
▼ بعد تفسير ../ ثلاث مرات
/etc/passwd ← خارج المجلد المسموح تماماً
تشبيه: موظف أرشيف تقول له «أعطني الملف رقم 5 من درج المساقات»، فيلتزم. لكن لو قلت له «اخرج من الدرج، ثم من الخزانة، ثم من الغرفة، وافتح خزانة المدير»، ونفّذ دون تفكير — فهذه هي الثغرة.
سيناريو — بوابة جامعية: صفحة تنزيل خطط المساقات تقبل اسم الملف من الرابط. عبر اجتياز المسار يمكن الوصول إلى ملف config.php الذي يحوي بيانات الاتصال بقاعدة البيانات، فتصبح كل بيانات الطلاب في خطر.
الكود الضعيف والآمن (PHP):
<?php
// ❌ ضعيف: اسم الملف من المستخدم يُلصق في المسار مباشرة
$path = "/var/www/files/" . $_GET['file'];
readfile($path);
<?php
// ✅ الحل الأفضل: لا نقبل اسم ملف أصلاً، بل معرّفاً من قائمة سماح
$allowed = [
'syllabus' => 'syllabus.pdf',
'schedule' => 'schedule.pdf',
];
$key = $_GET['doc'] ?? '';
if (!isset($allowed[$key])) { http_response_code(404); exit('غير موجود'); }
readfile('/var/www/files/' . $allowed[$key]);
<?php
// ✅ عند الحاجة لأسماء متغيّرة: نحسب المسار الحقيقي ونتأكد أنه داخل المجلد
$base = realpath('/var/www/files');
$requested = realpath($base . DIRECTORY_SEPARATOR . basename($_GET['file'] ?? ''));
if ($requested === false || !str_starts_with($requested, $base . DIRECTORY_SEPARATOR)) {
http_response_code(404);
exit('غير موجود');
}
header('Content-Type: application/octet-stream');
header('X-Content-Type-Options: nosniff');
readfile($requested);
basename() تحذف أي مجلدات من الاسم وتُبقي اسم الملف فقط.
realpath() تحسب المسار النهائي بعد تفسير ../ والروابط الرمزية.
str_starts_with() (PHP 8+) تتأكد أن الناتج ما زال داخل المجلد الأساسي.
أخطاء شائعة
- حذف
../ بدالة استبدال بسيطة والاكتفاء بها (توجد صيغ ترميز مختلفة للمسار، لذا الفحص يجب أن يكون على المسار النهائي لا على النص الخام).
- الاعتماد على فحص الامتداد فقط (
.pdf) لمنع الاجتياز.
- تشغيل خادم الويب بصلاحيات واسعة تسمح بقراءة ملفات النظام كلها.
أفضل الممارسات
- استخدم معرّفات من قائمة سماح أو جدول في قاعدة البيانات بدل أسماء الملفات.
- إن اضطررت لأسماء:
basename + realpath + فحص البادئة.
- شغّل خادم الويب بمستخدم محدود الصلاحيات (Least Privilege).
- المرجع: صفحة Path Traversal في موقع OWASP (https://owasp.org).
3. SSRF (تزوير الطلب من جهة الخادم)
إجبار الخادم على إرسال طلب لوجهة يختارها المهاجم (غالباً للوصول لخدمات داخلية):
POST /fetch url=http://169.254.169.254/ ← بيانات حسّاسة للبنية التحتية
الحماية: قوائم سماح للوجهات، منع العناوين الداخلية، التحقّق من الـ URL.
لماذا SSRF خطيرة؟
تزوير الطلب من جهة الخادم (Server-Side Request Forgery) يحوّل خادمك إلى «وسيط» يعمل لصالح المهاجم. الخادم عادة موجود داخل الشبكة ويستطيع الوصول إلى أشياء لا يصل إليها الإنترنت: لوحات إدارة داخلية، قواعد بيانات، وخدمة البيانات الوصفية في السحابة (العنوان 169.254.169.254) التي قد تعطي مفاتيح وصول مؤقتة للبنية التحتية.
تشبيه: لا يستطيع غريب دخول مكتب المدير، لكنه يستطيع أن يطلب من موظف الاستقبال: «اذهب إلى مكتب المدير وأحضر لي الملف الأحمر». إذا نفّذ الموظف دون سؤال، فقد تجاوز الغريب كل الأبواب.
كيف تحدث خطوة بخطوة:
- الموقع يقدّم ميزة مفيدة: «ألصق رابط صورة وسنعرضها» أو «معاينة رابط».
- الخادم يأخذ الرابط من المستخدم ويرسل إليه طلباً بنفسه.
- بدل رابط صورة خارجي، يُرسَل عنوان داخلي (
http://localhost:8080/admin أو عنوان الشبكة الداخلية).
- الخادم يجلب المحتوى الداخلي ويعيده في الاستجابة، أو ينفّذ عملية على خدمة داخلية.
المهاجم ──► خادم الويب ──► خدمة داخلية (لا يصل إليها الإنترنت)
▲ │
└──── الاستجابة ◄────┘
سيناريو — متجر إلكتروني: ميزة «أضف صورة المنتج من رابط» في لوحة البائعين. بائع خبيث يضع عنواناً داخلياً بدل رابط الصورة، فيعيد الخادم محتوى لوحة مراقبة داخلية لا يُفترض أن يراها أحد من خارج الشركة.
الكود الضعيف والآمن (Node.js):
// ❌ ضعيف: الخادم يجلب أي رابط يرسله المستخدم
app.post('/preview', async (req, res) => {
const r = await fetch(req.body.url);
res.send(await r.text());
});
// ✅ أكثر أماناً: قائمة سماح بالنطاقات + HTTPS فقط + منع إعادة التوجيه
const ALLOWED_HOSTS = new Set(['images.example-cdn.com', 'cdn.example.org']);
app.post('/preview', async (req, res) => {
let target;
try {
target = new URL(req.body.url); // تحليل الرابط بمكتبة قياسية لا بالتعابير النصية
} catch {
return res.status(400).send('رابط غير صالح');
}
if (target.protocol !== 'https:' || !ALLOWED_HOSTS.has(target.hostname)) {
return res.status(400).send('هذه الوجهة غير مسموحة');
}
const r = await fetch(target, {
redirect: 'error', // لا نتبع إعادة التوجيه إلى وجهة أخرى
signal: AbortSignal.timeout(5000) // مهلة زمنية قصوى
});
if (!r.headers.get('content-type')?.startsWith('image/')) {
return res.status(415).send('نوع غير مدعوم');
}
res.type(r.headers.get('content-type')).send(Buffer.from(await r.arrayBuffer()));
});
أخطاء شائعة
- قائمة منع (منع
localhost فقط) بدل قائمة سماح؛ فهناك صيغ كثيرة للعناوين الداخلية يصعب حصرها.
- اتّباع إعادة التوجيه تلقائياً (رابط مسموح يعيد التوجيه إلى عنوان داخلي).
- إعادة محتوى الاستجابة الداخلية كاملاً للمستخدم، بما في ذلك رسائل الخطأ.
- السماح بأي بروتوكول (مثل
file://) بدل HTTPS فقط.
أفضل الممارسات
- قائمة سماح بالنطاقات والبروتوكولات، وتحليل الرابط بمكتبة URL قياسية.
- عند الحاجة لروابط عامة: التحقق من أن العنوان بعد تحويل DNS ليس عنواناً خاصاً أو محلياً.
- عزل الشبكة: الخادم الذي يجلب روابط خارجية لا يصل إلى الخدمات الداخلية الحساسة.
- في السحابة: تفعيل الإصدار المحمي من خدمة البيانات الوصفية (مثل IMDSv2 في AWS).
- المرجع: OWASP Server-Side Request Forgery Prevention Cheat Sheet.
4. رفع الملفات الآمن
مخاطر: رفع ملف تنفيذي (مثل shell.php) يؤدي لتنفيذ كود على الخادم.
الحماية (طبقات):
- تحقّق من نوع المحتوى الحقيقي لا الامتداد فقط.
- قائمة سماح بالامتدادات (صور فقط مثلاً).
- أعد تسمية الملف وخزّنه خارج جذر الويب.
- امنع تنفيذ السكربتات في مجلد الرفع.
- افحص الحجم والأبعاد.
4.1 لماذا رفع الملفات من أخطر الميزات؟
ميزة رفع الملفات (صورة شخصية، واجب جامعي، إيصال دفع) تعني أنك تسمح لشخص من الإنترنت بوضع ملف على خادمك. المخاطر الرئيسية:
| الخطر |
ما يحدث |
| تنفيذ كود عن بعد (RCE — Remote Code Execution) |
ملف PHP يُرفع داخل مجلد يمكن الوصول إليه من الويب، فيُنفَّذ عند طلبه |
| XSS مخزّن عبر الملفات |
ملف HTML أو SVG يحتوي سكربتاً يُعرض للمستخدمين من نطاق الموقع نفسه |
| استبدال ملفات |
اسم ملف يحتوي ../ أو اسم ملف موجود فيستبدله |
| حجب الخدمة (DoS) |
ملفات ضخمة جداً، أو صور بأبعاد هائلة، تستهلك القرص والذاكرة |
| برمجيات خبيثة |
ملفات مصابة يُنزلها مستخدمون آخرون |
تشبيه: مكتب البريد في الجامعة يستقبل طروداً من الجميع. المكتب الآمن يفحص حجم الطرد ونوعه الحقيقي، ويضع عليه رقماً جديداً، ويخزّنه في مستودع مغلق، ولا يسمح لأحد بـ«تشغيل» محتويات الطرد داخل المكتب.
سيناريو — بوابة جامعية: صفحة «رفع الواجب» تقبل أي ملف وتحفظه باسمه الأصلي في /uploads/ داخل جذر الموقع. يُرفع ملف PHP بدل ملف PDF، ثم يُطلب عبر الرابط فيُنفَّذ على الخادم، فيحصل المهاجم على تحكّم بالخادم وبكل ما عليه من بيانات.
4.2 لماذا لا يكفي فحص الامتداد أو Content-Type؟
- الامتداد جزء من اسم الملف، والاسم يختاره المستخدم.
- ترويسة
Content-Type في طلب الرفع يرسلها المتصفح أو أي أداة، فيمكن ضبطها على image/png لأي ملف.
- لذلك نفحص المحتوى الفعلي على الخادم (مثل
finfo في PHP التي تقرأ بداية الملف)، ونجعل الامتداد النهائي يحدّده الخادم بناءً على النوع المكتشف، ونجمع ذلك مع بقية الطبقات لأن أي فحص منفرد قد لا يكفي.
4.3 الكود الضعيف والآمن (PHP)
<?php
// ❌ ضعيف: يحفظ الملف باسمه الأصلي داخل جذر الويب دون أي فحص
move_uploaded_file($_FILES['file']['tmp_name'], 'uploads/' . $_FILES['file']['name']);
echo "تم الرفع: uploads/" . $_FILES['file']['name'];
<?php
// ✅ آمن: طبقات متعددة
const MAX_SIZE = 2 * 1024 * 1024; // 2 ميغابايت
const STORAGE = '/var/app_storage/uploads/'; // خارج جذر الويب
$allowed = ['image/jpeg' => 'jpg', 'image/png' => 'png', 'application/pdf' => 'pdf'];
$f = $_FILES['file'] ?? null;
if (!$f || $f['error'] !== UPLOAD_ERR_OK) { http_response_code(400); exit('فشل الرفع'); }
// 1) فحص الحجم
if ($f['size'] > MAX_SIZE) { http_response_code(413); exit('الملف كبير جداً'); }
// 2) فحص النوع الحقيقي من محتوى الملف (لا من الاسم ولا من Content-Type)
$mime = (new finfo(FILEINFO_MIME_TYPE))->file($f['tmp_name']);
if (!isset($allowed[$mime])) { http_response_code(415); exit('نوع غير مسموح'); }
// 3) اسم جديد عشوائي يولّده الخادم، والامتداد من قائمة السماح
$name = bin2hex(random_bytes(16)) . '.' . $allowed[$mime];
// 4) التخزين خارج جذر الويب
if (!move_uploaded_file($f['tmp_name'], STORAGE . $name)) { http_response_code(500); exit; }
// 5) نحفظ في قاعدة البيانات: الاسم الجديد + الاسم الأصلي (للعرض فقط) + صاحب الملف
$pdo->prepare("INSERT INTO uploads (user_id, stored_name, original_name, mime) VALUES (?, ?, ?, ?)")
->execute([$_SESSION['user_id'], $name, $f['name'], $mime]);
echo "تم الرفع بنجاح";
تقديم الملف لاحقاً بأمان (عبر سكربت يفحص الملكية — ربطاً بالقسم 1):
<?php
// ✅ ملكية + ترويسات تمنع المتصفح من تفسير الملف كصفحة
$stmt = $pdo->prepare("SELECT stored_name, mime FROM uploads WHERE id = ? AND user_id = ?");
$stmt->execute([$_GET['id'], $_SESSION['user_id']]);
$file = $stmt->fetch();
if (!$file) { http_response_code(404); exit; }
header('Content-Type: ' . $file['mime']);
header('X-Content-Type-Options: nosniff'); // لا تخمين لنوع المحتوى
header('Content-Disposition: attachment; filename="download"'); // تنزيل لا عرض
readfile('/var/app_storage/uploads/' . $file['stored_name']);
طبقة إضافية على مستوى الخادم: إذا اضطررت لإبقاء مجلد الرفع داخل جذر الويب، امنع تنفيذ السكربتات فيه (مثال لخادم Apache):
# إعداد خاص بمجلد الرفع: رفض طلب أي ملف سكربت
<FilesMatch "\.(php|phtml|phar)$">
Require all denied
</FilesMatch>
4.4 ملخص طبقات الحماية
| الطبقة |
ماذا تمنع |
| قائمة سماح بالأنواع + فحص المحتوى |
رفع ملفات تنفيذية أو HTML |
| اسم عشوائي يولّده الخادم |
استبدال الملفات واجتياز المسار في الاسم |
| التخزين خارج جذر الويب |
طلب الملف مباشرة وتنفيذه |
| منع التنفيذ في مجلد الرفع |
التنفيذ حتى لو تسرّب ملف سكربت |
| حدّ الحجم والأبعاد |
حجب الخدمة |
nosniff و attachment (ويُفضَّل نطاق منفصل للملفات) |
XSS عبر الملفات المرفوعة |
| فحص مضاد للفيروسات (عند الحاجة) |
نشر البرمجيات الخبيثة |
| إعادة معالجة الصور (Re-encoding) |
إزالة البيانات المخفية وبيانات الموقع (EXIF) |
أخطاء شائعة
- الثقة بالامتداد أو بـ
Content-Type القادم من المتصفح.
- قائمة منع (منع
.php فقط) بدل قائمة سماح.
- استخدام اسم الملف الأصلي كما هو في التخزين.
- حفظ الملفات في مجلد قابل للتنفيذ داخل جذر الويب.
- عرض ملفات SVG و HTML المرفوعة من نطاق الموقع الرئيسي.
أفضل الممارسات
- قائمة سماح صغيرة بما تحتاجه الميزة فعلاً (صور الملف الشخصي: JPEG و PNG فقط).
- اسم عشوائي وتخزين خارج جذر الويب، أو في خدمة تخزين منفصلة.
- تقديم الملفات عبر سكربت يفحص الصلاحية ويضيف ترويسات آمنة.
- المرجع: OWASP File Upload Cheat Sheet.
5. أمن واجهات البرمجة (API Security)
معظم التطبيقات الحديثة لم تعد صفحات PHP تولّد HTML كاملاً فقط، بل واجهة أمامية (تطبيق جوال أو صفحة SPA مبنية بـ React أو Vue) تتحدث مع واجهة برمجة (API) على الخادم تعيد بيانات بصيغة JSON. كل ما درسناه في الأقسام السابقة ينطبق على الـ API، لكن بخصوصية تجعلها سطح هجوم مستقلاً يستحق قسماً خاصاً.
5.1 ما هي واجهة REST/JSON؟
واجهة البرمجة (API — Application Programming Interface) هي مجموعة نقاط نهاية (Endpoints)، كل نقطة عبارة عن مسار + طريقة HTTP، تستقبل طلباً وتعيد بيانات منظّمة. في أسلوب REST تمثّل المسارات «موارد»، وتمثّل الطرق «العمليات»:
| الطلب |
المعنى |
GET /api/orders |
اعرض قائمة طلباتي |
GET /api/orders/5001 |
اعرض الطلب رقم 5001 |
POST /api/orders |
أنشئ طلباً جديداً |
PUT /api/orders/5001 |
عدّل الطلب 5001 |
DELETE /api/orders/5001 |
احذف الطلب 5001 |
مثال على استجابة JSON:
{ "id": 5001, "status": "shipped", "total": 120.5, "items": [ { "sku": "BK-12", "qty": 2 } ] }
5.2 لماذا الـ API سطح هجوم مختلف؟
- لا توجد واجهة تحدّ من المستخدم: في الموقع التقليدي يرى المستخدم أزراراً ونماذج. أما الـ API فيستطيع المهاجم استدعاءها مباشرة بـ curl أو Burp أو سكربت، متجاوزاً تطبيق الجوال أو الصفحة تماماً.
- منطق العرض انتقل إلى العميل: الخادم يرسل كائناً كاملاً، والواجهة الأمامية «تختار» ما تعرضه. ما لا يظهر على الشاشة قد يكون موجوداً في الاستجابة.
- المعرّفات ظاهرة في كل مكان:
/api/users/42/orders/7 — كل رقم فرصة لتجربة IDOR.
- التوثيق يكشف الخريطة: ملفات Swagger / OpenAPI تشرح كل نقطة نهاية ومعاملاتها، وهي مفيدة للمطوّر وللمهاجم معاً.
- عدد كبير من النقاط وإصدارات متعددة:
/v1 و /v2 ونقاط داخلية للجوال، وكثيراً ما تبقى نسخة قديمة غير محمية.
- الاستدعاء الآلي سهل: سكربت بسيط يرسل آلاف الطلبات في دقيقة، فغياب حدود الاستهلاك أخطر هنا من الموقع العادي.
تشبيه: الموقع التقليدي مثل مطعم فيه نادل يأخذ طلبك من القائمة. الـ API مثل نافذة المطبخ الخلفية: يستطيع أي شخص أن يطرقها ويطلب ما يشاء مباشرة. إن لم يتحقق الطاهي بنفسه من كل طلب، فلا قيمة لقائمة الطعام ولا للنادل.
قاعدة القسم: عامل كل نقطة نهاية في الـ API كأنها باب مستقل إلى قاعدة البيانات: تحقق فيه من المصادقة، والصلاحية، والملكية، والحقول المسموحة، وحدود الاستهلاك — بغضّ النظر عن «من المفترض» أن يستدعيها.
5.3 نظرة عامة: OWASP API Security Top 10 (2023)
نشرت OWASP قائمة مستقلة لمخاطر الـ API لأن أنماطها تختلف عن قائمة OWASP Top 10 لتطبيقات الويب:
| الرمز |
الفئة |
شرح مختصر |
| API1 |
Broken Object Level Authorization (BOLA) |
الوصول إلى كائن يخص مستخدماً آخر بتغيير معرّفه (IDOR في الـ API) |
| API2 |
Broken Authentication |
ضعف في المصادقة: رموز غير متحقق منها، كلمات مرور ضعيفة، عدم الحد من التخمين |
| API3 |
Broken Object Property Level Authorization |
قراءة أو تعديل خصائص لا يحق للمستخدم الوصول إليها (كشف البيانات الزائد + Mass Assignment) |
| API4 |
Unrestricted Resource Consumption |
لا حدود لعدد الطلبات أو حجمها أو عدد السجلات، فيُستنزف الخادم أو الفاتورة |
| API5 |
Broken Function Level Authorization |
مستخدم عادي يستدعي وظائف إدارية لأن الخادم لا يفحص الدور |
| API6 |
Unrestricted Access to Sensitive Business Flows |
إساءة استخدام عملية تجارية مشروعة آلياً (شراء كل التذاكر، إنشاء آلاف الحسابات) |
| API7 |
Server Side Request Forgery (SSRF) |
الـ API يجلب رابطاً يرسله المستخدم دون قيود (القسم 3) |
| API8 |
Security Misconfiguration |
إعدادات خاطئة: CORS متساهل، رسائل خطأ مفصّلة، ترويسات أمان ناقصة |
| API9 |
Improper Inventory Management |
نقاط نهاية قديمة أو تجريبية أو توثيق مكشوف لا يعرف الفريق بوجوده |
| API10 |
Unsafe Consumption of APIs |
الثقة العمياء ببيانات قادمة من واجهة طرف ثالث وعدم التحقق منها |
لاحظ أن ثلاثاً من أول خمس فئات هي مشكلات تفويض — أي امتداد مباشر للقسم 1 من هذه المحاضرة.
5.4 API1 — BOLA (كسر التفويض على مستوى الكائن)
BOLA (Broken Object Level Authorization) هي الاسم الذي تستخدمه OWASP لثغرة IDOR التي درسناها في القسم 1، لكن في سياق الـ API. هي الأكثر انتشاراً لأن كل نقطة نهاية تقريباً تستقبل معرّف كائن.
كيف تحدث خطوة بخطوة:
- تطبيق الجوال يفتح سلة المشتريات عبر
GET /api/baskets/7 ويعرضها.
- المهاجم يراقب حركة المرور (بأدوات المطوّر أو بـ Burp) ويرى الطلب.
- يكرّر الطلب نفسه مع
8 و 9 و 10.
- الخادم يتحقق أن الرمز صالح فقط، فيعيد سلال مستخدمين آخرين.
الكود الضعيف والآمن (Node.js / Express):
// ❌ ضعيف: المصادقة موجودة، لكن لا فحص للملكية
app.get('/api/baskets/:id', requireAuth, async (req, res) => {
const basket = await db.baskets.findById(req.params.id);
res.json(basket);
});
// ✅ آمن: الملكية جزء من الاستعلام، والهوية من الرمز الموثوق لا من الطلب
app.get('/api/baskets/:id', requireAuth, async (req, res) => {
const basket = await db.baskets.findOne({
id: req.params.id,
ownerId: req.user.id // req.user مستخرج من رمز تم التحقق من توقيعه
});
if (!basket) return res.status(404).json({ error: 'غير موجود' });
res.json(basket);
});
تذكّر: المعرّف العشوائي (UUID) يصعّب التخمين فقط. في الـ API بالذات تتسرّب المعرّفات بسهولة (في استجابات أخرى، في روابط المشاركة، في سجلات المتصفح)، لذا فحص الملكية في كل نقطة نهاية هو الحماية الحقيقية.
5.5 API3 — التفويض على مستوى الخصائص: كشف البيانات الزائد و Mass Assignment
تجمع هذه الفئة مشكلتين متقابلتين على خصائص (Properties) الكائن نفسه:
أ) كشف البيانات الزائد (Excessive Data Exposure) — في الاتجاه الخارج:
الخادم يعيد الكائن كاملاً من قاعدة البيانات، ويعتمد على الواجهة الأمامية لإخفاء ما لا تحتاجه.
// ❌ ضعيف: يعيد السجل كما هو، بما فيه تجزئة كلمة المرور والدور والرقم الوطني
app.get('/api/users/me', requireAuth, async (req, res) => {
const user = await db.users.findById(req.user.id);
res.json(user); // { id, name, email, passwordHash, role, nationalId, resetToken ... }
});
// ✅ آمن: نُرجع فقط الحقول التي تحتاجها الشاشة (قائمة سماح للمخرجات)
app.get('/api/users/me', requireAuth, async (req, res) => {
const u = await db.users.findById(req.user.id);
res.json({ id: u.id, name: u.name, email: u.email });
});
ب) الإسناد الجماعي (Mass Assignment) — في الاتجاه الداخل:
رأيناه في القسم 1 مع role=admin. في الـ API يكون أسهل لأن المهاجم يرسل JSON مباشرة ويضيف أي خاصية يخمّنها:
PATCH /api/users/me
Content-Type: application/json
{ "name": "Ali", "role": "admin", "isVerified": true, "balance": 99999 }
الكود الضعيف والآمن (PHP):
<?php
// ❌ ضعيف: كل مفاتيح JSON تتحول إلى أعمدة في التحديث
$data = json_decode(file_get_contents('php://input'), true);
$sets = implode(', ', array_map(fn($k) => "$k = ?", array_keys($data)));
$pdo->prepare("UPDATE users SET $sets WHERE id = ?")
->execute([...array_values($data), $_SESSION['user_id']]);
<?php
// ✅ آمن: قائمة سماح صريحة بالحقول القابلة للتعديل + تحقق من النوع والطول
$data = json_decode(file_get_contents('php://input'), true) ?? [];
$allowed = ['name', 'phone'];
$clean = array_intersect_key($data, array_flip($allowed)); // نتجاهل role و balance وأي حقل آخر
if (isset($clean['name']) && (!is_string($clean['name']) || mb_strlen($clean['name']) > 100)) {
http_response_code(400); exit(json_encode(['error' => 'اسم غير صالح']));
}
if (!$clean) { http_response_code(400); exit(json_encode(['error' => 'لا توجد حقول صالحة'])); }
$sets = implode(', ', array_map(fn($k) => "$k = ?", array_keys($clean)));
$pdo->prepare("UPDATE users SET $sets WHERE id = ?")
->execute([...array_values($clean), $_SESSION['user_id']]);
الفكرة المشتركة: استخدم كائنات نقل بيانات (DTO — Data Transfer Object) أو مخططات تحقق (Schema Validation) تحدد بدقة ما يُقبل وما يُرسل، ولا تربط كائن قاعدة البيانات بالطلب أو بالاستجابة مباشرة.
5.6 API5 — كسر التفويض على مستوى الوظيفة (Broken Function Level Authorization)
هذا هو التصعيد الرأسي في الـ API. المطوّر يحمي نقاط المدير بإخفائها من تطبيق المستخدم، لكن أسماءها قابلة للتخمين:
GET /api/users/me ← مسموح للجميع
GET /api/admin/users ← هل يفحص الخادم الدور؟
DELETE /api/users/15 ← مستخدم عادي يغيّر GET إلى DELETE
// ❌ ضعيف: نقطة إدارية تكتفي بالمصادقة
app.delete('/api/users/:id', requireAuth, async (req, res) => {
await db.users.delete(req.params.id);
res.sendStatus(204);
});
// ✅ آمن: الرفض افتراضياً — كل مسارات /api/admin تمر بفحص الدور مركزياً
const adminRouter = express.Router();
adminRouter.use(requireAuth, requireRole('admin')); // الدالة نفسها من القسم 1
adminRouter.get('/users', listUsers);
adminRouter.delete('/users/:id', deleteUser);
app.use('/api/admin', adminRouter);
نقطة مهمة: افحص الطريقة أيضاً لا المسار فقط؛ كثير من الثغرات تظهر لأن GET /api/users/15 محمي بينما DELETE على المسار نفسه منسيّ.
5.7 API4 — الاستهلاك غير المقيّد للموارد (Unrestricted Resource Consumption)
كل طلب يكلّف الخادم وقتاً وذاكرة، وربما مالاً (رسائل SMS، استدعاء خدمة مدفوعة). بدون حدود يستطيع مهاجم واحد:
- إرسال آلاف محاولات تسجيل الدخول أو رموز التحقق (OTP) لتخمينها.
- طلب
GET /api/products?limit=1000000 فيستنزف قاعدة البيانات.
- رفع ملفات ضخمة أو JSON متداخل بعمق كبير.
- تفعيل «أرسل رمز تحقق» آلاف المرات فترتفع فاتورة الرسائل.
// ❌ ضعيف: لا حد لعدد الطلبات، والعميل يحدد حجم الصفحة كما يشاء
app.get('/api/products', async (req, res) => {
res.json(await db.products.find().limit(Number(req.query.limit)));
});
// ✅ آمن: حد للطلبات + سقف لحجم الصفحة + حد لحجم الجسم
const rateLimit = require('express-rate-limit');
app.use(express.json({ limit: '100kb' })); // حد لحجم جسم الطلب
app.use('/api/', rateLimit({ windowMs: 60 * 1000, max: 100 })); // 100 طلب في الدقيقة لكل عنوان
app.use('/api/auth/', rateLimit({ windowMs: 15 * 60 * 1000, max: 10 })); // أشد على تسجيل الدخول
app.get('/api/products', async (req, res) => {
const limit = Math.min(Math.max(parseInt(req.query.limit) || 20, 1), 50); // بين 1 و 50
const page = Math.max(parseInt(req.query.page) || 1, 1);
res.json(await db.products.find().skip((page - 1) * limit).limit(limit));
});
تحديد المعدّل (Rate Limiting) يعيد الحالة 429 Too Many Requests عند تجاوز الحد. في الأنظمة الحقيقية يُطبَّق غالباً أيضاً في بوابة الـ API (API Gateway) أو الوكيل العكسي، ويُربط بالمستخدم أو بمفتاح الـ API لا بعنوان IP فقط.
5.8 المصادقة في الـ API: مفاتيح API أم رموز؟
| الأسلوب |
يمثّل |
الاستخدام المناسب |
الخطر الرئيسي |
| مفتاح API (API Key) |
تطبيقاً أو مشروعاً لا مستخدماً |
خادم يستدعي خادماً، وتحديد الاستهلاك والفوترة |
يُكتب داخل تطبيق الجوال أو JavaScript فيُستخرج بسهولة؛ غالباً بلا انتهاء |
| رمز وصول (Access Token / JWT) |
مستخدماً مصادَقاً وصلاحياته |
تطبيق جوال أو SPA يتحدث نيابة عن المستخدم |
سوء التحقق من التوقيع، عمر طويل، تخزين غير آمن |
| OAuth 2.0 |
تفويض تطبيق طرف ثالث بصلاحيات محدودة |
«سجّل الدخول عبر...» والتكامل بين الأنظمة |
إعدادات خاطئة لعناوين إعادة التوجيه والنطاقات (Scopes) |
قاعدة: مفتاح الـ API ليس وسيلة لمعرفة هوية المستخدم. أي سرّ موجود داخل تطبيق يُنزَّل على جهاز المستخدم يجب افتراض أنه مكشوف.
5.9 أخطاء JWT الشائعة في الـ API
درسنا في المحاضرة 7 مكوّنات JWT وطريقة التحقق الصحيحة منه بـ jwt.verify. في الـ API تتكرر الأخطاء التالية:
| الخطأ |
ما يحدث |
الإصلاح |
قبول alg: none أو عدم تحديد الخوارزمية |
يُرسَل رمز بلا توقيع ويقبله الخادم، فيضع المهاجم "role":"admin" بنفسه |
تحديد الخوارزمية صراحة: algorithms: ['HS256'] |
استخدام jwt.decode بدل jwt.verify |
الخادم يقرأ الرمز دون التحقق من الختم إطلاقاً |
التحقق من التوقيع دائماً قبل الثقة بأي مطالبة |
سرّ توقيع ضعيف (secret، 123456) |
يمكن تخمين السرّ دون اتصال (Offline) ثم توقيع أي رمز |
سرّ عشوائي طويل (32 بايت فأكثر) من متغيرات البيئة |
لا يوجد exp أو عمر طويل جداً |
الرمز المسروق يعمل لأشهر ولا يمكن إلغاؤه |
عمر قصير (دقائق) + رمز تحديث (Refresh Token) قابل للإلغاء |
التخزين في localStorage |
أي ثغرة XSS (المحاضرة 5) تسرق الرمز |
كوكي HttpOnly; Secure; SameSite عندما يكون ذلك ممكناً |
| بيانات حساسة في Payload |
الـ Payload مُرمَّز بـ Base64 وليس مشفّراً، فيقرؤه أي أحد |
لا تضع فيه إلا المعرّف والدور وما يلزم |
// ❌ ضعيف: يقبل أي خوارزمية، والسرّ مكتوب في الكود، والرمز بلا انتهاء
const token = jwt.sign({ id: user.id, role: user.role }, 'secret');
const claims = jwt.verify(req.headers.authorization.split(' ')[1], 'secret');
// ✅ آمن (منسجم مع المحاضرة 7)
const SECRET = process.env.JWT_SECRET;
const token = jwt.sign({ sub: user.id, role: user.role }, SECRET,
{ algorithm: 'HS256', expiresIn: '15m', audience: 'shop-api', issuer: 'shop.example' });
function requireAuth(req, res, next) {
const [scheme, value] = (req.headers.authorization || '').split(' ');
if (scheme !== 'Bearer' || !value) return res.status(401).json({ error: 'رمز مفقود' });
try {
req.user = jwt.verify(value, SECRET,
{ algorithms: ['HS256'], audience: 'shop-api', issuer: 'shop.example' });
req.user.id = req.user.sub;
next();
} catch {
return res.status(401).json({ error: 'رمز غير صالح أو منتهي' });
}
}
5.10 إعدادات CORS الخاطئة للـ API
CORS (Cross-Origin Resource Sharing) آلية تسمح للخادم بأن يخبر المتصفح: «هذه المواقع الأخرى مسموح لها بقراءة ردودي». سياسة المصدر الواحد (Same-Origin Policy) تمنع ذلك افتراضياً، وCORS يخفّف هذا المنع — لذا الإعداد الخاطئ يفتح الباب.
الخطأ الأخطر: عكس ترويسة Origin القادمة كما هي مع السماح بإرسال بيانات الاعتماد (الكوكيز):
// ❌ ضعيف: أي موقع في العالم يُعتبر مسموحاً، ومع الكوكيز!
app.use((req, res, next) => {
res.setHeader('Access-Control-Allow-Origin', req.headers.origin);
res.setHeader('Access-Control-Allow-Credentials', 'true');
next();
});
ماذا يحدث خطوة بخطوة:
- الطالب مسجّل دخوله في
portal.example.edu، والـ API يعتمد على كوكي الجلسة.
- يزور صفحة خبيثة على
evil.example، فيها JavaScript يرسل fetch('https://portal.example.edu/api/users/me', { credentials: 'include' }).
- المتصفح يرسل الكوكي تلقائياً، والخادم يرد بـ
Access-Control-Allow-Origin: https://evil.example مع Allow-Credentials: true.
- المتصفح يسمح للصفحة الخبيثة بقراءة الرد، فتُسرق بيانات الطالب.
// ✅ آمن: قائمة سماح ثابتة بالمصادر المعروفة فقط
const cors = require('cors');
const ALLOWED_ORIGINS = ['https://portal.example.edu', 'https://m.portal.example.edu'];
app.use('/api/', cors({
origin: (origin, cb) => cb(null, !origin || ALLOWED_ORIGINS.includes(origin)),
credentials: true,
methods: ['GET', 'POST', 'PUT', 'DELETE']
}));
أخطاء CORS الشائعة أيضاً: قبول Origin: null، أو فحص المصدر بـ endsWith('example.edu') فيُقبل attackerexample.edu، أو Access-Control-Allow-Origin: * على API خاص. تذكّر أن CORS ليس وسيلة مصادقة ولا يحمي من CSRF (المحاضرة 6)؛ هو فقط يحدد من يستطيع قراءة الرد في المتصفح.
5.11 API9 — إدارة المخزون غير السليمة (Improper Inventory Management)
لا يمكنك حماية ما لا تعرف بوجوده. أمثلة شائعة:
- إصدار قديم منسي: الفريق أضاف فحص الملكية في
/api/v2/orders/:id، لكن /api/v1/orders/:id ما زال يعمل بلا فحص لأن تطبيق جوال قديم يستخدمه.
- بيئات غير إنتاجية مكشوفة:
staging-api.example.com متصل بقاعدة بيانات حقيقية وبحماية أضعف.
- توثيق مكشوف للعامة:
/swagger-ui أو /api-docs أو openapi.json يعرض كل النقاط الداخلية والإدارية ومعاملاتها.
- نقاط تصحيح (Debug):
/api/debug أو /actuator تُركت مفعّلة في الإنتاج.
الحماية:
- سجلّ (Inventory) محدَّث بكل الواجهات وإصداراتها وبيئاتها ومالكيها.
- إيقاف الإصدارات القديمة بخطة واضحة، أو تطبيق الضوابط الأمنية نفسها عليها.
- إتاحة التوثيق داخلياً فقط أو خلف مصادقة، وعدم تضمين النقاط الإدارية في التوثيق العام.
- توجيه كل الإصدارات عبر بوابة واحدة تطبّق المصادقة وتحديد المعدّل مركزياً.
5.12 تطبيق عملي في المختبر فقط: اختبار REST API في OWASP Juice Shop
تنبيه أخلاقي: الخطوات التالية تُنفَّذ حصراً على نسخة Juice Shop المحلية في بيئة Docker الخاصة بالمساق (http://localhost:3000) أو على شبكة المختبر المعزولة. تطبيق أي منها على موقع أو تطبيق جوال حقيقي هو وصول غير مصرّح به.
التحضير:
- تشغيل المختبر:
docker run --rm -p 3000:3000 bkimminich/juice-shop.
- إنشاء حسابين تجريبيين (طالب أ، طالب ب)، وإضافة منتج إلى سلة كل منهما.
- فتح أدوات المطوّر في المتصفح (F12) ← تبويب Network مع تصفية Fetch/XHR، أو توجيه المتصفح عبر وكيل Burp Suite.
الخطوة 1 — رسم خريطة الـ API: تصفّح التطبيق كالمستخدم العادي، ولاحظ الطلبات الخلفية: نقاط تبدأ بـ /rest/ وأخرى بـ /api/، وترويسة Authorization: Bearer ... المرافقة لها. سجّل كل نقطة نهاية وطريقتها في جدول. (فكّك الرمز في أداة محلية ولاحظ أنه JWT كما في المحاضرة 7.)
الخطوة 2 — اختبار BOLA على السلة: عند فتح السلة يظهر طلب مثل GET /rest/basket/{id}. في Burp أرسل الطلب إلى Repeater، وغيّر المعرّف إلى رقم سلة الحساب الآخر. لاحظ: هل يعيد الخادم سلة لا تخصّك؟ وثّق الطلب والاستجابة.
الخطوة 3 — كشف البيانات الزائد: راقب استجابة GET /api/Users (أو نقاط المستخدمين الأخرى) وأنت مسجّل بحساب عادي. ما الحقول التي تعود؟ هل تحتاج الواجهة كل هذه الحقول؟ هل يرى المستخدم العادي بيانات بقية المستخدمين؟
الخطوة 4 — Mass Assignment عند التسجيل: راقب طلب POST /api/Users عند إنشاء حساب جديد، ولاحظ الحقول المرسلة. ناقش: ماذا لو أضاف العميل حقلاً لا تعرضه الواجهة مثل الدور؟ نفّذ التجربة على نسخة المختبر فقط ولاحظ النتيجة.
الخطوة 5 — المخزون والتوثيق: ابحث في المختبر عن صفحة توثيق مكشوفة (مثل /api-docs) وناقش ما تكشفه للمهاجم.
الخطوة 6 — التقرير والإصلاح: لكل ملاحظة: نقطة النهاية، فئة OWASP API (API1، API3...)، الطلب والاستجابة، الأثر، والإصلاح المقترح بالكود من الأقسام 5.4 – 5.11.
5.13 سيناريو — تطبيق جوال لمتجر
شركة أطلقت تطبيق جوال يستدعي https://api.shop.example/v2/. الواجهة لا تُظهر أي بيانات حساسة، فاعتبر الفريق التطبيق آمناً. عند مراجعة حركة المرور تبيّن أن:
GET /v2/orders/{id} لا يفحص الملكية (API1).
- استجابة
/v2/users/me تحتوي passwordHash و role (API3).
/v1/ ما زال يعمل بلا مصادقة لأن نسخة قديمة من التطبيق تستخدمه (API9).
- مفتاح API لخدمة الرسائل مكتوب داخل التطبيق ويمكن استخراجه (API2/API8).
الدرس: الأمان يُبنى على الخادم في كل نقطة نهاية، لا في تطبيق الجوال ولا في الواجهة الأمامية.
أخطاء شائعة
- الاعتقاد أن الـ API «مخفي» لأن المستخدم لا يراه في المتصفح.
- فحص المصادقة دون فحص الملكية (BOLA) أو دون فحص الدور (API5).
- إرجاع كائن قاعدة البيانات كاملاً والاعتماد على الواجهة لإخفاء الحقول.
- ربط جسم الطلب مباشرة بنموذج قاعدة البيانات (Mass Assignment).
- غياب تحديد المعدّل وحدود حجم الصفحة.
- استخدام
jwt.decode أو قبول أي خوارزمية أو رموز بلا انتهاء.
- عكس
Origin في CORS مع Allow-Credentials: true.
- ترك
/v1 أو بيئة الاختبار أو توثيق Swagger مكشوفاً.
- وضع مفاتيح API سرية داخل تطبيق الجوال أو كود JavaScript.
أفضل الممارسات
- مصادقة وتفويض مركزيان (Middleware) يُطبَّقان على كل نقاط النهاية وكل الطرق، مع الرفض افتراضياً.
- فحص الملكية داخل الاستعلام في كل نقطة تستقبل معرّف كائن.
- قوائم سماح للحقول الداخلة والخارجة (DTO / Schema Validation).
- تحديد المعدّل، وسقف لحجم الصفحة والجسم، ومهلة زمنية للعمليات.
- رموز قصيرة العمر يُتحقق من توقيعها وخوارزميتها وجمهورها (Audience).
- CORS بقائمة سماح ثابتة، وعدم الاعتماد عليه كحماية.
- سجلّ محدَّث للواجهات وإصداراتها، وإيقاف القديم منها.
- تسجيل ومراقبة الطلبات المرفوضة (401 و 403 و 429).
- المراجع: OWASP API Security Top 10 (2023) و OWASP REST Security Cheat Sheet.
5.14 قائمة تحقق لأمن الـ API
| ✔ |
البند |
| ☐ |
كل نقطة نهاية تتطلب مصادقة ما لم تكن عامة عن قصد ومُوثَّقة كذلك |
| ☐ |
كل نقطة تستقبل معرّف كائن تفحص ملكيته على الخادم (BOLA) |
| ☐ |
النقاط الإدارية تمر بفحص دور مركزي، ولكل طريقة HTTP على حدة |
| ☐ |
الحقول المقبولة في الطلب محددة بقائمة سماح (منع Mass Assignment) |
| ☐ |
الاستجابة تحتوي الحقول اللازمة فقط (لا تجزئة كلمات مرور ولا حقول داخلية) |
| ☐ |
تحديد معدّل الطلبات، وأشدّ على تسجيل الدخول ورموز التحقق |
| ☐ |
سقف لحجم الصفحة (Pagination) وحجم جسم الطلب والملفات |
| ☐ |
JWT: خوارزمية محددة، سرّ قوي من متغيرات البيئة، exp قصير، تحقق من aud و iss |
| ☐ |
لا أسرار ولا مفاتيح API حساسة داخل تطبيق الجوال أو JavaScript |
| ☐ |
CORS بقائمة سماح ثابتة، ولا عكس لـ Origin مع بيانات الاعتماد |
| ☐ |
رسائل الخطأ عامة دون تفاصيل داخلية أو Stack Trace |
| ☐ |
HTTPS فقط لكل الطلبات |
| ☐ |
سجلّ بكل الواجهات وإصداراتها، والقديم منها متوقف أو محمي بالقدر نفسه |
| ☐ |
التوثيق (Swagger / OpenAPI) غير مكشوف للعامة في الإنتاج |
| ☐ |
البيانات القادمة من واجهات أطراف ثالثة يُتحقق منها كأي مدخل مستخدم (API10) |
6. استخدام الذكاء الاصطناعي
- «ولّد سيناريو IDOR مبسّطاً واشرح لماذا لا يكفي إخفاء الزر.»
- «كيف أتحقّق من الصلاحية على الخادم بشكل صحيح؟ أعطني مثال كود.»
- «ما طبقات الحماية الصحيحة لرفع الملفات؟»
- «راجع كود رفع الملفات هذا بلغة PHP من المختبر واذكر الطبقات الناقصة: [الصق الكود].»
- «اشرح الفرق بين التصعيد الأفقي والرأسي بمثال من نظام جامعي.»
- «راجع نقطة النهاية هذه في Express وحدّد فئات OWASP API Security Top 10 التي تنطبق عليها، ثم اقترح الإصلاح: [الصق الكود].»
- «اشرح لماذا يُعدّ عكس ترويسة Origin مع Access-Control-Allow-Credentials خطيراً، بمثال مبسّط.»
تنبيه: استخدم الذكاء الاصطناعي لفهم الثغرة وكتابة الإصلاح ومراجعة كودك، لا لاستهداف أنظمة حقيقية. لا تلصق بيانات أو روابط داخلية من أنظمة فعلية، وتحقق من الإجابات بالرجوع إلى أوراق OWASP المرجعية.
المختبر المرافق (مختبر 8)
IDOR في Juice Shop، وPath Traversal، ورفع ملف خبيث وتجاوز الفلترة، واختبار REST API في Juice Shop (BOLA وكشف البيانات الزائد). المُخرَج: تقرير ثغرات.
ربط بالمختبر
سيطبّق الطالب في المختبر 8 ما يلي، حصراً داخل بيئات المختبر المعزولة (OWASP Juice Shop و DVWA و WebGoat المثبّتة على جهازه أو على شبكة المختبر):
- IDOR في Juice Shop: إنشاء حسابين تجريبيين، ثم ملاحظة كيف يمكن للحساب الأول الوصول إلى بيانات الثاني بتعديل معرّف في الطلب باستخدام Burp، وتوثيق الطلب والاستجابة.
- Path Traversal: في وحدة File Inclusion في DVWA أو دروس WebGoat المخصّصة، ملاحظة كيف يؤدي بناء المسار من مدخل المستخدم إلى قراءة ملف خارج المجلد المقصود، ثم كتابة النسخة الآمنة (قائمة سماح أو
realpath).
- رفع الملفات: في وحدة File Upload في DVWA، مقارنة سلوك المستويات المختلفة، وفهم لماذا لا يكفي فحص الامتداد أو
Content-Type، باستخدام ملفات اختبار يزوّدها المدرّس فقط.
- أمن الـ API في Juice Shop: تنفيذ خطوات القسم 5.12 (رسم خريطة نقاط
/rest/ و /api/، اختبار BOLA على /rest/basket/{id}، ملاحظة الحقول الزائدة في /api/Users) على النسخة المحلية في Docker فقط، وتصنيف كل ملاحظة وفق OWASP API Security Top 10.
- الإصلاح: تطبيق كود الرفع الآمن من القسم 4.3 على تطبيق تجريبي وإثبات أن الملفات غير المسموحة تُرفض.
- التقرير: لكل ثغرة: الوصف، فئة OWASP، خطوات إعادة الإنتاج في المختبر، الأثر، والإصلاح المقترح مع الكود.
قاعدة أخلاقية ثابتة: تغيير معرّف في رابط موقع حقيقي «لمجرد التجربة»، أو رفع ملف اختبار إلى موقع حقيقي، هو وصول غير مصرّح به. يُمنع اختبار أي نظام حقيقي (بوابة الجامعة، مواقع الشركات، مواقع الزملاء) دون تفويض مكتوب من مالكه. إذا لاحظت ثغرة بالصدفة في نظام حقيقي، فأبلغ الجهة المسؤولة بمسؤولية ولا تستغلها.
فيديوهات
ملخص المحاضرة
- المصادقة تثبت الهوية، والتفويض يحدد ما يحق للمستخدم فعله؛ وكسر التحكم بالوصول هو الفئة الأولى A01 في OWASP Top 10.
- كل قرار صلاحية يُتَّخذ على الخادم في كل طلب ومن بيانات الجلسة، وإخفاء الأزرار ليس حماية.
- IDOR يُمنع بشرط الملكية داخل الاستعلام (
AND user_id = ?)، والمعرّفات العشوائية تساعد لكنها لا تغني عنه.
- التصعيد الأفقي يصل لبيانات مستخدم مماثل، والرأسي يصل لوظائف أعلى؛ والحل فحص مركزي للدور وقائمة سماح بالحقول.
- اجتياز المسار يُمنع بقائمة سماح بالمعرّفات، أو بـ
basename و realpath وفحص بقاء المسار داخل المجلد.
- SSRF تجعل الخادم يطلب وجهات داخلية؛ والحل قائمة سماح بالنطاقات وHTTPS فقط ومنع إعادة التوجيه وعزل الشبكة.
- رفع الملفات يحتاج طبقات: فحص المحتوى الحقيقي، اسم عشوائي، تخزين خارج جذر الويب، منع التنفيذ، حدّ الحجم.
- الملفات المرفوعة تُقدَّم عبر سكربت يفحص الملكية مع
X-Content-Type-Options: nosniff.
- الـ API سطح هجوم مستقل لأن المهاجم يستدعي نقاط النهاية مباشرة دون واجهة؛ وOWASP API Security Top 10 (2023) تبدأ بـ BOLA (API1) وهي IDOR في الـ API.
- كل نقطة نهاية تفحص المصادقة والملكية والدور بنفسها، مع قائمة سماح للحقول الداخلة (منع Mass Assignment) والخارجة (منع كشف البيانات الزائد).
- تحديد المعدّل (Rate Limiting) وسقف حجم الصفحة والجسم يمنعان الاستهلاك غير المقيّد للموارد.
- مفتاح الـ API يمثّل تطبيقاً لا مستخدماً؛ وJWT يحتاج خوارزمية محددة وسرّاً قوياً وعمراً قصيراً وتخزيناً بعيداً عن
localStorage قدر الإمكان.
- CORS بقائمة سماح ثابتة، ولا يُعكس
Origin مع بيانات الاعتماد؛ والإصدارات القديمة والتوثيق المكشوف خطر يجب إدارته.
- قوائم السماح (Allowlist) أقوى دائماً من قوائم المنع (Denylist) في كل مواضيع هذه المحاضرة.
مصطلحات المحاضرة
| English term |
المصطلح العربي |
شرح مختصر |
| Authorization / Access Control |
التفويض / التحكم بالوصول |
تحديد ما يحق للمستخدم فعله وعلى أي بيانات |
| Broken Access Control |
كسر التحكم بالوصول |
وصول المستخدم إلى موارد أو وظائف ليست من حقه |
| IDOR |
الإشارة المباشرة غير الآمنة للكائنات |
الوصول لسجل غيرك بتغيير معرّفه دون فحص الملكية |
| Privilege Escalation |
تصعيد الصلاحيات |
الحصول على صلاحيات أعلى أو أوسع من المسموح |
| Horizontal / Vertical |
أفقي / رأسي |
نحو مستخدم مماثل / نحو دور أعلى |
| Mass Assignment |
الإسناد الجماعي للحقول |
حفظ كل حقول الطلب بما فيها حقول حساسة مثل الدور |
| RBAC |
التحكم بالوصول حسب الدور |
ربط الصلاحيات بأدوار المستخدمين |
| Deny by Default |
الرفض افتراضياً |
كل شيء ممنوع ما لم يُسمح به صراحة |
| Least Privilege |
مبدأ أقل صلاحية |
منح أقل صلاحيات كافية لأداء العمل |
| Path Traversal |
اجتياز المسار |
الخروج من المجلد المسموح باستخدام ../ |
| SSRF |
تزوير الطلب من جهة الخادم |
إجبار الخادم على إرسال طلبات لوجهات يختارها المهاجم |
| Allowlist / Denylist |
قائمة سماح / قائمة منع |
السماح بالمعروف فقط / منع المعروف فقط |
| Web Root |
جذر الويب |
المجلد الذي يقدّم الخادم ملفاته مباشرة عبر الإنترنت |
| RCE |
تنفيذ كود عن بعد |
تشغيل أوامر على الخادم من خارج النظام |
| MIME Type |
نوع المحتوى |
تعريف نوع الملف مثل image/png |
| API / Endpoint |
واجهة برمجة / نقطة نهاية |
مسار وطريقة HTTP تستقبل طلباً وتعيد بيانات منظمة (غالباً JSON) |
| REST |
أسلوب REST |
تصميم للواجهات يمثّل الموارد بمسارات والعمليات بطرق HTTP |
| OWASP API Security Top 10 |
أعلى عشر مخاطر لواجهات البرمجة |
قائمة OWASP لأخطر ثغرات الـ API (إصدار 2023) |
| BOLA |
كسر التفويض على مستوى الكائن |
الوصول لكائن غيرك في الـ API بتغيير معرّفه (IDOR في الـ API) |
| BFLA |
كسر التفويض على مستوى الوظيفة |
استدعاء وظائف إدارية دون فحص الدور |
| Excessive Data Exposure |
كشف البيانات الزائد |
إعادة حقول أكثر مما تحتاجه الواجهة |
| Rate Limiting |
تحديد معدّل الطلبات |
تقييد عدد الطلبات في فترة زمنية وإرجاع 429 عند التجاوز |
| Pagination |
تقسيم النتائج إلى صفحات |
إعادة عدد محدود من السجلات في كل طلب بسقف يحدده الخادم |
| API Key |
مفتاح واجهة البرمجة |
سرّ يعرّف تطبيقاً أو مشروعاً لا مستخدماً |
| CORS |
مشاركة الموارد عبر المصادر |
آلية تحدد أي المواقع الأخرى يُسمح لها بقراءة ردود الخادم في المتصفح |
| API Inventory |
سجلّ الواجهات |
قائمة محدَّثة بكل الواجهات وإصداراتها وبيئاتها |
أسئلة مراجعة
- ما هي ثغرة IDOR؟ وكيف نمنعها؟
- ما الفرق بين التصعيد الأفقي والرأسي؟
- كيف يستغل المهاجم Path Traversal؟
- اذكر ثلاث طبقات لحماية رفع الملفات.
- لماذا تُعدّ واجهات البرمجة (API) سطح هجوم مستقلاً؟ وما علاقة BOLA بـ IDOR؟
أسئلة اختيار من متعدد
1. أيّ ممّا يلي هو الحماية الصحيحة من IDOR في صفحة عرض الفواتير؟
- أ) إخفاء رقم الفاتورة من شريط العنوان
- ب) إضافة شرط
AND user_id = ? بقيمة من الجلسة في الاستعلام
- ج) تشفير رقم الفاتورة بـ Base64
- د) منع زر «الفاتورة التالية» في الواجهة
الإجابة: ب
2. طالب يصل إلى صفحة تعديل العلامات المخصّصة للمسجّل. هذا مثال على:
- أ) تصعيد أفقي
- ب) تصعيد رأسي
- ج) SSRF
- د) اجتياز المسار
الإجابة: ب
3. ما وظيفة realpath() في حماية تنزيل الملفات؟
- أ) ضغط الملف قبل إرساله
- ب) تشفير اسم الملف
- ج) حساب المسار النهائي بعد تفسير
../ للتأكد أنه داخل المجلد المسموح
- د) تغيير صلاحيات الملف
الإجابة: ج
4. لماذا لا يكفي فحص ترويسة Content-Type في طلب رفع الملف؟
- أ) لأنها لا تُرسَل أبداً
- ب) لأن العميل يتحكم بقيمتها ويمكن ضبطها على أي نوع
- ج) لأنها خاصة بالصور فقط
- د) لأن PHP لا تستطيع قراءتها
الإجابة: ب
5. أيّ إجراء هو الأقوى للحماية من SSRF في ميزة «جلب صورة من رابط»؟
- أ) منع كلمة
localhost فقط
- ب) قائمة سماح بالنطاقات المسموحة مع HTTPS فقط ومنع إعادة التوجيه
- ج) إخفاء رسالة الخطأ
- د) تحويل الرابط إلى أحرف كبيرة
الإجابة: ب
6. مستخدم في تطبيق جوال يغيّر GET /api/orders/5001 إلى GET /api/orders/5002 فيرى طلب عميل آخر. ما فئة OWASP API Security Top 10 المناسبة؟
- أ) API4 — Unrestricted Resource Consumption
- ب) API9 — Improper Inventory Management
- ج) API1 — Broken Object Level Authorization (BOLA)
- د) API7 — SSRF
الإجابة: ج
7. ما الحماية الصحيحة من Mass Assignment في نقطة PATCH /api/users/me؟
- أ) إخفاء حقل الدور من نموذج الواجهة
- ب) قائمة سماح بالحقول القابلة للتعديل على الخادم وتجاهل أي حقل آخر
- ج) تشفير جسم الطلب بـ Base64
- د) تفعيل CORS لكل المصادر
الإجابة: ب
8. أيّ إعداد CORS هو الأخطر على API يعتمد على كوكي الجلسة؟
- أ) قائمة سماح ثابتة بنطاقَي الموقع وتطبيقه
- ب) عدم إرسال أي ترويسة CORS
- ج) عكس قيمة
Origin القادمة في Access-Control-Allow-Origin مع Access-Control-Allow-Credentials: true
- د) السماح بالطريقتين
GET و POST فقط لنطاق الموقع
الإجابة: ج
أسئلة قصيرة ونقاش
- يقول زميلك: «استخدمنا UUID بدل الأرقام المتسلسلة، فلا داعي لفحص الملكية». ناقش هذا الرأي.
- صمّم بالترتيب خطوات معالجة رفع «صورة شخصية» في بوابة الطلاب، واذكر الخطر الذي تمنعه كل خطوة.
- لماذا تُعدّ قائمة السماح أفضل من قائمة المنع في كلٍّ من: رفع الملفات، وSSRF، واجتياز المسار؟
- فريق أضاف فحص الملكية في
/api/v2/orders/:id لكنه أبقى /api/v1/ يعمل لدعم نسخة قديمة من تطبيق الجوال. ما الخطر؟ وما فئة OWASP API المناسبة؟ واقترح خطة معالجة.
- قارن بين مفتاح الـ API ورمز JWT من حيث ما يمثّله كلٌّ منهما، واذكر ثلاثة أخطاء شائعة في استخدام JWT داخل الـ API مع إصلاح كل منها.
للاستزادة