Tutorial: Asignación de un nombre DNS personalizado existente a Azure App Service

Azure App Service proporciona un servicio de hospedaje web muy escalable y con aplicación de revisiones de un modo automático. En este tutorial se muestra cómo asignar un nombre del Sistema de nombres de dominio (DNS) personalizado existente a Azure App Service.

En este tutorial aprenderá a:

1. Preparación del entorno

  • Cree una aplicación de App Service o use alguna aplicación que haya creado para otro tutorial.

  • Asegúrese de que puede editar los registros DNS del dominio personalizado. Si aún no tiene un dominio personalizado, puede adquirir un dominio de App Service.

    Nota

    Para editar los registros DNS, se requiere acceso al registro DNS del proveedor de dominios, como GoDaddy. Por ejemplo, para agregar entradas DNS para contoso.com y www.contoso.com, debe poder configurar las opciones de DNS del dominio raíz de contoso.com.

2. Preparación de la aplicación

Para asignar un nombre DNS personalizado a una aplicación web, el plan de App Service de dicha aplicación debe ser un nivel de pago, no Gratis (F1) .

Inicio de sesión en Azure

Abra Azure Portal e inicie sesión con su cuenta de Azure.

Selección de la aplicación en Azure Portal

  1. Busque y seleccione App Services.

    Captura de pantalla que muestra la selección de App Services.

  2. En la página App Services, seleccione el nombre de la aplicación de Azure.

    Captura de pantalla que muestra cómo ir a una aplicación de Azure en el portal.

    Consulte la página de administración de la aplicación de App Service.

Comprobar el plan de tarifa

  1. En el panel izquierdo de la página de la aplicación, desplácese hasta la sección Configuración y seleccione Escalar verticalmente (plan de App Service) .

    Captura de pantalla que muestra el menú Escalar verticalmente (plan de App Service).

  2. El nivel actual de la aplicación aparece resaltado con un cuadro azul. Asegúrese de que la aplicación no está en el nivel F1. No se admite DNS personalizado en el nivel F1.

    Captura de pantalla que muestra los planes de tarifa recomendados.

  3. Si el plan de App Service no está en el nivel F1, cierre la página Escalar verticalmente y vaya directamente a 3. Obtención de un identificador de comprobación de dominio.

Escalado vertical del plan de App Service

  1. Seleccione cualquiera de los niveles no gratuitos (D1, B1, B2, B3, o cualquier nivel de la categoría Producción). Para ver las opciones adicionales, seleccione Ver opciones adicionales.

  2. Seleccione Aplicar.

    Captura de pantalla que muestra la comprobación del plan de tarifa.

    Cuando vea la siguiente notificación, significará que la operación de escalado se habrá completado.

    Captura de pantalla que muestra la confirmación de la operación de escalado.

3. Obtención de un identificador de comprobación de dominio

Para agregar un dominio personalizado a la aplicación, tiene que confirmar la propiedad del dominio agregando un identificador de comprobación como un registro TXT con el proveedor de dominio.

  1. En el panel izquierdo de la página de la aplicación, seleccione Dominios personalizados.

  2. Copie el identificador del cuadro Id. de verificación del dominio personalizado en la página Dominios personalizados para realizar el siguiente paso.

    Captura de pantalla que muestra el identificador en el cuadro Id. de verificación del dominio personalizado.

    Advertencia

    La adición de identificadores de verificación de dominio al dominio personalizado puede impedir las entradas DNS pendientes y ayudar a evitar las adquisiciones de subdominios. En el caso de los dominios personalizados configurados previamente sin este identificador de verificación, debe agregar el identificador al registro de DNS para protegerlos del mismo riesgo. Para más información sobre esta amenaza común de alta gravedad, consulte Adquisición de subdominios.

  1. (Solo registro A) Para asignar un registro A, se necesita la dirección IP externa de la aplicación. En la página Dominios personalizados, copie el valor de Dirección IP.

    Captura de pantalla que muestra cómo ir a una aplicación de Azure en el portal.

4. Creación de los registros DNS

  1. Inicie sesión en el sitio web de su proveedor de dominios.

    Nota

    Si lo desea, puede usar Azure DNS para administrar los registros DNS para su dominio y configurar un nombre DNS personalizado para Azure App Service. Para más información, consulte el Tutorial: Hospedaje del dominio en Azure DNS.

  2. Busque la página de administración de registros DNS.

    Nota

    Cada proveedor de dominios tiene su propia interfaz de registros DNS, así que consulte la documentación del proveedor. Busque áreas del sitio etiquetadas como Nombre de dominio, DNS o Administración del servidor del nombres.

    A menudo, se puede encontrar la página de registros DNS al ver la información de la cuenta y al buscar un vínculo, como Mis dominios. Vaya a dicha página y, después, busque un vínculo que se llame algo así como Zone file, DNS Records o Advanced configuration.

    La captura de pantalla siguiente es un ejemplo de página de registros DNS:

    Captura de pantalla que muestra una página de registros DNS de ejemplo.

  3. Seleccione Agregar o el widget adecuado para crear un registro.

  4. Seleccione el tipo de registro que se va a crear y siga las instrucciones. Puede usar un registro CNAME o un registro D para asignar un nombre DNS personalizado a App Service.

    Nota

    Qué registro elegir

    • Para asignar el dominio raíz (por ejemplo, contoso.com), use un registro A. No use el registro CNAME para el registro raíz (para obtener información, consulte RFC 1912, sección 2.4).
    • Para asignar un subdominio (por ejemplo, www.contoso.com), use un registro CNAME.
    • Puede asignar un subdominio directamente a la dirección IP de la aplicación con un registro A, pero es posible que la dirección IP cambie. En su lugar, el registro CNAME se asigna al nombre de host predeterminado de la aplicación, que es menos susceptible de cambiar.
    • Para asignar un dominio con comodín (por ejemplo, *.contoso.com), utilice un registro CNAME.

Para un subdominio como www en www.contoso.com, cree dos registros según la tabla siguiente:

Tipo de registro Host Value Comentarios
CNAME <subdomain> (por ejemplo, www) <app-name>.azurewebsites.net La propia asignación de dominio.
TXT asuid.<subdomain> (por ejemplo, asuid.www) El identificador de comprobación que obtuvo anteriormente. App Service accede al registro TXT asuid.<subdomain> para comprobar la propiedad del dominio personalizado.

Captura de pantalla que muestra cómo ir a una aplicación de Azure en el portal.

Nota

En el caso de ciertos proveedores, como GoDaddy, los cambios en los registros DNS no entran en vigor hasta que se selecciona un vínculo Guardar cambios independiente.

5. Habilitación de la asignación en la aplicación

  1. En el panel izquierdo de la página de la aplicación en Azure Portal, seleccione Dominios personalizados.

    Captura de pantalla que muestra el menú Dominios personalizados.

  2. Seleccione Agregar dominio personalizado.

    Captura de pantalla que muestra el elemento Agregar nombre de host.

  1. Escriba el nombre de dominio completo para el que ha agregado un registro CNAME, como www.contoso.com.

  2. Seleccione Validar. Aparece la página Agregar dominio personalizado.

  3. Asegúrese de que en Tipo de registro de nombre de host está seleccionado CNAME (www.example.com o cualquier subdominio) . Seleccione Agregar dominio personalizado.

    Captura de pantalla que muestra el botón Agregar dominio personalizado.

    El nuevo dominio personalizado puede tardar un tiempo en reflejarse en la página Dominios personalizados de la aplicación. Actualice el explorador para actualizar los datos.

    Captura de pantalla que muestra la adición del registro CNAME.

    Nota

    Una etiqueta de advertencia para el dominio personalizado significa que aún no está enlazado a un certificado TLS/SSL. Todas las solicitudes HTTPS al dominio personalizado desde un explorador recibirán un error o una advertencia, en función del explorador. Para agregar un enlace TLS, consulte Protección de un nombre DNS personalizado con un enlace TLS/SSL en Azure App Service.

    Si olvidó un paso o cometió un error tipográfico en alguna parte anteriormente, aparecerá un error de comprobación en la parte inferior de la página.

    Captura de pantalla que muestra un error de comprobación.

6. Prueba en un explorador

Vaya a los nombres DNS que configuró anteriormente.

Captura de pantalla que muestra cómo ir a una aplicación de Azure.

Si recibe un error HTTP 404 (No encontrado) al navegar a la dirección URL del dominio personalizado, las dos causas más comunes son:

  • En el dominio personalizado configurado falta un registro A o un registro CNAME. Es posible que haya eliminado el registro DNS después de habilitar la asignación en la aplicación. Compruebe si los registros DNS están configurados correctamente mediante una herramienta de búsqueda de DNS en línea.
  • El cliente del explorador ha almacenado en caché la dirección IP antigua del dominio. Borre la memoria caché y pruebe la resolución DNS de nuevo. En un equipo Windows, borre la memoria caché con ipconfig /flushdns.

Migración de un dominio activo

Para migrar un sitio en vivo y su nombre de dominio DNS a App Service sin tiempo de inactividad, consulte Migración de un nombre DNS activo a Azure App Service.

Redirección a un directorio personalizado

Nota

De forma predeterminada, App Service dirige las solicitudes web al directorio raíz del código de la aplicación. Sin embargo, algunos marcos web no se inician en el directorio raíz. Por ejemplo, Laravel se inicia en el subdirectorio public. Para continuar con el ejemplo de DNS de contoso.com, se podría acceder a la aplicación en http://contoso.com/public, pero normalmente, en su lugar, quiere redirigir http://contoso.com al directorio public.

Aunque se trata de un escenario común, en realidad no implica la asignación de DNS personalizados, sino que se trata de personalizar el directorio virtual dentro de la aplicación.

  1. Seleccione Configuración de la aplicación en el panel izquierdo de la página de la aplicación web.

  2. En la parte inferior de la página, el directorio virtual raíz / apunta a site\wwwroot de forma predeterminada, que es el directorio raíz del código de la aplicación. Cambie esta configuración para que, en su lugar, apunte, por ejemplo, a site\wwwroot\public y después guarde los cambios.

    Captura de pantalla que muestra la personalización de un directorio virtual.

  3. Una vez finalizada la operación, vaya a la ruta de acceso raíz de la aplicación en el explorador (por ejemplo, http://contoso.com o http://<app-name>.azurewebsites.net) para comprobarlo.

Automatizar con scripts

Puede automatizar la administración de dominios personalizados con scripts mediante la CLI de Azure o Azure PowerShell.

Azure CLI

El comando siguiente agrega un nombre DNS personalizado configurado a una aplicación de App Service.

az webapp config hostname add \
    --webapp-name <app-name> \
    --resource-group <resource_group_name> \
    --hostname <fully_qualified_domain_name>

Para más información, consulte Asignación de un dominio personalizado a una aplicación web.

Azure PowerShell

Nota

En este artículo se usa el módulo Az de PowerShell, que es el módulo de PowerShell que se recomienda para interactuar con Azure. Para empezar a trabajar con el módulo Az de PowerShell, consulte Instalación de Azure PowerShell. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.

El comando siguiente agrega un nombre DNS personalizado configurado a una aplicación de App Service.

Set-AzWebApp `
    -Name <app-name> `
    -ResourceGroupName <resource_group_name> ` 
    -HostNames @("<fully_qualified_domain_name>","<app-name>.azurewebsites.net")

Para obtener más información, vea Asignación de un dominio personalizado a una aplicación web.

Pasos siguientes

Pase al siguiente tutorial para aprender a enlazar un certificado TLS/SSL personalizado a una aplicación web.

Protección de un nombre DNS personalizado con un enlace TLS/SSL en Azure App Service