يمكنك استخدام Firebase Authentication لتسجيل دخول مستخدم من خلال إرسال رسالة SMS إلى هاتف المستخدم. يسجّل المستخدم الدخول باستخدام رمز يُستخدم لمرة واحدة وارد في رسالة SMS.
أسهل طريقة لإضافة ميزة تسجيل الدخول باستخدام رقم الهاتف إلى تطبيقك هي استخدام FirebaseUI، الذي يتضمّن تطبيقًا مصغّرًا لتسجيل الدخول يتيح تنفيذ مسارات تسجيل الدخول باستخدام رقم الهاتف، بالإضافة إلى تسجيل الدخول المستند إلى كلمة المرور وتسجيل الدخول الموحّد. يوضّح هذا المستند كيفية تنفيذ عملية تسجيل الدخول باستخدام رقم الهاتف من خلال حزمة تطوير البرامج (SDK) لمنصة Firebase.
قبل البدء
إذا لم يسبق لك إجراء ذلك، انسخ مقتطف الإعداد من وحدة تحكّم Firebase إلى مشروعك كما هو موضّح في مقالة إضافة Firebase إلى مشروع JavaScript.المخاوف المرتبطة بالأمان
إنّ المصادقة باستخدام رقم الهاتف فقط، على الرغم من سهولتها، أقل أمانًا من الطرق الأخرى المتاحة، لأنّ ملكية رقم الهاتف يمكن نقلها بين المستخدمين. وعلى الأجهزة التي تتضمّن ملفات شخصية لتعدُّد المستخدمين، يمكن لأي مستخدم يتلقّى رسائل SMS تسجيل الدخول إلى حساب باستخدام رقم هاتف الجهاز.
إذا كنت تستخدم تسجيل الدخول المستند إلى رقم الهاتف في تطبيقك، فيجب عليك تقديمه إلى جانب طرق تسجيل الدخول الأكثر أمانًا، وإبلاغ المستخدمين بالمفاضلات الأمنية لاستخدام تسجيل الدخول برقم الهاتف.
تفعيل ميزة تسجيل الدخول باستخدام رقم الهاتف في مشروع Firebase
لتسجيل دخول المستخدمين عبر الرسائل القصيرة، عليك أولاً تفعيل طريقة تسجيل الدخول باستخدام رقم الهاتف في مشروع Firebase:
- في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.
- في علامة التبويب طريقة تسجيل الدخول، فعِّل موفّر تسجيل الدخول باستخدام الهاتف.
-
اضبط سياسة بشأن المناطق التي تريد السماح بإرسال رسائل SMS إليها أو حظرها. يمكن أن يساعد ضبط سياسة منطقة الرسائل القصيرة في حماية
تطبيقاتك من إساءة استخدام الرسائل القصيرة. بالنسبة إلى المشاريع الجديدة، لا تسمح السياسة التلقائية بأي مناطق.
- في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب الأمان > المصادقة > الإعدادات.
- في قسم سياسة منطقة الرسائل القصيرة، اضبط سياسة منطقة الرسائل القصيرة.
-
إذا لم يسبق لك ذلك، يمكنك تفويض نطاق تطبيقك:
- في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب الأمان > المصادقة > الإعدادات.
- في قسم النطاقات المسموح بها، انقر على إضافة نطاق، وأضِف نطاقك.
يُرجى العِلم أنّه لا يُسمح باستخدام localhost كنطاق مستضاف لأغراض المصادقة عبر الهاتف.
إعداد أداة التحقّق من reCAPTCHA
قبل أن تتمكّن من تسجيل دخول المستخدمين باستخدام أرقام هواتفهم، عليك إعداد أداة التحقّق من reCAPTCHA في Firebase. تستخدم Firebase خدمة reCAPTCHA لمنع إساءة الاستخدام، مثلاً من خلال التأكّد من أنّ طلب تأكيد رقم الهاتف وارد من أحد النطاقات المسموح بها في تطبيقك.
لا حاجة إلى إعداد عميل reCAPTCHA يدويًا، فعند استخدام عنصر RecaptchaVerifier في حزمة تطوير البرامج (SDK) لمنصّة Firebase، تنشئ Firebase تلقائيًا أي مفاتيح ورموز سرية ضرورية للعميل وتتعامل معها.
يتيح عنصر RecaptchaVerifier استخدام شارة reCAPTCHA غير المرئية التي يمكنها غالبًا التحقّق من المستخدم بدون الحاجة إلى أي إجراء من جانبه، بالإضافة إلى تطبيق reCAPTCHA المصغّر الذي يتطلّب دائمًا تفاعل المستخدم لإكمال عملية التحقّق بنجاح.
يمكن ترجمة خدمة reCAPTCHA الأساسية المعروضة إلى لغة المستخدم المفضّلة من خلال تعديل رمز اللغة في مثيل المصادقة قبل عرض reCAPTCHA. ستنطبق أيضًا عملية الأقلمة المذكورة أعلاه على رسالة SMS التي يتم إرسالها إلى المستخدم والتي تحتوي على رمز التحقّق.
Web
import { getAuth } from "firebase/auth"; const auth = getAuth(); auth.languageCode = 'it'; // To apply the default browser preference instead of explicitly setting it. // auth.useDeviceLanguage();
Web
firebase.auth().languageCode = 'it'; // To apply the default browser preference instead of explicitly setting it. // firebase.auth().useDeviceLanguage();
استخدام شارة reCAPTCHA غير مرئية
لاستخدام شارة reCAPTCHA غير مرئية، أنشئ عنصر RecaptchaVerifier
مع ضبط المَعلمة size على invisible، مع تحديد
رقم تعريف الزر الذي يرسل نموذج تسجيل الدخول. على سبيل المثال:
Web
import { getAuth, RecaptchaVerifier } from "firebase/auth"; const auth = getAuth(); window.recaptchaVerifier = new RecaptchaVerifier(auth, 'sign-in-button', { 'size': 'invisible', 'callback': (response) => { // reCAPTCHA solved, allow signInWithPhoneNumber. onSignInSubmit(); } });
Web
window.recaptchaVerifier = new firebase.auth.RecaptchaVerifier('sign-in-button', { 'size': 'invisible', 'callback': (response) => { // reCAPTCHA solved, allow signInWithPhoneNumber. onSignInSubmit(); } });
استخدام تطبيق reCAPTCHA المصغّر
لاستخدام تطبيق reCAPTCHA المصغّر المرئي، أنشئ عنصرًا على صفحتك
ليحتوي على التطبيق المصغّر، ثم أنشئ كائن RecaptchaVerifier
مع تحديد معرّف الحاوية عند إجراء ذلك. على سبيل المثال:
Web
import { getAuth, RecaptchaVerifier } from "firebase/auth"; const auth = getAuth(); window.recaptchaVerifier = new RecaptchaVerifier(auth, 'recaptcha-container', {});
Web
window.recaptchaVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container');
اختياري: تحديد مَعلمات reCAPTCHA
يمكنك اختياريًا ضبط دوال رد الاتصال على العنصر RecaptchaVerifier الذي يتم استدعاؤه عندما يحلّ المستخدم اختبار reCAPTCHA أو عندما تنتهي صلاحية reCAPTCHA قبل أن يرسل المستخدم النموذج:
Web
import { getAuth, RecaptchaVerifier } from "firebase/auth"; const auth = getAuth(); window.recaptchaVerifier = new RecaptchaVerifier(auth, 'recaptcha-container', { 'size': 'normal', 'callback': (response) => { // reCAPTCHA solved, allow signInWithPhoneNumber. // ... }, 'expired-callback': () => { // Response expired. Ask user to solve reCAPTCHA again. // ... } });
Web
window.recaptchaVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container', { 'size': 'normal', 'callback': (response) => { // reCAPTCHA solved, allow signInWithPhoneNumber. // ... }, 'expired-callback': () => { // Response expired. Ask user to solve reCAPTCHA again. // ... } });
اختياري: عرض reCAPTCHA مسبقًا
إذا أردت عرض reCAPTCHA مسبقًا قبل إرسال طلب تسجيل الدخول،
استخدِم render:
Web
recaptchaVerifier.render().then((widgetId) => { window.recaptchaWidgetId = widgetId; });
Web
recaptchaVerifier.render().then((widgetId) => { window.recaptchaWidgetId = widgetId; });
بعد حلّ render، ستحصل على رقم تعريف تطبيق reCAPTCHA المصغّر الذي يمكنك استخدامه لإجراء طلبات إلى واجهة برمجة تطبيقات reCAPTCHA:
Web
const recaptchaResponse = grecaptcha.getResponse(recaptchaWidgetId);
Web
const recaptchaResponse = grecaptcha.getResponse(recaptchaWidgetId);
إرسال رمز تحقّق إلى هاتف المستخدم
لبدء تسجيل الدخول باستخدام رقم الهاتف، اعرض للمستخدم واجهة تطلب منه تقديم رقم هاتفه، ثم اتصل بالرقم signInWithPhoneNumber لطلب إرسال Firebase رمز مصادقة إلى هاتف المستخدم عبر رسالة قصيرة SMS:
-
الحصول على رقم هاتف المستخدم
تختلف المتطلبات القانونية، ولكن كأفضل ممارسة ولوضع توقعات للمستخدمين، يجب إبلاغهم أنه إذا استخدموا تسجيل الدخول عبر الهاتف، فقد يتلقون رسالة SMS للتحقق والأسعار القياسية تطبق.
- اتصِل بـ
signInWithPhoneNumber، مع تمرير رقم هاتف المستخدم وRecaptchaVerifierالذي أنشأته سابقًا.إذا أدّىWeb
import { getAuth, signInWithPhoneNumber } from "firebase/auth"; const phoneNumber = getPhoneNumberFromUserInput(); const appVerifier = window.recaptchaVerifier; const auth = getAuth(); signInWithPhoneNumber(auth, phoneNumber, appVerifier) .then((confirmationResult) => { // SMS sent. Prompt user to type the code from the message, then sign the // user in with confirmationResult.confirm(code). window.confirmationResult = confirmationResult; // ... }).catch((error) => { // Error; SMS not sent // ... });
Web
const phoneNumber = getPhoneNumberFromUserInput(); const appVerifier = window.recaptchaVerifier; firebase.auth().signInWithPhoneNumber(phoneNumber, appVerifier) .then((confirmationResult) => { // SMS sent. Prompt user to type the code from the message, then sign the // user in with confirmationResult.confirm(code). window.confirmationResult = confirmationResult; // ... }).catch((error) => { // Error; SMS not sent // ... });
signInWithPhoneNumberإلى حدوث خطأ، أعِد ضبط reCAPTCHA ليتمكّن المستخدم من المحاولة مرة أخرى:grecaptcha.reset(window.recaptchaWidgetId); // Or, if you haven't stored the widget ID: window.recaptchaVerifier.render().then(function(widgetId) { grecaptcha.reset(widgetId); });
تُصدر طريقة signInWithPhoneNumber تحدّي reCAPTCHA للمستخدم، وإذا اجتاز المستخدم التحدّي، تطلب من Firebase Authentication إرسال رسالة SMS تحتوي على رمز تحقّق إلى هاتف المستخدم.
تسجيل دخول المستخدم باستخدام رمز التحقّق
بعد نجاح المكالمة إلى signInWithPhoneNumber، اطلب من
المستخدم كتابة رمز التحقّق الذي تلقّاه عبر رسالة قصيرة SMS. بعد ذلك، سجِّل دخول المستخدم من خلال تمرير الرمز إلى الإجراء confirm الخاص بالعنصر ConfirmationResult الذي تم تمريره إلى معالج التنفيذ في signInWithPhoneNumber (أي مجموعة الرموز البرمجية then). على سبيل المثال:
Web
const code = getCodeFromUserInput(); confirmationResult.confirm(code).then((result) => { // User signed in successfully. const user = result.user; // ... }).catch((error) => { // User couldn't sign in (bad verification code?) // ... });
Web
const code = getCodeFromUserInput(); confirmationResult.confirm(code).then((result) => { // User signed in successfully. const user = result.user; // ... }).catch((error) => { // User couldn't sign in (bad verification code?) // ... });
إذا نجح طلب البيانات من confirm، يتم تسجيل دخول المستخدم بنجاح.
الحصول على عنصر AuthCredential الوسيط
إذا كنت بحاجة إلى الحصول على عنصر AuthCredential لحساب المستخدم، يمكنك تمرير رمز التحقّق من نتيجة التأكيد ورمز التحقّق إلى PhoneAuthProvider.credential بدلاً من استدعاء confirm:
var credential = firebase.auth.PhoneAuthProvider.credential(confirmationResult.verificationId, code);
بعد ذلك، يمكنك تسجيل دخول المستخدم باستخدام بيانات الاعتماد:
firebase.auth().signInWithCredential(credential);
الاختبار باستخدام أرقام هواتف وهمية
يمكنك إعداد أرقام هواتف وهمية لأغراض التطوير باستخدام وحدة تحكّم Firebase. يوفّر الاختبار باستخدام أرقام هواتف وهمية المزايا التالية:
- اختبِر مصادقة رقم الهاتف بدون استهلاك حصة الاستخدام.
- اختبِر مصادقة رقم الهاتف بدون إرسال رسالة SMS فعلية.
- يمكنك إجراء اختبارات متتالية باستخدام رقم الهاتف نفسه بدون أن يتم تقييدها. يؤدي ذلك إلى تقليل احتمالية رفض التطبيق أثناء عملية مراجعة متجر التطبيقات إذا استخدم المراجع رقم الهاتف نفسه لإجراء الاختبار.
- يمكنك إجراء الاختبار بسهولة في بيئات التطوير بدون أي جهد إضافي، مثل إمكانية التطوير في محاكي iOS أو Android Emulator بدون "خدمات Google Play".
- كتابة اختبارات التكامل بدون أن يتم حظرها من خلال عمليات التحقّق من الأمان التي يتم تطبيقها عادةً على أرقام الهواتف الحقيقية في بيئة التشغيل الفعلي
يجب أن تستوفي أرقام الهواتف الخيالية المتطلبات التالية:
- تأكَّد من استخدام أرقام هواتف وهمية وغير موجودة حاليًا. لا يسمح لك Firebase Authentication بضبط أرقام الهواتف الحالية التي يستخدمها مستخدمون حقيقيون كأرقام اختبارية. أحد الخيارات هو استخدام أرقام تبدأ بالبادئة 555 كأرقام هواتف اختبارية في الولايات المتحدة، على سبيل المثال: +1 650-555-3434
- يجب أن تكون أرقام الهواتف منسَّقة بشكل صحيح من حيث الطول والقيود الأخرى. وستظل تخضع لعملية التحقّق نفسها التي يخضع لها رقم هاتف المستخدم الحقيقي.
- يمكنك إضافة ما يصل إلى 10 أرقام هواتف لأغراض التطوير.
- استخدِم أرقام هواتف أو رموزًا تجريبية يصعب تخمينها وغيِّرها بشكل متكرر.
إنشاء أرقام هواتف ورموز تحقّق وهمية
- في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.
- في علامة التبويب طريقة تسجيل الدخول (Sign-in method)، فعِّل مزوّد خدمة تسجيل الدخول الهاتف (Phone) إذا لم يسبق لك تفعيله.
- وسِّع قسم أرقام الهواتف المخصّصة للاختبار.
-
أدخِل رقم الهاتف الذي تريد اختباره، على سبيل المثال:
+1 650-555-3434. -
أدخِل رمز التحقّق المكوّن من 6 أرقام لهذا الرقم المحدّد، على سبيل المثال:
654321. - انقر على إضافة لكل رقم. إذا لزم الأمر، يمكنك حذف رقم الهاتف والرمز الخاص به من خلال تمرير مؤشر الماوس فوق الصف المقابل والنقر على رمز المهملات.
الاختبار اليدوي
يمكنك البدء مباشرةً في استخدام رقم هاتف وهمي في تطبيقك. يتيح لك ذلك إجراء اختبار يدوي خلال مراحل التطوير بدون مواجهة مشاكل في الحصص أو تقييد السرعة. يمكنك أيضًا إجراء الاختبار مباشرةً من محاكي iOS أو Android Emulator بدون تثبيت "خدمات Google Play".
عند تقديم رقم الهاتف الوهمي وإرسال رمز التحقّق، لا يتم إرسال أي رسالة قصيرة فعلية. بدلاً من ذلك، عليك تقديم رمز التحقّق الذي تم ضبطه مسبقًا لإكمال عملية تسجيل الدخول.
عند اكتمال تسجيل الدخول، يتم إنشاء مستخدم Firebase باستخدام رقم الهاتف هذا. يتّبع المستخدم السلوك نفسه الذي يتّبعه مستخدم رقم الهاتف الحقيقي، وله الخصائص نفسها، ويمكنه الوصول إلى Realtime Database/Cloud Firestore والخدمات الأخرى بالطريقة نفسها. ويحمل رمز التعريف المميّز الذي تم إنشاؤه خلال هذه العملية التوقيع نفسه الذي يحمله مستخدم رقم هاتف حقيقي.
هناك خيار آخر يتمثّل في ضبط دور اختبار من خلال المطالبات المخصّصة لهؤلاء المستخدمين لتمييزهم كمستخدمين مزيّفين إذا أردت فرض قيود إضافية على الوصول.
اختبار التكامل
بالإضافة إلى الاختبار اليدوي، يوفّر Firebase Authentication واجهات برمجة تطبيقات للمساعدة في كتابة اختبارات التكامل لاختبار المصادقة عبر الهاتف. تؤدي واجهات برمجة التطبيقات هذه إلى إيقاف ميزة "التحقّق من التطبيقات" من خلال إيقاف متطلبات reCAPTCHA في الويب والإشعارات الفورية الصامتة في نظام التشغيل iOS. يتيح ذلك إجراء اختبارات التشغيل الآلي في هذه المسارات ويسهّل تنفيذها. بالإضافة إلى ذلك، تساعد هذه الأدوات في توفير إمكانية اختبار عمليات التحقّق الفوري على Android.
على الويب، اضبط appVerificationDisabledForTesting على
true قبل عرض firebase.auth.RecaptchaVerifier. يؤدي ذلك إلى حلّ اختبار reCAPTCHA تلقائيًا، ما يتيح لك تجاوز رقم الهاتف بدون حلّه يدويًا. يُرجى العِلم أنّه حتى في حال إيقاف reCAPTCHA، لن تنجح عملية تسجيل الدخول إذا تم استخدام رقم هاتف غير وهمي. يمكن استخدام أرقام هواتف وهمية فقط مع واجهة برمجة التطبيقات هذه.
// Turn off phone auth app verification. firebase.auth().settings.appVerificationDisabledForTesting = true; var phoneNumber = "+16505554567"; var testVerificationCode = "123456"; // This will render a fake reCAPTCHA as appVerificationDisabledForTesting is true. // This will resolve after rendering without app verification. var appVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container'); // signInWithPhoneNumber will call appVerifier.verify() which will resolve with a fake // reCAPTCHA response. firebase.auth().signInWithPhoneNumber(phoneNumber, appVerifier) .then(function (confirmationResult) { // confirmationResult can resolve with the fictional testVerificationCode above. return confirmationResult.confirm(testVerificationCode) }).catch(function (error) { // Error; SMS not sent // ... });
تختلف طريقة عمل أدوات التحقّق من التطبيقات في reCAPTCHA الوهمية المرئية وغير المرئية عندما تكون ميزة "التحقّق من التطبيقات" غير مفعَّلة:
- reCAPTCHA المرئي: عندما يتم عرض reCAPTCHA المرئي من خلال
appVerifier.render()، يتم حلّه تلقائيًا بعد تأخير لجزء من الثانية. ويعادل ذلك نقر المستخدم على reCAPTCHA فور عرضه. ستنتهي صلاحية استجابة reCAPTCHA بعد مرور بعض الوقت، ثم يتم حلّها تلقائيًا مرة أخرى. - شارة reCAPTCHA غير مرئية:
لا يتم حلّ شارة reCAPTCHA غير المرئية تلقائيًا عند العرض، بل يتم حلّها عند
appVerifier.verify()الطلب أو عند النقر على زر الارتساء لشارة reCAPTCHA بعد تأخير لجزء من الثانية. وبالمثل، ستنتهي صلاحية الاستجابة بعد مرور بعض الوقت، ولن يتم حلّها تلقائيًا إلا بعد استدعاءappVerifier.verify()أو عند النقر على زر الارتساء في reCAPTCHA مرة أخرى.
عندما يتم حلّ اختبار reCAPTCHA وهمي، يتم تشغيل دالة رد الاتصال المقابلة كما هو متوقع مع الاستجابة المزيفة. إذا تم أيضًا تحديد دالة استدعاء لانتهاء الصلاحية، سيتم تفعيلها عند انتهاء الصلاحية.
الخطوات التالية
بعد أن يسجّل المستخدم الدخول لأول مرة، يتم إنشاء حساب مستخدم جديد وربطه ببيانات الاعتماد التي استخدمها لتسجيل الدخول، أي اسم المستخدم وكلمة المرور أو رقم الهاتف أو معلومات موفّر المصادقة. يتم تخزين هذا الحساب الجديد كجزء من مشروع Firebase، ويمكن استخدامه لتحديد هوية المستخدم في كل تطبيق في مشروعك، بغض النظر عن كيفية تسجيل المستخدم الدخول.
-
في تطبيقاتك، الطريقة المقترَحة لمعرفة حالة مصادقة المستخدم هي ضبط مراقِب على عنصر
Auth. يمكنك بعد ذلك الحصول على معلومات الملف الشخصي الأساسية للمستخدم من الكائنUser. يُرجى الاطّلاع على إدارة المستخدمين. في قواعد الأمان في Firebase Realtime Database وCloud Storage، يمكنك الحصول على رقم تعريف المستخدم الفريد للمستخدم الذي سجّل الدخول من المتغيّر
auth، واستخدامه للتحكّم في البيانات التي يمكن للمستخدم الوصول إليها.
يمكنك السماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام عدة موفّري مصادقة من خلال ربط بيانات اعتماد موفّر المصادقة بحساب مستخدم حالي.
لتسجيل خروج مستخدم، يمكنك استدعاء
signOut:
Web
import { getAuth, signOut } from "firebase/auth"; const auth = getAuth(); signOut(auth).then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });
Web
firebase.auth().signOut().then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });