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 associant les informations d'identification du fournisseur d'authentification à un compte utilisateur existant. Les utilisateurs sont identifiables par le même identifiant 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 associer un compte Google et se connecter avec l'une ou l'autre méthode à l'avenir. Ou bien, un utilisateur anonyme peut associer 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.

Pour associer 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 associer 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();

    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();
  3. Invitez l’utilisateur à se connecter auprès du fournisseur que vous souhaitez associer. Vous pouvez inviter vos utilisateurs à se connecter soit en ouvrant une fenêtre contextuelle, soit en les redirigeant vers la page de connexion du fournisseur. La méthode de redirection est privilégié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.
        // ...
      });

      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.
        // ...
      });
    • Pour vous connecter en 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(/* ... */);

      Web namespaced API

      auth.currentUser.linkWithRedirect(provider)
        .then(/* ... */)
        .catch(/* ... */);
      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.
        // ...
      });

      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.
        // ...
      });
    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 utilisateur. Dans cette situation, 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);
    });

    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);
    });

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);

    Web namespaced API

    var credential = firebase.auth.EmailAuthProvider.credential(email, password);
  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);
      });

    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);
      });

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

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 des fournisseurs d'authentification liés à un utilisateur à partir de la propriété providerData .

Web modular API

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

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

Web namespaced API

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