# Google SecOps

{% hint style="info" %}
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.
{% endhint %}

Dropzone integrates with [Google SecOps](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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-b3f07f902b1402dadc7abbd8bb62f9c204547390%2Fui-integrations-dropdown.png?alt=media" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Available"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-434641ec6d4e45051842f86164f485d6bd289424%2Fapp_system_integrations_available.png?alt=media" alt=""><figcaption><p>Click Available</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-8f322c5288f9ef7ee91492cdc1b418fae3e226a1%2Fapp_system_integrations_available_gso.png?alt=media" alt=""><figcaption><p>The Google SecOps Tile</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-fdfe86d3bd1ac5abccd6f60224b0da7ef5f26a5c%2Fapp_system_integrations_available_service_account.png?alt=media" alt="" width="320"><figcaption><p>Copy the service account email</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-02f3778b00ff52057eb669c8aefee933faa7a025%2Fgoogle-secops-1.png?alt=media" alt=""><figcaption><p>Open the navigation menu</p></figcaption></figure>

* Navigate to IAM & Admin > IAM

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-d69e5254147d19920a9cec1e18547f0ca14ffc81%2Fgoogle-secops-2.png?alt=media" alt=""><figcaption><p>Navigate to IAM</p></figcaption></figure>

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

{% hint style="info" %}
To be able to complete this step, you will need the `resourcemanager.projects.setIamPolicy` permission.
{% endhint %}

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-1aa341d94df73f922f035909397f096613a7da05%2Fgoogle-secops-3.png?alt=media" alt=""><figcaption><p>Click "Grant Access"</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-ad7e9e94dd0b1d04258c3923a0ef8471ecc2fa4b%2Fgoogle-secops-4.png?alt=media" alt=""><figcaption><p>Input the email address from the Dropzone UI Service Account Email</p></figcaption></figure>

* Click "Select a role"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-5624b6aed8ac912ef11c862456e417823efbec8a%2Fgoogle-secops-5.png?alt=media" alt=""><figcaption><p>Click "Select a role"</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-fe7c0657afca53324d9a650e7b97f3a83671f911%2Fgoogle-secops-6.png?alt=media" alt=""><figcaption><p>Assign the Chronicle API Viewer role</p></figcaption></figure>

* Click "Save"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-1a56fe6e04feaac1202553acbee1084398fd2774%2Fgoogle-secops-7.png?alt=media" alt=""><figcaption><p>Click "Save"</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-02f3778b00ff52057eb669c8aefee933faa7a025%2Fgoogle-secops-1.png?alt=media" alt=""><figcaption><p>Open the navigation menu</p></figcaption></figure>

* Navigate to Security > Detection and Controls > Google SecOps

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-7b0b53cd11cb4eeaa4414d028a578f80e3790405%2Fgoogle-secops-9.png?alt=media" alt=""><figcaption><p>Navigate to Google SecOps</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-dac396656c77f0feefaea901fabe5834bdcaddc0%2Fgoogle-secops-8.png?alt=media" alt=""><figcaption><p>Reveal the Instance Details</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-af5d2bd56bedb290c73e9e11ab14b40698108578%2Fgoogle-secops-10.png?alt=media" alt=""><figcaption><p>Copy the Instance Name</p></figcaption></figure>

To obtain your Project ID, do the following:

* In the upper left, click on the project icon

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-afe3f77ca7c7e44f502a3037f1d61b58444116b8%2Fgoogle-secops-11.png?alt=media" alt=""><figcaption><p>Click the project icon</p></figcaption></figure>

* 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"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-777619f8eeb58bbc9f82a2dc2ca0e99a8517bc3d%2Fgoogle-secops-12.png?alt=media" alt=""><figcaption><p>Copy the Project ID</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-28477d4e45878d98ffbc51e4fff73c169313c980%2Fgoogle-secops-13.png?alt=media" alt=""><figcaption><p>Navigate to SOAR Settings</p></figcaption></figure>

* Navigate to Advanced > API Keys

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-c817bc7034e746a137eebc6c99352eb1366c0b6b%2Fgoogle-secops-14.png?alt=media" alt=""><figcaption><p>Navigate to API Keys</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-80bed61a79042d2263719adf271261d99db369e1%2Fgoogle-secops-15.png?alt=media" alt=""><figcaption><p>Add API Key</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-8ffe3a368572ef287276c0e70472b8ed184b26de%2Fgoogle-secops-16.png?alt=media" alt=""><figcaption><p>Select Managed User</p></figcaption></figure>

* 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"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-e2bad83d92ee13eb1b00b1b8dfe9b89ba7760e58%2Fgoogle-secops-17.png?alt=media" alt=""><figcaption><p>Copy the API Key</p></figcaption></figure>

* Click "Yes"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-b385a2d1ea73fd4ba84960c3746e07466f7165b5%2Fgoogle-secops-18.png?alt=media" alt=""><figcaption><p>Copy the API Key</p></figcaption></figure>

To obtain your SOAR Instance Hostname, do the following:

* In the left sidebar, navigate to Ingestion > Webhook

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-73219eb09c8b2db33950e2c3c07cc39099569eca%2Fgoogle-secops-19.png?alt=media" alt=""><figcaption><p>Navigate to Webhook</p></figcaption></figure>

* Click the `+` icon

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-e7c57e68ee0dc7ca3070410d212619b3c80eed9b%2Fgoogle-secops-20.png?alt=media" alt=""><figcaption><p>Add new Webhook</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-70b1eff53f40812f6fbee98b085fc25b6e4221c4%2Fgoogle-secops-21.png?alt=media" alt=""><figcaption><p>Click Save</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-07a86dbc816212ee700176bcffd923afd196f325%2Fgoogle-secops-22.png?alt=media" alt=""><figcaption><p>Copy the SOAR Instance Hostname</p></figcaption></figure>

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

{% hint style="info" %}
The SOAR API Key and SOAR Instance Hostname are only necessary if you wish to enable Dropzone to investigate [cases](https://cloud.google.com/chronicle/docs/soar/investigate/working-with-cases/cases-overview).
{% endhint %}

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-b3f07f902b1402dadc7abbd8bb62f9c204547390%2Fui-integrations-dropdown.png?alt=media" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Available"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-434641ec6d4e45051842f86164f485d6bd289424%2Fapp_system_integrations_available.png?alt=media" alt=""><figcaption><p>Click Available</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-8f322c5288f9ef7ee91492cdc1b418fae3e226a1%2Fapp_system_integrations_available_gso.png?alt=media" alt=""><figcaption><p>The Google SecOps Tile</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-54747b0abb600dc56b54d61a02312e63b07b63f8%2Fapp_system_integrations_available_gso_alert_config-1.png?alt=media" alt=""><figcaption><p>The Google SecOps Alert Source Configuration (pt 1)</p></figcaption></figure>

* 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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-7f4c5dff1208a4fbdb9b9a6938ecc96aff2f948d%2Fapp_system_integrations_available_gso_alert_config-2.png?alt=media" alt=""><figcaption><p>The Google SecOps Alert Source Configuration (pt 2)</p></figcaption></figure>

* 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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-3f8c119053e25795230dcf441bf7f2774130dd16%2Fapp_system_integrations_available_gso_alert_config-3.png?alt=media" alt=""><figcaption><p>The Google SecOps Alert Source Configuration (pt 3)</p></figcaption></figure>

* 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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-e14bd7ae3f883b55aa06083351b2c69e07734d3d%2Fapp_system_integrations_available_gso_alert_config-5.png?alt=media" alt=""><figcaption><p>The Google SecOps Alert Source Configuration (pt 5)</p></figcaption></figure>

* 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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-669823467d0b4325c6b82ebe8ef7dc88cc88fa00%2Fapp_system_integrations_available_gso_alert_config-6.png?alt=media" alt=""><figcaption><p>The Google SecOps Alert Source Configuration (pt 6)</p></figcaption></figure>

* Input your desired Poll interval and lookback
* Click "Test & Save" to finish

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-dde71b8db0aa7c445cc84eceedb74bc92ad7ad9d%2Fapp_system_integrations_available_gso_config_alert_7.png?alt=media" alt=""><figcaption><p>Click "Test &#x26; Save" to finish</p></figcaption></figure>

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