Catch up on everthing we announced at this year's Firebase Summit. 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é Firebase pour votre site hébergé 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 que vous avez terminé le « Get Started » Assistant de votre projet page d' hébergement Firebase afin que vous avez un site d' hébergement Firebase dans votre projet Firebase.

Étape 1: Ajouter un domaine

  1. De votre projet est la page d' hébergement , entrez l'assistant de connexion d' un domaine personnalisé:

    • Si vous avez un seul site d' hébergement, cliquez sur Connecter domaine.
    • Si vous avez plus d'un site d' hébergement , cliquez sur Afficher pour le site souhaité, puis cliquez sur Connecter 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 requêtes sur le domaine personnalisé à un second domaine spécifié (tel que example.com et www.example.com redirection 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 demandé dans l'assistant d'installation Connect de domaine, vérifiez votre domaine pointe.

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 :

    • Type: Ajouter 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: Entrez votre clé de domaine pointe .

      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: Copier la valeur de vérification unique sur le terrain.

      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. Prévoyez un maximum de 24 heures pour la propagation de vos enregistrements TXT mises à jour, puis cliquez sur Vérifier.

    Notez que vous pouvez cliquer sur Annuler pour en toute sécurité , fermez la fenêtre Connect de domaine et rouvrir plus tard. Cela ne touche pas le temps de propagation, mais vous serez invité à re-saisir votre nom de domaine lorsque vous ouvrez à nouveau la fenêtre.

    Après amplement le temps de propagation, cliquez sur Vérifier dans la fenêtre Connect domaine de la console Firebase vous permet de commencer le processus d' approvisionnement 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 cliquez sur Vérifier invites un message d'erreur, vos dossiers ne sont pas propagées ou vos valeurs peuvent être incorrectes.

Étape 3: Prenez le direct

Dans la fenêtre Connect Domaine de la console Firebase, sélectionnez Configuration rapide 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 ont besoin d' une migration sans interruption de service.

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 configuration avancée, votre site sera hébergé par votre ancien fournisseur d' hébergement jusqu'à ce que l' état d'installation dans votre projet de Firebase hébergement de pages mises à jour de Connected.

Votre clé de domaine personnalisée

Lors de l' ajout ou la modification d' enregistrements DNS, différents fournisseurs de domaine vous attendent d'entrer dans les différentes entrées du champ hôte au sein de leurs sites de gestion de 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 pointe (par exemple, par example .com )
  • Laissant le champ Hôte vide
Sous-domaine

Les entrées communes incluent :

  • Le nom complet du sous - domaine (par exemple, l' app. example .com par app. example .com )
  • Seule la partie de sous - domaine (par exemple, l' app uniquement, et laissant de côté par . example .com )
  • Seulement www pour le sous - domaine www. example .com par 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.
      Dépannage tip: Cliquez sur Afficher pour le domaine, puis fournir 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.
    Dépannage tip: Cliquez sur Afficher pour le domaine, puis fournir 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é 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é lorsque vous avez initialement vérifié la propriété du domaine a été modifié ou supprimé les 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 n'est plus attribué un rôle IAM qui contient l'autorisation nécessaire 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 votre projet de page d' hébergement pour terminer le processus de re-vérification dans la fenêtre de temps spécifiée (habituellement 30 jours) pour éviter que votre domaine personnalisé d'être déconnecté automatiquement Firebase Hébergement.