#!/usr/bin/env python3
"""Lateral movement detection agent using Zeek logs and Windows event analysis."""
import json
import os
import re
import sys
from collections import Counter, defaultdict
from datetime import datetime
try:
import Evtx.Evtx as evtx
HAS_EVTX = True
except ImportError:
HAS_EVTX = False
LATERAL_MOVEMENT_EVENT_IDS = {
"4624": "Successful Logon",
"4625": "Failed Logon",
"4648": "Logon with Explicit Credentials",
"4672": "Special Privileges Assigned",
"7045": "New Service Installed",
}
SUSPICIOUS_LOGON_TYPES = {"3": "Network", "10": "RemoteInteractive (RDP)"}
def parse_zeek_conn_log(log_path):
"""Parse Zeek conn.log for internal lateral movement patterns."""
if not os.path.exists(log_path):
return {"error": f"Zeek conn.log not found: {log_path}"}
connections = defaultdict(lambda: {"count": 0, "ports": Counter(), "bytes": 0})
with open(log_path, "r") as f:
for line in f:
if line.startswith("#"):
continue
fields = line.strip().split("\t")
if len(fields) < 10:
continue
src_ip = fields[2] if len(fields) > 2 else ""
dst_ip = fields[4] if len(fields) > 4 else ""
dst_port = fields[5] if len(fields) > 5 else ""
resp_bytes = int(fields[9]) if len(fields) > 9 and fields[9] != "-" else 0
if src_ip.startswith(("10.", "172.16.", "192.168.")) and dst_ip.startswith(("10.", "172.16.", "192.168.")):
key = f"{src_ip}->{dst_ip}"
connections[key]["count"] += 1
connections[key]["ports"][dst_port] += 1
connections[key]["bytes"] += resp_bytes
lateral_indicators = []
for pair, info in connections.items():
smb_count = info["ports"].get("445", 0) + info["ports"].get("139", 0)
rdp_count = info["ports"].get("3389", 0)
winrm_count = info["ports"].get("5985", 0) + info["ports"].get("5986", 0)
psexec_count = info["ports"].get("445", 0)
if smb_count > 0 or rdp_count > 0 or winrm_count > 0:
src, dst = pair.split("->")
lateral_indicators.append({
"source": src, "destination": dst,
"total_connections": info["count"],
"smb_connections": smb_count,
"rdp_connections": rdp_count,
"winrm_connections": winrm_count,
"total_bytes": info["bytes"],
"risk": "HIGH" if smb_count > 10 or rdp_count > 5 else "MEDIUM",
})
lateral_indicators.sort(key=lambda x: x["total_connections"], reverse=True)
return {"total_internal_pairs": len(connections), "lateral_indicators": lateral_indicators[:30]}
def parse_zeek_smb_log(log_path):
"""Parse Zeek smb_mapping.log for file share access patterns."""
if not os.path.exists(log_path):
return {"error": f"SMB log not found: {log_path}"}
mappings = []
with open(log_path, "r") as f:
for line in f:
if line.startswith("#"):
continue
fields = line.strip().split("\t")
if len(fields) >= 6:
mappings.append({
"timestamp": fields[0],
"source": fields[2] if len(fields) > 2 else "",
"destination": fields[4] if len(fields) > 4 else "",
"share": fields[5] if len(fields) > 5 else "",
})
share_counts = Counter(m.get("share", "") for m in mappings)
src_counts = Counter(m.get("source", "") for m in mappings)
return {
"total_mappings": len(mappings),
"top_shares": share_counts.most_common(10),
"top_sources": src_counts.most_common(10),
"recent": mappings[-20:],
}
def analyze_windows_auth_logs(evtx_path):
"""Analyze Windows Security EVTX for lateral movement indicators."""
if not HAS_EVTX:
return {"error": "python-evtx not installed (pip install python-evtx)"}
if not os.path.exists(evtx_path):
return {"error": f"EVTX file not found: {evtx_path}"}
network_logons = []
failed_logons = []
explicit_creds = []
new_services = []
with evtx.Evtx(evtx_path) as log:
for record in log.records():
try:
xml = record.xml()
for eid, desc in LATERAL_MOVEMENT_EVENT_IDS.items():
if f"{eid}" in xml:
entry = {
"event_id": eid,
"description": desc,
"timestamp": record.timestamp().isoformat(),
}
if eid == "4624":
logon_type_match = re.search(r"(\d+)", xml)
if logon_type_match and logon_type_match.group(1) in SUSPICIOUS_LOGON_TYPES:
entry["logon_type"] = logon_type_match.group(1)
network_logons.append(entry)
elif eid == "4625":
failed_logons.append(entry)
elif eid == "4648":
explicit_creds.append(entry)
elif eid == "7045":
new_services.append(entry)
break
except Exception:
continue
return {
"network_logons": len(network_logons),
"failed_logons": len(failed_logons),
"explicit_credential_use": len(explicit_creds),
"new_services_installed": len(new_services),
"recent_network_logons": network_logons[-20:],
"recent_failures": failed_logons[-20:],
"new_services": new_services[-10:],
}
def detect_pass_the_hash_pattern(events):
"""Detect pass-the-hash indicators from auth events."""
alerts = []
by_source = defaultdict(list)
for e in events:
src = e.get("source", e.get("source_ip", ""))
by_source[src].append(e)
for src, src_events in by_source.items():
unique_dests = set(e.get("destination", e.get("dest_ip", "")) for e in src_events)
if len(unique_dests) > 5:
alerts.append({
"type": "PASS_THE_HASH_CANDIDATE",
"severity": "HIGH",
"source": src,
"unique_destinations": len(unique_dests),
"destinations": list(unique_dests)[:20],
"event_count": len(src_events),
})
return alerts
def generate_report(zeek_log_dir=None, evtx_path=None):
"""Generate comprehensive lateral movement detection report."""
report = {"timestamp": datetime.utcnow().isoformat() + "Z"}
if zeek_log_dir:
conn_log = os.path.join(zeek_log_dir, "conn.log")
smb_log = os.path.join(zeek_log_dir, "smb_mapping.log")
report["zeek_connections"] = parse_zeek_conn_log(conn_log)
report["zeek_smb"] = parse_zeek_smb_log(smb_log)
if evtx_path:
report["windows_auth"] = analyze_windows_auth_logs(evtx_path)
return report
if __name__ == "__main__":
action = sys.argv[1] if len(sys.argv) > 1 else "help"
if action == "zeek-conn" and len(sys.argv) > 2:
print(json.dumps(parse_zeek_conn_log(sys.argv[2]), indent=2, default=str))
elif action == "zeek-smb" and len(sys.argv) > 2:
print(json.dumps(parse_zeek_smb_log(sys.argv[2]), indent=2, default=str))
elif action == "windows" and len(sys.argv) > 2:
print(json.dumps(analyze_windows_auth_logs(sys.argv[2]), indent=2, default=str))
elif action == "report":
zeek_dir = sys.argv[2] if len(sys.argv) > 2 else None
evtx_file = sys.argv[3] if len(sys.argv) > 3 else None
print(json.dumps(generate_report(zeek_dir, evtx_file), indent=2, default=str))
else:
print("Usage: agent.py [zeek-conn |zeek-smb |windows |report [zeek_dir] [evtx]]")