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

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

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

1. אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט Android.

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

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:33.4.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, האפליקציה שלכם תשתמש תמיד בגרסאות תואמות של ספריות Android של Firebase.

   (חלופה)  מוסיפים יחסי תלות לספריות של 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:23.0.0")
   }

   מחפשים מודול ספרייה ספציפי ל-Kotlin? מתחיל בעוד אוקטובר 2023 (Firebase BoM 32.5.0), גם מפתחי Kotlin וגם מפתחי Java יכולים תלויות במודול הספרייה הראשי (לקבלת פרטים נוספים, אפשר לעיין שאלות נפוצות על היוזמה).

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

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

   Kotlin+KTX

   // 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. בשיטה onCreate של פעילות הכניסה, מקבלים את המופע המשותף של האובייקט FirebaseAuth:

   Kotlin+KTX

   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. כשמאתחלים את הפעילות, צריך לבדוק אם המשתמש מחובר כרגע:

   Kotlin+KTX

   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 LoginButtononSuccess מקבלים אסימון גישה למשתמש שנכנס לחשבון, מחליפים אותו בפרטי כניסה ל-Firebase ומבצעים אימות ב-Firebase באמצעות פרטי הכניסה ל-Firebase:

   Kotlin+KTX

   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:

Kotlin+KTX

Firebase.auth.signOut()
MainActivity.kt

Java

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