AWS AWSCloudFormation: Document specialized IGW_FIREWALL_SUBNET_CONNECTIVITY_OVERRIDE scope
Summary
Adds documentation for specialized scopes, including the IGW_FIREWALL_SUBNET_CONNECTIVITY_OVERRIDE type that selects subnets for a Network Firewall automated internet firewall policy override. Lists supported resource types, states the scope must select only AWS::EC2::Subnet and must not include an AccountFilter (accounts are determined by the deployment), notes specialized scopes cannot be associated with a deployment, and adds a YAML example.
Security assessment
The added constraint prevents a scope from carrying its own AccountFilter, ensuring the set of accounts a firewall policy applies to is governed by the deployment rather than the scope definition — a guardrail against unintended policy application across accounts. This is security-relevant configuration guidance for a network security control, not a fix for a specific vulnerability.
Evidence
A scope of this type must select only `AWS::EC2::Subnet` resources and must not include an `AccountFilter`, because the deployment that applies the policy determines which accounts are in scope.
Diff
diff --git a/AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-scope.md b/AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-scope.md index b01bbff..449b42c 100644 --- a//AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-scope.md +++ b//AWSCloudFormation/latest/TemplateReference/aws-resource-networksecuritymanager-scope.md @@ -12,0 +13,2 @@ The `AWS::NetworkSecurityManager::Scope` resource specifies an AWS Network Secur +A scope can instead be a _specialized_ scope, which is built for one specific purpose. A scope with a `SpecializedScopeType` of `IGW_FIREWALL_SUBNET_CONNECTIVITY_OVERRIDE` selects the subnets that a subnet connectivity override in an AWS Network Firewall automated internet firewall policy applies to. You can't associate a specialized scope with a deployment. + @@ -71,0 +74,2 @@ The resource-level scoping configuration, keyed by resource type, that defines w +The supported resource types are `AWS::ApiGateway::Stage`, `AWS::CloudFront::Distribution`, `AWS::EC2::EIP`, `AWS::ElasticLoadBalancingV2::LoadBalancer::application`, `AWS::ElasticLoadBalancing::LoadBalancer`, `AWS::EC2::VPC`, and `AWS::EC2::Subnet`. Select `AWS::EC2::VPC` for a scope that a deployment of an `IGW_FIREWALL` policy protects. A scope whose `SpecializedScopeType` is `IGW_FIREWALL_SUBNET_CONNECTIVITY_OVERRIDE` can select only `AWS::EC2::Subnet`. + @@ -111 +115,5 @@ _Update requires_ : [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/ -The specialized type of the scope, if the scope is built for one specific purpose. A scope with no `specializedScopeType` is a standard scope that you can associate with a deployment. A specialized scope can be used only for the purpose that its type defines and can't be associated with a deployment. This value is set when the scope is created and can't be changed. +The specialized type of the scope. Omit this property to create a standard scope, which you can associate with a deployment. + +Specify `IGW_FIREWALL_SUBNET_CONNECTIVITY_OVERRIDE` to create a scope that selects the subnets a subnet connectivity override applies to in an AWS Network Firewall automated internet firewall policy. Reference the scope from the `Scopes` property of a `SubnetConnectivityOverride` in the policy's `IgwFirewallConfig`. A scope of this type must select only `AWS::EC2::Subnet` resources and must not include an `AccountFilter`, because the deployment that applies the policy determines which accounts are in scope. You can't associate a specialized scope with a deployment. + +You can't change the specialized type after you create the scope. Changing this property replaces the scope. @@ -176 +184 @@ _Allowed Values_ : `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 scope was last updated, in ISO 8601 format. For example: `2026-11-19T21:42:56Z`. @@ -184,0 +193,9 @@ The version of the scope. AWS Network Security Manager increments this value eac +## + + * Select every CloudFront distribution in the organization + + * Select subnets for an internet firewall connectivity override + + + + @@ -203,0 +221,20 @@ The version of the scope. AWS Network Security Manager increments this value eac +### Select subnets for an internet firewall connectivity override + +#### YAML + + + AWSTemplateFormatVersion: "2010-09-09" + Description: Selects the subnets that an internet firewall policy override applies to. + Resources: + IsolatedSubnetsScope: + Type: AWS::NetworkSecurityManager::Scope + Properties: + ScopeName: isolated-subnets + ScopeDescription: Subnets tagged as isolated. + SpecializedScopeType: IGW_FIREWALL_SUBNET_CONNECTIVITY_OVERRIDE + ScopeConfiguration: '{"ResourceScopes":{"AWS::EC2::Subnet":{"Include":{"Expression":{"Criteria":{"Tags":{"network-zone":"isolated"}}}}}}}' + Outputs: + ScopeArn: + Value: !GetAtt IsolatedSubnetsScope.ScopeArn + +