Lier plusieurs fournisseurs d'authentification à un compte à l'aide de JavaScript

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. Les utilisateurs sont identifiables par le même ID utilisateur Firebase, quel que soit le fournisseur d'authentification utilisé pour se connecter. Par exemple, un utilisateur qui s'est connecté avec un mot de passe peut lier un compte Google et se connecter avec l'une ou l'autre méthode à l'avenir. Ou, un utilisateur anonyme peut lier un compte Facebook puis, plus tard, se connecter avec Facebook pour continuer à utiliser votre application.

Avant que tu commences

Ajoutez la prise en charge de deux fournisseurs d'authentification ou plus (y compris éventuellement l'authentification anonyme) à votre application.

Lier les informations d'identification du fournisseur d'authentification fédérée à un compte d'utilisateur

Pour lier les informations d'identification d'un fournisseur d'authentification tel que Google ou Facebook à un compte utilisateur existant :

1. Connectez l'utilisateur à l'aide de n'importe quel fournisseur ou méthode d'authentification.
2. Obtenez l'objet AuthProvider qui correspond au fournisseur que vous souhaitez lier au compte de l'utilisateur. Exemples:

   Web modular API

   import { GoogleAuthProvider, FacebookAuthProvider, TwitterAuthProvider, GithubAuthProvider } from "firebase/auth";
   
   const googleProvider = new GoogleAuthProvider();
   const facebookProvider = new FacebookAuthProvider();
   const twitterProvider = new TwitterAuthProvider();
   const githubProvider = new GithubAuthProvider();
   auth_get_providers.js

   Web namespaced API

   var googleProvider = new firebase.auth.GoogleAuthProvider();
   var facebookProvider = new firebase.auth.FacebookAuthProvider();
   var twitterProvider = new firebase.auth.TwitterAuthProvider();
   var githubProvider = new firebase.auth.GithubAuthProvider();
   link-multiple-accounts.js

3. Invitez l'utilisateur à se connecter avec le fournisseur que vous souhaitez lier. Vous pouvez inviter vos utilisateurs à se connecter en ouvrant une fenêtre contextuelle ou en les redirigeant vers la page de connexion du fournisseur. La méthode de redirection est préférée sur les appareils mobiles.
   • Pour vous connecter avec une fenêtre pop-up, appelez linkWithPopup :

     Web modular API

     import { getAuth, linkWithPopup, GoogleAuthProvider } from "firebase/auth";
     const provider = new GoogleAuthProvider();
     
     const auth = getAuth();
     linkWithPopup(auth.currentUser, provider).then((result) => {
       // Accounts successfully linked.
       const credential = GoogleAuthProvider.credentialFromResult(result);
       const user = result.user;
       // ...
     }).catch((error) => {
       // Handle Errors here.
       // ...
     });
     auth_link_with_popup.js

     Web namespaced API

     auth.currentUser.linkWithPopup(provider).then((result) => {
       // Accounts successfully linked.
       var credential = result.credential;
       var user = result.user;
       // ...
     }).catch((error) => {
       // Handle Errors here.
       // ...
     });
     link-multiple-accounts.js

   • Pour vous connecter en vous redirigeant vers la page de connexion du fournisseur, appelez linkWithRedirect : suivez les meilleures pratiques lors de l'utilisation de `linkWithRedirect`.

     Web modular API

     import { getAuth, linkWithRedirect, GoogleAuthProvider } from "firebase/auth";
     const provider = new GoogleAuthProvider();
     
     const auth = getAuth();
     linkWithRedirect(auth.currentUser, provider)
       .then(/* ... */)
       .catch(/* ... */);
     auth_link_with_redirect.js

     Web namespaced API

     auth.currentUser.linkWithRedirect(provider)
       .then(/* ... */)
       .catch(/* ... */);
     link-multiple-accounts.js

     Une fois que l'utilisateur s'est connecté, il est redirigé vers votre page. Ensuite, vous pouvez récupérer le résultat de la connexion en appelant getRedirectResult lors du chargement de votre page :

     Web modular API

     import { getRedirectResult } from "firebase/auth";
     getRedirectResult(auth).then((result) => {
       const credential = GoogleAuthProvider.credentialFromResult(result);
       if (credential) {
         // Accounts successfully linked.
         const user = result.user;
         // ...
       }
     }).catch((error) => {
       // Handle Errors here.
       // ...
     });
     auth_get_redirect_result.js

     Web namespaced API

     auth.getRedirectResult().then((result) => {
       if (result.credential) {
         // Accounts successfully linked.
         var credential = result.credential;
         var user = result.user;
         // ...
       }
     }).catch((error) => {
       // Handle Errors here.
       // ...
     });
     link-multiple-accounts.js

   Si l'utilisateur est connecté avec succès, le compte de l'utilisateur auprès du fournisseur est lié au compte de l'utilisateur dans votre projet Firebase.

   La liaison de compte échouera si les informations d'identification sont déjà liées à un autre compte d'utilisateur. Dans ce cas, vous devez gérer la fusion des comptes et des données associées en fonction de votre application :

   Web modular API

   import { getAuth, signInWithCredential, linkWithCredential, OAuthProvider } from "firebase/auth";
   
   // The implementation of how you store your user data depends on your application
   const repo = new MyUserDataRepo();
   
   // Get reference to the currently signed-in user
   const auth = getAuth();
   const prevUser = auth.currentUser;
   
   // Get the data which you will want to merge. This should be done now
   // while the app is still signed in as this user.
   const prevUserData = repo.get(prevUser);
   
   // Delete the user's data now, we will restore it if the merge fails
   repo.delete(prevUser);
   
   // Sign in user with the account you want to link to
   signInWithCredential(auth, newCredential).then((result) => {
     console.log("Sign In Success", result);
     const currentUser = result.user;
     const currentUserData = repo.get(currentUser);
   
     // Merge prevUser and currentUser data stored in Firebase.
     // Note: How you handle this is specific to your application
     const mergedData = repo.merge(prevUserData, currentUserData);
   
     const credential = OAuthProvider.credentialFromResult(result);
     return linkWithCredential(prevUser, credential)
       .then((linkResult) => {
         // Sign in with the newly linked credential
         const linkCredential = OAuthProvider.credentialFromResult(linkResult);
         return signInWithCredential(auth, linkCredential);
       })
       .then((signInResult) => {
         // Save the merged data to the new user
         repo.set(signInResult.user, mergedData);
       });
   }).catch((error) => {
     // If there are errors we want to undo the data merge/deletion
     console.log("Sign In Error", error);
     repo.set(prevUser, prevUserData);
   });
   auth_merge_accounts.js

   Web namespaced API

   // The implementation of how you store your user data depends on your application
   var repo = new MyUserDataRepo();
   
   // Get reference to the currently signed-in user
   var prevUser = auth.currentUser;
   
   // Get the data which you will want to merge. This should be done now
   // while the app is still signed in as this user.
   var prevUserData = repo.get(prevUser);
   
   // Delete the user's data now, we will restore it if the merge fails
   repo.delete(prevUser);
   
   // Sign in user with the account you want to link to
   auth.signInWithCredential(newCredential).then((result) => {
     console.log("Sign In Success", result);
     var currentUser = result.user;
     var currentUserData = repo.get(currentUser);
   
     // Merge prevUser and currentUser data stored in Firebase.
     // Note: How you handle this is specific to your application
     var mergedData = repo.merge(prevUserData, currentUserData);
   
     return prevUser.linkWithCredential(result.credential)
       .then((linkResult) => {
         // Sign in with the newly linked credential
         return auth.signInWithCredential(linkResult.credential);
       })
       .then((signInResult) => {
         // Save the merged data to the new user
         repo.set(signInResult.user, mergedData);
       });
   }).catch((error) => {
     // If there are errors we want to undo the data merge/deletion
     console.log("Sign In Error", error);
     repo.set(prevUser, prevUserData);
   });
   link-multiple-accounts.js

Lier l'adresse e-mail et les identifiants de mot de passe à un compte d'utilisateur

Pour ajouter une adresse e-mail et un mot de passe à un compte utilisateur existant :

1. Connectez l'utilisateur à l'aide de n'importe quel fournisseur ou méthode d'authentification.
2. Demander à l'utilisateur une adresse e-mail et un nouveau mot de passe.
3. Créez un objet AuthCredential avec l'adresse e-mail et le mot de passe :

   Web modular API

   import { EmailAuthProvider } from "firebase/auth";
   
   const credential = EmailAuthProvider.credential(email, password);
   auth_make_email_credential.js

   Web namespaced API

   var credential = firebase.auth.EmailAuthProvider.credential(email, password);
   link-multiple-accounts.js

4. Transmettez l'objet AuthCredential à la méthode linkWithCredential de l'utilisateur connecté :

   Web modular API

   import { getAuth, linkWithCredential } from "firebase/auth";
   
   const auth = getAuth();
   linkWithCredential(auth.currentUser, credential)
     .then((usercred) => {
       const user = usercred.user;
       console.log("Account linking success", user);
     }).catch((error) => {
       console.log("Account linking error", error);
     });
   auth_simple_link.js

   Web namespaced API

   auth.currentUser.linkWithCredential(credential)
     .then((usercred) => {
       var user = usercred.user;
       console.log("Account linking success", user);
     }).catch((error) => {
       console.log("Account linking error", error);
     });
   link-multiple-accounts.js

   L'appel à linkWithCredential échouera si les informations d'identification sont déjà liées à un autre compte d'utilisateur. Dans cette situation, vous devez gérer la fusion des comptes et des données associées en fonction de votre application (voir l'exemple ci-dessus).

Dissocier un fournisseur d'authentification d'un compte utilisateur

Vous pouvez dissocier un fournisseur d'authentification d'un compte, afin que l'utilisateur ne puisse plus se connecter avec ce fournisseur.

Pour dissocier un fournisseur d'authentification d'un compte utilisateur, transmettez l'ID du fournisseur à la méthode unlink . Vous pouvez obtenir les ID de fournisseur des fournisseurs d'authentification liés à un utilisateur à partir de la propriété providerData .

import { getAuth, unlink } from "firebase/auth";

const auth = getAuth();
unlink(auth.currentUser, providerId).then(() => {
  // Auth provider unlinked from account
  // ...
}).catch((error) => {
  // An error happened
  // ...
});
auth_unlink_provider.js

user.unlink(providerId).then(() => {
  // Auth provider unlinked from account
  // ...
}).catch((error) => {
  // An error happened
  // ...
});
link-multiple-accounts.js