
درس مصغّر 12 من 30 · الحسابات والوصول
اختر ما يحتاج إلى حماية
لمن هذا الدرس؟
لمن يريدون إتاحة صفحة أو ملاحظة بعد الدخول فقط. يستطيع مساعد البرمجة ربط الحماية المرفقة؛ وبرمجة الخادم ليست متطلب التعلم.
الخصوصية تعني عدم إتاحة المحتوى لزائر غير مخوّل، وليس إخفاءه بصريًا فقط.
هدف هذا الدرس
- أبقِ المحتوى الخاص خارج الصفحة العامة.
- اختبر المسار نفسه قبل الدخول وبعده.
- افحص فشل الوصول دون كشف الملاحظة.
شرح ومثال محلول وتدريب
قبل أن تبدأ
تحتاج إلى إعداد الدخول المرفق أو وصول مكافئ إلى Supabase، ومشروع منفصل لاستضافة الدوال، ومساعد برمجة. استخدم قيمة PRIVATE_NOTE وهمية محفوظة في بيئة الخادم فقط، ولا تستخدم محتوى خاصًا حقيقيًا أبدًا.
تحقّق من مهارات البداية
هذه مهارات مفيدة وليست دروسًا إلزامية تمنع الدخول. ابدأ هنا إن كنت تتقنها، وإلا افتح التحضير المرتبط. ملفات البداية مرفقة، فلا تحتاج إلى موقع شخصي سابق.
- كيف تتيح للناس تسجيل الدخول إلى موقعك
اطلب رمز دخول حقيقيًا واستخدمه.
الوقت المتوقع: 20–32 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. يسمح هذا المثال لكل مستخدم صالح في مشروع التدريب. تتطلب السجلات الخاصة بكل مستخدم والأدوار قواعد تفويض إضافية.
افهم الفكرة
استخدم الملاحظة الوهمية والمشروع الجاهز المرفقين. اطلب من المساعد إبقاء الملاحظة على الخادم، لا داخل الصفحة العامة التي ينزّلها المتصفح.
يستطيع الزائر فحص الملفات العامة حتى لو كان أحد العناصر مخفيًا. لا تضع معلومات خاصة حقيقية في التمرين.
مثال عملي
فقرة تخفيها أنماط الصفحة تظل جزءًا من الملف العام.
استخدم حزمة الملاحظة الخاصة الكاملة هذه ومشروع الدخول المُدار التجريبي الخاص بي. أبقِ PRIVATE_NOTE في بيئة الخادم الخاصة فقط، وحافظ على اختبارات الوصول المرفقة. ساعدني في تشغيل التطبيق، ثم قارن الوصول المباشر دون دخول بالوصول بعد التحقق من الدخول. لا تعتبر إخفاء فقرة حماية، ولا تكشف بيانات شخص آخر.ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
أي ملاحظة تختبر؟ وكيف ستتحقق أن الزوار غير المسجلين لا يستطيعون الحصول عليها؟
عرض حل نموذجي مشروح
مثال خطة: «ملاحظتي الخيالية تذكير باجتماع تدريبي. يمكن لأي مستخدم تجريبي موثّق ومسجل الدخول قراءتها في هذا المختبر. سأجرب مسار الملاحظة من جلسة منفصلة دون دخول، وأتأكد من أن الاستجابة لا تحتوي على الملاحظة».
يجب أن تبقى الملاحظة خارج ملفات الصفحة العامة. إخفاء فقرة بصريًا لا يمنع الزائر من قراءتها في المصدر الذي نزّله.
ما تتضمنه الإجابة السليمة
- يستخدم ملاحظة خيالية موجودة في الخادم فقط، ويحدد أن جمهور المختبر هم المستخدمون المسجل دخولهم.
- يخطط لطلب مباشر دون تسجيل دخول، بدل الاعتماد على عنصر مخفي في الصفحة.
كيف يعمل؟ (اختياري)
احمِ الاستجابة، لا الزر فقط
يجب ألا يُرسل المحتوى الخاص إلى متصفح غير مصرح له أصلًا.
يغيّر الإخفاء بـCSS وتعطيل الأزرار الواجهة، لا الاستجابة. يستطيع أي شخص فحص الملفات العامة وإرسال طلب مباشر إلى نقطة نهاية.
يقرأ خادمنا ملاحظة من بيئته ولا يعيدها إلا بعد التحقق من رمز مستخدم. الملاحظة الخيالية للمختبر؛ أما البيانات الخاصة الحقيقية فمكانها مصدر بيانات محمي، لا مستودع عام.
مثال محلول
ملف JavaScript عام يحتوي على ملاحظة «مخفية» يظل نسخة عامة. يبقي المثال القيمة خارج public/ بدلًا من ذلك.
تمرين تقني إضافي
تخفي الصفحة فقرة حتى تسجيل الدخول، لكن الفقرة موجودة في مصدر HTML. هل هي خاصة؟
عرض حل نموذجي مشروح
لا. اضبط الوصول إلى استجابة الخادم قبل إرسال المحتوى. إخفاء قيمة مستلمة لا يجعلها سرية.
- تدرك أن المتصفح تلقاها بالفعل.
- تنقل التحكم في الوصول إلى ما قبل الاستجابة المحمية.

الخطوة 1 · كيف تُبقي صفحة خاصة
اربط الحماية الجاهزة
دع المساعد يضبط اختبارات الخادم الموجودة.
شرح ومثال محلول وتدريب
افهم الفكرة
اتبع run-locally.txt مع المساعد. قبل الاختبار، تحقق من مشروع المصادقة المقصود وقيم المتصفح العامة وإعدادات مصادقة الخادم الخاصة وPRIVATE_NOTE الخيالية. شغّل المشروع كاملًا وافتح رابط الخادم الوسيط الفعلي؛ فلا تستطيع معاينة ملف عادية تشغيل حمايته.
فحوص جاهزية الحساب والخادم مطلوبة. قراءة تنفيذ الدالة اختيارية. يجب أن تتحقق الخدمة من جلسة الحساب قبل إرجاع الملاحظة؛ ولا يُعد إدخال طالب الطلب معرّف حساب آخر دليلًا على الهوية.
مثال عملي
هوية يرسلها المستخدم لا تعادل جلسة حساب مؤكدة.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
أي خطوة إعداد اكتملت؟ وما عنوان التطبيق الفعلي الذي تستطيع اختباره؟
عرض حل نموذجي مشروح
مثال سجل جاهزية: «يعمل التطبيق المرفق عند رابط الخادم الوسيط المحلي الذي طبعه الخادم. أُعد مشروع المصادقة التدريبي وملاحظة الخادم الخيالية. والملاحظة غير موجودة في ملفات الصفحة العامة».
مثال سجل تعذر: «تفتح الصفحة، لكن الخادم يعرض Auth not configured؛ ويجب أن يفحص المساعد بيئة المزود الخاصة قبل اختبار الوصول». فتح الصفحة وحده لا يثبت حماية الخادم.
ما تتضمنه الإجابة السليمة
- يحدد عنوان التطبيق العامل وإعداد الخادم والمزود المكتمل.
- يذكر عائق إعداد محددًا دون نشر الملاحظة الخاصة أو بيانات الاعتماد.
كيف يعمل؟ (اختياري)
أرسل رمز جلسة إلى الخادم
يقدم العميل رمز حامل؛ ويتحقق منه الخادم بصورة مستقلة.
اضبط ملفات تسجيل الدخول وبيئة الخادم وفق START-HERE.txt. يحصل العميل على جلسته الحالية ويرسل رمز وصولها في رأس Authorization عند طلب نقطة النهاية الخاصة.
يستدعي الخادم نقطة نهاية مستخدم المزوّد بذلك الرمز ومفتاح تطبيق المشروع القابل للنشر. يرفض الرموز المفقودة أو غير الصحيحة ويميّز انقطاع المزوّد عن هوية مقبولة. فك ترميز الرمز دون التحقق منه غير كافٍ.
اتبع الطلب بالترتيب: يرسل المتصفح رمز وصول المستخدم → يسأل الخادم مزوّد الهوية ما إذا كان الرمز يمثل مستخدمًا → لا تسمح بإعادة الملاحظة إلا نتيجة متحقق منها. يعرّف مفتاح المشروع القابل للنشر التطبيق؛ ولا يعرّف الشخص أو يفوّضه بمفرده.
للتسلسل المحلي الكامل، افتح run-locally.txt: جهز بيئة الجذر الخاصة، واربط مشروع التدريب فقط، وابدأ وكيل دوال Netlify. يسرد server-env.example.txt أسماء المتغيرات دون أسرار حقيقية. فتح HTML وحده لا يشغّل الخادم.
مثال محلول
حقل userId يقدمه مقدم الطلب ليس دليلًا على امتلاكه لذلك المعرّف. استخدم الهوية المُرجعة من التحقق.
const r=await fetch('/.netlify/functions/mini-private-note', {
headers:{Authorization:'Bearer '+session.access_token}
});Supabase: جلب مستخدم متحقق منه · Node.js: حالة دعم الإصدارات
تمرين تقني إضافي
هل يستطيع الخادم تفويض طلب بالثقة في userId من JSON المتصفح؟
عرض حل نموذجي مشروح
لا. يستطيع المتصفح تغيير ذلك الحقل. تحقق من بيانات الاعتماد واستخدم الهوية المتحقق منها.
- تتعامل مع ادعاءات هوية العميل على أنها غير موثوقة.
- تستخدم رمزًا متحققًا منه والهوية الناتجة.

الخطوة 2 · كيف تُبقي صفحة خاصة
اختبر الجمهور المسموح له
حدّد من ينبغي أن يستطيع قراءة هذا العنصر بعينه.
شرح ومثال محلول وتدريب
افهم الفكرة
سجّل الدخول بحساب اختبار تتحكم به واطلب الملاحظة الوهمية. قاعدة هذا المختبر تسمح لأي مستخدم دخل بجلسة متحقق منها؛ اطلب من المساعد الحفاظ على هذا النطاق المعلن.
إن خزّنت لاحقًا بيانات حساب تخص شخصًا واحدًا، فلن تكفي تلك القاعدة الأوسع. حدّد الجمهور بدل افتراض تطابق صلاحيات كل البيانات الخاصة.
مثال عملي
تحتاج ملاحظة مشتركة للأعضاء وسجل حساب فردي إلى قرارَي وصول مختلفين.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
من يُسمح له بقراءة ملاحظتك التجريبية؟ وهل طابق الطلب بعد الدخول تلك القاعدة؟
عرض حل نموذجي مشروح
مثال سجل وصول: «التحقق من حساب الاختبار A ناجح وقد استلم ملاحظة الأعضاء الخيالية. تسمح قاعدة المختبر لأي مستخدم موثّق ومسجل الدخول، لذا يدخل عضو تجريبي آخر موثّق ضمن الجمهور المسموح أيضًا».
هذه قاعدة لمحتوى مشترك بين الأعضاء. لا تكفي لملف A الشخصي الذي يجب قصره عليه؛ فذلك الحد المختلف يتطلب التحقق من الملكية.
ما تتضمنه الإجابة السليمة
- يوضح أن المختبر يسمح لأي مستخدم موثّق ومسجل الدخول، وليس لمالك واحد للملاحظة فقط.
- يسجل نتيجة الحساب المسموح دون تعميم هذه القاعدة على البيانات الشخصية للحسابات.
كيف يعمل؟ (اختياري)
أعد البيانات المحمية المقصودة فقط
الهوية الصحيحة لا تمنح تلقائيًا وصولًا إلى سجلات كل المستخدمين.
يمنح هذا المثال الصغير كل مستخدم صالح في مشروع التدريب وصولًا إلى ملاحظة مشتركة واحدة. هذه قاعدة تفويض صريحة وليست تعريفًا عامًا للمحتوى الخاص.
تستخدم الاستجابة private, no-store للتخزين المؤقت، فلا ينبغي أن يحتفظ مخزن مشترك بالملاحظة. يستخدم درس ملف شخصي لاحق قواعد ملكية للسجلات الخاصة بكل مستخدم. لا توسّع هذا المعالج إلى تفريغ شامل لقاعدة البيانات.
مثال محلول
تُشتق viewerId الخاصة بالخادم من التحقق. وتأتي الملاحظة من بيئته، لا من بيانات مقدمة في الطلب.
تمرين تقني إضافي
إذا استُبدلت الملاحظة بتفاصيل حساب مستخدم آخر، فهل تظل قاعدة «أي مستخدم مسجّل الدخول» مناسبة؟
عرض حل نموذجي مشروح
لا. أضف قاعدة تطابق الهوية المصادَق عليها بالسجل أو الدور المطلوب. تسجيل الدخول وحده لا يمنح الوصول إلى حساب آخر.
- تميّز المصادقة عن التفويض على مستوى السجل.
- تشترط الملكية أو دورًا مناسبًا للبيانات الخاصة بكل مستخدم.

الخطوة 3 · كيف تُبقي صفحة خاصة
جرّب المسار نفسه دون دخول
الطلب المباشر مهم بقدر أهمية الزر المعتاد.
شرح ومثال محلول وتدريب
افهم الفكرة
استخدم ملفًا شخصيًا في المتصفح تأكدت من عدم تسجيل دخوله، أو سجل الخروج وتحقق من حالة الحساب، ثم اطلب من المساعد طلب الملاحظة نفسها مباشرةً. قد تشارك نافذة خاصة إضافية جلسة خاصة موجودة. كرر طلب الملاحظة بعد تسجيل دخول متحقق منه.
يجب ألا تتضمن نتيجة الطلب دون دخول الملاحظة، بينما ينبغي أن تستلمها الجلسة المسموح لها. ويجب أن يبقى فشل الطلب خطأً دون تسريب المحتوى.
مثال عملي
حذف رابط من القائمة لا يحمي العنوان الذي كان يفتحه.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ماذا أعادت كل محاولة مباشرة، دون الدخول وبعده؟
عرض حل نموذجي مشروح
مثال سجل طلب مباشر: «دون تسجيل دخول: أعاد مسار الملاحظة Sign in required ولم يُعد الملاحظة. وبعد الدخول بالحساب A: أعاد المسار نفسه الملاحظة الخيالية. ساعدني المساعد في فحص محتوى الاستجابتين دون مشاركة رموز الجلسات».
إذا تضمنت الاستجابة دون تسجيل دخول الملاحظة، فقد فشلت الحماية حتى لو أخفتها الصفحة. وإذا كانت خدمة المصادقة غير متاحة، فسجل ذلك الفشل منفصلًا عن رفض طلب عادي.
ما تتضمنه الإجابة السليمة
- يقارن مسار الملاحظة نفسه بطلب دون تسجيل دخول وطلب مسموح بعد الدخول.
- يتحقق من أن الاستجابات المرفوضة أو الفاشلة لا تحتوي على نص الملاحظة الخاصة.
كيف يعمل؟ (اختياري)
جرّب نقطة النهاية دون الواجهة
يستهدف اختبار وصول حقيقي طلب البيانات مباشرة.
اطلب رابط الدالة في نافذة جديدة دون رأس Authorization؛ ينبغي ألا يعيد الملاحظة. جرّب رمز حامل مشوهًا، ثم استخدم واجهة مسجّلة الدخول لإرسال طلب مصرح به.
سجّل الخروج وتحقق من أن التطبيق يمحو الملاحظة المعروضة ولا يرسل رمز جلسة مجددًا. قد يبقى رمز صدر سابقًا صالحًا حتى انتهاء مدته المعدّة؛ الإلغاء العالمي الفوري متطلب منفصل.
مثال محلول
يبرهن طلب مباشر مرفوض أكثر من لقطة شاشة لزر دخول. احتفظ في سجلك بحالة الاستجابة وما إذا كان النص المحمي موجودًا.
تمرين تقني إضافي
يعيد طلب مباشر 401 دون ملاحظة، بينما تتلقى جلسة متحقق منها الملاحظة. أي حد اختبرت؟
عرض حل نموذجي مشروح
اختبرت أن نقطة النهاية هذه تتحقق من الهوية قبل إعادة الملاحظة المشتركة. تحتاج نقاط النهاية الأخرى وقواعد الملكية إلى اختباراتها الخاصة.
- تحدد حد استجابة الخادم.
- لا تدعي إلغاء رموز شاملًا أو تفويضًا خاصًا بكل مستخدم يتجاوز المثال.

الخطوة 4 · كيف تُبقي صفحة خاصة
احمِ قيمة تجريبية أخرى
كرّر الاختبارات نفسها بعد تعديل صغير.
شرح ومثال محلول وتدريب
افهم الفكرة
اطلب من المساعد إضافة قيمة وهمية ثانية محفوظة على الخادم وحده باستخدام قاعدة الجمهور المقصودة نفسها. لا تنقل أيًا من القيمتين إلى الملفات العامة للتسهيل.
كرّر ملاحظات السماح والرفض والفشل. أزل المعلومات الحساسة من التسليم، وحدّد أي اختبار لم تنفذه.
مثال عملي
ينبغي ألا تجعل إضافة حقل آخر الملاحظة الخاصة الأصلية عامة بالخطأ.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
قدّم حماية القيمة الجديدة ونتائج الوصول التي لاحظتها.
ما المطلوب إنجازه: مسار التدريب الذي يعمل ونتائج الوصول الفعلية دون دخول وبعده وعند الخطأ.
عرض حل نموذجي مشروح
مثال سجل إضافة: «أضفت موقع اجتماع خياليًا بجوار ملاحظة الأعضاء الأصلية. استلم عضو تجريبي موثّق القيمتين، ولم يستلم الطلب المباشر دون دخول أيًا منهما. وعند تعطيل المصادقة عمدًا في الإعداد المؤقت، ظلت الاستجابة خطأ ولم تتضمن أي قيمة».
يمكن لسجل التسليم تحديد الحقلين وهذه النتائج دون نسخ محتواهما. إذا لم يُنفذ أحد اختبارات الفشل، فسجله كذلك، بدل اعتبار نجاح الدخول دليلًا على سلامة كل الحدود.
ما تتضمنه الإجابة السليمة
- يبقي القيمتين الخياليتين في الخادم فقط، وفق قاعدة المحتوى المشترك بين الأعضاء المعلنة.
- يعيد اختبار استجابات السماح والرفض وفشل الخدمة بعد إضافة القيمة الجديدة.
كيف يعمل؟ (اختياري)
مهمتك: أضف قيمة محمية ثانية
أبقِ القيمة الجديدة خارج الملفات العامة وطبّق فحوص الخادم نفسها.
أضف قيمة تدريب أخرى في بيئة الخادم، ولا تعدها إلا بعد التحقق، واعرضها بأمان كنص. أبقِ الاستجابة غير قابلة للتخزين المؤقت.
كرر اختبارات الرمز المفقود والرمز غير الصحيح والجلسة الصالحة. ابحث في المصدر العام لتأكيد عدم تضمين أي من القيمتين الخاصتين فيه.
مثال محلول
توسّع المهمة الاستجابة المحمية، لا كمية البيانات المرسلة قبل الدخول.
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
تمرين تقني إضافي
احمِ قيمة ثانية وقدّم أدلة وصول إيجابية وسلبية.
عرض حل نموذجي مشروح
استدعِ نقطة نهاية private-note مباشرة دون رأس Authorization: توقع 401 وعدم وجود ملاحظة. يجب أن يفشل رمز حامل مختلق أيضًا. لا تلبي userId في المتصفح أو زر مخفي فحص هوية الخادم.
مع رمز جلستك الفعلي المتحقق منه في مشروع تدريبك، توقع ملاحظة الخادم المعدّة وCache-Control: private, no-store. أبقِ الملاحظة خارج HTML/JavaScript العام. لا تلصق رمز حامل حقيقيًا في تقرير اختبار مشترك.
بعد تسجيل الخروج، ينبغي أن تمحو الواجهة المحتوى الخاص وتتوقف عن الطلبات المصادَق عليها. قد يظل رمز وصول نُسخ سابقًا قابلًا للاستخدام حتى انتهاء الصلاحية: سلوك واجهة تسجيل الخروج لا يضمن إلغاءً فوريًا. يفوّض مختبر الملاحظة المشتركة المستخدمين المسجّلين؛ أما الملكية الخاصة بكل مستخدم فتمرين الملف الشخصي المنفصل.
- تبقى القيمتان في الخادم حتى نجاح التفويض.
- لا تحتوي الطلبات المباشرة غير المصرح بها أيًا من القيمتين؛ ويُفحص الوصول الصحيح وسلوك no-store.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.