Create DNS records in a custom domain for a web app

• An Azure account with an active subscription. Create an account for free.

• An Azure account with an active subscription. Create an account for free.

• Azure Cloud Shell or Azure PowerShell.

  The steps in this tutorial run the Azure PowerShell cmdlets interactively in Azure Cloud Shell. To run the commands in the Cloud Shell, select Open Cloud shell at the upper-right corner of a code block. Select Copy to copy the code and then paste it into Cloud Shell to run it. You can also run the Cloud Shell from within the Azure portal.

  You can also install Azure PowerShell locally to run the cmdlets. The steps in this article require Azure PowerShell module version 5.4.1 or later. Run Get-Module -ListAvailable Az to find your installed version. If you need to upgrade, see Update the Azure PowerShell module.

If you don't have an Azure account, create a free account before you begin.

• Use the Bash environment in Azure Cloud Shell. For more information, see Get started with Azure Cloud Shell.

  

• If you prefer to run CLI reference commands locally, install the Azure CLI. If you're running on Windows or macOS, consider running Azure CLI in a Docker container. For more information, see How to run the Azure CLI in a Docker container.

  • If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see Authenticate to Azure using Azure CLI.

  • When you're prompted, install the Azure CLI extension on first use. For more information about extensions, see Use and manage extensions with the Azure CLI.

  • Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.

1. Sign in to the Azure portal.

2. In the search box at the top of the portal, enter App Services, and select it from the results.

3. Select your web app from the list.

4. In the left navigation of the App Services page in the Azure portal, expand Settings, then select Custom domains, then copy the IP address of your web app:

To get the IP address of your web app, use:

$params = @{
    ResourceGroupName = "<your web app resource group>"
    Name = "contoso"
}
$webapp = Get-AzWebApp @params
($webapp.OutboundIpAddresses -split ',')[0].Trim()

To get the IP address of your web app, use:

# Get the inbound IP address
az webapp show \
    --resource-group "test-rg" \
    --name "web-app" \
    --query "outboundIpAddresses" \
    --output tsv | cut -d',' -f2

1. In the search box at the top of the portal, enter DNS zones, and select it from the results.

2. Select your DNS zone from the list.

3. Select + Record sets at the top of the Overview page of your DNS zone.

4. Select + Add.

5. On the Add record set page, enter the following information:

   Setting	Value
   Name	@ (represents the root domain)
   Type	A
   TTL	600
   TTL unit	Seconds
   IP address	Enter the IP address of your web app (copied from the previous step)

6. Select Add to create the record.

To create the A record, use:

$recordParams = @{
    Name = "@"
    RecordType = "A"
    ZoneName = "contoso.com"
    ResourceGroupName = "test-rg"
    Ttl = 600
    DnsRecords = (New-AzDnsRecordConfig -IPv4Address "<ip of web app service>")
}
New-AzDnsRecordSet @recordParams

To create the A record, use:

# Create the A record set
az network dns record-set a create \
    --resource-group test-rg \
    --zone-name contoso.com \
    --name "@" \
    --ttl 600

# Add the IP address to the A record set
az network dns record-set a add-record \
    --resource-group test-rg \
    --zone-name contoso.com \
    --record-set-name "@" \
    --ipv4-address "<ip of web app service>"

1. In the search box at the top of the portal, enter DNS zones, and select it from the results.

2. Select your DNS zone from the list.

3. Select + Record sets at the top of the Overview page of your DNS zone.

4. Select + Add.

5. On the Add record set page, enter the following information:

   Setting	Value
   Name	@ (represents the root domain)
   Type	TXT
   TTL	600
   TTL unit	Seconds
   Value	Enter your web app's default domain name (for example, contoso.azurewebsites.net)

6. Select Add to create the record.

To create the TXT record, use:

$txtRecordParams = @{
    ZoneName = "contoso.com"
    ResourceGroupName = "test-rg"
    Name = "@"
    RecordType = "txt"
    Ttl = 600
    DnsRecords = (New-AzDnsRecordConfig -Value "contoso.azurewebsites.net")
}
New-AzDnsRecordSet @txtRecordParams

To create the TXT record, use:

az network dns record-set txt add-record \
    --resource-group test-rg \
    --zone-name contoso.com \
    --record-set-name "@" \
    --value "contoso.azurewebsites.net"

1. In the search box at the top of the portal, enter DNS zones, and select it from the results.

2. Select your DNS zone from the list.

3. Select + Record sets at the top of the Overview page of your DNS zone.

4. Select + Add.

5. On the Add record set page, enter the following information:

   Setting	Value
   Name	www
   Type	CNAME
   TTL	600
   TTL unit	Seconds
   Alias	Enter your web app's default domain name (for example, contoso.azurewebsites.net)

6. Select Add to create the record.

$cnameRecordParams = @{
    ZoneName = "contoso.com"
    ResourceGroupName = "test-rg"
    Name = "www"
    RecordType = "CNAME"
    Ttl = 600
    DnsRecords = (New-AzDnsRecordConfig -cname "contoso.azurewebsites.net")
}
New-AzDnsRecordSet @cnameRecordParams

# Create the CNAME record
az network dns record-set cname set-record \
    --resource-group test-rg \
    --zone-name contoso.com \
    --record-set-name "www" \
    --cname "contoso.azurewebsites.net" \
    --ttl 600

1. In the search box at the top of the portal, enter App Services, and select it from the results.

2. Select your web app from the list.

3. Expand Settings in the left navigation, then select Custom domains.

4. Select + Add custom domain.

5. In + Add custom domain dialog, enter the following information:

   Setting	Value
   Domain provider	Select All other services
   TLS/SSL certificate	Select None (you can add an TLS/SSL certificate later)
   TLS/SSL type	Select SNI SSL
   Domain	Enter your domain name (for example, contoso.com)

   The domain validation sees the records you created in the previous steps.

6. Select Validate. Azure validates that the DNS records you created are properly configured.

7. Select Add.

8. The domain you added is now listed in the Custom domains section.

9. Repeat steps 3-8 for each custom domain you want to add (both contoso.com and www.contoso.com).

$webAppParams = @{
    Name = "contoso"
    ResourceGroupName = "<your web app resource group>"
    HostNames = @("contoso.com","www.contoso.com","contoso.azurewebsites.net")
}
Set-AzWebApp @webAppParams

# Add contoso.com
az webapp config hostname add \
    --webapp-name contoso \
    --resource-group <your web app resource group> \
    --hostname contoso.com

# Add www.contoso.com
az webapp config hostname add \
    --webapp-name contoso \
    --resource-group <your web app resource group> \
    --hostname www.contoso.com