אפשר להשתמש ב-Firebase Authentication כדי להכניס משתמש לחשבון באמצעות שליחת הודעת SMS לטלפון של המשתמש. המשתמש נכנס באמצעות קוד חד-פעמי שמופיע בהודעת ה-SMS.
הדרך הקלה ביותר להוסיף לאפליקציה כניסה באמצעות מספר טלפון היא להשתמש ב-FirebaseUI, שכולל ווידג'ט כניסה מוכן שמטמיע תהליכי כניסה באמצעות מספר טלפון, וגם כניסה באמצעות סיסמה וכניסה מאוחדת. במסמך הזה מוסבר איך להטמיע תהליך כניסה באמצעות מספר טלפון באמצעות Firebase SDK.
לפני שמתחילים
אם עדיין לא עשיתם את זה, העתיקו את קטע הקוד של האיניציאליזציה ממסוף Firebase לפרויקט שלכם, כמו שמתואר במאמר הוספת Firebase לפרויקט JavaScript.בעיות אבטחה
אימות באמצעות מספר טלפון בלבד הוא נוח, אבל פחות מאובטח משיטות אחרות, כי אפשר להעביר את הבעלות על מספר טלפון בין משתמשים. בנוסף, במכשירים עם כמה פרופילי משתמשים, כל משתמש שיכול לקבל הודעות SMS יכול להיכנס לחשבון באמצעות מספר הטלפון של המכשיר.
אם אתם משתמשים באפליקציה בכניסה לחשבון באמצעות מספר טלפון, אתם צריכים להציע אותה לצד שיטות כניסה מאובטחות יותר, וליידע את המשתמשים על הפשרות מבחינת האבטחה כשמשתמשים בכניסה לחשבון באמצעות מספר טלפון.
הפעלת כניסה באמצעות מספר טלפון בפרויקט ב-Firebase
כדי לאפשר למשתמשים להיכנס באמצעות SMS, קודם צריך להפעיל את שיטת הכניסה באמצעות מספר טלפון בפרויקט Firebase:
- במסוף Firebase, נכנסים אל אבטחה > אימות.
- בכרטיסייה שיטת התחברות, מפעילים את ספק הכניסה Phone.
-
מגדירים מדיניות באזורים שבהם רוצים לאפשר או לא לאפשר שליחת הודעות SMS. הגדרת מדיניות אזורית ל-SMS יכולה לעזור להגן על האפליקציות שלכם מפני ניצול לרעה של SMS. בפרויקטים חדשים, מדיניות ברירת המחדל לא מאפשרת אזורים.
- במסוף Firebase, נכנסים לכרטיסייה Security > Authentication > Settings.
- בקטע מדיניות אזורית בנושא SMS, מגדירים את המדיניות האזורית בנושא SMS.
-
אם עדיין לא עשיתם את זה, אתם צריכים לאשר את הדומיין של האפליקציה:
- במסוף Firebase, נכנסים לדף Security > Authentication > הכרטיסייה Settings.
- בקטע Authorized domains, לוחצים על Add domain ומוסיפים את הדומיין.
שימו לב: אי אפשר להשתמש ב-localhost כדומיין מתארח למטרות אימות באמצעות הטלפון.
הגדרת מאמת reCAPTCHA
כדי שהמשתמשים יוכלו להיכנס לחשבון באמצעות מספרי הטלפון שלהם, צריך להגדיר את מאמת ה-reCAPTCHA של Firebase. Firebase משתמש ב-reCAPTCHA כדי למנוע ניצול לרעה, למשל על ידי וידוא שבקשת האימות של מספר הטלפון מגיעה מאחד מהדומיינים המורשים של האפליקציה.
אין צורך להגדיר באופן ידני לקוח reCAPTCHA. כשמשתמשים באובייקט RecaptchaVerifier של Firebase SDK, מערכת Firebase יוצרת ומטפלת באופן אוטומטי בכל המפתחות והסודות הנדרשים של הלקוח.
האובייקט RecaptchaVerifier תומך ב-reCAPTCHA בלתי נראה, שלרוב יכול לאמת את המשתמש בלי לדרוש ממנו לבצע פעולה, וגם בווידג'ט של reCAPTCHA, שתמיד דורש אינטראקציה של המשתמש כדי להשלים את האימות.
אפשר להתאים את ה-reCAPTCHA שמוצג לשפה המועדפת על המשתמש. לשם כך, צריך לעדכן את קוד השפה במכונה של Auth לפני שמוצג ה-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
אפשר להגדיר פונקציות קריאה חוזרת (callback) באובייקט 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, שבו אפשר להשתמש כדי לבצע קריאות ל-API של 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. לאחר מכן, מעבירים את הקוד ל-method confirm של האובייקט ConfirmationResult שהועבר ל-fulfillment handler של 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 בלי Google Play Services.
- לכתוב בדיקות שילוב בלי להיחסם על ידי בדיקות אבטחה שבדרך כלל מופעלות על מספרי טלפון אמיתיים בסביבת ייצור.
מספרי טלפון פיקטיביים צריכים לעמוד בדרישות הבאות:
- חשוב להשתמש במספרי טלפון שהם באמת פיקטיביים ולא קיימים. ב-Firebase Authentication אי אפשר להגדיר מספרי טלפון קיימים של משתמשים אמיתיים כמספרי בדיקה. אפשרות אחת היא להשתמש במספרים עם הקידומת 555 כמספרי טלפון לבדיקה בארה"ב, לדוגמה: +1 650-555-3434
- מספרי הטלפון צריכים להיות בפורמט תקין מבחינת האורך ומגבלות אחרות. הם עדיין יעברו את אותו תהליך אימות כמו מספר טלפון של משתמש אמיתי.
- אפשר להוסיף עד 10 מספרי טלפון לפיתוח.
- השתמשו במספרי טלפון או בקודים לבדיקה שקשה לנחש, והחליפו אותם לעיתים קרובות.
יצירת מספרי טלפון וקודי אימות פיקטיביים
- במסוף Firebase, נכנסים אל אבטחה > אימות.
- בכרטיסייה שיטת התחברות, מפעילים את ספק הכניסה Phone, אם הוא עדיין לא מופעל.
- מרחיבים את הקטע מספרי טלפון לבדיקה.
-
מזינים את מספר הטלפון שרוצים לבדוק, לדוגמה:
+1 650-555-3434. -
מזינים את קוד האימות בן 6 הספרות של המספר הספציפי הזה, לדוגמה:
654321. - לוחצים על הוספה לכל מספר. אם צריך, אפשר למחוק את מספר הטלפון והקוד שלו. כדי לעשות את זה, מעבירים את העכבר מעל השורה הרלוונטית ולוחצים על סמל פח האשפה.
בדיקה ידנית
אתם יכולים להתחיל להשתמש במספר טלפון פיקטיבי ישירות באפליקציה. כך תוכלו לבצע בדיקות ידניות בשלבי הפיתוח בלי להיתקל בבעיות של מכסות או הגבלת קצב. אפשר גם לבדוק ישירות מסימולטור של iOS או מאמולטור Android בלי להתקין את Google Play Services.
כשמזינים את מספר הטלפון הפיקטיבי ושולחים את קוד האימות, לא נשלחת הודעת SMS אמיתית. במקום זאת, צריך להזין את קוד האימות שהוגדר קודם כדי להשלים את הכניסה.
בסיום הכניסה, נוצר משתמש Firebase עם מספר הטלפון הזה. המשתמש מתנהג כמו משתמש עם מספר טלפון אמיתי ויש לו את אותם מאפיינים, והוא יכול לגשת אל Realtime Database/Cloud Firestore ולשירותים אחרים באותו אופן. לטוקן של המזהה שנוצר בתהליך הזה יש את אותה חתימה כמו למשתמש אמיתי עם מספר טלפון.
אפשרות נוספת היא להגדיר תפקיד בדיקה באמצעות טענות נכוֹנוּת (claims) בהתאמה אישית למשתמשים האלה, כדי להבדיל אותם כמשתמשים מזויפים אם רוצים להגביל עוד יותר את הגישה.
בדיקת אינטגרציה
בנוסף לבדיקה ידנית, Firebase Authentication מספק ממשקי API שעוזרים לכתוב בדיקות שילוב לבדיקת אימות טלפוני. ממשקי ה-API האלה משביתים את אימות האפליקציה על ידי השבתת הדרישה ל-reCAPTCHA באינטרנט ובהתראות דחיפה שקטות ב-iOS. כך אפשר לבצע בדיקות אוטומטיות בתהליכים האלה וקל יותר להטמיע אותן. בנוסף, הם מאפשרים לבדוק תהליכי אימות מיידי ב-Android.
באינטרנט, מגדירים את appVerificationDisabledForTesting לערך true לפני העיבוד של firebase.auth.RecaptchaVerifier. הפעולה הזו פותרת את ה-reCAPTCHA באופן אוטומטי, ומאפשרת לכם להעביר את מספר הטלפון בלי לפתור את ה-reCAPTCHA באופן ידני. שימו לב שגם אם reCAPTCHA מושבת, אם תשתמשו במספר טלפון אמיתי, הכניסה לא תושלם. אפשר להשתמש ב-API הזה רק עם מספרי טלפון פיקטיביים.
// 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 מדומה, פונקציית הקריאה החוזרת המתאימה מופעלת כמצופה עם התגובה המזויפת. אם צוין גם קריאה חוזרת (callback) לתפוגה, היא תופעל כשהתוקף יפוג.
השלבים הבאים
אחרי שמשתמש נכנס לחשבון בפעם הראשונה, נוצר חשבון משתמש חדש שמקושר לפרטי הכניסה – כלומר, שם המשתמש והסיסמה, מספר הטלפון או פרטי ספק האימות – שאיתם המשתמש נכנס לחשבון. החשבון החדש הזה נשמר כחלק מהפרויקט ב-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. });