
درس مصغّر · العربية
كيف تُبقي صفحة خاصة
استخدم مشروع الدخول الجاهز لإبقاء ملاحظة تجريبية خاصة، واختبر السماح بالوصول ورفضه.
لمن هذا الدرس؟
لمن يريدون إتاحة صفحة أو ملاحظة بعد الدخول فقط. يستطيع مساعد البرمجة ربط الحماية المرفقة؛ وبرمجة الخادم ليست متطلب التعلم.
قبل أن تبدأ
تحتاج إلى إعداد الدخول المرفق أو وصول مكافئ إلى Supabase، ومشروع منفصل لاستضافة الدوال، ومساعد برمجة. استخدم قيمة PRIVATE_NOTE وهمية محفوظة في بيئة الخادم فقط، ولا تستخدم محتوى خاصًا حقيقيًا أبدًا.
الوقت المتوقع: 20–32 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. يسمح هذا المثال لكل مستخدم صالح في مشروع التدريب. تتطلب السجلات الخاصة بكل مستخدم والأدوار قواعد تفويض إضافية.
ما الذي ستتعلمه؟
- أبقِ المحتوى الخاص خارج الصفحة العامة.
- اختبر المسار نفسه قبل الدخول وبعده.
- افحص فشل الوصول دون كشف الملاحظة.
الخطوة 1
اختر ما يحتاج إلى حماية
الخصوصية تعني عدم إتاحة المحتوى لزائر غير مخوّل، وليس إخفاءه بصريًا فقط.
استخدم الملاحظة الوهمية والمشروع الجاهز المرفقين. اطلب من المساعد إبقاء الملاحظة على الخادم، لا داخل الصفحة العامة التي ينزّلها المتصفح.
يستطيع الزائر فحص الملفات العامة حتى لو كان أحد العناصر مخفيًا. لا تضع معلومات خاصة حقيقية في التمرين.
مثال عملي
فقرة تخفيها أنماط الصفحة تظل جزءًا من الملف العام.
استخدم حزمة الملاحظة الخاصة الكاملة هذه ومشروع الدخول المُدار التجريبي الخاص بي. أبقِ PRIVATE_NOTE في بيئة الخادم الخاصة فقط، وحافظ على اختبارات الوصول المرفقة. ساعدني في تشغيل التطبيق، ثم قارن الوصول المباشر دون دخول بالوصول بعد التحقق من الدخول. لا تعتبر إخفاء فقرة حماية، ولا تكشف بيانات شخص آخر.ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
احمِ الاستجابة، لا الزر فقط
يجب ألا يُرسل المحتوى الخاص إلى متصفح غير مصرح له أصلًا.
يغيّر الإخفاء بـCSS وتعطيل الأزرار الواجهة، لا الاستجابة. يستطيع أي شخص فحص الملفات العامة وإرسال طلب مباشر إلى نقطة نهاية.
يقرأ خادمنا ملاحظة من بيئته ولا يعيدها إلا بعد التحقق من رمز مستخدم. الملاحظة الخيالية للمختبر؛ أما البيانات الخاصة الحقيقية فمكانها مصدر بيانات محمي، لا مستودع عام.
مثال محلول
ملف JavaScript عام يحتوي على ملاحظة «مخفية» يظل نسخة عامة. يبقي المثال القيمة خارج public/ بدلًا من ذلك.
Extra implementation exercise
تخفي الصفحة فقرة حتى تسجيل الدخول، لكن الفقرة موجودة في مصدر HTML. هل هي خاصة؟
عرض حل نموذجي مشروح
لا. اضبط الوصول إلى استجابة الخادم قبل إرسال المحتوى. إخفاء قيمة مستلمة لا يجعلها سرية.
- تدرك أن المتصفح تلقاها بالفعل.
- تنقل التحكم في الوصول إلى ما قبل الاستجابة المحمية.
خطأ شائع
مساواة عنصر DOM مخفي بالتفويض.
الخطوة 2
اربط الحماية الجاهزة
دع المساعد يضبط اختبارات الخادم الموجودة.
اتبع run-locally.txt مع المساعد. قبل الاختبار، تحقق من مشروع المصادقة المقصود وقيم المتصفح العامة وإعدادات مصادقة الخادم الخاصة وPRIVATE_NOTE الخيالية. شغّل المشروع كاملًا وافتح رابط الخادم الوسيط الفعلي؛ فلا تستطيع معاينة ملف عادية تشغيل حمايته.
فحوص جاهزية الحساب والخادم مطلوبة. قراءة تنفيذ الدالة اختيارية. يجب أن تتحقق الخدمة من جلسة الحساب قبل إرجاع الملاحظة؛ ولا يُعد إدخال طالب الطلب معرّف حساب آخر دليلًا على الهوية.
مثال عملي
هوية يرسلها المستخدم لا تعادل جلسة حساب مؤكدة.
Supabase: جلب مستخدم متحقق منه · Node.js: حالة دعم الإصدارات
جرّب بنفسك
أي خطوة إعداد اكتملت؟ وما عنوان التطبيق الفعلي الذي تستطيع اختباره؟
عرض حل نموذجي مشروح
مثال سجل جاهزية: «يعمل التطبيق المرفق عند رابط الخادم الوسيط المحلي الذي طبعه الخادم. أُعد مشروع المصادقة التدريبي وملاحظة الخادم الخيالية. والملاحظة غير موجودة في ملفات الصفحة العامة».
مثال سجل تعذر: «تفتح الصفحة، لكن الخادم يعرض Auth not configured؛ ويجب أن يفحص المساعد بيئة المزود الخاصة قبل اختبار الوصول». فتح الصفحة وحده لا يثبت حماية الخادم.
- يحدد عنوان التطبيق العامل وإعداد الخادم والمزود المكتمل.
- يذكر عائق إعداد محددًا دون نشر الملاحظة الخاصة أو بيانات الاعتماد.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
أرسل رمز جلسة إلى الخادم
يقدم العميل رمز حامل؛ ويتحقق منه الخادم بصورة مستقلة.
اضبط ملفات تسجيل الدخول وبيئة الخادم وفق 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: حالة دعم الإصدارات
Extra implementation exercise
هل يستطيع الخادم تفويض طلب بالثقة في userId من JSON المتصفح؟
عرض حل نموذجي مشروح
لا. يستطيع المتصفح تغيير ذلك الحقل. تحقق من بيانات الاعتماد واستخدم الهوية المتحقق منها.
- تتعامل مع ادعاءات هوية العميل على أنها غير موثوقة.
- تستخدم رمزًا متحققًا منه والهوية الناتجة.
خطأ شائع
فحص وجود نص رمز فقط.
الخطوة 3
اختبر الجمهور المسموح له
حدّد من ينبغي أن يستطيع قراءة هذا العنصر بعينه.
سجّل الدخول بحساب اختبار تتحكم به واطلب الملاحظة الوهمية. قاعدة هذا المختبر تسمح لأي مستخدم دخل بجلسة متحقق منها؛ اطلب من المساعد الحفاظ على هذا النطاق المعلن.
إن خزّنت لاحقًا بيانات حساب تخص شخصًا واحدًا، فلن تكفي تلك القاعدة الأوسع. حدّد الجمهور بدل افتراض تطابق صلاحيات كل البيانات الخاصة.
مثال عملي
تحتاج ملاحظة مشتركة للأعضاء وسجل حساب فردي إلى قرارَي وصول مختلفين.
جرّب بنفسك
من يُسمح له بقراءة ملاحظتك التجريبية؟ وهل طابق الطلب بعد الدخول تلك القاعدة؟
عرض حل نموذجي مشروح
مثال سجل وصول: «التحقق من حساب الاختبار A ناجح وقد استلم ملاحظة الأعضاء الخيالية. تسمح قاعدة المختبر لأي مستخدم موثّق ومسجل الدخول، لذا يدخل عضو تجريبي آخر موثّق ضمن الجمهور المسموح أيضًا».
هذه قاعدة لمحتوى مشترك بين الأعضاء. لا تكفي لملف A الشخصي الذي يجب قصره عليه؛ فذلك الحد المختلف يتطلب التحقق من الملكية.
- يوضح أن المختبر يسمح لأي مستخدم موثّق ومسجل الدخول، وليس لمالك واحد للملاحظة فقط.
- يسجل نتيجة الحساب المسموح دون تعميم هذه القاعدة على البيانات الشخصية للحسابات.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
أعد البيانات المحمية المقصودة فقط
الهوية الصحيحة لا تمنح تلقائيًا وصولًا إلى سجلات كل المستخدمين.
يمنح هذا المثال الصغير كل مستخدم صالح في مشروع التدريب وصولًا إلى ملاحظة مشتركة واحدة. هذه قاعدة تفويض صريحة وليست تعريفًا عامًا للمحتوى الخاص.
تستخدم الاستجابة private, no-store للتخزين المؤقت، فلا ينبغي أن يحتفظ مخزن مشترك بالملاحظة. يستخدم درس ملف شخصي لاحق قواعد ملكية للسجلات الخاصة بكل مستخدم. لا توسّع هذا المعالج إلى تفريغ شامل لقاعدة البيانات.
مثال محلول
تُشتق viewerId الخاصة بالخادم من التحقق. وتأتي الملاحظة من بيئته، لا من بيانات مقدمة في الطلب.
Extra implementation exercise
إذا استُبدلت الملاحظة بتفاصيل حساب مستخدم آخر، فهل تظل قاعدة «أي مستخدم مسجّل الدخول» مناسبة؟
عرض حل نموذجي مشروح
لا. أضف قاعدة تطابق الهوية المصادَق عليها بالسجل أو الدور المطلوب. تسجيل الدخول وحده لا يمنح الوصول إلى حساب آخر.
- تميّز المصادقة عن التفويض على مستوى السجل.
- تشترط الملكية أو دورًا مناسبًا للبيانات الخاصة بكل مستخدم.
خطأ شائع
استخدام قاعدة صفحة خاصة مشتركة لسجلات حساسة خاصة بكل مستخدم.
الخطوة 4
جرّب المسار نفسه دون دخول
الطلب المباشر مهم بقدر أهمية الزر المعتاد.
استخدم ملفًا شخصيًا في المتصفح تأكدت من عدم تسجيل دخوله، أو سجل الخروج وتحقق من حالة الحساب، ثم اطلب من المساعد طلب الملاحظة نفسها مباشرةً. قد تشارك نافذة خاصة إضافية جلسة خاصة موجودة. كرر طلب الملاحظة بعد تسجيل دخول متحقق منه.
يجب ألا تتضمن نتيجة الطلب دون دخول الملاحظة، بينما ينبغي أن تستلمها الجلسة المسموح لها. ويجب أن يبقى فشل الطلب خطأً دون تسريب المحتوى.
مثال عملي
حذف رابط من القائمة لا يحمي العنوان الذي كان يفتحه.
جرّب بنفسك
ماذا أعادت كل محاولة مباشرة، دون الدخول وبعده؟
عرض حل نموذجي مشروح
مثال سجل طلب مباشر: «دون تسجيل دخول: أعاد مسار الملاحظة Sign in required ولم يُعد الملاحظة. وبعد الدخول بالحساب A: أعاد المسار نفسه الملاحظة الخيالية. ساعدني المساعد في فحص محتوى الاستجابتين دون مشاركة رموز الجلسات».
إذا تضمنت الاستجابة دون تسجيل دخول الملاحظة، فقد فشلت الحماية حتى لو أخفتها الصفحة. وإذا كانت خدمة المصادقة غير متاحة، فسجل ذلك الفشل منفصلًا عن رفض طلب عادي.
- يقارن مسار الملاحظة نفسه بطلب دون تسجيل دخول وطلب مسموح بعد الدخول.
- يتحقق من أن الاستجابات المرفوضة أو الفاشلة لا تحتوي على نص الملاحظة الخاصة.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
جرّب نقطة النهاية دون الواجهة
يستهدف اختبار وصول حقيقي طلب البيانات مباشرة.
اطلب رابط الدالة في نافذة جديدة دون رأس Authorization؛ ينبغي ألا يعيد الملاحظة. جرّب رمز حامل مشوهًا، ثم استخدم واجهة مسجّلة الدخول لإرسال طلب مصرح به.
سجّل الخروج وتحقق من أن التطبيق يمحو الملاحظة المعروضة ولا يرسل رمز جلسة مجددًا. قد يبقى رمز صدر سابقًا صالحًا حتى انتهاء مدته المعدّة؛ الإلغاء العالمي الفوري متطلب منفصل.
مثال محلول
يبرهن طلب مباشر مرفوض أكثر من لقطة شاشة لزر دخول. احتفظ في سجلك بحالة الاستجابة وما إذا كان النص المحمي موجودًا.
Extra implementation exercise
يعيد طلب مباشر 401 دون ملاحظة، بينما تتلقى جلسة متحقق منها الملاحظة. أي حد اختبرت؟
عرض حل نموذجي مشروح
اختبرت أن نقطة النهاية هذه تتحقق من الهوية قبل إعادة الملاحظة المشتركة. تحتاج نقاط النهاية الأخرى وقواعد الملكية إلى اختباراتها الخاصة.
- تحدد حد استجابة الخادم.
- لا تدعي إلغاء رموز شاملًا أو تفويضًا خاصًا بكل مستخدم يتجاوز المثال.
خطأ شائع
اختبار المسار الناجح عبر أزرار المتصفح فقط.
الخطوة 5
احمِ قيمة تجريبية أخرى
كرّر الاختبارات نفسها بعد تعديل صغير.
اطلب من المساعد إضافة قيمة وهمية ثانية محفوظة على الخادم وحده باستخدام قاعدة الجمهور المقصودة نفسها. لا تنقل أيًا من القيمتين إلى الملفات العامة للتسهيل.
كرّر ملاحظات السماح والرفض والفشل. أزل المعلومات الحساسة من التسليم، وحدّد أي اختبار لم تنفذه.
مثال عملي
ينبغي ألا تجعل إضافة حقل آخر الملاحظة الخاصة الأصلية عامة بالخطأ.
جرّب بنفسك
مواد البداية
ملفات البداية ومحتوى الاختبار مرفقة. التحقق الفعلي يتطلب حسابك أو بريدك أو نطاقك وفق المتطلبات السابقة. الفحص المحلي ممكن؛ سجّل الخطوات الحية التي لم تنفّذها على أنها غير مختبرة.
قدّم حماية القيمة الجديدة ونتائج الوصول التي لاحظتها.
ما المطلوب إنجازه مسار التدريب الذي يعمل ونتائج الوصول الفعلية دون دخول وبعده وعند الخطأ.
عرض حل نموذجي مشروح
مثال سجل إضافة: «أضفت موقع اجتماع خياليًا بجوار ملاحظة الأعضاء الأصلية. استلم عضو تجريبي موثّق القيمتين، ولم يستلم الطلب المباشر دون دخول أيًا منهما. وعند تعطيل المصادقة عمدًا في الإعداد المؤقت، ظلت الاستجابة خطأ ولم تتضمن أي قيمة».
يمكن لسجل التسليم تحديد الحقلين وهذه النتائج دون نسخ محتواهما. إذا لم يُنفذ أحد اختبارات الفشل، فسجله كذلك، بدل اعتبار نجاح الدخول دليلًا على سلامة كل الحدود.
- يبقي القيمتين الخياليتين في الخادم فقط، وفق قاعدة المحتوى المشترك بين الأعضاء المعلنة.
- يعيد اختبار استجابات السماح والرفض وفشل الخدمة بعد إضافة القيمة الجديدة.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
مهمتك: أضف قيمة محمية ثانية
أبقِ القيمة الجديدة خارج الملفات العامة وطبّق فحوص الخادم نفسها.
أضف قيمة تدريب أخرى في بيئة الخادم، ولا تعدها إلا بعد التحقق، واعرضها بأمان كنص. أبقِ الاستجابة غير قابلة للتخزين المؤقت.
كرر اختبارات الرمز المفقود والرمز غير الصحيح والجلسة الصالحة. ابحث في المصدر العام لتأكيد عدم تضمين أي من القيمتين الخاصتين فيه.
مثال محلول
توسّع المهمة الاستجابة المحمية، لا كمية البيانات المرسلة قبل الدخول.
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
Extra implementation exercise
احمِ قيمة ثانية وقدّم أدلة وصول إيجابية وسلبية.
عرض حل نموذجي مشروح
استدعِ نقطة نهاية private-note مباشرة دون رأس Authorization: توقع 401 وعدم وجود ملاحظة. يجب أن يفشل رمز حامل مختلق أيضًا. لا تلبي userId في المتصفح أو زر مخفي فحص هوية الخادم.
مع رمز جلستك الفعلي المتحقق منه في مشروع تدريبك، توقع ملاحظة الخادم المعدّة وCache-Control: private, no-store. أبقِ الملاحظة خارج HTML/JavaScript العام. لا تلصق رمز حامل حقيقيًا في تقرير اختبار مشترك.
بعد تسجيل الخروج، ينبغي أن تمحو الواجهة المحتوى الخاص وتتوقف عن الطلبات المصادَق عليها. قد يظل رمز وصول نُسخ سابقًا قابلًا للاستخدام حتى انتهاء الصلاحية: سلوك واجهة تسجيل الخروج لا يضمن إلغاءً فوريًا. يفوّض مختبر الملاحظة المشتركة المستخدمين المسجّلين؛ أما الملكية الخاصة بكل مستخدم فتمرين الملف الشخصي المنفصل.
- تبقى القيمتان في الخادم حتى نجاح التفويض.
- لا تحتوي الطلبات المباشرة غير المصرح بها أيًا من القيمتين؛ ويُفحص الوصول الصحيح وسلوك no-store.
خطأ شائع
إضافة القيمة الثانية كثابت في المتصفح للتسهيل.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.
واصل التعلّم
- كيف تنشئ أول موقع شخصي لك
- كيف تنشر موقعك من GitHub
- كيف تربط نطاقًا مخصصًا بموقعك
- كيف تعدّ البريد على نطاقك الخاص
- كيف تجعل موقعك قابلًا للاستخدام على الهواتف
- كيف تجعل صور موقعك تُحمّل أسرع
- كيف تصلك ملاحظات الموقع إلى صندوق بريدك
- كيف تضيف اشتراكات البريد إلى موقعك
- كيف ترسل رسائل بريد آلية من موقعك
- كيف تحفظ إرساليات النماذج في قاعدة بيانات
- كيف تتيح للناس تسجيل الدخول إلى موقعك
- كيف تتيح للمستخدمين تعديل معلومات ملفاتهم الشخصية
- كيف تتيح للمستخدمين رفع الصور
- كيف تُبقي مفاتيح API خارج الواجهة الأمامية
- كيف تعرض بيانات من واجهة API خارجية على موقعك
- كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
- كيف تجعل روبوت محادثة يجيب من محتواك الخاص
- كيف تضيف مدونة إلى موقعك
- كيف تضيف بحثًا إلى موقعك
- كيف تضيف لغة أخرى إلى موقعك
- كيف تساعد Google على العثور على موقعك
- كيف تصلح معاينة موقعك عند مشاركة رابط
- كيف تقيس الزيارات والإجراءات المفيدة على موقعك
- كيف تتيح للزوار حجز موعد
- كيف تقبل دفعة مالية على موقعك
- كيف تعاين تغييرات موقعك قبل النشر
- كيف تتراجع عن نشر موقع معطّل
- كيف تنسخ بيانات موقعك احتياطيًا وتستعيدها
- كيف تجد الأخطاء في موقعك المنشور وتصلحها