Associer un domaine personnalisé

Avec Firebase Hosting, vous n'avez pas besoin d'abandonner vos noms de domaine uniques axés sur votre marque. 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 provisionne un certificat SSL pour chacun de vos domaines et diffuse votre contenu via un CDN mondial.

La suite de ce document vous explique comment connecter votre domaine personnalisé.

Configurer votre domaine pour Hosting

Assurez-vous d'avoir terminé l'assistant "Premiers pas" sur la page Firebase Hosting de votre projet afin de disposer d'un site Firebase Hosting dans votre projet Firebase.

Étape 1: Ajouter un domaine personnalisé

  1. Sur la page Hosting de votre projet, accédez à l'assistant permettant d'associer un domaine personnalisé:

    • Si vous n'avez qu'un seul site Hosting, cliquez sur Ajouter un domaine personnalisé.
    • Si vous possédez plusieurs sites Hosting, cliquez sur Afficher pour le site souhaité, puis sur Ajouter un domaine personnalisé.

  2. Saisissez le nom de domaine personnalisé que vous souhaitez associer à votre site Hosting.

  3. (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).

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

Étape 2: Configurer un domaine personnalisé

Si vous y êtes invité dans l'assistant de configuration Connecter un domaine, validez votre domaine racine.

Ces étapes vous permettent de vous assurer que votre domaine n'est pas déjà associé à un projet Firebase et que vous en êtes le propriétaire.

  1. Sur le site de votre fournisseur de domaine, accédez à la page de gestion DNS.

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

    • Type (Type) : ajoutez un enregistrement TXT.

      Firebase Hosting exige que vous conserviez cet enregistrement TXT en permanence dans vos paramètres DNS pour prouver que le domaine vous appartient et autoriser Firebase à attribuer et à renouveler des certificats SSL pour votre site.

      Votre fournisseur de domaine peut indiquer ce terme sous la forme "Type d'enregistrement".

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

      Si vous prouvez que vous êtes le propriétaire d'un domaine de premier niveau (ou domaine racine), vous prouvez également que vous êtes le propriétaire de tous ses sous-domaines.

      Votre fournisseur de domaine peut indiquer ce terme sous la forme "Nom d'hôte", "Nom" ou "Domaine".

    • Value (Valeur) : copiez la valeur de validation unique dans le champ.

      Firebase Hosting vérifie cette valeur pour prouver que vous êtes bien le propriétaire du domaine.

      Votre fournisseur de domaine peut indiquer ce terme sous la forme "Données".

  3. La propagation de vos enregistrements TXT mis à jour peut prendre jusqu'à 24 heures. Attendez ce délai avant de cliquer sur Valider.

    Notez que vous pouvez cliquer sur Annuler pour fermer de manière sécurisée la fenêtre Connecter un domaine et la rouvrir ultérieurement. Cela n'a aucune incidence sur le délai de propagation, mais vous serez invité à recomposer votre nom de domaine lorsque vous rouvrirez la fenêtre.

    Après un temps de propagation suffisant, cliquez sur Verify (Valider) dans la fenêtre Connect Domain (Connecter un domaine) de la console Firebase pour commencer le processus de provisionnement du certificat SSL.

    Dans la plupart des cas, la propagation de vos enregistrements et la validation de votre domaine se produisent en quelques heures, selon votre fournisseur de domaine. Consultez la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées sur l'ajout d'enregistrements TXT et les délais de propagation.

    Si un message d'erreur s'affiche lorsque vous cliquez sur Valider, cela signifie que vos enregistrements ne se sont pas propagés ou que vos valeurs sont 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 pas actuellement de trafic ou les domaines que vous essayez de transférer depuis un autre site Hosting. La configuration avancée peut être utilisée si vous disposez déjà d'un domaine qui reçoit des requêtes sur un autre fournisseur d'hébergement et que vous avez besoin d'une migration sans temps d'arrêt.

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

Attendre le provisionnement du certificat SSL

Une fois que nous aurons vérifié la propriété du domaine, nous provisionnerons un certificat SSL pour votre domaine et le déploierons sur notre CDN mondial dans les 24 heures suivant la redirection de vos enregistrements A DNS vers Firebase Hosting.

Votre domaine figurera comme l'un des noms d'objet de remplacement (SAN) dans le certificat SSL FirebaseApp. Vous pouvez afficher 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 étape normale du processus qui 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 configuration sur la page Firebase Hosting de votre projet indique Connecté.

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ôte) 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)
  • Uniquement www pour le sous-domaine de www.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 consultez la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.

Descriptions des états de configuration des 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 ne se sont pas propagés depuis votre fournisseur de noms de domaine vers les serveurs Firebase Hosting.
    Conseil de dépannage: Si plus de 24 heures se sont écoulées, vérifiez que vous avez dirigé vos enregistrements vers Firebase Hosting.

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

    • Les requêtes de certificat SSL ont échoué, et le jeton (enregistrements TXT DNS ou fichier importé fourni à votre site) n'est 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 provisionné de certificat SSL.

Il arrive que les problèmes suivants bloquent 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 plus valides.
    Astuce 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.
    Astuce de dépannage: En général, Firebase Hosting recommande de ne pas dépasser 20 sous-domaines par domaine personnalisé racine, en raison des limites d'émission de certificats SSL.
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.