AWS acm: ACME DNS CNAME error wording and CloudTrail event logging note
Summary
Clarifies the ACME validation failure message to 'DNS CNAME records not found or incorrect' and rewrites the CloudTrail troubleshooting note to state the IssueCertificate failure is a management event logged by default, with errorType/errorMessage in serviceEventDetails.
Security assessment
Improves troubleshooting of ACME certificate issuance failures and clarifies that these failures are captured as CloudTrail management events by default (previously described as requiring a data-event trail), which aids auditability and detection. No specific vulnerability or CVE is referenced.
Evidence
+The failure also appears in CloudTrail as an `IssueCertificate` management event with a `status` of `FAILED`. Its `serviceEventDetails` carry the ACME error type as `errorType` and its `detail` as `errorMessage`. Management events are logged by default. For more information about `IssueCertificate` events, see [Issuing a certificate from an ACME endpoint (IssueCertificate)](./acm-supported-actions-in-cloudtrail.html#ct-acme-issuecertificate).
Diff
diff --git a/acm/latest/userguide/troubleshooting-acme.md b/acm/latest/userguide/troubleshooting-acme.md index 11877e1..3300969 100644 --- a//acm/latest/userguide/troubleshooting-acme.md +++ b//acm/latest/userguide/troubleshooting-acme.md @@ -112 +112 @@ When this happens, the ACME client sees the order transition to `invalid` status - "detail": "DNS CNAME records not found: [_a1b2c3d4e5f67890abcdef1234567890.example.com.]" + "detail": "DNS CNAME records not found or incorrect: [_a1b2c3d4e5f67890abcdef1234567890.example.com.]" @@ -124 +124 @@ ACME clients surface the order's error in their own output. For example, Certbot - DNS CNAME records not found: [_a1b2c3d4e5f67890abcdef1234567890.example.com.] + DNS CNAME records not found or incorrect: [_a1b2c3d4e5f67890abcdef1234567890.example.com.] @@ -126 +126 @@ ACME clients surface the order's error in their own output. For example, Certbot -If you have configured an CloudTrail trail or event data store to record ACM data events, the failure also appears on the `IssueCertificate` CloudTrail event under `serviceEventDetails`, with the same `errorType` and `errorMessage`. For more information, see [ACM API actions supported in CloudTrail logging](./acm-supported-actions-in-cloudtrail.html). +The failure also appears in CloudTrail as an `IssueCertificate` management event with a `status` of `FAILED`. Its `serviceEventDetails` carry the ACME error type as `errorType` and its `detail` as `errorMessage`. Management events are logged by default. For more information about `IssueCertificate` events, see [Issuing a certificate from an ACME endpoint (IssueCertificate)](./acm-supported-actions-in-cloudtrail.html#ct-acme-issuecertificate).