Skip to main content

Cyware Orchestrate

Arkose Labs

App Vendor: Arkose Labs

App Category: API Security

Connector Version: 1.0.0

API Version: 1.0.0

Note

This app is currently released as a beta version.

About App

Arkose Labs provides you with lasting bot prevention and account security by sapping the financial motivations of cybercriminals. Stay protected from various fraudulent activities, such as account takeover (ATO) attacks, credential stuffing, fake account creation, and bot-driven attacks.

The Arkose Labs app is configured with Orchestrate to perform the following actions:

Action Name

Description

Check API Status 

This action checks the API status.

Check API Status by Region 

This action accesses regional health checks and response time information.

Generic Action 

This is a generic action used to make requests to any Arkose Labs endpoint.

Post Truth Data 

This action posts truth data to Arkose Labs.

Configuration Parameters

The following configuration parameters are required for the Arkose Labs app to communicate with the Arkose Labs enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required/Optional

Comments

Access ID 

Enter the access ID to connect with Arkose Labs.

Text

Required

Secret Key 

Enter the secret key to authenticate with Arkose Labs.

Password

Required

Timeout 

Enter the timeout value in seconds. This is the number of seconds that requests will wait to establish a connection with Arkose Labs. 

Integer

Optional

Allowed values:

15-120

Default value:

15

Verify 

Choose your preference to verify SSL or TLS while making requests. It is recommended to set this option to yes. Passing no may result in incorrectly establishing the connection.

Boolean

Optional

Allowed values:

  • true

  • false

Default value:

false

Action: Check API Status

This action checks the API status.

Action Input Parameters 

This action does not require any input parameters.

Action: Check API Status by Region

This action accesses regional health checks and response time information.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Component ID 

Enter the component ID. 

Example: 

x7vj2bf6ckzv

Text

Required

Refer Arkose Labs API documentation for available component IDs. Note that the component IDs in the API documentation are subject to change.

Time Range 

Enter the time range to check the status. 

Text

Optional

Allowed values:

  • day.json

  • week.json

  • month.json

Action: Post Truth Data

Truth Data refers to the comprehensive dataset that provides Arkose Labs with additional data points to improve detection capabilities. This action posts truth data to Arkose Labs.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Session ID 

Enter the Arkose session ID to post the truth data. This acts as the primary link between the truth data and its Arkose session. 

Example: 

11663602dda317f65.6750167505

Text

Required

Public Key 

Enter the public key against which the session was originally generated. 

Example: 

1f662b05-b798-d2a3-b687-c1d43dd4eb76

Text

Required

Note

Sending a wrong public key will significantly impact Arkose Labs' ability to process these truth data sessions correctly.

Is Legit 

Enter whether you consider the session legit or non-legit. 

Integer

Required

Allowed values:

  • 0 (Indicates that the session is non-legit)

  • 1 (Indicates that the session is legit)

Creation Time 

Enter the date and timestamp of the session creation.

Text

Optional

The date and time must be of the format YYYY-MM-DD HH:MM:SS. 

Decision Time 

Enter the date and timestamp of the decision for the session. 

Text

Optional

The date and time must be of the format YYYY-MM-DD HH:MM:SS. 

Event Type 

Enter the stage of a user’s lifecycle where the event occurred. This data helps Arkose Labs create appropriate algorithms tailored to the specific event type, which reduces false positives. 

Integer

Optional

Allowed values:

  • 1 (registration)

  • 2 (login)

  • 3 (password_reset)

  • 4 (account_settings)

  • 5 (transaction)

Fraud Category 

Enter the category of the fraud. This information helps Arkose Labs tune the appropriate algorithm’s parameters, which reduces false positives. 

Integer

Optional

Allowed values:

  • 1 (automation)

  • 2 (fraud_farm)

  • 3 (human_driven)

Fraud Type 

Enter the fraud type. This helps Arkose Labs create and improve algorithms tailored to specific fraud types and verticals, improving overall accuracy. 

Integer

Optional

Allowed values:

  • 1 (fake_email)

  • 2 (fake_phone_number)

  • 3 (stolen_financial_improvement)

  • 4 (fraudulent_chargeback)

  • 5 (social_engineering_attempt)

Action: Generic Action

This is a generic action used to make requests to any Arkose Labs endpoint.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Method 

Enter the HTTP method to make the request. 

Text

Required

Allowed values:

  • GET

  • PUT

  • POST

  • DELETE

Endpoint 

Enter the endpoint to make the request. 

Example: 

/api/v1/poll_query

Text

Required

Query Params 

Enter the query parameters to pass to the API. 

Example: 

id: s647382829tdf

Key Value

Optional

Payload 

Enter the payload to pass to the API. 

Example: 

name: john

Any

Optional

Additional Data 

Enter the extra fields to pass to the API. 

Example: 

action: permit

Key Value

Optional