קישור של כמה ספקי אימות לחשבון ב-Unity

חשוב: יש בעיה ידועה שמונעת מ-linkWithCredentials() לפעול בצורה תקינה בחלק מהפרויקטים. בדוח הבעיות מופיע פתרון זמני וסטטוס התיקון.

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

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

מוסיפים לאפליקציה תמיכה בשני ספקי אימות או יותר (יכול להיות שזה כולל אימות אנונימי).

המחלקות FirebaseAuth הן שער לכל הקריאות ל-API. אפשר לגשת אליו דרך FirebaseAuth.DefaultInstance.

Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;

קישור פרטי כניסה של ספק אימות לחשבון משתמש

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

1. מבצעים כניסה לחשבון המשתמש באמצעות ספק או שיטת אימות כלשהם.
2. משלימים את תהליך הכניסה של ספק האימות החדש עד לשלב של קריאה לאחת מהשיטות של Firebase.Auth.FirebaseAuth.SignInAndRetrieveDataWithCredentialAsync, אבל לא כולל השלב הזה. לדוגמה, קבלת טוקן מזהה של משתמש ב-Google, טוקן גישה בפייסבוק או כתובת אימייל וסיסמה.

3. מקבלים Firebase.Auth.Credential עבור ספק האימות החדש:

   כניסה לחשבון Google

   Firebase.Auth.Credential credential =
       Firebase.Auth.GoogleAuthProvider.GetCredential(googleIdToken, googleAccessToken);

   Facebook Login

   Firebase.Auth.Credential credential =
       Firebase.Auth.FacebookAuthProvider.GetCredential(accessToken);

   כניסה באמצעות כתובת אימייל וסיסמה

   Firebase.Auth.Credential credential =
       Firebase.Auth.EmailAuthProvider.GetCredential(email, password);

4. מעבירים את האובייקט Firebase.Auth.Credential לשיטה LinkWithCredentialAsync של המשתמש המחובר:

   auth.CurrentUser.LinkWithCredentialAsync(credential).ContinueWith(task => {
     if (task.IsCanceled) {
       Debug.LogError("LinkWithCredentialAsync was canceled.");
       return;
     }
     if (task.IsFaulted) {
       Debug.LogError("LinkWithCredentialAsync encountered an error: " + task.Exception);
       return;
     }
   
     Firebase.Auth.AuthResult result = task.Result;
     Debug.LogFormat("Credentials successfully linked to Firebase user: {0} ({1})",
         result.User.DisplayName, result.User.UserId);
   });

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

   // Gather data for the currently signed in User.
   string currentUserId = auth.CurrentUser.UserId;
   string currentEmail = auth.CurrentUser.Email;
   string currentDisplayName = auth.CurrentUser.DisplayName;
   System.Uri currentPhotoUrl = auth.CurrentUser.PhotoUrl;
   
   // Sign in with the new credentials.
   auth.SignInAndRetrieveDataWithCredentialAsync(credential).ContinueWith(task => {
     if (task.IsCanceled) {
       Debug.LogError("SignInAndRetrieveDataWithCredentialAsync was canceled.");
       return;
     }
     if (task.IsFaulted) {
       Debug.LogError("SignInAndRetrieveDataWithCredentialAsync encountered an error: " + task.Exception);
       return;
     }
   
     Firebase.Auth.AuthResult result = task.Result;
     Debug.LogFormat("User signed in successfully: {0} ({1})",
         result.User.DisplayName, result.User.UserId);
   
     // TODO: Merge app specific details using the newUser and values from the
     // previous user, saved above.
   });

אם הקריאה ל-LinkWithCredentialAsync מצליחה, המשתמש יכול להיכנס באמצעות כל ספק אימות מקושר ולגשת לאותם נתונים ב-Firebase.

ביטול הקישור של ספק אימות לחשבון משתמש

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

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

// Unlink the sign-in provider from the currently active user.
// providerIdString is a string identifying a provider,
// retrieved via FirebaseAuth.FetchProvidersForEmail().
auth.CurrentUser.UnlinkAsync(providerIdString).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("UnlinkAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("UnlinkAsync encountered an error: " + task.Exception);
    return;
  }

  // The user has been unlinked from the provider.
  Firebase.Auth.AuthResult result = task.Result;
  Debug.LogFormat("Credentials successfully unlinked from user: {0} ({1})",
      result.User.DisplayName, result.User.UserId);
});

פתרון בעיות

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