Esercitazione: Aggiungere un dominio personalizzato all'endpoint della rete CDN di AzureTutorial: Add a custom domain to your Azure CDN endpoint

Questa esercitazione illustra come aggiungere un dominio personalizzato a un endpoint della rete CDN di Azure.This tutorial shows how to add a custom domain to an Azure Content Delivery Network (CDN) endpoint. Quando si usa un endpoint della rete CDN per distribuire il contenuto, è necessario un dominio personalizzato se si vuole che il nome di dominio sia visibile nell'URL della rete CDN.When you use a CDN endpoint to deliver content, a custom domain is necessary if you would like your own domain name to be visible in your CDN URL. Avere un nome di dominio visibile può essere pratico per i clienti e utile a scopo di personalizzazione.Having a visible domain name can be convenient for your customers and useful for branding purposes.

Dopo avere creato un endpoint della rete CDN nel profilo, il nome dell'endpoint, corrispondente a un sottodominio di azureedge.net, viene incluso nell'URL per la distribuzione del contenuto CDN per impostazione predefinita (ad esempio, https://contoso.azureedge.net/photo.png).After you create a CDN endpoint in your profile, the endpoint name, which is a subdomain of azureedge.net, is included in the URL for delivering CDN content by default (for example, https://contoso.azureedge.net/photo.png). Per comodità, la rete CDN di Azure offre la possibilità di associare un dominio personalizzato a un endpoint della rete CDN.For your convenience, Azure CDN provides the option of associating a custom domain with a CDN endpoint. Grazie a questa possibilità, si distribuisce il contenuto con un dominio personalizzato nell'URL invece che con un nome di endpoint (ad esempio, https://www.contoso.com/photo.png).With this option, you deliver your content with a custom domain in your URL instead of an endpoint name (for example, https://www.contoso.com/photo.png).

In questa esercitazione si apprenderà come:In this tutorial, you learn how to:

  • Creare un record DNS CNAME.Create a CNAME DNS record.
  • Associare il dominio personalizzato all'endpoint della rete CDN.Associate the custom domain with your CDN endpoint.
  • Verificare il dominio personalizzato.Verify the custom domain.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

prerequisitiPrerequisites

Prima di poter completare i passaggi di questa esercitazione, è necessario creare un profilo della rete CDN e almeno un endpoint della rete CDN.Before you can complete the steps in this tutorial, you must first create a CDN profile and at least one CDN endpoint. Per altre informazioni, vedere Guida introduttiva: Creare un profilo e un endpoint della rete CDN di Azure.For more information, see Quickstart: Create an Azure CDN profile and endpoint.

Se non si dispone già di un dominio personalizzato, è prima necessario acquistarne uno con un provider di dominio.If you do not already have a custom domain, you must first purchase one with a domain provider. Ad esempio, vedere Acquistare un nome di dominio personalizzato.For example, see Buy a custom domain name.

Se si usa Azure per ospitare i domini DNS, è necessario delegare il DNS (Domain Name System) del provider di dominio a un DNS di Azure.If you are using Azure to host your DNS domains, you must delegate the domain provider's domain name system (DNS) to an Azure DNS. Per altre informazioni, vedere Delegare un dominio a DNS di Azure.For more information, see Delegate a domain to Azure DNS. In caso contrario, se si usa un provider di dominio per gestire il dominio DNS, continuare con Creare un record DNS CNAME.Otherwise, if you are using a domain provider to handle your DNS domain, proceed to Create a CNAME DNS record.

Creare un record DNS CNAMECreate a CNAME DNS record

Prima di poter usare un dominio personalizzato con un endpoint della rete CDN di Azure, è necessario creare un record di nome canonico (CNAME) con il provider del dominio per puntare all'endpoint della rete CDN.Before you can use a custom domain with an Azure CDN endpoint, you must first create a canonical name (CNAME) record with your domain provider to point to your CDN endpoint. Un record CNAME è un tipo di record DNS che esegue il mapping di un nome di dominio di origine a uno di destinazione.A CNAME record is a type of DNS record that maps a source domain name to a destination domain name. Per la rete CDN di Azure il nome di dominio di origine è il nome di dominio personalizzato, mentre il nome di dominio di destinazione è il nome host dell'endpoint della rete CDN.For Azure CDN, the source domain name is your custom domain name and the destination domain name is your CDN endpoint hostname. Dopo che la rete CDN di Azure ha verificato il record CNAME creato, il traffico indirizzato al dominio personalizzato di origine (ad esempio, www.contoso.com) viene instradato al nome host dell'endpoint della rete CDN di destinazione specificato (ad esempio, contoso.azureedge.net).After Azure CDN verifies the CNAME record that you create, traffic addressed to the source custom domain (such as www.contoso.com) is routed to the specified destination CDN endpoint hostname (such as contoso.azureedge.net).

Un dominio personalizzato e il relativo sottodominio possono essere associati a un singolo endpoint alla volta.A custom domain and its subdomain can be associated with only a single endpoint at a time. È tuttavia possibile usare più sottodomini dello stesso dominio personalizzato per endpoint di servizio di Azure diversi usando più record CNAME.However, you can use different subdomains from the same custom domain for different Azure service endpoints by using multiple CNAME records. È anche possibile eseguire il mapping di un dominio personalizzato con sottodomini diversi allo stesso endpoint della rete CDN.You can also map a custom domain with different subdomains to the same CDN endpoint.

Eseguire il mapping del sottodominio cdnverify temporaneoMap the temporary cdnverify subdomain

Quando si esegue il mapping di un dominio esistente in fase di produzione, è necessario tenere presenti alcune considerazioni speciali.When you map an existing domain that is in production, there are special considerations. Mentre si sta registrando il dominio personalizzato nel portale di Azure, può verificarsi un breve tempo di inattività per il dominio.While you are registering your custom domain in the Azure portal, a brief period of downtime for the domain can occur. Per evitare l'interruzione del traffico Web, eseguire prima il mapping del dominio personalizzato al nome host dell'endpoint della rete CDN con il sottodominio cdnverify di Azure per creare un mapping CNAME temporaneo.To avoid interruption of web traffic, first map your custom domain to your CDN endpoint hostname with the Azure cdnverify subdomain to create a temporary CNAME mapping. Con questo metodo, gli utenti possono accedere al dominio senza interruzioni durante l'esecuzione del mapping DNS.With this method, users can access your domain without interruption while the DNS mapping occurs.

In caso contrario, se si usa per la prima volta il dominio personalizzato in cui non è in esecuzione traffico di produzione, è possibile eseguire il mapping diretto del dominio personalizzato all'endpoint della rete CDN.Otherwise, if you are using your custom domain for the first time and no production traffic is running on it, you can directly map your custom domain to your CDN endpoint. Continuare con Eseguire il mapping del dominio personalizzato permanente.Proceed to Map permanent custom domain.

Per creare un record CNAME con il sottodominio cdnverify:To create a CNAME record with the cdnverify subdomain:

  1. Accedere al sito Web del provider del dominio personalizzato.Log in to the web site of the domain provider for your custom domain.

  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.Find the page for managing DNS records by consulting the provider's documentation or searching for areas of the web site labeled Domain Name, DNS, or Name server management.

  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):Create a CNAME record entry for your custom domain and complete the fields as shown in the following table (field names may vary):

    SorgenteSource typeType DestinationDestination
    cdnverify.www.contoso.comcdnverify.www.contoso.com CNAMECNAME cdnverify.contoso.azureedge.netcdnverify.contoso.azureedge.net
    • Origine: immettere il nome di dominio personalizzato, incluso il sottodominio cdnverify, nel formato seguente: cdnverify.<nome di dominio personalizzato>.Source: Enter your custom domain name, including the cdnverify subdomain, in the following format: cdnverify.<custom domain name>. Ad esempio, cdnverify.www.contoso.com.For example, cdnverify.www.contoso.com.

    • Tipo: immettere CNAME.Type: Enter CNAME.

    • Destinazione: immettere il nome host dell'endpoint della rete CDN, incluso il sottodominio cdnverify, nel formato seguente: cdnverify.<nome endpoint>.azureedge.net.Destination: Enter your CDN endpoint hostname, including the cdnverify subdomain, in the following format: cdnverify.<endpoint name>.azureedge.net. Ad esempio, cdnverify.contoso.azureedge.net.For example, cdnverify.contoso.azureedge.net.

  4. Salvare le modifiche.Save your changes.

La procedura per il registrar GoDaddy, ad esempio, è la seguente:For example, the procedure for the GoDaddy domain registrar is as follows:

  1. Accedere al dominio personalizzato da usare e selezionarlo.Log in and select the custom domain you want to use.

  2. Nella sezione Domains (Domini) selezionare Manage All (Gestisci tutto), quindi selezionare DNS | Manage Zones (DNS | Gestisci zone).In the Domains section, select Manage All, then select DNS | Manage Zones.

  3. In Domain Name (Nome di dominio) immettere il proprio nome di dominio, quindi selezionare Search (Cerca).For Domain Name, enter your custom domain, then select Search.

  4. Nella pagina DNS Management (Gestione DNS) selezionare Add (Aggiungi), quindi selezionare CNAME nell'elenco Type (Tipo).From the DNS Management page, select Add, then select CNAME in the Type list.

  5. Completare i campi seguenti della voce CNAME:Complete the following fields of the CNAME entry:

    Voce CNAME

    • Type (Tipo): lasciare selezionato CNAME.Type: Leave CNAME selected.

    • Host: immettere il sottodominio del dominio personalizzato da usare, incluso il nome del sottodominio cdnverify.Host: Enter the subdomain of your custom domain to use, including the cdnverify subdomain name. Ad esempio, cdnverify.www.For example, cdnverify.www.

    • Points to (Punta a): immettere il nome host dell'endpoint della rete CDN, incluso il nome di sottodominio cdnverify.Points to: Enter the host name of your CDN endpoint, including the cdnverify subdomain name. Ad esempio, cdnverify.contoso.azureedge.net.For example, cdnverify.contoso.azureedge.net.

    • TTL: lasciare selezionato 1 Hour (1 ora).TTL: Leave 1 Hour selected.

  6. Selezionare Salva.Select Save.

    La voce CNAME viene aggiunta alla tabella di record DNS.The CNAME entry is added to the DNS records table.

    Tabella dei record DNS

Associare il dominio personalizzato all'endpoint della rete CDNAssociate the custom domain with your CDN endpoint

Dopo avere registrato il dominio personalizzato, è possibile aggiungerlo all'endpoint della rete CDN.After you've registered your custom domain, you can then add it to your CDN endpoint.

  1. Accedere al portale di Azure e passare al profilo della rete CDN contenente l'endpoint di cui si vuole eseguire il mapping a un dominio personalizzato.Log in to the Azure portal and browse to the CDN profile containing the endpoint that you want to map to a custom domain.

  2. Nella pagina Profilo CDN selezionare l'endpoint della rete CDN da associare al dominio personalizzato.On the CDN profile page, select the CDN endpoint to associate with the custom domain.

    Viene aperta la pagina Endpoint.The Endpoint page opens.

  3. Selezionare Dominio personalizzato.Select Custom domain.

    Pulsante Dominio personalizzato della rete CDN

    Viene aperta la pagina Aggiungi dominio personalizzato.The Add a custom domain page opens.

  4. Per Nome host dell'endpoint, il nome host dell'endpoint da usare come dominio di destinazione del record CNAME è precompilato e derivato dall'URL dell'endpoint della rete CDN: <nome host dell'endpoint>.azureedge.net.For Endpoint hostname, the endpoint host name to use as the destination domain of your CNAME record is prefilled and is derived from your CDN endpoint URL: <endpoint hostname>.azureedge.net. Non può essere modificato.It cannot be changed.

  5. Per Nome host personalizzato, immettere il dominio personalizzato, incluso il sottodominio, da usare come dominio di origine del record CNAME.For Custom hostname, enter your custom domain, including the subdomain, to use as the source domain of your CNAME record. Ad esempio, www.contoso.com o cdn.contoso.com.For example, www.contoso.com or cdn.contoso.com. Non usare il nome del sottodominio cdnverify.Do not use the cdnverify subdomain name.

    Finestra di dialogo del dominio personalizzato della rete CDN

  6. Selezionare Aggiungi.Select Add.

    Azure verifica l'esistenza del record CNAME per il nome di dominio personalizzato immesso.Azure verifies that the CNAME record exists for the custom domain name you entered. Se il record CNAME è corretto, il dominio personalizzato verrà convalidato.If the CNAME is correct, your custom domain will be validated.

    La propagazione delle impostazioni del nuovo dominio personalizzato a tutti i nodi perimetrali della rete CDN può richiedere tempo:It can take some time for the new custom domain settings to propagate to all CDN edge nodes:

    • La propagazione dei profili della rete CDN Standard di Azure con tecnologia Microsoft viene in genere completata in 10 minuti.For Azure CDN Standard from Microsoft profiles, propagation usually completes in 10 minutes.
    • La propagazione dei profili di rete CDN Standard di Azure con tecnologia Akamai viene in genere completata entro un minuto.For Azure CDN Standard from Akamai profiles, propagation usually completes within one minute.
    • La propagazione dei profili della rete CDN Standard di Azure con tecnologia Verizon e della rete CDN Premium di Azure con tecnologia Verizon viene in genere completata in 10 minuti.For Azure CDN Standard from Verizon and Azure CDN Premium from Verizon profiles, propagation usually completes in 10 minutes.

Verificare il dominio personalizzatoVerify the custom domain

Dopo aver completato la registrazione del dominio personalizzato, verificare che il dominio personalizzato faccia riferimento all'endpoint della rete CDN.After you have completed the registration of your custom domain, verify that the custom domain references your CDN endpoint.

  1. Assicurarsi di disporre di contenuto pubblico memorizzato nella cache nell'endpoint.Ensure that you have public content that is cached at the endpoint. Ad esempio, se l'endpoint della rete CDN è associato a un account di archiviazione, la rete CDN di Azure memorizzerà il contenuto in un contenitore pubblico della cache.For example, if your CDN endpoint is associated with a storage account, Azure CDN will cache the content in a public container. Per testare il dominio personalizzato, verificare che il contenitore sia impostato per poter consentire l'accesso pubblico e che contenga almeno un file.To test the custom domain, verify that your container is set to allow public access and contains at least one file.

  2. Nel browser passare all'indirizzo del file usando il dominio personalizzato.In your browser, navigate to the address of the file by using the custom domain. Se il dominio personalizzato è cdn.contoso.com, ad esempio, l'URL del file memorizzato nella cache sarà simile al seguente: http://cdn.contoso.com/my-public-container/my-file.jpg.For example, if your custom domain is cdn.contoso.com, the URL to the cached file should be similar to the following URL: http://cdn.contoso.com/my-public-container/my-file.jpg. Verificare che il risultato sia lo stesso di quando si accede all'endpoint della rete CDN direttamente in <nome host dell'endpoint>.azureedge.net.Verify that the result is that same as when you access the CDN endpoint directly at <endpoint hostname>.azureedge.net.

Eseguire il mapping del dominio personalizzato permanenteMap the permanent custom domain

Se si è verificato che il mapping del sottodominio cdnverify all'endpoint è stato eseguito correttamente (o se si usa un nuovo dominio personalizzato non in produzione), è possibile eseguire il mapping del dominio personalizzato direttamente al nome host dell'endpoint della rete CDN.If you have verified that the cdnverify subdomain has been successfully mapped to your endpoint (or if you are using a new custom domain that is not in production), you can then map the custom domain directly to your CDN endpoint hostname.

Per creare un record CNAME per il dominio personalizzato:To create a CNAME record for your custom domain:

  1. Accedere al sito Web del provider del dominio personalizzato.Log in to the web site of the domain provider for your custom domain.

  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.Find the page for managing DNS records by consulting the provider's documentation or searching for areas of the web site labeled Domain Name, DNS, or Name Server Management.

  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):Create a CNAME record entry for your custom domain and complete the fields as shown in the following table (field names may vary):

    SorgenteSource typeType DestinationDestination
    www.contoso.comwww.contoso.com CNAMECNAME contoso.azureedge.netcontoso.azureedge.net
    • Origine: immettere il nome di dominio personalizzato (ad esempio, www.contoso.com).Source: Enter your custom domain name (for example, www.contoso.com).

    • Tipo: immettere CNAME.Type: Enter CNAME.

    • Destinazione: immettere il nome host dell'endpoint della rete CDN.Destination: Enter your CDN endpoint hostname. Deve essere nel formato seguente:<nome endpoint>.azureedge.net.It must be in the following format:<endpoint name>.azureedge.net. Ad esempio, contoso.azureedge.net.For example, contoso.azureedge.net.

  4. Salvare le modifiche.Save your changes.

  5. Se si è creato in precedenza un record CNAME del sottodominio cdnverify temporaneo, eliminarlo.If you're previously created a temporary cdnverify subdomain CNAME record, delete it.

  6. Se si usa questo dominio personalizzato nell'ambiente di produzione per la prima volta, seguire i passaggi illustrati in Associare il dominio personalizzato all'endpoint della rete CDN e Verificare il dominio personalizzato.If you are using this custom domain in production for the first time, follow the steps for Associate the custom domain with your CDN endpoint and Verify the custom domain.

La procedura per il registrar GoDaddy, ad esempio, è la seguente:For example, the procedure for the GoDaddy domain registrar is as follows:

  1. Accedere al dominio personalizzato da usare e selezionarlo.Log in and select the custom domain you want to use.

  2. Nella sezione Domains (Domini) selezionare Manage All (Gestisci tutto), quindi selezionare DNS | Manage Zones (DNS | Gestisci zone).In the Domains section, select Manage All, then select DNS | Manage Zones.

  3. In Domain Name (Nome di dominio) immettere il proprio nome di dominio, quindi selezionare Search (Cerca).For Domain Name, enter your custom domain, then select Search.

  4. Nella pagina DNS Management (Gestione DNS) selezionare Add (Aggiungi), quindi selezionare CNAME nell'elenco Type (Tipo).From the DNS Management page, select Add, then select CNAME in the Type list.

  5. Completare i campi della voce CNAME:Complete the fields of the CNAME entry:

    Voce CNAME

    • Type (Tipo): lasciare selezionato CNAME.Type: Leave CNAME selected.

    • Host: immettere il sottodominio del dominio personalizzato da usare.Host: Enter the subdomain of your custom domain to use. Ad esempio, www o cdn.For example, www or cdn.

    • Points to (Punta a): immettere il nome host dell'endpoint della rete CDN.Points to: Enter the host name of your CDN endpoint. Ad esempio, contoso.azureedge.net.For example, contoso.azureedge.net.

    • TTL: lasciare selezionato 1 Hour (1 ora).TTL: Leave 1 Hour selected.

  6. Selezionare Salva.Select Save.

    La voce CNAME viene aggiunta alla tabella di record DNS.The CNAME entry is added to the DNS records table.

    Tabella dei record DNS

  7. Se si ha un record CNAME cdnverify, selezionare l'icona a forma di matita accanto a esso, quindi selezionare l'icona del cestino.If you have a cdnverify CNAME record, select the pencil icon next to it, then select the trash can icon.

  8. Selezionare Delete (Elimina) per eliminare il record CNAME.Select Delete to delete the CNAME record.

Pulire le risorseClean up resources

Nei passaggi precedenti è stato aggiunto un dominio personalizzato a un endpoint della rete CDN.In the preceding steps, you added a custom domain to a CDN endpoint. Se non si vuole più associare l'endpoint a un dominio personalizzato, è possibile rimuovere il dominio personalizzato eseguendo questi passaggi:If you no longer want to associate your endpoint with a custom domain, you can remove the custom domain by performing these steps:

  1. Nel profilo della rete CDN selezionare l'endpoint con il dominio personalizzato che si vuole rimuovere.In your CDN profile, select the endpoint with the custom domain that you want to remove.

  2. Nella pagina Endpoint, in Domini personalizzati fare clic con il pulsante destro del mouse sul dominio personalizzato che si vuole rimuovere, quindi scegliere Elimina dal menu di scelta rapida.From the Endpoint page, under Custom domains, right-click the custom domain that you want to remove, then select Delete from the context menu.

    Il dominio personalizzato viene dissociato dell'endpoint.The custom domain is disassociated from your endpoint.

Passaggi successiviNext steps

Questa esercitazione illustra come:In this tutorial, you learned how to:

  • Creare un record DNS CNAME.Create a CNAME DNS record.
  • Associare il dominio personalizzato all'endpoint della rete CDN.Associate the custom domain with your CDN endpoint.
  • Verificare il dominio personalizzato.Verify the custom domain.

Passare alla prossima esercitazione per imparare a configurare HTTPS in un dominio personalizzato della rete CDN di Azure.Advance to the next tutorial to learn how to configure HTTPS on an Azure CDN custom domain.