Firebase Summit で発表されたすべての情報をご覧ください。Firebase を使用してアプリ開発を加速し、自信を持ってアプリを実行する方法を紹介しています。詳細

カスタムドメインを接続する

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Firebase Hosting を使用すれば、独自のブランド中心のドメイン名をあきらめる必要はありません。 Firebase がホストするサイトでは、Firebase が生成したドメインの代わりに、カスタム ドメイン ( example.comapp.example.com ) を使用できます。

Firebase Hosting は、ドメインごとに SSL 証明書をプロビジョニングし、グローバル CDN 経由でコンテンツを提供します。

このドキュメントの残りの部分では、これらの手順を順を追って説明し、カスタム ドメインを接続します。

ホスティング用にドメインを設定する

Firebase プロジェクトに Firebase Hosting サイトがあるように、プロジェクトのFirebase Hosting ページから「Get Started」ウィザードを完了していることを確認してください。

ステップ 1 : ドメインを追加する

  1. プロジェクトの [ホスティング] ページから、カスタム ドメインを接続するためのウィザードに入ります。

    • ホスティング サイトが 1 つしかない場合は、[カスタム ドメインを追加] をクリックします。
    • 複数のホスティング サイトがある場合は、目的のサイトの [表示]をクリックし、[カスタム ドメインの追加] をクリックします。
  2. ホスティング サイトに接続するカスタム ドメイン名を入力します。

  3. (オプション)ボックスをオンにして、カスタム ドメインのすべてのリクエストを 2 番目に指定されたドメインにリダイレクトします ( example.comwww.example.comが同じコンテンツにリダイレクトされるように)。

  4. [続行]をクリックして、検証プロセスを開始します。

ステップ 2 : ドメインの所有権を確認する

Connect Domainセットアップ ウィザードで要求された場合は、apex ドメインを確認します。

これらの手順により、ドメインがまだ Firebase プロジェクトにリンクされておらず、指定されたドメインを所有していることを確認できます。

  1. ドメイン プロバイダーのサイトで、DNS 管理ページを見つけます。

  2. 次の入力を使用して、新しいレコードを追加して保存します。

    • タイプ: TXT レコードを追加します。

      Firebase Hosting では、ドメインの所有権を証明し、Firebase がサイトの SSL 証明書を割り当てて更新することを承認するために、この TXT レコードを DNS 設定に継続的に表示する必要があります。

      ドメイン プロバイダーは、この用語を「レコード タイプ」としてリストしている場合があります。

    • ホスト: apex ドメイン キーを入力します。

      頂点ドメインまたはルート ドメインの所有権を証明すると、そのすべてのサブドメインの所有権が証明されます。

      ドメイン プロバイダーは、この用語を「ホスト名」、「名前」、または「ドメイン」としてリストしている場合があります。

    • : 一意の検証値をフィールドにコピーします。

      Firebase Hosting はこの値をチェックして、ドメインの所有権を証明します。

      ドメイン プロバイダは、この用語を「データ」と記載している場合があります。

  3. 更新された TXT レコードが反映されるまで最大 24 時間待ち、[確認] をクリックします。

    [キャンセル] をクリックして、[ドメインの接続] ウィンドウを安全に閉じ、後で再度開くことができることに注意してください。これは伝播時間には影響しませんが、ウィンドウを再度開いたときにドメイン名を再入力するよう求められます。

    十分な伝播時間が経過したら、Firebase コンソールの [ Connect Domain ] ウィンドウで [ Verify ] をクリックすると、SSL 証明書のプロビジョニング プロセスを開始できます。

    ドメイン プロバイダーにもよりますが、ほとんどの場合、レコードの伝播とドメインの検証は数時間以内に行われます。 TXT レコードと伝播時間を追加するための詳細な手順については、ドメイン プロバイダーのドキュメントを参照してください。

    [検証] をクリックするとエラー メッセージが表示される場合は、レコードが反映されていないか、値が正しくない可能性があります。

ステップ 3 : ライブに移行する

Firebase コンソールの [ドメインの接続]ウィンドウで、新しいサイトの [クイック セットアップ] を選択するか、別のホスティング プロバイダーでサイトを既に実行しており、ゼロ ダウンタイムの移行が必要な場合は[高度なセットアップ] を選択します。

SSL 証明書のプロビジョニングを待ちます

ドメインの所有権を確認した後、お客様のドメインの SSL 証明書をプロビジョニングし、DNS A レコードを Firebase Hosting にポイントしてから 24 時間以内にグローバル CDN にデプロイします。

ドメインは、FirebaseApp SSL 証明書のサブジェクト代替名 (SAN) の 1 つとしてリストされます。この証明書は、ブラウザのセキュリティ ツールを使用して表示できます。ドメインのプロビジョニング中に、ドメイン名を含まない無効な証明書が表示される場合があります。これはプロセスの通常の部分であり、ドメインの証明書が利用可能になった後に解決されます。

Advanced Setupユーザーの場合、プロジェクトのFirebase Hosting ページセットアップ ステータスConnectedに更新されるまで、ウェブサイトは以前のホスティング プロバイダによってホストされます。

カスタム ドメイン キー

DNS レコードを追加または編集するとき、さまざまなドメイン プロバイダーは、DNS 管理サイト内のホストフィールドにさまざまな入力を入力することを期待しています。以下に、一般的なプロバイダーからの一般的な入力をまとめました。詳細な手順については、ドメイン プロバイダーのドキュメントを参照してください。

ドメインの種類カスタム ドメイン キー
頂点ドメイン

一般的な入力は次のとおりです。

  • @
  • apex ドメイン名 ( example .com )
  • ホストフィールドを空白のままにする
サブドメイン

一般的な入力は次のとおりです。

  • 完全なサブドメイン名 (例: app. example .com )
  • サブドメイン部分のみ (たとえば、 appのみ、 . example .comを除外)
  • wwwのサブドメインはwww. example .com

一般的なドメイン プロバイダー

一般的なドメイン プロバイダーと、それぞれに必要な入力の種類を次に示します。この情報は可能な限り最新の状態に保たれますが、詳細な手順についてはドメイン プロバイダーのドキュメントを参照してください。

カスタム ドメインのセットアップ ステータスの説明

状態説明
セットアップが必要

DNS レコードの構成を変更する必要がある場合があります。

  • ほとんどの場合、DNS A レコードはドメイン名プロバイダーから Firebase Hosting サーバーに伝播されていません。
    トラブルシューティングのヒント: 24 時間以上経過している場合は、レコードが Firebase Hosting を参照していることを確認してください。

  • まれに、特に Advanced Setup フローを使用している場合、次の理由で SSL チャレンジが失敗することがあります。

    • DNS レコードには、他のホスティング プロバイダーを指す A レコードまたは CNAME レコードがあります。
      トラブルシューティングのヒント: A レコードが Firebase Hosting のみを指していることを確認し、すべての CNAME レコードを削除します。
    • 移行に失敗し、トークン (サイトに提供された DNS TXT レコードまたはアップロードされたファイル) が無効になりました。
      トラブルシューティングのヒント: ドメインの [表示]をクリックし、新しいトークンを既存のドメインに提供します。
保留中

カスタム ドメインを正しく設定しましたが、Firebase Hosting は SSL 証明書をプロビジョニングしていません。

場合によっては、次の問題により、カスタム ドメインの SSL 証明書の作成が停止することがあります。

  • CAA レコードの制限が厳しすぎます。
    トラブルシューティングのヒント: 認証局 `letsencrypt.org` と `pki.goog` がドメインの SSL 証明書の作成を許可されていることを確認してください。
  • チャレンジ コードが無効です。
    高度なセットアップ フローを使用していて、移行が失敗した場合、トークン (およびそのチャレンジ コード) は無効になります。
    トラブルシューティングのヒント: ドメインの [表示]をクリックし、新しいトークンを既存のドメインに提供します。
  • リクエストしたサブドメインが多すぎます。
    トラブルシューティングのヒント: 通常、Firebase Hosting では、SSL 証明書の作成制限により、1 つの apex カスタム ドメインで 20 以下のサブドメインを推奨しています。
接続済み

カスタム ドメインには適切な DNS レコードがあり、SSL 証明書があります。
サイトのコンテンツを提供できます。

再確認が必要

次のいずれかの状況が発生した場合、Firebase では、ドメインの所有権を手動で再確認する必要がある場合があります。

  • ドメインの所有権を最初に確認したときに追加された TXT レコードが変更されたか、ドメインの DNS 設定から削除されました。
    • 1 つのドメインで、google-site-verification トークンを含む複数の TXT レコードが許可されていることに注意してください。
    • DNS 設定に TXT レコードが継続的に存在する必要があります。これにより、お客様がドメインを所有していることを証明し、お客様のサイトに SSL 証明書を割り当てて更新する権限を当社に与えることができます。
  • ドメインの所有権を確認した人には、ドメインの所有権を確認するために必要なアクセス許可を含むIAM ロールが割り当てられなくなりました。これらの役割には、所有者、編集者、Firebase 管理者、Firebase 開発管理者が含まれます。
トラブルシューティングのヒント: カスタム ドメインが Firebase Hosting から自動的に切断されないように、プロジェクトのHosting ページにアクセスして、指定された時間枠 (通常は 30 日) 内に再検証プロセスを完了してください。