Skip to content

Commit

Permalink
feat: introduce additional signals
Browse files Browse the repository at this point in the history
  • Loading branch information
ilfa committed May 10, 2023
1 parent 971f3bf commit 4e5fc79
Show file tree
Hide file tree
Showing 74 changed files with 5,154 additions and 99 deletions.
28 changes: 27 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,6 @@ Class | Method | HTTP request | Description
## Documentation For Models

- [BotdDetectionResult](docs/BotdDetectionResult.md)
- [BotdError](docs/BotdError.md)
- [BotdResult](docs/BotdResult.md)
- [BrowserDetails](docs/BrowserDetails.md)
- [Confidence](docs/Confidence.md)
Expand All @@ -166,17 +165,44 @@ Class | Method | HTTP request | Description
- [IPLocation](docs/IPLocation.md)
- [IPLocationCity](docs/IPLocationCity.md)
- [IdentificationError](docs/IdentificationError.md)
- [IpBlockListResult](docs/IpBlockListResult.md)
- [IpBlockListResultDetails](docs/IpBlockListResultDetails.md)
- [IpInfoResult](docs/IpInfoResult.md)
- [IpInfoResultV4](docs/IpInfoResultV4.md)
- [IpInfoResultV6](docs/IpInfoResultV6.md)
- [Location](docs/Location.md)
- [ManyRequestsResponse](docs/ManyRequestsResponse.md)
- [ProductError](docs/ProductError.md)
- [ProductsResponse](docs/ProductsResponse.md)
- [ProductsResponseBotd](docs/ProductsResponseBotd.md)
- [ProductsResponseIdentification](docs/ProductsResponseIdentification.md)
- [ProductsResponseIdentificationData](docs/ProductsResponseIdentificationData.md)
- [Response](docs/Response.md)
- [ResponseVisits](docs/ResponseVisits.md)
- [SeenAt](docs/SeenAt.md)
- [SignalResponseEmulator](docs/SignalResponseEmulator.md)
- [SignalResponseEmulatorData](docs/SignalResponseEmulatorData.md)
- [SignalResponseIncognito](docs/SignalResponseIncognito.md)
- [SignalResponseIncognitoData](docs/SignalResponseIncognitoData.md)
- [SignalResponseIpBlocklist](docs/SignalResponseIpBlocklist.md)
- [SignalResponseIpInfo](docs/SignalResponseIpInfo.md)
- [SignalResponseProxy](docs/SignalResponseProxy.md)
- [SignalResponseProxyData](docs/SignalResponseProxyData.md)
- [SignalResponseRootApps](docs/SignalResponseRootApps.md)
- [SignalResponseRootAppsData](docs/SignalResponseRootAppsData.md)
- [SignalResponseTampering](docs/SignalResponseTampering.md)
- [SignalResponseTor](docs/SignalResponseTor.md)
- [SignalResponseTorData](docs/SignalResponseTorData.md)
- [SignalResponseVpn](docs/SignalResponseVpn.md)
- [Subdivision](docs/Subdivision.md)
- [TamperingResult](docs/TamperingResult.md)
- [Visit](docs/Visit.md)
- [VpnResult](docs/VpnResult.md)
- [VpnResultMethods](docs/VpnResultMethods.md)
- [WebhookSignalResponseEmulator](docs/WebhookSignalResponseEmulator.md)
- [WebhookSignalResponseProxy](docs/WebhookSignalResponseProxy.md)
- [WebhookSignalResponseRootApps](docs/WebhookSignalResponseRootApps.md)
- [WebhookSignalResponseTor](docs/WebhookSignalResponseTor.md)
- [WebhookVisit](docs/WebhookVisit.md)

## Documentation For Authorization
Expand Down
1 change: 1 addition & 0 deletions docs/BotdDetectionResult.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **str** | Bot detection result: * `notDetected` - the visitor is not a bot * `good` - good bot detected, such as Google bot, Baidu Spider, AlexaBot and so on * `bad` - bad bot detected, such as Selenium, Puppeteer, Playwright, headless browsers, and so on |
**type** | **str** | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

2 changes: 2 additions & 0 deletions docs/BotdResult.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ Name | Type | Description | Notes
**ip** | **str** | IP address of the requesting browser or bot. |
**time** | **datetime** | Time in UTC when the request from the JS agent was made. We recommend to treat requests that are older than 2 minutes as malicious. Otherwise, request replay attacks are possible |
**url** | **str** | Page URL from which identification request was sent. |
**user_agent** | **str** | | [optional]
**request_id** | **str** | | [optional]
**bot** | [**BotdDetectionResult**](BotdDetectionResult.md) | |

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
Expand Down
10 changes: 10 additions & 0 deletions docs/IpBlockListResult.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# IpBlockListResult

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | `true` if request IP address is part of any database that we use to search for known malicious actors, `false` otherwise. | [optional]
**details** | [**IpBlockListResultDetails**](IpBlockListResultDetails.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/IpBlockListResultDetails.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# IpBlockListResultDetails

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**email_spam** | **bool** | IP address was part of a known email spam attack (SMTP). | [optional]
**attack_source** | **bool** | IP address was part of a known network attack (SSH/HTTPS). | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/IpInfoResult.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# IpInfoResult

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**v4** | [**IpInfoResultV4**](IpInfoResultV4.md) | | [optional]
**v6** | [**IpInfoResultV6**](IpInfoResultV6.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/IpInfoResultV4.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# IpInfoResultV4

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**address** | **str** | | [optional]
**geolocation** | [**IPLocation**](IPLocation.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/IpInfoResultV6.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# IpInfoResultV6

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**address** | **str** | | [optional]
**geolocation** | [**IPLocation**](IPLocation.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

2 changes: 1 addition & 1 deletion docs/BotdError.md → docs/ProductError.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# BotdError
# ProductError

## Properties
Name | Type | Description | Notes
Expand Down
9 changes: 9 additions & 0 deletions docs/ProductsResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,15 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**identification** | [**ProductsResponseIdentification**](ProductsResponseIdentification.md) | | [optional]
**botd** | [**ProductsResponseBotd**](ProductsResponseBotd.md) | | [optional]
**ip_info** | [**SignalResponseIpInfo**](SignalResponseIpInfo.md) | | [optional]
**incognito** | [**SignalResponseIncognito**](SignalResponseIncognito.md) | | [optional]
**root_apps** | [**SignalResponseRootApps**](SignalResponseRootApps.md) | | [optional]
**emulator** | [**SignalResponseEmulator**](SignalResponseEmulator.md) | | [optional]
**ip_blocklist** | [**SignalResponseIpBlocklist**](SignalResponseIpBlocklist.md) | | [optional]
**tor** | [**SignalResponseTor**](SignalResponseTor.md) | | [optional]
**vpn** | [**SignalResponseVpn**](SignalResponseVpn.md) | | [optional]
**proxy** | [**SignalResponseProxy**](SignalResponseProxy.md) | | [optional]
**tampering** | [**SignalResponseTampering**](SignalResponseTampering.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

2 changes: 1 addition & 1 deletion docs/ProductsResponseBotd.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**BotdResult**](BotdResult.md) | | [optional]
**error** | [**BotdError**](BotdError.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseEmulator.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseEmulator

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**SignalResponseEmulatorData**](SignalResponseEmulatorData.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/SignalResponseEmulatorData.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# SignalResponseEmulatorData

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | Android specific emulator detection. There are 2 values: • `true` - Emulated environment detected (e.g. launch inside of AVD) • `false` - No signs of emulated environment detected Available only for events from Android client. The field will not be present for a browser or iOS event. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseIncognito.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseIncognito

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**SignalResponseIncognitoData**](SignalResponseIncognitoData.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/SignalResponseIncognitoData.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# SignalResponseIncognitoData

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | `true` if we detected incognito mode used in the browser, `false` otherwise. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseIpBlocklist.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseIpBlocklist

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**IpBlockListResult**](IpBlockListResult.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseIpInfo.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseIpInfo

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**IpInfoResult**](IpInfoResult.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseProxy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseProxy

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**SignalResponseProxyData**](SignalResponseProxyData.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/SignalResponseProxyData.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# SignalResponseProxyData

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | `true` if the request IP address is used by a public proxy provider, `false` otherwise. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseRootApps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseRootApps

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**SignalResponseRootAppsData**](SignalResponseRootAppsData.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/SignalResponseRootAppsData.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# SignalResponseRootAppsData

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | Android specific root management apps detection. There are 2 values: • `true` - Root Management Apps detected (e.g. Magisk) • `false` - No Root Management Apps detected Available only for events from Android client. The field will not be present for a browser or iOS event. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseTampering.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseTampering

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**TamperingResult**](TamperingResult.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseTor.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseTor

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**SignalResponseTorData**](SignalResponseTorData.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/SignalResponseTorData.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# SignalResponseTorData

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | `true` if the request IP address is a known tor exit node, `false` otherwise. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/SignalResponseVpn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# SignalResponseVpn

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**data** | [**VpnResult**](VpnResult.md) | | [optional]
**error** | [**ProductError**](ProductError.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/TamperingResult.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# TamperingResult

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | Flag indicating whether browser tampering was detected according to our internal thresholds. | [optional]
**anomaly_score** | **float** | Confidence score (`0.0 - 1.0`) for the tampering detection. Values above `0.5` suggest that we're reasonably sure there was a tampering attempt. Values below `0.5` are genuine browsers. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/VpnResult.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# VpnResult

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | VPN or other anonymising service has been used when sending the request. | [optional]
**methods** | [**VpnResultMethods**](VpnResultMethods.md) | | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

10 changes: 10 additions & 0 deletions docs/VpnResultMethods.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# VpnResultMethods

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**timezone_mismatch** | **bool** | User's browser timezone doesn't match the timezone from which the request was originally made. | [optional]
**public_vpn** | **bool** | Request IP address is owned and used by a public VPN service provider. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/WebhookSignalResponseEmulator.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# WebhookSignalResponseEmulator

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | Android specific emulator detection. There are 2 values: • `true` - Emulated environment detected (e.g. launch inside of AVD) • `false` - No signs of emulated environment detected Available only for events from Android client. The field will not be present for a browser or iOS event. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/WebhookSignalResponseProxy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# WebhookSignalResponseProxy

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | `true` if the request IP address is used by a public proxy provider, `false` otherwise. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/WebhookSignalResponseRootApps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# WebhookSignalResponseRootApps

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | Android specific root management apps detection. There are 2 values: • `true` - Root Management Apps detected (e.g. Magisk) • `false` - No Root Management Apps detected Available only for events from Android client. The field will not be present for a browser or iOS event. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

9 changes: 9 additions & 0 deletions docs/WebhookSignalResponseTor.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# WebhookSignalResponseTor

## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**result** | **bool** | `true` if the request IP address is a known tor exit node, `false` otherwise. | [optional]

[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

Loading

0 comments on commit 4e5fc79

Please sign in to comment.