Adicionar um domínio personalizado ao Azure Front Door

Aplica-se a: ✔️ Porta da frente (clássico)

Important

Azure Front Door (classic) é descontinuado a 31 de março de 2027. Como o serviço está a encerrar-se, já não suporta criação de perfil, integração de novos domínios ou certificados geridos. Para evitar interrupções no serviço, migre para Azure Front Door Standard ou Premium. Para mais informações, consulte a descontinuação do Azure Front Door (clássico).

Este artigo mostra como adicionar um domínio personalizado à sua porta da frente. Quando você usa o Azure Front Door para entrega de aplicativos, um domínio personalizado é necessário se você quiser que seu próprio nome de domínio fique visível em sua solicitação de usuário final. Ter um nome de domínio visível pode ser conveniente para os seus clientes e útil para fins de imagem corporativa.

Depois de criar um perfil do Front Door, o host frontend padrão é um subdomínio de azurefd.net. Esse nome é incluído na URL para entregar conteúdo da 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 endereço. Com esse recurso, você pode entregar seu conteúdo com sua URL em vez do nome de domínio padrão da Front Door, como https://www.contoso.com/photo.png.

Se não tiver uma conta do Azure, crie uma conta gratuita antes de começar.

Note

Front Door não suporta domínios personalizados com caracteres punycode.

Prerequisites

  • Para concluir os passos neste tutorial, tem primeiro de criar um Front Door. Para obter mais informações, veja Quickstart: Create a Front Door (Início Rápido: Criar um Front Door).

  • Se você ainda não tiver um domínio personalizado, primeiro deverá comprar um com um provedor de domínio. Por exemplo, veja Buy a custom domain name (Comprar um nome de domínio personalizado).

  • Se estiver a utilizar o Azure para alojar os seus domínios DNS, tem de delegar o sistema de nomes de domínio (DNS) do fornecedor de domínio a um DNS do Azure. Para obter mais informações, veja Delegar um domínio ao DNS do Azure. Caso contrário, se estiver a utilizar um fornecedor de domínio para tratar o seu domínio DNS, continue para criar um registo de DNS CNAME.

Criar um registo DNS CNAME

Antes de poder usar um domínio personalizado com o Front Door, você deve primeiro criar um registro de nome canônico (CNAME) com seu provedor de domínio para apontar para o host frontend padrão do Front Door. Um registo CNAME é um tipo de registo 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 é seu nome de domínio personalizado e o nome de domínio de destino é seu nome de host padrão do Front Door. Depois que o Front Door verifica que o registo CNAME foi criado, o tráfego para o domínio personalizado de origem é encaminhado para o host frontend padrão de destino especificado.

Um domínio personalizado só pode ser associado a um perfil do Front Door de cada vez. No entanto, pode ter diferentes subdomínios de um domínio de ápice no mesmo perfil ou num perfil do Front Door diferente.

Mapeie o subdomínio temporário afdverify

Quando mapeias um domínio existente em produção, considera o impacto. Enquanto você registra seu domínio personalizado no portal do Azure, pode ocorrer um breve período de inatividade para o domínio. Para evitar a interrupção do tráfego web, mapeie o seu domínio personalizado para o seu host frontend predefinido Front Door usando primeiro o subdomínio Azure afdverify para criar um mapeamento CNAME temporário. Seus usuários podem acessar seu domínio sem interrupção quando o mapeamento DNS ocorre.

Caso esteja a usar o seu domínio personalizado pela primeira vez sem tráfego de produção, pode mapear diretamente o seu domínio personalizado para o Front Door. Você pode avançar para Mapear o domínio personalizado permanente.

Para criar um registo CNAME usando o subdomínio afdverify:

  1. Inicie sessão no site do fornecedor do domínio para o seu domínio personalizado.

  2. Encontre a página para gerir registos DNS consultando a documentação do fornecedor ou procurando áreas do site denominadas Nome de Domínio, DNS ou Gestão de Servidores de Nomes.

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

    Source Tipo Destination
    afdverify.www.contoso.com CNAME afdverify.contoso-frontend.azurefd.net
    • Fonte: Insira o seu nome de domínio personalizado, incluindo o afdverify subdomínio, no seguinte formato: afdverify.<custom domain name>. Por exemplo, afdverify.www.contoso.com. Se estiver a mapear um domínio wildcard, como *.contoso.com, o valor de origem é o mesmo que seria sem o wildcard: afdverify.contoso.com.

    • Tipo: Introduza CNAME.

    • Destino: Insira o seu host frontend Front Door predefinido, incluindo o subdomínio afdverify, no seguinte formato: afdverify.<endpoint name>.azurefd.net. Por exemplo, afdverify.contoso-frontend.azurefd.net.

  4. Guardar as suas alterações.

Por exemplo, o procedimento para a entidade de registo de domínios GoDaddy é o seguinte:

  1. Inicie sessão e selecione o domínio personalizado que pretende utilizar.

  2. Na secção de Domínios, selecione Gerir Tudo e depois selecione Gestão de Zonas DNS | .

  3. Para Nome de Domínio, introduza o seu domínio personalizado e depois selecione Pesquisar.

  4. Na página de Gestão de DNS , selecione Adicionar e depois selecione CNAME na lista de Tipos .

  5. Preencha os seguintes campos da entrada de CNAME:

    • Type (Tipo): deixe CNAME selecionado.

    • Host: Introduza o subdomínio do seu domínio personalizado para uso, incluindo o nome do subdomínio afdverify. Por exemplo, afdverify.www.

    • Aponta para: introduza o nome do host do seu frontend do Front Door predefinido, incluindo o nome de subdomínio afdverify. Por exemplo, afdverify.contoso-frontend.azurefd.net.

    • TTL: Deixe uma hora selecionada.

  6. Selecione Guardar.

    A entrada CNAME é adicionada à tabela de registos DNS.

Associe o domínio personalizado ao Front Door

Depois de registares o teu domínio personalizado, adiciona-o à tua Porta da Frente.

  1. Inicie sessão no portal do Azure e navegue para o Front Door que contém o anfitrião de front-end que quer mapear para um domínio personalizado.

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

  3. Especifique o Domínio personalizado.

  4. Para Host Frontend, o host frontend a ser usado como domínio de destino do seu registo CNAME é predeterminado e é derivado do seu Front Door: <hostname padrão>.azurefd.net. Não é possível alterá-lo.

  5. Para o Nome de anfitrião personalizado, introduza o seu domínio personalizado, incluindo o subdomínio para utilizar como o domínio de origem do seu registo de CNAME. Por exemplo, www.contoso.com ou cdn.contoso.com. Não use o nome do subdomínio afdverify.

  6. Selecione Adicionar.

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

Warning

Você deve garantir que cada um dos hosts front-end (incluindo domínios personalizados) em sua Front Door tenha uma regra de roteamento com um caminho padrão ('/*') associado a ela. Ou seja, em todas as suas regras de roteamento, deve haver pelo menos uma regra de roteamento para cada um dos hosts frontend definidos no caminho padrão ('/*'). Se não configurares esta definição, o tráfego do teu utilizador final pode não ser encaminhado corretamente.

Verificar o domínio personalizado

Depois de concluir o registro do seu domínio personalizado, verifique se o domínio personalizado faz referência ao seu host frontend padrão da Front Door.

No seu navegador, vá ao endereço do ficheiro usando o domínio personalizado. Por exemplo, se o seu domínio personalizado for robotics.contoso.com, o URL do ficheiro em cache deve ser semelhante ao seguinte URL: http://robotics.contoso.com/my-public-container/my-file.jpg. Verifique se o resultado é o mesmo que quando acede diretamente à Porta Principal no <Front Door host.azurefd.net>.

Mapear o domínio personalizado permanente

Para mapear o domínio personalizado diretamente para o seu host frontend Front Door padrão, certifique-se primeiro de que o subdomínio afdverify está mapeado com sucesso para o seu Front Door. Uma vez verificado, você pode continuar com o mapeamento do domínio personalizado.

Para criar um registo CNAME para o domínio personalizado:

  1. Inicie sessão no site do fornecedor do domínio para o seu domínio personalizado.

  2. Encontre a página para gerir registos DNS consultando a documentação do fornecedor ou procurando áreas do site denominadas Nome de Domínio, DNS ou Gestão de Servidores de Nomes.

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

    Source Tipo Destination
    <www.contoso.com> CNAME contoso-frontend.azurefd.net
    • Insira o seu nome de domínio personalizado (por exemplo, www.contoso.com) na fonte:

    • Type (Tipo): introduza CNAME.

    • Destino: Introduza o endereço predefinido de front-end do Front Door. Tem de estar no formato <nome do anfitrião>.azurefd.net. Por exemplo, contoso-frontend.azurefd.net.

  4. Guardar as suas alterações.

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

  6. Se estiver a usar este domínio personalizado em produção pela primeira vez, siga os passos para Associar o domínio personalizado com o seu Front Door e Verificar o domínio personalizado.

Por exemplo, o procedimento para a entidade de registo de domínios GoDaddy é o seguinte:

  1. Inicie sessão e selecione o domínio personalizado que pretende utilizar.

  2. Na secção de Domínios, selecione Gerir Tudo e depois selecione Gestão de Zonas DNS | .

  3. Para Nome de Domínio, introduza o seu domínio personalizado e depois selecione Pesquisar.

  4. Na página de Gestão de DNS , selecione Adicionar e depois selecione CNAME na lista de Tipos .

  5. Preencha os campos da entrada de CNAME:

    • Type (Tipo): deixe CNAME selecionado.

    • Host (Anfitrião): introduza o subdomínio do domínio personalizado que vai utilizar. Por exemplo, www ou perfil.

    • Aponta para: Introduza o nome de anfitrião predefinido do Front Door. Por exemplo, contoso.azurefd.net.

    • TTL: Deixe uma hora selecionada.

  6. Selecione Guardar.

    A entrada CNAME é adicionada à tabela de registos DNS.

  7. Se tiveres um registo CNAME do afdverify, seleciona o ícone de lápis ao lado e depois o ícone do caixote do lixo.

  8. Selecione Delete para eliminar o registo CNAME.

Limpar recursos

Nos passos anteriores, adicionou um domínio personalizado a um Front Door. Se já não quiser associar o seu Front Door a um domínio personalizado, remova o domínio personalizado seguindo estes passos:

  1. Vai ao teu fornecedor DNS e apaga o registo CNAME do domínio personalizado ou atualiza o registo CNAME do domínio personalizado para um endpoint que não seja Front Door.

    Important

    Para evitar entradas DNS pendentes e os riscos de segurança que estes criam, a partir de 9 de abril de 2021, o Azure Front Door exige a remoção dos registos CNAME para os endpoints Front Door antes de poder eliminar os recursos. Os recursos incluem domínios personalizados Front Door, endpoints Front Door ou grupos de recursos Azure que têm domínios personalizados Front Door ativados.

  2. No estruturador do Front Door, selecione o domínio personalizado que quer remover.

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

Próximo passo