Compartilhar via

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

  • Artigo

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 e o Google, não são compatíveis com registros de domínio que afetam a forma de configurar o 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

O registro de CNAME mapeia um nome de domínio para outro domínio (ou subdomínio), enquanto o registro de Amapeia 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 gostaria de que os usuários o acessassem a partir do 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. Depois que o domínio é adicionado, uma das seguintes condições deve ser atendida para que a renovação automática de certificado funcione:

  • Verifique se o registro CNAME do DNS da internet pública usado para adicionar o domínio personalizado ao Aplicativo Web Estático por meio da validação do CNAME ainda está presente. Essa opção só será válida se a validação do CNAME for usada para adicionar o domínio ao aplicativo Web estático.

  • Certifique-se de que o domínio personalizado seja resolvido para o aplicativo web estático por meio da internet pública. Essa opção é válida independentemente do método de validação usado para adicionar o domínio ao aplicativo Web. Essa abordagem é válida 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

Próximas etapas

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