AWS AWSCloudFormation: Document IGW_FIREWALL rule type and required IAM permissions
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 + +