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 sur 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: Ajoutez un domaine personnalisé

  1. À partir de l'API Page Hosting, accédez à l'assistant pour connecter un domaine personnalisé:

    • Si vous n'avez qu'un seul site Hosting, cliquez sur Ajouter un domaine personnalisé.
    • Si vous avez plusieurs sites Hosting, cliquez sur Affichez le site de votre choix, puis cliquez 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 du domaine personnalisé vers un deuxième domaine spécifié (tel 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 l'assistant de configuration Connecter un domaine vous y invite, valider votre domaine apex.

Cette procédure permet de s'assurer que votre domaine n'est pas déjà associé à Firebase et que vous êtes propriétaire du domaine spécifié.

  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: ajoutez un enregistrement TXT.

      Firebase Hosting exige que vous conserviez cet enregistrement TXT en continu dans vos paramètres DNS pour prouver que vous êtes bien le propriétaire du domaine et pour autoriser Firebase à attribuer et à renouveler les 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.

      Prouver que vous êtes propriétaire d'un domaine apex, ou d'un domaine racine, prouve votre la propriété de tous ses sous-domaines.

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

    • 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 Cancel (Annuler) pour fermer la page Connect Domain (Associer le domaine) puis la rouvrir plus tard. Cela n'affecte pas la propagation mais vous serez invité à saisissez à nouveau votre nom de domaine lorsque vous rouvrez 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 dans un délai de 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 avons validé la propriété du domaine, nous provisionnons un certificat SSL pour votre et le déployer sur notre CDN mondial dans les 24 heures suivant le pointage des enregistrements DNS A vers Firebase Hosting.

Votre domaine sera répertorié comme l'un des SAN (Subject Alternative Names) 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.

Si vous utilisez la configuration avancée, votre site Web sera hébergé sur votre ancien site d'hébergement. jusqu'à ce que le état de la configuration dans votre du projet Firebase Hosting page de mises à jour sur Connecté.

Votre clé de domaine personnalisée

Lors de l'ajout ou de la modification d'enregistrements DNS, les fournisseurs de domaine s'attendent à d'entrer différentes entrées pour le champ Host (Hôte) de leur gestion DNS. de votre site Web. 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ée
Domaine Apex

Voici quelques entrées courantes :

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

Voici quelques entrées courantes :

  • Le 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

Principaux fournisseurs de domaine

Voici quelques fournisseurs de domaine courants et les types d'informations que chacun d'entre eux peut nécessiter. Ces informations sont mises à jour autant que possible, mais consultez la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.

Configurer des descriptions d'état pour les domaines personnalisés

État Description
Configuration requise

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

  • Dans la plupart des cas, vos enregistrements DNS A n'ont pas été propagés de votre fournisseur de nom de domaine aux serveurs Firebase Hosting.
    Conseil de dépannage: Si plus de 24 heures se sont écoulées, vérifiez que vous avez fait pointer vos enregistrements vers Firebase Hosting.

  • Dans de rares cas, surtout si vous utilisez la configuration avancée, les tests 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 l'émission 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és à 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.
    Conseil de dépannage : En règle générale, Firebase Hosting recommande de ne pas dépasser 20 sous-domaines par domaine personnalisé racine, en raison des limites de création 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.