You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/app-service/app-service-web-tutorial-custom-domain.md
+19-19Lines changed: 19 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,8 +20,8 @@ author: msangapu-msft
20
20
The DNS record type you need to add with your domain provider depends on the domain you want to add to App Service.
21
21
22
22
| Scenario | Example | Recommended DNS record |
23
-
| - | - | - |- |
24
-
| Root domain | contoso.com |[A record](https://en.wikipedia.org/wiki/List_of_DNS_record_types#A). Don't use the CNAME record for the root record (for information, see [RFC 1912 Section 2.4](https://datatracker.ietf.org/doc/html/rfc1912#section-2.4)).|
23
+
| - | - | - |
24
+
| Root domain | contoso.com |[A record](https://en.wikipedia.org/wiki/List_of_DNS_record_types#A). Don't use the CNAME record for the root record. (For information, see [RFC 1912 Section 2.4](https://datatracker.ietf.org/doc/html/rfc1912#section-2.4).)|
25
25
| Subdomain |www.contoso.com, my.contoso.com |[CNAME record](https://en.wikipedia.org/wiki/CNAME_record). You can map a subdomain to the app's IP address directly with an A record, but it's possible for [the IP address to change](overview-inbound-outbound-ips.md#when-inbound-ip-changes). The CNAME maps to the app's default hostname instead, which is less susceptible to change. |
@@ -30,11 +30,11 @@ The DNS record type you need to add with your domain provider depends on the dom
30
30
31
31
## Prerequisites
32
32
33
-
*[Create an App Service app](./index.yml), or use an app that you created for another tutorial. The web app's [App Service plan](overview-hosting-plans.md) must be a paid tier and not **Free (F1)**. See [Scale up an app](manage-scale-up.md#scale-up-your-pricing-tier) to update the tier.
33
+
*[Create an App Service app](./index.yml), or use an app that you created for another tutorial. The web app's [App Service plan](overview-hosting-plans.md) must be a paid tier, not the Free (F1) tier. See [Scale up an app](manage-scale-up.md#scale-up-your-pricing-tier) to update the tier.
34
34
* Make sure you can edit the DNS records for your custom domain. To edit DNS records, you need access to the DNS registry for your domain provider, such as GoDaddy. 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. Your custom domains must be in a public DNS zone; private DNS zones are not supported.
35
35
* If you don't have a custom domain yet, you can [purchase an App Service domain](manage-custom-dns-buy-domain.md) instead.
36
36
37
-
## 1. Configure a custom domain
37
+
## Configure a custom domain
38
38
39
39
1. In the [Azure portal](https://portal.azure.com), navigate to your app's management page.
40
40
1. In the left menu for your app, select **Custom domains**.
@@ -47,17 +47,17 @@ The DNS record type you need to add with your domain provider depends on the dom
47
47
> [!NOTE]
48
48
> To configure an App Service domain, see [Buy a custom domain name for Azure App Service](manage-custom-dns-buy-domain.md).
49
49
50
-
1. For **TLS/SSL certificate**, select **App Service Managed Certificate** if your app is in **Basic** tier or higher. If you want to remain in **Shared** tier, or if you want to use your own certificate, select **Add certificate later**.
50
+
1. For **TLS/SSL certificate**, select **App Service Managed Certificate** if your app is in the Basic tier or higher. If you want to remain in the Shared tier, or if you want to use your own certificate, select **Add certificate later**.
51
51
52
52
1. For **TLS/SSL type**, select the binding type you want.
1. For Domain, specify a fully qualified domain name you want based on the domain you own. The **Hostname record type** box defaults to the recommended DNS record to use, depending on whether the domain is a root domain (like `contoso.com`), a subdomain (like `www.contoso.com`, or a wildcard domain `*.contoso.com`).
56
+
1. For **Domain**, specify a fully qualified domain name you want based on the domain you own. The **Hostname record type** box defaults to the recommended DNS record to use, depending on whether the domain is a root domain (like `contoso.com`), a subdomain (like `www.contoso.com`, or a wildcard domain `*.contoso.com`).
57
57
58
58
1. Don't select **Validate** yet.
59
59
60
-
1. For each custom domain in App Service, you need two DNS records with your domain provider. The **Domain validation** section shows you two DNS records that you must add with your domain provider. Select the respective **Copy** button to help you with the next step.
60
+
1. For each custom domain in App Service, you need two DNS records with your domain provider. The **Domain validation** section shows you two DNS records that you must add with your domain provider. Select the respective **Copy** button to help you with the next section.
61
61
62
62
The following screenshot shows the default selections for a `www.contoso.com` domain, which shows a CNAME record and a TXT record to add.
63
63
@@ -74,39 +74,39 @@ The DNS record type you need to add with your domain provider depends on the dom
74
74
75
75
<aname="cname"aria-hidden="true"></a>
76
76
77
-
## 2. Create the DNS records
77
+
## Create the DNS records
78
78
79
79
[!INCLUDE [Access DNS records with domain provider](../../includes/app-service-web-access-dns-records-no-h.md)]
80
80
81
81
Select the type of record to create and follow the instructions. You can use either a [CNAME record](https://en.wikipedia.org/wiki/CNAME_record) or an [A record](https://en.wikipedia.org/wiki/List_of_DNS_record_types#A) to map a custom DNS name to App Service. When your function app is hosted in a [Consumption plan](../azure-functions/consumption-plan.md), only the CNAME option is supported.
82
82
83
-
### [Root domain (e.g. contoso.com)](#tab/root)
83
+
### [Root domain (for example, contoso.com)](#tab/root)
84
84
85
-
Create two records according to the following table:
85
+
Create two records, as described in the following table:
86
86
87
87
| Record type | Host | Value | Comments |
88
88
| - | - | - | - |
89
-
| A |`@`| The app's IP address shown in the **Add custom domain** dialog. | The domain mapping itself (`@` typically represents the root domain).|
90
-
| TXT |`asuid`| The domain verification ID shown in the **Add custom domain** dialog. | For root domain, App Service accesses `asuid` TXT record to verify your ownership of the custom domain. |
89
+
| A |`@`| The app's IP address shown in the **Add custom domain** dialog. | The domain mapping itself. (`@` typically represents the root domain.)|
90
+
| TXT |`asuid`| The domain verification ID shown in the **Add custom domain** dialog. | For the root domain, App Service accesses the`asuid` TXT record to verify your ownership of the custom domain. |
91
91
92
92

Create two records according to the following table:
98
+
Create two records, as described in the following table:
99
99
100
100
|Record type|Host|Value|Comments|
101
101
|--- |--- |--- |--- |
102
-
|A|\<subdomain\> (for example, www)|IP address shown in the **Add custom domain** dialog.| The domain mapping itself. |
103
-
|TXT|asuid.\<subdomain\> (for example, asuid.www)|The domain verification ID shown in the **Add custom domain** dialog.| App Service accesses the `asuid.<subdomain>` TXT record to verify your ownership of the custom domain. |
102
+
|A|`<subdomain>` (for example, `www`)|IP address shown in the **Add custom domain** dialog.| The domain mapping itself. |
103
+
|TXT|`asuid.<subdomain` (for example, `asuid.www`)|The domain verification ID shown in the **Add custom domain** dialog.| App Service accesses the `asuid.<subdomain>` TXT record to verify your ownership of the custom domain. |
104
104
105
105

106
106
107
107
#### With a CNAME record
108
108
109
-
Create two records according to the following table:
109
+
Create two records, as described in the following table:
110
110
111
111
| Record type | Host | Value | Comments |
112
112
| - | - | - |
@@ -128,7 +128,7 @@ For a wildcard name like `*` in `*.contoso.com`, create two records according to
128
128
129
129
-----
130
130
131
-
## 3. Validate and complete
131
+
## Validate and complete
132
132
133
133
1. Back in the **Add custom domain** dialog in the Azure portal, select **Validate**.
134
134
@@ -150,7 +150,7 @@ For a wildcard name like `*` in `*.contoso.com`, create two records according to
150
150
> [!NOTE]
151
151
> Unless you configure a certificate binding for your custom domain, Any HTTPS request from a browser to the domain will receive an error or warning, depending on the browser.
152
152
153
-
## 4. Test in a browser
153
+
## Test in a browser
154
154
155
155
Browse to the DNS names that you configured earlier.
0 commit comments