メール アクションで状態を渡す

パスワードの再設定や、ユーザーのメールアドレスを確認する目的でメール アクションを送信するときに、続行 URL を使用して状態を渡すことができます。これにより、ユーザーはアクションの完了後にアプリに戻れるようになります。また、モバイルアプリがインストールされている場合に、ウェブページではなくモバイルアプリからメール アクション リンクが直接処理されるようにデベロッパー側で指定することも可能です。

これは、次の一般的に起こるシナリオで非常に役立ちます。

  • 現在ログインしていないユーザーがログインの必要なコンテンツにアクセスしようとしているが、パスワードを忘れたため、パスワードを再設定するフローをトリガーする場合。ユーザーはこのフローの終了後、元々アクセスしようとしていたアプリのセクションに戻ることを期待しています。

  • 確認済みのアカウントにしかアクセスを許可しないアプリの場合。たとえば、ニュースレターの登録では、ユーザーにメールアドレスの確認を求めます。ユーザーはメール確認フローを処理した後に、アプリに戻って登録を完了できることを期待しています。

  • その他、ユーザーがモバイル デバイスからフローを開始した場合。ユーザーはフローの確認後、ブラウザではなくモバイルアプリに戻ることを期待しています。

続行 URL を使用して状態を受け渡せる Firebase Auth の強力な機能により、ユーザー エクスペリエンスを大幅に向上させることができます。

メール アクションで続行 URL の状態を渡す

続行 URL を安全に渡すには、URL のドメインが Firebase コンソールで承認済みドメインとして追加されている必要があります。それには、[Authentication] セクションで、[ログイン方法] タブの下にある [承認済みドメイン] のリストにこのドメインを追加します（まだ存在しない場合）。

パスワードの再設定メールまたは確認メールを送信する際は、firebase.auth.ActionCodeSettings インスタンスを指定する必要があります。このインターフェースでは、次のパラメータを指定できます。

パラメータ 型 説明
url 文字列

コンテキストによって異なる意味を持つリンク（状態 / 続行 URL）を設定します。

  • リンクがウェブ アクション ウィジェットで処理される場合、これは continueUrl クエリ パラメータのディープリンクを表します。
  • リンクがアプリ内で直接処理される場合、これは Hosting リンクのディープリンク内の continueUrl クエリ パラメータを表します。
iOS ({bundleId: string}|undefined) iOS バンドル ID を設定して、Firebase Authentication が Apple デバイスで開くウェブ専用リンクとモバイルリンクのどちらを作成するかを判断できるようにします。
android ({packageName: string, installApp:boolean|undefined, minimumVersion: string|undefined}|undefined) Android パッケージ名を設定して、Firebase Authentication が Android デバイスで開くウェブ専用リンクとモバイルリンクのどちらを作成するかを判断できるようにします。
handleCodeInApp (boolean|undefined) メール アクション リンクがモバイルアプリとウェブリンクのどちらで最初に開かれるかを示します。デフォルトは false です。true に設定すると、アクション コード リンクはユニバーサル リンクまたは Android アプリリンクとして送信され、アプリがインストールされている場合はそのアプリで開かれます。false の場合、コードは最初にウェブ ウィジェットに送信され、続いてアプリがインストールされている場合はそのアプリにリダイレクトされます。
linkDomain (string|undefined) プロジェクトにカスタム Hosting リンク ドメインが定義されている場合に、指定したモバイルアプリでリンクを開く際に使用するドメインを指定します。指定しない場合、デフォルトのドメインが自動的に選択されます（PROJECT_ID.firebaseapp.com など）。
dynamicLinkDomain (string|undefined) 非推奨。このパラメータは指定しないでください。

次の例は、カスタム Hosting ドメイン custom-domain.com を使用して、モバイルアプリで最初に開かれるメール確認リンクを送信する方法を示しています。ディープリンクには、続行 URL ペイロード https://www.example.com/?email=user@example.com が含まれています。

const actionCodeSettings = {
  url: 'https://www.example.com/?email=' + firebase.auth().currentUser.email,
  iOS: {
    bundleId: 'com.example.ios'
  },
  android: {
    packageName: 'com.example.android',
  },
  handleCodeInApp: true,
  // Specify a custom Hosting link domain to use. The domain must be
  // configured in Firebase Hosting and owned by the project.
  linkDomain: "custom-domain.com"
};
firebase.auth().currentUser.sendEmailVerification(actionCodeSettings)
  .then(function() {
    // Verification email sent.
  })
  .catch(function(error) {
    // Error occurred. Inspect error.code.
  });

Firebase Authentication は、モバイルアプリで開かれるリンクを送信するときに Firebase Hosting を使用します。この機能を使用するには、Firebase コンソールでホスティング リンクを構成する必要があります。

  1. Android アプリを構成します。

    1. Android アプリでこれらのリンクを処理する予定の場合は、Firebase コンソールのプロジェクト設定でアプリのパッケージ名を指定する必要があります。それに加えて、アプリ証明書の SHA-1 および SHA-256 を指定する必要があります。
    2. AndroidManifest.xml ファイルで、ディープリンクのインテント フィルタを構成する必要があります。
    3. 詳しくは、Android Hosting リンクの受信の手順をご覧ください。

  2. iOS アプリを構成します。

    1. iOS アプリでこれらのリンクを処理する予定の場合は、アプリ機能の関連ドメインとして Hosting リンク ドメインを構成する必要があります。
    2. 詳しくは、iOS Hosting リンクの受信の手順をご覧ください。

ウェブ アプリケーションでメール アクションを処理する

最初にウェブアプリでアクション コード リンクを処理し、正常に完了した後で別のウェブページまたはモバイルアプリ（使用可能な場合）にリダイレクトするかどうかを指定できます。これを行うには、firebase.auth.ActionCodeSettings オブジェクトで handleCodeInApp を false に設定します。iOS バンドル ID または Android パッケージ名は必須ではありませんが、指定すると、メール アクション コードの完了時にユーザーを指定されたアプリにリダイレクトさせることができます。

ここで使用されるウェブ URL は、メール アクション テンプレートのセクションで設定された URL です。デフォルトの URL がすべてのプロジェクトにプロビジョニングされます。メール アクション ハンドラをカスタマイズする方法について詳しくは、メールハンドラのカスタマイズをご覧ください。

この場合、continueUrl クエリ パラメータ内のリンクは、ActionCodeSettings オブジェクトで指定された URL がペイロードに含まれる Hosting リンクになります。

メール確認などのメール アクションを処理する場合、ディープリンクから oobCode クエリ パラメータのアクション コードを解析した後、applyActionCode を使用してそのコードを適用し、変更を有効にする（メール確認などが行われるようにする）必要があります。

モバイルアプリでメール アクションを処理する

モバイルアプリがインストールされている場合に、最初にモバイルアプリ内でアクション コード リンクを処理するかどうかを指定できます。そのモバイルアプリをサポートしていないデバイスからリンクがクリックされた場合、リンクはウェブページから開かれます。これを行うには、firebase.auth.ActionCodeSettings オブジェクトで handleCodeInApp を true に設定します。モバイルアプリの Android パッケージ名または iOS バンドル ID も指定する必要があります。

モバイルアプリが使用できない場合に使用される代替ウェブ URL は、メール アクション テンプレートのセクションで設定された URL です。デフォルトの URL がすべてのプロジェクトにプロビジョニングされます。メール アクション ハンドラをカスタマイズする方法について詳しくは、メールハンドラのカスタマイズをご覧ください。

この場合、ユーザーに送信されるモバイルアプリ リンクは、ペイロードがアクション コード URL の Hosting リンクとなります。このリンクは、コンソールで構成され、oobCode、mode、apiKey、continueUrl のクエリ パラメータを含んでいます。後者は、ActionCodeSettings オブジェクトで指定された元の URL になります。アクション コードは、メールハンドラのカスタマイズで説明されているウェブフローからの処理方法と同様に、モバイルアプリから直接適用できます。

メール確認などのメール アクションを処理する場合、ディープリンクから oobCode クエリ パラメータのアクション コードを解析した後、applyActionCode を使用してそのコードを適用し、変更を有効にする（メール確認などが行われるようにする）必要があります。