Skip to content

Threat Intelligence

Siyarix can enrich targets with a small set of live lookups and a larger set of offline catalogs. This page describes what actually ships today — not a roadmap of unimplemented feeds.


Active integrations (live network)

AlienVault OTX

IPv4 reputation lookup against the Open Threat Exchange API.

from siyarix.threat_intel import AlienVaultOTX

otx = AlienVaultOTX()
result = await otx.lookup_ip("8.8.8.8")
# Returns: pulse_count, reputation, source (or error)

Set ALIENVAULT_API_KEY for authenticated requests. Lookups are IPv4-only.

National Vulnerability Database (NVD)

CVE details via the NVD API 2.0.

from siyarix.threat_intel import NVDDatabase

nvd = NVDDatabase()
result = await nvd.lookup_cve("CVE-2021-44228")
# Returns: description, base_score (CVSS v3.1 when present), source

ThreatIntelManager facade

Routes a single target string to OTX (IP) or NVD (CVE-…).

from siyarix.threat_intel import ThreatIntelManager

manager = ThreatIntelManager()
await manager.analyze_target("8.8.8.8")       # → OTX
await manager.analyze_target("CVE-2021-44228")  # → NVD

Offline catalogs (no network)

MITRE ATT&CK (MITREAttackDB)

A curated offline subset of Enterprise tactics and techniques, plus keyword map_finding() helpers for correlating text to technique IDs.

from siyarix.threat_intel import MITREAttackDB

db = MITREAttackDB()
db.query_technique("T1059")
db.search("phishing")
db.map_finding("PowerShell encoded command execution")

Offline CVE cache (ThreatIntelFeed)

ThreatIntelFeed.query_cve() / search() hit a small built-in KNOWN_CVES table (e.g. Log4Shell, MOVEit). This is not a full NVD mirror.

list_feeds() also advertises CISA KEV with status planned — Siyarix does not download the KEV catalog yet. Treat KEV as roadmap only; use the offline CVE cache or live NVD for vulnerability data.


CLI: MITRE reference map

siyarix security mitre-coverage

This command lists the offline MITREAttackDB catalog and marks techniques Referenced when a local hunt query technique ID or keyword-mapped incident/vulnerability text mentions them.

It is not a measured defensive-coverage report. It never claims “Covered / Partial / Gap” for detections or controls you have not deployed.


Planned (not implemented in this module)

These are roadmap items only — do not expect working APIs yet:

  • Live CISA KEV fetch
  • MISP feed ingestion
  • STIX 2.x / OpenIOC import
  • Knowledge-graph linking of indicators to scan findings

What you can do today

  • Check IPv4 reputation via AlienVault OTX
  • Pull CVE description / CVSS from NVD
  • Look up or search offline MITRE techniques and map finding text to technique IDs
  • Query the small offline CVE cache without network access
  • Inspect which offline techniques are referenced by local hunt queries / mapped findings (mitre-coverage)