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/alert/googlesecops_alert.md).

# Google Security Operations

Google SecOps is an SIEM integration. SIEM integrations are used to perform analysis of any SIEM generated alerts, and/or to use generated data as part of investigation analysis. They are optional, but enabling more integrations enhances Dropzone analysis.

Dropzone integrates with [Google Security Operations](https://cloud.google.com/security/products/security-operations) to investigate different security alerts across many of Google's security products.

## Integration Overview

To enable these integrations you will perform the following actions:

* Identify your service account address
* Grant IAM access to the Dropzone service account
* Obtain your Google Account Details
* Enable the Alert and Data sources

## 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

* Click "Available"

* In the Search bar, search Google Security Operations, then click "Configure"

* Copy the "SERVICE ACCOUNT EMAIL" field for use in the Google Console interface

## Grant IAM Access to Dropzone AI

* Navigate to the Google Console page of the project your SecOps instance is in
* In the upper left hand corner, open the navigation menu

* Navigate to IAM & Admin > IAM

* Under "View by principals," click "Grant Access"

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

* Click "Select a role"

* Search the "Chronicle API Viewer" role, then click it

* Click "Save"

## Obtain Account Details

To obtain your Instance Name, do the following:

* Return to the Google Console page of the project your SecOps instance is in
* In the upper left hand corner, open the navigation menu

* Navigate to Security > Detection and Controls > Google SecOps

* In the Google SecOps page, click the carrot next to "Instance Details"

* Copy the Customer ID shown for use later in the Dropzone UI where it is called "Instance Name"

To obtain your Project ID, do the following:

* In the upper left, click on the project icon

* Using the search bar, locate the project your SecOps instance is in
* Under "ID," copy the ID value shown for use later in the Dropzone UI where it is called "Project ID"

## SOAR Details

If you want Dropzone to be able to investigate [cases](https://cloud.google.com/chronicle/docs/soar/investigate/working-with-cases/cases-overview), you will need to generate a SOAR API Key and locate your SOAR Instance Hostname.

To generate your SOAR API Key, do the following:

* As an admin, log into your Google SecOps instance
* In the left sidebar, navigate to Settings > SOAR Settings

* Navigate to Advanced > API Keys

* In the upper right corner, click the `+` icon

* Name the API Key something memorable, such as Dropzone AI
* Next to "Permission Group," assign the API Key the Managed User permission

* In the SOC Role section, select your desired [SOC role](https://cloud.google.com/chronicle/docs/soar/admin-tasks/advanced/control-access-to-platform)
* Copy the API Key, then click "Save"

* Click "Yes"

To obtain your SOAR Instance Hostname, do the following:

* In the left sidebar, navigate to Ingestion > Webhook

* Click the `+` icon

* Name the Webhook something memorable, such as Dropzone AI
* Click "Save"

* Next to "Webhook URL," copy the SOAR Instance Hostname, eg https://*my-hostname*/v1alpha/projects

## Enable Google SecOps

To enable the Alert Source integration, you will need the following information:

| Dropzone Field         | Source                                                |
| ---------------------- | ----------------------------------------------------- |
| Instance Name          | The "Customer ID" value you copied earlier            |
| Project ID             | The "Project ID" value you copied earlier             |
| SOAR API Key           | The "SOAR API Key" value you copied earlier           |
| SOAR Instance Hostname | The "SOAR Instance Hostname" value you copied earlier |

To enable the Alert 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

* Click "Available"

* In the Search bar, search Google Security Operations, then click "Configure"

* Under the Alert Source heading, input the Instance Name and Project ID

* To enable Dropzone to investigate [alerts](https://cloud.google.com/chronicle/docs/investigation/investigate-alert), check the box labeled "Enable alerts." If you wish to enable Dropzone to filter by priority, check the box labeled "Enable priority filtering," then check the priority levels you wish for Dropzone to ingest.

* To enable Dropzone to investigate [cases](https://cloud.google.com/chronicle/docs/soar/investigate/working-with-cases/cases-overview), check the box labeled "Enable cases"
* Input your SOAR API Key and SOAR Instance Hostname
* Check the box labeled "Include Closed Cases" to include closed cases in Dropzone investigations

* If you wish to only include certain [stages](https://cloud.google.com/chronicle/docs/soar/investigate/working-with-cases/what-actions-can-you-take-on-a-case) in Dropzone investigation, check the box labeled "Enabled stage filtering," then check the stages you wish for Dropzone to ingest.

* If you wish to enable priority filtering, check the box labeled "Enable priority filtering," then check the priority levels you wish for Dropzone to ingest.

* If you wish to enable filtering by case [title](https://docs.cloud.google.com/chronicle/docs/soar/investigate/working-with-cases/whats-on-the-cases-screen#:~:text=Case%20queue%20header%3F-,Case,-top%20bar%20%2D%20left), check the box labeled "Enable case title filtering," then click "Add Item"
* Input case titles individually by clicking "Add Item" for each one
* Under "Filter Mode," select whether to include or exclude the cases matching the filters.

* If you wish to enrich Dropzone investigation with [CrowdStrike Recon](https://www.youtube.com/watch?v=0PjOLMuLIrA) information, check the box labeled "Enable case enrichment options," then check the box labeled "Fetch Crowdstrike Recon notifications"

* Input your desired Poll interval and lookback.

* If you wish to further filter alerts using the Python [CEL](https://python-common-expression-language.readthedocs.io/en/stable/tutorials/cel-language-basics/) package, check the box labeled "Use advanced filtering"
* Input your CEL expression, then select whether to include or exclude alerts matching that filter. Add each filter individually using the "Add Item" button.
* Contact your Dropzone AI support representative for more information about this feature.

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