Class StatefulEngineOptions
- java.lang.Object
-
- software.amazon.awssdk.services.networkfirewall.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 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)FlowTimeoutsflowTimeouts()Configures the amount of time that can pass without any traffic sent through the firewall before the firewall determines that the connection is idle.<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.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends StatefulEngineOptions.Builder>serializableBuilderClass()StreamExceptionPolicystreamExceptionPolicy()Configures how Network Firewall processes traffic when a network connection breaks midstream.StringstreamExceptionPolicyAsString()Configures how Network Firewall processes 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.
STRICT_ORDERis the default and recommended option. WithSTRICT_ORDER, provide your rules in the order that you want them to be evaluated. You can then choose one or more default actions for packets that don't match any rules. ChooseSTRICT_ORDERto have the stateful rules engine determine the evaluation order of your rules. The default action for this rule order isPASS, followed byDROP,REJECT, andALERTactions. Stateful rules are provided to the rule engine as Suricata compatible strings, and Suricata evaluates them based on your settings. For more information, see Evaluation order for stateful rules in the Network Firewall Developer Guide.If 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.
STRICT_ORDERis the default and recommended option. WithSTRICT_ORDER, provide your rules in the order that you want them to be evaluated. You can then choose one or more default actions for packets that don't match any rules. ChooseSTRICT_ORDERto have the stateful rules engine determine the evaluation order of your rules. The default action for this rule order isPASS, followed byDROP,REJECT, andALERTactions. Stateful rules are provided to the rule engine as Suricata compatible strings, and Suricata evaluates them based on your settings. For more information, see Evaluation order for stateful rules in the Network Firewall Developer Guide. - See Also:
RuleOrder
-
ruleOrderAsString
public final String ruleOrderAsString()
Indicates how to manage the order of stateful rule evaluation for the policy.
STRICT_ORDERis the default and recommended option. WithSTRICT_ORDER, provide your rules in the order that you want them to be evaluated. You can then choose one or more default actions for packets that don't match any rules. ChooseSTRICT_ORDERto have the stateful rules engine determine the evaluation order of your rules. The default action for this rule order isPASS, followed byDROP,REJECT, andALERTactions. Stateful rules are provided to the rule engine as Suricata compatible strings, and Suricata evaluates them based on your settings. For more information, see Evaluation order for stateful rules in the Network Firewall Developer Guide.If 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.
STRICT_ORDERis the default and recommended option. WithSTRICT_ORDER, provide your rules in the order that you want them to be evaluated. You can then choose one or more default actions for packets that don't match any rules. ChooseSTRICT_ORDERto have the stateful rules engine determine the evaluation order of your rules. The default action for this rule order isPASS, followed byDROP,REJECT, andALERTactions. Stateful rules are provided to the rule engine as Suricata compatible strings, and Suricata evaluates them based on your settings. For more information, see Evaluation order for stateful rules in the Network Firewall Developer Guide. - See Also:
RuleOrder
-
streamExceptionPolicy
public final StreamExceptionPolicy streamExceptionPolicy()
Configures how Network Firewall processes traffic when a network connection breaks midstream. Network connections can break due to disruptions in external networks or within the firewall itself.
-
DROP- Network Firewall fails closed and drops all subsequent traffic going to the firewall. This is the default behavior. -
CONTINUE- Network Firewall continues to apply rules to the subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on this context. For example, if you have a stateful rule todrop httptraffic, Network Firewall won't match the traffic for this rule because the service won't have the context from session initialization defining the application layer protocol as HTTP. However, this behavior is rule dependent—a TCP-layer rule using aflow:statelessrule would still match, as would theaws:drop_strictdefault action. -
REJECT- Network Firewall fails closed and drops all subsequent traffic going to the firewall. Network Firewall also sends a TCP reject packet back to your client so that the client can immediately establish a new session. Network Firewall will have context about the new session and will apply rules to the subsequent traffic.
If 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:
- Configures how Network Firewall processes traffic when a network connection breaks midstream. Network
connections can break due to disruptions in external networks or within the firewall itself.
-
DROP- Network Firewall fails closed and drops all subsequent traffic going to the firewall. This is the default behavior. -
CONTINUE- Network Firewall continues to apply rules to the subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on this context. For example, if you have a stateful rule todrop httptraffic, Network Firewall won't match the traffic for this rule because the service won't have the context from session initialization defining the application layer protocol as HTTP. However, this behavior is rule dependent—a TCP-layer rule using aflow:statelessrule would still match, as would theaws:drop_strictdefault action. -
REJECT- Network Firewall fails closed and drops all subsequent traffic going to the firewall. Network Firewall also sends a TCP reject packet back to your client so that the client can immediately establish a new session. Network Firewall will have context about the new session and will apply rules to the subsequent traffic.
-
- See Also:
StreamExceptionPolicy
-
-
streamExceptionPolicyAsString
public final String streamExceptionPolicyAsString()
Configures how Network Firewall processes traffic when a network connection breaks midstream. Network connections can break due to disruptions in external networks or within the firewall itself.
-
DROP- Network Firewall fails closed and drops all subsequent traffic going to the firewall. This is the default behavior. -
CONTINUE- Network Firewall continues to apply rules to the subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on this context. For example, if you have a stateful rule todrop httptraffic, Network Firewall won't match the traffic for this rule because the service won't have the context from session initialization defining the application layer protocol as HTTP. However, this behavior is rule dependent—a TCP-layer rule using aflow:statelessrule would still match, as would theaws:drop_strictdefault action. -
REJECT- Network Firewall fails closed and drops all subsequent traffic going to the firewall. Network Firewall also sends a TCP reject packet back to your client so that the client can immediately establish a new session. Network Firewall will have context about the new session and will apply rules to the subsequent traffic.
If 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:
- Configures how Network Firewall processes traffic when a network connection breaks midstream. Network
connections can break due to disruptions in external networks or within the firewall itself.
-
DROP- Network Firewall fails closed and drops all subsequent traffic going to the firewall. This is the default behavior. -
CONTINUE- Network Firewall continues to apply rules to the subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on this context. For example, if you have a stateful rule todrop httptraffic, Network Firewall won't match the traffic for this rule because the service won't have the context from session initialization defining the application layer protocol as HTTP. However, this behavior is rule dependent—a TCP-layer rule using aflow:statelessrule would still match, as would theaws:drop_strictdefault action. -
REJECT- Network Firewall fails closed and drops all subsequent traffic going to the firewall. Network Firewall also sends a TCP reject packet back to your client so that the client can immediately establish a new session. Network Firewall will have context about the new session and will apply rules to the subsequent traffic.
-
- See Also:
StreamExceptionPolicy
-
-
flowTimeouts
public final FlowTimeouts flowTimeouts()
Configures the amount of time that can pass without any traffic sent through the firewall before the firewall determines that the connection is idle.
- Returns:
- Configures the amount of time that can pass without any traffic sent through the firewall before the firewall determines that the connection is idle.
-
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.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-