本頁面由 Cloud Translation API 翻譯而成。

在 Firebase 中管理使用者

新增使用者

如要在 Firebase 專案中建立新使用者，請呼叫 CreateUserWithEmailAndPassword敬上方法或透過聯合身分首次登入使用者例如 Google 登入或 Facebook 登入。

您也可以從「驗證」頁面建立以密碼驗證的新使用者 Firebase 控制台，找到「使用者」頁面。

取得目前登入的使用者

如要取得目前的使用者，建議您設定驗證物件：

Firebase.Auth.FirebaseAuth auth;
Firebase.Auth.FirebaseUser user;

// Handle initialization of the necessary firebase modules:
void InitializeFirebase() {
  Debug.Log("Setting up Firebase Auth");
  auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
  auth.StateChanged += AuthStateChanged;
  AuthStateChanged(this, null);
}

// Track state changes of the auth object.
void AuthStateChanged(object sender, System.EventArgs eventArgs) {
  if (auth.CurrentUser != user) {
    bool signedIn = user != auth.CurrentUser && auth.CurrentUser != null;
    if (!signedIn && user != null) {
      Debug.Log("Signed out " + user.UserId);
    }
    user = auth.CurrentUser;
    if (signedIn) {
      Debug.Log("Signed in " + user.UserId);
    }
  }
}

// Handle removing subscription and reference to the Auth instance.
// Automatically called by a Monobehaviour after Destroy is called on it.
void OnDestroy() {
  auth.StateChanged -= AuthStateChanged;
  auth = null;
}

使用事件監聽器確保 Auth 物件不在中繼中當您取得目前使用者時的狀態，例如初始化。

您也可以呼叫 CurrentUser，取得目前登入的使用者。如果使用者未登入，CurrentUser 會傳回空值。如果使用者登出使用者的 IsValid() 會傳回 false。

保留使用者憑證

使用者之後，使用者的憑證會儲存在本機 KeyStore 中登入。簽署後，即可刪除使用者憑證本機快取使用者。KeyStore 會因平台而異：

Apple 平台：Keychain Services。
Android：Android KeyStore。
Windows：Credential Management API。
OS X：Keychain Services。
Linux：libsecret，使用者必須安裝。

取得使用者的個人資料

如要取得使用者的個人資料資訊，請使用 Firebase.Auth.FirebaseUser。例如：

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  string name = user.DisplayName;
  string email = user.Email;
  System.Uri photo_url = user.PhotoUrl;
  // 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 User.TokenAsync() instead.
  string uid = user.UserId;
}

取得使用者供應商專屬個人資料

如要取得從連結至某個請採用 ProviderData 方法。例如：

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  foreach (var profile in user.ProviderData) {
    // Id of the provider (ex: google.com)
    string providerId = profile.ProviderId;

    // UID specific to the provider
    string uid = profile.UserId;

    // Name, email address, and profile photo Url
    string name = profile.DisplayName;
    string email = profile.Email;
    System.Uri photoUrl = profile.PhotoUrl;
  }
}

更新使用者的個人資料

您可以更新使用者的基本個人資料，也就是使用者的顯示名稱和個人資料相片網址加入 UpdateUserProfile 方法。例如：

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  Firebase.Auth.UserProfile profile = new Firebase.Auth.UserProfile {
    DisplayName = "Jane Q. User",
    PhotoUrl = new System.Uri("https://example.com/jane-q-user/profile.jpg"),
  };
  user.UpdateUserProfileAsync(profile).ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("UpdateUserProfileAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("UpdateUserProfileAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("User profile updated successfully.");
  });
}

設定使用者的電子郵件地址

您可以使用 UpdateEmail 方法設定使用者的電子郵件地址。例如：

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  user.UpdateEmailAsync("user@example.com").ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("UpdateEmailAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("UpdateEmailAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("User email updated successfully.");
  });
}

敬上

向使用者傳送驗證電子郵件

您可以使用 SendEmailVerification 方法。例如：

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  user.SendEmailVerificationAsync().ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("SendEmailVerificationAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("SendEmailVerificationAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("Email sent successfully.");
  });
}

您可以在 Firebase 控制台，前往「電子郵件範本」頁面。請參閱「電子郵件範本」： Firebase 說明中心。

設定使用者密碼

您可以使用 UpdatePassword 方法設定使用者的密碼。例如：

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
string newPassword = "SOME-SECURE-PASSWORD";
if (user != null) {
  user.UpdatePasswordAsync(newPassword).ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("UpdatePasswordAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("UpdatePasswordAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("Password updated successfully.");
  });
}

敬上

傳送重設密碼電子郵件

您可以透過 SendPasswordResetEmail 將密碼重設電子郵件傳送給使用者方法。例如：

string emailAddress = "user@example.com";
if (user != null) {
  auth.SendPasswordResetEmailAsync(emailAddress).ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("SendPasswordResetEmailAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("SendPasswordResetEmailAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("Password reset email sent successfully.");
  });
}

您可以在 Firebase 控制台，前往「電子郵件範本」頁面。請參閱「電子郵件範本」： Firebase 說明中心。

您也可以透過 Firebase 控制台傳送重設密碼的電子郵件。

刪除使用者

您可以使用 Delete 方法刪除使用者帳戶。例如：

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  user.DeleteAsync().ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("DeleteAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("DeleteAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("User deleted successfully.");
  });
}

敬上

您也可以前往 Firebase 控制台，位於「使用者」頁面。

重新驗證使用者

某些涉及安全性的動作，例如刪除帳戶設定主要電子郵件地址，以及變更密碼：使用者必須最近登入。如果您執行了上述任一動作，且使用者已登入太久，動作失敗。

在這種情況下，請取得新的登入憑證，重新驗證使用者並將憑證傳遞至 Reauthenticate。例如：

Firebase.Auth.FirebaseUser user = auth.CurrentUser;

// Get auth credentials from the user for re-authentication. The example below shows
// email and password credentials but there are multiple possible providers,
// such as GoogleAuthProvider or FacebookAuthProvider.
Firebase.Auth.Credential credential =
    Firebase.Auth.EmailAuthProvider.GetCredential("user@example.com", "password1234");

if (user != null) {
  user.ReauthenticateAsync(credential).ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("ReauthenticateAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("ReauthenticateAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("User reauthenticated successfully.");
  });
}

匯入使用者帳戶

您可以使用 Firebase CLI 的 auth:import 指令。例如：

firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14