Vous n'avez pas besoin d'abandonner vos noms de domaine uniques axés sur la marque pour les applications déployées sur Firebase App Hosting. Pour votre site hébergé par Firebase, vous pouvez utiliser un domaine personnalisé (tel que example.com ou app.example.com) au lieu d'un domaine généré par Firebase. Firebase App Hosting provisionne un certificat SSL pour chacun de vos domaines.
Le reste de ce document vous explique comment connecter votre domaine personnalisé.
Configurer votre domaine pour App Hosting
Assurez-vous d'avoir terminé les tâches de configuration de base de App Hosting afin de disposer d'un site Firebase App Hosting dans votre projet Firebase.
Étape 1 : Ajoutez un domaine personnalisé
- Ouvrez la page App Hosting de votre projet.
- 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 pour configurer vos enregistrements DNS et terminer la configuration de votre domaine personnalisé.
Étape 2 : Configurer un domaine personnalisé
L'assistant Ajouter un domaine personnalisé de la console Firebase affiche les enregistrements nécessaires à mettre à jour pour rediriger 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:
- Type (Type) : ajoutez l'enregistrement DNS fourni.
Host (Hôte) : saisissez votre clé de domaine personnalisée 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. Votre fournisseur de domaine peut indiquer ce terme sous la forme "Nom d'hôte", "Nom" ou "Domaine".
Valeur: attribuez la valeur fournie à vos enregistrements. Votre fournisseur de domaine peut indiquer ce terme sous la forme "Données", "Points vers", "Contenu", "Adresse" ou "Adresse IP". Le contenu du champ de valeur varie selon le type d'enregistrement. Les enregistrements A et AAAA contiennent des adresses IP comme valeurs, tandis que les enregistrements TXT sont des chaînes.
Attendez que votre certificat SSL soit provisionné. Cette opération prend généralement quelques heures, mais peut parfois nécessiter jusqu'à 24 heures après avoir redirigé votre DNS vers Firebase App Hosting. Dans la plupart des cas, la propagation de vos enregistrements et le provisionnement de votre certificat SSL se produisent dans un délai d'une heure, selon votre fournisseur de domaine.
Attendre le provisionnement du certificat SSL
Une fois vos enregistrements DNS mis à jour, App Hosting peut prendre jusqu'à quelques heures pour provisionner un certificat SSL pour votre domaine. Dans certains cas, ce délai peut aller jusqu'à 24 heures après avoir 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, un certificat non valide peut s'afficher ou vous pouvez rencontrer des problèmes de connexion à votre domaine. Il s'agit d'une partie 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 pour les domaines personnalisés si nécessaire.
Types d'enregistrements DNS
L'assistant de domaine personnalisé App Hosting peut vous demander d'ajouter de 1 à 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 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 actuellement pas d'enregistrements AAAA, mais vous demandera de supprimer ceux qui existent déjà de 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 des enregistrements CNAME pour
deux raisons :
|
Oui |
| TXT | Ces enregistrements vous permettent d'ajouter des métadonnées arbitraires à votre domaine. App Hosting vous permet d'utiliser un format d'enregistrement TXT spécifique, 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 à créer des certificats SSL pour votre domaine. App Hosting ne demande des enregistrements CAA que s'il n'est pas en mesure de générer des certificats pour votre domaine. | Non |
Votre clé de domaine personnalisé
Lorsque vous ajoutez ou modifiez des enregistrements DNS, différents fournisseurs de domaines vous demandent de saisir des valeurs différentes pour le champ Host (Hébergeur) sur leurs sites de gestion DNS. Vous trouverez ci-dessous les entrées courantes de fournisseurs populaires. Pour obtenir des instructions détaillées, consultez la documentation de votre fournisseur de domaine.
| Type de domaine | Clé de domaine personnalisé |
|---|---|
| Domaine racine |
Voici quelques entrées courantes :
|
| Sous-domaine | Voici quelques entrées courantes :
|
Fournisseurs de domaines courants
Voici quelques fournisseurs de domaines courants et les types d'informations qu'ils peuvent vous demander. Ces informations sont mises à jour autant que possible, mais reportez-vous à la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.
Description des états pour les 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. Il arrive parfois 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 frappe | 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. |