Communitygithub.com

Erstellung von Erkennungsregeln mit Sigma

Erstellt herstellerneutrale Erkennungsregeln im Sigma-Regelformat für plattformübergreifende SIEM-Nutzung.

Was ist Erstellung von Erkennungsregeln mit Sigma?

Dieses Skill beschreibt den gesamten Workflow zur Erstellung, Validierung und Bereitstellung von herstellerneutralen Erkennungsregeln mit dem Sigma-Regelformat. Sigma ermöglicht es SOC-Ingenieuren, eine einzige Regel in YAML zu schreiben und diese automatisch in verschiedene SIEM-Abfragesprachen wie Splunk SPL, Elasticsearch Lucene oder Microsoft Sentinel KQL zu konvertieren. Der Skill behandelt alle notwendigen Schritte: von der Definition der Erkennungslogik basierend auf Threat Intelligence und MITRE ATT&CK-Mapping, über die Validierung der Regelsyntax mit pySigma, bis hin zur Konvertierung in zielspezifische Abfragen und der Bereitstellung in Produktions-SIEMs. Besonderes Augenmerk liegt auf der Integration in CI/CD-Pipelines, der False-Positive-Analyse und der Versionierung der Regeln in Git. Der Skill unterstützt die gängigsten SIEM-Plattformen und nutzt die offizielle Sigma-Regelbibliothek mit über 3.000 Community-Regeln. Er eignet sich besonders für Teams, die Detection-as-Code-Praktiken einführen oder ihre Erkennungsabdeckung über mehrere SIEM-Plattformen hinweg standardisieren möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/main/skills/building-detection-rules-with-sigma

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Erstellung von Erkennungsregeln mit Sigma?

Verwendung

Verwenden Sie dieses Skill, wenn:

  • SOC-Ingenieure portable Erkennungsregeln für mehrere SIEM-Plattformen erstellen müssen
  • Threat-Intelligence-Berichte TTPs beschreiben, die eine neue Erkennungsabdeckung erfordern
  • Vorhandene herstellerspezifische Regeln in ein teilbares Format standardisiert werden sollen
  • Das Team Sigma als Detection-as-Code-Standard in CI/CD-Pipelines übernimmt

Nicht verwenden für Echtzeit-Streaming-Erkennung (Sigma ist für Batch-/geplante Suchvorgänge) oder wenn das Ziel-SIEM native Erkennungsfunktionen hat, die Sigma nicht ausdrücken kann (z.B. Splunk RBA-Risikobewertung).

Voraussetzungen

  • Python 3.8+ mit pySigma und passendem Backend (pySigma-backend-splunk, pySigma-backend-elasticsearch, pySigma-backend-microsoft365defender)
  • Sigma-Regelrepository geklont: git clone https://github.com/SigmaHQ/sigma.git
  • Kenntnisse des MITRE ATT&CK-Frameworks für Technik-Zuordnung
  • Verständnis der Feldzuordnungen der Ziel-SIEM-Logquellen

Arbeitsablauf

Schritt 1: Erkennungslogik aus Threat Intelligence definieren

Beginnen Sie mit einem Threat-Bericht oder einer ATT&CK-Technik. Beispiel: Erkennung von Mimikatz Credential Dumping (T1003.001 — LSASS-Speicher):

title: Mimikatz Credential Dumping via LSASS Access
id: 0d894093-71bc-43c3-8d63-bf520e73a7c5
status: stable
level: high
description: Detects process accessing lsass.exe memory, indicative of credential dumping tools like Mimikatz
references:
    - https://attack.mitre.org/techniques/T1003/001/
    - https://github.com/gentilkiwi/mimikatz
author: mahipal
date: 2024/03/15
modified: 2024/03/15
tags:
    - attack.credential_access
    - attack.t1003.001
logsource:
    category: process_access
    product: windows
detection:
    selection:
        TargetImage|endswith: '\lsass.exe'
        GrantedAccess|contains:
            - '0x1010'
            - '0x1038'
            - '0x1fffff'
            - '0x40'
    filter_main_svchost:
        SourceImage|endswith: '\svchost.exe'
    filter_main_csrss:
        SourceImage|endswith: '\csrss.exe'
    filter_main_wininit:
        SourceImage|endswith: '\wininit.exe'
    condition: selection and not 1 of filter_main_*
falsepositives:
    - Legitimate security tools accessing LSASS
    - Windows Defender scanning
    - CrowdStrike Falcon sensor

Schritt 2: Sigma-Regelsyntax validieren

Verwenden Sie sigma check, um die Regel zu validieren:

# Installieren von pySigma und Validatoren
pip install pySigma pySigma-validators-sigmaHQ

# Regel validieren
sigma check rule.yml

Alternativ mit Python validieren:

from sigma.rule import SigmaRule
from sigma.validators.core import SigmaValidator

rule = SigmaRule.from_yaml(open("rule.yml").read())
validator = SigmaValidator()
issues = validator.validate_rule(rule)
for issue in issues:
    print(f"{issue.severity}: {issue.message}")

Schritt 3: In Ziel-SIEM-Abfrage konvertieren

In Splunk SPL konvertieren:

from sigma.rule import SigmaRule
from sigma.backends.splunk import SplunkBackend
from sigma.pipelines.splunk import splunk_windows_pipeline

pipeline = splunk_windows_pipeline()
backend = SplunkBackend(pipeline)

rule = SigmaRule.from_yaml(open("rule.yml").read())
splunk_query = backend.convert_rule(rule)
print(splunk_query[0])

Ausgabe:

TargetImage="*\\lsass.exe" (GrantedAccess="*0x1010*" OR GrantedAccess="*0x1038*"
OR GrantedAccess="*0x1fffff*" OR GrantedAccess="*0x40*")
NOT (SourceImage="*\\svchost.exe") NOT (SourceImage="*\\csrss.exe")
NOT (SourceImage="*\\wininit.exe")

In Elastic Abfrage (Lucene) konvertieren:

from sigma.backends.elasticsearch import LuceneBackend
from sigma.pipelines.elasticsearch import ecs_windows_pipeline

pipeline = ecs_windows_pipeline()
backend = LuceneBackend(pipeline)
elastic_query = backend.convert_rule(rule)
print(elastic_query[0])

In Microsoft Sentinel KQL konvertieren:

from sigma.backends.microsoft365defender import Microsoft365DefenderBackend

backend = Microsoft365DefenderBackend()
kql_query = backend.convert_rule(rule)
print(kql_query[0])

Schritt 4: Mit MITRE ATT&CK abbilden und Abdeckungsmetadaten hinzufügen

Taggen Sie jede Regel mit ATT&CK-Technik-IDs im Feld tags:

tags:
    - attack.credential_access        # Taktik
    - attack.t1003.001                # Sub-Technik
    - attack.t1003                    # Übergeordnete Technik

Verfolgen Sie die Erkennungsabdeckung mit dem ATT&CK Navigator:

import json

# ATT&CK Navigator-Layer aus Sigma-Regeln generieren
layer = {
    "name": "SOC Detection Coverage",
    "versions": {"attack": "14", "navigator": "4.9", "layer": "4.5"},
    "domain": "enterprise-attack",
    "techniques": []
}

# Sigma-Regelverzeichnis nach Technik-Tags durchsuchen
import os
from sigma.rule import SigmaRule

for root, dirs, files in os.walk("sigma/rules/windows/"):
    for f in files:
        if f.endswith(".yml"):
            rule = SigmaRule.from_yaml(open(os.path.join(root, f)).read())
            for tag in rule.tags:
                if str(tag).startswith("attack.t"):
                    technique_id = str(tag).replace("attack.", "").upper()
                    layer["techniques"].append({
                        "techniqueID": technique_id,
                        "color": "#31a354",
                        "score": 1
                    })

with open("coverage_layer.json", "w") as f:
    json.dump(layer, f, indent=2)

Schritt 5: Regel mit Beispieldaten testen

Erstellen Sie Testdaten und validieren Sie, dass die Regel die erwarteten Ereignisse erfasst:

# Sigma-Testframework verwenden
sigma test rule.yml --target splunk --pipeline splunk_windows

# Oder manuell in Splunk mit Beispieldaten testen
# Sysmon process_access-Log mit bekannter Mimikatz-Signatur hochladen

Validieren Sie die False-Positive-Rate, indem Sie die Regel 7 Tage lang gegen Produktionsdaten in einer nicht alarmierenden gespeicherten Suche ausführen.

Schritt 6: In Produktions-SIEM bereitstellen

Stellen Sie die konvertierte Abfrage als geplante Suche oder Korrelationsregel bereit:

Splunk ES-Korrelationssuche:

| tstats summariesonly=true count from datamodel=Endpoint.Processes
  where Processes.process_name="*\\lsass.exe"
  by Processes.src, Processes.user, Processes.process_name, Processes.parent_process_name
| `drop_dm_object_name(Processes)`
| where count > 0

Elastic Security-Regel (TOML-Format):

[rule]
name = "LSASS Memory Access - Credential Dumping"
description = "Detects suspicious access to LSASS process memory"
risk_score = 73
severity = "high"
type = "eql"
query = '''
process where event.action == "access" and
  process.name == "lsass.exe" and
  not process.executable : ("*\\svchost.exe", "*\\csrss.exe")
'''

[rule.threat]
framework = "MITRE ATT&CK"
[[rule.threat.technique]]
id = "T1003"
name = "OS Credential Dumping"

Schritt 7: Versionskontrolle und CI/CD-Integration

Speichern Sie Regeln in Git mit automatisierten Tests:

# .github/workflows/sigma-ci.yml
name: Sigma Rule CI
on: [push, pull_request]
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - run: pip install pySigma pySigma-validators-sigmaHQ
      - run: sigma check rules/
      - run: sigma convert -t splunk -p splunk_windows rules/ > /dev/null

Schlüsselkonzepte

BegriffDefinition
SigmaHerstellerneutrales Erkennungsregelformat (YAML-basiert), das mittels Backends in SIEM-spezifische Abfragen kompiliert
pySigmaPython-Bibliothek, die das alte sigmac für Regelkonvertierung, Validierung und Pipeline-Verarbeitung ersetzt
BackendpySigma-Plugin, das die Sigma-Erkennungslogik in eine Abfragesprache der Zielplattform (SPL, KQL, Lucene) übersetzt
PipelineFeldzuordnungskonfiguration, die generische Sigma-Feldnamen in SIEM-spezifische Feldnamen übersetzt
LogsourceSigma-Regelabschnitt, der die Kategorie (process_creation, network_connection) und das Produkt (windows, linux) der Zieldaten definiert
Detection-as-CodePraxis der Verwaltung von Erkennungsregeln in der Versionskontrolle mit CI/CD-Tests und automatisierter Bereitstellung

Werkzeuge und Systeme

  • SigmaHQ: Offizielles Sigma-Regelrepository mit über 3.000 Community-gepflegten Erkennungsregeln auf GitHub
  • pySigma: Python-basiertes Sigma-Regelverarbeitungsframework mit modularen Backends und Pipelines
  • ATT&CK Navigator: MITRE-Tool zur Visualisierung der Erkennungsabdeckung, kartiert auf ATT&CK-Techniken
  • Uncoder.IO: Webbasierter Sigma-Regelkonverter mit Unterstützung für über 30 SIEM-Plattformen zur schnellen Übersetzung

Häufige Szenarien

  • Neue CVE-Erkennung: Sigma-Regel für Exploit-Indikatoren schreiben (z.B. Log4Shell JNDI-Lookup-Muster in Web-Logs)
  • Hunting-Regel-Promotion: Ad-hoc Splunk-Hunting-Abfrage in Sigma-Regel für fortlaufende automatisierte Erkennung konvertieren
  • Multi-SIEM-Migration: Konvertierung von über 500 Splunk-Korrelationssuchen in Sigma für die Migration zu Elastic Security
  • Purple-Team-Output: Red-Team-Ergebnisse in Sigma-Regeln für sofortige defensive Abdeckung konvertieren
  • Threat-Intel-Operationalisierung: Transformierung IOC-basierter Threat-Berichte in verhaltensorientierte Sigma-Regeln

Ausgabeformat

SIGMA REGEL-BEREITSTELLUNGSBERICHT
━━━━━━━━━━━━━━━━━━━━━━━━━━━
Regel-ID:      0d894093-71bc-43c3-8d63-bf520e73a7c5
Titel:         Mimikatz Credential Dumping via LSASS Access
ATT&CK:        T1003.001 - LSASS Memory
Schweregrad:   Hoch
Status:        In Produktion bereitgestellt

Konvertierungen:
  Splunk SPL:    BESTANDEN — Gespeicherte Suche "sigma_lsass_access" erstellt
  Elastic EQL:   BESTANDEN — Erkennungsregel-ID elastic-0d894093 aktiviert
  Sentinel KQL:  BESTANDEN — Analytische Regel mittels ARM-Vorlage bereitgestellt

Tests:
  True Positives:    4/4 Testfälle übereinstimmend
  False Positives:   2 im 7-Tage-Backtest (svchost-Grenzfall — Filter hinzugefügt)
  Leistung:          Durchschnittliche Ausführung 3,2 s bei 50 Mio. Ereignissen/Tag

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