> 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/abnormalai_alert.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 AI 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 token scope. You can further specify Dropzone's multi-tenancy access in the Dropzone UI
  * **Tenant (Single Tenant)**: limits the token access to a single specified tenant
  * **Customer (All Current and Future Tenants)**: grants access across all tenants within your Abnormal account
* 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 Data 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 Alert 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                                                                                                                                                                                           |
| Tenant IDs     | The ID of your Abnormal AI tenants. Only needed if multi-tenancy is enabled. Locate them using [TenantBase](https://abnormal.ai/blog/abnormal-knowledge-bases-tenantbase#:~:text=to%20correct%20issues.-,Protect,-This%20House%20with) |

* 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 Alert Source header, 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%2FEibAJgEgC7lfud5mGvu9%2Fapp_system_integrations_available_abnormalai_alert_config.png?alt=media" alt=""><figcaption><p>The Abnormal AI Alert Source Configuration (pt 1)</p></figcaption></figure>

* If you have a Customer Access Token, you can limit Dropzone's access to specific tenants. Check the box labeled "Multi-tenant environment". Click "Add Item", then input the Tenant ID's of the specific tenants you want Dropzone to access

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

* Under "Enabled Alert Types", check the box labeled "Cases" to enable Dropzone to ingest Cases
* Select the severity levels you want Dropzone to ingest
* Check the box labeled "Threats" to enable Dropzone to ingest [Threats](https://abnormal.ai/resources/demos/about-threat-log-demo)
* Check the box labeled "Abuse Mailbox" to enable Dropzone to ingest alerts from your [Abuse Mailbox](https://abnormal.ai/glossary/abuse-mailbox)

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FOo4YnNQWaHkCDwpD1hkq%2Fapp_system_integrations_available_abnormalai_alert_config_2.png?alt=media" alt=""><figcaption><p>The Abnormal AI Alert Source Configuration (pt 3)</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 Abnormal AI Alert Source Integration (pt 4)</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 Abnormal AI Alert Source Configuration (pt 5)</p></figcaption></figure>

* Click "Test & Save" to finish

If you have any errors contact our Customer Success team.
