Aggiungere un dominio personalizzato al servizio Frontdoor di Azure

Si applica a: ✔️ Frontdoor (versione classica)

Important

Frontdoor di Azure (versione classica) non supporta la creazione del profilo, il nuovo onboarding del dominio o i certificati gestiti e verrà ritirato il 31 marzo 2027. Per evitare interruzioni del servizio, migrate per Frontdoor di Azure Standard o Premium. Per altre informazioni, vedere Frontdoor di Azure (versione classica) ritiro.

Questo articolo illustra come aggiungere un dominio personalizzato alla frontdoor. Quando si usa Frontdoor di Azure per il recapito delle applicazioni, è necessario un dominio personalizzato se si vuole che il proprio nome di dominio sia visibile nella richiesta dell'utente finale. Avere un nome di dominio visibile può essere pratico per i clienti e utile a scopo di personalizzazione.

Dopo aver creato un profilo frontdoor, l'host front-end predefinito è un sottodominio di azurefd.net. Questo nome è incluso nell'URL per la distribuzione del contenuto di Frontdoor al back-end per impostazione predefinita. Ad esempio: https://contoso-frontend.azurefd.net. Per praticità, Frontdoor di Azure offre la possibilità di associare un dominio personalizzato all'endpoint. Con questa funzionalità, è possibile distribuire il contenuto con l'URL anziché il nome di dominio predefinito di Frontdoor, ad esempio https://www.contoso.com/photo.png.

Se non si ha un account Azure, creare un account gratuito prima di iniziare.

Note

Il servizio Frontdoor non supporta i domini personalizzati con il sistema di codifica Punycode.

Prerequisites

Creare un record DNS CNAME

Prima di poter usare un dominio personalizzato con Frontdoor, è prima necessario creare un record CNAME (Canonical Name) con il provider di dominio per puntare all'host front-end predefinito di Frontdoor. Un record CNAME è un tipo di record DNS che esegue il mapping di un nome di dominio di origine a uno di destinazione. In Frontdoor di Azure il nome di dominio di origine è il nome di dominio personalizzato e il nome di dominio di destinazione è il nome host predefinito di Frontdoor. Dopo che Front Door verifica che il record CNAME sia stato creato, il traffico verso il dominio personalizzato di origine viene instradato all'host front-end predefinito di destinazione specificato di Front Door.

Un dominio personalizzato può essere associato solo a un profilo frontdoor alla volta. Tuttavia, è possibile avere sottodomini diversi di un dominio apex nello stesso profilo o in un profilo di Front Door diverso.

Mappare il sottodominio temporaneo afdverify

Quando si esegue il mapping di un dominio esistente in produzione, considerare l'impatto. Durante la registrazione del dominio personalizzato nella portale di Azure, potrebbe verificarsi un breve periodo di inattività per il dominio. Per evitare interruzioni del traffico Web, eseguire prima il mapping del dominio personalizzato all'host front-end predefinito di Frontdoor usando il sottodominio afdverify Azure per creare un mapping CNAME temporaneo. Gli utenti possono accedere al dominio senza interruzioni quando si verifica il mapping DNS.

Se si utilizza per la prima volta il dominio personalizzato senza traffico di produzione, è possibile mappare direttamente il dominio personalizzato al Front Door. È possibile passare direttamente a Mappatura del dominio personalizzato permanente.

Per creare un record CNAME usando il sottodominio afdverify:

  1. Accedere al sito Web del provider di dominio per il dominio personalizzato.

  2. Trovare la pagina per la gestione dei record DNS consultando la documentazione del provider o cercando aree del sito Web con l'etichetta Nome di dominio, DNS o Gestione del server dei nomi.

  3. Creare una voce di record CNAME per il dominio personalizzato e compilare i campi come illustrato nella tabella seguente (i nomi dei campi potrebbero variare):

    Source Type Destination
    afdverify.www.contoso.com CNAME afdverify.contoso-frontend.azurefd.net

    • Fonte: Immettere il nome di dominio personalizzato, incluso il afdverify sottodominio, nel formato seguente: afdverify.<custom domain name>. Ad esempio: afdverify.www.contoso.com. Se esegui il mapping di un dominio con un carattere jolly, ad esempio *.contoso.com, il valore di origine è uguale a quello che sarebbe senza il carattere jolly: afdverify.contoso.com.

    • Digitare: Immettere CNAME.

    • Destinazione: Immettere l'host front-end predefinito di Frontdoor, incluso il sottodominio afdverify, nel formato seguente: afdverify.<endpoint name>.azurefd.net. Ad esempio: afdverify.contoso-frontend.azurefd.net.

  4. Salva le modifiche.

La procedura per il registrar GoDaddy, ad esempio, è la seguente:

  1. Accedi e seleziona il dominio personalizzato che desideri utilizzare.

  2. Nella sezione Domini selezionare Gestisci tutto e quindi selezionare DNS | Gestisci zone.

  3. Per Nome di dominio immettere il dominio personalizzato e quindi selezionare Cerca.

  4. Nella pagina Gestione DNS selezionare Aggiungi e quindi selezionare CNAME nell'elenco Tipo .

  5. Completare i campi seguenti della voce CNAME:

    • Type (Tipo): lasciare selezionato CNAME.

    • Host: immettere il sottodominio del dominio personalizzato da usare, incluso il nome del sottodominio afdverify. Ad esempio: afdverify.www.

    • Punta a: immettere il nome host dell'host di front-end predefinito di Front Door, incluso il nome di sottodominio afdverify. Ad esempio: afdverify.contoso-frontend.azurefd.net.

    • TTL: lasciare selezionata un'ora.

  6. Seleziona Salva.

    La voce CNAME viene aggiunta alla tabella di record DNS.

Associare il dominio personalizzato al proprio Front Door.

Dopo aver registrato il dominio personalizzato, aggiungilo a Front Door.

  1. Accedere al portale di Azure e passare alla frontdoor contenente l'host di front-end di cui si vuole eseguire il mapping a un dominio personalizzato.

  2. Nella pagina della finestra di progettazione di Frontdoor selezionare + per aggiungere un dominio personalizzato.

  3. Specificare un dominio personalizzato.

  4. Per host Frontend, l'host Frontend da utilizzare come dominio di destinazione del record CNAME è predeterminato ed è derivato dal tuo Front Door: nome host predefinito.azurefd.net. Non è possibile modificarlo.

  5. Per Nome host personalizzato, immettere il dominio personalizzato, incluso il sottodominio, da usare come dominio di origine del record CNAME. Ad esempio: www.contoso.com o cdn.contoso.com. Non usare il nome del sottodominio afdverify.

  6. Seleziona Aggiungi.

    Azure verifica l'esistenza del record CNAME per il nome di dominio personalizzato immesso. Se il record CNAME è corretto, il dominio personalizzato viene convalidato.

Warning

È necessario assicurarsi che a ogni host front-end (inclusi domini personalizzati) in Frontdoor sia associata una regola di routing con un percorso predefinito ('/*'). Ovvero, in tutte le regole di routing deve essere presente almeno una regola di routing per ognuno degli host front-end definiti nel percorso predefinito ('/*'). Se non si configura questa impostazione, il traffico dell'utente finale potrebbe non essere instradato correttamente.

Verificare il dominio personalizzato

Dopo aver completato la registrazione del dominio personalizzato, verificare che il dominio personalizzato faccia riferimento all'host front-end predefinito di Frontdoor.

Nel browser passare all'indirizzo del file usando il dominio personalizzato. Ad esempio, se il dominio personalizzato è robotics.contoso.com, l'URL del file memorizzato nella cache dovrebbe essere simile all'URL seguente: http://robotics.contoso.com/my-public-container/my-file.jpg. Verificare che il risultato sia uguale a quando si accede direttamente al <Front Door host>.azurefd.net.

Mappare il dominio permanente personalizzato

Per eseguire il mapping del dominio personalizzato direttamente al tuo host front-end Front Door predefinito, assicurarsi innanzitutto che il sottodominio afdverify sia mappato correttamente a Front Door. Dopo la verifica, è possibile procedere con il mapping del dominio personalizzato.

Per creare un record CNAME per il dominio personalizzato:

  1. Accedere al sito Web del provider di dominio per il dominio personalizzato.

  2. Trovare la pagina per la gestione dei record DNS consultando la documentazione del provider o cercando le aree del sito Web con l'etichetta Domain Name, DNS o Name Server Management.

  3. Creare una voce di record CNAME per il dominio personalizzato e compilare i campi come illustrato nella tabella seguente (i nomi dei campi potrebbero variare):

    Source Type Destination
    <www.contoso.com> CNAME contoso-frontend.azurefd.net

    • Origine: immettere il nome di dominio personalizzato (ad esempio, www.contoso.com).

    • Tipo: immettere CNAME.

    • Destinazione: inserisci l'host front-end di Front Door predefinito. Deve essere nel formato seguente:<nome host>.azurefd.net. Ad esempio, contoso-frontend.azurefd.net.

  4. Salva le modifiche.

  5. Se in precedenza è stato creato un record CNAME di sottodominio afdverify temporaneo, eliminarlo.

  6. Se si usa questo dominio personalizzato nell'ambiente di produzione per la prima volta, seguire i passaggi per Associare il dominio personalizzato a Frontdoor e Verificare il dominio personalizzato.

La procedura per il registrar GoDaddy, ad esempio, è la seguente:

  1. Accedi e seleziona il dominio personalizzato che desideri utilizzare.

  2. Nella sezione Domini selezionare Gestisci tutto e quindi selezionare DNS | Gestisci zone.

  3. Per Nome di dominio immettere il dominio personalizzato e quindi selezionare Cerca.

  4. Nella pagina Gestione DNS selezionare Aggiungi e quindi selezionare CNAME nell'elenco Tipo .

  5. Completare i campi della voce CNAME:

    • Type (Tipo): lasciare selezionato CNAME.

    • Host: immettere il sottodominio del dominio personalizzato da usare. Ad esempio, www o profilo.

    • Indica: immettere il nome host predefinito di Front Door. Ad esempio, contoso.azurefd.net.

    • TTL: lasciare selezionata un'ora.

  6. Seleziona Salva.

    La voce CNAME viene aggiunta alla tabella di record DNS.

  7. Se si dispone di un record CNAME afdverify, selezionare l'icona a forma di matita accanto e quindi selezionare l'icona del cestino.

  8. Selezionare Delete (Elimina) per eliminare il record CNAME.

Pulire le risorse

Nei passaggi precedenti è stato aggiunto un dominio personalizzato a un Front Door. Se non si vuole più associare Frontdoor a un dominio personalizzato, rimuovere il dominio personalizzato seguendo questa procedura:

  1. Passare al provider DNS ed eliminare il record CNAME per il dominio personalizzato o aggiornare il record CNAME per il dominio personalizzato a un endpoint non Frontdoor.

    Important

    Per evitare voci DNS dangling e i rischi per la sicurezza creati, a partire dal 9 aprile 2021, Frontdoor di Azure richiede la rimozione dei record CNAME negli endpoint di Frontdoor prima di poter eliminare le risorse. Le risorse includono domini personalizzati di Front Door, endpoint di Front Door, o gruppi di risorse di Azure che hanno domini personalizzati di Front Door abilitati.

  2. Nella finestra di progettazione della frontdoor, selezionare il dominio personalizzato che si vuole rimuovere.

  3. Selezionare Elimina dal menu di scelta rapida per il dominio personalizzato. Il dominio personalizzato viene rimosso dall'endpoint.

Passo successivo

Abilitare HTTPS per un dominio personalizzato

  • Last updated on