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

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

始める前に

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

既存のユーザー アカウントに認証プロバイダの認証情報をリンクするには:

  1. 任意の認証プロバイダや認証方法を使用してユーザーのログインを行います。

  2. 新しい認証プロバイダのログインフローを行います（ただし、いずれかの signInWith メソッドを呼び出す手前まで）。たとえば、ユーザーの Google ID トークン、Facebook アクセス トークン、またはメールアドレスとパスワードを取得します。

  3. 新しい認証プロバイダの Credential オブジェクトを取得します。

    // Google Sign-in
final credential = GoogleAuthProvider.credential(idToken: idToken);

// Email and password sign-in
final credential =
    EmailAuthProvider.credential(email: emailAddress, password: password);

// Etc.

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

    try {
  final userCredential = await FirebaseAuth.instance.currentUser
      ?.linkWithCredential(credential);
} on FirebaseAuthException catch (e) {
  switch (e.code) {
    case "provider-already-linked":
      print("The provider has already been linked to the user.");
      break;
    case "invalid-credential":
      print("The provider's credential is not valid.");
      break;
    case "credential-already-in-use":
      print("The account corresponding to the credential already exists, "
          "or is already linked to a Firebase User.");
      break;
    // See the API reference for the full list of error codes.
    default:
      print("Unknown error.");
  }
  ```

linkWithCredential() の呼び出しが成功したら、ユーザーはリンクされた認証プロバイダを使用してログインし、同じ Firebase データにアクセスできるようになります。

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

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

try {
  await FirebaseAuth.instance.currentUser?.unlink(providerId);
} on FirebaseAuthException catch (e) {
  switch (e.code) {
    case "no-such-provider":
      print("The user isn't linked to the provider or the provider "
          "doesn't exist.");
      break;
    default:
      print("Unknown error.");
  }
}

トラブルシューティング

複数のアカウントをリンクしようとしたときにエラーが発生した場合は、確認済みのメールアドレスに関するドキュメントをご確認ください。