S'authentifier avec Firebase à l'aide d'un système d'authentification personnalisé et d'Unity

Vous pouvez intégrer Firebase Authentication à un système d'authentification personnalisé en modifiant votre serveur d'authentification pour qu'il produise des jetons signés personnalisés lorsqu'un utilisateur se connecte. Votre application reçoit ce jeton et l'utilise pour s'authentifier auprès de Firebase.

Avant de commencer

  1. Avant de pouvoir utiliser Firebase Authentication, vous devez :

    • Enregistrez votre projet Unity avec votre projet Firebase.
    • Ajoutez le SDK Unity Firebase (plus précisément, FirebaseAuth.unitypackage) à votre projet Unity.

    Pour obtenir des instructions détaillées sur ces étapes de configuration initiales, consultez Ajouter Firebase à votre projet Unity.

  2. Obtenez les clés de serveur de votre projet:
    1. Accédez à la page Comptes de service. dans les paramètres de votre projet.
    2. Cliquez sur Générer une nouvelle clé privée en bas de la section SDK Firebase Admin de la page Comptes de service.
    3. La paire de clés publique/privée du nouveau compte de service enregistrées sur votre ordinateur. Copiez ce fichier sur votre serveur d'authentification.

Authentifier avec Firebase

La classe FirebaseAuth sert de passerelle pour tous les appels d'API. Il est accessible via FirebaseAuth.DefaultInstance. 
Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;

Appelez Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync avec le jeton de votre serveur d'authentification.

  1. Lorsque les utilisateurs se connectent à votre application, envoyez leurs identifiants de connexion (par exemple, leur nom d'utilisateur et leur mot de passe) à votre serveur d'authentification. Votre serveur vérifie les identifiants et renvoie un jeton personnalisé s'ils sont valides.
  2. Une fois que vous avez reçu le jeton personnalisé de votre serveur d'authentification, transmettez-le à Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync pour connecter l'utilisateur :
    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);
});

Étapes suivantes

Lorsqu'un utilisateur se connecte pour la première fois, un compte utilisateur est créé et associés aux identifiants, c'est-à-dire au nom d'utilisateur et au mot de passe, ou des informations sur le fournisseur d'authentification, c'est-à-dire l'utilisateur avec lequel il s'est connecté. Ce nouveau compte est stocké dans votre projet Firebase et peut être utilisé pour identifier un utilisateur dans toutes les applications de votre projet, quelle que soit la manière dont il se connecte.

  • Dans vos applications, vous pouvez obtenir les informations de profil de base de l'utilisateur à partir de l'objet 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;
}

  • Dans vos règles de sécurité Firebase Realtime Database et Cloud Storage, vous pouvez obtenir l'ID utilisateur unique de l'utilisateur connecté à partir de la variable auth et l'utiliser pour contrôler les données auxquelles un utilisateur peut accéder.

Vous pouvez autoriser les utilisateurs à se connecter à votre appli à l'aide de plusieurs authentifications fournisseurs en associant leurs identifiants compte utilisateur existant.

Pour déconnecter un utilisateur, appelez . SignOut():

auth.SignOut();