AWS AWSCloudFormation: ACM Certificate: add CertificateUsage and RootHierarchyType properties
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)