Associer un domaine personnalisé

Vous n'avez pas à renoncer à vos noms de domaine uniques et axés sur votre marque pour les applications déployées sur Firebase App Hosting. Vous pouvez utiliser un domaine personnalisé (tel que example.com ou app.example.com) au lieu d'un domaine généré par Firebase pour votre site hébergé sur Firebase. Firebase App Hosting provisionne un certificat SSL pour chacun de vos domaines.

Le reste de ce document vous explique comment associer un domaine personnalisé de l'une des manières suivantes :

• Migrer un domaine
• Associer un nouveau domaine

Pour éviter toute interruption du service, vos enregistrements DNS doivent être mis à jour dans un ordre précis. Suivez les instructions pour migrer un domaine afin d'éviter les temps d'arrêt de votre application.

Si les temps d'arrêt ne sont pas un problème pour vous, par exemple lorsque vous associez un domaine qui est nouveau pour votre application Web, suivez les instructions pour associer un nouveau domaine.

Avant de commencer : types d'enregistrements DNS

L'assistant App Hosting Configurer le domaine d'App Hosting peut vous demander d'ajouter ou de supprimer entre 1 et 5 enregistrements DNS, en fonction de la configuration actuelle de votre domaine. Le type d'un enregistrement détermine sa fonction. Voici les types d'enregistrements App Hosting peut demander :

Type	Description	Exclusif
A	Ces enregistrements contiennent des valeurs IPv4 (par exemple, 8.8.8.8), qui indiquent aux navigateurs l'adresse à utiliser lorsqu'ils tentent de contacter votre domaine.	Oui
AAAA	Ces enregistrements contiennent des valeurs IPv6 (par exemple, 2001:4860:4860::8888), un autre type d'enregistrement d'adresse ayant à peu près la même fonction que les enregistrements A. App Hosting n'utilise pas actuellement les enregistrements AAAA, mais vous demandera de supprimer tous ceux qui existent dans notre domaine, le cas échéant.	Oui
CNAME	Ces enregistrements contiennent un nom de domaine distinct qui doit être utilisé à la place de votre domaine actuel pour résoudre les requêtes DNS. Les enregistrements CNAME ne sont autorisés que sur les sous-domaines (par exemple, www.example.com). App Hosting utilise les enregistrements CNAME pour deux raisons : Intégration facile : lorsque cela est possible, App Hosting vous demande d'utiliser un CNAME pour un domaine préconfiguré commençant par _custom-domain.... Validation du certificat SSL : App Hosting utilise Cloud Certificate Manager pour provisionner des certificats SSL pour votre domaine personnalisé. Un enregistrement CNAME sur un sous-domaine _acme-challenge... permet à Certificate Manager de créer et de renouveler des certificats pour vous. Après l'intégration, cet enregistrement ne doit pas être supprimé , sinon votre couverture de certificat expirera.	Oui
TXT	Ces enregistrements vous permettent d'associer des métadonnées arbitraires à votre domaine. App Hosting vous permet d'utiliser un format spécifique d'enregistrement TXT, fah-claim=[UUID], pour indiquer le domaine personnalisé qu'il doit diffuser sur votre domaine.	Non
CAA	Ces enregistrements fonctionnent comme une liste d'autorisation pour spécifier les autorités de certification autorisées à générer des certificats SSL pour votre domaine. App Hosting ne demande des enregistrements CAA que s'il est bloqué pour générer des certificats pour votre domaine.	Non

Avant de commencer : votre nom de domaine personnalisé

Lorsque vous ajoutez ou modifiez des enregistrements DNS, différents fournisseurs de domaine s'attendent à ce que vous saisissiez différentes entrées pour le champ Hôte (ou nom d'hôte) sur leurs sites de gestion DNS. L'assistant de domaine personnalisé App Hosting vous demande de saisir cette même valeur dans le champ Nom.

Nous avons compilé les entrées courantes des fournisseurs populaires ci-dessous. Consultez la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.

Type de domaine	Nom du domaine personnalisé
Domaine racine	Les entrées courantes incluent : @ Le nom de domaine racine (par exemple, example.com) Laisser le champ Hôte vide
Sous-domaine	Les entrées courantes incluent : Le nom complet du sous-domaine (par exemple, app.example.com) Seule la partie du sous-domaine (par exemple, app uniquement, sans .example.com)

Fournisseurs de domaine courants

Voici quelques fournisseurs de domaine courants et les types d'entrées que chacun peut exiger. Ces informations sont mises à jour autant que possible, mais consultez la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.

Cloudflare

Organisateur	Entrée
example.com.	@
www.example.com.	www

Google Cloud DNS

Organisateur	Entrée
example.com.	.example.com.
www.example.com.	www.example.com.

NameCheap

Organisateur	Entrée
example.com.	@
www.example.com.	www

Squarespace

Organisateur	Entrée
example.com.	@
www.example.com.	www

Migrer un domaine

Si vous souhaitez transférer votre domaine d'un autre fournisseur vers App Hosting sans temps d'arrêt, vous pouvez utiliser le flux Migrer un domaine dans la Firebase console. Ce flux vous guide tout au long d'un processus en deux étapes qui prépare App Hosting à diffuser du contenu sur votre domaine avant de rediriger le trafic vers les serveurs App Hosting.

Étape 1 : Ajouter un domaine personnalisé

1. Dans la console Firebase, accédez à Hébergement et sans serveur > App Hosting.
2. Sélectionnez un backend App Hosting à l'aide de l'option Afficher le tableau de bord.
3. Sélectionnez l'onglet Paramètres, puis cliquez sur Ajouter un domaine personnalisé.
4. Saisissez le nom de domaine personnalisé que vous souhaitez associer à votre App Hosting site.
5. (Facultatif) Cochez la case pour rediriger toutes les requêtes du domaine personnalisé vers un deuxième domaine spécifié (de sorte que example.com et www.example.com soient redirigés vers le même contenu).
6. Cliquez sur Continuer la configuration pour configurer vos enregistrements DNS et terminer la configuration de votre domaine personnalisé.

Étape 2 : Préparer le domaine

1. Sélectionnez l'onglet Migrer un domaine de l'assistant Configurer le domaine.
2. Suivez les instructions de la première étape, Préparer le domaine, qui inclut l'ensemble des modifications nécessaires pour que App Hosting diffuse votre backend préféré et établisse des connexions TLS sécurisées pour votre domaine. Ajoutez, supprimez et enregistrez des enregistrements de votre domaine auprès de votre fournisseur DNS avec les entrées suivantes pour les enregistrements requis :
   • Nom : saisissez le nom de votre domaine personnalisé pour les enregistrements. L'hôte que vous indiquez est le domaine sur lequel vous souhaitez diffuser du contenu. Ce domaine peut être un domaine racine ou un sous-domaine. Votre fournisseur de domaine peut répertorier ce terme sous le nom "Nom d'hôte", "Nom" ou "Domaine".
   • Type d'enregistrement : ajoutez l'enregistrement DNS fourni.
   • Valeur : attribuez la valeur fournie à vos enregistrements. Votre fournisseur de domaine peut répertorier ce terme sous le nom "Données", "Pointe vers", "Contenu", "Adresse" ou "Adresse IP". Le contenu du champ de valeur varie selon le type d'enregistrement. Par exemple, les enregistrements TXT sont des chaînes.
3. Sélectionnez Vérifier les enregistrements. App Hosting tentera de détecter les modifications que vous avez apportées à votre fournisseur de domaine. La prise en compte des modifications peut prendre jusqu'à 24 heures. Vous pouvez vérifier l'état dans la vue Paramètres > Domaines du tableau de bord du backend.

Étape 3 : Diriger vers App Hosting

1. Une fois que App Hosting a vérifié les mises à jour des enregistrements de l'étape précédente, l'assistant passe à l'étape finale Diriger vers App Hosting étape. Cette étape affiche les mises à jour d'enregistrement que vous devez effectuer pour diriger le trafic de votre domaine's vers les serveurs App Hosting. Comme précédemment, ajoutez, supprimez et enregistrez des enregistrements de votre domaine auprès de votre fournisseur DNS avec les entrées suivantes pour les enregistrements requis :
   • Nom : saisissez le nom de votre domaine personnalisé pour les enregistrements. L'hôte que vous indiquez est le domaine sur lequel vous souhaitez diffuser du contenu. Ce domaine peut être un domaine racine ou un sous-domaine. Votre fournisseur de domaine peut répertorier ce terme sous le nom "Nom d'hôte", "Nom" ou "Domaine".
   • Type d'enregistrement : ajoutez l'enregistrement DNS fourni.
   • Valeur : attribuez la valeur fournie à vos enregistrements. Votre fournisseur de domaine peut répertorier ce terme sous le nom "Données", "Pointe vers", "Contenu", "Adresse" ou "Adresse IP". Le contenu du champ de valeur varie selon le type d'enregistrement. Par exemple, les enregistrements TXT sont des chaînes.
2. Sélectionnez Vérifier les enregistrements. App Hosting tentera de détecter les modifications que vous avez apportées à votre fournisseur de domaine. La prise en compte des modifications peut prendre jusqu'à 24 heures. Vous pouvez vérifier l'état dans la vue Paramètres > Domaines du tableau de bord du backend.

Associer un nouveau domaine

Si les temps d'arrêt ne sont pas un problème pour vous, par exemple lorsque vous associez un domaine qui est nouveau pour votre application Web, suivez les instructions de cette section.

Étape 1 : Ajouter un domaine personnalisé

1. Dans la console Firebase, accédez à Hébergement et sans serveur > App Hosting.
2. Sélectionnez un backend App Hosting à l'aide de l'option Afficher le tableau de bord.
3. Sélectionnez l'onglet Paramètres, puis cliquez sur Ajouter un domaine personnalisé.
4. Saisissez le nom de domaine personnalisé que vous souhaitez associer à votre App Hosting site.
5. (Facultatif) Cochez la case pour rediriger toutes les requêtes du domaine personnalisé vers un deuxième domaine spécifié (de sorte que example.com et www.example.com soient redirigés vers le même contenu).
6. Cliquez sur Continuer la configuration pour configurer vos enregistrements DNS et terminer la configuration de votre domaine personnalisé.

Étape 2 : Vérifier les enregistrements DNS

1. L'assistant Configurer le domaine de la console Firebase affiche les enregistrements nécessaires qui doivent être mis à jour pour pointer votre page vers Firebase App Hosting. Ajoutez, supprimez et enregistrez des enregistrements de votre domaine auprès de votre fournisseur DNS avec les entrées suivantes :
   • Nom : saisissez le nom de votre domaine personnalisé pour les enregistrements. L'hôte que vous indiquez est le domaine sur lequel vous souhaitez diffuser du contenu. Ce domaine peut être un domaine racine ou un sous-domaine. Votre fournisseur de domaine peut répertorier ce terme sous le nom "Nom d'hôte", "Nom" ou "Domaine".
   • Type d'enregistrement : ajoutez l'enregistrement DNS fourni.
   • Valeur : attribuez la valeur fournie à vos enregistrements. Votre fournisseur de domaine peut répertorier ce terme sous le nom "Données", "Pointe vers", "Contenu", "Adresse" ou "Adresse IP". Le contenu du champ de valeur varie selon le type d'enregistrement. Par exemple, les enregistrements TXT sont des chaînes.
2. Sélectionnez Vérifier les enregistrements. App Hosting tentera de détecter les modifications que vous avez apportées à votre fournisseur de domaine. La prise en compte des modifications peut prendre jusqu'à 24 heures. Vous pouvez vérifier l'état dans la vue Paramètres > Domaines du tableau de bord du backend.

Attendre le provisionnement du certificat SSL

App Hosting peut prendre jusqu'à quelques heures pour provisionner un certificat SSL pour votre domaine après la mise à jour de vos enregistrements DNS. Dans certains cas, cela peut prendre jusqu'à 24 heures après que vous avez pointé votre DNS vers Firebase App Hosting.

Vous pouvez afficher ce certificat à l'aide des outils de sécurité du navigateur. Pendant le provisionnement du domaine, il est possible qu'un certificat non valide s'affiche ou que vous rencontriez des problèmes de connexion à votre domaine. Cela fait partie du processus normal et sera résolu une fois le certificat de votre domaine disponible.

Remarque : Firebase App Hosting reprovisionne automatiquement les certificats SSL, si nécessaire, pour les domaines personnalisés.

Descriptions d'état pour les domaines personnalisés

État	Description
Configuration requise	Vous devrez peut-être modifier une configuration avec vos enregistrements DNS. Dans la plupart des cas, vos enregistrements A DNS ne se sont pas propagés de votre fournisseur de nom de domaine vers les serveurs Firebase App Hosting. Conseil de dépannage : si plus de 24 heures se sont écoulées, vérifiez que vous avez pointé vos enregistrements vers Firebase App Hosting. Dans de rares cas, les défis SSL peuvent échouer, car vos enregistrements DNS comportent des enregistrements A ou CNAME qui pointent vers d'autres fournisseurs d'hébergement. Conseil de dépannage : vérifiez que vos enregistrements A ne pointent que vers Firebase App Hosting, et supprimez tous les enregistrements CNAME.
En attente	Vous avez correctement configuré votre domaine personnalisé, mais Firebase App Hosting n'a pas provisionné de certificat SSL. Parfois, des enregistrements CAA trop restrictifs peuvent bloquer la génération d'un certificat SSL pour un domaine personnalisé. Assurez-vous que les autorités de certification `letsencrypt.org` et `pki.goog` sont autorisées à créer des certificats SSL pour votre domaine.
Génération du certificat	Un certificat SSL est en cours de génération pour votre domaine.
Connecté	Votre domaine personnalisé possède les enregistrements DNS appropriés et un certificat SSL. Vous pouvez diffuser le contenu de votre site.