אימות באמצעות Firebase באמצעות מספר טלפון ו-C++‎

אפשר להשתמש ב-Firebase Authentication כדי לשלוח הודעה ב-SMS לטלפון של המשתמש כדי לאפשר לו להיכנס לחשבון. המשתמש נכנס באמצעות קוד חד-פעמי שנכלל הודעת SMS.

במסמך הזה נסביר איך להטמיע תהליך כניסה באמצעות מספר טלפון. Firebase SDK.

לפני שמתחילים

1. הוספת Firebase לקובץ C++ project.
2. אם עדיין לא קישרתם את האפליקציה לפרויקט Firebase, צריך לעשות זאת דרך מסוף Firebase.
3. מהן הדרישות לפלטפורמה לכניסה באמצעות מספר טלפון:
   • הכניסה למספר טלפון מיועדת לפלטפורמות של ניידים בלבד.
   • ב-iOS, כדי להיכנס למספר טלפון צריך מכשיר פיזי. אי אפשר להשתמש בסימולטור.

בעיית אבטחה

אימות באמצעות מספר טלפון בלבד, אבל פחות נוח, פחות מאובטח בהשוואה לשיטות האחרות הזמינות, כי החזקה של מספר טלפון ניתן להעביר בקלות בין משתמשים. כמו כן, במכשירים עם מספר משתמשים פרופילים, כל משתמש שיכול לקבל הודעות SMS יכול להיכנס לחשבון באמצעות מספר הטלפון של המכשיר.

אם אתם משתמשים בכניסה באמצעות מספר טלפון באפליקציה, כדאי להציע זאת שיטות כניסה מאובטחות יותר, ומיידעות את המשתמשים יתרונות השימוש בכניסה למספר טלפון.

הפעלת כניסה באמצעות מספר טלפון לפרויקט Firebase

כדי להכניס משתמשים באמצעות SMS, צריך קודם להפעיל את הכניסה באמצעות מספר הטלפון של פרויקט Firebase:

1. במסוף Firebase, פותחים את הקטע Authentication.
2. בדף שיטת כניסה, מפעילים את האפשרות Phone Number שיטת כניסה לחשבון.

התחלת קבלת התראות APNs (פלטפורמות של Apple)

כדי להשתמש באימות של מספרי טלפון בפלטפורמות של Apple, האפליקציה צריכה להיות מסוגלת לקבל התראות APN מ-Firebase. כשנכנסים לחשבון של משתמש באמצעות הטלפון מספר בפעם הראשונה במכשיר, Firebase Authentication שולח דחיפה שקטה התראה למכשיר כדי לאמת שבקשת הכניסה של מספר הטלפון מגיע מהאפליקציה. (לכן, אין אפשרות להשתמש בכניסה באמצעות מספר טלפון בסימולטור).

כדי להפעיל התראות מ-APN לשימוש עם Firebase Authentication:

1. ב-Xcode, להפעיל את ההתראותבפרויקט.

2. מעלים את אישור ה-APN ל-Firebase. אם עדיין אין לכם אישור APN, צריך ליצור אישור מרכז המנויים למפתחי Apple.

   1. בתוך הפרויקט במסוף Firebase, בוחרים סמל גלגל השיניים, בחירה Project Settings (הגדרות הפרויקט), ואז בוחרים את הכרטיסייה העברת הודעות בענן.

   2. בוחרים את אישור ההעלאה. לאישור הפיתוח, אישור ייצור, או שניהם. לפחות אחד הוא נדרש.

   3. לכל אישור, בוחרים את קובץ ה- .p12 ומציינים הסיסמה, אם בכלל. מוודאים שמזהה החבילה של האישור תואם למזהה החבילה של האפליקציה. בוחרים באפשרות Save.

שליחת קוד אימות לטלפון של המשתמש

כדי להיכנס לחשבון עם מספר טלפון, צריך להציג למשתמש ממשק לתת לו את מספר הטלפון ואז להתקשר PhoneAuthProvider::VerifyPhoneNumber כדי לבקש מ-Firebase לשלוח קוד אימות לטלפון המשתמש באמצעות SMS:

1. מאתרים את מספר הטלפון של המשתמש.

   הדרישות המשפטיות שונות, אבל מומלץ וליצור ציפיות בקרב המשתמשים, עליכם להודיע להם שאם הם משתמשים בטלפון, ייתכן שהם יקבלו הודעת SMS לאימות יחולו התעריפים הרגילים לשליחת הודעות.

2. קוראים אל PhoneAuthProvider::VerifyPhoneNumber ומעבירים אליה מספר טלפון.

   class PhoneListener : public PhoneAuthProvider::Listener {
    public:
     ~PhoneListener() override {}
   
     void OnVerificationCompleted(PhoneAuthCredential credential) override {
       // Auto-sms-retrieval or instant validation has succeeded (Android only).
       // No need for the user to input the verification code manually.
       // `credential` can be used instead of calling GetCredential().
     }
   
     void OnVerificationFailed(const std::string& error) override {
       // Verification code not sent.
     }
   
     void OnCodeSent(const std::string& verification_id,
                     const PhoneAuthProvider::ForceResendingToken&
                         force_resending_token) override {
       // Verification code successfully sent via SMS.
       // Show the Screen to enter the Code.
       // Developer may want to save that verification_id along with other app states in case
       // the app is terminated before the user gets the SMS verification code.
     }
   };
   
   PhoneListener phone_listener;
   PhoneAuhtOptions options;
   options.timeout_milliseconds = kAutoVerifyTimeOut;
   options.phone_number = phone_number;
   PhoneAuthProvider& phone_provider = PhoneAuthProvider::GetInstance(auth);
   phone_provider->VerifyPhoneNumber(options, &phone_listener);

   כשקוראים לפונקציה PhoneAuthProvider::VerifyPhoneNumber, ל-Firebase,
   • (ב-iOS) נשלחת התראה שקטה באפליקציה,
   • שולחת הודעת SMS המכילה קוד אימות אל מספר הטלפון ומעביר מזהה אימות לפונקציית ההשלמה. כדי להיכנס לחשבון של המשתמש, תצטרכו גם את קוד האימות וגם את מזהה האימות.

3. כדאי לשמור את מזהה האימות ולשחזר אותו כשהאפליקציה נטענת. כך תוכלו לוודא שעדיין יש לכם מזהה אימות תקף אם האפליקציה שלכם תיסגר לפני שהמשתמש ישלים את תהליך הכניסה (לדוגמה, בזמן המעבר לאפליקציית ה-SMS).

   אתם יכולים לשמור את מזהה האימות איך שתרצו. אם אתם כותבים באמצעות מסגרת C++ בפלטפורמות שונות, היא אמורה לספק התראות על סיום ותיקון של האפליקציה. באירועים האלה, אפשר לשמור ולשחזר בהתאמה, מזהה האימות.

אם השיחה אל VerifyPhoneNumber תסתיים בOnCodeSent נשלחת קריאה ב-listener, תוכלו לבקש מהמשתמש להקליד את קוד האימות כשהם מקבלים אותו בהודעת ה-SMS.

לעומת זאת, אם הקריאה אל VerifyPhoneNumber מובילה OnVerificationCompleted, אז האימות האוטומטי הסתיים בהצלחה עכשיו יהיה לך PhoneAuthCredential ולהשתמש בו כמו שמתואר שלמטה.

כניסה לחשבון באמצעות קוד האימות

לאחר שהמשתמש יספק לאפליקציה את קוד האימות מה-SMS הודעה, כדי להיכנס לחשבון על ידי יצירת PhoneAuthCredential מקוד האימות וממזהה האימות, והעברת האובייקט אל Auth::SignInWithCredential.

1. מקבלים את קוד האימות מהמשתמש.
2. יוצרים אובייקט Credential מקוד האימות ו מזהה אימות.

   PhoneAuthCredential credential = phone_auth_provider->GetCredential(
       verification_id_.c_str(), verification_code.c_str());
       

3. כניסה לחשבון המשתמש באמצעות האובייקט Credential:

   Future<User> future = auth_->SignInWithCredential(credential);
   future.OnCompletion(
       [](const Future<User*>& result, void*) {
         if (result.error() == kAuthErrorNone) {
           // Successful.
           // User is signed in.
           User user = *result.result();
   
           // This should display the phone number.
           printf("Phone number: %s", user.phone_number().c_str());
   
           // The phone number provider UID is the phone number itself.
           printf("Phone provider uid: %s", user.uid().c_str());
   
           // The phone number providerID is 'phone'
           printf("Phone provider ID: %s", user.provider_id().c_str());
         } else {
           // Error.
           printf("Sign in error: %s", result.error_message().c_str());
         }
       },
       nullptr);

השלבים הבאים

אחרי שמשתמש נכנס לחשבון בפעם הראשונה, נוצר חשבון משתמש חדש שמקושר לפרטי הכניסה – כלומר שם המשתמש והסיסמה, מספר הטלפון או פרטי ספק האימות – שבאמצעותם המשתמש נכנס לחשבון. החשבון החדש הזה מאוחסן כחלק מפרויקט Firebase, וניתן להשתמש בו כדי לזהות משתמש בכל האפליקציות בפרויקט, ללא קשר לאופן שבו המשתמש נכנס לחשבון.

• באפליקציות שלכם, תוכלו לקבל את פרטי הפרופיל הבסיסיים של המשתמש דרך אובייקט firebase::auth::User:

  firebase::auth::User user = auth->current_user();
  if (user.is_valid()) {
    std::string name = user.display_name();
    std::string email = user.email();
    std::string photo_url = user.photo_url();
    // The user's ID, unique to the Firebase project.
    // Do NOT use this value to authenticate with your backend server,
    // if you have one. Use firebase::auth::User::Token() instead.
    std::string uid = user.uid();
  }

• בכללי האבטחה של Firebase Realtime Database ו-Cloud Storage, אפשר לקבל את מזהה המשתמש הייחודי של המשתמש שנכנס לחשבון מהמשתנה auth, ולהשתמש בו כדי לקבוע לאילו נתונים למשתמש תהיה גישה.

אפשר לאפשר למשתמשים להיכנס לאפליקציה באמצעות מספר סוגי אימות מספקים באמצעות קישור פרטי הכניסה של ספק האימות קיים חשבון משתמש קיים.

כדי להוציא משתמש מהחשבון, קוראים לפונקציה SignOut():

auth->SignOut();