Details

ID	`FeedURLhaus`
Provider	Open Source
Category	Data Enrichment & Threat Intelligence
From Version	5.5.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM

README

URLhaus is a platform from abuse.ch and Spamhaus dedicated to sharing malicious URLs that are being used for malware distribution.
For more information, visit: https://urlhaus.abuse.ch/

Fetch indicators from URLhaus api

Fetch indicators from the URLhaus API.

Parameter	Description	Required
Auth Key	Auth Key for authentication with abuse.ch	True
Fetches indicators	Check tofetch indicators	True
Indicator Reputation	The type of reputation for the indicator	True
Feed Source	The type of data we want to get from the api	True
Traffic Light Protocol Color	The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed.	True
Indicator Expiration Method	The indicator expiration method	True
Source Reliability	The reliability of the feed	True
Feed Fetch Interval	The time interval to fetch indicators from the api	True
Trust any certificate	Weather or not to trust any certificate	True
Use system proxy settings	If you want to use proxy for the integration	True

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.

Commands

You can execute these commands in a playbook.

urlhaus-get-indicators

Manual command to fetch events and display them.

Configuration parameters

credentials —
feedTags — Tags
feedExpirationPolicy —
feedReputation — Indicator Reputation
tlp_color — Traffic Light Protocol Color
feed — Fetch indicators
feedReliability — Source Reliability (required)
feedExpirationInterval —
feedFetchInterval — Feed Fetch Interval
feedBypassExclusionList — Bypass exclusion list
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (1)

urlhaus-get-indicators
Retrieves a limited number of indicators.

Source

FeedURLhaus.py FeedURLhaus.yml FeedURLhaus_description.md

Download History Raw

category: Data Enrichment & Threat Intelligence
provider: Open Source
sectionorder:
- Connect
- Collect
commonfields:
  id: FeedURLhaus
  version: -1
configuration:
- displaypassword: Auth Key
  hiddenusername: true
  name: credentials
  type: 9
  section: Connect
  required: false
  additionalinfo: Starting June 30th 2025 this parameter is mandatory.
- name: feedTags
  display: Tags
  type: 0
  section: Collect
  additionalinfo: Supports CSV values.
  required: false
- display: ''
  name: feedExpirationPolicy
  options:
  - never
  - interval
  - indicatorType
  - suddenDeath
  type: 17
  section: Collect
  required: false
- display: Indicator Reputation
  type: 18
  section: Collect
  options:
  - None
  - Good
  - Suspicious
  - Bad
  defaultvalue: 'Bad'
  additionalinfo: Indicators from this integration instance will be marked with this reputation
  name: feedReputation
  required: false
- name: tlp_color
  display: Traffic Light Protocol Color
  defaultvalue: WHITE
  type: 15
  section: Collect
  additionalinfo: The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed.
  options:
  - RED
  - AMBER
  - GREEN
  - WHITE
  required: false
- name: feed
  defaultvalue: 'true'
  display: Fetch indicators
  type: 8
  section: Collect
  required: false
- name: feedReliability
  display: Source Reliability
  type: 15
  section: Collect
  required: true
  options:
  - A - Completely reliable
  - B - Usually reliable
  - C - Fairly reliable
  - D - Not usually reliable
  - E - Unreliable
  - F - Reliability cannot be judged
  defaultvalue: '- B - Usually reliable'
  additionalinfo: Reliability of the source providing the intelligence data.
- name: feedExpirationInterval
  display: ''
  type: 1
  section: Collect
  required: false
- name: feedFetchInterval
  display: Feed Fetch Interval
  type: 19
  section: Collect
  defaultvalue: '60'
  required: false
- name: feedBypassExclusionList
  display: Bypass exclusion list
  type: 8
  section: Collect
  additionalinfo: 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.
  required: false
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  section: Connect
  required: false
- display: Use system proxy settings
  name: proxy
  section: Connect
  type: 8
  required: false
description: Fetch url indicators for URLHaus.
display: URLhaus Feed
name: FeedURLhaus
script:
  commands:
  - name: urlhaus-get-indicators
    description: Retrieves a limited number of indicators.
    arguments:
    - name: limit
      description: Limit of the api request.
    outputs: []
  dockerimage: demisto/python3:3.12.13.10116658
  feed: true
  runonce: false
  script: "-"
  subtype: python3
  type: python
fromversion: 5.5.0
tests:
- playbook-urlhaus-feed_Test