אימות באמצעות Facebook Login ב-Android

אתם יכולים לאפשר למשתמשים לבצע אימות ב-Firebase באמצעות חשבונות Facebook שלהם, על ידי שילוב של Facebook Login באפליקציה.

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

1. אם עדיין לא הוספתם את Firebase לפרויקט Android, אתם צריכים להוסיף אותו.

2. באתר Facebook for Developers, מקבלים את מזהה האפליקציה ואת סוד האפליקציה של האפליקציה.
3. מפעילים את Facebook Login כספק כניסה לפרויקט ב-Firebase:
   1. במסוף Firebase, נכנסים אל אבטחה > אימות.
   2. בכרטיסייה שיטת התחברות, מפעילים את ספק הכניסה פייסבוק ומציינים את הערכים של App ID ו-App Secret שקיבלתם מפייסבוק.
   3. מוודאים שכתובת ה-URI להפניה אוטומטית של OAuth (לדוגמה, my-app-12345.firebaseapp.com/__/auth/handler) מופיעה כאחת מכתובות ה-URI להפניה אוטומטית של OAuth בדף ההגדרות של האפליקציה ב-Facebook באתר Facebook for Developers, בהגדרה Product Settings > Facebook Login.

4. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle), מוסיפים את התלות בספריית Firebase Authentication ל-Android. מומלץ להשתמש ב-Firebase Android BoM כדי לשלוט בניהול גרסאות של הספרייה.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:35.1.0"))
   
       // Add the dependency for the Firebase Authentication library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth")
   }

   כשמשתמשים ב-Firebase Android BoM, האפליקציה תמיד משתמשת בגרסאות תואמות של ספריות Firebase ל-Android.

   (אפשרות חלופית)  מוסיפים תלות של הפרויקט בספריות של Firebase בלי להשתמש ב-BoM

   אם אתם בוחרים לא להשתמש ב-Firebase BoM, אתם צריכים לציין כל גרסה של ספריית Firebase בשורת התלות שלה.

   שימו לב: אם אתם משתמשים בכמה ספריות של Firebase באפליקציה, מומלץ מאוד להשתמש ב-BoM כדי לנהל את גרסאות הספרייה, וכך לוודא שכל הגרסאות תואמות.

   dependencies {
       // Add the dependency for the Firebase Authentication library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth:25.0.0")
   }

אימות באמצעות Firebase

1. משלבים את Facebook Login באפליקציה לפי התיעוד למפתחים. כשמגדירים את האובייקט LoginButton או LoginManager, צריך לבקש את ההרשאות public_profile ו-email. אם שילבתם את Facebook Login באמצעות LoginButton, פעילות הכניסה שלכם כוללת קוד שדומה לקוד הבא:

   Kotlin

   // Initialize Facebook Login button
   callbackManager = CallbackManager.Factory.create()
   
   buttonFacebookLogin.setReadPermissions("email", "public_profile")
   buttonFacebookLogin.registerCallback(
       callbackManager,
       object : FacebookCallback<LoginResult> {
           override fun onSuccess(loginResult: LoginResult) {
               Log.d(TAG, "facebook:onSuccess:$loginResult")
               handleFacebookAccessToken(loginResult.accessToken)
           }
   
           override fun onCancel() {
               Log.d(TAG, "facebook:onCancel")
           }
   
           override fun onError(error: FacebookException) {
               Log.d(TAG, "facebook:onError", error)
           }
       },
   )
   // ...
   override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
       super.onActivityResult(requestCode, resultCode, data)
   
       // Pass the activity result back to the Facebook SDK
       callbackManager.onActivityResult(requestCode, resultCode, data)
   }
   FacebookLoginActivity.kt

   Java

   // Initialize Facebook Login button
   mCallbackManager = CallbackManager.Factory.create();
   LoginButton loginButton = findViewById(R.id.button_sign_in);
   loginButton.setReadPermissions("email", "public_profile");
   loginButton.registerCallback(mCallbackManager, new FacebookCallback<LoginResult>() {
       @Override
       public void onSuccess(LoginResult loginResult) {
           Log.d(TAG, "facebook:onSuccess:" + loginResult);
           handleFacebookAccessToken(loginResult.getAccessToken());
       }
   
       @Override
       public void onCancel() {
           Log.d(TAG, "facebook:onCancel");
       }
   
       @Override
       public void onError(FacebookException error) {
           Log.d(TAG, "facebook:onError", error);
       }
   });
   // ...
   @Override
   protected void onActivityResult(int requestCode, int resultCode, Intent data) {
       super.onActivityResult(requestCode, resultCode, data);
   
       // Pass the activity result back to the Facebook SDK
       mCallbackManager.onActivityResult(requestCode, resultCode, data);
   }
   FacebookLoginActivity.java

2. ב-method onCreate של פעילות הכניסה, מקבלים את המכונה המשותפת של האובייקט FirebaseAuth:

   Kotlin

   private lateinit var auth: FirebaseAuth
   // ...
   // Initialize Firebase Auth
   auth = Firebase.auth
   FacebookLoginActivity.kt

   Java

   private FirebaseAuth mAuth;
   // ...
   // Initialize Firebase Auth
   mAuth = FirebaseAuth.getInstance();
   FacebookLoginActivity.java

3. כשמאתחלים את ה-Activity, בודקים אם המשתמש מחובר כרגע:

   Kotlin

   public override fun onStart() {
       super.onStart()
       // Check if user is signed in (non-null) and update UI accordingly.
       val currentUser = auth.currentUser
       updateUI(currentUser)
   }
   FacebookLoginActivity.kt

   Java

   @Override
   public void onStart() {
       super.onStart();
       // Check if user is signed in (non-null) and update UI accordingly.
       FirebaseUser currentUser = mAuth.getCurrentUser();
       updateUI(currentUser);
   }
   FacebookLoginActivity.java

4. אחרי שהמשתמש נכנס לחשבון, בשיטת הקריאה החוזרת (callback) של LoginButton ב-onSuccess, מקבלים טוקן גישה למשתמש שנכנס לחשבון, מחליפים אותו בפרטי כניסה ל-Firebase ומבצעים אימות ב-Firebase באמצעות פרטי הכניסה ל-Firebase:

   Kotlin

   private fun handleFacebookAccessToken(token: AccessToken) {
       Log.d(TAG, "handleFacebookAccessToken:$token")
   
       val credential = FacebookAuthProvider.getCredential(token.token)
       auth.signInWithCredential(credential)
           .addOnCompleteListener(this) { task ->
               if (task.isSuccessful) {
                   // Sign in success, update UI with the signed-in user's information
                   Log.d(TAG, "signInWithCredential:success")
                   val user = auth.currentUser
                   updateUI(user)
               } else {
                   // If sign in fails, display a message to the user.
                   Log.w(TAG, "signInWithCredential:failure", task.exception)
                   Toast.makeText(
                       baseContext,
                       "Authentication failed.",
                       Toast.LENGTH_SHORT,
                   ).show()
                   updateUI(null)
               }
           }
   }
   FacebookLoginActivity.kt

   Java

   private void handleFacebookAccessToken(AccessToken token) {
       Log.d(TAG, "handleFacebookAccessToken:" + token);
   
       AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());
       mAuth.signInWithCredential(credential)
               .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
                   @Override
                   public void onComplete(@NonNull Task<AuthResult> task) {
                       if (task.isSuccessful()) {
                           // Sign in success, update UI with the signed-in user's information
                           Log.d(TAG, "signInWithCredential:success");
                           FirebaseUser user = mAuth.getCurrentUser();
                           updateUI(user);
                       } else {
                           // If sign in fails, display a message to the user.
                           Log.w(TAG, "signInWithCredential:failure", task.getException());
                           Toast.makeText(FacebookLoginActivity.this, "Authentication failed.",
                                   Toast.LENGTH_SHORT).show();
                           updateUI(null);
                       }
                   }
               });
   }
   FacebookLoginActivity.java

   אם הקריאה ל-signInWithCredential מצליחה, אפשר להשתמש ב-getCurrentUser כדי לקבל את נתוני החשבון של המשתמש.

השלבים הבאים

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

• באפליקציות, אתם יכולים לקבל את פרטי הפרופיל הבסיסיים של המשתמש מהאובייקט FirebaseUser. ניהול משתמשים

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

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

כדי להוציא משתמש מהחשבון, מפעילים את signOut:

Firebase.auth.signOut()
MainActivity.kt

FirebaseAuth.getInstance().signOut();
MainActivity.java