Skip to content

Commit 1b365e4

Browse files
authored
More info and fixed warnings
1 parent dc08e34 commit 1b365e4

File tree

1 file changed

+15
-16
lines changed

1 file changed

+15
-16
lines changed

articles/app-service/app-service-managed-certificate-changes-july-2025.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,13 @@ ms.date: 07/28/2025
1414

1515
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).
1616

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).
1818

1919
## What’s changing
2020

2121
- **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.
2222

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:
2424

2525
- The customer experience for requesting an ASMC or proving domain ownership remains unchanged.
2626
- 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
3131
3232
## Impacted scenarios
3333

34-
You will not be able to create or renew ASMCs if:
35-
34+
You can't create or renew ASMCs if:
3635
- Your app is not publicly accessible.
3736
- You use Azure Traffic Manager with nested or external endpoints.
3837
- You rely on `*.trafficmanager.net` domains.
@@ -55,7 +54,7 @@ We recognize that making applications publicly accessible may conflict with cust
5554
2. **Add the certificate to the site**
5655
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.
5756
> [!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.
5958
- [REST API: Import KV certificate to site](/rest/api/appservice/certificates/create-or-update)
6059
- [CLI: Import KV certificate to site](/cli/azure/webapp/config/ssl#az-webapp-config-ssl-import)
6160

@@ -84,10 +83,10 @@ We recognize that making applications publicly accessible may conflict with cust
8483
**Temporary mitigation: DigiCert IP allowlisting**
8584
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.
8685
> [!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:
8887
>
8988
> - 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.
9190
> - Microsoft doesn’t provide alerts if DigiCert updates its IPs.
9291
> - Use this approach at your own risk.
9392
@@ -102,7 +101,7 @@ Only “Azure Endpoints” are supported. “Nested” and “External” endpoi
102101
**Recommended mitigation:**
103102

104103
- 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).
106105

107106
---
108107

@@ -115,8 +114,8 @@ Certificates for `*.trafficmanager.net` domains are not supported. If your app r
115114
1. **Add a custom domain to the site**
116115
You can configure a custom domain that points to your `trafficmanager.net` endpoint and secure it with your own certificate.
117116

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).
120119

121120
> [!IMPORTANT]
122121
> 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
126125

127126
4. **Add the certificate to the site**
128127
> [!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.
130129
- [REST API: Import KV certificate to site](/rest/api/appservice/certificates/create-or-update)
131130
- [CLI: Import KV certificate to site](/cli/azure/webapp/config/ssl#az-webapp-config-ssl-import)
132131

@@ -155,16 +154,16 @@ Certificates for `*.trafficmanager.net` domains are not supported. If your app r
155154
## Frequently asked questions (FAQ)
156155

157156
**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.
159158

160159
**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.
162161

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

166165
**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.
168167

169168
---
170169

0 commit comments

Comments
 (0)