Connecter un domaine personnalisé

Vous n'êtes pas obligé d'abandonner vos noms de domaine uniques et centrés sur votre marque avec Firebase 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 Hosting fournit un certificat SSL pour chacun de vos domaines et diffuse votre contenu sur un CDN mondial.

Le reste de ce document vous guide à travers ces étapes pour connecter votre domaine personnalisé.

Configurez votre domaine pour l'hébergement

Assurez-vous d'avoir terminé l'assistant « Démarrer » sur la page d'hébergement Firebase de votre projet afin que vous disposiez d'un site d'hébergement Firebase dans votre projet Firebase.

Étape 1 : Ajouter un domaine personnalisé

  1. Depuis la page Hébergement de votre projet, entrez dans l'assistant de connexion d'un domaine personnalisé :

    • Si vous n'avez qu'un seul site d'hébergement, cliquez sur Ajouter un domaine personnalisé .
    • Si vous disposez de plusieurs sites d'hébergement , cliquez sur Afficher pour le site souhaité, puis cliquez sur Ajouter un domaine personnalisé .

  2. Saisissez le nom de domaine personnalisé que vous souhaitez connecter à votre site d'hébergement.

  3. (Facultatif) Cochez la case pour rediriger toutes les requêtes sur le domaine personnalisé vers un deuxième domaine spécifié (par exemple, example.com et www.example.com redirigent vers le même contenu).

  4. Cliquez sur Continuer pour configurer vos enregistrements DNS et terminer la configuration de votre domaine personnalisé.

Étape 2 : Configurer un domaine personnalisé

Si cela vous est demandé dans l’assistant de configuration de Connect Domain , vérifiez votre domaine apex.

Ces étapes garantissent que votre domaine n'est pas déjà lié à un projet Firebase et que vous possédez le domaine spécifié.

  1. Sur le site de votre fournisseur de domaine, localisez la page de gestion DNS.

  2. Ajoutez et enregistrez un nouvel enregistrement avec les entrées suivantes :

    • Type : Ajouter un enregistrement TXT.

      Firebase Hosting nécessite que vous conserviez cet enregistrement TXT continuellement présent dans vos paramètres DNS pour prouver votre propriété du domaine et autoriser Firebase à attribuer et renouveler des certificats SSL pour votre site.

      Votre fournisseur de domaine peut répertorier ce terme comme « Type d'enregistrement ».

    • Hôte : saisissez votre clé de domaine apex .

      Prouver votre propriété d'un domaine apex, ou domaine racine, prouve votre propriété de tous ses sous-domaines.

      Votre fournisseur de domaine peut répertorier ce terme comme « Nom d'hôte », « Nom » ou « Domaine ».

    • Valeur : copiez la valeur de vérification unique dans le champ.

      Firebase Hosting vérifie cette valeur pour prouver la propriété de votre domaine.

      Votre fournisseur de domaine peut répertorier ce terme comme « Données ».

  3. Attendez jusqu'à 24 heures pour la propagation de vos enregistrements TXT mis à jour, puis cliquez sur Vérifier .

    Notez que vous pouvez cliquer sur Annuler pour fermer en toute sécurité la fenêtre Connecter le domaine et la rouvrir ultérieurement. Cela n'affecte pas le temps de propagation, mais vous serez invité à ressaisir votre nom de domaine lorsque vous rouvrirez la fenêtre.

    Après un temps de propagation suffisant, cliquer sur Vérifier dans la fenêtre Connecter le domaine de la console Firebase vous permet de commencer le processus de provisionnement du certificat SSL.

    Dans la plupart des cas, la propagation de vos enregistrements et la vérification de votre domaine auront lieu en quelques heures, selon votre fournisseur de domaine. Reportez-vous à la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées sur l'ajout d'enregistrements TXT et les temps de propagation.

    Si le fait de cliquer sur Vérifier affiche un message d'erreur, vos enregistrements ne se sont pas propagés ou vos valeurs peuvent être incorrectes.

Dans l'assistant Ajouter un domaine personnalisé de la console Firebase, sélectionnez Configuration rapide ou Configuration avancée .

La configuration rapide peut être utilisée pour les nouveaux domaines qui ne reçoivent actuellement pas de trafic ou pour les domaines que vous essayez de transférer depuis un autre site d'hébergement. La configuration avancée peut être utilisée si vous disposez déjà d'un domaine recevant des demandes sur un autre fournisseur d'hébergement et que vous avez besoin d'une migration sans temps d'arrêt.

L'assistant de configuration avancée vous aidera à établir un certificat SSL et une revendication de propriété pour permettre à l'hébergement de diffuser le trafic sur le domaine avant de recevoir du trafic.

Attendez la fourniture du certificat SSL

Après avoir vérifié la propriété du domaine, nous fournissons un certificat SSL pour votre domaine et le déployons sur notre CDN mondial dans les 24 heures suivant le pointage de vos enregistrements DNS A vers Firebase Hosting.

Votre domaine sera répertorié comme l'un des noms alternatifs de sujet (SAN) dans le certificat SSL FirebaseApp. Vous pouvez visualiser ce certificat à l'aide des outils de sécurité du navigateur. Pendant le provisionnement du domaine, vous pouvez voir un certificat non valide qui n'inclut pas votre nom de domaine. Il s'agit d'une partie normale du processus et sera résolue une fois que le certificat de votre domaine sera disponible.

Pour les utilisateurs de la configuration avancée , votre site Web sera hébergé par votre ancien fournisseur d'hébergement jusqu'à ce que l' état de la configuration sur la page d'hébergement Firebase de votre projet soit mis à jour sur Connecté .

Votre clé de domaine personnalisée

Lors de l'ajout ou de la modification d'enregistrements DNS, différents fournisseurs de domaine s'attendent à ce que vous saisissiez différentes entrées pour le champ Hôte au sein de leurs sites de gestion DNS. Nous avons compilé ci-dessous les contributions courantes des fournisseurs populaires. Reportez-vous à la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.

Type de domaine Clé de domaine personnalisée
Domaine Apex

Les entrées courantes incluent :

  • @
  • Le nom de domaine apex (par exemple, example .com )
  • Laisser le champ Hôte vide
Sous-domaine

Les entrées courantes incluent :

  • Le nom complet du sous-domaine (par exemple, app. example .com )
  • Uniquement la partie sous-domaine (par exemple, app uniquement et en laissant de côté . example .com )
  • Uniquement www pour le sous-domaine de www. example .com

Fournisseurs de domaines courants

Voici quelques fournisseurs de domaines courants et les types d’entrées que chacun peut nécessiter. Ces informations sont tenues à jour autant que possible, mais reportez-vous à la documentation de votre fournisseur de domaine pour des instructions détaillées.

Descriptions de l'état de configuration pour les domaines personnalisés

Statut Description
Nécessite une configuration

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 depuis votre fournisseur de nom de domaine vers les serveurs Firebase Hosting.
    Conseil de dépannage : si cela fait plus de 24 heures, vérifiez que vous avez pointé vos enregistrements vers Firebase Hosting.

  • Dans des cas plus rares, en particulier si vous utilisez le flux de configuration avancée, les tests SSL peuvent échouer pour les raisons suivantes :

    • Vos enregistrements DNS contiennent 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 Hosting et supprimez tous les enregistrements CNAME.
    • La migration a échoué et le jeton (enregistrements DNS TXT ou fichier téléchargé fourni sur votre site) n'est désormais plus valide.
      Conseil de dépannage : cliquez sur Afficher pour le domaine, puis fournissez le nouveau jeton à votre domaine existant.
En attente

Vous avez correctement configuré votre domaine personnalisé, mais Firebase Hosting n'a pas fourni de certificat SSL.

Parfois, les problèmes suivants peuvent bloquer la création d'un certificat SSL pour un domaine personnalisé :

  • Vos enregistrements CAA sont trop restrictifs.
    Conseil de dépannage : assurez-vous que les autorités de certification « letsencrypt.org » et « pki.goog » sont autorisées à créer des certificats SSL pour votre domaine.
  • Votre code de défi n'est pas valide.
    Si vous utilisez le flux de configuration avancée et que la migration a échoué, votre jeton (et son code de défi) ne sont désormais plus valides.
    Conseil de dépannage : cliquez sur Afficher pour le domaine, puis fournissez le nouveau jeton à votre domaine existant.
  • Vous avez demandé des certificats pour trop de sous-domaines.
    Conseil de dépannage : en règle générale, Firebase Hosting ne recommande pas plus de 20 sous-domaines sur un domaine personnalisé apex, en raison des limites de création de certificats SSL.
Certificat de frappe

Un certificat SSL est en cours de production pour votre domaine.

Connecté

Votre domaine personnalisé possède les enregistrements DNS appropriés et dispose d'un certificat SSL.
Vous pouvez diffuser le contenu de votre site.