Compartir vía

Dominios personalizados con Azure Static Web Apps

  • Artículo

De manera predeterminada, Azure Static Web Apps proporciona un nombre de dominio generado automáticamente para el sitio web, pero puede apuntar un dominio personalizado al sitio. Los certificados SSL/TLS gratuitos se crean automáticamente para el nombre de dominio generado automáticamente y los dominios personalizados que pueda agregar.

Al asignar un dominio personalizado a una aplicación web estática, tiene algunas opciones disponibles, que incluyen la configuración de subdominios y un dominio de vértice.

En la tabla siguiente se incluyen vínculos a artículos que muestran cómo configurar un tipo de proveedor basado en dominio personalizado. 1

Action Usando... Usando...
Configuración de un dominio con el subdominio www DNS de Azure Proveedor externo
Configuración de un dominio de vértice DNS de Azure Proveedor externo

1 Algunos registradores, como GoDaddy y Google, no admiten registros de dominio que afecten a cómo se configura el dominio de vértice. Considere la posibilidad de usar Azure DNS con estos registradores para configurar el dominio de vértice.

Nota:

No se admite la adición de un dominio personalizado a un entorno de versión preliminar. Tampoco se admiten los dominios Unicode, incluidos los dominios Punycode y el prefijo xn--.

Acerca de los dominios

La configuración de un dominio de vértice es un escenario común que se puede configurar una vez configurado el nombre de dominio. La creación de un dominio de vértice se logra mediante la configuración de un registro ALIAS o ANAME o mediante el aplanado CNAME. Algunos registradores de dominios, como GoDaddy y Squarespace (anteriormente Google), no admiten estos registros DNS. Si el registrador de dominios no admite todos los registros DNS que necesita, considere la posibilidad de usar Azure DNS para configurar el dominio.

Como alternativa, para los registradores de dominios que no admiten registros ALIAS, registros ANAME o acoplamiento de CNAME, puede configurar un registro A para la aplicación web estática. Esta configuración dirige el tráfico a un único host regional de la aplicación web estática. No se recomienda usar registros A, porque la aplicación ya no se beneficia de la distribución global y este tipo de configuración podría afectar al rendimiento de la aplicación si el tráfico se distribuye globalmente.

Nota:

El registro CNAME asigna un nombre de dominio a otro dominio (o subdominio) mientras que el registro A asigna un nombre de dominio a una dirección IP. Si la dirección IP cambia, una entrada CNAME sigue siendo válida, a diferencia del registro A. Supongamos que tiene WebApp1 y desea que los usuarios accedan a ella desde https://www.contoso.com. Puede hacerlo de dos maneras posibles: puede crear un registro CNAME y asignarlo a WebApp1.azurestaticapps.net. Como alternativa, puede crear un registro A y asignarlo a la dirección IP de WebApp1.

Estos son los términos y condiciones que podría encontrar al configurar un dominio personalizado.

  • Dominios de vértice o raíz: dado el dominio www.example.com, el prefijo www se conoce como subdominio, mientras que el segmento restante de example.com se conoce como dominio de vértice.

  • Registrador de dominios: un registrador comprueba la disponibilidad de un dominio que vende los derechos para comprar un nombre de dominio.

  • Zona DNS: una zona del Sistema de nombres de dominio (DNS) hospeda los registros DNS asociados a un dominio específico. Hay varios registros disponibles que dirigen el tráfico para distintos propósitos. Por ejemplo, el dominio example.com puede contener varios registros DNS. Un registro controla el tráfico para mail.example.com (para un servidor de correo) y otro www.example.com (para un sitio web).

  • Hospedaje de DNS: un host de DNS mantiene servidores DNS que resuelven un nombre de dominio en una dirección IP específica.

  • Servidor de nombres: un servidor de nombres es responsable de almacenar los registros DNS de un dominio.

Para que la comprobación de dominio personalizada funcione con Static Web Apps, el DNS debe poder resolverse públicamente. Una vez que se agrega el dominio, se debe cumplir una de las condiciones siguientes para que funcione la renovación automática de certificados:

  • Asegúrese de que el registro DNS CNAME de Internet público que se ha usado para agregar el dominio personalizado a la aplicación web estática mediante la validación CNAME sigue presente. Esta opción solo es válida si se ha usado la validación CNAME para agregar el dominio a la aplicación web estática.

  • Asegúrese de que el dominio personalizado se resuelve en la aplicación web estática a través de la red pública de Internet. Esta opción es válida independientemente del método de validación que se haya usado para agregar el dominio a la aplicación web. Este enfoque es válido incluso cuando se habilitan puntos de conexión privados. El propósito de un punto de conexión privado para Static Web Apps es bloquear el acceso a Internet al contenido del sitio, pero no bloquear la resolución DNS de Internet al sitio.

Migración con tiempo de inactividad cero

Es posible que quiera migrar un dominio personalizado que actualmente atiende un sitio web de producción a la aplicación web estática sin tiempo de inactividad. Los proveedores DNS no aceptan varios registros para el mismo nombre y host, por lo que puede validar por separado la propiedad del dominio y enrutar el tráfico a la aplicación web.

  1. Abra la aplicación web estática en Azure Portal.

  2. Agregue un registro TXT para el dominio personalizado (APEX o subdominio). En lugar de escribir el valor Host tal como se muestra, escriba el Host en el proveedor DNS de la siguiente manera:

    • Para dominios APEX, escriba _dnsauth.www.<YOUR-DOMAIN.COM>.
    • Para subdominios, escriba _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>.

  3. Una vez que se valide el dominio, puede migrar el tráfico a la aplicación web estática si actualiza el registro de CNAME, ALIAS o A para que apunte al nombre de host predeterminado

Pasos siguientes

Use los vínculos siguientes para obtener pasos sobre cómo configurar el dominio en función del proveedor.