aws-cdk-lib.aws_networkfirewall.CfnRuleGroup.RulesSourceListProperty

RulesSourceListProperty Struct

Stateful inspection criteria for a domain list rule group.

For HTTPS traffic, domain filtering is SNI-based. It uses the server name indicator extension of the TLS handshake.

By default, Network Firewall domain list inspection only includes traffic coming from the VPC where you deploy the firewall. To inspect traffic from IP addresses outside of the deployment VPC, you set the HOME_NET rule variable to include the CIDR range of the deployment VPC plus the other CIDR ranges. For more information, see RuleVariables in this guide and Stateful domain list rule groups in AWS Network Firewall in the Network Firewall Developer Guide

Source

Generated code

Type last changed

v2.93.0 · 23 Aug 2023

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_networkfirewall as networkfirewall } from 'aws-cdk-lib';
const rulesSourceListProperty: networkfirewall.CfnRuleGroup.RulesSourceListProperty = {
  generatedRulesType: 'generatedRulesType',
  targets: ['targets'],
  targetTypes: ['targetTypes'],
};

Properties

generatedRulesTypestringgenerated_rules_typestrgeneratedRulesTypeStringGeneratedRulesTypestringGeneratedRulesType*stringrequired#

Whether you want to apply allow, reject, alert, or drop behavior to the domains in your target list.

When logging is enabled and you choose Alert, traffic that matches the domain specifications generates an alert in the firewall's logs. Then, traffic either passes, is rejected, or drops based on other rules in the firewall policy.

targetsstring[]targetstyping.List[str]targetsList<String>Targetsstring[]Targets*[]*stringrequired#

The domains that you want to inspect for in your traffic flows. Valid domain specifications are the following:.

notes

• Explicit names. For example, abc.example.com matches only the domain abc.example.com .
• Names that use a domain wildcard, which you indicate with an initial ' . '. For example, .example.com matches example.com and matches all subdomains of example.com , such as abc.example.com and www.example.com .

targetTypesstring[]target_typestyping.List[str]targetTypesList<String>TargetTypesstring[]TargetTypes*[]*stringrequired#

The types of targets to inspect for.

Valid values are TLS_SNI and HTTP_HOST .