使用自訂驗證系統和 Unity 進行 Firebase 驗證

您可以將 Firebase Authentication 與自訂驗證系統整合，方法是修改驗證伺服器，在使用者成功登入時產生自訂簽署權杖。應用程式收到這個權杖後，會用來向 Firebase 驗證。

事前準備

  1. 使用 Firebase Authentication 前，請先完成下列事項：

    • 在 Firebase 專案中註冊 Unity 專案。
    • 將 Firebase Unity SDK (具體來說是 FirebaseAuth.unitypackage) 新增至 Unity 專案。

    如需這些初始設定步驟的詳細操作說明，請參閱「將 Firebase 新增至 Unity 專案」。

  2. 取得專案的伺服器金鑰：
    1. 在 Firebase 控制台中，依序前往「 Settings」(設定) > 「Service accounts」(服務帳戶) 分頁。
    2. 在「Firebase Admin SDK」部分底部，按一下「Generate New Private Key」(產生新的私密金鑰)。
    3. 新服務帳戶的公開/私密金鑰組會自動儲存至您的電腦。將這個檔案複製到驗證伺服器。

使用 Firebase 驗證

FirebaseAuth 類別是所有 API 呼叫的閘道。 可透過 FirebaseAuth.DefaultInstance 存取。
Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;

使用驗證伺服器提供的權杖呼叫 Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync。

  1. 使用者登入應用程式時，請將他們的登入憑證 (例如使用者名稱和密碼) 傳送至驗證伺服器。伺服器會檢查憑證，並在憑證有效時傳回自訂權杖。
  2. 從驗證伺服器收到自訂權杖後，請將其傳遞至 Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync，讓使用者登入：
    auth.SignInWithCustomTokenAsync(custom_token).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("SignInWithCustomTokenAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("SignInWithCustomTokenAsync 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);
});

後續步驟

使用者首次登入後，系統會建立新的使用者帳戶，並連結至使用者登入時使用的憑證，也就是使用者名稱和密碼、電話號碼或驗證供應商資訊。這個新帳戶會儲存為 Firebase 專案的一部分，無論使用者如何登入，都可用來識別專案中每個應用程式的使用者。

  • 在應用程式中，您可以從 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;
}

  • 在 Firebase Realtime Database 和 Cloud Storage安全性規則中，您可以從 auth 變數取得已登入使用者的專屬使用者 ID，並用來控管使用者可存取的資料。

您可以將驗證供應商憑證連結至現有使用者帳戶，允許使用者透過多個驗證供應商登入應用程式。

如要登出使用者，請呼叫 SignOut()：

auth.SignOut();