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 a su 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. Puede configurar 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

Acción 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. Los dominios Unicode, incluidos los dominios Punycode y el xn-- prefijo tampoco se admiten.

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 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 ALIAS registros, ANAME registros o CNAME aplanamiento, puede configurar un A registro para la aplicación web estática. Esto dirige el tráfico a un único host regional de la aplicación web estática. No se recomienda usar A registros, ya que la aplicación ya no se beneficiará de su distribución global y esto puede afectar al rendimiento de la aplicación si el tráfico se distribuye globalmente.

Estos son los términos y condiciones que 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.contoso.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 resolverse públicamente. Una vez agregado 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 usado para agregar el dominio personalizado a la aplicación web estática a través de la validación CNAME sigue presente. Esta opción solo es válida si se usó la validación de 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 usado para agregar el dominio a la aplicación web. Este enfoque es válido incluso si los puntos de conexión privados están habilitados, ya que los puntos de conexión privados para Static Web Apps bloquean el acceso a Internet al contenido del sitio, pero no bloquean 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 o 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 como se muestra, escriba el host en el proveedor DNS como se indica a continuación:
    • En Dominios de APEX, escriba _dnsauth.www.<YOUR-DOMAIN.COM>.
    • En Subdominios, escriba _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>.
  3. Una vez validado el dominio, puede migrar el tráfico a la aplicación web estática actualizando el CNAMEregistro , ALIASo 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.