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

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

اربط صفحة الدخول الجاهزة بخدمة حسابات مُدارة، واختبر رموز البريد وتسجيل الخروج والمحاولات الفاشلة.

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

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

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

قبل أن تبدأ

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

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

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

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

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

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

الخطوة 1

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

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

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

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

مثال عملي

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

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

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

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

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

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

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

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

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

مثال محلول

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

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

Extra implementation exercise

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

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

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

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

الخطوة 2

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

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

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

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

مثال عملي

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

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

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

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

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

فعّل مصادقة 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، لكن البريد قد يحتوي على رابط أو رمز بحسب القالب. تتوقع واجهتنا نسخة الرمز.

Extra implementation exercise

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

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

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

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

الخطوة 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)

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

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

اقرأ 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 */ }

Extra implementation exercise

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

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

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

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

الخطوة 4

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

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

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

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

مثال عملي

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

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

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

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

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

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

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

مثال محلول

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

Extra implementation exercise

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

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

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

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

الخطوة 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

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

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

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

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

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

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

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

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

واصل التعلّم

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