> For the complete documentation index, see [llms.txt](https://docs.dropzone.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dropzone.ai/integrations/data/google-safe-browsing.md).

# Google Safe Browsing

{% hint style="info" %}
Google Safe Browsing is a Threat Intelligence (TI) integration. TI Data Source integrations are used during investigations to improve analysis and in interactive chat to help answer questions. They are optional, but enabling more tooling integrations enhances Dropzone analysis.
{% endhint %}

The Dropzone platform integrates with [Google Safe Browsing](https://developers.google.com/safe-browsing) to perform real-time checks on URLS and determine if there are any threats associated with them.

## Integrations Overview

To enable these integrations you will perform the following actions:

* Grant IAM access to your principal
* Create an API Key with the necessary permissions
* Enable the Data sources within your Dropzone tenant

## IAM access

To use Google Safe Browsing, you must have a Google Developer Console project. If you do not already have a project, see the [Google Cloud Platform documentation](https://docs.cloud.google.com/resource-manager/docs/creating-managing-projects?hl=en\&visit_id=639214647150194288-1565135454\&rd=1) for more information. You must also have the IAM access permissions to create and manage API keys within the project.

If you do not already have those permissions, see the (Google Cloud Platform documentation)\[<https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access>] for instructions on how to grant IAM access roles, or have an administrator perform the following steps:

* Go to the GCP cloud console at <https://console.cloud.google.com>

<figure><img src="/files/FWqwQeKiCrUfSf0ccFdl" alt=""><figcaption><p>Project Dropdown</p></figcaption></figure>

* Click the current project dropdown
* Click "All"
* Select the organization or folder you want Dropzone to access

<figure><img src="/files/SwuhoAMkeH6Zja3kYlNV" alt=""><figcaption><p>Resource Selection</p></figcaption></figure>

* From the left menu, navigate to IAM & Admin > IAM

<figure><img src="/files/1ccZLmrW4Ps825cHCDyM" alt=""><figcaption><p>IAM &#x26; Admin Menu</p></figcaption></figure>

* Under "View by principals," find the principal (e.g. your account) you want to be able to create an API key
* Click the Edit icon

<figure><img src="/files/5owdZC4uUmanl1tl9Eer" alt=""><figcaption></figcaption></figure>

* Click "Add another role"
* Add the following roles:

| Role Name                                                                                                                     | Purpose                                                                                        |
| ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| [API Keys Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/serviceusage#serviceusage.apiKeysAdmin)             | Allows the principal to create and manage API keys for a project                               |
| [Service Usage Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/serviceusage#serviceusage.serviceUsageViewer) | Allows the principal to restrict an API key to specific APIs by using the Google Cloud console |

<figure><img src="/files/PNwpZTnOlUnLtQYn7FDN" alt=""><figcaption><p>Add the requisite roles</p></figcaption></figure>

* Click "Save"

## Create an API Key

Google Safe Browsing requires an API key to enable.

To obtain an API Key, do the following:

* In the left sidebar of your [Google Cloud console](https://console.cloud.google.com), navigate to APIs & Services > Credentials

<figure><img src="/files/QU4E0GrUL5Nfqp9ZfrI5" alt=""><figcaption><p>The GCP sidebar</p></figcaption></figure>

* Click "Create Credentials," then select "API Key"

<figure><img src="/files/niLPiitJ2DHfqD8rP6QA" alt=""><figcaption></figcaption></figure>

* Name the key something memorable, such as "Dropzone AI"
* In the "Select API restrictions" dropdown, select "Safe Browsing API"

{% hint style="info" %}
If Safe Browsing is not available to select, this API may not be enabled in the Google Cloud project that you chose. To enable it, go to the [Safe Browsing](https://console.cloud.google.com/apis/library/safebrowsing.googleapis.com) page in the API Library of your Cloud Console. Click "Enable," then try again.
{% endhint %}

<figure><img src="/files/UlZzxbxuOD0N3zUCG1iQ" alt=""><figcaption></figcaption></figure>

* Click "Create"
* Record the key value shown for use later in the Dropzone UI where it is called "API key"

## Enable Google Safe Browsing

To enable the Data Source integration, do the following:

* Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app
* In the bottom left hand corner, click Settings > Integrations

<figure><img src="/files/zN02u3HObDaemUY8E1kD" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Library"

{% hint style="info" %}
If you have previously integrated this application, click "Configured"
{% endhint %}

<figure><img src="/files/QySQeLXXUC5SLjaXyamH" alt=""><figcaption><p>Click Library</p></figcaption></figure>

* In the Search bar, search ipinfo.io, then click "Configure"

<figure><img src="/files/Z6fjL28MU3Lc08mo0O28" alt=""><figcaption><p>The Google Safe Browsing Tile</p></figcaption></figure>

* Input the API key
* Click "Test & Save" to finish

<figure><img src="/files/dRuzIsJrX6ouga0U9gWd" alt=""><figcaption><p>The Google Safe Browsing configuration</p></figcaption></figure>

If you have any errors engage your Dropzone AI support representative.