Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
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é .
Entrez le nom de domaine personnalisé que vous souhaitez connecter à votre site d'hébergement.
(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).
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é.
Sur le site de votre fournisseur de domaine, recherchez la page de gestion DNS.
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".
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".
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.
Installation rapide
Retournez sur le site de gestion DNS de votre fournisseur de nom de domaine pour créer des enregistrements DNS A pointant votre page vers Firebase Hosting. Ajoutez et enregistrez des enregistrements avec les entrées suivantes :
L'hébergeur que vous indiquez est le domaine sur lequel vous souhaitez diffuser du contenu ; ce domaine peut être un domaine ou un sous-domaine apex.
Votre fournisseur de domaine peut répertorier ce terme sous la forme "Nom d'hôte", "Nom" ou "Domaine".
Valeur : attribuez une valeur à chaque enregistrement DNS A pour faire pointer votre domaine vers les adresses IP spécifiées.
Votre fournisseur de domaine peut répertorier ce terme comme "Données", "Pointe vers", "Contenu", "Adresse" ou "Adresse IP".
Prévoyez du temps pour que votre certificat SSL soit provisionné . Cela peut prendre jusqu'à 24 heures après que vous ayez pointé vos enregistrements A vers Firebase Hosting. Dans la plupart des cas, la propagation de vos enregistrements et la fourniture de votre certificat SSL se feront en quelques heures, selon votre fournisseur de domaine.
Configuration avancée
La fenêtre Connecter le domaine de la console Firebase vous demandera de fournir un jeton pour migrer votre site existant. Il vous suffit d'effectuer l'une des opérations suivantes pour fournir le jeton :
Mettre à jour les enregistrements DNS TXT : visitez le site de gestion DNS de votre fournisseur de domaine. Ajoutez un enregistrement TXT avec votre clé de domaine et la valeur fournie.
Prévoyez jusqu'à 24 heures pour la propagation de vos enregistrements TXT.
Téléchargez un fichier sur un site existant : Téléchargez le jeton sur votre site existant à l'URL spécifiée et vérifiez son existence.
Cette page doit être diffusée via HTTPS et n'a pas besoin d'être valide ou sécurisée. Le jeton chiffré n'est valide que pour un essai. Si la migration échoue, un nouveau jeton sera généré pour vos enregistrements.
Prévoyez du temps pour que votre certificat SSL soit provisionné . Cela peut prendre jusqu'à 24 heures. Dans la plupart des cas, la propagation de vos enregistrements et la fourniture de votre certificat SSL se feront en quelques heures, selon votre fournisseur de domaine.
Une fois votre certificat SSL provisionné, revenez sur le site de gestion DNS de votre fournisseur DNS pour ajouter des enregistrements DNS A pointant votre page vers Firebase Hosting. Ajoutez et enregistrez des enregistrements avec les entrées suivantes :
L'hébergeur que vous indiquez est le domaine sur lequel vous souhaitez diffuser du contenu ; ce domaine peut être un domaine ou un sous-domaine apex.
Votre fournisseur de domaine peut répertorier ce terme sous la forme "Nom d'hôte", "Nom" ou "Domaine".
Valeur : attribuez une valeur à chaque enregistrement DNS A pour faire pointer votre domaine vers les adresses IP spécifiées.
Votre fournisseur de domaine peut répertorier ce terme comme "Données", "Pointe vers", "Contenu", "Adresse" ou "Adresse IP".
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.
Nuageux
Taper
Héberger
Valeur
Entrées d'enregistrement DNS TXT
SMS
example .com
valeur de vérification fournie dans la console Firebase
DNS A enregistre les entrées
UN
example .com
199.36.158.100
UN
www
199.36.158.100
Domaines Google
Taper
Héberger
Valeur
Entrées d'enregistrement DNS TXT
SMS
@
valeur de vérification fournie dans la console Firebase
DNS A enregistre les entrées
UN
@
199.36.158.100
UN
www
199.36.158.100
Google Cloud DNS
Taper
Héberger
Valeur
Entrées d'enregistrement DNS TXT
SMS
example .com
valeur de vérification fournie dans la console Firebase
DNS A enregistre les entrées
UN
example .com
199.36.158.100
UN
www
199.36.158.100
NomCheap
Taper
Héberger
Valeur
Entrées d'enregistrement DNS TXT
SMS
@
valeur de vérification fournie dans la console Firebase
DNS A enregistre les entrées
UN
@
199.36.158.100
UN
@
199.36.158.100
Espace carré
Taper
Héberger
Valeur
Entrées d'enregistrement DNS TXT
SMS
@
valeur de vérification fournie dans la console Firebase
DNS A enregistre les entrées
UN
@
199.36.158.100
UN
www
199.36.158.100
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.