← 返回列表

DirectConnect API

单站 AlienVault OTX 入库 2026-11-18T01:23:16

The OTX DirectConnect API allows you to easily synchronize the Threat Intelligence available in OTX to the tools you use to monitor your environment. Using the DirectConnect agents you can integrate with your infrastructure to detect threats targeting your environment. If there is no pre-built agent for the products you are using, leverage the DirectConnect SDK (available in Java and Python) to develop your own integration for the community.

Resources

Docs

TAXII

Example API Uses

You can access the API using the cli as follows

curl /api/v1/pulses/subscribed?page=1 -H "X-OTX-API-KEY: \"

OTX can act as a TAXII server, making it possible for you to consume pulses via any TAXII client that you prefer. #### Getting set up

To consume the OTX STIX/TAXII feed you'll need to enter the following details into your TAXII client:

Discovery URL: https://otx.alienvault.com/taxii/discovery

Username: (Your API key)

Password: (put anything here, password is ignored)

How are you using STIX/TAXII?

Despite a mammoth specification, we found there is little standardisation in the way TAXII client implementations work. For example, some clients will poll for updates every minute, some every hour. Some clients do not properly do "paging" of results. Let us know if our implementation isn't working for your client, or if you have any questions or suggestions. #### Testing / exploration

To get an idea of how TAXII works with OTX, you can try it out using any number of available TAXII clients. Here are some examples using a client called cabby. cabby can be downloaded and installed, or if you have a working docker installed, you can run it via a docker container. If you're using docker, your command line will look something like docker run --rm=true eclecticiq/cabby:latest taxii-discovery ...more arguments...

if you're running from a locally installed cabby instance, the same command would just be taxii-discovery ...more arguments...

Discovery

taxii-discovery is a cabby program that will call the taxii discovery endpoint, which tells you what services are available and some of the options they support. ```
$ taxii-discovery --path https://otx.alienvault.com/taxii/discovery
=== Service Instance ===
Service Type: POLL
Service Version: urn:taxii.mitre.org:services:1.1
Protocol Binding: urn:taxii.mitre.org:protocol:https:1.0
Service Address: https://otx.alienvault.com/taxii/poll
Message Binding: urn:taxii.mitre.org:message:xml:1.1
Available: True
Message: OTX Taxii Polling
=== Service Instance ===
Service Type: COLLECTION_MANAGEMENT
Service Version: urn:taxii.mitre.org:services:1.1
Protocol Binding: urn:taxii.mitre.org:protocol:https:1.0
Service Address: https://otx.alienvault.com/taxii/collections
Message Binding: urn:taxii.mitre.org:message:xml:1.1
Available: True
Message: OTX Taxii Collections
=== Service Instance ===
Service Type: DISCOVERY
Service Version: urn:taxii.mitre.org:services:1.1
Protocol Binding: urn:taxii.mitre.org:protocol:https:1.0
Service Address: https://otx.alienvault.com/taxii/discovery
Message Binding: urn:taxii.mitre.org:message:xml:1.1
Available: True
Message: OTX Taxii Discovery

#### Collections

taxii-collections is a cabby program that will list the collections that are available to you. Note that available collections will vary by user, depending on collections you have access to. If you do not pass a username, then you will see only public collections. To see your personal additional collection, pass your OTX API key as the "username", with anything or nothing as the password. ```
$ taxii-collections --path https://otx.alienvault.com/taxii/collections --username MY_OTX_API_KEY_HERE --password foo
2017-04-25 14:53:42,286 INFO: Sending Collection_Information_Request to https://otx.alienvault.com/taxii/collections
=== Data Collection Information ===
Collection Name: user_LevelBlue
Collection Type: DATA_FEED
Available: True
Collection Description: Data feed for user: LevelBlue
Supported Content: All
=== Polling Service Instance ===
Poll Protocol: urn:taxii.mitre.org:protocol:https:1.0
Poll Address: https://otx.alienvault.com/taxii/poll
Message Binding: urn:taxii.mitre.org:message:xml:1.1
==================================
=== Data Collection Information ===
Collection Name: group_999
Collection Type: DATA_FEED
Available: True
Collection Description: Data feed for group: id=999 name=Secret Group #1
Supported Content: All
=== Polling Service Instance ===
Poll Protocol: urn:taxii.mitre.org:protocol:https:1.0
Poll Address: https://otx.alienvault.com/taxii/poll
Message Binding: urn:taxii.mitre.org:message:xml:1.1
==================================
=== Data Collection Information ===
Collection Name: group_1000
Collection Type: DATA_FEED
Available: True
Collection Description: Data feed for group: id=18 name=My Malware Group
Supported Content: All
=== Polling Service Instance ===
Poll Protocol: urn:taxii.mitre.org:protocol:https:1.0
Poll Address: https://otx.alienvault.com/taxii/poll
Message Binding: urn:taxii.mitre.org:message:xml:1.1
==================================

Polling

taxii-poll is a cabby program that will poll a collection and return all matching results. This command can be helpful to make sure that the collection feed is working, but because it dumps all the output in a raw for, the output won't be included here. This example will fetch the first page of results from the LevelBlue user's feed, starting at April 15th, 2017 at midnight UTC. ```
taxii-poll --path https://otx.alienvault.com/taxii/poll --collection user_LevelBlue\
--username MY_OTX_API_KEY_HERE --password foo --begin 2017-04-15T00:00:00

```

Do you know of any OTX API integrations we're missing here, or planning on writing your own?

We've love to hear - Let us know via cs-otx-support@att.com or the feedback form.

Name Description Language
OpenCTI Connector Imports OTX threat data into the OpenCTI platform Python
MISP Importer Imports pulses into a MISP instance Python
Splunk Importer Tutorial Splunk and Sysmon via a CSV export Python
Bro Importer Integrate Bro with LevelBlue Labs OTX Python
OTX 2 CRITS Imports pulses into CRITS Python
The Hive Incident Response Platform Python
Maltego Transform A local Maltego transform Python
Signature Base Downloads indicators into a CSV file for Loki and Spark Python
SDK Examples Trivial examples included with the OTX SDK Python
HostIntel Collects various intelligence sources for hosts Python
IntelMQ Collects and processes security feeds using a message queuing protocol Python
FileIntel Collects various intelligence sources for a given file Python
CTI Toolbox Python
GoatRider Pulls down threat intelligence from a number of sources Python
ArcReactor Collects OSINT for SIEMs Python
OTX MISP Imports pulses into MISP Python
Splunk APP Python
RITAA Graylog matching Python
OTX Siphon Pulls subscribed indicators into to a csv file. Python
Graylog Importer Threat Intelligence Plugin for Graylog Java
Threat Scanner App Android application Java
Node SDK Node
Brocade Firewall Update Node
Go Client Client for GO Go
Rust Bindings Bindings for Rust Rust
Ruby Wrapper Rubey Gem Ruby
ThreatPinch Chrome extension Javascript
BurningDogs Honeypot Pulse Creator F#
Kentik Custom Dimension
PowerShell API for OTX Pulling all LevelBlue indicators and exporting to CSVs PowerShell

Already using LevelBlue USM or LevelBlue OSSIM? If so, use your OTX API key with USM / OSSIM and get the benefits of the DirectConnect API immediately.

Don’t have LevelBlue USM? Try LevelBlue USM.

原文链接:https://otx.alienvault.com/api