Skip to content

Commit bd057cb

Browse files
committed
updates
1 parent cd67697 commit bd057cb

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

articles/app-service/app-service-web-tutorial-custom-domain.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,8 @@ author: msangapu-msft
2020
The DNS record type you need to add with your domain provider depends on the domain you want to add to App Service.
2121

2222
| 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).) |
2525
| 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. |
2626
| [Wildcard](https://en.wikipedia.org/wiki/Wildcard_DNS_record) | *.contoso.com | [CNAME record](https://en.wikipedia.org/wiki/CNAME_record). |
2727

@@ -30,11 +30,11 @@ The DNS record type you need to add with your domain provider depends on the dom
3030
3131
## Prerequisites
3232

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.
3434
* 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.
3535
* If you don't have a custom domain yet, you can [purchase an App Service domain](manage-custom-dns-buy-domain.md) instead.
3636

37-
## 1. Configure a custom domain
37+
## Configure a custom domain
3838

3939
1. In the [Azure portal](https://portal.azure.com), navigate to your app's management page.
4040
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
4747
> [!NOTE]
4848
> To configure an App Service domain, see [Buy a custom domain name for Azure App Service](manage-custom-dns-buy-domain.md).
4949
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**.
5151

5252
1. For **TLS/SSL type**, select the binding type you want.
5353

5454
[!INCLUDE [Certificate binding types](../../includes/app-service-ssl-binding-types.md)]
5555

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`).
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`).
5757

5858
1. Don't select **Validate** yet.
5959

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.
6161

6262
The following screenshot shows the default selections for a `www.contoso.com` domain, which shows a CNAME record and a TXT record to add.
6363

@@ -74,39 +74,39 @@ The DNS record type you need to add with your domain provider depends on the dom
7474

7575
<a name="cname" aria-hidden="true"></a>
7676

77-
## 2. Create the DNS records
77+
## Create the DNS records
7878

7979
[!INCLUDE [Access DNS records with domain provider](../../includes/app-service-web-access-dns-records-no-h.md)]
8080

8181
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.
8282

83-
### [Root domain (e.g. contoso.com)](#tab/root)
83+
### [Root domain (for example, contoso.com)](#tab/root)
8484

85-
Create two records according to the following table:
85+
Create two records, as described in the following table:
8686

8787
| Record type | Host | Value | Comments |
8888
| - | - | - | - |
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. |
9191

9292
![Screenshot that shows a DNS records page.](./media/app-service-web-tutorial-custom-domain/a-record.png)
9393

94-
### [Subdomain (e.g. www.contoso.com)](#tab/subdomain)
94+
### [Subdomain (for example, www.contoso.com)](#tab/subdomain)
9595

9696
#### With an A record
9797

98-
Create two records according to the following table:
98+
Create two records, as described in the following table:
9999

100100
|Record type|Host|Value|Comments|
101101
|--- |--- |--- |--- |
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. |
104104

105105
![Screenshot that shows a DNS records subdomain page.](./media/app-service-web-tutorial-custom-domain/a-record-subdomain.png)
106106

107107
#### With a CNAME record
108108

109-
Create two records according to the following table:
109+
Create two records, as described in the following table:
110110

111111
| Record type | Host | Value | Comments |
112112
| - | - | - |
@@ -128,7 +128,7 @@ For a wildcard name like `*` in `*.contoso.com`, create two records according to
128128

129129
-----
130130

131-
## 3. Validate and complete
131+
## Validate and complete
132132

133133
1. Back in the **Add custom domain** dialog in the Azure portal, select **Validate**.
134134

@@ -150,7 +150,7 @@ For a wildcard name like `*` in `*.contoso.com`, create two records according to
150150
> [!NOTE]
151151
> 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.
152152
153-
## 4. Test in a browser
153+
## Test in a browser
154154

155155
Browse to the DNS names that you configured earlier.
156156

0 commit comments

Comments
 (0)