AWS Security ChangesHomeSearch

AWS AWSCloudFormation: ACM Certificate: add CertificateUsage and RootHierarchyType properties

Service: AWSCloudFormation · 2026-11-21 · Documentation medium

File: AWSCloudFormation/latest/TemplateReference/aws-resource-certificatemanager-certificate.md · Type: encryption

Summary

Documents two new ACM certificate properties: CertificateUsage (Extended Key Usage profile, CLIENT_AND_SERVER_AUTH | CLIENT_AUTH_ONLY) and RootHierarchyType (N2_AMAZON_MANAGED | N2_SFG2_AMAZON_MANAGED), both requiring replacement, and adds them to the JSON/YAML syntax examples.

Security assessment

The added CertificateUsage property controls the certificate's Extended Key Usage (e.g., restricting to CLIENT_AUTH_ONLY), which is security-relevant certificate configuration, but this is a new-feature reference entry rather than a fix for a specific vulnerability or a security best-practice guide.

Evidence

+The Extended Key Usage profile of the certificate. This value exists only for Amazon N2 certificates. If `CertificateUsage` was omitted from the request, this value is `CLIENT_AND_SERVER_AUTH`.

Diff

diff --git a/AWSCloudFormation/latest/TemplateReference/aws-resource-certificatemanager-certificate.md b/AWSCloudFormation/latest/TemplateReference/aws-resource-certificatemanager-certificate.md
index 87cad3b..e6f6ab1 100644
--- a//AWSCloudFormation/latest/TemplateReference/aws-resource-certificatemanager-certificate.md
+++ b//AWSCloudFormation/latest/TemplateReference/aws-resource-certificatemanager-certificate.md
@@ -31,0 +32 @@ To declare this entity in your CloudFormation template, use the following syntax
+          "CertificateUsage" : String,
@@ -34,0 +36 @@ To declare this entity in your CloudFormation template, use the following syntax
+          "RootHierarchyType" : String,
@@ -49,0 +52 @@ To declare this entity in your CloudFormation template, use the following syntax
+      CertificateUsage: String
@@ -53,0 +57 @@ To declare this entity in your CloudFormation template, use the following syntax
+      RootHierarchyType: String
@@ -113,0 +118,13 @@ _Required_ : No
+`CertificateUsage`
+    
+
+The Extended Key Usage profile of the certificate. This value exists only for Amazon N2 certificates. If `CertificateUsage` was omitted from the request, this value is `CLIENT_AND_SERVER_AUTH`.
+
+_Required_ : No
+
+ _Type_ : String
+
+ _Allowed values_ : `CLIENT_AND_SERVER_AUTH | CLIENT_AUTH_ONLY`
+
+ _Update requires_ : [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
+
@@ -182,0 +200,13 @@ _Required_ : No
+
+`RootHierarchyType`
+    
+
+The root hierarchy from which the certificate was issued. This value exists only for Amazon N2 certificates, which have a `Type` of `AMAZON_ISSUED`.
+
+_Required_ : No
+
+ _Type_ : String
+
+ _Allowed values_ : `N2_AMAZON_MANAGED | N2_SFG2_AMAZON_MANAGED`
+
+ _Update requires_ : [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)