Tutorial: Incorporación de un dominio personalizado a Front DoorTutorial: Add a custom domain to your Front Door

En este tutorial se muestra cómo agregar un dominio personalizado a Front Door.This tutorial shows how to add a custom domain to your Front Door. Si se usa Azure Front Door Service para la entrega de aplicaciones, es necesario un dominio personalizado si desea que su nombre de dominio se vea en la solicitud del usuario final.When you use Azure Front Door Service for application delivery, a custom domain is necessary if you would like your own domain name to be visible in your end-user request. El hecho de tener un nombre de dominio visible puede ser cómodo para sus clientes y útil con fines de personalización de marca.Having a visible domain name can be convenient for your customers and useful for branding purposes.

Después de crear una instancia de Front Door, el host de front-end predeterminado, que es un subdominio de azurefd.net, se incluye en la dirección URL para entregar el contenido de Front Door desde el back-end de forma predeterminada (por ejemplo, https://contoso.azurefd.net/activeusers.htm).After you create a Front Door, the default frontend host, which is a subdomain of azurefd.net, is included in the URL for delivering Front Door content from your backend by default (for example, https://contoso.azurefd.net/activeusers.htm). Para su comodidad, Azure Front Door permite asociar un dominio personalizado al host predeterminado.For your convenience, Azure Front Door provides the option of associating a custom domain with the default host. Con esta opción, entrega el contenido con un dominio personalizado en la dirección URL, en lugar de un nombre de dominio propiedad de Front Door (por ejemplo, https://www.contoso.com/photo.png).With this option, you deliver your content with a custom domain in your URL instead of a Front Door owned domain name (for example, https://www.contoso.com/photo.png).

En este tutorial, aprenderá a:In this tutorial, you learn how to:

  • Crear un registro DNS de CNAMECreate a CNAME DNS record.
  • Asociar el dominio personalizado a Front Door.Associate the custom domain with your Front Door.
  • Comprobar el dominio personalizadoVerify the custom domain.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Requisitos previosPrerequisites

Para poder completar los pasos de este tutorial, primero debe crear una instancia de Front Door.Before you can complete the steps in this tutorial, you must first create a Front Door. Para más información, consulte Inicio rápido: Cree una instancia de Front Door.For more information, see Quickstart: Create a Front Door.

Si no dispone ya de un dominio personalizado, primero debe adquirir uno con un proveedor de dominios.If you do not already have a custom domain, you must first purchase one with a domain provider. Por ejemplo, vea Compra de un nombre de dominio personalizado.For example, see Buy a custom domain name.

Si usa Azure para hospedar sus dominios DNS, debe delegar el sistema de nombres de dominio (DNS) del proveedor de dominios en una instancia de Azure DNS.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. Para más información, vea Delegación de un dominio en DNS de Azure.For more information, see Delegate a domain to Azure DNS. Por el contrario, si utiliza un proveedor de dominios para controlar su dominio DNS, diríjase a Creación de un registro DNS de CNAME.Otherwise, if you are using a domain provider to handle your DNS domain, proceed to Create a CNAME DNS record.

Creación de un registro DNS de CNAMECreate a CNAME DNS record

Para poder usar un dominio personalizado con Front Door, antes hay que crear un registro de nombre canónico (CNAME) con su proveedor de dominios para señalar a su host de front-end predeterminado de Front Door (como por ejemplo, contoso.azurefd.net).Before you can use a custom domain with your Front Door, you must first create a canonical name (CNAME) record with your domain provider to point to your Front Door's default frontend host (say contoso.azurefd.net). Un registro CNAME es un tipo de registro de DNS que asigna un nombre de dominio de origen a un nombre de dominio de destino.A CNAME record is a type of DNS record that maps a source domain name to a destination domain name. En el caso de Azure Front Door Service, el nombre del dominio de origen es su nombre de dominio personalizado, mientras que el nombre del dominio de destino es el nombre de host predeterminado de Front Door.For Azure Front Door Service, the source domain name is your custom domain name and the destination domain name is your Front Door default hostname. Una vez que Front Door compruebe el registro CNAME que cree, el tráfico dirigido al dominio personalizado de origen (como www.contoso.com) se enruta al host del front-end predeterminado de la instancia de Front Door del destino especificado (como contoso.azurefd.net).After Front Door 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 Front Door default frontend host (such as contoso.azurefd.net).

Un dominio personalizado y su subdominio no se pueden asociar con más de una instancia de Front Door a la vez.A custom domain and its sub-domain can be associated with only a single Front Door at a time. Sin embargo, puede utilizar diferentes subdominios del mismo dominio personalizado para distintas instancias de Front Door. Para ello debe usar varios registros CNAME.However, you can use different sub-domains from the same custom domain for different Front Doors by using multiple CNAME records. También puede asignar un dominio personalizado con diferentes subdominios a la misma instancia de Front Door.You can also map a custom domain with different sub-domains to the same Front Door.

Asignar el subdominio afdverify temporalMap the temporary afdverify sub-domain

Al asignar un dominio existente que esté en producción, existen consideraciones especiales.When you map an existing domain that is in production, there are special considerations. Mientras se registra un dominio personalizado en Azure Portal, se puede producir un breve período de inactividad en el dominio.While you are registering your custom domain in the Azure portal, a brief period of downtime for the domain can occur. Para evitar la interrupción del tráfico web, en primer lugar es preciso asignar un dominio al host del front-end predeterminado de Front Door con el subdominio afdverify Azure para crear una asignación de CNAME temporal.To avoid interruption of web traffic, first map your custom domain to your Front Door default frontend host with the Azure afdverify sub-domain to create a temporary CNAME mapping. Con este método, los usuarios pueden acceder a un dominio sin interrupción mientras se realiza la asignación de DNS.With this method, users can access your domain without interruption while the DNS mapping occurs.

Por el contrario, si es la primera vez que usa un dominio personalizado y no se ejecuta tráfico de producción en él, puede asignar directamente el dominio personalizado a Front Door.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 Front Door. Diríjase a Asignación del dominio personalizado permanente.Proceed to Map the permanent custom domain.

Para crear un registro CNAME con el subdominio afdverify:To create a CNAME record with the afdverify subdomain:

  1. Inicie sesión en el sitio web del proveedor de dominios de su dominio personalizado.Sign in to the web site of the domain provider for your custom domain.

  2. Busque la página para administrar registros DNS mediante la consulta de la documentación del proveedor o busque las áreas del sitio web con las etiquetas Nombre de dominio, DNS o Name Server Management (Administración del servidor de nombres).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. Cree una entrada de registro CNAME para el dominio personalizado y rellene los campos como se muestra en la tabla siguiente (los nombres de campo pueden variar):Create a CNAME record entry for your custom domain and complete the fields as shown in the following table (field names may vary):

    OrigenSource TypeType DestinoDestination
    afdverify.www.contoso.comafdverify.www.contoso.com CNAMECNAME afdverify.contoso.azurefd.netafdverify.contoso.azurefd.net
    • Origen: escriba un nombre de dominio personalizado, incluido el subdominio afdverify, con el siguiente formato: afdverify.<nombre de dominio personalizado>.Source: Enter your custom domain name, including the afdverify subdomain, in the following format: afdverify.<custom domain name>. Por ejemplo, afdverify.www.contoso.com.For example, afdverify.www.contoso.com.

    • Escriba: Escriba CNAME.Type: Enter CNAME.

    • Destino: especifique el host de front-end de Front Door predeterminado, incluido el subdominio afdverify, con el siguiente formato: afdverify.<nombre de punto de conexión>.azurefd.net.Destination: Enter your default Front Door frontend host, including the afdverify subdomain, in the following format: afdverify.<endpoint name>.azurefd.net. Por ejemplo, afdverify.contoso.azurefd.net.For example, afdverify.contoso.azurefd.net.

  4. Guarde los cambios.Save your changes.

Por ejemplo, este es el procedimiento para el registrador de dominios GoDaddy:For example, the procedure for the GoDaddy domain registrar is as follows:

  1. Inicie sesión y seleccione el dominio personalizado que desea usar.Sign in and select the custom domain you want to use.

  2. En la sección Domains (Dominio)º, seleccione Manage all (Administrar todos) y, después, seleccione DNS | Manage Zones (Administrar Zonas).In the Domains section, select Manage All, then select DNS | Manage Zones.

  3. En Domain Name (Nombre de dominio), escriba el dominio personalizado y seleccione Search (Buscar).For Domain Name, enter your custom domain, then select Search.

  4. En la página DNS Management (Administración de SNS), seleccione Add (Agregar) y, después, seleccione CNAME en la lista Type (Tipo).From the DNS Management page, select Add, then select CNAME in the Type list.

  5. Complete los siguientes campos de la entrada de CNAME:Complete the following fields of the CNAME entry:

    • Escriba: Deje seleccionado CNAME.Type: Leave CNAME selected.

    • Host: escriba el subdominio del dominio personalizado que va a usar, incluido el nombre de subdominio afdverify.Host: Enter the subdomain of your custom domain to use, including the afdverify subdomain name. Por ejemplo, afdverify.www.For example, afdverify.www.

    • Points to (Apunta a): escriba el nombre del host de front-end de Front Door predeterminado, incluido el nombre de subdominio afdverify.Points to: Enter the host name of your default Front Door frontend host, including the afdverify subdomain name. Por ejemplo, afdverify.contoso.azurefd.net.For example, afdverify.contoso.azurefd.net.

    • TTL: deje seleccionado 1 Hour (1 hora).TTL: Leave 1 Hour selected.

  6. Seleccione Guardar.Select Save.

    La entrada de CNAME se agrega a la tabla de registros DNS.The CNAME entry is added to the DNS records table.

Asociación del dominio personalizado a Front DoorAssociate the custom domain with your Front Door

Una vez que haya registrado un dominio personalizado, puede agregarlo a Front Door.After you've registered your custom domain, you can then add it to your Front Door.

  1. Inicie sesión en Azure Portal y vaya a la instancia de Front Door que contenga el host de front-end que desea asignar a un dominio personalizado.Sign in to the Azure portal and browse to the Front Door containing the frontend host that you want to map to a custom domain.

  2. En la página Diseñador de Front Door, haga clic en "+" para agregar un dominio personalizado.On the Front Door designer page, click on '+' to add a custom domain.

  3. Especifique Dominio personalizado.Specify Custom domain.

  4. En Host de front-end, el host de front-end que se usa como dominio de destino de su registro CNAME se rellena previamente y se deriva de Front Door: <nombre de host predeterminado>.azurefd.NET.For Frontend host, the frontend host to use as the destination domain of your CNAME record is pre-filled and is derived from your Front Door: <default hostname>.azurefd.net. No se puede modificar.It cannot be changed.

  5. Para Nombre de host personalizado, escriba el dominio personalizado, incluido el subdominio, que se usará como el dominio de origen del registro CNAME.For Custom hostname, enter your custom domain, including the subdomain, to use as the source domain of your CNAME record. Por ejemplo, www.contoso.com o cdn.contoso.com.For example, www.contoso.com or cdn.contoso.com. No utilice el nombre de subdominio afdverify.Do not use the afdverify subdomain name.

  6. Seleccione Agregar.Select Add.

    Azure comprueba que el registro CNAME existe para el nombre de dominio personalizado que ha especificado.Azure verifies that the CNAME record exists for the custom domain name you entered. Si el registro CNAME es correcto, el dominio personalizado se valida.If the CNAME is correct, your custom domain will be validated.

Advertencia

Debe asegurarse de que todos los hosts de front-end (incluidos los dominios personalizados) de Front Door tienen una regla de enrutamiento con una ruta de acceso predeterminada ('/*') asociada.You must ensure that each of the frontend hosts (including custom domains) in your Front Door has a routing rule with a default path ('/*') associated with it. Es decir, entre todas las reglas de enrutamientos debe haber al menos una para cada uno de los hosts de front-end que se definen en la ruta de acceso predeterminada ('/*').That is, across all of your routing rules there must be at least one routing rule for each of your frontend hosts defined at the default path ('/*'). Si no la hay, puede darse el caso de que el tráfico del usuario final no se enrute correctamente.Failing to do so, may result in your end-user traffic not getting routed correctly.

Comprobación del dominio personalizadoVerify the custom domain

Después de haber completado el registro del dominio personalizado, compruebe que hace referencia al host de front-end de Front Door personalizado.After you have completed the registration of your custom domain, verify that the custom domain references your default Front Door frontend host.

En el explorador, vaya a la dirección del archivo usando el dominio personalizado.In your browser, navigate to the address of the file by using the custom domain. Por ejemplo, si el dominio personalizado es robotics.contoso.com, la dirección URL al archivo almacenado en la caché sería similar a la siguiente: http://robotics.contoso.com/my-public-container/my-file.jpg.For example, if your custom domain is robotics.contoso.com, the URL to the cached file should be similar to the following URL: http://robotics.contoso.com/my-public-container/my-file.jpg. Compruebe que el resultado es el mismo que cuando accede a Front Door directamente en <host de Front Door>.azurefd.net.Verify that the result is that same as when you access the Front Door directly at <Front Door host>.azurefd.net.

Asignación de un dominio personalizado permanenteMap the permanent custom domain

Si ha comprobado que el subdominio afdverify se ha asignado correctamente a Front Door (o si utiliza un nuevo dominio personalizado que no esté en producción), puede asignar el dominio personalizado directamente al host de Front Door predeterminado.If you have verified that the afdverify subdomain has been successfully mapped to your Front Door (or if you are using a new custom domain that is not in production), you can then map the custom domain directly to your default Front Door frontend host.

Para crear un registro CNAME para un dominio personalizado:To create a CNAME record for your custom domain:

  1. Inicie sesión en el sitio web del proveedor de dominios de su dominio personalizado.Sign in to the web site of the domain provider for your custom domain.

  2. Para encontrar la página de administración de los registros DNS, consulte la documentación del proveedor o busque las áreas del sitio web con la etiqueta Nombre de dominio, DNS o Name Server Management (Administración del servidor de nombres).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. Cree una entrada de registro CNAME para el dominio personalizado y rellene los campos como se muestra en la tabla siguiente (los nombres de campo pueden variar):Create a CNAME record entry for your custom domain and complete the fields as shown in the following table (field names may vary):

    OrigenSource TypeType DestinoDestination
    <www.contoso.com><www.contoso.com> CNAMECNAME contoso.azurefd.netcontoso.azurefd.net
    • Origen: Escriba el nombre de dominio personalizado (por ejemplo, www.contoso.com).Source: Enter your custom domain name (for example, www.contoso.com).

    • Escriba: Escriba CNAME.Type: Enter CNAME.

    • Destino: especifique el host de front-end de Front Door predeterminado.Destination: Enter your default Front Door frontend host. Debe tener el siguiente formato:<nombre de host>.azurefd.net.It must be in the following format:<hostname>.azurefd.net. Por ejemplo, contoso.azurefd.net.For example, contoso.azurefd.net.

  4. Guarde los cambios.Save your changes.

  5. Si previamente ha creado un registro CNAME de un subdominio afdverify temporal, elimínelo.If you're previously created a temporary afdverify subdomain CNAME record, delete it.

  6. La primera vez que use este dominio personalizado en producción, siga los pasos de Asociación del dominio personalizado a Front Door y Comprobación del dominio personalizado.If you are using this custom domain in production for the first time, follow the steps for Associate the custom domain with your Front Door and Verify the custom domain.

Por ejemplo, este es el procedimiento para el registrador de dominios GoDaddy:For example, the procedure for the GoDaddy domain registrar is as follows:

  1. Inicie sesión y seleccione el dominio personalizado que desea usar.Sign in and select the custom domain you want to use.

  2. En la sección Domains (Dominio)º, seleccione Manage all (Administrar todos) y, después, seleccione DNS | Manage Zones (Administrar Zonas).In the Domains section, select Manage All, then select DNS | Manage Zones.

  3. En Domain Name (Nombre de dominio), escriba el dominio personalizado y seleccione Search (Buscar).For Domain Name, enter your custom domain, then select Search.

  4. En la página DNS Management (Administración de SNS), seleccione Add (Agregar) y, después, seleccione CNAME en la lista Type (Tipo).From the DNS Management page, select Add, then select CNAME in the Type list.

  5. Complete los campos de la entrada de CNAME:Complete the fields of the CNAME entry:

    • Escriba: Deje seleccionado CNAME.Type: Leave CNAME selected.

    • Host: escriba el subdominio del dominio personalizado que va a usar.Host: Enter the subdomain of your custom domain to use. Por ejemplo, www o profile.For example, www or profile.

    • Points to (Apunta a): escriba el nombre de host predeterminado de Front Door.Points to: Enter the default host name of your Front Door. Por ejemplo, contoso.azurefd.net.For example, contoso.azurefd.net.

    • TTL: deje seleccionado 1 Hour (1 hora).TTL: Leave 1 Hour selected.

  6. Seleccione Guardar.Select Save.

    La entrada de CNAME se agrega a la tabla de registros DNS.The CNAME entry is added to the DNS records table.

  7. Si tiene un registro CNAME de afdverify, seleccione el icono de lápiz que encontrará al lado y, después, seleccione el icono de la papelera.If you have an afdverify CNAME record, select the pencil icon next to it, then select the trash can icon.

  8. Seleccione Delete (Eliminar) para eliminar el registro CNAME.Select Delete to delete the CNAME record.

Limpieza de recursosClean up resources

En los pasos anteriores, ha agregado un dominio personalizado a Front Door.In the preceding steps, you added a custom domain to a Front Door. Si desea que Front Door deje de estar asociado a un dominio personalizado, siga estos pasos para quitar el dominio personalizado:If you no longer want to associate your Front Door with a custom domain, you can remove the custom domain by performing these steps:

  1. En el diseñador de Front Door, seleccione el punto de conexión con el dominio personalizado que desee quitar.In your Front Door designer, select the custom domain that you want to remove.

  2. Haga clic en Eliminar en el menú contextual del dominio personalizado.Click Delete from the context menu for the custom domain.

    El dominio personalizado se desasocia del punto de conexión.The custom domain is disassociated from your endpoint.

Pasos siguientesNext steps

En este tutorial aprendió lo siguiente:In this tutorial, you learned how to:

  • Crear un registro DNS de CNAMECreate a CNAME DNS record.
  • Asociar el dominio personalizado a Front Door.Associate the custom domain with your Front Door.
  • Comprobar el dominio personalizadoVerify the custom domain.