2016年5月にFirebaseAuthenticationとして最新バージョンのGoogleIdentity Toolkitをリリースし、2019年4月にGoogleCloud のIdentityPlatformをリリースしました。これらの製品には、アップグレードされたクライアントSDK、オープンソースUIライブラリ、セッション管理、およびパスワードを忘れた場合の統合電子メール送信サービスが含まれます。

2020年6月30日、このページとAPI設定ページに記載されているSDKは機能を停止します。（IdentityPlatformとFirebaseAuthenticationで使用されるhttps://identitytoolkit.googleapis.com/...およびhttps://securetoken.googleapis.com/...エンドポイントは引き続き機能します。）

Identity Toolkitから既存のプロジェクトを移行するには、 IdentityPlatform移行ガイドまたはFirebaseAuthentication 移行ガイドを参照してください。

このページは Cloud Translation API によって翻訳されました。

Google Identity Toolkit から Firebase Authentication に移行する

Google Identity Toolkit の最新バージョンが Firebase Authentication としてリリースされました。今後、Identity Toolkit の機能に関する作業は凍結され、新機能の開発はすべて Firebase Authentication で行われます。Identity Toolkit のデベロッパーは、アプリケーションで実用的になり次第、Firebase Authentication に移行することをおすすめします。ただし、Identity Toolkit は引き続き機能し、今後お知らせがない限り非推奨になりません。

新機能

Firebase Authentication には、すでに Google Identity Toolkit よりも優れた機能強化が組み込まれています。

Firebase のすべてにアクセス

Firebase は、質の高いアプリの迅速な開発、ユーザーベースの拡大、収益アップを支援するモバイルプラットフォームです。Firebase は補完的な機能から構成されており、ニーズに合わせて自由に組み合わせて利用できます。また、モバイル分析、クラウドメッセージング、リアルタイムデータベース、ファイルストレージ、静的ホスティング、リモート構成、モバイルクラッシュレポート、Android テストのインフラストラクチャが含まれています。
更新された UI

Google の最新の UX 研究に基づいて、UI フローを全面的に再構築しました。これには、パスワードの再設定、アカウントのリンク、新規または既存のアカウントの曖昧さ回避フローなどがあり、多くの場合、コーディングとデバッグにかなりの時間がかかります。Android で Smart Lock for Passwords を統合し、参加するアプリのログインと登録のコンバージョンを大幅に改善しています。また、アプリに合わせてテーマを簡単に変更でき、最大限のカスタマイズ性を実現するため、Android 版と iOS 版はオープンソース化されています。
サーバーセットアップの簡素化

デベロッパーが Firebase Authentication を簡単に使用できるようになりました。Identity Toolkit を使用して、多くのデベロッパーがメール復元フローを実装しないことで、ユーザーがパスワードを忘れた場合にアカウントを復元できないようにしていることがわかりました。Firebase Authentication では、メール確認、パスワードの再設定、パスワード変更に関するメッセージをユーザーに送信でき、ユーザーに合わせてテキストを簡単にカスタマイズできます。また、リダイレクトをホストし、パスワード変更オペレーションを完了するために UI ウィジェットをホストする必要がなくなりました。
新しい管理コンソール

Firebase には新しいデベロッパーコンソールがあり、[Authentication] セクションでは、ユーザーを表示、変更、削除できます。これは、ログインと登録のフローをデバッグする際に役立ちます。コンソールでは、認証方法を構成し、メールテンプレートをカスタマイズすることもできます。
新しい SDK

Identity Toolkit のすべてのサーバー API が、各クライアントライブラリ（Android、iOS、ウェブ）でネイティブに使用できるようになりました。デベロッパーは、固定の UI に縛られることなく、既存および新規のユーザーのログインと登録、ユーザープロパティへのアクセス、リンク、アカウントの更新と削除、パスワードのリセットなどを行うことができます。必要に応じて、この API 上に独自のログインフローとエクスペリエンス全体を手動で構築することもできます。
モバイルアプリのセッション管理

Identity Toolkit では、Identity Toolkit の初期認証イベントに基づいて、アプリが独自のセッション状態を作成しました。Firebase Auth はバックエンドサービスを使用して、認証イベントから作成されたリフレッシュトークンを取得し、Android、iOS、JavaScript 用の 1 時間のアクセストークンと交換します。ユーザーがパスワードを変更すると、更新トークンは新しいアクセストークンを生成できなくなり、ユーザーがそのデバイスで再認証するまでアクセスが無効になります。
匿名認証と GitHub 認証

Firebase Authentication では、GitHub と匿名の 2 つの新しい認証タイプがサポートされています。匿名ログインを使用すると、ユーザーにログインや登録のプロセスを行わなくても、一意のユーザー ID を作成できます。これで、匿名ユーザーを使用して、通常のユーザーと同様に、認証された API 呼び出しを行うことができます。ユーザーがアカウントの登録を決定すると、すべてのアクティビティが同じユーザー ID で保持されます。これは、サーバーサイドのショッピングカートや、登録フローでユーザーを送信する前に働きかけたいアプリケーションに適しています。

機能の違い

現在、Identity Toolkit の一部の機能は Firebase Authentication では使用できません。また、設計が再設計され、動作が異なる機能もあります。これらの機能がアプリにとって重要な場合は、すぐには移行しないことをおすすめします。多くの場合、これらの機能がアプリにとって重要でないか、簡単にフォールバックでき、移行を続行できます。

サーバーサイドの違い

基盤となる REST API、アカウント検証ロジック、プライマリユーザーデータベースを備えた Core Identity Toolkit サービスに、マイナーな更新のみが行われました。ただし、一部の機能と Firebase Authentication をサービスに統合する方法が変更されました。

ID プロバイダ

PayPal と AOL はサポートされていません。これらの IdP のアカウントを持つユーザーは、引き続きパスワード復元フローを使用してアプリケーションにログインし、アカウントのパスワードを設定できます。
サーバーライブラリ

現在、Java、Node.js、Python、Go、C# で利用可能な Firebase Admin SDK があります。
アカウント管理メール

パスワードの再設定、メール確認、メール変更のメッセージは、Firebase またはデベロッパー独自のメールサーバーから実行できます。現在、Firebase メールテンプレートのカスタマイズは限定的です。
メールアドレス変更の確認

Identity Toolkit では、ユーザーがメールアドレスの変更を決定すると、メールアドレスの変更フローを続行するためのリンクが記載されたメールが新しいアドレスに送信されます。

Firebase は、変更を元に戻すためのリンクが記載された取り消しメールを古いメールアドレスに送信して、メールアドレスの変更を確認します。
IdP のロールアウト

Identity Toolkit には、ログインシステムに ID プロバイダを段階的に追加する機能があり、サポートリクエストへの影響をテストできました。この機能は Firebase Authentication で削除されました。

クライアントサイドの違い

Firebase では、Google Identity Toolkit によって提供される機能は、次の 2 つのコンポーネントに分かれています。

Firebase Authentication SDK

Firebase Authentication では、Identity Toolkit の REST API によって提供される機能が、Android、iOS、JavaScript 用のクライアント SDK にパッケージ化されています。この SDK を使用すると、REST 呼び出しでバックエンドサービスと通信する代わりに、クライアント SDK を使用して、ユーザーのログインと登録、ユーザープロフィール情報へのアクセス、アカウントのリンク、更新、削除、パスワードの再設定を行うことができます。
FirebaseUI 認証

ログイン、登録、パスワードの再設定、アカウントのリンクを管理するすべての UI フローは、Frebase Authentication SDK を使用して再構築されています。iOS と Android 向けのオープンソース SDK として提供されているため、Identity Toolkit では不可能な方法でフローを完全にカスタマイズできます。

その他に次の点が異なります。

セッションと移行

セッションの管理は Identity Toolkit と Firebase Authentication で異なるため、SDK をアップグレードするとユーザーの既存のセッションは終了し、ユーザーは再度ログインする必要があります。

始める前に

Identity Toolkit から Firebase Authentication に移行する前に、

Firebase コンソールを開き、[Google プロジェクトをインポート] をクリックして、Identity Toolkit プロジェクトを選択します。
> [権限] をクリックして、[IAM と管理] ページを開きます。
サービスアカウント] ページを開きます。ここでは、以前に Identity Toolkit 用に構成したサービスアカウントを確認できます。
サービスアカウントの横にある [] > [キーを作成] をクリックします。次に、[秘密鍵の作成] ダイアログで鍵のタイプを [JSON] に設定し、[作成] をクリックします。サービスアカウントの認証情報を含む JSON ファイルがダウンロードされます。これは、次のステップで SDK を初期化するために必要です。

重要: このファイルは、サービスアカウントの秘密暗号鍵などの機密情報を含み、1 回だけ生成されます。キーを紛失または漏洩した場合は、サービスアカウント管理ページを使用して、サービスアカウント用に新しい JSON キーを作成できます。
Firebase コンソールに戻ります。 [Auth] セクションで、[Email Templates] ページを開きます。このページでは、アプリのメールテンプレートをカスタマイズします。

Identity Toolkit では、ユーザーがパスワードの再設定、メールアドレスの変更、メールアドレスの確認を行うと、Identity Toolkit サーバーから OOB コードを取得し、そのコードをメールでユーザーに送信する必要がありました。Firebase は、構成したテンプレートに基づいてメールを送信します。追加の操作は必要ありません。
省略可: サーバー上の Firebase サービスにアクセスする必要がある場合は、Firebase SDK をインストールします。
1. Firebase Node.js モジュールは、npm を使用してインストールできます。
```
$ npm init
$ npm install --save firebase-admin
```
2. コードでは、以下を使用して Firebase にアクセスできます。
```
var admin = require('firebase-admin');
var app = admin.initializeApp({
  credential: admin.credential.cert('path/to/serviceAccountCredentials.json')
});
```

次に、アプリのプラットフォーム（Android、iOS、ウェブ）の移行手順を完了します。

サーバーと JavaScript

主な変更点

Firebase のウェブ実装と Identity Toolkit のウェブ実装には、他にもいくつかの違いがあります。

ウェブセッションの管理

以前は、ユーザーが Identity Toolkit ウィジェットを使用して認証すると、セッションのブートストラップに使用されたユーザーの Cookie が設定されていました。この Cookie の有効期間は 2 週間で、ユーザーがアカウント管理ウィジェットでパスワードとメールアドレスを変更できるようにするために使用されました。一部のサイトでは、この Cookie を使用して、サイト上の他のすべてのページリクエストを認証しています。他のサイトでは、この Cookie を使用して、そのフレームワークの Cookie 管理システムで独自の Cookie を作成しています。

現在、Firebase クライアント SDK は Firebase ID トークンを管理し、Firebase Authentication のバックエンドと連携してセッションを最新の状態に保ちます。アカウントに関する重要な変更（ユーザーのパスワードの変更など）が発生すると、バックエンドはセッションを期限切れにします。Firebase ID トークンは、ウェブクライアントの Cookie として自動的に設定されることはなく、有効期間は 1 時間です。1 時間のセッションが必要な場合を除き、Firebase ID トークンを Cookie として使用してすべてのページリクエストを検証することは適切ではありません。代わりに、ユーザーがログインしたときのリスナーを設定し、Firebase ID トークンを取得して、トークンを検証し、フレームワークの Cookie 管理システムを介して独自の Cookie を作成する必要があります。

Cookie のセッション存続期間は、アプリケーションのセキュリティ要件に基づいて設定する必要があります。
ウェブログインフロー

以前は、ユーザーが使用したい ID を確認するため、ログインが開始されると、ユーザーは accountchooser.com にリダイレクトされていました。Firebase Auth UI のフローは、ウェブの場合は accountchooser.com に移動し、Android の場合は HintRequest API を使用するメールオプションなど、ログイン方法のリストで始まります。また、Firebase UI ではメールアドレスが不要になりました。これにより、匿名ユーザー、カスタム認証ユーザー、メールアドレスを必要としないプロバイダのユーザーのサポートが容易になります。
アカウント管理ウィジェット

このウィジェットは、メールアドレスの変更、パスワードの変更、ID プロバイダとのアカウントのリンク解除を行うための UI をユーザーに提供します。現在開発中です。
ログインボタン/ウィジェット

ログインボタンやユーザーカードなどのウィジェットは提供されなくなりました。これは、Firebase Authentication API を使用して非常に簡単に構築できます。
signOutUrl がない

firebase.auth.signOut() を呼び出してコールバックを処理する必要があります。
oobActionUrl がない

メールの送信は Firebase によって処理され、Firebase コンソールで構成するようになりました。
CSS のカスタマイズ

FirebaseUI は、マテリアルデザインアニメーションを動的に追加する Material Design Lite スタイル設定を使用します。

ステップ 1: サーバーコードを変更する

サーバーが Identity Toolkit トークン（2 週間有効）を使用してウェブユーザーセッションを管理している場合は、独自のセッション Cookie を使用するようにサーバーを変換する必要があります。
1. Firebase ID トークンを検証し、ユーザーのセッション Cookie を設定するためのエンドポイントを実装します。クライアントアプリは、このエンドポイントに Firebase ID トークンを送信します。
2. 受信リクエストに独自のセッション Cookie が含まれている場合は、ユーザーが認証済みと見なされます。それ以外の場合は、リクエストを未認証として扱います。
3. どのユーザーも既存のログインセッションを失わないようにする場合は、すべての Identity Toolkit トークンが期限切れになるまで 2 週間待つか、以下のステップ 3 で説明するように、ウェブアプリケーションのデュアルトークン検証も行います。
次に、Firebase トークンは Identity Toolkit トークンとは異なるため、トークン検証ロジックを更新する必要があります。Firebase Server SDK をサーバーにインストールします。Firebase Server SDK でサポートされていない言語を使用している場合は、ご使用の環境に JWT トークン検証ライブラリをダウンロードして、適切にトークンを検証します。
上記の更新を初めて行う場合は、Identity Toolkit トークンに依存するコードパスがまだ残っている場合があります。iOS アプリや Android アプリの場合、新しいコードパスを機能させるには、アプリを新しいバージョンにアップグレードする必要があります。ユーザーにアプリの更新を強制しない場合は、トークンを調べて、トークンの検証に Firebase SDK または Identity Toolkit SDK を使用する必要があるかどうかを判断するサーバー検証ロジックを追加できます。ウェブアプリケーションのみがある場合は、新しい認証リクエストはすべて Firebase に移行されるため、Firebase のトークン検証方法を使用するだけで済みます。

Firebase ウェブ API リファレンスをご覧ください。

ステップ 2: HTML を更新する

Firebase 初期化コードをアプリに追加します。
1. Firebase コンソールでプロジェクトを開きます。
2. 概要ページで [アプリを追加] をクリックし、[ウェブアプリに Firebase を追加] をクリックします。Firebase を初期化するコードスニペットが表示されます。
3. 初期化スニペットをコピーしてウェブページに貼り付けます。

アプリに FirebaseUI Auth を追加します。

<script src="https://www.gstatic.com/firebasejs/ui/live/0.4/firebase-ui-auth.js"></script>
<link type="text/css" rel="stylesheet" href="https://www.gstatic.com/firebasejs/ui/live/0.4/firebase-ui-auth.css" />
<!-- *******************************************************************************************
   * TODO(DEVELOPER): Paste the initialization snippet from:
   * Firebase Console > Overview > Add Firebase to your web app. *
   ***************************************************************************************** -->
<script type="text/javascript">
  // FirebaseUI config.
  var uiConfig = {
    'signInSuccessUrl': '<url-to-redirect-to-on-success>',
    'signInOptions': [
      // Leave the lines as is for the providers you want to offer your users.
      firebase.auth.GoogleAuthProvider.PROVIDER_ID,
      firebase.auth.FacebookAuthProvider.PROVIDER_ID,
      firebase.auth.TwitterAuthProvider.PROVIDER_ID,
      firebase.auth.GithubAuthProvider.PROVIDER_ID,
      firebase.auth.EmailAuthProvider.PROVIDER_ID
    ],
    // Terms of service url.
    'tosUrl': '<your-tos-url>',
  };

  // Initialize the FirebaseUI Widget using Firebase.
  var ui = new firebaseui.auth.AuthUI(firebase.auth());
  // The start method will wait until the DOM is loaded.
  ui.start('#firebaseui-auth-container', uiConfig);
</script>

アプリから Identity Toolkit SDK を削除します。
セッション管理に Identity Toolkit ID トークンを使用している場合は、クライアント側で次の変更を行う必要があります。
1. Firebase で正常にログインしたら、firebase.auth().currentUser.getToken() を呼び出して Firebase ID トークンを取得します。
2. Firebase ID トークンをバックエンドサーバーに送信して検証し、独自のセッション Cookie を発行します。
  
  機密性の高い操作を行う場合や、認証済みの編集リクエストをサーバーに送信する場合は、セッション Cookie のみに頼らないようにしてください。クロスサイトリクエストフォージェリ（CSRF）に対する保護を強化する必要があります。
  
  フレームワークで CSRF 保護が提供されない場合、攻撃を防ぐ 1 つの方法は、ログインユーザーの Firebase ID トークンを getToken() で取得し、そのトークンを各リクエストに含めることです（セッション Cookie もデフォルトで送信されます）。その後、バックエンドフレームワークで完了したセッション Cookie チェックに加えて、Firebase Server SDK を使用してトークンを検証します。Firebase ID トークンはウェブストレージにのみ保存され、Cookie には保存されないため、CSRF 攻撃が成功しにくくなります。
3. Identity Toolkit トークンは 2 週間有効です。トークンの発行は 2 週間継続するか、アプリのセキュリティ要件に応じて変更することをおすすめします。ユーザーがログアウトしたら、セッション Cookie を消去します。

ステップ 3: IdP のリダイレクト URL を更新する

Firebase コンソールで [Authentication] セクションを開き、[ログイン方法] タブをクリックします。
サポートしているフェデレーションログインプロバイダごとに、次の操作を行います。
1. ログインプロバイダの名前をクリックします。
2. OAuth リダイレクト URI をコピーします。
3. ログインプロバイダのデベロッパーコンソールで、OAuth リダイレクト URI を更新します。

Android

ステップ 1: Firebase をアプリに追加する

Firebase コンソールを開き、すでにインポートしている Identity Toolkit プロジェクトを選択します。
概要ページで [アプリを追加] をクリックし、[Android アプリに Firebase を追加] をクリックします。[Firebase を追加] ダイアログで、アプリのパッケージ名と署名証明書フィンガープリントを入力して、[アプリを追加] をクリックします。google-services.json 構成ファイルがパソコンにダウンロードされます。
構成ファイルを Android アプリモジュールのルートディレクトリにコピーします。この構成ファイルには、プロジェクトと Google OAuth クライアント情報が含まれています。
プロジェクトレベルの build.gradle ファイル（<var>your-project</var>/build.gradle）の defaultConfig セクションに、アプリのパッケージ名を指定します。
```
defaultConfig {
   …..
  applicationId "com.your-app"
}
```
また、プロジェクトレベルの build.gradle ファイルで、google-services プラグインを含める依存関係を追加します。
```
buildscript {
 dependencies {
   // Add this line
   classpath 'com.google.gms:google-services:3.0.0'
 }
}
```
アプリのアプリレベルの build.gradle ファイル（<var>my-project</var>/<var>app-module</var>/build.gradle）の末尾に次の行を追加して、google-services プラグインを有効にします。
```
// Add to the bottom of the file
apply plugin: 'com.google.gms.google-services'
```
google-services プラグインは、google-services.json ファイルを使用して、Firebase を使用するようにアプリケーションを構成します。

アプリレベルの build.gradle ファイルで、Firebase Authentication の依存関係を追加します。

compile 'com.google.firebase:firebase-auth:22.3.1'
compile 'com.google.android.gms:play-services-auth:21.0.0'

ステップ 2: Identity Toolkit SDK を削除する

AndroidManifest.xml ファイルから Identity Toolkit の構成を削除します。この情報は google-service.json ファイルに含まれ、google-services プラグインによって読み込まれます。
アプリから Identity Toolkit SDK を削除します。

ステップ 3: アプリに FirebaseUI を追加する

アプリに FirebaseUI Auth を追加します。
アプリで Identity Toolkit SDK の呼び出しを FirebaseUI の呼び出しに置き換えます。

iOS

ステップ 1: Firebase をアプリに追加する

次のコマンドを実行して、アプリに Firebase SDK を追加します。
```
$ cd your-project directory
$ pod init
$ pod 'Firebase'
```
Firebase コンソールを開き、すでにインポートしている Identity Toolkit プロジェクトを選択します。
概要ページで [アプリを追加] をクリックし、[iOS アプリに Firebase を追加] をクリックします。[Firebase の追加] ダイアログで、アプリのバンドル ID と App Store ID を入力して、[アプリを追加] をクリックします。GoogleService-Info.plist 構成ファイルがパソコンにダウンロードされます。プロジェクトに複数のバンドル ID がある場合は、独自の GoogleService-Info.plist ファイルを設定できるように、各バンドル ID を Firebase コンソールで接続する必要があります。
構成ファイルを Xcode プロジェクトのルートにコピーし、すべてのターゲットに追加します。

ステップ 2: Identity Toolkit SDK を削除する

アプリの Podfile から GoogleIdentityToolkit を削除します。
pod install コマンドを実行します。

ステップ 3: アプリに FirebaseUI を追加する

アプリに FirebaseUI Auth を追加します。
アプリで Identity Toolkit SDK の呼び出しを FirebaseUI の呼び出しに置き換えます。