Google GCP | Dropzone AI Documentation

Integration Overview

To enable these integrations you will perform the following actions:

• Determine which section of your GCP environment to enable Dropzone visibility
• Grant IAM access to the Dropzone service account
• Enable the Alert and Data sources

Determine Dropzone Visibilty Scope

Dropzone requires some IAM access to query your GCP environment.

You will later be granting the Dropzone service account access to a portion of your GCP environment, at either a folder level or for the whole organization.

For example, in the screenshot below, if you were to grant access via the production folder then Dropzone would have access to the Project FreezeRay project, and any other folders or projects you add to production in the future. However, it would not be available to alligator-apples. If you grant access via the top level org, example.net then it would apply to all folders and projects going forward.

Resource Selection

When enabling the integration you will be supplying the ID of the top level folder or organization, and Dropzone will recurse through all objects thereunder when making Data Source queries.

When you've chosen your folder or org, record the ID value for use later in the Dropzone UI where it is called "Parent Resource."

Identify your service account email address

To obtain the email address of your Dropzone service account, do the following:

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

Integrations Dropdown

• Click "Available"

Click Available

• In the Search bar, search GCP, then click "Configure"

The GCP Tile

• Record the "SERVICE ACCOUNT EMAIL" field for use in the GCP Console interface

SERVICE ACCOUNT EMAIL

Grant GCP Access to Dropzone Service Account

• Go to the GCP cloud console at https://console.cloud.google.com

Project Dropdown

• Click the current project dropdown
• Click "All"
• Select the organization or the folder you've chosen for Dropzone visibility

Resource Selection

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

IAM & Admin Menu

• Under "New principals," input the email address you copied earlier from the Dropzone UI "SERVICE ACCOUNT EMAIL"

Input the email address from the Dropzone UI Service Account Email

• Click "Select a role"

• Add the following roles:

• These roles should only be included if the top-level parent is an organization.
  Some of these roles are only necessary for the Alert Source integration. If you don't intend to perform that integration, you may ignore them.

• Continue adding roles via the "Add another role" button until complete

Add another role

• Click "Save"

Enable GCP

The Data source integration allows Dropzone AI to interact with your GCP environment to gather information for use in investigation analysis and interactive chat.

You'll need the following information:

• Dropzone Field: Source
• Parent Resource: The ID of the org or folder where you granted Dropzone access

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, navigate to Settings > Integrations

Integrations Dropdown

• Click "Available"

Click Available

• In the Search bar, search GCP, then click "Configure"

The GCP Tile

• Under the Data Source heading, input the "Parent Resource" ID
• Select the "Parent Resource Type" that matches the resource you've selected
• Select the "Default Zone." This is used for queries (such as finding VMs) when a zone is not specified

The GCP Data Source configuration

• Click "Test & Save" to finish

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