Avant que tu commences
Avant de pouvoir utiliser Firebase Authentication , vous devez :
- Enregistrez votre projet Unity avec votre projet Firebase.
- Ajoutez le SDK Firebase Unity (en particulier,
FirebaseAuth.unitypackage
) à votre projet Unity.
Vous trouverez des instructions détaillées pour ces étapes de configuration initiales dans Ajouter Firebase à votre projet Unity .
- Obtenez les clés de serveur de votre projet :
- Accédez à la page Comptes de service dans les paramètres de votre projet.
- Cliquez sur Générer une nouvelle clé privée en bas de la section Firebase Admin SDK de la page Comptes de service .
- La paire de clés publique/privée du nouveau compte de service est automatiquement enregistrée sur votre ordinateur. Copiez ce fichier sur votre serveur d'authentification.
S'authentifier avec Firebase
La classeFirebaseAuth
est la 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.
- 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 informations d'identification et renvoie un jeton personnalisé si elles sont valides.
- Après avoir 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); });
Prochaines étapes
Lorsqu'un utilisateur se connecte pour la première fois, un nouveau compte d'utilisateur est créé et lié aux informations d'identification (c'est-à-dire le nom d'utilisateur et le mot de passe, le numéro de téléphone ou les informations du fournisseur d'authentification) avec lesquelles l'utilisateur s'est connecté. Ce nouveau compte est stocké dans le cadre de votre projet Firebase et peut être utilisé pour identifier un utilisateur dans chaque application de votre projet, quelle que soit la manière dont l'utilisateur se connecte.
Dans vos applications, vous pouvez obtenir les informations de base du profil 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 application à l'aide de plusieurs fournisseurs d'authentification en liant les informations d'identification du fournisseur d'authentification à un compte d'utilisateur existant.
Pour déconnecter un utilisateur, appelez SignOut()
:
auth.SignOut();