AWS Security ChangesHomeSearch

AWS AWSCloudFormation: Document IGW_FIREWALL rule type and required IAM permissions

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

File: AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-rule.md · Type: iam

Summary

Adds documentation for the new IGW_FIREWALL firewall type and INSPECTION/CONFIGURATION rule configuration keys, including the IAM permissions the calling principal needs (network-firewall:CreateFirewallPolicyV2, network-firewall:TagResource, and Network Firewall logging permissions) because Network Security Manager validates the configuration with a Network Firewall dry run using the caller's credentials. Also adds a YAML example and clarifies the LastUpdated timestamp format.

Security assessment

The added text explicitly enumerates the IAM permissions a principal must hold for the stack operation to succeed, which is least-privilege/permission guidance for a security control (firewall policy) resource. It documents required permissions rather than fixing a vulnerability, so it is security documentation, not an incident response.

Evidence

When you create or update an `IGW_FIREWALL` rule, AWS Network Security Manager validates the configuration with an AWS Network Firewall dry run that uses your credentials. The IAM principal that runs the stack operation needs the `network-firewall:CreateFirewallPolicyV2` and `network-firewall:TagResource` permissions for `INSPECTION` rules, and the AWS Network Firewall logging permissions for `CONFIGURATION` rules.

Diff

diff --git a/AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-rule.md b/AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-rule.md
index 94d76a9..817ceea 100644
--- a//AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-rule.md
+++ b//AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-rule.md
@@ -11 +11 @@ This is the new _CloudFormation Template Reference Guide_. Please update your bo
-The `AWS::NetworkSecurityManager::Rule` resource specifies an AWS Network Security Manager rule. A rule defines a network security configuration to enforce, such as an AWS WAF rule group or a single web ACL setting.
+The `AWS::NetworkSecurityManager::Rule` resource specifies an AWS Network Security Manager rule. A rule defines a network security configuration to enforce, such as an AWS WAF rule group, a single web ACL setting, or a single AWS Network Firewall automated internet firewall policy setting.
@@ -57,0 +58,4 @@ The firewall configuration for the rule, as a JSON string. The structure depends
+For an `IGW_FIREWALL` rule, provide a JSON object with exactly one top-level key, which names the AWS Network Firewall setting that the rule configures. For an `INSPECTION` rule, the key is one of `FirewallRuleGroupEntry`, `IpsRuleGroupEntry`, `PolicyMode`, `FirewallDefaultAction`, or `StatefulEngineOptions`, and its value uses the format of the matching member of the AWS Network Firewall `FirewallPolicyV2` structure. `FirewallRuleGroupEntry` and `IpsRuleGroupEntry` each take a single entry rather than a list. For a `CONFIGURATION` rule, the key is `LoggingConfiguration`. For example: `{"PolicyMode":"ENFORCE"}`.
+
+When you create or update an `IGW_FIREWALL` rule, AWS Network Security Manager validates the configuration with an AWS Network Firewall dry run that uses your credentials. The IAM principal that runs the stack operation needs the `network-firewall:CreateFirewallPolicyV2` and `network-firewall:TagResource` permissions for `INSPECTION` rules, and the AWS Network Firewall logging permissions for `CONFIGURATION` rules.
+
@@ -75 +79 @@ _Required_ : Conditional
-The type of firewall that the rule configures. `WAF` specifies an AWS WAF rule.
+The type of firewall that the rule configures. `WAF` specifies an AWS WAF rule. `IGW_FIREWALL` specifies a rule for AWS Network Firewall automated internet firewall policies.
@@ -183 +187 @@ _Allowed Values_ : `DRAFT` | `ACTIVE`
-The time when the resource was last updated. For a snapshot, this is the time when the snapshot was created.
+The date and time when the rule was last updated, in ISO 8601 format. For example: `2026-11-19T21:42:56Z`.
@@ -191,0 +196,9 @@ The version of the resource.
+## 
+
+  * Create a rule that sets the default action of a web ACL
+
+  * Create a rule that sets the policy mode of an internet firewall policy
+
+
+
+
@@ -216,0 +230,21 @@ The version of the resource.
+### Create a rule that sets the policy mode of an internet firewall policy
+
+#### YAML
+    
+    
+                    AWSTemplateFormatVersion: "2010-09-09"
+                    Description: Creates a Network Security Manager rule for a Network Firewall automated internet firewall policy.
+                    Resources:
+                      EnforceModeRule:
+                        Type: AWS::NetworkSecurityManager::Rule
+                        Properties:
+                          RuleName: igw-enforce-mode
+                          RuleDescription: Enforces the firewall rules instead of only alerting.
+                          FirewallType: IGW_FIREWALL
+                          RuleType: INSPECTION
+                          Configuration: '{"PolicyMode":"ENFORCE"}'
+                    Outputs:
+                      RuleArn:
+                        Value: !GetAtt EnforceModeRule.RuleArn
+            
+