Skip to main content

Cyware Orchestrate

HUMAN

App Vendor: HUMAN

App Category: Network Security

Connector Version: 1.0.0

API Version: v1

Note

This app is currently released as a beta version.

About App

HUMAN specializes in preemptive fraud detection and prevention by analyzing internet activity, verifying human interactions, and leveraging a HUMAN Security's network effect to protect users collectively.

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

Action Name

Description

Get Allow Lists 

This action returns the list of allowed actions for respective pairs of app IDs and host domains.

Get Deny Lists 

This action returns lists of blocked actions for respective pairs of app IDs and host domains.

Get Incidents 

This action returns lists of incidents detected for the respective pair of the app ID and host domain.

Get Scripts 

This action returns lists of scripts for the respective pair of the app ID and host domain.

Generic Action

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

Configuration Parameters

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

Parameter

Description

Field Type

Required/Optional

Comments

API Key 

Enter the API key for the HUMAN server.

Password

Required

API Version 

Enter the version of the HUMAN server.

Text

Optional

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

Timeout 

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

Integer

Optional

Allowed values:

15-120

Default value:

30

Action: Get Allow Lists

This action returns the list of allowed actions for respective pairs of app IDs and host domains.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

App ID 

Enter the app ID to get the allow list details.

Example:

sampledomain.com

List

Required

Start Time 

Enter the start time in milliseconds to get the allow list details.

Text

Optional

The time should be in Unix format, representing the number of milliseconds elapsed since midnight of January 1, 1970.

Default value:

Past 24 hours

End Time 

Enter the end time in milliseconds to get the allow list details.

Text

Optional

The time should be in Unix format, representing the number of milliseconds elapsed since midnight of January 1, 1970.

Default value:

Current time

Skip 

Enter the skip value to get the allow list details. This is the number of actions to skip when returning the results.

Integer

Optional

Default value:

0

Take 

Enter the take value to get the allow list details. This is the number of actions to return when returning the results.

Integer

Optional

Default value:

20

Action: Get Deny Lists

This action returns lists of blocked actions for respective pairs of app IDs and host domains.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

App ID 

Enter the app ID to get the deny list details.

Example:

sampledomain.com

List

Required

Start Time 

Enter the start time in milliseconds to get the deny list details. 

Text

Optional

The time should be in Unix format, representing the number of milliseconds elapsed since midnight of January 1, 1970.

Default value:

Past 24 hours

End Time 

Enter the end time in milliseconds to get the deny list details.

Text

Optional

The time should be in Unix format, representing the number of milliseconds elapsed since midnight of January 1, 1970.

Default value:

Current time

Skip 

Enter the skip value to get the deny list details. This is the number of actions to skip when returning the results.

Integer

Optional

Default value:

0

Take 

Enter the take value to get the deny list details. This is the number of actions to return when returning the results. 

Integer

Optional

Default value:

20

Action: Get Incidents

This action returns lists of incidents detected for the respective pair of the app ID and host domain.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

App ID 

Enter the app ID to get the incident details.

Example:

sampledomain.com

List

Required

TLD 

Enter the TLD to get the incident details.

Example:

hostdomain.com

List

Required

This is an array of host domains to filter the relevant incidents.

Start Time 

Enter the start time in milliseconds to get the incident details.

Text

Optional

The time should be in Unix format, representing the number of milliseconds elapsed since midnight of January 1, 1970.

Default value:

Past 24 hours.

End Time 

Enter the end time in milliseconds to get the incident details.

Text

Optional

The time should be in Unix format, representing the number of milliseconds elapsed since midnight of January 1, 1970.

Default value:

Current time

Skip 

Enter the skip value to get the incident details. This is the number of incidents to skip when returning the results.

Integer

Optional

Default value:

0

Take 

Enter the take value to get the incident details. This is the number of incidents to return when returning the results.

Integer

Optional

Default value:

20

Action: Get Scripts

This action returns lists of scripts for the respective pair of the app ID and host domain.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

App ID 

Enter the app ID to get the script details.

Example:

sampledomain.com

List

Required

TLD 

Enter the TLD to get the script details.

Example:

hostdomain.com

List

Required

This is an array of host domains to filter the relevant scripts.

Start Time 

Enter the start time in milliseconds to get the script details.

Text

Optional

The time should be in Unix format, representing the number of milliseconds elapsed since midnight of January 1, 1970.

Default value:

Past 24 hours

End Time 

Enter the end time in milliseconds to get the script details.

Text

Optional

The time should be in Unix format, representing the number of milliseconds elapsed since midnight of January 1, 1970.

Default value:

Current time

Skip 

Enter the skip value to get the script details. This is the number of scripts to skip when returning results.

Integer

Optional

Default value:

0

Take 

Enter the take value to get the script details. This is the number of scripts to return when returning results.

Integer

Optional

Default value:

20

Action: Generic Action

This is a generic action used to make requests to any HUMAN 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

  • POST

  • PUT

  • DELETE

Endpoint 

Enter the endpoint to make the request. 

Example: 

/v3.3/incidents

Text

Required

Query Params 

Enter the query parameters to pass to the API.

Key Value

Optional

Payload 

Enter the payload to pass to the API.

Any

Optional

Extra Fields 

Enter the extra fields to pass to the API.

Key Value

Optional