AWS acm: Domain validation: prefer DNS, email deprecation notice
Summary
Adds deprecation notice for email validation, removes the note that email validation is required when DNS cannot be edited, and updates switching guidance to use UpdateCertificateOptions.
Security assessment
The change promotes DNS validation over email validation and documents the API to migrate, which strengthens domain-ownership validation; it is best-practice guidance rather than a specific vulnerability fix.
Evidence
+To switch an existing certificate from email validation to DNS validation, use the [`UpdateCertificateOptions`](https://docs.aws.amazon.com/acm/latest/APIReference/API_UpdateCertificateOptions.html) API.
Diff
diff --git a/acm/latest/userguide/domain-ownership-validation.md b/acm/latest/userguide/domain-ownership-validation.md index 69d4a9b..18e995b 100644 --- a//acm/latest/userguide/domain-ownership-validation.md +++ b//acm/latest/userguide/domain-ownership-validation.md @@ -20,0 +21,2 @@ We recommend using DNS validation over email validation for the following reason + * AWS Certificate Manager will deprecate email validation throughout 2027 for new public certificates and renewals. For more information, see [AWS Certificate Manager will discontinue email validation to prove domain validation for certificates](https://aws.amazon.com/blogs/security/aws-certificate-manager-will-discontinue-email-validation-to-prove-domain-validation-for-certificates/) on the AWS Security Blog. + @@ -30,2 +31,0 @@ We recommend using DNS validation over email validation for the following reason -If you can't edit your domain's DNS database, you must use [email validation](./email-validation.html) instead. - @@ -36 +36 @@ HTTP validation is available for certificates used with CloudFront. This method -After you create a certificate with email validation, you cannot switch to validating it with DNS. To use DNS validation, delete the certificate and then create a new one that uses DNS validation. +To switch an existing certificate from email validation to DNS validation, use the [`UpdateCertificateOptions`](https://docs.aws.amazon.com/acm/latest/APIReference/API_UpdateCertificateOptions.html) API.