Adicionar um domínio personalizado ao Azure Front Door

Importante

O Azure Front Door (clássico) será desativado em 31 de março de 2027. Para evitar qualquer interrupção do serviço, é importante que você migre seus perfis do Azure Front Door (clássico) para a camada Azure Front Door Standard ou Premium até março de 2027. Para obter mais informações, veja Desativação do Azure Front Door (clássico).

Este artigo mostra como adicionar um domínio personalizado ao seu Front Door. Quando você usa o Azure Front Door para distribuir aplicativo, um domínio personalizado será necessário se você quiser que seu próprio nome de domínio fique visível na solicitação do usuário final. Ter um nome de domínio visível pode ser conveniente para os clientes e útil para fins de identidade visual.

Depois de criar um perfil no Front Door, o host de front-end padrão será um subdomínio de azurefd.net. Esse nome está incluído na URL para fornecer conteúdo do Front Door ao seu back-end por padrão. Por exemplo, https://contoso-frontend.azurefd.net. Para sua conveniência, o Azure Front Door oferece a opção de associar um domínio personalizado ao ponto de extremidade. Com esse recurso, você pode entregar seus conteúdos com sua URL em vez do nome de domínio padrão do Front Door, como https://www.contoso.com/photo.png.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Observação

O Front Door não dá suporte a domínios personalizados com caracteres punycode.

Pré-requisitos

Criar um registro DNS CNAME

Antes de usar um domínio personalizado com o Front Door, você precisará criar primeiro um registro CNAME (nome canônico) com seu provedor de domínio para apontar para o host de front-end padrão do Front Door. Um registro CNAME é um tipo de registro DNS que mapeia um nome de domínio de origem para um nome de domínio de destino. No Azure Front Door, o nome de domínio de origem é o seu nome de domínio personalizado e o nome de domínio de destino é nome do host padrão do Front Door. Depois que o Front Door verificar se o registro CNAME foi criado, o tráfego ao domínio personalizado de origem é roteado para o host de front-end padrão do Front Door de destino especificado.

Um domínio personalizado só pode ser associado a um perfil do Front Door por vez. No entanto, você pode ter subdomínios diferentes de um domínio apex no mesmo perfil ou em um perfil diferente do Front Door.

Mapear o subdomínio afdverify temporário

Quando você mapeia um domínio existente que está na produção, algumas coisas devem ser consideradas. Enquanto você estiver registrando seu domínio personalizado no portal do Azure, o domínio poderá sofrer um breve período de tempo de inatividade. Para evitar a interrupção do tráfego da Web, mapeie seu domínio personalizado para seu host de front-end padrão do Front Door com o subdomínio afdverify do Azure primeiro a fim de criar um mapeamento CNAME temporário. Seus usuários podem acessar seu domínio sem interrupção durante o mapeamento de DNS.

Se você estiver usando seu domínio personalizado pela primeira vez sem nenhum tráfego de produção, poderá mapear diretamente seu domínio personalizado para seu Front Door. Você pode pular para Mapear o domínio personalizado permanente.

Para criar um registro CNAME com o subdomínio afdverify:

  1. Entre no site do provedor de domínio relativo ao seu domínio personalizado.

  2. Localize a página de gerenciamento de registros DNS consultando a documentação do provedor ou procurando áreas do site rotuladas como Nome de Domínio, DNS ou Gerenciamento do servidor de nome.

  3. Crie uma entrada de registro CNAME para seu domínio personalizado e conclua os campos conforme mostrado na tabela a seguir (os nomes de campo podem variar):

    Fonte Type Destino
    afdverify. www.contoso.com CNAME afdverify.contoso-frontend.azurefd.net
    • Origem: Insira o nome de domínio personalizado, incluindo o subdomínio afdverify, no seguinte formato: afdverify. <nome de domínio personalizado> . Por exemplo, afdverify. www.contoso.com. Se você estiver mapeando um domínio curinga, como *.contoso.com, o valor de origem será o mesmo que seria sem o curinga: afdverify.contoso.com.

    • Tipo: Insira CNAME.

    • Destino: Insira o host padrão de front-end do Front Door, incluindo o subdomínio afdverify, no seguinte formato: afdverify. <nome do ponto de extremidade> .azurefd.net. Por exemplo, afdverify.contoso-frontend.azurefd.net.

  4. Salve suas alterações.

Por exemplo, o procedimento para o registrador de domínio GoDaddy é o seguinte:

  1. Entre e selecione o domínio personalizado que você deseja usar.

  2. Na seção Domínios, selecione Gerenciar Todos e selecione DNS | Gerenciar Zonas.

  3. Para Nome de Domínio, insira seu domínio personalizado e selecione Pesquisar.

  4. Na página Gerenciamento de DNS, selecione Adicionar e selecione CNAME na lista Tipo.

  5. Preencha os campos abaixo da entrada CNAME:

    • Tipo: Deixe CNAME selecionado.

    • Host: insira o subdomínio do domínio personalizado a ser usado, incluindo o nome de subdomínio afdverify. Por exemplo, afdverify. www.

    • Aponta para: Insira o nome do host padrão de front-end do Front Door, incluindo o nome do subdomínio afdverify. Por exemplo, afdverify.contoso-frontend.azurefd.net.

    • TTL: Deixe a opção uma Hora selecionada.

  6. Clique em Salvar.

    A entrada CNAME é adicionada à tabela de registros DNS.

Associar o domínio personalizado ao seu Front Door

Depois de registrar seu domínio personalizado, adicione-o ao Front Door.

  1. Entre no portal do Azure e navegue até o Front Door que contém o host de front-end que você deseja mapear para um domínio personalizado.

  2. Na página Designer do Front Door, selecione "+" para adicionar um domínio personalizado.

  3. Especifique o Domínio personalizado.

  4. Para o Host de front-end, o host de front-end a ser usado como o domínio de destino do seu registro CNAME é predeterminado e derivado do seu Front Door: <nome do host padrão>.azurefd.net. Ele não pode ser alterado.

  5. Para o Nome de host personalizado, insira seu domínio personalizado, incluindo o subdomínio, para usar como o domínio de origem de seu registro CNAME. Por exemplo, www.contoso.com ou cdn.contoso.com. Não use o nome de subdomínio afdverify.

  6. Selecione Adicionar.

    O Azure verifica se o registro CNAME existe para o nome de domínio personalizado digitado. Se o CNAME estiver correto, seu domínio personalizado será validado.

Aviso

Você precisa garantir que cada um dos hosts de front-end (incluindo domínios personalizados) no seu Front Door tenha uma regra de roteamento com um caminho padrão ("/*") associado a ela. Ou seja, entre todas as suas regras de roteamento, deve haver pelo menos uma para cada um dos seus hosts de front-end definida no caminho padrão ('/*'). Não fazer isso poderá fazer o tráfego do seu usuário final não ser roteado corretamente.

Verificar o domínio personalizado

Depois de concluir o registro do seu domínio personalizado, verifique se o domínio personalizado referencia seu host de front-end padrão do Front Door.

Em seu navegador, navegue até o endereço do arquivo usando o domínio personalizado. Por exemplo, se o seu domínio personalizado for robotics.contoso.com, a URL para o arquivo armazenado em cache deverá ser semelhante à seguinte URL: http://robotics.contoso.com/my-public-container/my-file.jpg. Verifique se o resultado é o mesmo de quando você acessa o Front Door diretamente em <host do Front Door> .azurefd.net.

Mapear o domínio personalizado permanente

Para continuar mapeando o domínio personalizado diretamente para o host de front-end padrão do Front Door, você precisa garantir que o subdomínio afdverify tenha sido mapeado com êxito para o Front Door. Depois de verificado, você pode continuar mapeando o domínio personalizado.

Para criar um registro CNAME para seu domínio personalizado:

  1. Entre no site do provedor de domínio relativo ao seu domínio personalizado.

  2. Localize a página de gerenciamento de registros DNS consultando a documentação do provedor ou procurando áreas do site rotuladas como Nome de Domínio, DNS ou Gerenciamento do Servidor de Nome.

  3. Crie uma entrada de registro CNAME para seu domínio personalizado e conclua os campos conforme mostrado na tabela a seguir (os nomes de campo podem variar):

    Fonte Type Destino
    <www.contoso.com> CNAME contoso-frontend.azurefd.net
    • Origem: insira seu nome de domínio personalizado (por exemplo, www.contoso.com).

    • Tipo: Insira CNAME.

    • Destino: Insira o host padrão de front-end do Front Door. Ele deve estar no seguinte formato: <nomedohost> .azurefd.net. Por exemplo, contoso-frontend.azurefd.net.

  4. Salve suas alterações.

  5. Se anteriormente você criou um registro CNAME do subdomínio afdverify temporário, exclua-o.

  6. Se estiver usando este domínio personalizado na produção pela primeira vez, siga as etapas para Associar o domínio personalizado ao seu Front Door e Verificar o domínio personalizado.

Por exemplo, o procedimento para o registrador de domínio GoDaddy é o seguinte:

  1. Entre e selecione o domínio personalizado que você deseja usar.

  2. Na seção Domínios, selecione Gerenciar Todos e selecione DNS | Gerenciar Zonas.

  3. Para Nome de Domínio, insira seu domínio personalizado e selecione Pesquisar.

  4. Na página Gerenciamento de DNS, selecione Adicionar e selecione CNAME na lista Tipo.

  5. Preencha os campos da entrada CNAME:

    • Tipo: Deixe CNAME selecionado.

    • Host: Insira o subdomínio do domínio personalizado a ser usado. Por exemplo, www ou perfil.

    • Aponta para: Insira o nome do host padrão do Front Door. Por exemplo, contoso.azurefd.net.

    • TTL: Deixe a opção uma Hora selecionada.

  6. Clique em Salvar.

    A entrada CNAME é adicionada à tabela de registros DNS.

  7. Se você tiver um registro CNAME afdverify, selecione o ícone de lápis ao lado dele e o ícone de lixeira.

  8. Selecione Excluir para excluir o registro CNAME.

Limpar os recursos

Nas etapas anteriores, você adicionou um domínio personalizado a um Front Door. Se você não quiser associar seu Front Door a um domínio personalizado, será possível remover o domínio personalizado seguindo estas etapas:

  1. Acesse seu provedor DNS, exclua o registro CNAME para o domínio personalizado ou atualize o registro CNAME para o domínio personalizado para um ponto de extremidade não Front Door.

    Importante

    Para evitar entradas DNS pendente e os riscos de segurança que elas criam, a partir de 9 de abril de 2021, o Azure Front Door requer a remoção dos registros CNAME para pontos de extremidade Front Door antes que os recursos possam ser excluídos. Os recursos incluem domínios personalizados Front Door, pontos de extremidade Front Door ou grupos de recursos do Azure que têm domínios personalizados Front Door habilitados.

  2. No designer do Front Door, selecione o domínio personalizado que você deseja remover.

  3. Selecione Excluir no menu de contexto do domínio personalizado. O domínio personalizado será removido do ponto de extremidade.

Próximas etapas

Neste tutorial, você aprendeu a:

  • Criar um registro DNS CNAME.
  • Associe o domínio personalizado ao seu Front Door.
  • Verificar o domínio personalizado.

Para saber como habilitar o HTTPS para o domínio personalizado, prossiga para o próximo tutorial.