DeviceFingerprintChallenge¶

class oci.waas.models.DeviceFingerprintChallenge(**kwargs)¶

Bases: object

The device fingerprint challenge settings. The device fingerprint challenge generates hashed signatures of both virtual and real browsers to identify and block malicious bots.

Attributes

`ACTION_BLOCK`	A constant which can be used with the action property of a DeviceFingerprintChallenge.
`ACTION_DETECT`	A constant which can be used with the action property of a DeviceFingerprintChallenge.
`action`	Gets the action of this DeviceFingerprintChallenge.
`action_expiration_in_seconds`	Gets the action_expiration_in_seconds of this DeviceFingerprintChallenge.
`challenge_settings`	Gets the challenge_settings of this DeviceFingerprintChallenge.
`failure_threshold`	Gets the failure_threshold of this DeviceFingerprintChallenge.
`failure_threshold_expiration_in_seconds`	Gets the failure_threshold_expiration_in_seconds of this DeviceFingerprintChallenge.
`is_enabled`	[Required] Gets the is_enabled of this DeviceFingerprintChallenge.
`max_address_count`	Gets the max_address_count of this DeviceFingerprintChallenge.
`max_address_count_expiration_in_seconds`	Gets the max_address_count_expiration_in_seconds of this DeviceFingerprintChallenge.

Methods

__init__(**kwargs) Initializes a new DeviceFingerprintChallenge object with values from keyword arguments.

ACTION_BLOCK = 'BLOCK'¶: A constant which can be used with the action property of a DeviceFingerprintChallenge. This constant has a value of “BLOCK”

ACTION_DETECT = 'DETECT'¶: A constant which can be used with the action property of a DeviceFingerprintChallenge. This constant has a value of “DETECT”

__init__(**kwargs)¶

Initializes a new DeviceFingerprintChallenge object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):

Parameters:

is_enabled (bool) – The value to assign to the is_enabled property of this DeviceFingerprintChallenge.
action (str) – The value to assign to the action property of this DeviceFingerprintChallenge. Allowed values for this property are: “DETECT”, “BLOCK”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
failure_threshold (int) – The value to assign to the failure_threshold property of this DeviceFingerprintChallenge.
action_expiration_in_seconds (int) – The value to assign to the action_expiration_in_seconds property of this DeviceFingerprintChallenge.
failure_threshold_expiration_in_seconds (int) – The value to assign to the failure_threshold_expiration_in_seconds property of this DeviceFingerprintChallenge.
max_address_count (int) – The value to assign to the max_address_count property of this DeviceFingerprintChallenge.
max_address_count_expiration_in_seconds (int) – The value to assign to the max_address_count_expiration_in_seconds property of this DeviceFingerprintChallenge.
challenge_settings (oci.waas.models.BlockChallengeSettings) – The value to assign to the challenge_settings property of this DeviceFingerprintChallenge.

action¶

Gets the action of this DeviceFingerprintChallenge. The action to take on requests from detected bots. If unspecified, defaults to DETECT.

Allowed values for this property are: “DETECT”, “BLOCK”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The action of this DeviceFingerprintChallenge.
Return type:	str

action_expiration_in_seconds¶

Gets the action_expiration_in_seconds of this DeviceFingerprintChallenge. The number of seconds between challenges for the same IP address. If unspecified, defaults to 60.

Returns:	The action_expiration_in_seconds of this DeviceFingerprintChallenge.
Return type:	int

challenge_settings¶

Gets the challenge_settings of this DeviceFingerprintChallenge.

Returns:	The challenge_settings of this DeviceFingerprintChallenge.
Return type:	oci.waas.models.BlockChallengeSettings

failure_threshold¶

Gets the failure_threshold of this DeviceFingerprintChallenge. The number of failed requests allowed before taking action. If unspecified, defaults to 10.

Returns:	The failure_threshold of this DeviceFingerprintChallenge.
Return type:	int

failure_threshold_expiration_in_seconds¶

Gets the failure_threshold_expiration_in_seconds of this DeviceFingerprintChallenge. The number of seconds before the failure threshold resets. If unspecified, defaults to 60.

Returns:	The failure_threshold_expiration_in_seconds of this DeviceFingerprintChallenge.
Return type:	int

is_enabled¶

[Required] Gets the is_enabled of this DeviceFingerprintChallenge. Enables or disables the device fingerprint challenge Web Application Firewall feature.

Returns:	The is_enabled of this DeviceFingerprintChallenge.
Return type:	bool

max_address_count¶

Gets the max_address_count of this DeviceFingerprintChallenge. The maximum number of IP addresses permitted with the same device fingerprint. If unspecified, defaults to 20.

Returns:	The max_address_count of this DeviceFingerprintChallenge.
Return type:	int

max_address_count_expiration_in_seconds¶

Gets the max_address_count_expiration_in_seconds of this DeviceFingerprintChallenge. The number of seconds before the maximum addresses count resets. If unspecified, defaults to 60.

Returns:	The max_address_count_expiration_in_seconds of this DeviceFingerprintChallenge.
Return type:	int