Files
mukul975 27c6414ca5 Add folder anatomy (scripts/agent.py + references/api-reference.md) for 648 cybersecurity skills
Complete skill folder anatomy across all cybersecurity skills:
- scripts/agent.py: 80-150 line Python agents using real libraries (impacket,
  boto3, azure-mgmt-*, kubernetes, pefile, yara, scapy, shodan, stix2, etc.)
- references/api-reference.md: real API documentation with method signatures
- LICENSE: MIT license for all skill folders
2026-03-10 21:02:12 +01:00

54 lines
1.6 KiB
Markdown

# API Reference: Breach and Attack Simulation Agent
## Dependencies
| Library | Version | Purpose |
|---------|---------|---------|
| requests | >=2.28 | HTTP client for SIEM detection validation |
## CLI Usage
```bash
python scripts/agent.py \
--target 10.0.1.50 \
--siem-url https://siem.example.com \
--siem-key YOUR_KEY \
--output-dir /reports/
```
## Functions
### `simulate_technique(technique, target) -> dict`
Simulates a MITRE ATT&CK technique and records detection/blocked status.
### `check_siem_detection(siem_url, api_key, technique_id, time_window) -> dict`
Queries SIEM API for alerts matching the simulated technique within time window.
### `compute_detection_coverage(results) -> dict`
Calculates overall detection rate and per-tactic coverage breakdown.
### `generate_report(target, siem_url, siem_key) -> dict`
Runs 7 ATT&CK technique simulations and generates detection gap report.
## ATT&CK Techniques Tested
| ID | Name | Tactic |
|----|------|--------|
| T1566.001 | Spearphishing Attachment | Initial Access |
| T1059.001 | PowerShell | Execution |
| T1003.001 | LSASS Memory | Credential Access |
| T1021.002 | SMB Admin Shares | Lateral Movement |
| T1486 | Data Encrypted for Impact | Impact |
| T1071.001 | Web Protocols | C2 |
| T1048.003 | Exfiltration Over Unencrypted | Exfiltration |
## Output Schema
```json
{
"coverage": {"total_tests": 7, "detected": 5, "missed": 2, "detection_rate_pct": 71.4},
"gaps": [{"technique_id": "T1003.001", "technique_name": "LSASS Memory"}],
"recommendations": ["Create detection rule for T1003.001"]
}
```