Communitygithub.com

IOC-Anreicherung automatisieren

Automatisiert die Anreicherung roher Indikatoren einer Kompromittierung mit Daten aus mehreren Quellen.

Was ist IOC-Anreicherung automatisieren?

Diese Fertigkeit beschreibt, wie ein SOAR-Playbook oder eine Python-Pipeline zur automatischen Anreicherung von Indikatoren einer Kompromittierung (IOCs) erstellt wird. Sie ist besonders nützlich, um SIEM-Warnungen mit Threat-Intelligence-Kontext aus Quellen wie VirusTotal, Shodan, AbuseIPDB und MISP anzureichern, bevor sie an Analysten weitergeleitet werden. Dadurch wird die mittlere Zeit bis zur Erstbewertung (MTTT) reduziert. Die Fertigkeit umfasst die Definition einer Pipeline-Architektur, die Implementierung von Python-Funktionen zur parallelen Abfrage mehrerer APIs, die Berechnung eines gewichteten Vertrauenswertscores sowie die Integration in Plattformen wie Cortex XSOAR, Splunk SOAR oder Tines. Wichtige Aspekte sind die Handhabung von Ratenbegrenzungen, die Fehlerbehandlung und die Vermeidung von Fallstricken wie fehlendem Caching oder automatischen Blockierungsentscheidungen ohne menschliche Überprüfung. Die bereitgestellten Codebeispiele demonstrieren die konkrete Umsetzung in Python und die Konfiguration von SOAR-Playbooks.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/main/skills/automating-ioc-enrichment

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Automatisierung der IOC-Anreicherung

Wann verwenden

Verwenden Sie diese Fertigkeit, wenn:

  • Sie ein SOAR-Playbook erstellen, das SIEM-Warnungen automatisch mit Threat-Intelligence-Kontext anreichert, bevor sie an Analysten weitergeleitet werden.
  • Sie eine Python-Pipeline für die Massenanreicherung von IOCs aus Phishing-E-Mail-Einsendungen erstellen.
  • Sie die durchschnittliche Bearbeitungszeit für Analysten (MTTT) reduzieren, indem Sie Alarmkontext mit Daten aus VT, Shodan und MISP vorab füllen.

Verwenden Sie diese Fertigkeit nicht für vollautomatische Blockierungsentscheidungen ohne menschliche Überprüfung – die Anreicherungsautomatisierung sollte Entscheidungen informieren, nicht aber Blockaden für Maßnahmen mit hohen Auswirkungen autonom ausführen.

Voraussetzungen

  • SOAR-Plattform (Cortex XSOAR, Splunk SOAR, Tines oder n8n) oder Python 3.9+-Umgebung
  • API-Schlüssel: VirusTotal, AbuseIPDB, Shodan und mindestens ein TIP (MISP oder OpenCTI)
  • SIEM-Integrationsendpunkt für den Alarmbezug
  • Budget für Ratenbegrenzungen, dokumentiert pro API (VT: 4/Minute kostenlos, 500/Minute Enterprise)

Arbeitsablauf

Schritt 1: Entwurf der Anreicherungspipeline-Architektur

Definieren Sie den Anreicherungsfluss für jeden IOC-Typ:

SIEM-Alarm → IOCs extrahieren → Typ klassifizieren → An Anreicherungsfunktionen weiterleiten
  IP-Adresse → AbuseIPDB + Shodan + VirusTotal IP + MISP
  Domain → VirusTotal Domain + PassiveTotal + Shodan + MISP
  URL → URLScan.io + VirusTotal URL + Google Safe Browsing
  Datei-Hash → VirusTotal Files + MalwareBazaar + MISP
→ Ergebnisse aggregieren → Vertrauenswert berechnen → Alarm aktualisieren → Analyst benachrichtigen

Schritt 2: Implementierung von Python-Anreicherungsfunktionen

import requests
import time
from dataclasses import dataclass, field
from typing import Optional

RATE_LIMIT_DELAY = 0.25  # 4 Anfragen/Sekunde für VT kostenlosen Tarif

@dataclass
class EnrichmentResult:
    ioc_value: str
    ioc_type: str
    vt_malicious: int = 0
    vt_total: int = 0
    abuse_confidence: int = 0
    shodan_ports: list = field(default_factory=list)
    misp_events: list = field(default_factory=list)
    confidence_score: int = 0

def enrich_ip(ip: str, vt_key: str, abuse_key: str, shodan_key: str) -> EnrichmentResult:
    result = EnrichmentResult(ip, "ip")

    # VirusTotal IP lookup
    vt_resp = requests.get(
        f"https://www.virustotal.com/api/v3/ip_addresses/{ip}",
        headers={"x-apikey": vt_key}
    )
    if vt_resp.status_code == 200:
        stats = vt_resp.json()["data"]["attributes"]["last_analysis_stats"]
        result.vt_malicious = stats.get("malicious", 0)
        result.vt_total = sum(stats.values())

    time.sleep(RATE_LIMIT_DELAY)

    # AbuseIPDB
    abuse_resp = requests.get(
        "https://api.abuseipdb.com/api/v2/check",
        headers={"Key": abuse_key, "Accept": "application/json"},
        params={"ipAddress": ip, "maxAgeInDays": 90}
    )
    if abuse_resp.status_code == 200:
        result.abuse_confidence = abuse_resp.json()["data"]["abuseConfidenceScore"]

    # Berechnung des zusammengesetzten Vertrauenswerts
    result.confidence_score = min(
        (result.vt_malicious / max(result.vt_total, 1)) * 60 +
        (result.abuse_confidence / 100) * 40, 100
    )

    return result

def enrich_hash(sha256: str, vt_key: str) -> EnrichmentResult:
    result = EnrichmentResult(sha256, "sha256")
    vt_resp = requests.get(
        f"https://www.virustotal.com/api/v3/files/{sha256}",
        headers={"x-apikey": vt_key}
    )
    if vt_resp.status_code == 200:
        stats = vt_resp.json()["data"]["attributes"]["last_analysis_stats"]
        result.vt_malicious = stats.get("malicious", 0)
        result.vt_total = sum(stats.values())
        result.confidence_score = int((result.vt_malicious / max(result.vt_total, 1)) * 100)
    return result

Schritt 3: SOAR-Playbook erstellen (Cortex XSOAR)

Erstellen Sie in Cortex XSOAR ein Anreicherungs-Playbook:

  1. Auslöser: Alarm in SIEM erstellt (via Webhook oder Polling)
  2. IOCs extrahieren: Verwenden Sie die Aufgabe "Indikatoren extrahieren" mit Regex-Mustern für IP, Domain, URL, Hash
  3. Parallele Anreicherung: Verzweigen Sie gleichzeitig zu mehreren Anreicherungsaufgaben
  4. VT-Anreicherung: Rufen Sie die Befehle !vt-file-scan oder !vt-ip-scan auf
  5. AbuseIPDB-Prüfung: Rufen Sie den Befehl !abuseipdb-check-ip auf
  6. MISP-Suche: Rufen Sie !misp-search für Querverweise auf
  7. Score-Aggregation: Python-Transformationsaufgabe zur Berechnung des zusammengesetzten Scores
  8. Bedingte Weiterleitung: Wenn Score ≥70 → Hohe Prioritätswarteschlange; wenn 40–69 → Mittel; <40 → Automatisch schließen mit Hinweis
  9. Alarmanreicherung: Schreiben Sie Anreicherungsergebnisse in den Alarmkontext für die Analystenansicht

Schritt 4: Ratenbegrenzungen und Fehlerbehandlung

import time
from functools import wraps

def rate_limited(max_per_second):
    min_interval = 1.0 / max_per_second
    def decorator(func):
        last_called = [0.0]
        @wraps(func)
        def wrapper(*args, **kwargs):
            elapsed = time.time() - last_called[0]
            wait = min_interval - elapsed
            if wait > 0:
                time.sleep(wait)
            result = func(*args, **kwargs)
            last_called[0] = time.time()
            return result
        return wrapper
    return decorator

def retry_on_429(max_retries=3):
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            for attempt in range(max_retries):
                response = func(*args, **kwargs)
                if response.status_code == 429:
                    retry_after = int(response.headers.get("Retry-After", 60))
                    time.sleep(retry_after)
                else:
                    return response
        return wrapper
    return decorator

Schritt 5: Metriken und Optimierung

Verfolgen Sie die Pipeline-Leistung wöchentlich:

  • Anreicherungslatenz: Ziel <30 Sekunden von Alarmauslösung bis zur angereicherten Ausgabe
  • API-Erfolgsrate: Ziel >99% (Ratenbegrenzungs- oder Ausfallereignisse identifizieren)
  • True-Positive-Rate: Verfolgen Sie Analysten-Übersteuerungen automatisierter Vertrauenswerte
  • Kosten: Verfolgen Sie das API-Aufrufvolumen im Vergleich zum Budget (VT Enterprise: $X pro 1 Mio. Suchanfragen)

Schlüsselkonzepte

BegriffDefinition
SOARSecurity Orchestration, Automation, and Response – Plattform zur Automatisierung von Sicherheitsworkflows und Integration verschiedener Tools
Anreicherungs-PlaybookAutomatisierte Workflow-Sequenz, die rohen Sicherheitsereignissen kontextbezogene Intelligenz hinzufügt
RatenbegrenzungAPI-Anbieter-Beschränkungen der Anforderungshäufigkeit (z. B. VT kostenlos: 4 Anfragen/Minute); Pipelines müssen diese Grenzen einhalten
Zusammengesetzter VertrauenswertEinzelner Wert, der Signale aus mehreren Anreicherungsquellen mittels gewichteter Formel aggregiert
Fan-out-MusterParallele Ausführung mehrerer Anreicherungsabfragen, um die Gesamtanreicherungslatenz zu minimieren

Tools und Systeme

  • Cortex XSOAR (Palo Alto): Enterprise SOAR mit über 700 Marktplatzintegrationen, einschließlich VT, MISP, Shodan und AbuseIPDB
  • Splunk SOAR (Phantom): SOAR-Plattform mit Python-basierten Playbooks; native Splunk-SIEM-Integration
  • Tines: No-Code-SOAR-Plattform mit Webhook-gesteuerter Automatisierung; kostengünstig für kleinere Teams
  • TheHive + Cortex: Open-Source-IR-/Anreicherungsplattform mit Observable-Anreicherung über Cortex-Analysatoren

Häufige Fallstricke

  • Blockieren aufgrund von Anreicherungslatenz: Wenn die Anreicherung länger als 5 Minuten dauert, beginnen Analysten mit der Bearbeitung nicht angereicherter Alarme, was den Zweck zunichtemacht. Setzen Sie Zeitübergrenzen und liefern Sie Teilergebnisse.
  • Kein Caching: Das 50-malige Abfragen desselben IOCs verursacht unnötige API-Kosten. Zwischenspeichern Sie Anreicherungsergebnisse standardmäßig für 24 Stunden.
  • Stilles Ignorieren von API-Fehlern: Fehlgeschlagene Anreicherungsaufrufe sollten protokolliert werden und Fallback-Logik auslösen, nicht stillschweigend leere Ergebnisse liefern, die als saubere IOCs erscheinen.
  • Automatisieren von Blockaden allein basierend auf Anreicherungswerten: Zusammengesetzte Werte enthalten Fehlalarme; erfordern Sie menschliche Bestätigung für Blockierungsentscheidungen gegen gemeinsam genutzte Infrastruktur.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

abusing-dpapi-for-credential-access

Extract and decrypt Windows DPAPI-protected secrets (Credential Manager, browser logins/cookies, Wi-Fi credentials, KeePass keys) online or offline using SharpDPAPI, SharpChrome, Mimikatz, or Impacket

abusing-shadow-credentials-for-privesc

Take over Active Directory accounts by writing attacker-controlled public keys to msDS-KeyCredentialLink (Shadow Credentials) with pyWhisker, Whisker, or Certipy, then authenticate via PKINIT to recover the target

achieving-cmmc-level-2-compliance

>-

acquiring-disk-image-with-dd-and-dcfldd

Create forensically sound bit-for-bit disk images with dd or dcfldd on a Linux forensic workstation, preserving evidence integrity through hash verification (MD5/SHA) during acquisition. Use when imaging a suspect drive, USB device, or memory card for investigation, preserving volatile disk evidence during incident response, or producing a verified copy for legal or law-enforcement proceedings before any destructive analysis.

analyzing-active-directory-acl-abuse

Detect dangerous ACL misconfigurations in Active Directory using ldap3

analyzing-android-malware-with-apktool

Perform static analysis of Android APK malware using apktool for resource decompilation, jadx for Java source recovery, and androguard for manifest inspection, dangerous permission-combination detection, and identification of obfuscated code, dynamic code loading, and reflection-based API calls. Use to statically triage a suspicious APK without executing it or to build mobile malware detection rules.

analyzing-api-gateway-access-logs

Parses API Gateway access logs (AWS API Gateway, Kong, Nginx) to detect

analyzing-apt-group-with-mitre-navigator

Query ATT&CK data with attackcti, mitreattack-python, and stix2, then build MITRE ATT&CK Navigator layers and multi-layer heatmap overlays mapping one or more APT groups

analyzing-azure-activity-logs-for-threats

Queries Azure Monitor activity logs and sign-in logs via azure-monitor-query

analyzing-bootkit-and-rootkit-samples

Analyzes bootkit and advanced rootkit malware infecting the Master

analyzing-browser-forensics-with-hindsight

Parse Chromium-based browser databases with Hindsight to extract and correlate browsing history, downloads, cookies, cached content, autofill data, saved passwords, and extensions from Chrome, Edge, Brave, Opera, and Vivaldi into a unified timeline (XLSX, JSON, or SQLite output). Use during incident response, insider-threat investigations, or criminal cases when you need to reconstruct a user

analyzing-campaign-attribution-evidence

Systematically evaluate cyber-campaign evidence to attribute an operation to a threat actor, using the Diamond Model and Analysis of Competing Hypotheses (ACH) to weigh infrastructure overlaps, TTP consistency, malware code similarity, and timing/language artifacts into confidence-weighted attribution assessments. Use when an incident investigation needs a defensible attribution confidence level.

analyzing-certificate-transparency-for-phishing

Monitor Certificate Transparency logs using crt.sh and Certstream to

analyzing-cloud-storage-access-patterns

Detect abnormal access in AWS S3, GCS, and Azure Blob Storage by analyzing CloudTrail Data Events, GCS audit logs, and Azure Storage Analytics for after-hours bulk downloads, new-IP access, and API-call spikes (e.g. GetObject) via statistical baselines and time-series anomaly detection. Use when investigating suspected cloud data exfiltration or building related detection rules.

analyzing-cobalt-strike-beacon-configuration

Extract and analyze Cobalt Strike beacon configuration from PE files

analyzing-cobaltstrike-malleable-c2-profiles

Parse and analyze Cobalt Strike Malleable C2 profiles with dissect.cobaltstrike (profiles and beacon-payload configs) and pyMalleableC2 (AST parsing) to extract HTTP/DNS transforms, URIs, headers, sleep/jitter, and injection behavior, then generate network detection signatures. Use when reverse-engineering a captured malleable profile or building detections against Cobalt Strike Beacon traffic.

analyzing-command-and-control-communication

Analyzes malware C2 communication over HTTP, HTTPS, DNS, and custom

analyzing-cyber-kill-chain

Analyzes intrusion activity against the Lockheed Martin Cyber Kill Chain

analyzing-disk-image-with-autopsy

Perform comprehensive forensic analysis of raw (dd), E01, or AFF disk images with Autopsy and The Sleuth Kit, recovering deleted files, examining metadata and embedded artifacts, keyword searching, and building investigation timelines with visual reports. Use for structured analysis of a forensic disk image or when stakeholders need visual reports from evidence.

analyzing-dns-logs-for-exfiltration

Analyzes DNS query logs to detect data exfiltration via DNS tunneling,

Verwandte Skills