Associer un domaine personnalisé

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. 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 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é

  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 pour configurer vos enregistrements DNS et terminer la configuration de votre domaine personnalisé.

Étape 2: Configurer un domaine personnalisé

  1. 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 dans votre fournisseur DNS en saisissant les informations 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".

    • Value (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

App Hosting peut mettre jusqu'à plusieurs heures à provisionner un certificat SSL pour votre domaine après la mise à jour de vos enregistrements DNS. 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 réprovisionne automatiquement les certificats SSL, si nécessaire, pour les domaines personnalisés.

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 :
  • Intégration facile:lorsque cela est possible, App Hosting vous demande de créer un enregistrement CNAME vers un domaine préconfiguré commençant par _custom-domain....
  • Validation des certificats SSL:App Hosting utilise le Gestionnaire de certificats Cloud 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 la couverture de votre 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 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 si elle est empêchée d'émettre 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:

  • @
  • Nom de domaine racine (par exemple, example.com)
  • Laisser le champ Host (Hôte) vide
Sous-domaine

Voici quelques entrées courantes:

  • Nom complet du sous-domaine (par exemple, app.example.com)
  • Seule la partie sous-domaine (par exemple, app uniquement, en ignorant .example.com)

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 dans la mesure du possible, mais reportez-vous à la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.

Descriptions d'état pour les domaines personnalisés

État Description
Configuration requise

Vous devrez peut-être modifier une configuration dans vos enregistrements DNS.

  • Dans la plupart des cas, vos enregistrements DNS A n'ont pas été propagés depuis votre fournisseur de noms 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 dirigé vos enregistrements vers Firebase App Hosting.

  • Dans de rares cas, les défis SSL peuvent échouer, car vos enregistrements DNS contiennent des enregistrements A ou des enregistrements 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.

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.
Vous pouvez diffuser le contenu de votre site.