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-managed-certificate-changes-july-2025.md
+15-16Lines changed: 15 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,13 +14,13 @@ ms.date: 07/28/2025
14
14
15
15
Starting July 28, 2025, Azure App Service Managed Certificates (ASMC) are subject to new issuance and renewal requirements due to DigiCert’s migration to a new validation platform. This change is driven by industry-wide compliance with Multi-Perspective Issuance Corroboration (MPIC).
16
16
17
-
For a detailed explanation of the underlying changes at DigiCert, refer to [changes to the managed TLS feature](../security/fundamentals/managed-tls-changes.md).
17
+
For a detailed explanation of the underlying changes at DigiCert, refer to [changes to the managed Transport Layer Security (TLS) feature](../security/fundamentals/managed-tls-changes.md).
18
18
19
19
## What’s changing
20
20
21
21
-**Validation method update**: ASMC now uses HTTP Token validation for both apex and subdomains. Previously, subdomains were validated using CNAME records, which did not require public access. With HTTP Token, DigiCert must reach a specific endpoint on your app to verify domain ownership.
22
22
23
-
App Service automatically places the required token at the correct path for validation. This applies to both initial certificate issuance and renewals, meaning:
23
+
App Service automatically places the required token at the correct path for validation. This process applies to both initial certificate issuance and renewals, meaning:
24
24
25
25
- The customer experience for requesting an ASMC or proving domain ownership remains unchanged.
26
26
- All API and CLI request payloads for ASMC creation or renewal are unaffected.
@@ -31,8 +31,7 @@ For a detailed explanation of the underlying changes at DigiCert, refer to [chan
31
31
32
32
## Impacted scenarios
33
33
34
-
You will not be able to create or renew ASMCs if:
35
-
34
+
You can't create or renew ASMCs if:
36
35
- Your app is not publicly accessible.
37
36
- You use Azure Traffic Manager with nested or external endpoints.
38
37
- You rely on `*.trafficmanager.net` domains.
@@ -55,7 +54,7 @@ We recognize that making applications publicly accessible may conflict with cust
55
54
2.**Add the certificate to the site**
56
55
After acquiring a certificate for your custom domain, you need to upload it to your App Service app and configure it for use. After acquiring a certificate for your custom domain, you need to upload it to your App Service app and configure it for use.
57
56
> [!TIP]
58
-
> Ensure that you have[authorized App Service to read the certificates from Key vault](configure-ssl-certificate.md#authorize-app-service-to-read-from-the-vault). Use the specific identity listed in the documentation and not the Managed Identity of the site.
57
+
> Make sure to[authorized App Service to read the certificates from Key vault](configure-ssl-certificate.md#authorize-app-service-to-read-from-the-vault). Use the specific identity listed in the documentation and not the Managed Identity of the site.
59
58
-[REST API: Import KV certificate to site](/rest/api/appservice/certificates/create-or-update)
60
59
-[CLI: Import KV certificate to site](/cli/azure/webapp/config/ssl#az-webapp-config-ssl-import)
61
60
@@ -84,10 +83,10 @@ We recognize that making applications publicly accessible may conflict with cust
84
83
**Temporary mitigation: DigiCert IP allowlisting**
85
84
Some customers may choose to allowlist [DigiCert’s domain validation IPs](https://knowledge.digicert.com/alerts/ip-address-domain-validation) as a short-term workaround. This can help buy time to move away from using ASMC for websites that aren’t publicly accessible, especially given the short notice of the change.
86
85
> [!NOTE]
87
-
> This isn’t an official or supported long-term solution. Microsoft’s stance remains that **public access is required** to avoid potential service disruptions. Consider the following:
86
+
> Allowlisting DigiCert's IP isn’t an official or supported long-term solution. Microsoft’s stance remains that **public access is required** to avoid potential service disruptions. Consider the following:
88
87
>
89
88
> - DigiCert manages its own IPs and may change them without notice.
90
-
> - Microsoft doesn’t control DigiCert’s infrastructure and can’t guarantee the documentation will stay up to date.
89
+
> - Microsoft doesn’t control DigiCert’s infrastructure and can’t guarantee the documentation stay up to date.
91
90
> - Microsoft doesn’t provide alerts if DigiCert updates its IPs.
92
91
> - Use this approach at your own risk.
93
92
@@ -102,7 +101,7 @@ Only “Azure Endpoints” are supported. “Nested” and “External” endpoi
102
101
**Recommended mitigation:**
103
102
104
103
- Switch to Azure Endpoints or use a custom domain secured with a custom certificate.
105
-
- For guidance on using App Service as an Azure Traffic Manager endpoint, refer to [App Service and Traffic Manager Profiles](web-sites-traffic-manager#app-service-and-traffic-manager-profiles).
104
+
- For guidance on using App Service as an Azure Traffic Manager endpoint, refer to [App Service and Traffic Manager Profiles](web-sites-traffic-manager#app-service-and-traffic-manager-profiles.md).
106
105
107
106
---
108
107
@@ -115,8 +114,8 @@ Certificates for `*.trafficmanager.net` domains are not supported. If your app r
115
114
1.**Add a custom domain to the site**
116
115
You can configure a custom domain that points to your `trafficmanager.net` endpoint and secure it with your own certificate.
117
116
118
-
- If the custom domain is not yet live or does not currently serve traffic, refer to [set up custom domain name for your app](app-service-web-tutorial-custom-domain).
119
-
- If the domain is already active and serving traffic, refer to [migrate an active domain](manage-custom-dns-migrate-domain).
117
+
- If the custom domain is not yet live or does not currently serve traffic, refer to [set up custom domain name for your app](app-service-web-tutorial-custom-domain.md).
118
+
- If the domain is already active and serving traffic, refer to [migrate an active domain](manage-custom-dns-migrate-domain.md).
120
119
121
120
> [!IMPORTANT]
122
121
> If the site restricts public access, do not use ASMC to secure the custom domain. This scenario is impacted by the validation change and will result in certificate issuance or renewal failure.
@@ -126,7 +125,7 @@ Certificates for `*.trafficmanager.net` domains are not supported. If your app r
126
125
127
126
4.**Add the certificate to the site**
128
127
> [!TIP]
129
-
> Ensure that you have [authorized App Service to read the certificates from Key vault](configure-ssl-certificate#authorize-app-service-to-read-from-the-vault). Use the specific identity listed in the documentation—not the Managed Identity of the site.
128
+
> Make sure to [authorized App Service to read the certificates from Key vault](configure-ssl-certificate#authorize-app-service-to-read-from-the-vault.md). Use the specific identity listed in the documentation—not the Managed Identity of the site.
130
129
-[REST API: Import KV certificate to site](/rest/api/appservice/certificates/create-or-update)
131
130
-[CLI: Import KV certificate to site](/cli/azure/webapp/config/ssl#az-webapp-config-ssl-import)
132
131
@@ -155,16 +154,16 @@ Certificates for `*.trafficmanager.net` domains are not supported. If your app r
155
154
## Frequently asked questions (FAQ)
156
155
157
156
**Why is public access now required?**
158
-
Due to MPIC compliance, App Service is migrating to Http Token validation for all ASMC creation and renewal requests. DigiCert must verify domain ownership by reaching a specific endpoint on your app. This is only possible if the app is publicly accessible.
157
+
Due to MPIC compliance, App Service is migrating to Http Token validation for all ASMC creation and renewal requests. DigiCert must verify domain ownership by reaching a specific endpoint on your app. A successful validation with Http token is only possible if the app is publicly accessible.
159
158
160
159
**Can I still use CNAME records?**
161
-
Yes, you can still use CNAME records for DNS routing and for verifying domain ownership.
160
+
Yes, you can still use CNAME records for domain name system (DNS) routing and for verifying domain ownership.
162
161
163
-
**What if I allowlist DigiCert IPs?**
164
-
This may work temporarily, but Microsoft cannot guarantee stability or updates. DigiCert may change IPs without notice, and Microsoft will not maintain documentation for these IPs. Customers are responsible for monitoring and maintaining this configuration.
162
+
**What if I allowlist DigiCert IP addresses?**
163
+
Allowlisting DigiCert’s domain validation IPs may work as a temporary workaround. However, Microsoft cannot guarantee that these IPs won’t change. DigiCert may update them without notice, and Microsoft does not maintain documentation for these IPs. Customers are responsible for monitoring and maintaining this configuration.
165
164
166
165
**Are certificates for \*.azurewebsites.net impacted?**
167
-
No. These changes only apply to App Service Managed Certificates that are issued to customer’s custom domain.
166
+
No, these changes do not apply to the *.azurewebsites.net certificates. ASMC is only issued to customer’s custom domain and not the default hostname.
0 commit comments