Vous n'avez pas à renoncer à vos noms de domaine uniques et axés sur la 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 guide à travers les étapes permettant de connecter un domaine personnalisé de l'une des manières suivantes :
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 que votre application ne subisse des temps d'arrêt.
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 Configurer le domaine de App Hosting peut vous demander d'ajouter ou de supprimer un à 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 type d'enregistrement d'adresse différent qui remplit à peu près la même fonction que les enregistrements A. App Hosting n'utilise pas d'enregistrements AAAA pour le moment, 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 :
|
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 quel domaine personnalisé doit être diffusé 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 la création de 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 dans 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 populaires. Pour obtenir des instructions détaillées, consultez la documentation de votre fournisseur de domaine.
| Type de domaine | Nom du domaine personnalisé |
|---|---|
| Domaine Apex |
Voici quelques entrées courantes :
|
| Sous-domaine | Voici quelques entrées courantes :
|
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 aussi souvent que possible, mais consultez la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.
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 diriger le trafic vers les serveurs App Hosting.
Étape 1 : Ajoutez un domaine personnalisé
- Dans la console Firebase, accédez à Hébergement et sans serveur > App Hosting.
- Sélectionnez un backend App Hosting à l'aide de l'option Afficher le tableau de bord.
- Sélectionnez l'onglet Paramètres, puis cliquez sur Ajouter un domaine personnalisé.
- Saisissez le nom de domaine personnalisé que vous souhaitez associer à votre site App Hosting.
- (Facultatif) Cochez la case pour rediriger toutes les requêtes du domaine personnalisé vers un deuxième domaine spécifié (de sorte que
example.cometwww.example.comredirigent vers le même contenu). - Cliquez sur Continuer la configuration pour configurer vos enregistrements DNS et terminer la configuration de votre domaine personnalisé.
Étape 2 : Préparez le domaine
- Sélectionnez l'onglet Migrer un domaine de l'assistant Configurer un domaine.
- 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 dans votre fournisseur DNS avec 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. Ce domaine peut être un domaine apex ou un sous-domaine. Votre fournisseur de domaine peut lister ce terme sous "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 utiliser 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.
- Sélectionnez Valider les enregistrements. App Hosting tentera de détecter les modifications que vous avez apportées chez 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 : Dirigez l'utilisateur vers App Hosting
- 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. Cette étape affiche les mises à jour d'enregistrements que vous devez effectuer pour diriger le trafic de votre domaine vers les serveurs App Hosting. Comme précédemment, ajoutez, supprimez et enregistrez les enregistrements de votre domaine dans votre fournisseur DNS avec 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. Ce domaine peut être un domaine apex ou un sous-domaine. Votre fournisseur de domaine peut lister ce terme sous "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 utiliser 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.
- Sélectionnez Valider les enregistrements. App Hosting tentera de détecter les modifications que vous avez apportées chez 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 : Ajoutez un domaine personnalisé
- Dans la console Firebase, accédez à Hébergement et sans serveur > App Hosting.
- Sélectionnez un backend App Hosting à l'aide de l'option Afficher le tableau de bord.
- Sélectionnez l'onglet Paramètres, puis cliquez sur Ajouter un domaine personnalisé.
- Saisissez le nom de domaine personnalisé que vous souhaitez associer à votre site App Hosting.
- (Facultatif) Cochez la case pour rediriger toutes les requêtes du domaine personnalisé vers un deuxième domaine spécifié (de sorte que
example.cometwww.example.comredirigent vers le même contenu). - Cliquez sur Continuer la configuration pour configurer vos enregistrements DNS et terminer la configuration de votre domaine personnalisé.
Étape 2 : Validez les enregistrements DNS
- L'assistant Configurer le domaine de la console Firebase affiche les enregistrements nécessaires à mettre à jour pour que votre page pointe vers Firebase App Hosting. Ajoutez, supprimez et enregistrez des enregistrements de votre domaine dans votre fournisseur DNS avec 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. Ce domaine peut être un domaine apex ou un sous-domaine. Votre fournisseur de domaine peut lister ce terme sous "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 utiliser 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.
- Sélectionnez Valider les enregistrements. App Hosting tentera de détecter les modifications que vous avez apportées chez 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 avoir fait pointer 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, un certificat non valide peut s'afficher ou vous pouvez rencontrer des problèmes de connexion à votre domaine. Il s'agit d'une étape normale du processus, qui sera résolue une fois que le certificat de votre domaine sera disponible.
Remarque : Firebase App Hosting reprovisionne automatiquement les certificats SSL, si nécessaire, pour les domaines personnalisés.
Descriptions d'état des domaines personnalisés
| État | Description |
|---|---|
| Configuration requise |
Vous devrez peut-être modifier une configuration dans vos enregistrements DNS.
|
| 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 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. |
| Génération du certificat | Un certificat SSL est en cours de création pour votre domaine. |
| Connecté | Votre domaine personnalisé dispose des enregistrements DNS appropriés et d'un certificat SSL. |