通过 Unity 使用基于密码的账号进行 Firebase 身份验证

您可以借助 Firebase Authentication 让您的用户使用其电子邮件地址和密码进行 Firebase 身份验证，还可以管理您的应用的基于密码的账号。

准备工作

在使用 Firebase Authentication 之前，您需要：

  • 注册 Unity 项目并将其配置为使用 Firebase。

    • 如果您的 Unity 项目已在使用 Firebase，那么该项目已经注册并已配置为使用 Firebase。

    • 如果您没有 Unity 项目，则可以下载示例应用。

  • 将 Firebase Unity SDK（具体而言是 FirebaseAuth.unitypackage）添加到您的 Unity 项目中。

请注意，为了将 Firebase 添加到 Unity 项目，需要在 Firebase 控制台中和打开的 Unity 项目中执行若干任务（例如，从控制台下载 Firebase 配置文件，然后将配置文件移到 Unity 项目中）。

访问 Firebase.Auth.FirebaseAuth 类

FirebaseAuth 类是所有 API 调用都需要通过的门户，此类可通过 FirebaseAuth.DefaultInstance 访问。
Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;

创建基于密码的账号

如需创建一个带有密码的新用户账号，请在您的应用的登录代码中完成以下步骤：

  1. 当新用户使用您的应用注册表单注册时，需完成您的应用要求的所有新账号验证步骤，例如验证新账号的密码是否输入正确并且符合您规定的密码复杂度要求。
  2. 将新用户的电子邮件地址和密码传递给 FirebaseAuth.CreateUserWithEmailAndPassword 方法，创建一个新账号：
    auth.CreateUserWithEmailAndPasswordAsync(email, password).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("CreateUserWithEmailAndPasswordAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("CreateUserWithEmailAndPasswordAsync encountered an error: " + task.Exception);
    return;
  }

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

让用户使用电子邮件地址和密码登录

使用密码让用户登录的步骤与创建新账号的步骤类似。在您的应用的登录函数中，执行以下操作：

  1. 当用户登录到您的应用时，将该用户的电子邮件地址和密码传递给 FirebaseAuth.SignInWithEmailAndPassword：
    auth.SignInWithEmailAndPasswordAsync(email, password).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("SignInWithEmailAndPasswordAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("SignInWithEmailAndPasswordAsync 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);
});
  2. 您也可以像其他工作流一样创建凭据并登录：
    Firebase.Auth.Credential credential =
    Firebase.Auth.EmailAuthProvider.GetCredential(email, password);
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);
});

建议：设置密码政策

您可以强制实施密码复杂度要求，从而提高账号安全性。

如需为项目配置密码政策，请打开 Firebase 控制台的“身份验证设置”页面上的密码政策标签页：

身份验证设置

Firebase Authentication 密码政策支持以下密码要求：

  • 必须包含小写字符

  • 必须包含大写字符

  • 必须包含数字字符

  • 必须包含非字母数字字符

    以下字符符合非字母数字字符要求：^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~

  • 最小密码长度（介于 6 到 30 个字符之间；默认为 6）

  • 最大密码长度（上限为 4096 个字符）

您可以通过两种模式启用密码政策强制执行：

  • 要求：尝试登录会失败，直到用户将密码更新为符合您的政策的密码。

  • 通知：允许用户使用不符合要求的密码登录。使用此模式时，您应检查用户的密码是否符合客户端的政策，并以某种方式提示用户更新密码（如果密码不符合政策）。

新用户始终需要选择符合您政策的密码。

如果您有活跃用户，我们建议您不要启用“登录时强制升级”，除非您打算禁止密码不符合政策的用户访问您的应用。请改用通知模式，让用户使用当前密码登录，并告知他们密码不符合哪些要求。

推荐做法：启用电子邮件枚举保护

如果您必须注册一个电子邮件地址（例如，当使用电子邮件地址和密码登录时）但未注册，或者如果电子邮件地址不应该被使用（例如，当更改用户的电子邮件地址时）但已注册，一些将电子邮件地址作为参数的 Firebase Authentication 方法会抛出具体的错误。虽然这对于向用户建议具体的补救措施非常有用，但恶意操作者也可能会滥用该功能，以发现用户注册的电子邮件地址。

为了降低这种风险，我们建议您使用 Google Cloud gcloud 工具为您的项目启用电子邮件枚举保护。请注意，启用此功能会更改 Firebase Authentication 的错误报告行为：请确保您的应用不依赖于更具体的错误。

后续步骤

在用户首次登录后，系统会创建一个新的用户账号，并将其与该用户登录时使用的凭据（即用户名和密码、电话号码或者身份验证提供方信息）相关联。此新账号存储在您的 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，然后利用此 ID 来控制用户可以访问哪些数据。

您可以通过将身份验证提供方凭据关联至现有用户账号，让用户可以使用多个身份验证提供方登录您的应用。

如需将用户退出登录，请调用 SignOut()：

auth.SignOut();