Associer un domaine personnalisé

Vous n'avez pas besoin d'abandonner vos noms de domaine uniques et axé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é sur Firebase.

Firebase Hosting provisionne un certificat SSL pour chacun de vos domaines et diffuse votre contenu via un CDN mondial.

Le reste de ce document vous guide à travers ces étapes pour 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 pour disposer d'un site Firebase Hosting dans votre projet Firebase.

Étape 1 : Ajoutez un domaine personnalisé

  1. Sur la page Hosting de votre projet, accédez à l'assistant pour associer 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 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 la configuration de votre domaine personnalisé.

Étape 2 : Configurer un domaine personnalisé

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

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

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

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

    • Type : ajoutez un enregistrement TXT.

      Firebase Hosting exige que cet enregistrement TXT soit toujours présent dans vos paramètres DNS pour prouver que vous êtes propriétaire du domaine et autoriser Firebase à attribuer et renouveler des certificats SSL pour votre site.

      Votre fournisseur de domaine peut utiliser le terme "Type d'enregistrement".

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

      Si vous prouvez que vous êtes propriétaire d'un domaine apex ou d'un domaine racine, vous prouvez que vous êtes propriétaire de tous ses sous-domaines.

      Votre fournisseur de domaine peut utiliser les termes "Nom d'hôte", "Nom" ou "Domaine".

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

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

      Votre fournisseur de domaine peut utiliser le terme "Données".

  3. Laissez passer jusqu'à 24 heures pour que vos enregistrements TXT mis à jour soient propagés, puis cliquez sur Valider.

    Notez que vous pouvez cliquer sur Annuler pour fermer la fenêtre Associer un domaine et la rouvrir ultérieurement. Cela n'a pas d'incidence sur le temps de propagation, mais vous serez invité à saisir à nouveau votre nom de domaine lorsque vous rouvrirez la fenêtre.

    Après un temps de propagation suffisant, cliquez sur Valider dans la fenêtre Associer un domaine de la console Firebase pour lancer le processus de provisionnement du certificat SSL.

    Dans la plupart des cas, la propagation de vos enregistrements et la validation de votre domaine auront lieu 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 peut-être incorrectes.

Dans l'assistant Add Custom Domain (Ajouter un domaine personnalisé) de la console Firebase, sélectionnez Quick Setup (Configuration rapide) ou Advanced Setup (Configuration avancée).

La configuration rapide peut être utilisée pour les nouveaux domaines qui ne reçoivent pas de trafic actuellement ou pour les domaines que vous essayez de transférer depuis un autre site Hosting. Vous pouvez utiliser la configuration avancée si vous disposez déjà d'un domaine recevant des requêtes auprès d'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 à revendiquer la propriété pour permettre à Hosting de diffuser du trafic sur le domaine avant de le recevoir.

Attendre le provisionnement du certificat SSL

Une fois la propriété du domaine validée, nous provisionnons un certificat SSL pour votre domaine et le déployons sur notre CDN mondial dans les 24 heures suivant la redirection de vos enregistrements A DNS vers Firebase Hosting.

Votre domaine sera listé 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, il est possible qu'un certificat non valide s'affiche et ne contienne pas votre nom de domaine. Il s'agit d'une étape normale du processus. Le problème sera résolu une fois le certificat de votre domaine disponible.

Si vous utilisez 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 Firebase Hosting de votre projet passe à Connecté.

Votre clé de domaine personnalisée

Lorsque vous ajoutez ou modifiez des enregistrements DNS, différents fournisseurs de domaine vous demandent de saisir des entrées différentes pour le champ Hôte sur leurs sites de gestion DNS. Vous trouverez ci-dessous les entrées courantes des fournisseurs les plus 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 exemples d'entrées courantes :

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

Voici quelques exemples d'entrées courantes :

  • Nom complet du sous-domaine (par exemple, app.example.com)
  • Seule la partie sous-domaine (par exemple, app uniquement, sans .example.com)
  • Seul www pour le sous-domaine de www.example.com

Fournisseurs de domaines courants

Voici quelques fournisseurs de domaine courants et les types d'entrées qu'ils peuvent exiger. Nous mettons ces informations à jour autant que possible, mais consultez la documentation de votre fournisseur de domaine pour obtenir des instructions détaillées.

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

État Description
À configurer

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 Firebase Hosting.
    Conseil de dépannage : Si plus de 24 heures se sont écoulées, vérifiez que vous avez redirigé vos enregistrements vers Firebase Hosting.

  • Dans de rares cas, en particulier si vous utilisez la procédure de configuration avancée, les défis SSL peuvent échouer pour les raisons suivantes :

    • Les défis liés au 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.

Les problèmes suivants peuvent parfois empêcher 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 validation 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 validation) ne sont 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 un trop grand nombre de sous-domaines.
    Conseil de dépannage : En général, Firebase Hosting recommande de ne pas utiliser plus de 20 sous-domaines sur un domaine personnalisé racine, en raison des limites de création de certificats SSL.
Certificat de génération

Un certificat SSL est en cours de création pour votre domaine.
Connecté

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