Tutorial: Mapear um nome DNS personalizado existente para o Serviço de Aplicativo do Azure

O Serviço de Aplicativo do Azure fornece um serviço de hospedagem na Web altamente escalonável e com aplicação automática de patches. Este tutorial mostra como mapear um nome DNS (Sistema de Nomes de Domínio) personalizado existente para o Serviço de Aplicativo. Para migrar um site ativo e seu nome de domínio DNS para o Serviço de Aplicativo sem tempo de inatividade, veja Migrar um nome DNS ativo do Azure.

Neste tutorial, você aprenderá como:

  • Mapear um subdomínio usando um registro CNAME.
  • Mapear um domínio raiz usando um registro A.
  • Mapear um domínio curinga usando um registro CNAME.
  • Redirecionar a URL padrão para um diretório personalizado.

1. Prepare o seu ambiente

  • Crie um aplicativo do Serviço de Aplicativo ou use um aplicativo que você criou para outro tutorial. O plano do serviço de aplicativo do aplicativo Web deve ser uma camada paga e não livre (F1). Confira Escalar um aplicativo para atualizar a camada.
  • Verifique se você pode editar os registros DNS de seu domínio personalizado. Para editar registros DNS, você precisa acessar o registro DNS do seu provedor de domínio, como o GoDaddy. Por exemplo, para adicionar entradas DNS a contoso.com e www.contoso.com, você deve poder definir as configurações de DNS do domínio raiz de contoso.com. Seus domínios personalizados devem estar em uma zona DNS pública; a zona DNS privada só tem suporte no ASE (Ambiente do Serviço de Aplicativo) do ILB (Load Balancer interno).
  • Se você ainda não tem um domínio personalizado, pode comprar um domínio do Serviço de Aplicativo.

2. Obter a ID de verificação de domínio

Entrar no Azure

Abra o portal do Azure e entre com a sua conta do Azure.

Selecionar o aplicativo no Portal do Microsoft Azure

  1. Pesquise e selecione Serviços de Aplicativos.

    Captura de tela que mostra a seleção de Serviços de Aplicativos.

  2. Na página Serviços de Aplicativos, selecione o nome do seu aplicativo do Azure.

    Captura de tela mostrando a navegação do portal para um aplicativo do Azure.

    A página de gerenciamento do aplicativo do Serviço de Aplicativo é exibida.

    Para adicionar um domínio personalizado ao seu aplicativo, você precisa verificar sua propriedade do domínio adicionando uma ID de verificação como um registro TXT com seu provedor de domínio.

  3. No painel esquerdo da página do aplicativo, selecione Domínios personalizados.

  4. Copie a ID da caixa ID de Verificação de Domínio Personalizado na página Domínios Personalizados para a próxima etapa.

    Captura de tela que mostra a ID na caixa ID de Verificação de Domínio Personalizado.

    Aviso

    A adição de IDs de verificação de domínio ao domínio personalizado pode impedir entradas DNS pendentes e ajudar a evitar a tomada de controle de subdomínio. Para os domínios personalizados configurados anteriormente sem essa ID de verificação, você deverá protegê-los do mesmo risco adicionando a ID de verificação ao seu registro DNS. Para obter mais informações sobre essa ameaça comum de alta severidade, confira Tomada de controle de subdomínio.

  1. (Somente um registro) Para mapear um registro A, você precisa do endereço IP externo do aplicativo. Na página Domínios personalizados, copie o valor do endereço IP.

    Captura de tela que mostra a navegação do portal para um aplicativo do Azure.

3. Criar os registros DNS

  1. Entre no site de seu provedor de domínio.

    É possível usar o DNS do Azure para gerenciar registros DNS para seu domínio e configurar um nome DNS personalizado para o Serviço de Aplicativo do Azure. Para saber mais, confira Tutorial: Hospede seu domínio no DNS do Azure.

  2. Localize a página para gerenciamento de registros DNS.

    Cada provedor de domínio tem sua própria interface de registros DNS; portanto, consulte a documentação do provedor. Procure áreas do site rotuladas como Nome de Domínio, DNS ou Gerenciamento de Servidor de Nomes.

    Normalmente, você pode encontrar a página de registros DNS exibindo as informações da conta e procurando um link como Meus domínios. Acesse essa página e, em seguida, procure um link com um nome semelhante a Arquivo de zona, Registros DNS ou Configuração avançada.

    A captura de tela a seguir é um exemplo de uma página de registros DNS:

    Captura de tela que mostra um exemplo de página de registros DNS.

  3. Selecione Adicionar ou o widget adequado para criar um registro.

  4. Selecione o tipo de registro a ser criado e siga as instruções. Você pode usar um registro CNAME ou um registro A para mapear um nome DNS personalizado para o serviço de aplicativo.

Tipos de registro DNS

Cenário Exemplo Registro DNS recomendado
Domínio raiz contoso.com Registro A. Não use o registro CNAME para o registro raiz (para obter informações, confira RFC 1912 Seção 2.4).
Subdomínio www.contoso.com, my.contoso.com registro CNAME Você pode mapear um subdomínio para o endereço IP do aplicativo diretamente com um registro A, mas é possível que o endereço IP seja alterado. O CNAME é mapeado para o nome do host padrão do aplicativo, que é menos suscetível a alterações.
Curinga *.contoso.com registro CNAME
  • Para um domínio raiz como contoso.com, crie dois registros de acordo com a seguinte tabela:

    Tipo de registro Host Valor Comentários
    Um @ Endereço IP de Copiar o endereço IP do aplicativo O mapeamento de domínio em si (@ normalmente representa o domínio raiz).
    TXT asuid A ID de verificação que você obteve anteriormente Para domínio raiz, o Serviço de Aplicativo acessa o registro TXT asuid para verificar sua propriedade do domínio personalizado

    Captura de tela que mostra uma página de registros DNS.

  • Para mapear um subdomínio como www.contoso.com com um registro A em vez de um registro CNAME recomendado, o seu registro A e o registro TXT devem se parecer com a seguinte tabela:

    Tipo de registro Host Valor Comentários
    Um <subdomínio> (por exemplo, www) Endereço IP de Copiar o endereço IP do aplicativo
    TXT asuid.<subdomínio> (por exemplo, asuid.www) A ID de verificação que você obteve anteriormente

    Captura de tela de uma página de registros DNS.

Observação

Para alguns provedores, como GoDaddy, as alterações nos registros DNS só entram em vigor quando você seleciona um link separado Salvar Alterações.

4. Habilitar o mapeamento no aplicativo

Depois de criar registros DNS, você habilita o mapeamento em seu aplicativo.

  1. No painel esquerdo da página do aplicativo no portal do Azure, selecione Domínios personalizados.

    Captura de tela que mostra o menu Domínios personalizados.

  2. Selecione Adicionar domínio personalizado.

    Captura de tela que mostra o item Adicionar nome do host.

  3. Digite o nome de domínio totalmente qualificado para o qual você configurou o registro A, como contoso.com.

  4. Selecione Validar. A página Adicionar domínio personalizado é exibida.

  5. Verifique se Tipo de registro de nome de host está definido como Registro A (example.com) . Selecione Adicionar domínio personalizado.

    Captura de tela que mostra como adicionar um nome DNS ao aplicativo.

    Pode levar algum tempo para que o novo domínio personalizado seja refletido na página Domínios Personalizados do aplicativo. Atualize o navegador para atualizar os dados.

    Captura de tela que mostra como adicionar um registro A.

    Observação

    Um rótulo de aviso do domínio personalizado significa que ele ainda não está associado a um certificado TLS/SSL. As solicitações HTTPS de um navegador para o seu domínio personalizado receberão um erro ou um aviso, dependendo do navegador. Para adicionar uma associação de TLS, confira Proteger um nome DNS personalizado com uma associação TLS/SSL no Serviço de Aplicativo do Azure.

    Se você perdeu uma etapa ou cometeu um erro de digitação em algum lugar anteriormente, verá um erro de verificação na parte inferior da página.

    Captura de tela mostrando um erro de verificação.

5. Testar em um navegador

Procure os nomes DNS configurados anteriormente.

Captura de tela que mostra a navegação para um aplicativo do Azure.

Se você receber um erro HTTP 404 (Não Encontrado) ao navegar até a URL do seu domínio personalizado, as duas causas mais comuns serão:

  • O domínio personalizado configurado não tem um registro A ou um registro CNAME. Você pode ter excluído o registro DNS depois de habilitar o mapeamento no seu aplicativo. Verifique se os registros DNS estão configurados corretamente usando uma ferramenta de pesquisa de DNS online.
  • O cliente do navegador armazenou em cache o endereço IP antigo do seu domínio. Desmarque o cache e teste a resolução DNS novamente. Em um computador Windows, limpe o cache com o ipconfig /flushdns.

(Adicional) Automatizar com scripts

Você pode automatizar o gerenciamento de domínios personalizados com scripts usando a CLI do Azure ou o Azure PowerShell.

O comando a seguir adiciona um nome DNS personalizado configurado para um aplicativo de serviço de aplicativo.

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

Para obter mais informações, consulte Mapear um domínio personalizado para um aplicativo Web.

Próximas etapas