software.amazon.awssdk.services.wafv2.model

Class JA3Fingerprint

java.lang.Object

software.amazon.awssdk.services.wafv2.model.JA3Fingerprint

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<JA3Fingerprint.Builder,JA3Fingerprint>

@Generated(value="software.amazon.awssdk:codegen")
public final class JA3Fingerprint
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<JA3Fingerprint.Builder,JA3Fingerprint>

Match against the request's JA3 fingerprint. The JA3 fingerprint is a 32-character hash derived from the TLS Client Hello of an incoming request. This fingerprint serves as a unique identifier for the client's TLS configuration. WAF calculates and logs this fingerprint for each request that has enough TLS Client Hello information for the calculation. Almost all web requests include this information.

You can use this choice only with a string match ByteMatchStatement with the PositionalConstraint set to EXACTLY.

You can obtain the JA3 fingerprint for client requests from the web ACL logs. If WAF is able to calculate the fingerprint, it includes it in the logs. For information about the logging fields, see Log fields in the WAF Developer Guide.

Provide the JA3 fingerprint string from the logs in your string match statement specification, to match with any future requests that have the same TLS configuration.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	JA3Fingerprint.Builder

Method Summary

Modifier and Type	Method and Description
static JA3Fingerprint.Builder	builder()
boolean	equals(Object obj)
boolean	equalsBySdkFields(Object obj)
FallbackBehavior	fallbackBehavior() The match status to assign to the web request if the request doesn't have a JA3 fingerprint.
String	fallbackBehaviorAsString() The match status to assign to the web request if the request doesn't have a JA3 fingerprint.
<T> Optional<T>	getValueForField(String fieldName, Class<T> clazz)
int	hashCode()
List<SdkField<?>>	sdkFields()
static Class<? extends JA3Fingerprint.Builder>	serializableBuilderClass()
JA3Fingerprint.Builder	toBuilder()
String	toString() 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

fallbackBehavior

public final FallbackBehavior fallbackBehavior()

The match status to assign to the web request if the request doesn't have a JA3 fingerprint.

You can specify the following fallback behaviors:

• MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.

• NO_MATCH - Treat the web request as not matching the rule statement.

If the service returns an enum value that is not available in the current SDK version, fallbackBehavior will return FallbackBehavior.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from fallbackBehaviorAsString().

Returns:

The match status to assign to the web request if the request doesn't have a JA3 fingerprint.

You can specify the following fallback behaviors:

• MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.

• NO_MATCH - Treat the web request as not matching the rule statement.

See Also:

FallbackBehavior

fallbackBehaviorAsString

public final String fallbackBehaviorAsString()

The match status to assign to the web request if the request doesn't have a JA3 fingerprint.

You can specify the following fallback behaviors:

• MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.

• NO_MATCH - Treat the web request as not matching the rule statement.

If the service returns an enum value that is not available in the current SDK version, fallbackBehavior will return FallbackBehavior.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from fallbackBehaviorAsString().

Returns:

The match status to assign to the web request if the request doesn't have a JA3 fingerprint.

You can specify the following fallback behaviors:

• MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.

• NO_MATCH - Treat the web request as not matching the rule statement.

See Also:

FallbackBehavior

toBuilder

public JA3Fingerprint.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<JA3Fingerprint.Builder,JA3Fingerprint>

builder

public static JA3Fingerprint.Builder builder()

serializableBuilderClass

public static Class<? extends JA3Fingerprint.Builder> serializableBuilderClass()

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object

equalsBySdkFields

public final boolean equalsBySdkFields(Object obj)

Specified by:

equalsBySdkFields in interface SdkPojo

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.

Overrides:

toString in class Object

getValueForField

public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)

sdkFields

public final List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo