Catch up on highlights from Firebase at Google I/O 2023. Learn more

Connecter un domaine personnalisé

Vous n'avez pas à renoncer à vos noms de domaine uniques et centrés sur la 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 "Commencer" à partir de la page d'hébergement Firebase de votre projet afin d'avoir un site d'hébergement Firebase dans votre projet Firebase.

Étape 1 : Ajouter un domaine

  1. Depuis la page Hébergement de votre projet, accédez à 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 avez plusieurs sites d'hébergement , cliquez sur Afficher pour le site souhaité, puis cliquez sur Ajouter un domaine personnalisé .
  2. Entrez 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 second domaine spécifié (par exemple, example.com et www.example.com redirigent vers le même contenu).

  4. Cliquez sur Continuer pour lancer le processus de validation.

Étape 2 : Vérifiez la propriété du domaine

Si vous y êtes invité dans l'assistant de configuration Connecter un domaine , 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, recherchez la page de gestion DNS.

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

    • Tapez : Ajoutez un enregistrement TXT.

      Firebase Hosting exige que vous conserviez cet enregistrement TXT en permanence dans vos paramètres DNS pour prouver que vous êtes propriétaire du domaine et pour autoriser Firebase à attribuer et à renouveler les 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 que vous êtes propriétaire d'un domaine apex, ou domaine racine, prouve que vous êtes propriétaire de tous ses sous-domaines.

      Votre fournisseur de domaine peut répertorier ce terme sous la forme "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 se feront 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 sont peut-être incorrectes.

Étape 3 : Passez en direct

Dans la fenêtre Connecter le domaine de la console Firebase, sélectionnez Configuration rapide pour un nouveau site ou Configuration avancée si vous avez déjà un site en cours d'exécution sur un autre fournisseur d'hébergement et que vous avez besoin d'une migration sans temps d'arrêt.

Attendre le provisionnement du certificat SSL

Une fois que nous avons 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 autres noms d'objet (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. Ceci est une partie normale du processus et sera résolu 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 fournisseur d'hébergement précédent jusqu'à ce que l' état de configuration de la page d'hébergement Firebase de votre projet passe à 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 dans leurs sites de gestion DNS. Nous avons compilé ci-dessous les entrées 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 supérieur

Les entrées communes incluent :

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

Les entrées communes incluent :

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

Fournisseurs de domaine communs

Voici quelques fournisseurs de domaine 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 la 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 de votre fournisseur de nom de domaine aux serveurs d'hébergement Firebase.
    Conseil de dépannage : si cela fait plus de 24 heures, vérifiez que vous avez redirigé 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 car :

    • Vos enregistrements DNS ont 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 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 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.

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 challenge) sont désormais invalides.
    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 frappe des certificats SSL.
Connecté

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

Nécessite une re-vérification

Firebase peut vous demander de revérifier manuellement la propriété de votre domaine si l'enregistrement TXT ajouté lorsque vous avez initialement vérifié la propriété de votre domaine a été modifié ou supprimé des paramètres DNS de votre domaine.

  • Notez que plusieurs enregistrements TXT avec un jeton de vérification de site Google sont autorisés sur un seul domaine.
  • Nous exigeons que l'enregistrement TXT soit continuellement présent dans vos paramètres DNS car cela prouve que vous êtes propriétaire du domaine et nous autorise à attribuer et à renouveler les certificats SSL pour votre site.
Conseil de dépannage : accédez à la page d'hébergement de votre projet pour terminer le processus de revérification dans le délai spécifié (généralement 30 jours) afin d'éviter que votre domaine personnalisé ne soit automatiquement déconnecté de Firebase Hosting.