id: feed_urlhaus
name: URLhaus Feed
version: 1.0.0
description: "abuse.ch URLhaus feed connector — pull the bulk list of malware-distribution URLs (recent additions or currently-online) and emit normalized IOCs (URL + type, with threat/tags/status context) for import into the Threat Indicator Manager. abuse.ch now requires a free Auth-Key for downloads; stdlib-only, no extra Python dependencies."
changelog: "1.0.0 — Initial release: fetch the URLhaus recent/online CSV feed."
category: feed

# URLhaus is an abuse.ch feed. As of 2024 abuse.ch requires a free Auth-Key
# (sent as the Auth-Key header) for feed downloads.
config_schema:
  properties:
    api_key:
      type: string
      description: "abuse.ch Auth-Key (free — from your abuse.ch account profile)"
      x-soar-sensitive: true
    list:
      type: string
      description: "Which feed: recent (last additions) or online (currently active). Default recent"
      default: "recent"
    insecure:
      type: boolean
      description: "Trust any TLS certificate (not secure)"
      default: false
  required: []

commands:
  - id: fetch_indicators
    name: feed-urlhaus-fetch-indicators
    description: "Fetch the URLhaus CSV feed and return normalized indicators."
    risk: read
    inputs_schema:
      properties:
        list: { type: string, description: "recent | online (overrides the config default)" }
        max_indicators: { type: number, description: "Max indicators to return (0 = no limit, default 0)" }
      required: []
    outputs_schema: { properties: {} }

  - id: test_connection
    name: feed-urlhaus-test-connection
    description: "Verify the URLhaus feed is reachable (used by the Test button)."
    risk: read
    inputs_schema:
      properties: {}
      required: []
    outputs_schema: { properties: {} }