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

# Gem

Dropzone AI integrates with Gem, an SIEM focusing on Cloud Detection and Response (CDR) that provides real-time, packet-level visibility across hybrid and multi-cloud environments.

## Create an API Key

Dropzone requires a Gem Client ID and Client Secret.

To obtain these, follow the instructions available on Gem's [documentation site](https://docs.wiz.io/) for creating a Client ID and Client Secret.

## Enable Gem

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 left side bar, navigate to Platform Settings > Integrations

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FQKQGU2YK0KqsewZWvh0i%2Fui-integrations-dropdown.png?alt=media" 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="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fx4O3FuRG5IqPwx5sFuHr%2Fapp_system_integrations_library.png?alt=media" alt=""><figcaption><p>Click Library</p></figcaption></figure>

* In the Search bar, search Gem, then click "Configure"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FgjqHC4I9J7d11HWKz7HO%2Fapp_system_integrations_available_Gem.png?alt=media" alt=""><figcaption><p>The Gem Alert Tile</p></figcaption></figure>

* Input your Gem server domain (e.g. *app.gem.security*, *eu-west-1.app.gem.security*)
* Input the Client ID and Client Secret you created earlier

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FzzBvhT41EQIWl1bylaVp%2Fapp_system_integrations_available_Gem_config.png?alt=media" alt=""><figcaption><p>The Gem Alert Source Configuration (pt 1)</p></figcaption></figure>

* Input your desired poll interval and lookback
* Click "Comment Investigation Results to ticket" if you want Dropzone to push investigation results back to Gem

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fl8hTEItQVWF9ubah8YUt%2Fapp_system_integrations_available_Gem_config-1.png?alt=media" alt=""><figcaption><p>The Gem Alert Source Configuration (pt 2)</p></figcaption></figure>

* 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 our Customer Success team for more information about this feature

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FI56AMieT91vHIswUkCuf%2Fadvanced-filtering-test-save.png?alt=media" alt=""><figcaption><p>The Gem Alert Source Configuration (pt 3)</p></figcaption></figure>

* Click "Test & Save"

If you have any errors or questions, contact our Customer Success team.
