Associer un domaine personnalisé

Vous n'avez pas besoin d'abandonner 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é (comme example.com ou app.example.com) au lieu d'un domaine généré par Firebase pour votre site hébergé par 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 pour votre application.

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

Avant de commencer : types d'enregistrements DNS

L'assistant Configurer le domaine App Hosting peut vous demander d'ajouter ou de supprimer entre un et cinq 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 que 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 d'enregistrements AAAA, mais vous demandera de supprimer ceux qui existent déjà dans votre 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 des enregistrements CNAME pour deux raisons : Intégration facile : lorsque cela est possible, App Hosting vous demande d'utiliser un enregistrement CNAME vers un domaine préconfiguré qui commence par _custom-domain.... Validation des certificats 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 au gestionnaire de certificats 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é à utiliser sur votre domaine.	Non
CAA	Ces enregistrements fonctionnent comme une liste d'autorisation permettant de spécifier les autorités de certification autorisées à émettre des certificats SSL pour votre domaine. App Hosting ne demande des enregistrements CAA que s'il est bloqué pour l'émission de certificats pour votre domaine.	Non

Avant de commencer : votre nom de domaine personnalisé

Lorsque vous ajoutez ou modifiez des enregistrements DNS, les différents fournisseurs de domaine s'attendent à ce que vous saisissiez des entrées différentes 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.

Vous trouverez ci-dessous les entrées courantes des fournisseurs les plus populaires. Pour obtenir des instructions détaillées, consultez la documentation de votre fournisseur de domaine.

Type de domaine	Nom du domaine personnalisé
Domaine racine	Voici quelques exemples d'entrées courantes : @ Nom de domaine racine (par exemple, example.com) Laissez le champ Hôte vide.
Sous-domaine	Voici quelques exemples d'entrées courantes : Nom complet du sous-domaine (par exemple, app.example.com) Seule la partie sous-domaine (par exemple, app uniquement, sans .example.com)

Fournisseurs de domaines courants

Voici quelques fournisseurs de domaine courants et les types d'entrées qu'ils peuvent exiger. Nous mettons ces informations à 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 console Firebase. Ce flux vous guide à travers 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 : Ajoutez un domaine personnalisé

1. Ouvrez la page App Hosting de votre projet.
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 site App Hosting.
5. (Facultatif) Cochez la case pour rediriger toutes les requêtes sur le domaine personnalisé vers un deuxième domaine spécifié (de sorte que example.com et www.example.com redirigent 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éparez le domaine

1. Sélectionnez l'onglet Migrer un domaine de l'assistant Configurer un 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 les enregistrements de votre domaine chez votre fournisseur de DNS en utilisant les entrées suivantes pour les enregistrements requis :
   • Nom : saisissez le nom de domaine personnalisé pour les enregistrements. L'hôte que vous indiquez est le domaine sur lequel vous souhaitez diffuser du contenu. Il peut s'agir d'un domaine racine ou d'un sous-domaine. Il est possible que votre fournisseur de domaine utilise les termes "Nom d'hôte", "Nom" ou "Domaine".
   • Type d'enregistrement : ajoutez l'enregistrement DNS fourni.
   • Valeur : attribuez la valeur fournie à vos enregistrements. Il est possible que votre fournisseur de domaine utilise les termes "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 Valider 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 backend.

Étape 3 : Redirigez vers App Hosting

1. Une fois que App Hosting a vérifié les modifications apportées à l'enregistrement à l'étape précédente, l'assistant passe à la dernière étape Diriger vers App Hosting. Cette étape affiche les modifications que vous devez apporter aux enregistrements pour rediriger le trafic de votre domaine vers les serveurs App Hosting. Comme précédemment, ajoutez, supprimez et enregistrez les enregistrements de votre domaine chez votre fournisseur de DNS en utilisant les entrées suivantes pour les enregistrements requis :
   • Nom : saisissez le nom de domaine personnalisé pour les enregistrements. L'hôte que vous indiquez est le domaine sur lequel vous souhaitez diffuser du contenu. Il peut s'agir d'un domaine racine ou d'un sous-domaine. Il est possible que votre fournisseur de domaine utilise les termes "Nom d'hôte", "Nom" ou "Domaine".
   • Type d'enregistrement : ajoutez l'enregistrement DNS fourni.
   • Valeur : attribuez la valeur fournie à vos enregistrements. Il est possible que votre fournisseur de domaine utilise les termes "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 Valider 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 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 nouveau domaine à votre application Web, suivez les instructions de cette section.

Étape 1 : Ajoutez un domaine personnalisé

1. Ouvrez la page App Hosting de votre projet.
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 site App Hosting.
5. (Facultatif) Cochez la case pour rediriger toutes les requêtes sur le domaine personnalisé vers un deuxième domaine spécifié (de sorte que example.com et www.example.com redirigent 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érifiez les enregistrements DNS

1. L'assistant Configurer un domaine de la console Firebase affiche les enregistrements à mettre à jour pour rediriger votre page vers Firebase App Hosting. Ajoutez, supprimez et enregistrez les enregistrements de votre domaine chez votre fournisseur DNS en utilisant les entrées suivantes :
   • Nom : saisissez le nom de domaine personnalisé pour les enregistrements. L'hôte que vous indiquez est le domaine sur lequel vous souhaitez diffuser du contenu. Il peut s'agir d'un domaine racine ou d'un sous-domaine. Il est possible que votre fournisseur de domaine utilise les termes "Nom d'hôte", "Nom" ou "Domaine".
   • Type d'enregistrement : ajoutez l'enregistrement DNS fourni.
   • Valeur : attribuez la valeur fournie à vos enregistrements. Il est possible que votre fournisseur de domaine utilise les termes "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 Valider 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 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 redirigé 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. Il s'agit d'une étape normale du processus, qui sera résolue une fois le certificat de votre domaine disponible.

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

Descriptions des états pour les domaines personnalisés

État	Description
À configurer	Vous devrez peut-être modifier une configuration avec vos enregistrements DNS. Dans la plupart des cas, vos enregistrements DNS A ne se sont pas propagés de votre fournisseur de nom de domaine aux serveurs Firebase App Hosting. Conseil de dépannage : Si plus de 24 heures se sont écoulées, vérifiez que vous avez redirigé 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 pointent uniquement 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. Il arrive que des enregistrements CAA trop restrictifs empêchent la création 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.
Certificat de génération	Un certificat SSL est en cours de création 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.