Current ThreatQ Version Filter
 

AlienVault OTX CDF

The web format of this guide reflects the most current release.  Guides for older iterations are available in PDF format.  

Integration Details

ThreatQuotient provides the following details for this integration:

Introduction

AlienVault OTX is the world’s largest open threat intelligence community, enabling collaborative defense with actionable, community-powered threat data. These feed ingests data from AlienVault's Open Threat Exchange.

The CDF provides the following feed:

  • AlienVault OTX - returns responses is a plain text list of CSV-like values, using #'s as separators.

The integration ingests indicators and indicator attributes.  

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. 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 OSINT option from the Category dropdown (optional).
  3. Click on the integration entry to open its details page.
  4. Enter the following parameter under the Configuration tab:
    Parameter Description
    Feed URL Displays the endpoint polled by this feed.

    This field is for display purposes only.

    Configuration Screen
  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

AlienVault OTX

GET https://reputation.alienvault.com/reputation.data

The response is a plain text list of CSV-like values, using #'s as separators:

46.4.123.15#4#2#Malicious Host#DE##51.2993011475,9.49100017548#3
49.143.32.6#4#2#Malicious Host#KR##37.5111999512,126.974098206#3
45.248.192.48#4#3#Malicious Host#IN#Sikar#27.6166992188,75.1500015259#3
100.27.42.243#4#2#Malicious Host#US#Ashburn#39.0480995178,-77.4728012085#3
36.27.208.157#4#2#Malicious Host#CN##30.2936000824,120.161399841#3
106.13.17.16#4#2#Malicious Host#CN##39.9289016724,116.388298035#3
118.89.65.15#4#2#Malicious Host#CN#Beijing#39.9287986755,116.388900757#3
...

ThreatQuotient provides the following default mapping for this feed:

Feed Data Path ThreatQ Entity ThreatQ Object Type or Attribute Key Examples Notes
0 (first token) Indicator.Value IP Address 46.4.123.15 N/A
1 (second token) Indicator.Attribute AlienVault Reliability 4 N/A
2 (third token) Indicator.Attribute AlienVault Threat Level 2 Updates at ingestion.
3 (fourth token) Indicator.Attribute Description Malicious Host Split on ;
4 (fifth token) Indicator.Attribute Country CN N/A
5 (sixth token) Indicator.Attribute City Beijing N/A
7 (eighth token) Indicator.Attribute AlienVault Revision 3 Split on ;

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.

AlienVault OTX

Metric Result
Run Time 2 minutes
Indicator 1,595
Indicator Attributes 8,903

Change Log

  • Version 2.0.1
    • Added ingest rules to the AlienVault Threat Level attribute.  This attribute value will now be updated upon ingestion instead of duplicated.   
  • Version 2.0.0
    • Removed API Key usage.
  • Version 1.0.0
    • Initial release

PDF Guides

Document ThreatQ Version
AlienVault OTX CDF v2.0.1 4.4.0 or Greater
AlienVault OTX CDF v2.0.0 4.4.0 or Greater