JavaScript を使用してアカウントに複数の認証プロバイダをリンクする

既存のユーザー アカウントに認証プロバイダの認証情報をリンクすると、ユーザーが複数の認証プロバイダを使用してアプリにログインできるようになります。ログインに使用した認証プロバイダに関係なく、同じ Firebase ユーザー ID でユーザーを識別できます。たとえば、パスワードを使用してログインしたユーザーが Google アカウントの認証情報をリンクすると、それ以降はどちらの方法でもログインできるようになります。また、匿名ユーザーが Facebook アカウントの認証情報をリンクすると、それ以降は Facebook を使ってログインしてアプリを使用できるようになります。

始める前に

アプリに複数の認証プロバイダ（匿名認証も含む）のサポートを追加します。

ユーザー アカウントにフェデレーション認証プロバイダの認証情報をリンクする

既存のユーザー アカウントに Google や Facebook などの認証プロバイダからの認証情報をリンクするには、以下の手順を行います。

1. 任意の認証プロバイダや認証方法を使用してユーザーのログインを行います。
2. ユーザーのアカウントにリンクするプロバイダに対応する AuthProvider オブジェクトを取得します。例:

   ウェブ向けのモジュラー API

   ツリー シェイキングが可能なモジュラー ウェブ API の詳細と、名前空間 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 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. リンク対象のプロバイダにログインするようユーザーに促します。ポップアップ ウィンドウをユーザーに表示するか、プロバイダのログインページにリダイレクトすることにより、ログインを促すことができます。モバイル デバイスではリダイレクトすることをおすすめします。
   • ポップアップ ウィンドウでログインを行う場合は、linkWithPopup を呼び出します。

     ウェブ向けのモジュラー API

     ツリー シェイキングが可能なモジュラー ウェブ API の詳細と、名前空間 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

     ウェブ向けの名前空間付き 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

   • プロバイダのログインページにリダイレクトしてログインを行う場合は、linkWithRedirect を呼び出します。「linkWithRedirect」を使用する場合は、ベスト プラクティスに従ってください。

     ウェブ向けのモジュラー API

     ツリー シェイキングが可能なモジュラー ウェブ API の詳細と、名前空間 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 API

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

     ユーザーは、ログイン後に元のページにリダイレクトされます。元のページが読み込まれるときに getRedirectResult を呼び出すと、ログイン結果を取得できます。

     ウェブ向けのモジュラー API

     ツリー シェイキングが可能なモジュラー ウェブ API の詳細と、名前空間 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 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

   ユーザーが正常にログインすると、プロバイダでのユーザー アカウントが Firebase プロジェクト内のユーザー アカウントにリンクされます。

   認証情報がすでに別のユーザー アカウントにリンクされている場合は、アカウントのリンク付けが失敗します。この場合は、アプリに適した方法でアカウントと関連データの統合を行う必要があります。

   モジュール方式の Web API

   ツリー シェイキングが可能なモジュラー ウェブ API の詳細と、名前空間 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 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

ユーザー アカウントにメールアドレスとパスワードの認証情報をリンクする

既存のユーザー アカウントにメールアドレスとパスワードの認証情報をリンクするには、以下の手順を行います。

1. 任意の認証プロバイダや認証方法を使用してユーザーのログインを行います。
2. ユーザーにメールアドレスと新しいパスワードの入力を促します。
3. そのメールアドレスとパスワードを使って AuthCredential オブジェクトを作成します。

   ウェブ向けのモジュラー API

   ツリー シェイキングが可能なモジュラー ウェブ API の詳細と、名前空間 API からのアップグレード方法をご確認ください。

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

   名前空間対応の Web API

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

4. ログイン ユーザーの linkWithCredential メソッドに AuthCredential オブジェクトを渡します。

   モジュール方式の Web API

   ツリー シェイキングが可能なモジュラー ウェブ API の詳細と、名前空間 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 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

   認証情報が別のユーザー アカウントにすでにリンクされている場合は、linkWithCredential の呼び出しが失敗します。その場合、アプリに適した方法でアカウントと関連データの統合を行う必要があります（上記の例を参照）。

ユーザー アカウントから認証プロバイダのリンクを解除する

アカウントから認証プロバイダのリンクを解除することで、ユーザーがそのプロバイダを使用してログインできなくなります。

ユーザー アカウントから認証プロバイダのリンクを解除するには、プロバイダ ID を unlink メソッドに渡します。ユーザーにリンクされている認証プロバイダのプロバイダ ID は providerData プロパティから取得できます。

モジュール方式の Web API

ツリー シェイキングが可能なモジュラー ウェブ API の詳細と、名前空間 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
  // ...
});
auth_unlink_provider.js

名前空間が指定されたウェブ API

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