Google Cloud Recaptcha Enterprise V1 Client - Class WebKeySettings (2.3.0)

Reference documentation and code samples for the Google Cloud Recaptcha Enterprise V1 Client class WebKeySettings.

Settings specific to keys that can be used by websites.

Generated from protobuf message google.cloud.recaptchaenterprise.v1.WebKeySettings

Namespace

Google \ Cloud \ RecaptchaEnterprise \ V1

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ allow_all_domains bool

Optional. If set to true, it means allowed_domains are not enforced.

↳ allowed_domains array

Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com' Each key supports a maximum of 250 domains. To use a key on more domains, set allow_all_domains to true. When this is set, you are responsible for validating the hostname by checking the token_properties.hostname field in each assessment response against your list of allowed domains.

↳ allow_amp_traffic bool

Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.

↳ integration_type int

Required. Describes how this key is integrated with the website.

↳ challenge_security_preference int

Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationType CHECKBOX, INVISIBLE or POLICY_BASED_CHALLENGE.

↳ challenge_settings WebKeySettings\ChallengeSettings

Optional. Challenge settings.

getAllowAllDomains

Optional. If set to true, it means allowed_domains are not enforced.

Returns
Type Description
bool

setAllowAllDomains

Optional. If set to true, it means allowed_domains are not enforced.

Parameter
Name Description
var bool
Returns
Type Description
$this

getAllowedDomains

Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment.

Examples: 'example.com' or 'subdomain.example.com' Each key supports a maximum of 250 domains. To use a key on more domains, set allow_all_domains to true. When this is set, you are responsible for validating the hostname by checking the token_properties.hostname field in each assessment response against your list of allowed domains.

Returns
Type Description
Google\Protobuf\Internal\RepeatedField

setAllowedDomains

Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment.

Examples: 'example.com' or 'subdomain.example.com' Each key supports a maximum of 250 domains. To use a key on more domains, set allow_all_domains to true. When this is set, you are responsible for validating the hostname by checking the token_properties.hostname field in each assessment response against your list of allowed domains.

Parameter
Name Description
var string[]
Returns
Type Description
$this

getAllowAmpTraffic

Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.

Returns
Type Description
bool

setAllowAmpTraffic

Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.

Parameter
Name Description
var bool
Returns
Type Description
$this

getIntegrationType

Required. Describes how this key is integrated with the website.

Returns
Type Description
int Enum of type IntegrationType.

setIntegrationType

Required. Describes how this key is integrated with the website.

Parameter
Name Description
var int

Enum of type IntegrationType.

Returns
Type Description
$this

getChallengeSecurityPreference

Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationType CHECKBOX, INVISIBLE or POLICY_BASED_CHALLENGE.

Returns
Type Description
int Enum of type ChallengeSecurityPreference.

setChallengeSecurityPreference

Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationType CHECKBOX, INVISIBLE or POLICY_BASED_CHALLENGE.

Parameter
Name Description
var int

Enum of type ChallengeSecurityPreference.

Returns
Type Description
$this

getChallengeSettings

Optional. Challenge settings.

Returns
Type Description
WebKeySettings\ChallengeSettings|null

hasChallengeSettings

clearChallengeSettings

setChallengeSettings

Optional. Challenge settings.

Parameter
Name Description
var WebKeySettings\ChallengeSettings
Returns
Type Description
$this