Skip to content

Commit 7ff707f

Browse files
committed
updates
1 parent 9827b06 commit 7ff707f

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

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

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -109,58 +109,58 @@ Create two records, as described in the following table:
109109
Create two records, as described in the following table:
110110

111111
| Record type | Host | Value | Comments |
112-
| - | - | - |
113-
| CNAME | `<subdomain>` (for example, `www`) | `<app-name>.azurewebsites.net` (see [note at top](#dnl-note)) | The domain mapping itself. |
112+
| - | - | - |-|
113+
| CNAME | `<subdomain>` (for example, `www`) | `<app-name>.azurewebsites.net`. (See [the note at the start of this article](#dnl-note).) | The domain mapping itself. |
114114
| 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. |
115115

116116
![Screenshot that shows the portal navigation to an Azure app.](./media/app-service-web-tutorial-custom-domain/cname-record.png)
117117

118118
### [Wildcard (CNAME)](#tab/wildcard)
119119

120-
For a wildcard name like `*` in `*.contoso.com`, create two records according to the following table:
120+
For a wildcard name, like `*` in `*.contoso.com`, create two records, as described in the following table:
121121

122122
| Record type | Host | Value | Comments |
123123
| - | - | - | - |
124-
| CNAME | `*` | `<app-name>.azurewebsites.net` (see [note at top](#dnl-note)) | The domain mapping itself. |
124+
| CNAME | `*` | `<app-name>.azurewebsites.net`. (See [the note at start of this article](#dnl-note).) | The domain mapping itself. |
125125
| TXT | `asuid` | The domain verification ID shown in the **Add custom domain** dialog. | App Service accesses the `asuid` TXT record to verify your ownership of the custom domain. |
126126

127127
![Screenshot that shows the navigation to an Azure app.](./media/app-service-web-tutorial-custom-domain/cname-record-wildcard.png)
128128

129129
-----
130130

131-
## Validate and complete
131+
## Validate domain ownership and complete the mapping
132132

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

135135
:::image type="content" source="./media/app-service-web-tutorial-custom-domain/configure-custom-domain-validate.png" alt-text="A screenshot showing how to validate your DNS record settings in the Add a custom domain dialog." border="true":::
136136

137-
1. If the **Domain validation** section shows green check marks next for both domain records, then you've configured them correctly. Select **Add**. If you see any errors or warnings, fix it in the DNS record settings on your domain provider's website.
137+
1. If the **Domain validation** section shows green check marks next to both domain records, you've configured them correctly. Select **Add**. If you see any errors or warnings, resolve them in the DNS record settings on your domain provider's website.
138138

139139
:::image type="content" source="./media/app-service-web-tutorial-custom-domain/configure-custom-domain-add.png" alt-text="A screenshot showing the Add button activated after validation." border="true":::
140140

141141
> [!NOTE]
142142
> If you configured the TXT record but not the A or CNAME record, App Service treats it as a [domain migration](manage-custom-dns-migrate-domain.md) scenario and allows the validation to succeed, but you won't see green check marks next to the records.
143143
144-
1. You should see the custom domain added to the list. You may also see a red X with **No binding**.
144+
1. You should see the custom domain added to the list. You might also see a red X and the text **No binding**.
145145

146-
If you selected **App Service Managed Certificate** earlier, wait a few minutes for App Service to create the managed certificate for your custom domain. When the process is complete, the red X becomes a green check mark with **Secured**. If you selected **Add certificate later**, this red X will remain until you [add a private certificate for the domain](configure-ssl-certificate.md) and [configure the binding](configure-ssl-bindings.md).
146+
If you selected **App Service Managed Certificate** earlier, wait a few minutes for App Service to create the managed certificate for your custom domain. When the process is complete, the red X becomes a green check mark and you see the word **Secured**. If you selected **Add certificate later**, the red X will remain until you [add a private certificate for the domain](configure-ssl-certificate.md) and [configure the binding](configure-ssl-bindings.md).
147147

148148
:::image type="content" source="./media/app-service-web-tutorial-custom-domain/add-custom-domain-complete.png" alt-text="A screenshot showing the custom domains page with the new secured custom domain." border="true":::
149149

150150
> [!NOTE]
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.
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.
152152
153-
## Test in a browser
153+
## Test the DNS resolution
154154

155-
Browse to the DNS names that you configured earlier.
155+
Browse to the DNS names that you configured.
156156

157157
![Screenshot that shows navigation to an Azure app.](./media/app-service-web-tutorial-custom-domain/app-with-custom-dns.png)
158158

159159
<a name="resolve-404-not-found" aria-hidden="true"></a>
160160

161161
If you receive an HTTP 404 (Not Found) error when you browse to the URL of your custom domain, the two most-likely causes are:
162162

163-
- The browser client has cached the old IP address of your domain. Clear the cache, and test DNS resolution again. On a Windows machine, you clear the cache with `ipconfig /flushdns`.
163+
- The browser client has cached the old IP address of your domain. Clear the cache and test the DNS resolution again. On a Windows machine, you can clear the cache with `ipconfig /flushdns`.
164164
- You configured an IP-based certificate binding, and the app's IP address has changed because of it. [Remap the A record](configure-ssl-bindings.md#2-remap-records-for-ip-based-ssl) in your DNS entries to the new IP address.
165165

166166
If you receive a `Page not secure` warning or error, it's because your domain doesn't have a certificate binding yet. [Add a private certificate for the domain](configure-ssl-certificate.md) and [configure the binding](configure-ssl-bindings.md).
@@ -172,7 +172,7 @@ If you receive a `Page not secure` warning or error, it's because your domain do
172172
## Next steps
173173

174174
> [!div class="nextstepaction"]
175-
> [Purchase an App Service domain](manage-custom-dns-buy-domain.md).
175+
> [Purchase an App Service domain](manage-custom-dns-buy-domain.md)
176176
177177
> [!div class="nextstepaction"]
178178
> [Secure a custom DNS name with a TLS/SSL binding in Azure App Service](configure-ssl-bindings.md)

0 commit comments

Comments
 (0)