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

# iboss

Dropzone AI integrates with [iboss](https://www.iboss.com), a cloud-native Zero Trust networks access layer. Integrating with iboss allows Dropzone to use your organizational data from the platform to inform and enrich its investigations.

### Integration Overview

Dropzone supports two methods of authentication for this integration: Username/Password and API Key.

To enable these integrations you will perform the following actions:

* Create a dedicated API User with the necessary permissions
* Obtain an API Key
* Locate your API roots
* Enable the Data source in your Dropzone tenant

{% hint style="info" %}
Dropzone requires read access to the `Reporting/Event Logs`, `Cloud/Account Settings`, and `SWG URL Lookup Control` APIs. To preserve the principle of least privilege, we recommend creating a dedicated iboss user with only the necessary permissions.

If you choose to use an account that already has the needed access, you can skip to the "Obtain an API Key" section.
{% endhint %}

### Create an iboss User

To create a dedicated iboss user, do the following:

* Log in to your iboss Web console
* In the upper left, click "Home"

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

* Navigate to System Administrators > Role-Based Access Control

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

* Click "+ Add Custom RBAC Group"

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

* Name the role something memorable, such as "Dropzone AI"
* Enable the following APIs:
  * Reporting/Event Logs - Read Only
  * Cloud/Account Settings - Read Only
  * SWG URL Lookup Control - Read Only
* Click "Add RBAC Group"
* Navigate back to System Administrators
* In the System Administrators section, click "Add New System Administrator"

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

* Enter an email address for the system administrator

{% hint style="info" %}
Make sure that MFA is disabled for the user account used by this integration. You may wish to create a unique email address dedicated to this purpose.
{% endhint %}

* Name the administrator something memorable, such as "Dropzone AI"

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

* Click "Add New System Administrator"
* Check the email address for the account you created. You should receive an email confirming the role you've created and requesting a password for the role
* Save the email address and the password you create for use later in the Dropzone UI where they are called "Username" and "Password" respectively

### Create an API Key

As the dedicated user you just created, follow steps [here](https://documenter.getpostman.com/view/26524233/2s93RUuXjk#6b13c3b3-9072-47fa-ad0a-111ccc777b2c) to create an API key. Copy the key value for use later in the Dropzone UI.

## Enable iboss

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

| Dropzone Field   | Source                                                                              |
| ---------------- | ----------------------------------------------------------------------------------- |
| Account API Root | The iboss Account API root used to obtain a session token                           |
| Cloud API Root   | The iboss Cloud API root used for the Reporting APIs (Event Logs)                   |
| Core API Root    | The iboss Core API root used to discover the account's gateway node for URL lookups |
| Username         | The email address you used earlier                                                  |
| Password         | The Password value you used earlier                                                 |
| API Key          | The API Key value you generated earlier                                             |

{% hint style="info" %}
Unless your iboss tenant is on iboss GovCloud or a region-specific instance, you may leave the API Roots as the default.
{% endhint %}

* 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://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 iboss, then click "Configure"

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

* Input your API Roots

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

* Select your authentication method, then input either your Username and Password or the API Key
* Click "Test & Save" to finish

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

If you have any errors contact our Customer Success team.
