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.

property 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

property 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

property challenge_settings

Gets the challenge_settings of this DeviceFingerprintChallenge.

Returns

The challenge_settings of this DeviceFingerprintChallenge.

Return type

oci.waas.models.BlockChallengeSettings

property 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

property 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

property 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

property 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

property 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