Class: Aws::NetworkFirewall::Types::Route53ResolvedIPValidation

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-networkfirewall/lib/aws-sdk-networkfirewall/types.rb

Overview

The policy-level configuration for resolved IP validation. When you set this on a firewall policy, you require that the destination IP address of a connection is one that the Amazon Route 53 Resolver returned in a DNS response for a domain. The Route 53 Resolver must have returned the response in a VPC that's associated with the Route 53 Resolver DNS Firewall rule group identified by DNSFirewallRuleGroupId. At the policy level, this verifies that the destination IP address was resolved for some domain. To match specific domains, also configure stateful rule groups that use the AWS_ROUTE_53_RESOLVED_DOMAIN target type or the aws_route_53_resolved_domain rule keyword.

See Also:

Constant Summary collapse

SENSITIVE = 
[]

Instance Attribute Summary collapse

Instance Attribute Details

#action ⇒ String

The action that Network Firewall takes for a connection whose destination IP address fails resolved IP validation. A destination IP address fails validation when the Route 53 Resolver didn't return it in a DNS response in an associated VPC. Valid values are the following:

  • ALERT – Tags the matching connection in the firewall's flow logs without blocking it, when you enable logging. Use this to observe the effect of resolved IP validation before you enforce it.

  • DROP – Silently blocks the connection without sending any response to the client.

  • REJECT – Blocks the connection and sends a TCP reset (RST) to the client. Because a TCP reset applies only to TCP connections, Network Firewall drops non-TCP traffic instead of resetting it.

Returns:

  • (String) 


7192
7193
7194
7195
7196
7197
7198
7199
7200
 
# File 'gems/aws-sdk-networkfirewall/lib/aws-sdk-networkfirewall/types.rb', line 7192

class Route53ResolvedIPValidation < Struct.new(
  :action,
  :dns_firewall_rule_group_id,
  :dns_expiry_exception_policy,
  :bypass_destination_validation_ip_ranges,
  :source_ip_ranges)
  SENSITIVE = []
  include Aws::Structure
end

#bypass_destination_validation_ip_ranges ⇒ Array<Types::Address>

The destination IP address ranges that are exempt from the policy-level resolved IP check. Network Firewall doesn't apply the Action in this configuration to a connection whose destination falls in these ranges, even if the Route 53 Resolver didn't return that IP address in an associated VPC. Specify each entry as an IPv4 or IPv6 address or CIDR range, up to 100 entries.

This exemption applies only to the policy-level check. Stateful rules that use the AWS_ROUTE_53_RESOLVED_DOMAIN target type or the aws_route_53_resolved_domain keyword still evaluate connections to these destinations and match them independently of this list.

Returns:



7192
7193
7194
7195
7196
7197
7198
7199
7200
 
# File 'gems/aws-sdk-networkfirewall/lib/aws-sdk-networkfirewall/types.rb', line 7192

class Route53ResolvedIPValidation < Struct.new(
  :action,
  :dns_firewall_rule_group_id,
  :dns_expiry_exception_policy,
  :bypass_destination_validation_ip_ranges,
  :source_ip_ranges)
  SENSITIVE = []
  include Aws::Structure
end

#dns_expiry_exception_policy ⇒ String

The action that Network Firewall takes when the DNS resolution recorded for a destination IP address has expired from the resolved IP cache. This applies when Network Firewall still sees traffic to that IP address after the expiry. Network Firewall keeps a resolution for longer than the DNS record's time to live (TTL). Valid values are the following:

  • CONTINUE – Treats the expired resolution as still valid and doesn't block the connection because of expiry.

  • DROP – Silently blocks traffic to the IP address after its resolution has expired, without sending any response to the client.

  • REJECT – Blocks traffic to the IP address after its resolution has expired and sends a TCP reset (RST) to the client. Network Firewall drops non-TCP traffic instead of resetting it.

Returns:

  • (String) 


7192
7193
7194
7195
7196
7197
7198
7199
7200
 
# File 'gems/aws-sdk-networkfirewall/lib/aws-sdk-networkfirewall/types.rb', line 7192

class Route53ResolvedIPValidation < Struct.new(
  :action,
  :dns_firewall_rule_group_id,
  :dns_expiry_exception_policy,
  :bypass_destination_validation_ip_ranges,
  :source_ip_ranges)
  SENSITIVE = []
  include Aws::Structure
end

#dns_firewall_rule_group_id ⇒ String

The ID of the Route 53 Resolver DNS Firewall rule group that determines which VPCs' DNS resolutions count for resolved IP validation. A destination IP address counts as resolved for a domain only when the Route 53 Resolver returned it in a DNS response within a VPC that's associated with this rule group. Associate the rule group with the VPCs that send traffic to the firewall. The ID must match the pattern ^rslvr-frg-[0-9a-f]+$. It must also exist and be accessible from your account. Network Firewall validates this when you create or update the policy.

Changing this value swaps the managed rule group association. Network Firewall processes the swap asynchronously. Each policy can have only one managed Route 53 Resolver DNS Firewall association. While a swap is in progress, Network Firewall rejects further changes to this setting. Wait until the swap completes, then retry.

Returns:

  • (String) 


7192
7193
7194
7195
7196
7197
7198
7199
7200
 
# File 'gems/aws-sdk-networkfirewall/lib/aws-sdk-networkfirewall/types.rb', line 7192

class Route53ResolvedIPValidation < Struct.new(
  :action,
  :dns_firewall_rule_group_id,
  :dns_expiry_exception_policy,
  :bypass_destination_validation_ip_ranges,
  :source_ip_ranges)
  SENSITIVE = []
  include Aws::Structure
end

#source_ip_ranges ⇒ Array<Types::Address>

The client source IP address ranges whose connections are subject to resolved IP validation. Specify each entry as an IPv4 or IPv6 address or CIDR range, up to 100 entries. If you omit this field, resolved IP validation applies to the CIDR ranges of the firewall's VPC and of any additional VPCs attached to the firewall. Specifying an empty list is not the same as omitting the field: an empty list means that Network Firewall doesn't validate any source addresses.

This scope applies to the policy-level check only. Stateful rules that use the AWS_ROUTE_53_RESOLVED_DOMAIN target type or the aws_route_53_resolved_domain keyword still evaluate their destinations regardless of SourceIPRanges.

Returns:



7192
7193
7194
7195
7196
7197
7198
7199
7200
 
# File 'gems/aws-sdk-networkfirewall/lib/aws-sdk-networkfirewall/types.rb', line 7192

class Route53ResolvedIPValidation < Struct.new(
  :action,
  :dns_firewall_rule_group_id,
  :dns_expiry_exception_policy,
  :bypass_destination_validation_ip_ranges,
  :source_ip_ranges)
  SENSITIVE = []
  include Aws::Structure
end