Configurar um nome de domínio personalizado para sua conta de armazenamento do AzureConfigure a custom domain name for your Azure storage account

Você pode configurar um domínio personalizado para acessar os dados de blob em sua conta de armazenamento do Azure.You can configure a custom domain for accessing blob data in your Azure storage account. O endpoint padrão do armazenamento de Blobs do Azure é <nome da conta de armazenamento>.blob.core.windows.net.The default endpoint for Azure Blob storage is <storage-account-name>.blob.core.windows.net. Você também pode usar o ponto de extremidade da Web que é gerado como parte do recurso de sites estáticos.You can also use the web endpoint that's generated as a part of the static websites feature. Se você mapear um domínio e subdomínio personalizados, como www.contoso.com, para o BLOB ou ponto de extremidade da Web para sua conta de armazenamento, os usuários poderão usar esse domínio para acessar dados de BLOB em sua conta de armazenamento.If you map a custom domain and subdomain, such as www.contoso.com, to the blob or web endpoint for your storage account, your users can use that domain to access blob data in your storage account.

Importante

O Armazenamento do Azure ainda não dá suporte nativo a HTTPS com domínios personalizados.Azure Storage does not yet natively support HTTPS with custom domains. Você pode atualmente Usar o CDN do Azure para acessar blobs usando domínios personalizados em HTTPS.You can currently Use Azure CDN to access blobs by using custom domains over HTTPS.

Observação

Contas de armazenamento atualmente suportam a apenas um nome de domínio personalizado por conta.Storage accounts currently support only one custom domain name per account. Você não pode mapear um nome de domínio personalizado para os pontos de extremidade de serviços da Web e de blob.You can't map a custom domain name to both the web and blob service endpoints.

Observação

O mapeamento só funciona para subdomínios (por exemplo, www.contoso.com).The mapping does only work for subdomains (e.g. www.contoso.com). Se você quiser ter o ponto de extremidade da Web disponível no domínio raiz (por exemplo, contoso.com), precisará Adicionar um domínio personalizado ao ponto de extremidade da CDN do Azure.If you want to have your web endpoint available on the root domain (e.g. contoso.com), then you have to Add a custom domain to your Azure CDN endpoint.

A tabela a seguir mostra algumas URLs de amostra para dados de blobs localizados em uma conta de armazenamento denominada mystorageaccount.The following table shows a few sample URLs for blob data that's located in a storage account named mystorageaccount. O subdomínio personalizado registrado para a conta de armazenamento é contoso.com da.Web:The custom subdomain that's registered for the storage account is www.contoso.com:

Tipo de recursoResource type URL padrãoDefault URL URL de domínio personalizadaCustom domain URL
Conta de armazenamentoStorage account http://mystorageaccount.blob.core.windows.nethttp://mystorageaccount.blob.core.windows.net http://www.contoso.comhttp://www.contoso.com
BlobBlob http://mystorageaccount.blob.core.windows.net/mycontainer/myblobhttp://mystorageaccount.blob.core.windows.net/mycontainer/myblob http://www.contoso.com/MyContainer/myblobhttp://www.contoso.com/mycontainer/myblob
Contêiner raizRoot container http://mystorageaccount.blob.Core.Windows.net/myblob ou http://mystorageaccount.blob.Core.Windows.net/$root/myblobhttp://mystorageaccount.blob.core.windows.net/myblob or http://mystorageaccount.blob.core.windows.net/$root/myblob http://www.contoso.com/myblob ou http://www.contoso.com/$root/myblobhttp://www.contoso.com/myblob or http://www.contoso.com/$root/myblob
WebWeb http://mystorageaccount. [ Zone]. Web. Core. Windows. NET/$Web/[indexdoc] ou http://mystorageaccount. [ Zone]. Web. Core. Windows. net/[indexdoc] ou http://mystorageaccount. [ Zone]. Web. Core. Windows. NET/$Web ou http://mystorageaccount. [ Zone]. Web. Core. Windows. net/http://mystorageaccount.[zone].web.core.windows.net/$web/[indexdoc] or http://mystorageaccount.[zone].web.core.windows.net/[indexdoc] or http://mystorageaccount.[zone].web.core.windows.net/$web or http://mystorageaccount.[zone].web.core.windows.net/ http://www.contoso.com/$Web ou http://www.contoso.com/ou http://www.contoso.com/$Web/[indexdoc] ou http://www.contoso.com/[indexdoc]http://www.contoso.com/$web or http://www.contoso.com/ or http://www.contoso.com/$web/[indexdoc] or http://www.contoso.com/[indexdoc]

Observação

Conforme mostrado nas seções a seguir, todos os exemplos para o terminal de serviço de blob também se aplicam ao terminal de serviço da web.As shown in the following sections, all examples for the blob service endpoint also apply to the web service endpoint.

Mapeamento de CNAME direto vs. intermediárioDirect vs. intermediary CNAME mapping

Você pode apontar seu domínio personalizado prefixado com um subdomínio (por exemplo., www contoso.com) para o ponto de extremidade de BLOB para sua conta de armazenamento de uma das duas maneiras:You can point your custom domain prefixed with a subdomain (e.g. www.contoso.com) to the blob endpoint for your storage account in either of two ways:

  • Use o mapeamento de CNAME direto.Use direct CNAME mapping.
  • Use o subdomínio intermediário asverify.Use the asverify intermediary subdomain.

Mapeamento direto de CNAMEDirect CNAME mapping

O primeiro método, que é também o mais simples, é criar um registro de nome canônico (CNAME) que mapeia seu domínio e subdomínio personalizados diretamente para o ponto de extremidade do blob.The first, and simplest, method is to create a canonical name (CNAME) record that maps your custom domain and subdomain directly to the blob endpoint. Um registro CNAME é um recurso de DNS que mapeia um domínio de origem a um domínio de destino.A CNAME record is a domain name system (DNS) feature that maps a source domain to a destination domain. Em nosso exemplo, o domínio de origem é seu próprio domínio e subdomínio personalizados (.www contoso.com, por exemplo).In our example, the source domain is your own custom domain and subdomain (www.contoso.com, for example). O domínio de destino é o ponto de extremidade de serviço de blob (mystorageaccount.blob.core.windows.net, por exemplo).The destination domain is your blob service endpoint (mystorageaccount.blob.core.windows.net, for example).

O método direto é coberto na seção "Registrar um domínio personalizado".The direct method is covered in the "Register a custom domain" section.

Mapeamento intermediário com asverifyIntermediary mapping with asverify

O segundo método também usa registros CNAME.The second method also uses CNAME records. Para evitar o tempo de inatividade, no entanto, ele primeiro emprega um subdomínio especial asverify que é reconhecido pelo Azure.To avoid downtime, however, it first employs a special subdomain asverify that's recognized by Azure.

O mapeamento do seu domínio personalizado para um ponto de extremidade de blob pode causar um breve período de inatividade enquanto você registra o domínio no portal do Microsoft Azure.Mapping your custom domain to a blob endpoint can cause a brief period of downtime while you are registering the domain in the Azure portal. Se o domínio atualmente oferecer suporte a um aplicativo com um contrato de nível de serviço (SLA) que exija tempo de inatividade zero, use o subdomínio asverify do Azure como uma etapa de registro intermediária.If the domain currently supports an application with a service-level agreement (SLA) that requires zero downtime, use the Azure asverify subdomain as an intermediate registration step. Essa etapa garante que os usuários podem acessar seu domínio enquanto ocorre o mapeamento de DNS.This step ensures that users can access your domain while the DNS mapping takes place.

O método intermediário é coberto em Registre um domínio personalizado usando o subdomínio asverify.The intermediary method is covered in Register a custom domain by using the asverify subdomain.

Registrar um domínio personalizadoRegister a custom domain

Registre o domínio usando o procedimento nesta seção se as seguintes instruções se aplicarem:Register the domain by using the procedure in this section if the following statements apply:

  • Você não está preocupado com o fato de o domínio estar brevemente indisponível para seus usuários.You are unconcerned that the domain is briefly unavailable to your users.
  • Seu domínio personalizado não está hospedando um aplicativo no momento.Your custom domain is not currently hosting an application.

Você pode usar o DNS do Azure para configurar um nome DNS personalizado para a sua loja Blob do Azure.You can use Azure DNS to configure a custom DNS name for your Azure Blob store. Para obter mais informações, consulte Usar o DNS do Azure para fornecer as configurações de domínio personalizadas para um serviço do Azure.For more information, see Use Azure DNS to provide custom domain settings for an Azure service.

Se o seu domínio personalizado atualmente suporta um aplicativo que não pode ter nenhum tempo de inatividade, use o procedimento em Registre um domínio personalizado usando o subdomínio asverify.If your custom domain currently supports an application that cannot have any downtime, use the procedure in Register a custom domain by using the asverify subdomain.

Para configurar um nome de domínio personalizado, crie um novo registro CNAME no DNS.To configure a custom domain name, create a new CNAME record in DNS. O registro CNAME especifica um alias para um nome de domínio.The CNAME record specifies an alias for a domain name. No nosso exemplo, ele mapeia o endereço do seu domínio personalizado para o endpoint de armazenamento do Blob da sua conta de armazenamento.In our example, it maps the address of your custom domain to your storage account's Blob storage endpoint.

Normalmente, você pode gerenciar as configurações de DNS do seu domínio no site do registrador de domínios.You can usually manage your domain's DNS settings on your domain registrar's website. Cada registrador tem um método semelhante, mas ligeiramente diferente, para especificar um registro CNAME, mas o conceito é o mesmo.Each registrar has a similar but slightly different method of specifying a CNAME record, but the concept is the same. Como alguns pacotes básicos de registro de domínio não oferecem configuração de DNS, talvez seja necessário atualizar seu pacote de registro de domínio para poder criar o registro CNAME.Because some basic domain registration packages don't offer DNS configuration, you might need to upgrade your domain registration package before you can create the CNAME record.

  1. No portal do Microsoft Azure, acesse sua conta de armazenamento.In the Azure portal, go to your storage account.

  2. No painel de menu, em Serviço de Blob, selecione Domínio personalizado.In the menu pane, under Blob Service, select Custom domain.
    O painel Domínio personalizado é aberto.The Custom domain pane opens.

  3. Faça login no site do registrador de domínios e vá para a página de gerenciamento de DNS.Sign in to your domain registrar's website, and then go to the page for managing DNS.
    Você pode encontrar a página em uma seção denominada Domain Name, DNS ou Name Server Management.You might find the page in a section named Domain Name, DNS, or Name Server Management.

  4. Localize a seção de gerenciamento de CNAMEs.Find the section for managing CNAMEs.
    Talvez seja necessário acessar uma página de configurações avançadas e procurar CNAME, Alias ou Subdomínios.You might have to go to an advanced settings page and look for CNAME, Alias, or Subdomains.

  5. Crie um novo registro CNAME, insira um alias de subdomínio, como www ou photos (subdomínio é necessário, não há suporte para domínios raiz) e forneça um nome de host.Create a new CNAME record, enter a subdomain alias such as www or photos (subdomain is required, root domains are not supported), and then provide a host name.
    O nome do host é o ponto de extremidade de serviço de blob.The host name is your blob service endpoint. Seu formato é <mystorageaccount>.blob.core.windows.net, onde mystorageaccount é o nome da sua conta de armazenamento.Its format is <mystorageaccount>.blob.core.windows.net, where mystorageaccount is the name of your storage account. O nome do host a ser usado aparece no item #1 do painel Domínio personalizado no portal do Microsoft Azure.The host name to use appears in item #1 of the Custom domain pane in the Azure portal.

  6. No painel Domínio personalizado, na caixa de texto, insira o nome do seu domínio personalizado, incluindo o subdomínio.In the Custom domain pane, in the text box, enter the name of your custom domain, including the subdomain.
    Por exemplo, se seu domínio for contoso.com e o alias de subdomínio for www, digite.www contoso.com.For example, if your domain is contoso.com and your subdomain alias is www, enter www.contoso.com. Se o seu subdomínio for photos, digite photos.contoso.com.If your subdomain is photos, enter photos.contoso.com.

  7. Para registrar seu domínio personalizado, selecione Salvar.To register your custom domain, select Save.
    Se o registro for bem-sucedido, o portal notificará que sua conta de armazenamento foi atualizada com sucesso.If the registration is successful, the portal notifies you that your storage account was successfully updated.

Depois que seu novo registro CNAME for propagado pelo DNS, se os usuários tiverem as permissões apropriadas, eles poderão visualizar os dados de blob usando seu domínio personalizado.After your new CNAME record has propagated through DNS, if your users have the appropriate permissions, they can view blob data by using your custom domain.

Registre um domínio personalizado usando o subdomínio asverifyRegister a custom domain by using the asverify subdomain

Se o seu domínio personalizado atualmente suporta um aplicativo com um SLA que exige que não haja tempo de inatividade, registre seu domínio personalizado usando o procedimento desta seção.If your custom domain currently supports an application with an SLA that requires that there be no downtime, register your custom domain by using the procedure in this section. Criando um CNAME que aponta de comoverify.<subdomínio>.<customdomain> to asverify.<storageaccount> .blob.core.windows.net, você pode pré-registrar seu domínio com o Azure.By creating a CNAME that points from asverify.<subdomain>.<customdomain> to asverify.<storageaccount>.blob.core.windows.net, you can pre-register your domain with Azure. Você pode criar um segundo CNAME que aponte para o <subdomínio>.<customdomain> para <storageaccount>.blob.core.windows.net e, em seguida, o tráfego para o seu domínio personalizado é direcionado ao seu ponto de extremidade de blob.You can then create a second CNAME that points from <subdomain>.<customdomain> to <storageaccount>.blob.core.windows.net, and then traffic to your custom domain is directed to your blob endpoint.

O subdomínio asverify é um subdomínio especial reconhecido pelo Azure.The asverify subdomain is a special subdomain recognized by Azure. Ao adicionar asverify ao seu próprio subdomínio, você permite que o Azure reconheça seu domínio personalizado sem precisar modificar o registro DNS do domínio.By prepending asverify to your own subdomain, you permit Azure to recognize your custom domain without having to modify the DNS record for the domain. Quando você modificar o registro DNS do domínio, ele será mapeado para o ponto de extremidade do blob sem nenhum tempo de inatividade.When you do modify the DNS record for the domain, it will be mapped to the blob endpoint with no downtime.

  1. No portal do Microsoft Azure, acesse sua conta de armazenamento.In the Azure portal, go to your storage account.

  2. No painel de menu, em Serviço de Blob, selecione Domínio personalizado.In the menu pane, under Blob Service, select Custom domain.
    O painel Domínio personalizado é aberto.The Custom domain pane opens.

  3. Entre no site do provedor de DNS e vá para a página de gerenciamento de DNS.Sign in to your DNS provider's website, and then go to the page for managing DNS.
    Você pode encontrar a página em uma seção denominada Domain Name, DNS ou Name Server Management.You might find the page in a section named Domain Name, DNS, or Name Server Management.

  4. Localize a seção de gerenciamento de CNAMEs.Find the section for managing CNAMEs.
    Talvez seja necessário acessar uma página de configurações avançadas e procurar CNAME, Alias ou Subdomínios.You might have to go to an advanced settings page and look for CNAME, Alias, or Subdomains.

  5. Crie um novo registro CNAME, forneça um alias de subdomínio que inclua o subdomínio asverify, como asverify.www ou asverify.photos, e forneça um nome de host.Create a new CNAME record, provide a subdomain alias that includes the asverify subdomain, such as asverify.www or asverify.photos, and then provide a host name.
    O nome do host é o ponto de extremidade de serviço de blob.The host name is your blob service endpoint. Seu formato é asverify.<mystorageaccount> .blob.core.windows.net, onde mystorageaccount é o nome da sua conta de armazenamento.Its format is asverify.<mystorageaccount>.blob.core.windows.net, where mystorageaccount is the name of your storage account. O nome de host a ser usado aparece no item #2 dos domínio personalizado painel na portal do Azure.The host name to use appears in item #2 of the Custom domain pane in the Azure portal.

  6. No painel Domínio personalizado, na caixa de texto, insira o nome do seu domínio personalizado, incluindo o subdomínio.In the Custom domain pane, in the text box, enter the name of your custom domain, including the subdomain.
    Não inclua asverify.Do not include asverify. Por exemplo, se seu domínio for contoso.com e o alias de subdomínio for www, digite.www contoso.com.For example, if your domain is contoso.com and your subdomain alias is www, enter www.contoso.com. Se o seu subdomínio for photos, digite photos.contoso.com.If your subdomain is photos, enter photos.contoso.com.

  7. Selecione a caixa de seleção Usar validação de CNAME indireta.Select the Use indirect CNAME validation check box.

  8. Para registrar seu domínio personalizado, selecione Salvar.To register your custom domain, select Save.
    Se o registro for bem-sucedido, o portal notificará que sua conta de armazenamento foi atualizada com sucesso.If the registration is successful, the portal notifies you that your storage account was successfully updated. Seu domínio personalizado foi verificado pelo Azure, mas o tráfego para seu domínio ainda não está sendo encaminhado para sua conta de armazenamento.Your custom domain has been verified by Azure, but traffic to your domain is not yet being routed to your storage account.

  9. Volte ao site do provedor de DNS e crie outro registro CNAME que mapeie seu subdomínio para o ponto de extremidade do serviço de blob.Return to your DNS provider's website, and then create another CNAME record that maps your subdomain to your blob service endpoint.
    Por exemplo, especifique o subdomínio como www ou fotos (sem o asverify) e especifique o nome do host como <mystorageaccount>.blob. core.windows.net, onde mystorageaccount é o nome da sua conta de armazenamento.For example, specify the subdomain as www or photos (without the asverify) and specify the host name as <mystorageaccount>.blob.core.windows.net, where mystorageaccount is the name of your storage account. Com essa etapa, o registro do seu domínio personalizado está concluído.With this step, the registration of your custom domain is complete.

  10. Por fim, você pode excluir o registro CNAME recém-criado que contém o subdomínio asverify, que era necessário apenas como uma etapa intermediária.Finally, you can delete the newly created CNAME record that contains the asverify subdomain, which was required only as an intermediary step.

Depois que seu novo registro CNAME for propagado pelo DNS, se os usuários tiverem as permissões apropriadas, eles poderão visualizar os dados de blob usando seu domínio personalizado.After your new CNAME record has propagated through DNS, if your users have the appropriate permissions, they can view blob data by using your custom domain.

Testar seu domínio personalizadoTest your custom domain

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.To confirm that your custom domain is mapped to your blob service endpoint, create a blob in a public container within your storage account. Em seguida, em um navegador da Web, acesse o blob usando um URI no seguinte formato: http://<subdomain.customdomain>/<mycontainer>/<myblob>Then, in a web browser, access the blob by using a URI in the following format: http://<subdomain.customdomain>/<mycontainer>/<myblob>

Por exemplo, para acessar um formulário da web no contêiner myforms no subdomínio personalizado photos.contoso.com, você pode usar o seguinte URI: http://photos.contoso.com/myforms/applicationform.htmFor example, to access a web form in the myforms container in the photos.contoso.com custom subdomain, you might use the following URI: http://photos.contoso.com/myforms/applicationform.htm

Cancelar o registro de um domínio personalizadoDeregister a custom domain

Para cancelar o registro de um domínio personalizado para seu ponto de extremidade do Armazenamento de Blobs, use um dos procedimentos a seguir.To deregister a custom domain for your Blob storage endpoint, use one of the following procedures.

Portal do AzureAzure portal

Para remover a configuração do domínio personalizado, faça o seguinte:To remove the custom domain setting, do the following:

  1. No portal do Microsoft Azure, acesse sua conta de armazenamento.In the Azure portal, go to your storage account.

  2. No painel de menu, em Serviço de Blob, selecione Domínio personalizado.In the menu pane, under Blob Service, select Custom domain.
    O painel Domínio personalizado é aberto.The Custom domain pane opens.

  3. Limpe o conteúdo da caixa de texto que contém seu nome de domínio personalizado.Clear the contents of the text box that contains your custom domain name.

  4. Selecione o botão Salvar.Select the Save button.

Depois que o domínio personalizado for removido com sucesso, você verá uma notificação do portal informando que sua conta de armazenamento foi atualizada com sucesso.After the custom domain has been removed successfully, you will see a portal notification that your storage account was successfully updated.

CLI do AzureAzure CLI

Para remover um registro de domínio personalizado, use o comando da CLI az storage account e, em seguida, especifique uma cadeia vazia ("") para o valor do argumento --custom-domain.To remove a custom domain registration, use the az storage account update CLI command, and then specify an empty string ("") for the --custom-domain argument value.

  • Formato do comando:Command format:

    az storage account update \
        --name <storage-account-name> \
        --resource-group <resource-group-name> \
        --custom-domain ""
    
  • Exemplo de comando:Command example:

    az storage account update \
        --name mystorageaccount \
        --resource-group myresourcegroup \
        --custom-domain ""
    

PowerShellPowerShell

Observação

Este artigo foi atualizado para usar o novo módulo Az do Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Você ainda pode usar o módulo AzureRM, que continuará a receber as correções de bugs até pelo menos dezembro de 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para saber mais sobre o novo módulo Az e a compatibilidade com o AzureRM, confira Apresentação do novo módulo Az do Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obter instruções de instalação do módulo Az, confira Instalar o Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Para remover um registro de domínio personalizado, use o cmdlet Set-AzStorageAccount do PowerShell e especifique uma sequência vazia ("") para o valor do argumento -CustomDomainName.To remove a custom domain registration, use the Set-AzStorageAccount PowerShell cmdlet, and then specify an empty string ("") for the -CustomDomainName argument value.

  • Formato do comando:Command format:

    Set-AzStorageAccount `
        -ResourceGroupName "<resource-group-name>" `
        -AccountName "<storage-account-name>" `
        -CustomDomainName ""
    
  • Exemplo de comando:Command example:

    Set-AzStorageAccount `
        -ResourceGroupName "myresourcegroup" `
        -AccountName "mystorageaccount" `
        -CustomDomainName ""
    

Próximas etapasNext steps