Home
Softono
AI-Powered-Ransomware-Intelligence-Agent

AI-Powered-Ransomware-Intelligence-Agent

Open source Python
21
Stars
0
Forks
0
Issues
1
Watchers
2 months
Last Commit

About AI-Powered-Ransomware-Intelligence-Agent

Automated n8n workflow for ransomware threat monitoring using ransomware.live API and Claude AI β€” companion to the SANS Ransomware Intelligence webinar

Platforms

Web Self-hosted

Languages

Python

Links

πŸ›‘οΈ AI-Powered Ransomware Intelligence Agent (n8n Workflows)

n8n.io Claude Ollama Ransomware.live License: CC BY-NC 4.0

Author: Raymond DePalma  |  Companion to the SANS Ransomware Intelligence Webinar

Automated threat intelligence pipelines that continuously monitor ransomware leak sites, run AI-powered analysis, and deliver rich interactive reports β€” to Slack, Google Docs, and email.


πŸ–ΌοΈ Preview

n8n Workflow

n8n Workflow

HTML Report β€” Dashboard

Dashboard KPIs

HTML Report β€” Charts & Analysis

Charts Analysis

HTML Report β€” Lifecycle & Mindmap

Lifecycle Mindmap


πŸ“Š Workflow Progression

Level File LLM Key Capabilities Visibility
101 101_ransomware_threat_monitor.json Claude Sonnet Monitor β†’ AI analysis β†’ HTML + Slack report βœ… Public
101 (Ollama) 101_ransomware_threat_monitor_ollama.json Ollama (local) Same as 101, fully local β€” no API costs βœ… Public
200 200_ransomware_intel_advanced.json Claude Sonnet + IOC enrichment, YARA rules, historical trending, email + JIRA βœ… Public
200 (Ollama) 200_ransomware_intel_advanced_ollama.json Ollama (local) Same as 200, fully local βœ… Public

✨ What the 101 Workflow Produces

Import, activate, and within minutes you get a full dark-themed threat intelligence brief:

  • 8 KPI cards β€” Active groups, total victims, countries, industries, time-to-encrypt, victims/day, double extortion rate, composite risk score
  • MITRE ATT&CK table β€” Observed TTPs with technique IDs, tactic phases, and severity badges
  • 5 Chart.js charts β€” Geographic doughnut, industry doughnut, TTP severity polar area, group comparison, risk radar
  • Attack lifecycle visualization β€” 6-step colored flow (Initial Access β†’ Execution β†’ Priv Esc β†’ Lateral Mvmt β†’ Exfiltration β†’ Impact)
  • Group profile cards β€” Per-actor victim breakdown with individual industry charts
  • Slack alert β€” Concise threat summary with group and victim stats
  • Google Doc β€” Full markdown brief (optional)

πŸ› οΈ Prerequisites

For the Claude version (101/200):

  1. n8n instance β€” self-hosted or cloud
  2. Anthropic API key
  3. Slack webhook URL
  4. Google Docs OAuth (optional)

For the Ollama version (101/200):

  1. n8n instance
  2. Ollama running locally β€” ollama serve
  3. A compatible model pulled β€” ollama pull llama3.1
  4. Slack webhook URL

Compatible Ollama models: llama3.1 (recommended), mistral, gemma2, qwen2.5

For the 200 level (additional):

  • VirusTotal API key (free tier: 500 req/day)
  • AbuseIPDB API key (free tier available)
  • SMTP/SendGrid for email delivery
  • JIRA credentials (optional)

Note: The ransomware.live API is completely free and requires no authentication.

Optional: Mock API for Safe Demos

This repository includes a Mock API Server (mock_api/) that simulates the ransomware.live feed β€” ideal for webinars or offline demos. See mock_api/README.md.


πŸš€ Quick Start

Claude (101)

  1. Download n8n_workflows/101_ransomware_threat_monitor.json
  2. Import into n8n (Workflows β†’ Add Workflow β†’ Import from File)
  3. Configure credentials: Anthropic API key, Slack webhook, Google Docs OAuth
  4. Customize the Filter by Industry node with your target sectors
  5. Activate and trigger manually to test

Ollama (101) β€” fully local, no API costs

  1. Start Ollama and pull a model: ollama pull llama3.1
  2. Download n8n_workflows/101_ransomware_threat_monitor_ollama.json
  3. Import into n8n
  4. Configure Slack webhook
  5. The Ollama node connects to http://localhost:11434 by default β€” no API key needed

Demo Mode (offline)

Use 101_ransomware_threat_monitor_DEMO.json with the included mock_api/ server for live demos without connecting to real threat feeds.


πŸ“‹ Workflow Architecture (101)

Schedule (6h) β†’ Fetch Victims API β†’ Redact Identities β†’ Filter by Industry
     β†’ Deduplicate by Group β†’ Fetch Group Profiles β†’ Build Consolidated Brief
     β†’ AI Threat Analysis (Claude / Ollama) β†’ Enhance Brief
     β†’ Output HTML File + Slack Alert + Google Doc

πŸ“„ Sample Outputs

See the examples/ directory:

  • HTML Report β€” Full interactive report with Chart.js charts, open in any browser
  • Markdown Report β€” Full brief with Mermaid diagrams and MITRE mapping
  • Slack Alert β€” Concise channel notification

πŸ“ License

CC BY-NC 4.0 β€” Free for educational and defensive use with attribution. Commercial use prohibited.

Disclaimer: This workflow connects to real-world threat feeds. Handle intelligence reports with appropriate OPSEC.