2016 年 5 月に、Google Identity Toolkit の最新バージョンを Firebase Authentication としてリリースし、2019 年 4 月に Google Cloud の Identity Platform をリリースしました。これらのプロダクトには、アップグレードされたクライアント SDK、オープンソースの UI ライブラリ、セッション管理、パスワード忘れのフロー用の統合メール送信サービスが含まれています。

2020 年 6 月 30 日をもって、このページに記載されている SDK と API 設定ページは機能しなくなります。（Identity Platform と Firebase Authentication で使用される https://identitytoolkit.googleapis.com/... エンドポイントと https://securetoken.googleapis.com/... エンドポイントは引き続き機能します）。

Identity Toolkit から既存のプロジェクトを移行するには、Identity Platform 移行ガイドまたは Firebase Authentication 移行ガイドをご覧ください。

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 は、ニーズに合わせて組み合わせることができる補完的な機能で構成されており、モバイルアナリティクス、Cloud Messaging、Realtime Database、ファイルストレージ、静的ホスティング、Remote Config、モバイルクラッシュレポート、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、アカウント検証ロジック、メインユーザーデータベースを備えたコア Identity Toolkit サービスは、わずかな更新しか行われていません。ただし、一部の機能と、Firebase Authentication をサービスに統合する方法は変更されています。

ID プロバイダ

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

現在、Firebase Admin SDK が Java、Node.js、Python、Go、C# 用に用意されています。
アカウント管理メール

パスワードの再設定、メール確認、メール変更のメッセージは、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 Auth

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

その他の違いは次のとおりです。

セッションと移行

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

始める前に

Identity Toolkit から Firebase Authentication に移行するには、次の操作を行う必要があります。

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

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

Identity Toolkit では、ユーザーがパスワードをリセットしたり、メールアドレスを変更したり、メールアドレスを確認したりした場合、Identity Toolkit サーバーから OOB コードを取得し、メールでユーザーに送信する必要がありました。 Firebase は、構成したテンプレートに基づいてメールを送信します。追加の操作は必要ありません。
省略可: サーバーで Firebase サービスにアクセスする必要がある場合は、 Firebase SDK をインストールします。
1. npm を使用して Firebase Node.js モジュールをインストールできます。
```
$ 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

主な変更点

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

ウェブセッション管理

以前は、ユーザーが 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 Web 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 保護が提供されていない場合は、攻撃を防ぐ方法として、getToken() を使用してログイン済みユーザーの Firebase ID トークンを取得し、各リクエストにトークンを含める方法があります（セッション 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:24.0.1'
compile 'com.google.android.gms:play-services-auth:21.5.1'

ステップ 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 がある場合は、Firebase コンソールで各バンドル ID を接続して、独自の GoogleService-Info.plist ファイルを設定できるようにする必要があります。
構成ファイルを Xcode プロジェクトのルートにコピーし、すべてのターゲットに追加します。

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

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

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

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

Google Identity Toolkit から Firebase Authentication に移行する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

新機能

機能の違い

サーバーサイドの違い

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

始める前に

サーバーと JavaScript

主な変更点

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

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

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

Android

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

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

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

iOS

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

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

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

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

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