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
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -109,58 +109,58 @@ Create two records, as described in the following table:
109
109
Create two records, as described in the following table:
110
110
111
111
| 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. |
114
114
| 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. |
115
115
116
116

117
117
118
118
### [Wildcard (CNAME)](#tab/wildcard)
119
119
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:
121
121
122
122
| Record type | Host | Value | Comments |
123
123
| - | - | - | - |
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. |
125
125
| 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. |
126
126
127
127

128
128
129
129
-----
130
130
131
-
## Validate and complete
131
+
## Validate domain ownership and complete the mapping
132
132
133
133
1. Back in the **Add custom domain** dialog in the Azure portal, select **Validate**.
134
134
135
135
:::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":::
136
136
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.
138
138
139
139
:::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":::
140
140
141
141
> [!NOTE]
142
142
> 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.
143
143
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**.
145
145
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).
147
147
148
148
:::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":::
149
149
150
150
> [!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.
152
152
153
-
## Test in a browser
153
+
## Test the DNS resolution
154
154
155
-
Browse to the DNS names that you configured earlier.
155
+
Browse to the DNS names that you configured.
156
156
157
157

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:
162
162
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`.
164
164
- 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.
165
165
166
166
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
172
172
## Next steps
173
173
174
174
> [!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)
176
176
177
177
> [!div class="nextstepaction"]
178
178
> [Secure a custom DNS name with a TLS/SSL binding in Azure App Service](configure-ssl-bindings.md)
0 commit comments