Compartilhar via


Domínios personalizados com os Aplicativos Web Estáticos do Azure

Observação

A validação de domínio personalizado para Aplicativos Web Estáticos do Enterprise Grade Edge agora requer o método de token TXT – a validação CNAME não tem mais suporte para novos domínios.

Por padrão, os Aplicativos Web Estáticos do Azure fornecem um nome de domínio gerado automaticamente para seu site, mas você pode apontar um domínio personalizado para seu site. Os certificados SSL/TLS gratuitos são criados automaticamente no nome de domínio gerado automaticamente e todos os domínios personalizados que você pode adicionar.

Ao mapear um domínio personalizado para um aplicativo Web estático, você tem algumas opções disponíveis, que incluem a configuração de subdomínios e um domínio apex.

A tabela a seguir inclui links para artigos que demonstram como configurar um tipo de provedor baseado em domínio personalizado. 1

Ação Usando... Usando...
Configurar um domínio com o subdomínio www DNS do Azure Provedor externo
Configurar um domínio Apex DNS do Azure Provedor externo

1 Alguns registradores como o GoDaddy não dão suporte a registros de domínio que afetam a forma como você configura seu domínio apex. Use o DNS do Azure com esses registradores para configurar o domínio Apex.

Observação

Não há suporte para adicionar um domínio personalizado a um ambiente de visualização. Domínios Unicode, incluindo domínios Punycode e o prefixo xn-- também não têm suporte.

Sobre domínios

Definir um domínio Apex é um cenário comum a ser configurado depois que o nome de domínio é definido. Um domínio Apex é criado configurando um registro ALIAS ou ANAME ou por meio do nivelamento de CNAME. Alguns registradores de domínio, como GoDaddy e Squarespace (antigo Google), não dão suporte a esses registros DNS. Se o registrador de domínio não for compatível com todos os registros DNS necessários, use o DNS do Azure para configurar o domínio.

Como alternativa, para registradores de domínio que não dão suporte a registros ALIAS, registros ANAME ou nivelamento CNAME, você pode configurar um registro A para seu aplicativo Web estático. Essa configuração direciona o tráfego para um único host regional do seu aplicativo Web estático. O uso de registros A não é recomendado, pois seu aplicativo não se beneficia mais da distribuição global e esse tipo de configuração pode afetar o desempenho do aplicativo se o tráfego for distribuído globalmente.

Observação

CNAME O registro mapeia um nome de domínio para outro domínio (ou subdomínio), enquanto o registro de A mapeia um nome de domínio para um endereço IP. Se o endereço IP for alterado, uma entrada de CNAME ainda será válida, ao contrário do registro A. Digamos que você tenha o WebApp1 e queira que os usuários acessem-no a partir de https://www.contoso.com. Você pode fazer isso de duas maneiras possíveis: pode criar um registro CNAME e mapeá-lo para WebApp1.azurestaticapps.net. Alternativamente, você pode criar um registro A e mapeá-lo para o endereço IP do WebApp1.

Veja a seguir os termos que você pode encontrar ao configurar um domínio personalizado.

  • Domínios Apex ou raiz: considerando o domínio www.example.com, o prefixo www é conhecido como subdomínio, enquanto o segmento restante do example.com é chamado de domínio Apex.

  • Registrador de domínio: um registrador verifica se a disponibilidade de um domínio vende os direitos para comprar um nome de domínio.

  • Zona DNS: uma zona DNS (Sistema de Nomes de Domínio) hospeda os registros DNS associados a um domínio específico. Há vários registros disponíveis que direcionam o tráfego para finalidades diferentes. Por exemplo, o domínio example.com pode conter vários registros DNS. Um registro lida com o tráfego para mail.example.com (para um servidor de email) e outro www.example.com (para um site).

  • Hospedagem DNS: um host DNS mantém os servidores DNS que resolvem um nome de domínio para um endereço IP específico.

  • Servidor de nomes: um servidor de nomes é responsável por armazenar os registros DNS para um domínio.

Para que a verificação de um domínio personalizado funcione com Aplicativos Web Estáticos o DNS deve ser resolvível publicamente. Para que a renovação automática de certificado funcione, o Custom Domain deve ser resolvido para o aplicativo Web estático pela Internet pública. Há suporte para renovação automática de certificado mesmo quando você habilita pontos de extremidade privados. A finalidade de um ponto de extremidade privado para Aplicativos Web Estáticos é bloquear o acesso à Internet ao conteúdo do site, mas não bloquear a resolução de DNS da Internet no site.

Migração sem tempo de inatividade

Talvez você queira migrar um domínio personalizado que atualmente atende um site de produção para seu aplicativo Web estático sem tempo de inatividade. Os provedores DNS não aceitam vários registros para o mesmo nome e host, portanto, você pode validar separadamente sua propriedade do domínio e rotear o tráfego para seu aplicativo Web.

  1. Abra seu aplicativo Web estático no portal do Azure.

  2. Adicione um registro TXT para seu domínio personalizado (APEX ou subdomínio). Em vez de inserir o valor do Host como exibido, insira o Host em seu provedor DNS da seguinte maneira:

    • Para domínios APEX, insira _dnsauth.www.<YOUR-DOMAIN.COM>.
    • Para subdomínios, insira _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>.
  3. Depois que seu domínio for validado, você poderá migrar seu tráfego para seu aplicativo Web estático atualizando seu registro CNAME, ALIAS ou A para apontar para o nome do host padrão

Migrando domínios entre instâncias

Os Aplicativos Web Estáticos do Azure permitem apenas associar um domínio exclusivo a um único recurso dentro de uma fatia. A tentativa de associar um domínio já associado a outro recurso sem primeiro desassociar do recurso original resultará em falha.

A fatia na qual o recurso é colocado pode ser determinada inspecionando a URL padrão atribuída a ele:

<random-prefix>.<slice>.azurestaticapps.net

Por exemplo, um site de aplicativo Web estático com a URL orange-pond-0a04b7203.2.azurestaticapps.net padrão foi colocado na fatia número 2.

Se o aplicativo estático do qual você está migrando o domínio e o aplicativo para o qual você está migrando estiverem na mesma fatia, você deverá:

  • Remova o domínio de uma instância e adicione-o à sua nova instância. Isso resultará em algum tempo de inatividade.
  • Exclua e reimplante a nova instância até que o recurso resultante seja colocado em uma fatia diferente da instância de origem.

Próximas etapas

Use os links a seguir para obter as etapas sobre como configurar o domínio de acordo com o provedor.