Class StatefulEngineOptions
- java.lang.Object
-
- software.amazon.awssdk.services.fms.model.StatefulEngineOptions
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<StatefulEngineOptions.Builder,StatefulEngineOptions>
@Generated("software.amazon.awssdk:codegen") public final class StatefulEngineOptions extends Object implements SdkPojo, Serializable, ToCopyableBuilder<StatefulEngineOptions.Builder,StatefulEngineOptions>
Configuration settings for the handling of the stateful rule groups in a Network Firewall firewall policy.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceStatefulEngineOptions.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static StatefulEngineOptions.Builderbuilder()booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()RuleOrderruleOrder()Indicates how to manage the order of stateful rule evaluation for the policy.StringruleOrderAsString()Indicates how to manage the order of stateful rule evaluation for the policy.List<SdkField<?>>sdkFields()static Class<? extends StatefulEngineOptions.Builder>serializableBuilderClass()StreamExceptionPolicystreamExceptionPolicy()Indicates how Network Firewall should handle traffic when a network connection breaks midstream.StringstreamExceptionPolicyAsString()Indicates how Network Firewall should handle traffic when a network connection breaks midstream.StatefulEngineOptions.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
ruleOrder
public final RuleOrder ruleOrder()
Indicates how to manage the order of stateful rule evaluation for the policy. Stateful rules are provided to the rule engine as Suricata compatible strings, and Suricata evaluates them based on certain settings. For more information, see Evaluation order for stateful rules in the Network Firewall Developer Guide.
Default:
DEFAULT_ACTION_ORDERIf the service returns an enum value that is not available in the current SDK version,
ruleOrderwill returnRuleOrder.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromruleOrderAsString().- Returns:
- Indicates how to manage the order of stateful rule evaluation for the policy. Stateful rules are provided
to the rule engine as Suricata compatible strings, and Suricata evaluates them based on certain settings.
For more information, see Evaluation order for stateful rules in the Network Firewall Developer Guide.
Default:
DEFAULT_ACTION_ORDER - See Also:
RuleOrder
-
ruleOrderAsString
public final String ruleOrderAsString()
Indicates how to manage the order of stateful rule evaluation for the policy. Stateful rules are provided to the rule engine as Suricata compatible strings, and Suricata evaluates them based on certain settings. For more information, see Evaluation order for stateful rules in the Network Firewall Developer Guide.
Default:
DEFAULT_ACTION_ORDERIf the service returns an enum value that is not available in the current SDK version,
ruleOrderwill returnRuleOrder.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromruleOrderAsString().- Returns:
- Indicates how to manage the order of stateful rule evaluation for the policy. Stateful rules are provided
to the rule engine as Suricata compatible strings, and Suricata evaluates them based on certain settings.
For more information, see Evaluation order for stateful rules in the Network Firewall Developer Guide.
Default:
DEFAULT_ACTION_ORDER - See Also:
RuleOrder
-
streamExceptionPolicy
public final StreamExceptionPolicy streamExceptionPolicy()
Indicates how Network Firewall should handle traffic when a network connection breaks midstream.
-
DROP- Fail closed and drop all subsequent traffic going to the firewall. -
CONTINUE- Continue to apply rules to subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on context. For example, with a stateful rule that drops HTTP traffic, Network Firewall won't match subsequent traffic because the it won't have the context from session initialization, which defines the application layer protocol as HTTP. However, a TCP-layer rule using aflow:statelessrule would still match, and so would theaws:drop_strictdefault action. -
REJECT- Fail closed and drop all subsequent traffic going to the firewall. With this option, Network Firewall also sends a TCP reject packet back to the client so the client can immediately establish a new session. With the new session, Network Firewall will have context and will apply rules appropriately.For applications that are reliant on long-lived TCP connections that trigger Gateway Load Balancer idle timeouts, this is the recommended setting.
-
FMS_IGNORE- Firewall Manager doesn't monitor or modify the Network Firewall stream exception policy settings.
For more information, see Stream exception policy in your firewall policy in the Network Firewall Developer Guide.
Default:
FMS_IGNOREIf the service returns an enum value that is not available in the current SDK version,
streamExceptionPolicywill returnStreamExceptionPolicy.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstreamExceptionPolicyAsString().- Returns:
- Indicates how Network Firewall should handle traffic when a network connection breaks midstream.
-
DROP- Fail closed and drop all subsequent traffic going to the firewall. -
CONTINUE- Continue to apply rules to subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on context. For example, with a stateful rule that drops HTTP traffic, Network Firewall won't match subsequent traffic because the it won't have the context from session initialization, which defines the application layer protocol as HTTP. However, a TCP-layer rule using aflow:statelessrule would still match, and so would theaws:drop_strictdefault action. -
REJECT- Fail closed and drop all subsequent traffic going to the firewall. With this option, Network Firewall also sends a TCP reject packet back to the client so the client can immediately establish a new session. With the new session, Network Firewall will have context and will apply rules appropriately.For applications that are reliant on long-lived TCP connections that trigger Gateway Load Balancer idle timeouts, this is the recommended setting.
-
FMS_IGNORE- Firewall Manager doesn't monitor or modify the Network Firewall stream exception policy settings.
For more information, see Stream exception policy in your firewall policy in the Network Firewall Developer Guide.
Default:
FMS_IGNORE -
- See Also:
StreamExceptionPolicy
-
-
streamExceptionPolicyAsString
public final String streamExceptionPolicyAsString()
Indicates how Network Firewall should handle traffic when a network connection breaks midstream.
-
DROP- Fail closed and drop all subsequent traffic going to the firewall. -
CONTINUE- Continue to apply rules to subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on context. For example, with a stateful rule that drops HTTP traffic, Network Firewall won't match subsequent traffic because the it won't have the context from session initialization, which defines the application layer protocol as HTTP. However, a TCP-layer rule using aflow:statelessrule would still match, and so would theaws:drop_strictdefault action. -
REJECT- Fail closed and drop all subsequent traffic going to the firewall. With this option, Network Firewall also sends a TCP reject packet back to the client so the client can immediately establish a new session. With the new session, Network Firewall will have context and will apply rules appropriately.For applications that are reliant on long-lived TCP connections that trigger Gateway Load Balancer idle timeouts, this is the recommended setting.
-
FMS_IGNORE- Firewall Manager doesn't monitor or modify the Network Firewall stream exception policy settings.
For more information, see Stream exception policy in your firewall policy in the Network Firewall Developer Guide.
Default:
FMS_IGNOREIf the service returns an enum value that is not available in the current SDK version,
streamExceptionPolicywill returnStreamExceptionPolicy.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstreamExceptionPolicyAsString().- Returns:
- Indicates how Network Firewall should handle traffic when a network connection breaks midstream.
-
DROP- Fail closed and drop all subsequent traffic going to the firewall. -
CONTINUE- Continue to apply rules to subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on context. For example, with a stateful rule that drops HTTP traffic, Network Firewall won't match subsequent traffic because the it won't have the context from session initialization, which defines the application layer protocol as HTTP. However, a TCP-layer rule using aflow:statelessrule would still match, and so would theaws:drop_strictdefault action. -
REJECT- Fail closed and drop all subsequent traffic going to the firewall. With this option, Network Firewall also sends a TCP reject packet back to the client so the client can immediately establish a new session. With the new session, Network Firewall will have context and will apply rules appropriately.For applications that are reliant on long-lived TCP connections that trigger Gateway Load Balancer idle timeouts, this is the recommended setting.
-
FMS_IGNORE- Firewall Manager doesn't monitor or modify the Network Firewall stream exception policy settings.
For more information, see Stream exception policy in your firewall policy in the Network Firewall Developer Guide.
Default:
FMS_IGNORE -
- See Also:
StreamExceptionPolicy
-
-
toBuilder
public StatefulEngineOptions.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<StatefulEngineOptions.Builder,StatefulEngineOptions>
-
builder
public static StatefulEngineOptions.Builder builder()
-
serializableBuilderClass
public static Class<? extends StatefulEngineOptions.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
-