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

# SentinelOne

Dropzone AI integrates with SentinelOne, an endpoint cybersecurity platform that protects against various types of threats. Integrating SentinelOne with Dropzone allows Dropzone to automatically investigate security incidents in your SentinelOne environment.

## Create a Service User and API Key

SentinelOne requires an API key from a Service User with Viewer Access to enable.

To obtain an API Key, do the following:

* Log in to the SentinelOne Management Console
* In the left navigation bar of the SentinelOne dashboard, click "Settings"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FIgh3C22F1xSh4YOdXXdT%2Fsentinelone-api-1.png?alt=media" alt=""><figcaption><p>Settings</p></figcaption></figure>

* Navigate to Users > Service Users
* Click the Actions dropdown, then click "Create New Service User"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2F6ubFxDe2TCp8xHSHBr4E%2Fsentinelone-api-2.png?alt=media" alt=""><figcaption><p>Create New Service User</p></figcaption></figure>

* Enter the Name, Description, and Expiration Date, then click "Next"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FAREaTVz9CJiTmHv3q4xz%2Fsentinelone-api-3.png?alt=media" alt=""><figcaption><p>Enter information</p></figcaption></figure>

* Under Access Level, select "Account." Select the newly generated account and set the role to Viewer

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FkKVSwAPESAv8vZhRGyVi%2Fsentinelone-api-4.png?alt=media" alt=""><figcaption><p>Assign roles to the new Account</p></figcaption></figure>

* Click "Create User"
* Copy the API Token shown for use later in the Dropzone UI where it is called "API Token"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FvYpRAoFS07SX9bayUXRm%2Fsentinelone-api-5.png?alt=media" alt=""><figcaption><p>Copy API Token</p></figcaption></figure>

## Enable SentinelOne

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

| Dropzone Field       | Source                                                    |
| -------------------- | --------------------------------------------------------- |
| SentinelOne Hostname | Your SentinelOne Hostname, e.g. usea1-123.sentinelone.net |
| API Token            | The API token 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 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 SentinelOne, then click "Configure"

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

* Under the Alert Source header, input your SentinelOne hostname and API Token
* If you don't want Dropzone to use the [XDR API](https://www.sentinelone.com/platform/singularity-xdr-protection/?utm_source=https%3A%2F%2Fwww.google.com%2F\&utm_medium=organic-search), uncheck the box labeled "Enable XDR API"
* Otherwise, input your SentinelOne XDR hostname

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

* If you wish to treat each of your sites in SentinelOne as separate tenants, check the box labeled "Multi-tenant environment" and click "Add Item." Then input the site IDs for each of the sites you want Dropzone to be able to analyze

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

* Under "Incident types," check the incident types you want Dropzone to investigate alerts for
* Under "Incident status," check the incident statuses you want Dropzone to investigate alerts for

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

* Under "Alert Severity," check the severity levels you want Dropzone to investigate alerts for
* Input your desired log ingestion delay

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

* If you wish, you may filter threats from investigation by title. To do so, click "Add Item" in the "Title Filtering" section and input your exclusions
* Under "Title Filter Mode," select whether to include or exclude the incidents matching the patterns

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

* Input your desired poll interval and lookback

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FHVBJ98XYaCSKhc4Ujvy0%2Fpoll-interval-lookback.png?alt=media" alt=""><figcaption><p>The SentinelOne Alert Source Configuration (pt 6)</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 SentinelOne Alert Source Configuration (pt 6)</p></figcaption></figure>

* Click "Test & Save" to finish

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