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

# Abnormal AI (Beta)

{% hint style="warning" %}
This integration is currently in Beta. It is not visible in the Dropzone UI until it has been explicitly enabled for your Dropzone instance. At this point in its development, any attempts to integrate with it will return a success, regardless of whether the information entered is accurate or not. For more information about our beta integrations, engage our Customer Success team.
{% endhint %}

Dropzone AI integrates with the [Abnormal AI](https://abnormal.ai/) security platform to detect the abnormal usage and behaviors of accounts, vendors, and applications associated with your organization.

## Create an API Key

Abnormal AI requires an API key to enable.

To obtain an API Key, do the following:

* Sign in to your [Abnormal Security portal](https://portal.abnormalsecurity.com/)
* Navigate to Settings > Integrations
* Scroll to the API Token Management section
* Click "+ Create New Token"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FHgQnH6w7FqrEC3hChkVe%2Fabnormalai-1.png?alt=media" alt=""><figcaption><p>The API Token Management section</p></figcaption></figure>

* Select "Rest API" as the integration type
* Click "Next"
* Select the "Tenant (Single Tenant)" token scope
* Select "Custom Access"
* Enable the following access levels:

| Scope              | Access Level         | Used By                   |
| ------------------ | -------------------- | ------------------------- |
| Abuse Campaigns    | Read, Read Sensitive | Alert Source              |
| Employees          | Read, Read Sensitive | Alert Source, Data Source |
| Messages           | Read, Read Sensitive | Alert Source, Data Source |
| Search and Respond | Read, Read Sensitive | Data Source               |
| Threats            | Read, Read Sensitive | Alert Source              |
| Vendors            | Read, Read Sensitive | Alert Source, Data Source |
| Cases              | Read, Read Sensitive | Alert Source              |

{% hint style="info" %}
Some of these scopes are only necessary for the Alert Source integration. If you don't intend to perform that integration, you may ignore them.

The Cases scope is only recommended if you have an [Account Takeover Protection](https://abnormal.ai/platform/account-takeover-protection) license.
{% endhint %}

* Name the token something memorable, such as Dropzone AI
* Select an expiry date

{% hint style="info" %}
Your Dropzone integration will stop working when the client secret expires. For convenience's sake, we recommend picking a longer expiration date, to limit the number of times the access token must be updated.

Consider setting a calendar reminder to update the key prior to expiration. If you wish to receive email notifications before your token expires, you may configure the API token expiry event type in the [Abnormal Portal Notification Settings](https://abnormalsecurity.my.site.com/support/s/article/Abnormal-Portal-Notifications-Settings) page.
{% endhint %}

* In the "IP Safelist" section, input an IPv4 / IPv6 address or a CIDR block, then click "Add"

{% hint style="info" %}
Currently, this address must be the same as the `public-ipv4` endpoint Dropzone uses when calling Abnormal AI. If you do not know the IP address, you can do a DNS lookup of your instance (e.g. example.dropzone.app), or find it using a `curl` request.

In the near future, this IP address will be an AWS public address. Use AWS' [instance metadata service](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) to locate the `public-ivp4` value.

If your Abnormal AI traffic is routed through a Dropzone [connector](https://docs.dropzone.ai/platform/settings/connector), add its IP address to the Safelist as well.
{% endhint %}

* Click "Create Token"

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

* Copy the token shown for use later in the Dropzone UI, where it is called "Access Token"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2F4L8HltAhTFcpkjRZlTgf%2Fabnormalai-3.png?alt=media" alt=""><figcaption><p>Copy the Access Token</p></figcaption></figure>

## Enable Abnormal AI

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

| Dropzone Field | Source                                       |
| -------------- | -------------------------------------------- |
| Access Token   | The Access Token value you generated earlier |
| Region         | The tenant region of your Abnormal AI tenant |

* 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 Abnormal AI, then click "Configure"

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

* Under the Data Source header, if your Abnormal AI integration is behind an On-premise Dropzone Connector, select your connector from the dropdown
* Input the Access Token and Region

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FddF5ySRW7cs5trIqM7TA%2Fapp_system_integrations_available_abnormalai_data_config.png?alt=media" alt=""><figcaption><p>The Abnormal AI Data Source Configuration</p></figcaption></figure>

* Click "Test & Save" to finish

If you have any errors contact our Customer Success team.
