Adicionar um domínio personalizado ao Azure Front Door

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 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 fornece a opção de associar um domínio personalizado ao ponto de extremidade. Com esse recurso, você pode entregar seu conteúdo com sua URL em vez do nome de domínio padrão da Front Door, https://www.contoso.com/photo.pngcomo .

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

Nota

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

Pré-requisitos

  • 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 a Criar um registo 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 registro CNAME é criado, o tráfego para o domínio personalizado de origem é roteado para o host frontend padrão de destino especificado.

Um domínio personalizado só pode ser associado a um perfil de porta frontal de cada vez. No entanto, você pode ter diferentes subdomínios de um domínio do ápice no mesmo perfil ou em um perfil de porta da frente diferente.

Mapeie o subdomínio afdverify temporário

Quando você mapeia um domínio existente que está em produção, há coisas consideradas. Enquanto você registra seu domínio personalizado no portal do Azure, um breve período de inatividade para o domínio pode ocorrer. Para evitar a interrupção do tráfego da Web, mapeie seu domínio personalizado para o host front-end padrão do Front Door com o subdomínio afdverify do Azure primeiro para criar um mapeamento CNAME temporário. Seus usuários podem acessar seu domínio sem interrupção quando o mapeamento DNS ocorre.

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

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

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

  2. Encontre a página de gestão dos registos DNS ao consultar a documentação do fornecedor ou ao procurar áreas do Web site com o nome Domain Name (Nome de domínio), DNS ou Name server management (Gestão de servidores de nomes).

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

    Source Tipo Destino
    afdverify.www.contoso.com CNAME afdverify.contoso-frontend.azurefd.net
    • Origem: introduza 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.

    • Type (Tipo): introduza CNAME.

    • Destino: introduza o anfitrião de front-end do Front Door predefinido, incluindo o subdomínio afdverify, no seguinte formato: afdverify.<nome do ponto final>.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 Domínios, selecione Manage All (Gerir Tudo) e selecione DNS | Manage Zones (Gerir Zonas).

  3. Em Domain Name (Nome de Domínio), introduza o domínio personalizado e selecione Search (Pesquisar).

  4. Na página DNS Management (Gestão de DNS), selecione Add (Adicionar) e selecione CNAME na lista Type (Tipo).

  5. Preencha os seguintes campos da entrada de CNAME:

    • Type (Tipo): deixe CNAME selecionado.

    • Anfitrião: introduza o subdomínio do domínio personalizado que vai utilizar, incluindo o nome de subdomínio afdverify. Por exemplo, afdverify.www.

    • Aponta para: introduza o nome do seu anfitrião de front-end 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.

Associar o domínio personalizado ao Front Door

Depois de registar o domínio personalizado, pode adicioná-lo ao Front Door.

  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 do designer 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 registro CNAME é predeterminado e é derivado do seu Front Door: <default hostname.azurefd.net>. Não pode ser alterado.

  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.

Aviso

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 seus hosts frontend definidos no caminho padrão ('/*'). Não o fazer pode resultar no tráfego de utilizador final 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 browser, utilize o domínio personalizado para navegar para o endereço do ficheiro. Por exemplo, se o 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. Confirme que o resultado é igual ao resultado que viu quando acedeu ao Front Door diretamente em <anfitrião do Front Door>.azurefd.net.

Mapear o domínio personalizado permanente

Se você verificou que o subdomínio afdverify foi mapeado com êxito para sua Front Door, você pode mapear o domínio personalizado diretamente para seu host frontend padrão Front Door.

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

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

  2. Encontre a página de gestão dos registos DNS ao consultar a documentação do fornecedor ou ao procurar áreas do Web site com o nome Domain Name (Nome de domínio), DNS ou Name server management (Gestão de servidores de nomes).

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

    Source Tipo Destino
    <www.contoso.com> CNAME contoso-frontend.azurefd.net
    • Source: introduza o nome de domínio personalizado (por exemplo, www.contoso.com).

    • Type (Tipo): introduza CNAME.

    • Destino: introduza o anfitrião de front-end do Front Door predefinido. 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 tiver criado anteriormente um registo CNAME para o subdomínio afdverify temporário, elimine-o.

  6. Se você estiver usando esse domínio personalizado em produção pela primeira vez, siga as etapas para Associar o domínio personalizado à sua porta da frente 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 Domínios, selecione Manage All (Gerir Tudo) e selecione DNS | Manage Zones (Gerir Zonas).

  3. Em Domain Name (Nome de Domínio), introduza o domínio personalizado e selecione Search (Pesquisar).

  4. Na página DNS Management (Gestão de DNS), selecione Add (Adicionar) e selecione CNAME na lista Type (Tipo).

  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 do 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 tiver um registo CNAME afdverify, selecione o ícone de lápis junto ao mesmo e, em seguida, selecione o ícone de caixote do lixo.

  8. Selecione Delete para eliminar o registo CNAME.

Clean up resources (Limpar recursos)

Nos passos anteriores, adicionou um domínio personalizado a um Front Door. Se você não quiser mais associar sua Front Door a um domínio personalizado, poderá remover o domínio personalizado seguindo estas etapas:

  1. Vá para seu provedor de 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 que não seja Front Door.

    Importante

    Para evitar entradas DNS pendentes e os riscos de segurança que elas criam, a partir de 9 de abril de 2021, o Azure Front Door exige 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 da Front Door, pontos de extremidade da Front Door ou grupos de recursos do Azure que têm domínio(s) personalizado(s) da Front Door habilitados.

  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óximos passos

Neste tutorial, ficou a saber como:

  • Criar um registo DNS CNAME.
  • Associar o domínio personalizado ao Front Door.
  • Verificar o domínio personalizado.

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