Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. 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, entrez dans l'assistant de connexion d'un domaine personnalisé :

    • Si vous n'avez qu'un seul site d'hébergement, cliquez sur Connecter le domaine .
    • Si vous avez plusieurs sites d'hébergement , cliquez sur Afficher pour le site souhaité, puis cliquez sur Connecter le domaine .
  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 demandes du 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 lancer le processus de validation.

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

Si cela 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à associé à 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 :

    • Tapez : Ajoutez un enregistrement TXT.

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

      Votre fournisseur de domaine peut lister ce terme comme « Type d'enregistrement ».

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

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

      Votre fournisseur de domaine peut lister 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 lister 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 Connect Domain et 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 long temps de propagation, cliquer sur Vérifier dans la fenêtre Connect Domain 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 cliquer sur Vérifier affiche un message d'erreur, vos enregistrements ne se sont pas propagés ou vos valeurs peuvent être incorrectes.

Étape 3 : Lancez-vous

Dans la fenêtre Connect Domain de la console Firebase, sélectionnez Quick Setup pour un nouveau site ou Advanced Setup si vous avez déjà un site en cours d'exécution sur un autre fournisseur d'hébergement et avez besoin d'une migration sans interruption.

Attendre l'approvisionnement 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 du sujet (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 ancien fournisseur d'hébergement jusqu'à ce que le statut de la configuration sur 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 contributions communes des fournisseurs populaires. Reportez-vous à la documentation de votre fournisseur de domaine pour des instructions détaillées.

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

Les entrées communes incluent :

  • @
  • Le nom de domaine apex (par exemple, par 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 )
  • Seule la partie du sous-domaine (par exemple, app uniquement et en excluant . 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 d'état de configuration pour les domaines personnalisés

Statut La description
Configuration requise

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 à 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 fourni de certificat SSL.

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

  • Vos dossiers 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) 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.
Lié

Votre domaine personnalisé possède les enregistrements DNS appropriés et possède 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'une des situations suivantes se produit :

  • L'enregistrement TXT ajouté lors de la première vérification de 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 même domaine.
    • Nous exigeons que l'enregistrement TXT soit continuellement présent dans vos paramètres DNS, car cela prouve que vous possédez le domaine et nous autorise à attribuer et à renouveler les certificats SSL pour votre site.
  • La personne qui a vérifié la propriété du domaine ne se voit plus attribuer un rôle IAM contenant l'autorisation requise pour vérifier la propriété du domaine. Ces rôles incluent le propriétaire, l'éditeur, l'administrateur Firebase et l'administrateur Firebase Develop.
Conseil de dépannage : visitez 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.