Mapear um domínio personalizado para um ponto de extremidade do Armazenamento de Blobs do Azure

É possível mapear um domínio personalizado para um ponto de extremidade de serviço Blob ou um ponto de extremidade de site estático.

Mapear um domínio personalizado somente com HTTP habilitado

Essa abordagem é mais fácil, mas só permite o acesso HTTP. Se a conta de armazenamento estiver configurada para exigir a transferência segura via HTTPS, será necessário habilitar o acesso HTTPS para o domínio personalizado.

Para habilitar o acesso HTTPS, veja a seção Mapear um domínio personalizado com HTTPS habilitado deste artigo.

Mapear um domínio personalizado

Se você estiver preocupado com o fato de o domínio estar brevemente indisponível para seus usuários, siga estas etapas.

✔️ Etapa 1: Obter o nome do host do ponto de extremidade de armazenamento.

✔️ Etapa 2: Criar um registro de nome canônico (CNAME) com o provedor de domínio.

✔️ Etapa 3: Registrar o domínio personalizado no Azure.

✔️ Etapa 4: Testar o domínio personalizado.

Etapa 1: Obter o nome do host do ponto de extremidade de armazenamento

O nome do host é a URL do ponto de extremidade de armazenamento sem o identificador de protocolo nem a barra à direita.

1. No portal do Microsoft Azure, acesse sua conta de armazenamento.

2. No painel do menu, em Configurações, selecione Pontos de extremidade.

3. Copie o valor do ponto de extremidade do serviço Blob ou o ponto de extremidade do site estático para um arquivo de texto.

   Observação

   Não há suporte para o ponto de extremidade de armazenamento do Data Lake (por exemplo: https://mystorageaccount.dfs.core.windows.net/).

4. Remova o identificador de protocolo (por exemplo: HTTPS) e a barra à direita dessa cadeia de caracteres de caracteres. A tabela a seguir contém exemplos.

   Tipo de ponto de extremidade	endpoint	nome de host
   serviço blob	https://mystorageaccount.blob.core.windows.net/	mystorageaccount.blob.core.windows.net
   site estático	https://mystorageaccount.z5.web.core.windows.net/	mystorageaccount.z5.web.core.windows.net

   Defina esse valor para mais tarde.

Etapa 2: Criar um registro de nome canônico (CNAME) com o provedor de domínio

Crie um registro CNAME para apontar para o nome do host. Um registro CNAME é um tipo de registro DNS (Sistemas de Nomes de Domínio) que mapeia um nome de domínio de origem para um nome de domínio de destino.

1. Entre no site do registrador de domínios e acesse a página para gerenciar as configurações DNS.

   Você pode encontrar a página em uma seção denominada Domain Name, DNS ou Name Server Management.

2. Localize a seção para gerenciar os registros CNAMEs.

   Talvez seja necessário acessar uma página de configurações avançadas e procurar CNAME, Alias ou Subdomínios.

3. Crie um registro CNAME. Como parte desse registro, forneça os seguintes itens:

   • O alias de subdomínio, como www ou photos. O subdomínio é necessário, não há suporte para domínios raiz.

   • O nome do host que você obteve na seção Obter o nome do host do ponto de extremidade de armazenamento anteriormente neste artigo.

Etapa 3: Registrar o domínio personalizado com o Azure

Set-AzStorageAccount -ResourceGroupName <resource-group-name> -Name <storage-account-name> -CustomDomainName <custom-domain-name> -UseSubDomain $false

az storage account update \
   --resource-group <resource-group-name> \ 
   --name <storage-account-name> \
   --custom-domain <custom-domain-name> \
   --use-subdomain false

Etapa 4: Testar o domínio personalizado

Para confirmar que seu domínio personalizado está mapeado para o ponto de extremidade do serviço de blob, crie um blob em um contêiner público em sua conta de armazenamento. Em seguida, em um navegador da Web, acesse o blob usando um URI no seguinte formato: http://<subdomain.customdomain>/<mycontainer>/<myblob>

Por exemplo, para acessar um formulário da Web no contêiner myforms do subdomínio personalizado photos.contoso.com, é possível usar o seguinte URI: http://photos.contoso.com/myforms/applicationform.htm

Mapear um domínio personalizado com tempo de inatividade zero

Se o domínio atualmente oferecer suporte a um aplicativo com um SLA (contrato de nível de serviço) que exija tempo de inatividade zero, siga as etapas a seguir para garantir que os usuários possam acessar o domínio enquanto o mapeamento DNS ocorrer.

✔️ Etapa 1: Obter o nome do host do ponto de extremidade de armazenamento.

✔️ Etapa 2: Criar um registro de nome canônico (CNAME) intermediário com o provedor de domínio.

✔️ Etapa 3: Registrar previamente o domínio personalizado no Azure.

✔️ Etapa 4: Criar um registro CNAME com o provedor de domínio.

✔️ Etapa 5: Testar o domínio personalizado.

Etapa 1: Obter o nome do host do ponto de extremidade de armazenamento

O nome do host é a URL do ponto de extremidade de armazenamento sem o identificador de protocolo nem a barra à direita.

1. No portal do Microsoft Azure, acesse sua conta de armazenamento.

2. No painel do menu, em Configurações, selecione Pontos de extremidade.

3. Copie o valor do ponto de extremidade do serviço Blob ou o ponto de extremidade do site estático para um arquivo de texto.

4. Remova o identificador de protocolo (por exemplo: HTTPS) e a barra à direita dessa cadeia de caracteres de caracteres. A tabela a seguir contém exemplos.

   Tipo de ponto de extremidade	endpoint	nome de host
   serviço blob	https://mystorageaccount.blob.core.windows.net/	mystorageaccount.blob.core.windows.net
   site estático	https://mystorageaccount.z5.web.core.windows.net/	mystorageaccount.z5.web.core.windows.net

   Defina esse valor para mais tarde.

Etapa 2: Criar um registro de nome canônico (CNAME) intermediário com o provedor de domínio

Crie um registro CNAME temporário para apontar para o nome do host. 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.

1. Entre no site do registrador de domínios e acesse a página para gerenciar as configurações DNS.

   Você pode encontrar a página em uma seção denominada Domain Name, DNS ou Name Server Management.

2. Localize a seção para gerenciar os registros CNAMEs.

   Talvez seja necessário acessar uma página de configurações avançadas e procurar CNAME, Alias ou Subdomínios.

3. Crie um registro CNAME. Como parte desse registro, forneça os seguintes itens:

   • O alias de subdomínio, como www ou photos. O subdomínio é necessário, não há suporte para domínios raiz.

     Adicione o subdomínio asverify ao alias. Por exemplo: asverify.www ou asverify.photos.

   • O nome do host que você obteve na seção Obter o nome do host do ponto de extremidade de armazenamento anteriormente neste artigo.

     Adicione o subdomínio asverify ao nome do host. Por exemplo: asverify.mystorageaccount.blob.core.windows.net.

Etapa 3: Registrar previamente o domínio personalizado com o Azure

Ao registrar previamente o domínio personalizado com o Azure, você permite que o Azure reconheça o domínio personalizado sem precisar modificar o registro DNS do domínio. Dessa forma, quando você modificar o registro DNS do domínio, ele será mapeado para o ponto de extremidade do blob sem nenhum tempo de inatividade.

Set-AzStorageAccount -ResourceGroupName <resource-group-name> -Name <storage-account-name> -CustomDomainName <custom-domain-name> -UseSubDomain $true

az storage account update \
   --resource-group <resource-group-name> \ 
   --name <storage-account-name> \
   --custom-domain <custom-domain-name> \
   --use-subdomain true

Etapa 4: Criar um registro CNAME com o provedor de domínio

Crie um registro CNAME temporário para apontar para o nome do host.

1. Entre no site do registrador de domínios e acesse a página para gerenciar as configurações DNS.

   Você pode encontrar a página em uma seção denominada Domain Name, DNS ou Name Server Management.

2. Localize a seção para gerenciar os registros CNAMEs.

   Talvez seja necessário acessar uma página de configurações avançadas e procurar CNAME, Alias ou Subdomínios.

3. Crie um registro CNAME. Como parte desse registro, forneça os seguintes itens:

   • O alias de subdomínio, como www ou photos. O subdomínio é necessário, não há suporte para domínios raiz.

   • O nome do host que você obteve na seção Obter o nome do host do ponto de extremidade de armazenamento anteriormente neste artigo.

Etapa 5: Testar o domínio personalizado

Para confirmar que seu domínio personalizado está mapeado para o ponto de extremidade do serviço de blob, crie um blob em um contêiner público em sua conta de armazenamento. Em seguida, em um navegador da Web, acesse o blob usando um URI no seguinte formato: http://<subdomain.customdomain>/<mycontainer>/<myblob>

Por exemplo, para acessar um formulário da Web no contêiner myforms do subdomínio personalizado photos.contoso.com, é possível usar o seguinte URI: http://photos.contoso.com/myforms/applicationform.htm

Remover um mapeamento de domínio personalizado

Para remover um mapeamento de domínio personalizado, cancele o registro do domínio personalizado. Use um dos procedimentos a seguir.

Mapear um domínio personalizado com HTTPS habilitado

Essa abordagem envolve mais etapas, mas habilita o acesso HTTPS. Se você não precisar que os usuários acessem seu conteúdo do blob ou da Web usando HTTPS, veja a seção Mapear um domínio personalizado com apenas o HTTP habilitado neste artigo. A abordagem envolve o uso do Azure Front Door (preferencial) ou da CDN do Azure, que são serviços de Rede de Distribuição de Conteúdo oferecidos pelo Azure.

Como usar o Azure Front Door

1. Habilite o Azure Front Door no ponto de extremidade do blob ou do site.

   Para obter etapas, consulte Como integre uma conta de Armazenamento do Azure ao Azure Front Door.

2. Como configurar um domínio personalizado para o Azure Front Door.

3. Como configurar o HTTPS em um domínio personalizado do Azure Front Door.

   Observação

   Ao atualizar seu site estático, certifique-se de limpar o conteúdo em cache nos POPs de borda do AFD, limpando o endpoint do AFD. Para obter mais informações, consulte Limpeza de cache no Azure Front Door.

4. (Opcional) Examine as seguintes diretrizes:

   • Aprenda como usar o Azure Front Door com blobs do Armazenamento do Azure.
   • Saiba como habilitar o Link Privado do Azure Front Door com o Armazenamento de Blobs do Azure.
   • Saiba como habilitar o Link Privado do Azure Front Door com o Site Estático de Armazenamento.
   • Redirecionamento de HTTP para HTTPS com o AFD.
   • Cobrança do Front Door.

Usando o Azure CDN

1. Habilite a CDN do Azure no blob ou no ponto de extremidade da Web. Para obter diretrizes passo a passo, consulte Integrar uma conta de armazenamento do Azure à CDN do Azure.

2. Mapeie conteúdo da CDN do Azure para um domínio personalizado.

3. Habilite HTTPS em um domínio personalizado da CDN do Azure.

   Observação

   Ao atualizar o site estático, limpe o conteúdo armazenado em cache nos servidores de borda da CDN limpando o ponto de extremidade da CDN. Para obter mais informações, confira Como limpar um ponto de extremidade do CDN do Azure.

4. (Opcional) Examine as seguintes diretrizes:

   • Tokens SAS (assinatura de acesso compartilhado) com a CDN do Azure.

   • Redirecionamento de HTTP para HTTPS com a CDN do Azure.

   • Preços e cobrança ao usar o Armazenamento de Blobs com a CDN do Azure.

Suporte a recursos

O suporte para esse recurso pode ser afetado ao habilitar o Data Lake Storage Gen2, o protocolo NFS (Sistema de Arquivos de Rede) 3.0 ou o protocolo SFTP (Protocolo de Transferência de Arquivo SSH). Se você tiver habilitado qualquer um desses recursos, consulte o Suporte a recursos de Armazenamento de Blobs nas contas de Armazenamento do Azure para avaliar o suporte para esse recurso.

Próximas etapas

• Saiba mais sobre a hospedagem de sites estáticos no Armazenamento de Blobs do Azure