id: feed_json
name: JSON Feed
version: 1.0.0
description: "Generic JSON threat-intel feed connector — fetch any JSON feed from a URL, dig into a configurable array path, pull a value field (and optional type field) and emit normalized IOCs (value + type) for import into the Threat Indicator Manager. One connector, many feeds. Optional bearer token; stdlib-only, no extra Python dependencies."
changelog: "1.0.0 — Initial release: fetch indicators from a JSON feed with configurable field mapping."
category: feed

# The feed is fetched over HTTP(S) from feed_url. array_path digs into nested
# objects (dot notation) to reach the list of indicators; value_field/type_field
# select the fields on each element.
config_schema:
  properties:
    feed_url:
      type: string
      description: "URL of the JSON feed"
    api_token:
      type: string
      description: "Optional bearer token (if the feed requires auth)"
      x-soar-sensitive: true
    array_path:
      type: string
      description: "Dot path to the array of indicators (e.g. 'data.indicators'). Empty = the top-level value"
    value_field:
      type: string
      description: "Field holding the IOC value on each element (dot path allowed, default 'value')"
      default: "value"
    type_field:
      type: string
      description: "Optional field holding the IOC type on each element"
    insecure:
      type: boolean
      description: "Trust any TLS certificate (not secure)"
      default: false
  required:
    - feed_url

commands:
  - id: fetch_indicators
    name: feed-json-fetch-indicators
    description: "Fetch and parse the JSON feed, returning normalized indicators."
    risk: read
    inputs_schema:
      properties:
        array_path: { type: string, description: "Dot path to the array (overrides config)" }
        value_field: { type: string, description: "Value field / dot path (overrides config)" }
        type_field: { type: string, description: "Type field (overrides config)" }
        ioc_type: { type: string, description: "auto | ip | domain | url | hash | email — fallback type when no type_field (default auto)" }
        max_indicators: { type: number, description: "Max indicators to return (0 = no limit, default 0)" }
      required: []
    outputs_schema: { properties: {} }

  - id: test_connection
    name: feed-json-test-connection
    description: "Verify the feed URL returns valid JSON (used by the Test button)."
    risk: read
    inputs_schema:
      properties: {}
      required: []
    outputs_schema: { properties: {} }