> 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/data/swimlane-ti.md).

# Swimlane Threat Intelligence

Dropzone AI integrates with [Swimlane Turbine](https://swimlane.com/swimlane-turbine/), an AI automation security platform. Integrating Swimlane with Dropzone allows Dropzone to access Swimlane's threat intelligence, automatically respond to security incidents, and enrich investigation and incident response.

## Integration Overview

To enable these integrations you will perform the following actions:

* Configure your role-based access (or create a designated Dropzone user)
* Obtain a Personal Access Token
* Enable the Data source within your Dropzone tenant

## Role Based Access Control - Create a Dropzone User

Swimlane Turbine uses [Role-Based Access Control](https://docs.swimlane.com/90kk-role-based-access-control-rbac). You will need access to a user with read access permissions to the [application](https://docs.swimlane.com/applications-applets) and all [fields](https://docs.swimlane.com/select-fields-and-assign-field-properties) within the application you want Dropzone to have access to. See [here](https://docs.swimlane.com/application-permissions) for more information.

Alternatively, you may create a designated Dropzone user by doing the following:

* As an administrator, open the admin panel, then select "Users"

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

* Click "+ Add User"

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

* Name the user something memorable, such as "DropzoneAI"
* Enter the first name, last name, username, display name, and email

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FA33MtZ8frQf87bGYQKjB%2Fswimlaneti-3.png?alt=media" alt=""><figcaption><p>Configure the new user</p></figcaption></figure>

* In the Password tab, input a password or have one be autogenerated upon creation
* Record the username and password for use later in the Dropzone UI where they will be called "username" and "password," respectively

{% hint style="info" %}
If you plan to create a personal access token, you may skip this step.
{% endhint %}

* Exempt the Dropzone user from forced SSO
* In the Groups & Roles tab, assign the user read permissions into the tenants you want Dropzone to have access to
* Click "Save"

See Swimlane's [User Management documentation](https://docs.swimlane.com/users) for more information.

## Obtain Personal Access Token

To obtain a Personal Access Token, do the following:

* As an administrator, open the admin panel, then select "Users"

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

* Locate the new Dropzone user (or a user you want Dropzone to use for access) and click them
* In the personal access token tab, click "Generate Token"
* Copy the token shown for use later in the Dropzone UI, where it is called "Personal Access Token"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2F2UNXvOivgRXDvmXgdVLV%2Fswimlaneti-4.png?alt=media" alt=""><figcaption><p>Copy the personal access token</p></figcaption></figure>

## Enable SentinelOne

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

| Dropzone Field                                                                                 | Source                                                                                                                                                                                    |
| ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Swimlane Host URL                                                                              | Your Swimlane Host name, e.g. <https://swimlane.example.gov>                                                                                                                              |
| Personal Access Token                                                                          | The Access token value you copied earlier                                                                                                                                                 |
| Username/Password                                                                              | Your username/password, used in place of a Personal Access token                                                                                                                          |
| TI App name                                                                                    | The name of the Swimlane [application](https://docs.swimlane.com/applications-applets) you want Dropzone to access                                                                        |
| IOC [Field Name](https://docs.swimlane.com/select-fields-and-assign-field-properties)          | The display name of the field in the application that contains the indicators of compromise (e.g. hashes, URLs, or IPs linked to the incident) you want Dropzone to use for investigation |
| IOC Subtype [Field Name](https://docs.swimlane.com/select-fields-and-assign-field-properties)  | The display name of the field that contains the machine-readable subtype used to route automation (e.g. ipv4\_public, sha256, domain)                                                     |
| IOC Category [Field Name](https://docs.swimlane.com/select-fields-and-assign-field-properties) | The display name of the field that holds the human-readable IOC category used to select enrichment sources (e.g. IP Address, FileHash, Domain)                                            |
| Status [Field Name](https://docs.swimlane.com/select-fields-and-assign-field-properties)       | The display name of the field that indicates when threat intelligence enrichment is complete, e.g. Analysis Complete                                                                      |

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 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 Swimlane Threat Intel, then click "Configure"

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

* Input the Swimlane Host URL, Personal Access Token (or Username/Password), and the TI App Name

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

* To guide Dropzone's threat intelligence enrichment, input the IOC Field Name, IOC Subtype Field Name, IOC Category Field Name, and Status Field Name
* Input the value of the status field when enrichment is complete, e.g `Yes`, `Complete`, or `Finished`

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

* Check the box labeled "Create Record if Not Found" to enable Dropzone to create a Swimlane [record](https://docs.swimlane.com/user-guide-10x/application-records) if it cannot locate the IOC in question. This will trigger Swimlane's automation to run [TI queries](https://docs.swimlane.com/turbine-user-guide/swimlane-intelligence-native-action)

{% hint style="info" %}
This feature is only available if the service account you're using has edit access to the application. Contact our Customer Success team for more information.
{% endhint %}

* Check the box labeled "Include IPv6 addresses" to allow Dropzone to use IPv6 IP indicators to enrich ingested data
* If your Swimlane application only tracks domains and not full URLs, check the box labeled "Look Up URLs by Domain Only"

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

* If you wish, you may exclude certain IOC values from ingestion. No lookups will be performed on these IOCs and no records will be created. To do so, input a Python regex of the IOC values you wish to skip, combining multiple patterns with '|'
* If you have a self-signed certificate, uncheck the box labeled "Verify SSL"

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

* Enter your desired poll timeout and poll interval
* Input the maximum number of [lookups](https://docs.swimlane.com/user-guide-10x/lookup-and-create-references-within-records) you want to run simultaneously

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

* Click "Test & Save" to finish

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