درس مصغّر · العربية

كيف تُبقي صفحة خاصة

استخدم مشروع الدخول الجاهز لإبقاء ملاحظة تجريبية خاصة، واختبر السماح بالوصول ورفضه.

ابدأ الدرس التفاعلياقرأ ملاحظات الدرس

لمن هذا الدرس؟

لمن يريدون إتاحة صفحة أو ملاحظة بعد الدخول فقط. يستطيع مساعد البرمجة ربط الحماية المرفقة؛ وبرمجة الخادم ليست متطلب التعلم.

قبل أن تبدأ

تحتاج إلى إعداد الدخول المرفق أو وصول مكافئ إلى Supabase، ومشروع منفصل لاستضافة الدوال، ومساعد برمجة. استخدم قيمة PRIVATE_NOTE وهمية محفوظة في بيئة الخادم فقط، ولا تستخدم محتوى خاصًا حقيقيًا أبدًا.

الوقت المتوقع: 20–32 دقيقة

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

ما الذي ستتعلمه؟

  • أبقِ المحتوى الخاص خارج الصفحة العامة.
  • اختبر المسار نفسه قبل الدخول وبعده.
  • افحص فشل الوصول دون كشف الملاحظة.

ملفات ورشة العمل

الخطوة 1

اختر ما يحتاج إلى حماية

الخصوصية تعني عدم إتاحة المحتوى لزائر غير مخوّل، وليس إخفاءه بصريًا فقط.

استخدم الملاحظة الوهمية والمشروع الجاهز المرفقين. اطلب من المساعد إبقاء الملاحظة على الخادم، لا داخل الصفحة العامة التي ينزّلها المتصفح.

يستطيع الزائر فحص الملفات العامة حتى لو كان أحد العناصر مخفيًا. لا تضع معلومات خاصة حقيقية في التمرين.

مثال عملي

فقرة تخفيها أنماط الصفحة تظل جزءًا من الملف العام.

استخدم حزمة الملاحظة الخاصة الكاملة هذه ومشروع الدخول المُدار التجريبي الخاص بي. أبقِ PRIVATE_NOTE في بيئة الخادم الخاصة فقط، وحافظ على اختبارات الوصول المرفقة. ساعدني في تشغيل التطبيق، ثم قارن الوصول المباشر دون دخول بالوصول بعد التحقق من الدخول. لا تعتبر إخفاء فقرة حماية، ولا تكشف بيانات شخص آخر.

ملفات هذه الخطوة

Start hereملفات ورشة العمل

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. هل هي خاصة؟

عرض حل نموذجي مشروح

لا. اضبط الوصول إلى استجابة الخادم قبل إرسال المحتوى. إخفاء قيمة مستلمة لا يجعلها سرية.

  • تدرك أن المتصفح تلقاها بالفعل.
  • تنقل التحكم في الوصول إلى ما قبل الاستجابة المحمية.

الخطوة 2

اربط الحماية الجاهزة

دع المساعد يضبط اختبارات الخادم الموجودة.

اتبع run-locally.txt مع المساعد. قبل الاختبار، تحقق من مشروع المصادقة المقصود وقيم المتصفح العامة وإعدادات مصادقة الخادم الخاصة وPRIVATE_NOTE الخيالية. شغّل المشروع كاملًا وافتح رابط الخادم الوسيط الفعلي؛ فلا تستطيع معاينة ملف عادية تشغيل حمايته.

فحوص جاهزية الحساب والخادم مطلوبة. قراءة تنفيذ الدالة اختيارية. يجب أن تتحقق الخدمة من جلسة الحساب قبل إرجاع الملاحظة؛ ولا يُعد إدخال طالب الطلب معرّف حساب آخر دليلًا على الهوية.

مثال عملي

هوية يرسلها المستخدم لا تعادل جلسة حساب مؤكدة.

Supabase: جلب مستخدم متحقق منه · Node.js: حالة دعم الإصدارات

ملفات هذه الخطوة

Start hereملفات ورشة العمل

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

اختبر الجمهور المسموح له

حدّد من ينبغي أن يستطيع قراءة هذا العنصر بعينه.

سجّل الدخول بحساب اختبار تتحكم به واطلب الملاحظة الوهمية. قاعدة هذا المختبر تسمح لأي مستخدم دخل بجلسة متحقق منها؛ اطلب من المساعد الحفاظ على هذا النطاق المعلن.

إن خزّنت لاحقًا بيانات حساب تخص شخصًا واحدًا، فلن تكفي تلك القاعدة الأوسع. حدّد الجمهور بدل افتراض تطابق صلاحيات كل البيانات الخاصة.

مثال عملي

تحتاج ملاحظة مشتركة للأعضاء وسجل حساب فردي إلى قرارَي وصول مختلفين.

ملفات هذه الخطوة

Start hereملفات ورشة العمل

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

جرّب المسار نفسه دون دخول

الطلب المباشر مهم بقدر أهمية الزر المعتاد.

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

يجب ألا تتضمن نتيجة الطلب دون دخول الملاحظة، بينما ينبغي أن تستلمها الجلسة المسموح لها. ويجب أن يبقى فشل الطلب خطأً دون تسريب المحتوى.

مثال عملي

حذف رابط من القائمة لا يحمي العنوان الذي كان يفتحه.

ملفات هذه الخطوة

Start hereملفات ورشة العمل

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

احمِ قيمة تجريبية أخرى

كرّر الاختبارات نفسها بعد تعديل صغير.

اطلب من المساعد إضافة قيمة وهمية ثانية محفوظة على الخادم وحده باستخدام قاعدة الجمهور المقصودة نفسها. لا تنقل أيًا من القيمتين إلى الملفات العامة للتسهيل.

كرّر ملاحظات السماح والرفض والفشل. أزل المعلومات الحساسة من التسليم، وحدّد أي اختبار لم تنفذه.

مثال عملي

ينبغي ألا تجعل إضافة حقل آخر الملاحظة الخاصة الأصلية عامة بالخطأ.

ملفات هذه الخطوة

Start hereملفات ورشة العمل

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.

هل أفادك هذا الدرس؟

اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.

واصل التعلّم

استكشف الدروس الأخرى