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 associer 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 App Hosting peut vous demander d'ajouter ou de supprimer 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. Non
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. Une fois l'intégration terminée, 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

Avant de commencer: votre nom 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 (ou host name) 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 de 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 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 autant que possible, mais reportez-vous à la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.

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

Migrer un domaine

Si vous souhaitez assurer un service ininterrompu sans temps d'arrêt pour votre application, vous devez configurer vos enregistrements DNS dans un certain ordre. Après avoir ajouté votre domaine, vous devrez d'abord suivre une procédure pour valider vos enregistrements DNS, puis effectuer une autre étape de validation pour diriger les requêtes en direct vers 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: Vérifier les enregistrements DNS

  1. 1. L'assistant Migrer un domaine 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 valeurs suivantes pour les enregistrements requis :
    • Nom: saisissez votre 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. Votre fournisseur de domaine peut indiquer ce terme sous la forme "Nom d'hôte", "Nom" ou "Domaine".
    • Type d'enregistrement: ajoutez l'enregistrement DNS fourni.
    • 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.
  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 Settings > Domains (Paramètres > Domaines) du tableau de bord du backend.

Étape 3: Accéder directement à App Hosting

  1. Une fois que App Hosting a validé les mises à jour de l'enregistrement, la boîte de dialogue Direct to App Hosting (Rediriger vers App Hosting) affiche l'enregistrement final que vous devez mettre à jour pour rediriger votre domaine vers App Hosting. Comme précédemment, ajoutez, supprimez et enregistrez les enregistrements de votre domaine dans votre fournisseur DNS en saisissant les valeurs suivantes pour les enregistrements requis :
    • Nom: saisissez votre 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. Votre fournisseur de domaine peut indiquer ce terme sous la forme "Nom d'hôte", "Nom" ou "Domaine".
    • Type d'enregistrement: ajoutez l'enregistrement DNS fourni.
    • 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.
  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 Settings > Domains (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 nouveau à 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érifier les enregistrements DNS

  1. L'assistant Configurer le domaine 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 utilisant les entrées suivantes :
    • Nom: saisissez votre 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. Votre fournisseur de domaine peut indiquer ce terme sous la forme "Nom d'hôte", "Nom" ou "Domaine".
    • Type d'enregistrement: ajoutez l'enregistrement DNS fourni.
    • 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.
  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 Settings > Domains (Paramètres > Domaines) du tableau de bord du backend.

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.

Descriptions d'état pour les domaines personnalisés

État Description
Configuration requise

Vous devrez peut-être modifier une configuration de 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.