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

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

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

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

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

בעיות אבטחה

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

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

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

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

  1. במסוף Firebase, נכנסים אל אבטחה > אימות.
  2. בכרטיסייה שיטת התחברות, מפעילים את ספק הכניסה Phone.
  3. מגדירים מדיניות באזורים שבהם רוצים לאפשר או לא לאפשר שליחת הודעות SMS. הגדרת מדיניות אזורית ל-SMS יכולה לעזור להגן על האפליקציות שלכם מפני ניצול לרעה של SMS. בפרויקטים חדשים, מדיניות ברירת המחדל לא מאפשרת אזורים.
    1. במסוף Firebase, נכנסים לכרטיסייה Security ‏> Authentication ‏> Settings.
    2. בקטע מדיניות אזורית בנושא SMS, מגדירים את המדיניות האזורית בנושא SMS.

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

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

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

  1. ב-Xcode, מפעילים התראות בפרויקט.
  2. מעלים את אישור ה-APNs ל-Firebase. אם עדיין אין לכם אישור APNs, אתם צריכים ליצור אחד ב-Apple Developer Member Center.

    1. במסוף Firebase, נכנסים אל הגדרות > כללי. לאחר מכן לוחצים על הכרטיסייה Cloud Messaging.
    2. לוחצים על Upload Certificate (העלאת אישור) כדי להעלות את אישור הפיתוח, את אישור הייצור או את שניהם. צריך להוסיף לפחות אחד.
    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).
        // There's no need for the end user to input the verification code manually.
        // `credential` can't 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. שומרים את מזהה האימות ומשחזרים אותו כשהאפליקציה נטענת. כך תוכלו לוודא שעדיין יש לכם מזהה אימות תקין אם האפליקציה נסגרת לפני שהמשתמש משלים את תהליך הכניסה (לדוגמה, בזמן המעבר לאפליקציית הסמס).

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

אם הקריאה ל-VerifyPhoneNumber גורמת לקריאה ל-OnCodeSent במאזין, אתם יכולים לבקש מהמשתמש להקליד את קוד האימות כשהוא מקבל אותו בהודעת ה-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();