feat(feed): add generic JSON feed connector (configurable field mapping)

2026-07-12 23:02:10 +02:00
parent 381b42b6c7
commit 929b4166d6
3 changed files with 235 additions and 0 deletions
@@ -0,0 +1,59 @@
+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: {} }