Integration Details

ThreatQuotient provides the following details for this integration:

Introduction

The Abnormal Security CDF enables analysts to automatically ingest their Abnormal Security Cases & Threats into ThreatQ.

The integration provides the following feeds:

• Abnormal Security - Cases - ingests cases from Abnormal Security and creates incidents in ThreatQ
• Abnormal Security - Threats - ingests threats from Abnormal Security and creates incidents in ThreatQ

The integration ingests the following system objects:

• Incidents
• Events
• Identities
• Indicators

Prerequisites

An Abnormal Security License and API Key are required to use this integration.   You can generate an API key from: https://portal.abnormalsecurity.com/home/settings/integrations.   

Installation

Perform the following steps to install the integration:

The same steps can be used to upgrade the integration to a new version.

1. Log into https://marketplace.threatq.com/.
2. Locate and download the integration file.
3. Navigate to the integrations management page on your ThreatQ instance.
4. Click on the Add New Integration button.
5. Upload the integration file using one of the following methods:
   • Drag and drop the file into the dialog box
   • Select Click to Browse to locate the integration file on your local machine

   ThreatQ will inform you if the feed already exists on the platform and will require user confirmation before proceeding. ThreatQ will also inform you if the new version of the feed contains changes to the user configuration. The new user configurations will overwrite the existing ones for the feed and will require user confirmation before proceeding.

6. If prompted, select the individual feeds to install and click Install. The feed will be added to the integrations page. 

You will still need to configure and then enable the feed.

Configuration

ThreatQuotient does not issue API keys for third-party vendors. Contact the specific vendor to obtain API keys and other integration-related credentials.

To configure the integration:

1. Navigate to your integrations management page in ThreatQ.
2. Select the Commercial option from the Category dropdown (optional).

   If you are installing the integration for the first time, it will be located under the Disabled tab.

3. Click on the integration entry to open its details page.
4. Enter the following parameters under the Configuration tab:

   Parameter	Description
   AUTHENTICATION
   API Key	Enter your Abnormal Security API Key.
   API DATA FILTERING (Abnormal Security Threats feed only)
   Source	Filter threats based on the source of detection.  Options include Advanced (default) and All.
   Attack Type	Filter threats based on the type of attack. The API only allows one selection at a time. Selecting Any will return all attack types.  Options include: Any (default) Internal-to-Internal Attacks (Email Account Takeover) Spam Reconnaissance Scam Social Engineering (BEC) Phishing: Credential Invoice/Payment Fraud (BEC) Malware Extortion Phishing: Sensitive Data Other
   Attack Vector	Filter threats based on the attack vector. The API only allows one selection at a time. Selecting Any will return all attack vectors.  Options include: Any (default) Link Attachment Text Others Attachment with zipped files
   Attack Strategy	Filter threats based on the attack strategy. The API only allows one selection at a time. Selecting Any will return all attack strategy.  Options include: Any (default) Name Impersonation Internal Compromised Email Account External Compromised Email Account Spoofed Email Unknown Sender COVID 19 Related Attack
   INGESTION OPTIONS
   Ingest Summary Insights As	Select which ThreatQ entity type to ingest the Summary Insights.  Options include Tags (default) and Attributes.
   Inherit Attributes to Indicators	Select which attributes you want to inherit to the related Indicators.

   
   
5. Review any additional settings, make any changes if needed, and click on Save.
6. Click on the toggle switch, located above the Additional Information section, to enable it.

ThreatQ Mapping

{
  "threats": [
    {
      "threatId": "184712ab-6d8b-47b3-89d3-a314efef79e2"
    }
  ],
  "pageNumber": 1,
  "nextPageNumber": 2
}

{
  "threats": [
    {
      "threatId": "184712ab-6d8b-47b3-89d3-a314efef79e2"
    }
  ],
  "pageNumber": 1,
  "nextPageNumber": 2
}

{
  "caseId": "1234",
  "severity": "Potential Account Takeover",
  "affectedEmployee": "John Doe",
  "firstObserved": "2020-06-09T17:42:59Z",
  "threatIds": ["184712ab-6d8b-47b3-89d3-a314efef79e2"]
}

{
  "threatId": "184712ab-6d8b-47b3-89d3-a314efef79e2",
  "messages": [
    {
      "threatId": "184712ab-6d8b-47b3-89d3-a314efef79e2",
      "abxMessageId": 4551618356913732000,
      "abxPortalUrl": "https://portal.abnormalsecurity.com/home/threat-center/remediation-history/4551618356913732076",
      "subject": "Phishing Email",
      "fromAddress": "support@secure-reply.org",
      "fromName": "Support",
      "senderDomain": "secure-reply.org",
      "toAddresses": "example@example.com, another@example.com",
      "recipientAddress": "example@example.com",
      "receivedTime": "2020-06-09T17:42:59Z",
      "sentTime": "2020-06-09T17:42:59Z",
      "internetMessageId": "<5edfca1c.1c69fb81.4b055.8fd5@mx.google.com>",
      "remediationStatus": "Auto Remediated",
      "attackType": "Extortion",
      "attackStrategy": "Name Impersonation",
      "returnPath": "support@secure-reply.org",
      "replyToEmails": ["reply-to@example.com"],
      "ccEmails": ["cc@example.com"],
      "senderIpAddress": "100.101.102.103",
      "impersonatedParty": "None / Others",
      "attackVector": "Text",
      "attachmentNames": ["attachment.pdf"],
      "attachmentCount": 0,
      "urls": ["https://www.google.com/"],
      "urlCount": 0,
      "summaryInsights": [
        "Bitcoin Topics",
        "Personal Information Theft",
        "Unusual Sender"
      ],
      "remediationTimestamp": "2020-06-09T17:42:59Z",
      "isRead": true,
      "attackedParty": "VIP",
      "autoRemediated": true,
      "postRemediated": false
    }
  ],
  "pageNumber": 1,
  "nextPageNumber": 2
}

{
  "threatId": "184712ab-6d8b-47b3-89d3-a314efef79e2",
  "messages": [
    {
      "threatId": "184712ab-6d8b-47b3-89d3-a314efef79e2",
      "abxMessageId": 4551618356913732000,
      "abxPortalUrl": "https://portal.abnormalsecurity.com/home/threat-center/remediation-history/4551618356913732076",
      "subject": "Phishing Email",
      "fromAddress": "support@secure-reply.org",
      "fromName": "Support",
      "senderDomain": "secure-reply.org",
      "toAddresses": "example@example.com, another@example.com",
      "recipientAddress": "example@example.com",
      "receivedTime": "2020-06-09T17:42:59Z",
      "sentTime": "2020-06-09T17:42:59Z",
      "internetMessageId": "<5edfca1c.1c69fb81.4b055.8fd5@mx.google.com>",
      "remediationStatus": "Auto Remediated",
      "attackType": "Extortion",
      "attackStrategy": "Name Impersonation",
      "returnPath": "support@secure-reply.org",
      "replyToEmails": ["reply-to@example.com"],
      "ccEmails": ["cc@example.com"],
      "senderIpAddress": "100.101.102.103",
      "impersonatedParty": "None / Others",
      "attackVector": "Text",
      "attachmentNames": ["attachment.pdf"],
      "attachmentCount": 0,
      "urls": ["https://www.google.com/"],
      "urlCount": 0,
      "summaryInsights": [
        "Bitcoin Topics",
        "Personal Information Theft",
        "Unusual Sender"
      ],
      "remediationTimestamp": "2020-06-09T17:42:59Z",
      "isRead": true,
      "attackedParty": "VIP",
      "autoRemediated": true,
      "postRemediated": false
    }
  ],
  "pageNumber": 1,
  "nextPageNumber": 2
}

{
  "threats": [
    {
      "abxMessageId": 4551618356913732000,
      "domainLink": "lamronba.com",
      "linkType": "html href",
      "source": "body",
      "displayText": "This is not a spoof!",
      "linkUrl": "http://spoof.lamronba.com"
    }
  ]
}

{
  "threats": [
    {
      "abxMessageId": 4551618356913732000,
      "attachmentName": "attachment1.jpg"
    }
  ]
}

Average Feed Run

Object counts and Feed runtime are supplied as generalities only - objects returned by a provider can differ based on credential configurations and Feed runtime may vary based on system resources and load.

Abnormal Security - Cases

Abnormal Security - Threats

Change Log

• Version 1.0.0
  • Initial release