
درس مصغّر · العربية
كيف تتيح للناس تسجيل الدخول إلى موقعك
اربط صفحة الدخول الجاهزة بخدمة حسابات مُدارة، واختبر رموز البريد وتسجيل الخروج والمحاولات الفاشلة.
لمن هذا الدرس؟
لمن يريدون إتاحة تسجيل الدخول على موقع صغير. تتولى الخدمة المُدارة والتطبيق المرفق التنفيذ؛ ويمكنك العمل مع مساعد برمجة دون كتابة كود المصادقة.
قبل أن تبدأ
تحتاج إلى مشروع Supabase التجريبي الخاص بك وصندوق اختبار مسموح أو مرسل مضبوط. استخدم الصفحة المرفقة عبر HTTP محلي أو استضافتك عبر HTTPS. يستطيع مساعد البرمجة إرشادك للإعداد وضبط رموز البريد.
الوقت المتوقع: 20–32 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. قد يضيف تسليم البريد وإعداد الحساب وقت انتظار. يجب فحص قيود المزوّد وأعمار الجلسات في الحساب المستخدم للتدريب.
ما الذي ستتعلمه؟
- اطلب رمز دخول حقيقيًا واستخدمه.
- تحقق من حالتَي تسجيل الدخول والخروج.
- اعرض الرموز الخاطئة والرسائل المفقودة بوصفها حالات فشل فعلية.
الخطوة 1
افهم مسار تسجيل الدخول
استلام الرمز والدخول إلى الحساب لحظتان مختلفتان.
استخدم الصفحة الجاهزة مع مساعدك. يدخل الشخص عنوانه، ويستلم رمزًا، ثم يرسل الرمز قبل أن تنشئ الخدمة جلسة تسجيل الدخول.
قول الصفحة «راجع بريدك» يعني تقديم طلب، ولا يعني أن هوية الزائر قد تحققت.
مثال عملي
عنوان البريد وحده لا يثبت أن صاحبه أكمل تسجيل الدخول.
استخدم تطبيق Supabase للدخول المرفق. وجّهني لإعداد رموز البريد لدى المزود باستخدام صندوق اختبار أملك صلاحية استخدامه، وضع قيم المشروع القابلة للنشر وحدها في الإعداد العام، وشغّل الصفحة عبر HTTP. ساعدني في اختبار طلب الرمز وإدخاله وإعادة التحميل والخروج. يجب ألا يتحول رمز غير صالح أو بريد مفقود إلى حالة دخول وهمية.Supabase: رموز تسجيل الدخول بالبريد · Supabase: أنواع مفاتيح API
ملفات هذه الخطوة
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 خارج ملفات المتصفح. فحوص المزود والتطبيق هذه مطلوبة؛ أما قراءة تنفيذ المصادقة أو إعادة كتابته فاختيارية.
مثال عملي
قد يعمل رابط البريد، لكنه يظل مسارًا غير مناسب لصفحة تطلب كتابة رمز.
جرّب بنفسك
هل طابق إعداد المزود والرسالة المستلمة نموذج إدخال الرمز؟
عرض حل نموذجي مشروح
مثال سجل إعداد: «اختير المشروع التدريبي؛ ويتضمن قالب البريد رمز الدخول؛ ويحتوي public/config.js على رابط المشروع والمفتاح القابل للنشر فقط؛ وتفتح الصفحة عبر HTTP محلي».
مثال حالة متعذرة: «تفتح الصفحة، لكن البريد يحتوي على رابط فقط. يتعذر اختبار إدخال الرمز حتى يساعدني المساعد في تصحيح قالب المزود». لا يتضمن أي من السجلين مفتاحًا أو رمزًا قابلًا لإعادة الاستخدام.
- يحدد المشروع التدريبي وقالب البريد الذي يحتوي على الرمز وجاهزية المعاينة عبر HTTP.
- يميز إعدادات المشروع العامة عن المفاتيح السرية، ويذكر أي خطوة إعداد متعذرة.
ملفات هذه الخطوة
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
أكمل تسجيل دخول حقيقيًا واحدًا
استخدم الرسالة الفعلية بدل رمز مختلق.
ابدأ دون تسجيل دخول في جلسة تصفح خاص جديدة. اطلب رمزًا لصندوق تتحكم فيه وأدخل رمزًا خاطئًا عمدًا أولًا. تحقق من بقاء المحاولة مرفوضة ومن أن الصفحة ما زالت تعرض عدم وجود حساب مسجل دخوله. ثم اطلب رمزًا جديدًا وأدخل قيمته الحقيقية من البريد وافحص الحساب المعروض.
يجب ألا ينشئ الرمز المرفوض تسجيل دخول. إذا بدأت وأنت مسجل الدخول، فقد يترك الرمز الخاطئ الجلسة الموجودة كما هي؛ وهذه حالة أخرى لا تختبر منع إنشاء جلسة جديدة. إن لم يصل البريد، فسجل تلك المرحلة المتعذرة بدقة.
مثال عملي
عرض علامة نجاح لطيفة بعد رفض الرمز يقدّم صورة خاطئة عن حالة الحساب.
جرّب بنفسك
في جلسة تصفح خاص جديدة دون تسجيل دخول، ماذا حدث مع الرمز الخاطئ ثم مع رمز بريد حقيقي جديد؟
عرض حل نموذجي مشروح
مثال سجل اختبار: «في جلسة تصفح خاص جديدة، أظهر الرمز الخاطئ Code was not accepted، وظلت الصفحة تعرض No signed-in account. طلبت بعدها رمز بريد جديدًا وتحققت منه، ثم ظهرت هوية حسابي التجريبي».
إذا لم يصل البريد، فسجل صالح هو: «قُبل الطلب؛ ولم أجد رمزًا في الصندوق المسموح أو الرسائل غير المرغوبة؛ ولم أنفذ تحققًا ناجحًا». اختبار رمز خاطئ وأنت مسجل الدخول مسبقًا لا يثبت منع إنشاء جلسة جديدة.
- يختبر رمزًا خاطئًا دون جلسة دخول، ويسجل أنه لم يُنشئ تسجيل دخول.
- يستخدم رمزًا حقيقيًا جديدًا بعد ذلك، ويتحقق من هوية الحساب الناتجة.
ملفات هذه الخطوة
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 وافحص الهوية مجددًا. لاختبار جلسة مستقلة، استخدم ملفًا شخصيًا مستقلًا في المتصفح، أو أغلق كل النوافذ الخاصة قبل فتح نافذة جديدة؛ فقد تشارك النوافذ الخاصة الإضافية جلسة التصفح الخاص الموجودة.
تعرض نسخة البداية حالة الحساب؛ ولا تحتوي على مستند محمي للاختبار. إذا أضفت محتوى خاصًا لاحقًا، فيجب أن يتحقق الخادم من الوصول قبل إرجاعه. إخفاء زر وحده لا يوفر تلك الحماية.
مثال عملي
ينبغي ألا تستمر الصفحة بعد الخروج في التصرف بصلاحيات الحساب السابق لمجرد بقاء تسمية ظاهرة.
جرّب بنفسك
ما حالة الحساب التي ظهرت بعد إعادة التحميل، وبعد تسجيل الخروج، وفي جلسة تصفح خاص جديدة؟
عرض حل نموذجي مشروح
مثال سجل جلسة: «بقي حساب الاختبار A ظاهرًا بعد إعادة التحميل. غيّر Sign out الهوية إلى No signed-in account. ولم يظهر أي حساب في ملف شخصي مستقل في المتصفح أيضًا».
يوضح هذا التطبيق حالة الحساب، لا مستندًا خاصًا. إذا بقيت الجلسة بعد الخروج، فسجل ذلك الفشل؛ أما اختبار الوصول إلى المحتوى الخاص فموضوع درس الصفحة الخاصة.
- يسجل حالة الحساب بعد إعادة التحميل وبعد إجراء تسجيل الخروج.
- يفحص ملفًا شخصيًا مستقلًا في المتصفح أو جلسة تصفح خاص بدأت من جديد، بدل افتراض استقلال نافذة إضافية.
ملفات هذه الخطوة
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
سجّل مسار الحساب كاملًا
اختم بملاحظات قابلة للتكرار، لا بمجرد لقطة نجاح.
كرّر مسار العنوان والبريد والرمز بعد أي إصلاح. احفظ سجلًا للدخول وإعادة التحميل والخروج ومحاولة فاشلة مفيدة، بعد إزالة المعلومات الحساسة.
إن منعت قيود المرسل أو حدود الحساب الاختبار، فاذكر المرحلة بدقة. لا تستبدل رمزًا وصل فعلًا بمحاكاة محلية.
مثال عملي
يميّز التقرير المفيد بين غياب البريد وخطأ الرمز ونجاح التحقق.
جرّب بنفسك
مواد البداية
ملفات البداية ومحتوى الاختبار مرفقة. التحقق الفعلي يتطلب حسابك أو بريدك أو نطاقك وفق المتطلبات السابقة. الفحص المحلي ممكن؛ سجّل الخطوات الحية التي لم تنفّذها على أنها غير مختبرة.
قدّم اختبارات مسار الحساب وما بقي متعذرًا.
ما المطلوب إنجازه سجل موجز لمسار الحساب يشمل وصول الرمز الحقيقي والدخول وإعادة التحميل والخروج ومحاولة فاشلة.
عرض حل نموذجي مشروح
مثال سجل مكتمل: «وصل رمز إلى الصندوق التجريبي؛ ورُفض الرمز الخاطئ دون تسجيل دخول؛ وحدد رمز صحيح جديد الحساب A؛ وأبقت إعادة التحميل A؛ وأزال الخروج الهوية؛ ولم توجد جلسة في ملف شخصي مستقل في المتصفح».
مثال سجل غير مكتمل: «فشل طلب الرمز بسبب قيود المرسل لدى المزود. لم يُختبر الوصول أو التحقق؛ والإجراء التالي هو فحص المستلم المسموح وإعداد المرسل». يجب أن يبقى مسار الحساب المتعذر غير مكتمل، لا أن يُستبدل بدخول محلي وهمي.
- يقدم ملاحظات الطلب والبريد والرمز الخاطئ والرمز الصحيح وإعادة التحميل والخروج بالترتيب.
- يحدد أي خطوة بريد أو مزود مفقودة، ولا يضع الرموز أو رموز الجلسة في السجل.
ملفات هذه الخطوة
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 }} لتتضمن الرسالة الرمز الذي تتوقعه هذه الصفحة. اطلب رمزًا لصندوق بريدك. طلب بريد لا يعني وجود جلسة متحقق منها.
أدخل رمزًا خاطئًا وتأكد من عدم إنشاء جلسة مستخدم. استخدم رمزًا صحيحًا جديدًا، وتحقق من الهوية المعروضة، وأعد التحميل ولاحظ الجلسة. سجّل الخروج وتحقق من أن التبويب لم يعد يبلغ عن جلسة.
كرر من نافذة خاصة: يجب ألا ترث حالة تسجيل دخول النافذة الأولى. إخفاء زر لا يتعلق بحماية مستند؛ يجب أن يتحقق الخادم من التفويض قبل إعادة محتوى خاص.
- تبقى حالتا الرمز الخاطئ وتسجيل الخروج دون مصادقة.
- تستمر جلسة صحيحة وفق الإعداد، ويُتحقق من تسجيل خروج العميل بصدق.
خطأ شائع
تسليم لقطة شاشة تحتوي على رمز جلسة قابل لإعادة الاستخدام.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.
واصل التعلّم
- كيف تنشئ أول موقع شخصي لك
- كيف تنشر موقعك من GitHub
- كيف تربط نطاقًا مخصصًا بموقعك
- كيف تعدّ البريد على نطاقك الخاص
- كيف تجعل موقعك قابلًا للاستخدام على الهواتف
- كيف تجعل صور موقعك تُحمّل أسرع
- كيف تصلك ملاحظات الموقع إلى صندوق بريدك
- كيف تضيف اشتراكات البريد إلى موقعك
- كيف ترسل رسائل بريد آلية من موقعك
- كيف تحفظ إرساليات النماذج في قاعدة بيانات
- كيف تُبقي صفحة خاصة
- كيف تتيح للمستخدمين تعديل معلومات ملفاتهم الشخصية
- كيف تتيح للمستخدمين رفع الصور
- كيف تُبقي مفاتيح API خارج الواجهة الأمامية
- كيف تعرض بيانات من واجهة API خارجية على موقعك
- كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
- كيف تجعل روبوت محادثة يجيب من محتواك الخاص
- كيف تضيف مدونة إلى موقعك
- كيف تضيف بحثًا إلى موقعك
- كيف تضيف لغة أخرى إلى موقعك
- كيف تساعد Google على العثور على موقعك
- كيف تصلح معاينة موقعك عند مشاركة رابط
- كيف تقيس الزيارات والإجراءات المفيدة على موقعك
- كيف تتيح للزوار حجز موعد
- كيف تقبل دفعة مالية على موقعك
- كيف تعاين تغييرات موقعك قبل النشر
- كيف تتراجع عن نشر موقع معطّل
- كيف تنسخ بيانات موقعك احتياطيًا وتستعيدها
- كيف تجد الأخطاء في موقعك المنشور وتصلحها