Aggiungere un dominio personalizzato al servizio Frontdoor di Azure

Importante

Frontdoor di Azure (classico) verrà ritirato il 31 marzo 2027. Per evitare interruzioni del servizio, è importante eseguire la migrazione dei profili di Frontdoor di Azure (classico) al livello Standard o Premium di Frontdoor di Azure entro marzo 2027. Per altre informazioni, vedere Ritiro di Frontdoor di Azure (classico).

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 una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

Nota

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

Prerequisiti

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 Frontdoor verifica che il record CNAME venga creato, il traffico verso il dominio personalizzato di origine viene instradato all'host front-end predefinito di Frontdoor di destinazione specificato.

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 frontdoor diverso.

Eseguire il mapping del sottodominio afdverify temporaneo

Quando si esegue il mapping di un dominio esistente che si trova nell'ambiente di produzione, è necessario considerare alcuni aspetti.When you map an existing domain that is in production, there are things consider. 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 con il sottodominio afdverify di Azure per creare un mapping CNAME temporaneo. Gli utenti possono accedere al dominio senza interruzioni quando si verifica il mapping DNS.

Se si usa il dominio personalizzato per la prima volta senza traffico di produzione, è possibile eseguire direttamente il mapping del dominio personalizzato alla frontdoor. È possibile passare direttamente a Eseguire il mapping del dominio personalizzato permanente.

Per creare un record CNAME con il sottodominio afdverify:

  1. Accedere al sito Web del provider del dominio personalizzato.

  2. Cercare la pagina per la gestione dei record DNS facendo riferimento alla documentazione del provider oppure eseguendo una ricerca delle aree del sito Web con etichetta come Nome del dominio, DNS o Gestione dei server dei nomi.

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

    Origine Type Destinazione
    afdverify.www.contoso.com CNAME afdverify.contoso-frontend.azurefd.net
    • Origine: immettere il nome di dominio personalizzato, incluso il sottodominio afdverify, nel formato seguente: afdverify.<nome di dominio personalizzato>. Ad esempio, afdverify.www.contoso.com. Se si esegue il mapping di un dominio con caratteri jolly, ad esempio *.contoso.com, il valore di origine è uguale a quello di senza il carattere jolly: afdverify.contoso.com.

    • Tipo: immettere CNAME.

    • Destinazione: immettere l'host di frontend della frontdoor predefinito, incluso il sottodominio afdverify, nel seguente formato: afdverify.<nome endpoint>.azurefd.net. Ad esempio, afdverify.contoso-frontend.azurefd.net.

  4. Salva le modifiche.

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

  1. Accedere al dominio personalizzato da usare e selezionarlo.

  2. Nella sezione Domains (Domini) selezionare Manage All (Gestisci tutto), quindi selezionare DNS | Manage Zones (DNS | Gestisci zone).

  3. In Domain Name (Nome di dominio) immettere il proprio nome di dominio, quindi selezionare Search (Cerca).

  4. Nella pagina DNS Management (Gestione DNS) selezionare Add (Aggiungi), quindi selezionare CNAME nell'elenco Type (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 della frontdoor predefinito, 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 alla propria frontdoor

Dopo aver registrato il dominio personalizzato, è possibile aggiungerlo alla frontdoor.

  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 l'host front-end, l'host front-end da usare come dominio di destinazione del record CNAME è predeterminato ed è derivato da Frontdoor: <nome> host predefinito.azurefd.net. Questo valore non può essere modificato.

  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. Selezionare Aggiungi.

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

Avviso

È 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 ('/*'). In caso contrario, è possibile che il traffico degli utenti finali non venga instradato in modo corretto.

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 è lo stesso come quando si accede alla frontdoor direttamente alla <frontdoor host>.azurefd.net.

Eseguire il mapping del dominio personalizzato permanente

Per procedere con il mapping del dominio personalizzato direttamente all'host front-end frontdoor predefinito, è necessario assicurarsi che il sottodominio afdverify sia stato mappato correttamente alla frontdoor. 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 del dominio personalizzato.

  2. Cercare la pagina per la gestione dei record DNS facendo riferimento alla documentazione del provider oppure eseguendo una ricerca delle aree del sito Web con etichetta come Nome del dominio, DNS o Gestione dei server dei nomi.

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

    Origine Type Destinazione
    <www.contoso.com> CNAME contoso-frontend.azurefd.net
    • Origine: immettere il nome di dominio personalizzato (ad esempio, www.contoso.com).

    • Tipo: immettere CNAME.

    • Destinazione: immettere l'host di front-end della frontdoor 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. Accedere al dominio personalizzato da usare e selezionarlo.

  2. Nella sezione Domains (Domini) selezionare Manage All (Gestisci tutto), quindi selezionare DNS | Manage Zones (DNS | Gestisci zone).

  3. In Domain Name (Nome di dominio) immettere il proprio nome di dominio, quindi selezionare Search (Cerca).

  4. Nella pagina DNS Management (Gestione DNS) selezionare Add (Aggiungi), quindi selezionare CNAME nell'elenco Type (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 il profilo.

    • Punta a: immettere il nome host predefinito della frontdoor. 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 ha un record CNAME afdverify, selezionare l'icona a forma di matita accanto a esso, 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 una frontdoor. Se non si vuole più associare Frontdoor a un dominio personalizzato, è possibile rimuovere il dominio personalizzato seguendo questa procedura:

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

    Importante

    Per evitare voci DNS incerte e i rischi per la sicurezza creati, a partire dal 9 aprile 2021, Frontdoor di Azure richiede la rimozione dei record CNAME negli endpoint frontdoor prima che le risorse possano essere eliminate. Le risorse includono domini personalizzati di Frontdoor, endpoint frontdoor o gruppi di risorse di Azure con domini personalizzati di Frontdoor 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.

Passaggi successivi

Questa esercitazione ha descritto come:

  • Creare un record DNS CNAME.
  • Associare il dominio personalizzato alla propria frontdoor.
  • Verificare il dominio personalizzato.

Per informazioni su come abilitare HTTPS per il dominio personalizzato, continuare con l'esercitazione successiva.