الدروسكيف تتيح للناس تسجيل الدخول إلى موقعك

درس مصغّر 11 من 30 · الحسابات والوصول

افهم مسار تسجيل الدخول

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

لمن يريدون إتاحة تسجيل الدخول على موقع صغير. تتولى الخدمة المُدارة والتطبيق المرفق التنفيذ؛ ويمكنك العمل مع مساعد برمجة دون كتابة كود المصادقة.

استلام الرمز والدخول إلى الحساب لحظتان مختلفتان.

هدف هذا الدرس

  • اطلب رمز دخول حقيقيًا واستخدمه.
  • تحقق من حالتَي تسجيل الدخول والخروج.
  • اعرض الرموز الخاطئة والرسائل المفقودة بوصفها حالات فشل فعلية.
شرح ومثال محلول وتدريب

قبل أن تبدأ

تحتاج إلى مشروع Supabase التجريبي الخاص بك وصندوق اختبار مسموح أو مرسل مضبوط. استخدم الصفحة المرفقة عبر HTTP محلي أو استضافتك عبر HTTPS. يستطيع مساعد البرمجة إرشادك للإعداد وضبط رموز البريد.

تحقّق من مهارات البداية

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

  1. كيف تنشر موقعك من GitHub

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

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

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

افهم الفكرة

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

قول الصفحة «راجع بريدك» يعني تقديم طلب، ولا يعني أن هوية الزائر قد تحققت.

مثال عملي

عنوان البريد وحده لا يثبت أن صاحبه أكمل تسجيل الدخول.

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

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

ابدأ هناملفات ورشة العمل

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

جرّب بنفسك

ما الحالات الظاهرة التي ستفحصها بين إدخال العنوان والدخول الفعلي؟

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

إجابة توضيحية: «بعد Send sign-in code أتوقع رسالة قبول الطلب. ثم يجب أن أجد البريد. لا ينبغي أن تعرض الصفحة حسابي المسجل دخوله إلا بعد نجاح Verify code».

عبارة «راجع بريدك» تخص مرحلة الطلب. ولا تثبت وصول الرسالة أو وجود جلسة.

ما تتضمنه الإجابة السليمة

  • يفصل طلب الرسالة واستلام رمزها والتحقق من تسجيل الدخول.
  • يعدّ ظهور الحساب المتحقق منه دليل الجلسة، لا مجرد إدخال العنوان.
كيف يعمل؟ (اختياري)

أضف جلسة تسجيل دخول حقيقية

تتحقق المصادقة من الهوية؛ عرض عنوان بريد إلكتروني غير كافٍ.

سنستخدم Supabase Auth لإرسال رمز بريد لمرة واحدة وإنشاء جلسة بعد التحقق. تدير حزمة SDK في المتصفح تخزين الجلسة وتجديدها؛ ولا ننفذ قاعدة بيانات كلمات مرور.

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

مثال محلول

يجب ألا يمنح إدخال بريد شخص آخر في حقل صلاحيات ذلك الشخص. الرمز المرسل إلى صندوق البريد هو خطوة التحقق.

Supabase: رموز تسجيل الدخول بالبريد · Supabase: أنواع مفاتيح API

تمرين تقني إضافي

قبلت الصفحة عنوان بريد وتقول «Check your inbox». هل أصبح الزائر مصادَقًا عليه؟

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

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

  • تفصل حالة الطلب عن حالة التحقق.
  • تشترط نجاح التحقق ووجود جلسة.

الخطوة 1 · كيف تتيح للناس تسجيل الدخول إلى موقعك

جهّز المزود والصفحة

اختر مسار الرمز الذي يتوقعه النموذج المرفق.

شرح ومثال محلول وتدريب

افهم الفكرة

قبل الاختبار، اطلب من المساعد فحص أربعة متطلبات: مشروع Supabase التدريبي المقصود، وصندوق بريد تسمح به إعدادات المرسل، وقالب بريد يحتوي على رمز دخول، وتشغيل الصفحة المرفقة عبر HTTP. يجب أن يتوافق القالب مع واجهة إدخال الرمز، لا أن يقتصر على رابط دخول.

لا يخص public/config.js سوى رابط المشروع والمفتاح القابل للنشر. أبقِ المفاتيح السرية ومفاتيح service-role خارج ملفات المتصفح. فحوص المزود والتطبيق هذه مطلوبة؛ أما قراءة تنفيذ المصادقة أو إعادة كتابته فاختيارية.

مثال عملي

قد يعمل رابط البريد، لكنه يظل مسارًا غير مناسب لصفحة تطلب كتابة رمز.

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

ابدأ هناملفات ورشة العمل

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

جرّب بنفسك

هل طابق إعداد المزود والرسالة المستلمة نموذج إدخال الرمز؟

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

مثال سجل إعداد: «اختير المشروع التدريبي؛ ويتضمن قالب البريد رمز الدخول؛ ويحتوي public/config.js على رابط المشروع والمفتاح القابل للنشر فقط؛ وتفتح الصفحة عبر HTTP محلي».

مثال حالة متعذرة: «تفتح الصفحة، لكن البريد يحتوي على رابط فقط. يتعذر اختبار إدخال الرمز حتى يساعدني المساعد في تصحيح قالب المزود». لا يتضمن أي من السجلين مفتاحًا أو رمزًا قابلًا لإعادة الاستخدام.

ما تتضمنه الإجابة السليمة

  • يحدد المشروع التدريبي وقالب البريد الذي يحتوي على الرمز وجاهزية المعاينة عبر HTTP.
  • يميز إعدادات المشروع العامة عن المفاتيح السرية، ويذكر أي خطوة إعداد متعذرة.
كيف يعمل؟ (اختياري)

اضبط المزوّد وعميل المتصفح

يجب أن يطابق قالب البريد ونوع المفتاح مسار الرمز المرفق.

فعّل مصادقة Email في مشروع Supabase منفصل. تحقق من قدرة مرسله على التسليم إلى صندوق اختبارك؛ واضبط SMTP مدعومًا عند الحاجة. أدرج {{ .Token }} في قالب بريد Magic Link حتى توفر الرسالة الرمز الذي تتوقعه هذه الصفحة.

ضع رابط المشروع والمفتاح القابل للنشر في config.js. يعرّف هذا المفتاح التطبيق؛ وليس جلسة مستخدم أو سرًا إداريًا. لا تضع أبدًا مفتاحًا سريًا أو مفتاح service-role في ملف المتصفح هذا. قدّم public/ عبر HTTP/HTTPS كي تعمل استيرادات الوحدات.

تتوقع الصفحة رمز بريد يُكتب يدويًا (OTP). يعرض {{ .Token }} ذلك الرمز في قالب بريد المزوّد؛ أما القالب الذي يحتوي فقط على متغير رابط تأكيد فلن يعطي هذه الواجهة الرمز الذي تطلبه. استخدم الدليل الحالي للبريد دون كلمة مرور لتحديد مكان القالب بدل تخمين اسم إعداد.

يوضح دليل Supabase الرسمي «With OTP» صراحة أن رموز البريد تشترك مع Magic Link في التنفيذ: عدّل قالب بريد Magic Link ليشمل {{ .Token }}. لا يعني الاسم أن هذه الصفحة ينبغي أن تتلقى رسالة تحتوي على رابط فقط. اتبع ذلك الدليل إذا اختلفت تسميات لوحة التحكم؛ ولا تختلق إعداد قالب غير ذي صلة.

مثال محلول

تسمى طريقة SDK بـsignInWithOtp، لكن البريد قد يحتوي على رابط أو رمز بحسب القالب. تتوقع واجهتنا نسخة الرمز.

تمرين تقني إضافي

تطلب صفحتك رمزًا، لكن البريد يحتوي على رابط سحري فقط. ما الذي ينبغي فحصه؟

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

افحص القالب المعدّ بحثًا عن قيمة Token، وكرر الطلب بعد مواءمته مع واجهة الرمز. اتبع وثائق المزوّد الحالية لمشروعك.

  • تفحص قالب البريد والمسار المقصود.
  • لا تختلق رمزًا أو تدعي التحقق من الرسالة.

الخطوة 2 · كيف تتيح للناس تسجيل الدخول إلى موقعك

أكمل تسجيل دخول حقيقيًا واحدًا

استخدم الرسالة الفعلية بدل رمز مختلق.

شرح ومثال محلول وتدريب

افهم الفكرة

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

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

مثال عملي

عرض علامة نجاح لطيفة بعد رفض الرمز يقدّم صورة خاطئة عن حالة الحساب.

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

ابدأ هناملفات ورشة العمل

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

جرّب بنفسك

في جلسة تصفح خاص جديدة دون تسجيل دخول، ماذا حدث مع الرمز الخاطئ ثم مع رمز بريد حقيقي جديد؟

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

مثال سجل اختبار: «في جلسة تصفح خاص جديدة، أظهر الرمز الخاطئ Code was not accepted، وظلت الصفحة تعرض No signed-in account. طلبت بعدها رمز بريد جديدًا وتحققت منه، ثم ظهرت هوية حسابي التجريبي».

إذا لم يصل البريد، فسجل صالح هو: «قُبل الطلب؛ ولم أجد رمزًا في الصندوق المسموح أو الرسائل غير المرغوبة؛ ولم أنفذ تحققًا ناجحًا». اختبار رمز خاطئ وأنت مسجل الدخول مسبقًا لا يثبت منع إنشاء جلسة جديدة.

ما تتضمنه الإجابة السليمة

  • يختبر رمزًا خاطئًا دون جلسة دخول، ويسجل أنه لم يُنشئ تسجيل دخول.
  • يستخدم رمزًا حقيقيًا جديدًا بعد ذلك، ويتحقق من هوية الحساب الناتجة.
كيف يعمل؟ (اختياري)

اطلب رمزًا وتحقق منه

يقابل كل زر انتقال حالة مختلفًا.

اقرأ public/app.js. يستدعي الإجراء الأول signInWithOtp بالبريد المُدخل؛ ويستدعي الثاني verifyOtp بذلك البريد والرمز المستلم. تتضمن النتيجة الناجحة جلسة.

استخدم صندوق بريدك وانسخ الرمز الحالي بدقة. ينبغي أن يُبقي الرمز الخاطئ أو المنتهي أو المستخدم سابقًا المستخدم غير مسجّل الدخول. لا تسجّل الرموز أو رموز الوصول في تقرير مشترك.

مثال محلول

تستخدم الواجهة textContent لنص الحالة والحساب. ولا تفسر عنوان البريد بوصفه HTML.

const {data,error}=await client.auth.verifyOtp({email,token,type:'email'});
if(error || !data.session) { /* keep the unverified state */ }

تمرين تقني إضافي

يعيد رمز غير صحيح خطأ، لكن تطبيقك يعرض «Signed in» رغم ذلك. ما الشرط الذي يجب تغييره؟

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

اعرض حالة تسجيل الدخول فقط عندما ينجح التحقق وتوجد جلسة. لا تستخدم نقرة الزر نفسها دليلًا.

  • تفحص الخطأ المُرجع والجلسة.
  • تفصل الفشل عن المصادقة الناجحة.

الخطوة 3 · كيف تتيح للناس تسجيل الدخول إلى موقعك

افحص إعادة التحميل والخروج

تأكد أن الحالة الظاهرة تتبع الجلسة الفعلية.

شرح ومثال محلول وتدريب

افهم الفكرة

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

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

مثال عملي

ينبغي ألا تستمر الصفحة بعد الخروج في التصرف بصلاحيات الحساب السابق لمجرد بقاء تسمية ظاهرة.

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

ابدأ هناملفات ورشة العمل

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

جرّب بنفسك

ما حالة الحساب التي ظهرت بعد إعادة التحميل، وبعد تسجيل الخروج، وفي جلسة تصفح خاص جديدة؟

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

مثال سجل جلسة: «بقي حساب الاختبار A ظاهرًا بعد إعادة التحميل. غيّر Sign out الهوية إلى No signed-in account. ولم يظهر أي حساب في ملف شخصي مستقل في المتصفح أيضًا».

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

ما تتضمنه الإجابة السليمة

  • يسجل حالة الحساب بعد إعادة التحميل وبعد إجراء تسجيل الخروج.
  • يفحص ملفًا شخصيًا مستقلًا في المتصفح أو جلسة تصفح خاص بدأت من جديد، بدل افتراض استقلال نافذة إضافية.
كيف يعمل؟ (اختياري)

افحص استمرار الجلسة وتسجيل الخروج

اختبر أكثر من الرمز الصحيح الأول.

حدّث الصفحة بعد تسجيل الدخول وافحص حالة الحساب. ثم سجّل الخروج وحدّث مجددًا. استخدم نافذة خاصة للتحقق من أن متصفحًا آخر لا يرث الجلسة تلقائيًا.

يمحو تسجيل الخروج جلسة هذا العميل؛ ولا يعني أن كل رمز وصول منسوخ في أي مكان يتوقف فورًا عن العمل. يهم عمر رمز الوصول وسلوك إلغائه عند إنشاء نقاط نهاية خادم محمية.

مثال محلول

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

تمرين تقني إضافي

هل يكفي إخفاء زر Sign in لحماية مستند خاص؟

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

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

  • تفصل حالة الواجهة عن التفويض في الخادم.
  • تشترط فحوص الوصول في طلب المستند.

الخطوة 4 · كيف تتيح للناس تسجيل الدخول إلى موقعك

سجّل مسار الحساب كاملًا

اختم بملاحظات قابلة للتكرار، لا بمجرد لقطة نجاح.

شرح ومثال محلول وتدريب

افهم الفكرة

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

إن منعت قيود المرسل أو حدود الحساب الاختبار، فاذكر المرحلة بدقة. لا تستبدل رمزًا وصل فعلًا بمحاكاة محلية.

مثال عملي

يميّز التقرير المفيد بين غياب البريد وخطأ الرمز ونجاح التحقق.

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

ابدأ هناملفات ورشة العمل

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

جرّب بنفسك

قدّم اختبارات مسار الحساب وما بقي متعذرًا.

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

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

مثال سجل مكتمل: «وصل رمز إلى الصندوق التجريبي؛ ورُفض الرمز الخاطئ دون تسجيل دخول؛ وحدد رمز صحيح جديد الحساب A؛ وأبقت إعادة التحميل A؛ وأزال الخروج الهوية؛ ولم توجد جلسة في ملف شخصي مستقل في المتصفح».

مثال سجل غير مكتمل: «فشل طلب الرمز بسبب قيود المرسل لدى المزود. لم يُختبر الوصول أو التحقق؛ والإجراء التالي هو فحص المستلم المسموح وإعداد المرسل». يجب أن يبقى مسار الحساب المتعذر غير مكتمل، لا أن يُستبدل بدخول محلي وهمي.

ما تتضمنه الإجابة السليمة

  • يقدم ملاحظات الطلب والبريد والرمز الخاطئ والرمز الصحيح وإعادة التحميل والخروج بالترتيب.
  • يحدد أي خطوة بريد أو مزود مفقودة، ولا يضع الرموز أو رموز الجلسة في السجل.
كيف يعمل؟ (اختياري)

مهمتك: تحقق من رحلة الحساب كاملة

وثّق حالات الطلب والفشل وتسجيل الدخول وتسجيل الخروج.

اختبر رمزًا خاطئًا قبل إكمال تسجيل دخول صحيح. افحص سلوك التحديث وتسجيل الخروج ونافذة خاصة. استخدم صناديق بريد تتحكم بها فقط.

حسّن رسالة غامضة واحدة دون تغيير حقيقتها: الرمز المطلوب لا يزال معلقًا، والخطأ ليس جلسة ناجحة.

مثال محلول

ينبغي أن يحدد التقرير الحالات الملحوظة دون كشف الرمز المستلم أو رمز الحامل أو معلومات ملف شخصي خاصة.

يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.

تمرين تقني إضافي

أكمل رحلة الحساب واشرح ما الذي تثبته كل حالة لاحظتها.

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

اضبط رابط المشروع والمفتاح القابل للنشر، ثم قالبًا يحتوي على {{ .Token }} لتتضمن الرسالة الرمز الذي تتوقعه هذه الصفحة. اطلب رمزًا لصندوق بريدك. طلب بريد لا يعني وجود جلسة متحقق منها.

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

كرر من نافذة خاصة: يجب ألا ترث حالة تسجيل دخول النافذة الأولى. إخفاء زر لا يتعلق بحماية مستند؛ يجب أن يتحقق الخادم من التفويض قبل إعادة محتوى خاص.

  • تبقى حالتا الرمز الخاطئ وتسجيل الخروج دون مصادقة.
  • تستمر جلسة صحيحة وفق الإعداد، ويُتحقق من تسجيل خروج العميل بصدق.

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

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