Collega un dominio personalizzato

Non devi rinunciare ai tuoi nomi di dominio univoci incentrati sul brand per le app di cui è stato eseguito il deployment su Firebase App Hosting. 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 rimanente di questo documento illustra la procedura per collegare un dominio personalizzato in uno dei seguenti modi:

• Eseguire la migrazione di un dominio
• Collegare un nuovo dominio

Per evitare interruzioni del servizio, i record DNS devono essere aggiornati in un ordine specifico. Segui le istruzioni per eseguire la migrazione di un dominio in modo da evitare i tempi di inattività della tua app.

Se i tempi di inattività non sono un problema, ad esempio quando colleghi un dominio nuovo alla tua app web, segui le istruzioni per collegare un nuovo dominio.

Nota: questa guida presuppone che tu abbia completato le attività di App Hosting configurazione di base in modo da avere un backend Firebase App Hosting nel tuo progetto Firebase. Abbiamo fornito alcune informazioni di base sui tipi di record e sugli input comuni di fornitori popolari per riferimento futuro, ma assicurati di consultare la documentazione del tuo fornitore di dominio per istruzioni dettagliate sulla configurazione lato fornitore.

Prima di iniziare: tipi di record DNS

La procedura guidata App Hosting Configura dominio potrebbe chiederti di aggiungere o rimuovere da 1 a 5 record DNS, a seconda della configurazione corrente del dominio. Il tipo di un record ne determina la 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 ti consente di utilizzare un formato specifico di record TXT, fah-claim=[UUID], per indicare quale dominio personalizzato deve essere pubblicato sul tuo dominio.	No
Accesso sensibile al contesto	Questi record fungono da lista consentita per specificare le autorità di certificazione autorizzate a emettere certificati SSL per il tuo dominio. App Hosting richiede i record CAA solo se non è altrimenti possibile coniare certificati per il tuo dominio.	No

Prima di iniziare: il tuo nome di dominio personalizzato

Quando aggiungi o modifichi i record DNS, i diversi provider di dominio ti richiedono di inserire input diversi per il campo Host (o nome host) nei loro siti di gestione DNS. La procedura guidata per i domini personalizzati App Hosting richiede di inserire lo stesso valore nel campo Nome.

Di seguito abbiamo raccolto gli input comuni di fornitori molto utilizzati. Per istruzioni dettagliate, consulta la documentazione del fornitore del tuo dominio.

Tipo di dominio	Nome dominio personalizzato
Dominio Apex	Gli input più comuni includono: @ Il nome di dominio di primo livello (ad es. 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 domini comuni

Di seguito sono riportati alcuni fornitori di domini 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.

Cloudflare

Organizzatore	Input
example.com.	@
www.example.com.	www

Google Cloud DNS

Organizzatore	Input
example.com.	.example.com.
www.example.com.	www.example.com.

NameCheap

Organizzatore	Input
example.com.	@
www.example.com.	www

Squarespace

Organizzatore	Input
example.com.	@
www.example.com.	www

Eseguire la migrazione di un dominio

Se vuoi trasferire il tuo dominio da un altro provider a App Hosting senza tempi di riposo, puoi utilizzare il flusso Esegui la migrazione di un dominio nella console Firebase. Questo flusso ti guida attraverso una procedura in due passaggi che prepara App Hosting a pubblicare contenuti sul tuo dominio prima di indirizzare il traffico ai server App Hosting.

Passaggio 1: aggiungi il dominio personalizzato

1. Apri la App Hosting pagina 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 con la configurazione per configurare i record DNS e completare la configurazione del dominio personalizzato.

Passaggio 2: prepara il dominio

1. Seleziona la scheda Esegui la migrazione di un dominio della procedura guidata Configura dominio.
2. Segui le istruzioni del primo passaggio, Prepara il dominio, che include l'insieme di modifiche necessarie per consentire a App Hosting di eseguire il servizio del backend preferito e stabilire connessioni TLS sicure per il tuo dominio. Aggiungi, rimuovi e salva i record del tuo dominio nel tuo provider DNS con i seguenti input per i record richiesti:
   • Nome: inserisci il nome di dominio personalizzato per i record. L'host che indichi è il dominio su cui vuoi pubblicare i contenuti. Questo dominio può essere un dominio principale o un sottodominio. Il tuo provider di dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio"
   • Tipo di record: aggiungi il record DNS fornito.
   • Valore: assegna il valore fornito ai record. Il fornitore del tuo dominio potrebbe indicare questo termine come "Dati", "Indica", "Contenuti", "Indirizzo" o "Indirizzo IP". I contenuti del campo del valore variano in base al tipo di record. I record A e AAAA hanno indirizzi IP come valori, mentre i record TXT sono stringhe.
3. Seleziona Verifica record. App Hosting tenterà di rilevare le modifiche apportate nel tuo provider di dominio. La propagazione delle modifiche può richiedere fino a 24 ore. Puoi controllare lo stato nella visualizzazione Impostazioni > Domini nella dashboard di backend.

Passaggio 3: indirizza a App Hosting

1. Dopo che App Hosting ha verificato gli aggiornamenti dei record del passaggio precedente, la procedura guidata passa al passaggio finale Vai a App Hosting. Questo passaggio mostra gli aggiornamenti dei record da apportare per indirizzare il traffico del tuo dominio ai server App Hosting. Come prima, aggiungi, rimuovi e salva i record del tuo dominio nel tuo provider DNS con i seguenti input per i record richiesti:
   • Nome: inserisci il nome di dominio personalizzato per i record. L'host che indichi è il dominio su cui vuoi pubblicare i contenuti. Questo dominio può essere un dominio principale o un sottodominio. Il tuo provider di dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio"
   • Tipo di record: aggiungi il record DNS fornito.
   • Valore: assegna il valore fornito ai record. Il fornitore del tuo dominio potrebbe indicare questo termine come "Dati", "Indica", "Contenuti", "Indirizzo" o "Indirizzo IP". I contenuti del campo del valore variano in base al tipo di record. I record A e AAAA hanno indirizzi IP come valori, mentre i record TXT sono stringhe.
2. Seleziona Verifica record. App Hosting tenterà di rilevare le modifiche apportate nel tuo provider di dominio. La propagazione delle modifiche può richiedere fino a 24 ore. Puoi controllare lo stato nella visualizzazione Impostazioni > Domini nella dashboard di backend.

Importante: assicurati di rimuovere eventuali record A o CNAME che rimandano ad altri fornitori. Se uno di questi tipi di record è presente, Firebase non può eseguire il provisioning di un certificato SSL.

Collegare un nuovo dominio

Se i tempi di inattività non sono un problema, ad esempio quando colleghi un dominio nuovo alla tua app web, segui le istruzioni riportate in questa sezione.

Passaggio 1: aggiungi il dominio personalizzato

1. Apri la App Hosting pagina 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 con la configurazione per configurare i record DNS e completare la configurazione del dominio personalizzato.

Passaggio 2: verifica i record DNS

1. La procedura guidata Configura dominio della Console Firebase mostra i record necessari da aggiornare per indirizzare la tua pagina a Firebase App Hosting. Aggiungi, rimuovi e salva i record del tuo dominio nel tuo provider DNS con i seguenti input:
   • Nome: inserisci il nome di dominio personalizzato per i record. L'host che indichi è il dominio su cui vuoi pubblicare i contenuti. Questo dominio può essere un dominio principale o un sottodominio. Il tuo provider di dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio"
   • Tipo di record: aggiungi il record DNS fornito.
   • Valore: assegna il valore fornito ai record. Il fornitore del tuo dominio potrebbe indicare questo termine come "Dati", "Indica", "Contenuti", "Indirizzo" o "Indirizzo IP". I contenuti del campo del valore variano in base al tipo di record. I record A e AAAA hanno indirizzi IP come valori, mentre i record TXT sono stringhe.
2. Seleziona Verifica record. App Hosting tenterà di rilevare le modifiche apportate nel tuo provider di dominio. La propagazione delle modifiche può richiedere fino a 24 ore. Puoi controllare lo stato nella visualizzazione Impostazioni > Domini nella dashboard di backend.

Importante: assicurati di rimuovere eventuali record A o CNAME che rimandano ad altri fornitori. Se uno di questi tipi di record è presente, Firebase non può eseguire il provisioning di un certificato SSL.

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 impostato 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 dominio. Si tratta di una parte normale della procedura e verrà risolta quando il certificato del tuo dominio sarà disponibile.

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

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, verifica 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.