Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Connectez 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, signé par Let's Encrypt , pour chacun de vos domaines et sert votre contenu sur un CDN global.

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é l'assistant «Prise en main» à 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 d'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 plus d'un site d'hébergement , cliquez sur Afficher pour le site souhaité, puis 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é (tel que example.com et www.example.com redirigent vers le même contenu).

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

Étape 2 : valider la propriété du domaine

Si cela est demandé dans l'assistant de configuration du domaine de connexion , 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 sauvegardez un nouvel enregistrement avec les entrées suivantes:

    • Type : ajoutez un enregistrement TXT.

      Firebase Hosting exige que vous conserviez cet enregistrement TXT en permanence présent dans vos paramètres DNS pour prouver que vous êtes le 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 : entrez votre clé de domaine apex .

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

      Votre fournisseur de domaine peut répertorier 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 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 de connexion au domaine et la rouvrir ultérieurement. Cela n'affecte pas 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, 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 auront lieu 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 peuvent être incorrectes.

Étape 3 : passez en direct

Dans la fenêtre Connect Domain 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.

Attendez 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 global 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 de 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. Il s'agit d'une partie normale du processus et se résoudra 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 le statut de configuration de la page d'hébergement Firebase de votre projet soit mis à jour sur 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 communes de 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 )
  • Laisser le champ Host 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ée dont chacun peut avoir besoin. Ces informations sont tenues à jour autant que possible, mais reportez-vous à la documentation de votre fournisseur de domaine pour des instructions détaillées.

Description de l'état de la configuration pour les domaines personnalisés

Statut La description
Besoin de 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 vers les serveurs Firebase Hosting.
    Conseil de dépannage: si cela fait plus de 24 heures, vérifiez que vous avez pointé 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 l'autorité de certification Let's Encrypt est autorisée à 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) 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 trop de sous-domaines.
    Conseil de dépannage: En règle générale, Firebase Hosting recommande de ne pas dépasser 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 dispose d'un certificat SSL.
Vous pouvez diffuser le contenu de votre site.

Nécessite une nouvelle 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 vérification initiale 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 seul 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 des certificats SSL pour votre site.
  • La personne qui a prouvé la propriété du domaine a été supprimée en tant que membre de votre projet Firebase.
Conseil de dépannage: visitez la page d'hébergement de votre projet pour terminer le processus de revérification dans la fenêtre de temps spécifiée (généralement 30 jours) afin d'éviter que votre domaine personnalisé ne soit automatiquement déconnecté de Firebase Hosting.