Collega un dominio personalizzato

Per le app di cui è stato eseguito il deployment su Firebase App Hosting, non devi rinunciare ai tuoi nomi di dominio univoci e incentrati sul brand. Puoi utilizzare un dominio personalizzato (ad esempio example.com o app.example.com) anziché un dominio generato da Firebase per il tuo sito ospitato su Firebase. Firebase App Hosting esegue il provisioning di un certificato SSL per ciascuno dei tuoi domini.

La parte restante di questo documento illustra i passaggi per collegare un dominio personalizzato.

Configura il dominio per App Hosting

Assicurati di aver completato le attività di App Hosting configurazione di base in modo da avere un sito Firebase App Hosting nel tuo progetto Firebase.

Passaggio 1: aggiungi il dominio personalizzato

  1. Apri la pagina App Hosting del progetto.
  2. Seleziona un backend App Hosting utilizzando l'opzione Visualizza dashboard.
  3. Seleziona la scheda Impostazioni e poi fai clic su Aggiungi dominio personalizzato.
  4. Inserisci il nome di dominio personalizzato che vuoi collegare al tuo sito App Hosting.
  5. (Facoltativo) Seleziona la casella per reindirizzare tutte le richieste sul dominio personalizzato a un secondo dominio specificato (in modo che example.com e www.example.com reindirizzino agli stessi contenuti).
  6. Fai clic su Continua per configurare i record DNS e completare la configurazione del tuo dominio personalizzato.

Passaggio 2: configura il dominio personalizzato

  1. La procedura guidata Aggiungi dominio personalizzato della console Firebase mostra i record necessari da aggiornare per indirizzare la tua pagina a Firebase App Hosting. Aggiungi, rimuovi e salva record del tuo dominio nel tuo provider DNS con i seguenti input:

    • Tipo: aggiungi il record DNS fornito.

    • Host: inserisci la chiave del dominio personalizzato per i record. L'host indicato è il dominio in cui vuoi pubblicare i contenuti. Può essere un dominio Apex o un sottodominio. Il fornitore del tuo dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio".

    • Valore: assegna il valore fornito ai record. Il fornitore del tuo dominio potrebbe indicare questo termine come "Dati", "Punti a", "Contenuti", "Indirizzo" o "Indirizzo IP". Il contenuto del campo del valore varia in base al tipo di record: i record A e AAAA hanno indirizzi IP come valori, mentre i record TXT sono stringhe.

Attendi il provisioning del certificato SSL. In genere, questa operazione richiede alcune ore, ma a volte possono essere necessarie fino a 24 ore dopo aver impostato il DNS su Firebase App Hosting. Nella maggior parte dei casi, la propagazione dei record e il provisioning del certificato SSL avvengono entro un'ora, a seconda del provider del dominio.

Attendi il provisioning del certificato SSL

App Hosting può richiedere fino a qualche ora per eseguire il provisioning di un certificato SSL per il tuo dominio dopo l'aggiornamento dei record DNS. In alcuni casi, potrebbero essere necessarie fino a 24 ore dopo aver puntato il DNS su Firebase App Hosting.

Puoi visualizzare questo certificato utilizzando gli strumenti di sicurezza del browser. Durante il provisioning del dominio, potresti visualizzare un certificato non valido o avere problemi di connessione al tuo dominio. Si tratta di una parte normale del processo e verrà risolta quando il certificato del tuo dominio sarà disponibile.

Nota:Firebase App Hosting esegue automaticamente il provisioning dei certificati SSL, se necessario, per i domini personalizzati.

Tipi di record DNS

La procedura guidata App Hosting Dominio personalizzato potrebbe chiederti di aggiungere da 1 a 5 record DNS, a seconda della configurazione attuale del tuo dominio. Il tipo di un record determina la sua funzione. Di seguito sono riportati i tipi di record che App Hosting potrebbe richiedere:

Tipo Descrizione Esclusiva
A Questi record contengono valori IPv4 (ad es. 8.8.8.8), che indicano ai browser quale indirizzo utilizzare quando tentano di contattare il tuo dominio. Sì
AAAA Questi record contengono valori IPv6 (ad es. 2001:4860:4860::8888), un tipo diverso di record di indirizzo con la stessa funzione dei record A. Al momento App Hosting non utilizza record AAAA, ma ti chiederà di rimuovere quelli esistenti dal nostro dominio, se presenti. Sì
CNAME Questi record contengono un nome di dominio separato che deve essere utilizzato al posto del tuo dominio attuale per risolvere le query DNS. I record CNAME sono consentiti solo nei sottodomini (ad es. www.example.com). App Hosting utilizza i record CNAME per due motivi:
  • Onboarding facile: se possibile, App Hosting ti chiede di eseguire il CNAME a un dominio preconfigurato che inizia con _custom-domain....
  • Verifica del certificato SSL: App Hosting utilizza Cloud Certificate Manager per eseguire il provisioning dei certificati SSL per il tuo dominio personalizzato. Un record CNAME su un sottodominio _acme-challenge... consente a Certificate Manager di creare e rinnovare i certificati per te. Dopo l'onboarding, questo record non deve essere rimosso, altrimenti la copertura del certificato scadrà.
 Sì
TXT Questi record ti consentono di associare metadati arbitrari al tuo dominio. App Hosting consente di utilizzare un formato specifico del record TXT, fah-claim=[UUID], per indicare il dominio personalizzato da pubblicare nel tuo dominio. No
Accesso sensibile al contesto Questi record funzionano come una lista consentita per specificare le autorità di certificazione autorizzate a generare certificati SSL per il tuo dominio. App Hosting richiede i record CAA solo se non è altrimenti possibile creare certificati per il tuo dominio. No

La chiave del tuo dominio personalizzato

Quando aggiungi o modifichi i record DNS, diversi provider di dominio prevedono che tu inserisca input diversi per il campo Host nei rispettivi siti di gestione DNS. Abbiamo raccolto alcuni input comuni dai fornitori più noti qui sotto. Fai riferimento alla documentazione del tuo provider di dominio per istruzioni dettagliate.

Tipo di dominio Chiave del dominio personalizzato
Dominio Apex

Gli input comuni includono:

  • @
  • Il nome di dominio di primo livello (ad esempio example.com)
  • Lasciare vuoto il campo Host
Sottodominio

Gli input più comuni includono:

  • Il nome completo del sottodominio (ad esempio app.example.com)
  • Solo la parte del sottodominio (ad esempio solo app, senza .example.com)

Provider di dominio comuni

Di seguito sono riportati alcuni fornitori di dominio comuni e i tipi di input che potrebbero richiedere. Queste informazioni vengono mantenute aggiornate il più possibile, ma consulta la documentazione del fornitore del tuo dominio per istruzioni dettagliate.

Descrizioni dello stato per i domini personalizzati

Stato Descrizione
Richiede la configurazione

Potrebbe essere necessario modificare una configurazione dei record DNS.

  • Nella maggior parte dei casi, i record DNS A non sono stati propagati dal provider del nome di dominio ai server Firebase App Hosting.
    Suggerimento per la risoluzione dei problemi: se sono trascorse più di 24 ore, controlla di aver indirizzato i tuoi record a Firebase App Hosting.

  • In rari casi, le verifiche SSL potrebbero non riuscire perché i tuoi record DNS contengono record A o CNAME che rimandano ad altri provider di hosting.
    Suggerimento per la risoluzione dei problemi: verifica che i record A rimandino solo a Firebase App Hosting e rimuovi tutti i record CNAME.
In attesa

Hai configurato correttamente il tuo dominio personalizzato, ma Firebase App Hosting non ha eseguito il provisioning di un certificato SSL.

A volte, i record CAA eccessivamente restrittivi possono bloccare la creazione di un certificato SSL per un dominio personalizzato. Assicurati che le autorità di certificazione "letsencrypt.org" e "pki.goog" siano autorizzate a creare certificati SSL per il tuo dominio.
Minting Certificate

È in corso la produzione di un certificato SSL per il tuo dominio.
Connesso

Il tuo dominio personalizzato dispone dei record DNS corretti e di un certificato SSL.
Puoi pubblicare i contenuti del tuo sito.