Tutorial: Mapear um nome DNS personalizado existente para o Serviço de Aplicativo do AzureTutorial: Map an existing custom DNS name to Azure App Service

O Serviço de Aplicativo do Azure fornece um serviço de hospedagem na Web altamente escalonável e com aplicação automática de patches.Azure App Service provides a highly scalable, self-patching web hosting service. Este tutorial mostra como mapear um nome DNS (Sistema de Nomes de Domínio) personalizado existente para o Serviço de Aplicativo.This tutorial shows you how to map an existing custom Domain Name System (DNS) name to App Service.

Captura de tela que mostra a navegação no portal do Azure para um aplicativo do Azure.

Neste tutorial, você aprenderá como:In this tutorial, you learn how to:

  • Mapear um subdomínio (por exemplo, www.contoso.com) usando um registro CNAME.Map a subdomain (for example, www.contoso.com) by using a CNAME record.
  • Mapear um domínio raiz (por exemplo, contoso.com) usando um registro A.Map a root domain (for example, contoso.com) by using an A record.
  • Mapear um domínio curinga (por exemplo, *.contoso.com) usando um registro CNAME.Map a wildcard domain (for example, *.contoso.com) by using a CNAME record.
  • Redirecionar a URL padrão para um diretório personalizado.Redirect the default URL to a custom directory.
  • Automatizar o mapeamento de domínio com scripts.Automate domain mapping with scripts.

Pré-requisitosPrerequisites

Para concluir este tutorial:To complete this tutorial:

  • Crie um aplicativo do Serviço de Aplicativo ou use um aplicativo que você criou para outro tutorial.Create an App Service app, or use an app that you created for another tutorial.

  • Compre um nome de domínio e verifique se você tem acesso ao registro DNS do provedor de domínio (como o GoDaddy).Purchase a domain name, and make sure you have access to the DNS registry for your domain provider (such as GoDaddy).

    Por exemplo, para adicionar entradas DNS a contoso.com e www.contoso.com, você deve poder definir as configurações de DNS do domínio raiz de contoso.com.For example, to add DNS entries for contoso.com and www.contoso.com, you must be able to configure the DNS settings for the contoso.com root domain.

    Observação

    Caso você não tenha um nome de domínio, considere a possibilidade de comprar um domínio usando o portal do Azure.If you don't have an existing domain name, consider purchasing a domain by using the Azure portal.

Preparar o aplicativoPrepare the app

Para mapear um nome DNS personalizado para um aplicativo Web, o Plano do Serviço de Aplicativo do aplicativo Web precisa ser uma camada paga (Compartilhado, Básico, Standard, Premium ou Consumo para o Azure Functions).To map a custom DNS name to a web app, the web app's App Service plan must be a paid tier (Shared, Basic, Standard, Premium, or Consumption for Azure Functions). Nesta etapa, você verifica se o aplicativo do Serviço de Aplicativo está no tipo de preço com suporte.In this step, you make sure that the App Service app is in the supported pricing tier.

Observação

Os planos de hospedagem Gratuito e Compartilhado (versão prévia) do Serviço de Aplicativo são camadas base executadas nas mesmas máquinas virtuais do Azure de outros aplicativos do Serviço de Aplicativo.App Service Free and Shared (preview) hosting plans are base tiers that run on the same Azure virtual machines as other App Service apps. Alguns aplicativos podem pertencer a outros clientes.Some apps might belong to other customers. O uso dessas camadas é voltado somente para desenvolvimento e teste.These tiers are intended to be used only for development and testing purposes.

Entrar no AzureSign in to Azure

Abra o portal do Azure e entre com a sua conta do Azure.Open the Azure portal, and sign in with your Azure account.

Selecionar o aplicativo no Portal do Microsoft AzureSelect the app in the Azure portal

  1. Pesquise e selecione Serviços de Aplicativos.Search for and select App Services.

    Captura de tela que mostra a seleção de Serviços de Aplicativos.

  2. Na página Serviços de Aplicativos, selecione o nome do seu aplicativo do Azure.On the App Services page, select the name of your Azure app.

    Captura de tela mostrando a navegação do portal para um aplicativo do Azure.

A página de gerenciamento do aplicativo do Serviço de Aplicativo é exibida.You see the management page of the App Service app.

Verifique o tipo de preçoCheck the pricing tier

  1. No painel esquerdo da página do aplicativo, role a página até a seção Configurações e selecione Aumentar (Plano do Serviço de Aplicativo) .In the left pane of the app page, scroll to the Settings section and select Scale up (App Service plan).

    Captura de tela que mostra o menu Aumentar (Plano do Serviço de Aplicativo).

  2. A camada atual do aplicativo é realçada por uma borda azul.The app's current tier is highlighted by a blue border. Verifique se o aplicativo não está na camada F1.Check to make sure that the app isn't in the F1 tier. Não há suporte para o DNS personalizado na camada F1.Custom DNS isn't supported in the F1 tier.

    Captura de tela que mostra Tipos de preço recomendados.

  3. Se o Plano do Serviço de Aplicativo não estiver na camada F1, feche a página Aumentar e acesse Mapear um registro CNAME.If the App Service plan isn't in the F1 tier, close the Scale up page and skip to Map a CNAME record.

Escalar verticalmente o plano do Serviço de AplicativoScale up the App Service plan

  1. Selecione qualquer uma das camadas não gratuitas (D1, B1, B2, B3 ou qualquer camada na categoria Produção).Select any of the non-free tiers (D1, B1, B2, B3, or any tier in the Production category). Para obter mais opções, selecione Ver opções adicionais.For additional options, select See additional options.

  2. Selecione Aplicar.Select Apply.

    Captura de tela que mostra como verificar o tipo de preço.

    Quando você receber a notificação a seguir, a operação de escala terá sido concluída.When you see the following notification, the scale operation is complete.

    Captura de tela que mostra a confirmação da operação de escala.

Obter a ID de verificação de domínioGet a domain verification ID

Para adicionar um domínio personalizado ao seu aplicativo, você precisa verificar sua propriedade do domínio adicionando uma ID de verificação como um registro TXT com seu provedor de domínio.To add a custom domain to your app, you need to verify your ownership of the domain by adding a verification ID as a TXT record with your domain provider. No painel esquerdo da página do aplicativo, selecione Domínios personalizados.In the left pane of your app page, select Custom domains. Copie a ID da caixa ID de Verificação de Domínio Personalizado na página Domínios Personalizados para a próxima etapa.Copy the ID in the Custom Domain Verification ID box in the Custom Domains page for the next step.

Captura de tela que mostra a ID na caixa ID de Verificação de Domínio Personalizado.

Aviso

A adição de IDs de verificação de domínio ao domínio personalizado pode impedir entradas DNS pendentes e ajudar a evitar a tomada de controle de subdomínio.Adding domain verification IDs to your custom domain can prevent dangling DNS entries and help to avoid subdomain takeovers. Para obter mais informações sobre essa ameaça comum de alta severidade, confira Tomada de controle de subdomínio.For more information on this common high-severity threat, see Subdomain takeover.

Mapear seu domínioMap your domain

Você pode usar um registro CNAME ou um registro A para mapear um nome DNS personalizado para o serviço de aplicativo.You can use either a CNAME record or an A record to map a custom DNS name to App Service. Siga as respectivas etapas:Follow the respective steps:

Observação

Você deve usar registros CNAME para todos os nomes DNS personalizados, exceto os domínios raiz (por exemplo, contoso.com).You should use CNAME records for all custom DNS names except root domains (for example, contoso.com). Para os domínios raiz, use registros A.For root domains, use A records.

Criar um registro CNAMEMap a CNAME record

No exemplo do tutorial, você adiciona um registro CNAME ao subdomínio www (por exemplo, www.contoso.com).In the tutorial example, you add a CNAME record for the www subdomain (for example, www.contoso.com).

Se você tiver um subdomínio diferente de www, substitua www pelo subdomínio (por exemplo, por sub se o seu domínio personalizado for sub.constoso.com).If you have a subdomain other than www, replace www with your subdomain (for example, with sub if your custom domain is sub.constoso.com).

Acessar registros DNS com o provedor de domínioAccess DNS records with a domain provider

Observação

Você pode usar o DNS do Azure para configurar um nome DNS personalizado para o Serviço de Aplicativo do Azure.You can use Azure DNS to configure a custom DNS name for Azure App Service. 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.

  1. Entre no site de seu provedor de domínio.Sign in to the website of your domain provider.

  2. Localize a página para gerenciamento de registros DNS.Find the page for managing DNS records. Cada provedor de domínio tem sua própria interface de registros DNS; portanto, consulte a documentação do provedor.Every domain provider has its own DNS records interface, so consult the provider's documentation. Procure áreas do site rotuladas como Nome de Domínio, DNS ou Gerenciamento de Servidor de Nomes.Look for areas of the site labeled Domain Name, DNS, or Name Server Management.

    Normalmente, você pode encontrar a página de registros DNS exibindo as informações da conta e procurando um link como Meus domínios.Often, you can find the DNS records page by viewing your account information and then looking for a link such as My domains. Acesse essa página e, em seguida, procure um link com um nome semelhante a Arquivo de zona, Registros DNS ou Configuração avançada.Go to that page, and then look for a link that's named something like Zone file, DNS Records, or Advanced configuration.

    A captura de tela a seguir é um exemplo de uma página de registros DNS:The following screenshot is an example of a DNS records page:

    Captura de tela que mostra um exemplo de página de registros DNS.

  3. Na captura de tela de exemplo, selecione Adicionar para criar um registro.In the example screenshot, select Add to create a record. Alguns provedores têm links diferentes para adicionar tipos de registro diferentes.Some providers have different links to add different record types. Novamente, consulte a documentação do provedor.Again, consult the provider's documentation.

Observação

Para alguns provedores, como GoDaddy, as alterações nos registros DNS só entram em vigor quando você seleciona um link separado Salvar Alterações.For certain providers, such as GoDaddy, changes to DNS records don't become effective until you select a separate Save Changes link.

Criar um registro CNAMECreate the CNAME record

Mapeie um subdomínio para o nome do domínio padrão do aplicativo (<app-name>.azurewebsites.net, em que <app-name> é o nome do aplicativo).Map a subdomain to the app's default domain name (<app-name>.azurewebsites.net, where <app-name> is the name of your app). Para criar um mapeamento CNAME para o subdomínio www, crie dois registros:To create a CNAME mapping for the www subdomain, create two records:

Tipo de registroRecord type HostHost ValorValue ComentáriosComments
CNAMECNAME www <app-name>.azurewebsites.net O mapeamento de domínio em si.The domain mapping itself.
TXTTXT asuid.www A ID de verificação que você obteve anteriormenteThe verification ID you got earlier O Serviço de Aplicativo acessa o registro TXT asuid.<subdomain> para verificar sua propriedade do domínio personalizado.App Service accesses the asuid.<subdomain> TXT record to verify your ownership of the custom domain.

Depois de adicionar os registros CNAME e TXT, a página de registros DNS será parecida com o seguinte exemplo:After you add the CNAME and TXT records, the DNS records page looks like the following example:

Captura de tela que mostra a navegação no portal para um aplicativo do Azure.

Habilitar o mapeamento de registro CNAME no AzureEnable the CNAME record mapping in Azure

  1. No painel esquerdo da página do aplicativo no portal do Azure, selecione Domínios personalizados.In the left pane of the app page in the Azure portal, select Custom domains.

    Captura de tela que mostra o menu Domínios personalizados.

  2. Na página Domínios personalizados do aplicativo, adicione o nome DNS personalizado totalmente qualificado (www.contoso.com) à lista.On the Custom domains page of the app, add the fully qualified custom DNS name (www.contoso.com) to the list.

  3. Selecione Adicionar domínio personalizado.Select Add custom domain.

    Captura de tela que mostra o item Adicionar nome do host.

  4. Digite o nome de domínio totalmente qualificado ao qual você adicionou um registro CNAME, como www.contoso.com.Type the fully qualified domain name that you added a CNAME record for, such as www.contoso.com.

  5. Selecione Validar.Select Validate. A página Adicionar domínio personalizado será exibida.The Add custom domain page appears.

  6. Certifique-se de que Tipo de registro do nome do host esteja definido como CNAME (www.exemplo.com ou qualquer subdomínio) .Make sure that Hostname record type is set to CNAME (www.example.com or any subdomain). Selecione Adicionar domínio personalizado.Select Add custom domain.

    Captura de tela que mostra o botão Adicionar domínio personalizado.

    Pode levar algum tempo para que o novo domínio personalizado seja refletido na página Domínios Personalizados do aplicativo.It might take some time for the new custom domain to be reflected in the app's Custom Domains page. Atualize o navegador para atualizar os dados.Refresh the browser to update the data.

    Captura de tela que mostra como adicionar o registro CNAME.

    Observação

    Um rótulo de aviso do domínio personalizado significa que ele ainda não está associado a um certificado TLS/SSL.A warning label for your custom domain means that it's not yet bound to a TLS/SSL certificate. As solicitações HTTPS de um navegador para o seu domínio personalizado receberão um erro ou um aviso, dependendo do navegador.Any HTTPS request from a browser to your custom domain will receive an error or warning, depending on the browser. Para adicionar uma associação de TLS, confira Proteger um nome DNS personalizado com uma associação TLS/SSL no Serviço de Aplicativo do Azure.To add a TLS binding, see Secure a custom DNS name with a TLS/SSL binding in Azure App Service.

    Se você perdeu uma etapa ou cometeu um erro de digitação em algum lugar anteriormente, verá um erro de verificação na parte inferior da página.If you missed a step or made a typo somewhere earlier, a verification error appears at the bottom of the page.

    Captura de tela que mostra um erro de verificação.

Mapear um registro AMap an A record

No exemplo do tutorial, você adiciona um registro A ao domínio raiz (por exemplo, contoso.com).In the tutorial example, you add an A record for the root domain (for example, contoso.com).

Copiar o endereço IP do aplicativoCopy the app's IP address

Para mapear um registro A, você precisa do endereço IP externo do aplicativo.To map an A record, you need the app's external IP address. Encontre esse endereço IP na página Domínios Personalizados do aplicativo no portal do Azure.You can find this IP address on the app's Custom Domains page in the Azure portal.

  1. No painel esquerdo da página do aplicativo no portal do Azure, selecione Domínios personalizados.In the left pane of the app page in the Azure portal, select Custom domains.

    Captura de tela que mostra o menu Domínios personalizados.

  2. Na página Domínios Personalizados, copie o endereço IP do aplicativo.On the Custom Domains page, copy the app's IP address.

    Captura de tela que mostra a navegação do portal para um aplicativo do Azure.

Acessar registros DNS com o provedor de domínioAccess DNS records with a domain provider

Observação

Você pode usar o DNS do Azure para configurar um nome DNS personalizado para o Serviço de Aplicativo do Azure.You can use Azure DNS to configure a custom DNS name for Azure App Service. 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.

  1. Entre no site de seu provedor de domínio.Sign in to the website of your domain provider.

  2. Localize a página para gerenciamento de registros DNS.Find the page for managing DNS records. Cada provedor de domínio tem sua própria interface de registros DNS; portanto, consulte a documentação do provedor.Every domain provider has its own DNS records interface, so consult the provider's documentation. Procure áreas do site rotuladas como Nome de Domínio, DNS ou Gerenciamento de Servidor de Nomes.Look for areas of the site labeled Domain Name, DNS, or Name Server Management.

    Normalmente, você pode encontrar a página de registros DNS exibindo as informações da conta e procurando um link como Meus domínios.Often, you can find the DNS records page by viewing your account information and then looking for a link such as My domains. Acesse essa página e, em seguida, procure um link com um nome semelhante a Arquivo de zona, Registros DNS ou Configuração avançada.Go to that page, and then look for a link that's named something like Zone file, DNS Records, or Advanced configuration.

    A captura de tela a seguir é um exemplo de uma página de registros DNS:The following screenshot is an example of a DNS records page:

    Captura de tela que mostra um exemplo de página de registros DNS.

  3. Na captura de tela de exemplo, selecione Adicionar para criar um registro.In the example screenshot, select Add to create a record. Alguns provedores têm links diferentes para adicionar tipos de registro diferentes.Some providers have different links to add different record types. Novamente, consulte a documentação do provedor.Again, consult the provider's documentation.

Observação

Para alguns provedores, como GoDaddy, as alterações nos registros DNS só entram em vigor quando você seleciona um link separado Salvar Alterações.For certain providers, such as GoDaddy, changes to DNS records don't become effective until you select a separate Save Changes link.

Criar um conjunto A de registrosCreate the A record

Para mapear um registro A para um aplicativo, geralmente para o domínio raiz, crie dois registros:To map an A record to an app, usually to the root domain, create two records:

Tipo de registroRecord type HostHost ValorValue ComentáriosComments
UmA @ Endereço IP de Copiar o endereço IP do aplicativoIP address from Copy the app's IP address O mapeamento de domínio em si (@ normalmente representa o domínio raiz).The domain mapping itself (@ typically represents the root domain).
TXTTXT asuid A ID de verificação que você obteve anteriormenteThe verification ID you got earlier O Serviço de Aplicativo acessa o registro TXT asuid.<subdomain> para verificar sua propriedade do domínio personalizado.App Service accesses the asuid.<subdomain> TXT record to verify your ownership of the custom domain. Para o domínio raiz, use asuid.For the root domain, use asuid.

Observação

Para adicionar um subdomínio (como www.contoso.com) usando um registro A em vez de um registro CNAME recomendado, o registro A e o registro TXT devem ser parecidos com a seguinte tabela:To add a subdomain (like www.contoso.com) by using an A record instead of a recommended CNAME record, your A record and TXT record should look like the following table instead:

Tipo de registroRecord type HostHost ValorValue
UmA www Endereço IP de Copiar o endereço IP do aplicativoIP address from Copy the app's IP address
TXTTXT asuid.www <app-name>.azurewebsites.net

Quando os registros são adicionados, a página de registros DNS é parecida com o seguinte exemplo:After the records are added, the DNS records page looks like the following example:

Captura de tela que mostra uma página de registros DNS.

Habilitar o mapeamento de registro A no aplicativoEnable the A record mapping in the app

De volta à página Domínios Personalizados do aplicativo no portal do Azure, adicione o nome DNS personalizado totalmente qualificado (por exemplo, contoso.com) à lista.Back in the app's Custom Domains page in the Azure portal, add the fully qualified custom DNS name (for example, contoso.com) to the list.

  1. Selecione Adicionar domínio personalizado.Select Add custom domain.

    Captura de tela que mostra como adicionar um nome do host.

  2. Digite o nome de domínio totalmente qualificado para o qual você configurou o registro A, como contoso.com.Type the fully qualified domain name that you configured the A record for, such as contoso.com.

  3. Selecione Validar.Select Validate. A página Adicionar domínio personalizado é exibida.The Add custom domain page is shown.

  4. Verifique se Tipo de registro de nome de host está definido como Registro A (example.com) .Make sure that Hostname record type is set to A record (example.com). Selecione Adicionar domínio personalizado.Select Add custom domain.

    Captura de tela que mostra como adicionar um nome DNS ao aplicativo.

    Pode levar algum tempo para que o novo domínio personalizado seja refletido na página Domínios Personalizados do aplicativo.It might take some time for the new custom domain to be reflected in the app's Custom Domains page. Atualize o navegador para atualizar os dados.Refresh the browser to update the data.

    Captura de tela que mostra como adicionar um registro A.

    Observação

    Um rótulo de aviso do domínio personalizado significa que ele ainda não está associado a um certificado TLS/SSL.A warning label for your custom domain means that it's not yet bound to a TLS/SSL certificate. As solicitações HTTPS de um navegador para o seu domínio personalizado receberão um erro ou um aviso, dependendo do navegador.Any HTTPS request from a browser to your custom domain will receive an error or warning, depending on the browser. Para adicionar uma associação de TLS, confira Proteger um nome DNS personalizado com uma associação TLS/SSL no Serviço de Aplicativo do Azure.To add a TLS binding, see Secure a custom DNS name with a TLS/SSL binding in Azure App Service.

    Se você perdeu uma etapa ou cometeu um erro de digitação em algum lugar anteriormente, verá um erro de verificação na parte inferior da página.If you missed a step or made a typo somewhere earlier, a verification error appears at the bottom of the page.

    Captura de tela mostrando um erro de verificação.

Mapear um domínio curingaMap a wildcard domain

No exemplo do tutorial, você mapeia um nome DNS curinga (por exemplo, *.contoso.com) para o aplicativo do Serviço de Aplicativo adicionando um registro CNAME.In the tutorial example, you map a wildcard DNS name (for example, *.contoso.com) to the App Service app by adding a CNAME record.

Acessar registros DNS com o provedor de domínioAccess DNS records with a domain provider

Observação

Você pode usar o DNS do Azure para configurar um nome DNS personalizado para o Serviço de Aplicativo do Azure.You can use Azure DNS to configure a custom DNS name for Azure App Service. 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.

  1. Entre no site de seu provedor de domínio.Sign in to the website of your domain provider.

  2. Localize a página para gerenciamento de registros DNS.Find the page for managing DNS records. Cada provedor de domínio tem sua própria interface de registros DNS; portanto, consulte a documentação do provedor.Every domain provider has its own DNS records interface, so consult the provider's documentation. Procure áreas do site rotuladas como Nome de Domínio, DNS ou Gerenciamento de Servidor de Nomes.Look for areas of the site labeled Domain Name, DNS, or Name Server Management.

    Normalmente, você pode encontrar a página de registros DNS exibindo as informações da conta e procurando um link como Meus domínios.Often, you can find the DNS records page by viewing your account information and then looking for a link such as My domains. Acesse essa página e, em seguida, procure um link com um nome semelhante a Arquivo de zona, Registros DNS ou Configuração avançada.Go to that page, and then look for a link that's named something like Zone file, DNS Records, or Advanced configuration.

    A captura de tela a seguir é um exemplo de uma página de registros DNS:The following screenshot is an example of a DNS records page:

    Captura de tela que mostra um exemplo de página de registros DNS.

  3. Na captura de tela de exemplo, selecione Adicionar para criar um registro.In the example screenshot, select Add to create a record. Alguns provedores têm links diferentes para adicionar tipos de registro diferentes.Some providers have different links to add different record types. Novamente, consulte a documentação do provedor.Again, consult the provider's documentation.

Observação

Para alguns provedores, como GoDaddy, as alterações nos registros DNS só entram em vigor quando você seleciona um link separado Salvar Alterações.For certain providers, such as GoDaddy, changes to DNS records don't become effective until you select a separate Save Changes link.

Criar um registro CNAMECreate the CNAME record

Mapeie um nome de domínio curinga * para o nome do domínio padrão do aplicativo (<app-name>.azurewebsites.net, em que <app-name> é o nome do aplicativo).Map a wildcard name * to the app's default domain name (<app-name>.azurewebsites.net, where <app-name> is the name of your app). Para mapear o nome curinga, crie dois registros:To map the wildcard name, create two records:

Tipo de registroRecord type HostHost ValorValue ComentáriosComments
CNAMECNAME * <app-name>.azurewebsites.net O mapeamento de domínio em si.The domain mapping itself.
TXTTXT asuid A ID de verificação que você obteve anteriormenteThe verification ID you got earlier O Serviço de Aplicativo acessa o registro TXT asuid para verificar sua propriedade do domínio personalizado.App Service accesses the asuid TXT record to verify your ownership of the custom domain.

Para o exemplo do domínio *.contoso.com, o registro CNAME mapeará o nome * para <app-name>.azurewebsites.net.For the *.contoso.com domain example, the CNAME record will map the name * to <app-name>.azurewebsites.net.

Quando o CNAME é adicionado, a página de registros DNS fica parecida com o seguinte exemplo:When the CNAME is added, the DNS records page looks like the following example:

Captura de tela que mostra a navegação para um aplicativo do Azure.

Habilitar o mapeamento de registro CNAME no aplicativoEnable the CNAME record mapping in the app

Agora você pode adicionar qualquer subdomínio que corresponda o nome curinga ao aplicativo (por exemplo, sub1.contoso.com, sub2.contoso.com e *.contoso.com correspondem a *.contoso.com).You can now add any subdomain that matches the wildcard name to the app (for example, sub1.contoso.com, sub2.contoso.com and *.contoso.com both match *.contoso.com).

  1. No painel esquerdo da página do aplicativo no portal do Azure, selecione Domínios personalizados.In the left pane of the app page in the Azure portal, select Custom domains.

    Captura de tela que mostra o menu Domínios personalizados.

  2. Selecione Adicionar domínio personalizado.Select Add custom domain.

    Captura de tela que mostra como adicionar um nome do host.

  3. Digite um nome de domínio totalmente qualificado que corresponde ao domínio curinga (por exemplo, sub1.contoso.com) e, em seguida, selecione Validar.Type a fully qualified domain name that matches the wildcard domain (for example, sub1.contoso.com), and then select Validate.

    O botão Adicionar domínio personalizado está ativado.The Add custom domain button is activated.

  4. Certifique-se de que Tipo de registro do nome do host esteja definido como registro CNAME (www.exemplo.com ou qualquer subdomínio) .Make sure that Hostname record type is set to CNAME record (www.example.com or any subdomain). Selecione Adicionar domínio personalizado.Select Add custom domain.

    Captura de tela que mostra como adicionar um nome DNS ao aplicativo.

    Pode levar algum tempo para que o novo domínio personalizado seja refletido na página Domínios Personalizados do aplicativo.It might take some time for the new custom domain to be reflected in the app's Custom Domains page. Atualize o navegador para atualizar os dados.Refresh the browser to update the data.

  5. Selecione o ícone + novamente para adicionar outro domínio personalizado que corresponde ao domínio curinga.Select the + icon again to add another custom domain that matches the wildcard domain. Por exemplo, adicione sub2.contoso.com.For example, add sub2.contoso.com.

    Captura de tela que mostra como adicionar um registro CNAME.

    Observação

    Um rótulo de aviso do domínio personalizado significa que ele ainda não está associado a um certificado TLS/SSL.A warning label for your custom domain means that it's not yet bound to a TLS/SSL certificate. As solicitações HTTPS de um navegador para o seu domínio personalizado receberão um erro ou um aviso, dependendo do navegador.Any HTTPS request from a browser to your custom domain will receive an error or warning, depending on the browser. Para adicionar uma associação de TLS, confira Proteger um nome DNS personalizado com uma associação TLS/SSL no Serviço de Aplicativo do Azure.To add a TLS binding, see Secure a custom DNS name with a TLS/SSL binding in Azure App Service.

Testar em um navegadorTest in a browser

Procure os nomes DNS configurados anteriormente (por exemplo, contoso.com, www.contoso.com, sub1.contoso.com e sub2.contoso.com).Browse to the DNS names that you configured earlier (for example, contoso.com, www.contoso.com, sub1.contoso.com, and sub2.contoso.com).

Captura de tela que mostra a navegação para um aplicativo do Azure.

Resolver 404 "Não Encontrado"Resolve 404 "Not Found"

Se você receber um erro HTTP 404 (Não Encontrado) ao navegar para a URL do seu domínio personalizado, verifique se o domínio é resolvido para o endereço IP do aplicativo usando WhatsmyDNS.net.If you receive an HTTP 404 (Not Found) error when you browse to the URL of your custom domain, verify that your domain resolves to your app's IP address by using WhatsmyDNS.net. Caso contrário, isso poderá ocorrer devido a um dos seguintes motivos:If not, it might be because of one of the following reasons:

  • O domínio personalizado configurado não tem um registro A ou um registro CNAME.The custom domain configured is missing an A record or a CNAME record.
  • O cliente do navegador armazenou em cache o endereço IP antigo do seu domínio.The browser client has cached the old IP address of your domain. Desmarque o cache e teste a resolução DNS novamente.Clear the cache, and test DNS resolution again. Em um computador Windows, limpe o cache com o ipconfig /flushdns.On a Windows machine, you clear the cache with ipconfig /flushdns.

Migrar um domínio ativoMigrate an active domain

Para migrar um site ativo e seu nome de domínio DNS para o Serviço de Aplicativo sem tempo de inatividade, veja Migrar um nome DNS ativo para o Serviço de Aplicativo do Azure.To migrate a live site and its DNS domain name to App Service with no downtime, see Migrate an active DNS name to Azure App Service.

Redirecionar para um diretório personalizadoRedirect to a custom directory

Por padrão, o Serviço de Aplicativo direciona solicitações da Web para o diretório raiz do seu código de aplicativo.By default, App Service directs web requests to the root directory of your app code. No entanto, algumas estruturas da Web não são iniciadas no diretório raiz.But certain web frameworks don't start in the root directory. Por exemplo, Laravel inicia no subdiretório public.For example, Laravel starts in the public subdirectory. Para continuar o exemplo de DNS contoso.com, este aplicativo poderá estar acessível em http://contoso.com/public, mas o ideal é direcionar http://contoso.com para o diretório public.To continue the contoso.com DNS example, such an app is accessible at http://contoso.com/public, but you want to direct http://contoso.com to the public directory instead. Essa etapa não envolve a resolução DNS, mas trata da personalização do diretório virtual.This step doesn't involve DNS resolution but is about customizing the virtual directory.

Para personalizar um diretório virtual, selecione Configurações de aplicativo no painel esquerdo da página do aplicativo Web.To do customize a virtual directory, select Application settings in the left pane of your web app page.

Na parte inferior da página, o diretório virtual raiz / aponta para site\wwwroot por padrão, que é o diretório raiz do seu código de aplicativo.At the bottom of the page, the root virtual directory / points to site\wwwroot by default, which is the root directory of your app code. Altere-o para apontar para o site\wwwroot\public em vez disso, por exemplo, e salve as alterações.Change it to point to the site\wwwroot\public instead, for example, and save your changes.

Captura de tela que mostra como personalizar um diretório virtual.

Após a conclusão da operação, o aplicativo deverá retornar para a página certa no caminho raiz (por exemplo, http://contoso.com).After the operation finishes, your app should return the right page at the root path (for example, http://contoso.com).

Automatizar com scriptsAutomate with scripts

Você pode automatizar o gerenciamento de domínios personalizados com scripts usando a CLI do Azure ou o Azure PowerShell.You can automate management of custom domains with scripts by using the Azure CLI or Azure PowerShell.

CLI do AzureAzure CLI

O comando a seguir adiciona um nome DNS personalizado configurado para um aplicativo de serviço de aplicativo.The following command adds a configured custom DNS name to an App Service app.

az webapp config hostname add \
    --webapp-name <app-name> \
    --resource-group <resource_group_name> \
    --hostname <fully_qualified_domain_name>

Para obter mais informações, consulte Mapear um domínio personalizado para um aplicativo Web.For more information, see Map a custom domain to a web app.

Azure PowerShellAzure PowerShell

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.

O comando a seguir adiciona um nome DNS personalizado configurado para um aplicativo de serviço de aplicativo.The following command adds a configured custom DNS name to an App Service app.

Set-AzWebApp `
    -Name <app-name> `
    -ResourceGroupName <resource_group_name> ` 
    -HostNames @("<fully_qualified_domain_name>","<app-name>.azurewebsites.net")

Para obter mais informações, consulte Atribuir um domínio personalizado para um aplicativo web.For more information, see Assign a custom domain to a web app.

Próximas etapasNext steps

Neste tutorial, você aprendeu a:In this tutorial, you learned how to:

  • Mapear um subdomínio usando um registro CNAME.Map a subdomain by using a CNAME record.
  • Mapear um domínio raiz usando um registro A.Map a root domain by using an A record.
  • Mapear um domínio curinga usando um registro CNAME.Map a wildcard domain by using a CNAME record.
  • Redirecionar a URL padrão para um diretório personalizado.Redirect the default URL to a custom directory.
  • Automatizar o mapeamento de domínio com scripts.Automate domain mapping with scripts.

Prossiga para o próximo tutorial e saiba como associar um certificado TLS/SSL personalizado a um aplicativo Web.Continue to the next tutorial to learn how to bind a custom TLS/SSL certificate to a web app.