Google Safe Browsing
The Google Safe Browsing connector finds threat entries that match the Safe Browsing lists.
Prerequisites
This connector requires that you have an API key to https://safebrowsing.googleapis.com. Activate the key on the Google API page.
Capabilities
Use the Google Safe Browsing connector to retrieve a URL from the Google Safe Browsing lists.
Additional Documentation
Configurations
API Key Authentication
Authenticates using an API Key
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | A URL to the target host. | string | Required |
key | API key | string | Required |
verify_ssl | Verify SSL certificate | boolean | Optional |
http_proxy | A proxy to route requests through. | string | Optional |
Actions
Get URL Threat Match
Check a URL against the Google Safe Browsing API for any threat entries that match the Safe Browsing lists
Endpoint
- URL: /v4/threatMatches:find
- Method: POST
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
client | object | Optional | Client Information |
client.clientId | string | Optional | A client ID that (hopefully) uniquely identifies the client implementation of the Safe Browsing API. |
client.clientVersion | string | Optional | The version of the client implementation. |
threatInfo | object | Optional | Threat Information |
threatInfo.threatTypes | array | Optional | The threat types to be checked. |
threatInfo.platformTypes | array | Optional | The platform types to be checked. |
threatInfo.threatEntryTypes | array | Optional | The entry types to be checked. |
threatInfo.threatEntries | array | Required | The threat entries to be checked. |
threatInfo.threatEntries.hash | string | Optional | A hash prefix, consisting of the most significant 4-32 bytes of a SHA256 hash. This field is in binary format. For JSON requests, hashes are base64-encoded. A base64-encoded string. |
threatInfo.threatEntries.url | string | Optional | A URL. |
threatInfo.threatEntries.digest | string | Optional | The digest of an executable in SHA256 format. The API supports both binary and hex digests. For JSON requests, digests are base64-encoded. A base64-encoded string. |
Input Example
{"client":{"clientId":"mycompany","clientVersion":"0.1"},"threatInfo":{"threatTypes":["string"],"platformTypes":["string"],"threatEntryTypes":["string"],"threatEntries":[{"hash":"string","url":"https://example.com/api/resource","digest":"string"}]}}
Output
Parameter | Type | Description |
|---|---|---|
threat_type | string | Type of the resource |
Output Example
{"threat_type":"string"}
Response Headers
Header | Description | Example |
|---|---|---|
Content-Type | The media type of the resource | application/json |
Date | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |