Class: Aws::NetworkFirewall::Types::FirewallPolicy

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

Overview

The firewall policy defines the behavior of a firewall using a collection of stateless and stateful rule groups and other settings. You can use one firewall policy for multiple firewalls.

This, along with FirewallPolicyResponse, define the policy. You can retrieve all objects for a firewall policy by calling DescribeFirewallPolicy.

See Also:

Constant Summary collapse

SENSITIVE = 
[]

Instance Attribute Summary collapse

Instance Attribute Details

#enable_tls_session_holding ⇒ Boolean

When true, prevents TCP and TLS packets from reaching destination servers until TLS Inspection has evaluated Server Name Indication (SNI) rules. Requires an associated TLS Inspection configuration.

Returns:

  • (Boolean) 


4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#policy_variables ⇒ Types::PolicyVariables

Contains variables that you can use to override default Suricata settings in your firewall policy.

Returns:



4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#stateful_default_actions ⇒ Array<String>

The default actions to take on a packet that doesn't match any stateful rules. The stateful default action is optional, and is only valid when using the strict rule order.

Valid values of the stateful default action:

  • aws:drop_strict

  • aws:drop_established

  • aws:alert_strict

  • aws:alert_established

  • aws:drop_established_app_layer

  • aws:alert_established_app_layer

  • aws:drop_established_app_layer_to_server

  • aws:alert_established_app_layer_to_server

For more information, see Strict evaluation order in the Network Firewall Developer Guide.

Returns:

  • (Array<String>) 


4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#stateful_engine_options ⇒ Types::StatefulEngineOptions

Additional options governing how Network Firewall handles stateful rules. The stateful rule groups that you use in your policy must have stateful rule options settings that are compatible with these settings.

Returns:



4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#stateful_rule_group_references ⇒ Array<Types::StatefulRuleGroupReference>

References to the stateful rule groups that are used in the policy. These define the inspection criteria in stateful rules.

Returns:



4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#stateless_custom_actions ⇒ Array<Types::CustomAction>

The custom action definitions that are available for use in the firewall policy's StatelessDefaultActions setting. You name each custom action that you define, and then you can use it by name in your default actions specifications.

Returns:



4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#stateless_default_actions ⇒ Array<String>

The actions to take on a packet if it doesn't match any of the stateless rules in the policy. If you want non-matching packets to be forwarded for stateful inspection, specify aws:forward_to_sfe.

You must specify one of the standard actions: aws:pass, aws:drop, or aws:forward_to_sfe. In addition, you can specify custom actions that are compatible with your standard section choice.

For example, you could specify ["aws:pass"] or you could specify ["aws:pass", “customActionName”]. For information about compatibility, see the custom action descriptions under CustomAction.

Returns:

  • (Array<String>) 


4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#stateless_fragment_default_actions ⇒ Array<String>

The actions to take on a fragmented UDP packet if it doesn't match any of the stateless rules in the policy. Network Firewall only manages UDP packet fragments and silently drops packet fragments for other protocols. If you want non-matching fragmented UDP packets to be forwarded for stateful inspection, specify aws:forward_to_sfe.

You must specify one of the standard actions: aws:pass, aws:drop, or aws:forward_to_sfe. In addition, you can specify custom actions that are compatible with your standard section choice.

For example, you could specify ["aws:pass"] or you could specify ["aws:pass", “customActionName”]. For information about compatibility, see the custom action descriptions under CustomAction.

Returns:

  • (Array<String>) 


4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#stateless_rule_group_references ⇒ Array<Types::StatelessRuleGroupReference>

References to the stateless rule groups that are used in the policy. These define the matching criteria in stateless rules.

Returns:



4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end

#tls_inspection_configuration_arn ⇒ String

The Amazon Resource Name (ARN) of the TLS inspection configuration.

Returns:

  • (String) 


4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
 
# File 'lib/aws-sdk-networkfirewall/types.rb', line 4348

class FirewallPolicy < Struct.new(
  :stateless_rule_group_references,
  :stateless_default_actions,
  :stateless_fragment_default_actions,
  :stateless_custom_actions,
  :stateful_rule_group_references,
  :stateful_default_actions,
  :stateful_engine_options,
  :tls_inspection_configuration_arn,
  :policy_variables,
  :enable_tls_session_holding)
  SENSITIVE = []
  include Aws::Structure
end