ThreatFox Feed

Details

ID	`ThreatFox Feed`
Provider	AbuseCh
Category	Data Enrichment & Threat Intelligence
From Version	6.10.0
Docker Image	`demisto/python3:3.12.13.10399583`
Supported Modules	Agentix XSIAM

README

ThreatFox is a platform from abuse.ch and Spamhaus dedicated to sharing indicators of compromise (IOCs) associated with malware, with the infosec community, AV vendors and cyber threat intelligence providers.
For more information visit: https://threatfox.abuse.ch/

Create an Auth Key for abuse.ch

Note: If you already have a profile, you can skip steps 1 and 2.

Sign up for an abuse.ch account. You can do this easily by using an existing account that you may already have on X, LinkedIn, Google or Github. Just log in with the authentication provider of your choice here: https://auth.abuse.ch/
Once you are authenticated on abuse.ch, ensure that you connect at least one additional authentication provider. This will ensure that you have access to abuse.ch platforms, even if one of the authentication providers you use shuts down (yes, it happened with Twitter!)
Ensure that you hit the “Save profile” button. In the “Optional” section, you can now generate an “Auth-Key”. This is your personal Auth-Key that you can now use in the integration.

Configure ThreatFox Feed in Cortex

Parameter	Description	Required
Server URL		True
Auth Key	Auth Key for authentication with abuse.ch	True
Use system proxy settings		False
Trust any certificate (not secure)		False
Fetch indicators		False
Source Reliability	Reliability of the source providing the intelligence data.	True
Indicator Reputation	Indicators from this integration instance will be marked with this reputation.	False
Traffic Light Protocol Color	The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed.	False
Indicator Expiration Method	The method to be used to expire indicators from this feed. Default: indicatorType	False
Bypass exclusion list	When selected, the exclusion list is ignored for indicators from this feed. This means that if an indicator from this feed is on the exclusion list, the indicator might still be added to the system.	False
Feed Fetch Interval (in days)		False
Return IOCs with Ports	If selected, IP indicators will include a tag with the port value	False
Confidence Threshold		False
Create relationship	If selected, indicators will be created with relationships	False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

threatfox-get-indicators

Retrieves indicators from the ThreatFox API.

Base Command

threatfox-get-indicators

Input

Argument Name	Description	Required
search_term	Indicator value to search for	Optional
id	Indicator ID to search for.	Optional
hash	Hash to search for.	Optional
tag	Tag to search by. For available tag options, please refer to the API documentation- https://threatfox.abuse.ch/api/.	Optional
malware	Malware to search by. For available malware options, please refer to the API documentation- https://threatfox.abuse.ch/api/.	Optional
limit	Maximum indicators to search for. Available only when searching by ‘malware’ or ‘tag’. Default is 50. Max is 1000.	Optional

Context Output

There is no context output for this command.

Create an API Key

Sign up for an abuse.ch account by using an existing account that you may already have on X, LinkedIn, Google or Github. Just log in with the authentication provider of your choice here: https://auth.abuse.ch/
Once you’ve logged in to abuse.ch, add at least one more way to log in. This helps ensure you can always access abuse.ch platforms, even if one of your login methods stops working.
Click the Save profile button. In the Optional section, you can now create an Auth-Key. This is your personal authentication key that you can use to query any abuse.ch APIs.

If you already have a profile, you only need to follow step 3. There’s nothing further to do for your authentication set up.

Configuration parameters

feed — Fetch indicators
url — Server URL (required)
credentials —
feedReputation — Indicator Reputation
feedReliability — Source Reliability (required)
confidence_threshold — Confidence Threshold
tlp_color — Traffic Light Protocol Color
feedExpirationPolicy —
feedExpirationInterval —
feedFetchInterval — Feed Fetch Interval
with_ports — Return IOCs with Ports
create_relationship — Create relationship
feedBypassExclusionList — Bypass exclusion list
proxy — Use system proxy settings
insecure — Trust any certificate (not secure)
feedTags — Tags

Commands (1)

threatfox-get-indicators
Retrieves indicators from the ThreatFox API. Choose one field to search by.

Source

FeedThreatFox.py FeedThreatFox_test.py FeedThreatFox.yml FeedThreatFox_description.md

Download History Raw

## ThreatFox Feed Integration Help

ThreatFox is a free platform from abuse.ch with the goal of sharing indicators of compromise (IOCs) associated with malware with the infosec community, AV vendors and threat intelligence providers.

The ThreatFox Feed allows users to fetch indicators from ThreatFox.

Note, the fetch interval must be a whole number of days: 1, 2, 3, 4, 5, 6, or 7.
Please note that the fetch indicators process will automatically skip any indicators of type SHA3, and these will not be retrieved or processed by the integration.

A manual command is also available to retrieve indicators from ThreatFox as needed and should be used with caution.
For more details, refer to the ThreatFox documentation: <https://threatfox.abuse.ch/api/>

#### Create the required Auth Key for abuse.ch
> Note: If you already have a profile, you can skip steps 1 and 2.

1. Sign up for an abuse.ch account. You can do this easily by using an existing account that you may already have on X, LinkedIn, Google or Github. Just log in with the authentication provider of your choice here: https://auth.abuse.ch/
  
2. Once you are authenticated on abuse.ch, ensure that you connect at least one additional authentication provider. This will ensure that you have access to abuse.ch platforms, even if one of the authentication providers you use shuts down (yes, it happened with Twitter!)

3. Ensure that you hit the "Save profile" button. In the "Optional" section, you can now generate an "Auth-Key". This is your personal Auth-Key that you can now use in the integration.