Firebase App Hosting にデプロイされたアプリに、ブランドを象徴する独自のドメイン名を使用する必要はありません。Firebase でホストされるサイトには、Firebase で生成されるドメインの代わりに、example.com や app.example.com といったカスタム ドメインを使用できます。Firebase App Hosting は、各ドメインの SSL 証明書をプロビジョニングします。
カスタム ドメインを接続する方法を、以下で紹介します。
App Hosting 用にドメインを設定する
基本的な App Hosting のセットアップタスクが完了し、Firebase プロジェクト内に Firebase App Hosting サイトがあることを確認します。
ステップ 1: カスタム ドメインを追加する
- プロジェクトの App Hosting ページを開きます。
- [ダッシュボードを表示] オプションを使用して、App Hosting バックエンドを選択します。
- [設定] タブを選択し、[カスタム ドメインを追加] をクリックします。
- App Hosting サイトに接続するカスタム ドメイン名を入力します。
- （省略可）カスタム ドメインのすべてのリクエストを 2 番目に指定されたドメインにリダイレクトするチェックボックスをオンにします（
example.comとwww.example.comを同じコンテンツにリダイレクトします）。 - [続行] をクリックして DNS レコードを構成し、カスタム ドメインの設定を完了します。
ステップ 2: カスタム ドメインを設定する
Firebase コンソールの [カスタム ドメインを追加] ウィザードに、ページが Firebase App Hosting を指すように更新する必要があるレコードが表示されます。次の入力を使用して、DNS プロバイダのドメインのレコードを追加、削除、保存します。
- タイプ: 指定した DNS レコードを追加します。
ホスト: レコードのカスタム ドメインキーを入力します。ホストには、コンテンツを提供するドメイン（Apex ドメインまたはサブドメイン）を指定します。ドメイン プロバイダによっては、「ホスト名」、「名前」、「ドメイン」といった用語を使用している場合があります。
値: 指定された値をレコードに割り当てます。ドメイン プロバイダによっては、「データ」、「ポイント」、「コンテンツ」、「アドレス」、「IP アドレス」といった用語を使用している場合があります。value フィールドの内容はレコードタイプによって異なります。A レコードと AAAA レコードでは値として IP アドレスが使用されますが、TXT レコードでは文字列が使用されます。
SSL 証明書のプロビジョニングが完了するまで待ちます。通常、この処理は数時間で完了しますが、DNS が Firebase App Hosting を指定してから最長で 24 時間ほどかかることもあります。ほとんどの場合、レコードの伝播と SSL 証明書のプロビジョニングは 1 時間以内に行われます（ドメイン プロバイダによって異なります）。
SSL 証明書のプロビジョニングを待機する
App Hosting DNS レコードを更新した後、ドメインの SSL 証明書がプロビジョニングされるまでに最大で数時間かかることがあります。DNS が Firebase App Hosting を指定するよう設定してから、最大で 24 時間かかる場合があります。
この証明書は、ブラウザのセキュリティ ツールを使用して表示できます。ドメインのプロビジョニング中は、無効な証明書が表示されたり、ドメインへの接続に問題が発生したりすることがあります。これは、通常プロセスの一部であり、ドメインの証明書が入手可能になると解決します。
注: Firebase App Hosting は、必要に応じてカスタム ドメインの SSL 証明書を自動的に再プロビジョニングします。
DNS レコードタイプ
App Hosting カスタム ドメイン ウィザードでは、ドメインの現在の構成に応じて 1 ～ 5 個の DNS レコードを追加するように求められる場合があります。レコードのタイプによって機能が決定されます。App Hosting が要求する可能性があるレコードの種類は次のとおりです。
| タイプ | 説明 | 限定 |
|---|---|---|
| A | これらのレコードには IPv4 値（8.8.8.8 など）が含まれており、ドメインへの接続時に使用するアドレスをブラウザに指示します。 | ○ |
| AAAA | これらのレコードには IPv6 値（2001:4860:4860::8888 など）が含まれます。これは、A レコードとほぼ同じ機能を備えた別のタイプのアドレスレコードです。App Hosting は現在 AAAA レコードを使用していませんが、ドメインに既存の AAAA レコードがある場合は、削除するよう求められます。 | ○ |
| CNAME | これらのレコードには、DNS クエリを解決するために現在のドメインの代わりに使用される別のドメイン名が含まれています。CNAME レコードは、サブドメイン（www.example.com など）でのみ使用できます。App Hosting は、次の 2 つの理由で CNAME レコードを使用します。
|
○ |
| TXT | これらのレコードを使用すると、任意のメタデータをドメインに関連付けることができます。App Hosting を使用すると、特定の形式の TXT レコード（fah-claim=[UUID]）を使用して、ドメインで提供するカスタム ドメインを指定できます。 |
いいえ |
| CAA | これらのレコードは、ドメインの SSL 証明書を作成できる認証局を指定する許可リストとして機能します。App Hosting がドメインの証明書の作成をブロックしている場合にのみ、CAA レコードをリクエストします。 | いいえ |
カスタム ドメインキー
DNS レコードを追加または編集する際、DNS 管理サイト内の [ホスト] フィールドに入力する値はドメイン プロバイダによって異なります。以下に、よく利用されるプロバイダの一般的な入力情報をまとめました。詳細な手順については、ドメイン プロバイダのドキュメントをご覧ください。
| ドメイン タイプ | カスタム ドメインキー |
|---|---|
| Apex ドメイン |
一般的な入力情報:
|
| サブドメイン | 一般的な入力情報:
|
一般的なドメイン プロバイダ
一般的なドメイン プロバイダと、それぞれに必要な入力の種類は次のとおりです。この情報は可能な限り最新の状態に保たれますが、詳しい手順についてはドメイン プロバイダのドキュメントをご覧ください。
カスタム ドメインのステータスの説明
| ステータス | 説明 |
|---|---|
| 設定が必要です |
DNS レコードを使った構成の変更が必要な場合があります。
|
| 保留中 | カスタム ドメインは正しく設定されていますが、Firebase App Hosting は SSL 証明書をプロビジョニングしていません。 過度に制限された CAA レコードによって、カスタム ドメインの SSL 証明書の作成が停止することがあります。認証局「letsencrypt.org」と「pki.goog」がドメインの SSL 証明書の作成が許可されていることを確認します。 |
| 証明書を作成中 | ドメインの SSL 証明書を作成しています。 |
| 接続済み | カスタム ドメインには適切な DNS レコードがあり、SSL 証明書があります。 |