---
updatedAt: 2026-10-13T14:48:34.000Z
agentTools:
  projectIndex: https://docs.axonius.com/llms.txt
---

# Abnormal Security

Abnormal Security is an email security provider that helps companies protect against targeted email attacks.

<Callout icon="💡" theme="warn">
  In many deployments, the Abnormal API may require you to allowlist (whitelist) the IP address used for requests from Axonius.
</Callout>

### Asset Types Fetched

* Users, Alerts/Incidents, Secrets

<Callout icon="far fa-circle-info" theme="info">
  Note

  This adapter only brings users that have been noted in threats in the past 7 days from the fetch.
</Callout>

## Before You Begin

### Required Ports

* TCP port 80/443

### Authentication Methods

* API Token

### APIs

Axonius uses the [Abnormal Security Client API](https://app.swaggerhub.com/apis/abnormal-security/abx/1.4.2#/info).

### Permissions

Consult with your vendor for permissions for reading the objects.

### Supported From Version

Supported from Axonius version 6.1

## Connecting the Adapter in Axonius

To connect the adapter in Axonius, provide the following parameters:

### Required Parameters

1. **Host Name or IP Address** - The hostname or IP address of the Abnormal Security server.
2. **Email Domain** - Email domain for filtering emails inside threats. Example of a valid email domain: axonius.com. Also can be a comma-separated list of email domains, i.e., axonius.com,axonius.io.
3. **Token** - An API Token associated with a user account that has permissions to fetch assets. For information on how to generate the token, see [Generating the authentication token](https://app.swaggerhub.com/apis/abnormal-security/abx/1.4.2#/info).

![Abnormal Security](https://raw.githubusercontent.com/Axonius/ax-docs-pub/refs/heads/main/Images/Abnormal%20Security.png)

### Optional Parameters

1. **Verify SSL** - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see [SSL Trust & CA Settings](https://docs.axonius.com/axonius-help-docs/docs/certificate-settings#ssl-trust-ca-settings).
2. **HTTPS Proxy** - Connect the adapter to a proxy instead of directly connecting it to the domain.
3. **HTTPS Proxy User Name** - The user name to use when connecting to the value supplied in **Host Name or IP Address** via the value supplied in **HTTPS Proxy**.
4. **HTTPS Proxy Password** - The password to use when connecting to the server using the **HTTPS Proxy**.

To learn more about common adapter connection parameters and buttons, see [Adding a New Adapter Connection](https://docs.axonius.com/axonius-help-docs/docs/adding-a-new-adapter-connection).

## Advanced Settings

<Callout icon="far fa-circle-info" theme="info">
  Note: Advanced settings can either apply to all connections for this adapter, or to a specific connection. Refer to [Advanced Configuration for Adapters](https://docs.axonius.com/axonius-help-docs/docs/advanced-configuration-for-adapters). To learn more about **Adapter Configuration** tab advanced settings, see [Adapter Advanced Settings](https://docs.axonius.com/axonius-help-docs/docs/advanced-settings).
</Callout>

### Global Endpoints Config

**Fetch from last X hours** - Configure the time range for fetching data from the Abnormal Security API. Enter the number of hours of historical data to retrieve.

* **Default value:** 24 hours
* **Maximum value:** 48 hours

This setting applies to all endpoints.

### Endpoints Config

Select and enable the settings listed in this section to enrich employees' data with additional data from specific endpoints.

**Employee Enrichment Options:**

* **Enrich Employee with Employee identity** - Enable this option to enrich employees with identity information from the `/employee/{emailAddress}/identity` endpoint.
* **Enrich Employee with Employee logins** - Enable this option to enrich employees with login activity data from the `/employee/{emailAddress}/logins` endpoint.
* **Enrich Employee with Campaigns details** - Enable this option to enrich employees with abuse campaign information from the `/abusecampaigns/{campaignId}` endpoint.

**Threat Data Options:**

You can enrich employees with threat information using one of two methods. **Do not enable both methods simultaneously.**

* **Enrich Employee with Threats details - CSV** - Enable this option to enrich employees with threat information from the `/threats_export/csv` endpoint. This method uses CSV export for better performance with large data volumes. If you enable this, **don't** enable **Enrich Employee with Threats - API**.

* **Enrich Employee with Threats - API** - Enable this option to enrich employees with threat information from the `/threats` endpoint. This method provides real-time threat data. If you enable this, **don't** enable **Enrich Employee with Threats details - CSV**. When you enable this option, the following nested setting becomes available:
  * **Enrich Threats - API with Threats details - API** - Enable this option to enrich threat records with detailed message information from the `/threats/{threatId}` endpoint.

**Additional Endpoints:**

* **Fetch Users of sub type recipient from Recipient Employees** - Enable this option to fetch users of the subtype "recipient" from the `/aggregations/recipient_employees` endpoint.
* **Fetch Incidents of sub type summary from Summaries** - Enable this option to fetch incident summary data from the `/aggregations/dashboard_summary` endpoint.
* **Fetch Incidents of sub type trend from Trends** - Enable this option to fetch trending attack data from the `/aggregations/trending_attacks` endpoint.
* **Fetch Incidents of sub type threats from Incidents: Threats** - Enable this option to fetch threat data for incidents from the `/threats` endpoint.

**Threats details CSV context - applies context on the following endpoints: Incidents: Threats, EmployeeFetch**

* **Secret from SOAR Tokens** - Enable collection of SOAR API tokens from Abnormal Security.

<Callout icon="far fa-circle-info" theme="info">
  Note: To learn more about **Adapter Configuration** tab advanced settings, see [Adapter Advanced Settings](https://docs.axonius.com/axonius-help-docs/docs/advanced-settings).
</Callout>