A comprehensive Windows security auditing and threat detection toolkit. Features 58 production-ready PowerShell functions organized into 14 modules for enterprise-grade security assessment, compliance validation, and incident response.
PowerShell
Restructure README (features first) and fix 3 audit-found bugs
Okan YILDIZ8ac3a3df088e
diff --git a/Analysis/Get-EventLogAnalysis.ps1 b/Analysis/Get-EventLogAnalysis.ps1index b7d1134..3e2f982 100644--- a/Analysis/Get-EventLogAnalysis.ps1+++ b/Analysis/Get-EventLogAnalysis.ps1@@ -104,6 +104,12 @@ function Get-EventLogAnalysis {if ($IncludeWarnings) {$filterLevels += 3 # Warning}++ # Security audit events (1102, 4625, 4697, ...) are logged at+ # Information level, so the Security log must include Level 4+ if ($logName -eq 'Security' -and $filterLevels -notcontains 4) {+ $filterLevels += 4 # Information (Security audit events)+ }try {$events = Get-WinEvent -FilterHashtable @{diff --git a/Forensics/Get-ExecutionArtifacts.ps1 b/Forensics/Get-ExecutionArtifacts.ps1index f412658..b222569 100644--- a/Forensics/Get-ExecutionArtifacts.ps1+++ b/Forensics/Get-ExecutionArtifacts.ps1@@ -146,27 +146,65 @@ function Get-ExecutionArtifacts {try {# Decode ROT13 encoded entry name$decodedName = ConvertFrom-ROT13 -Text $entry-+# Get execution data$value = Get-ItemProperty -Path $countPath -Name $entry -ErrorAction SilentlyContinue-+# Skip if not an executable pathif ($decodedName -notmatch '\.(exe|bat|cmd|ps1|vbs|js)') {continue}-++ # Decode the binary value (Win7+ format is >= 68 bytes:+ # run count Int32 at offset 4, last-run FILETIME Int64 at offset 60)+ $timestamp = $null+ $runCount = $null+ $timestampNote = $null++ $uaBytes = $null+ if ($null -ne $value -and $value.PSObject.Properties.Name -contains $entry) {+ $uaBytes = $value.$entry+ }++ if ($uaBytes -is [byte[]] -and $uaBytes.Length -ge 68) {+ try {+ $runCount = [BitConverter]::ToInt32($uaBytes, 4)+ $fileTime = [BitConverter]::ToInt64($uaBytes, 60)+ $decoded = [DateTime]::FromFileTimeUtc($fileTime).ToLocalTime()+ # Plausibility check: 2000-01-01 .. now + 1 day+ if ($decoded -ge [DateTime]'2000-01-01' -and $decoded -le (Get-Date).AddDays(1)) {+ $timestamp = $decoded+ }+ else {+ $timestampNote = 'Decoded timestamp outside plausible range'+ }+ }+ catch {+ $timestampNote = 'Could not decode UserAssist timestamp'+ }+ }+ elseif ($uaBytes -is [byte[]]) {+ # Vista/XP 16-byte variant carries no timestamp+ $timestampNote = 'No timestamp (legacy 16-byte format)'+ }+ else {+ $timestampNote = 'No binary data available'+ }+$results.Artifacts += [PSCustomObject]@{Source = 'UserAssist'ExecutableName = Split-Path -Path $decodedName -LeafFullPath = $decodedName- Timestamp = Get-Date # UserAssist timestamp parsing is complex, using current time- TimestampType = 'Tracked'+ Timestamp = $timestamp+ TimestampType = 'Last Executed (UserAssist)'Details = @{EncodedName = $entryDecodedPath = $decodedName+ RunCount = $runCount+ TimestampNote = $timestampNote}}-+$results.Summary.UserAssist++}catch {@@ -258,19 +296,44 @@ function Get-ExecutionArtifacts {elseif ($props.PSObject.Properties.Name -contains 'RecentItems') {$appPath = $props.RecentItems}-++ # RecentApps stores LastActivatedTime as a FILETIME QWORD;+ # FeatureUsage\AppSwitched has no timestamp - do not fabricate one+ $timestamp = $null+ $timestampType = 'Recent Activity'+ $timestampNote = 'No timestamp recorded by this source'++ if ($null -ne $props -and $props.PSObject.Properties.Name -contains 'LastActivatedTime' -and $null -ne $props.LastActivatedTime) {+ try {+ $decoded = [DateTime]::FromFileTimeUtc([int64]$props.LastActivatedTime).ToLocalTime()+ # Plausibility check: 2000-01-01 .. now + 1 day+ if ($decoded -ge [DateTime]'2000-01-01' -and $decoded -le (Get-Date).AddDays(1)) {+ $timestamp = $decoded+ $timestampType = 'Last Activated'+ $timestampNote = $null+ }+ else {+ $timestampNote = 'Decoded timestamp outside plausible range'+ }+ }+ catch {+ $timestampNote = 'Could not decode LastActivatedTime'+ }+ }+if ($appName -or $appPath) {$results.Artifacts += [PSCustomObject]@{Source = 'RecentApps'ExecutableName = $appNameFullPath = $appPath- Timestamp = Get-Date- TimestampType = 'Recent Activity'+ Timestamp = $timestamp+ TimestampType = $timestampTypeDetails = @{RegistryPath = $app.PSPath+ TimestampNote = $timestampNote}}-+$results.Summary.RecentApps++}}@@ -309,10 +372,32 @@ function Get-ExecutionArtifacts {}$execPath = $property.Name-- # Extract timestamp from binary data (simplified)- $timestamp = Get-Date # Full parsing requires binary conversion-++ # BAM binary value: first 8 bytes are the last-execution FILETIME+ $timestamp = $null+ $timestampNote = $null++ $bamBytes = $property.Value+ if ($bamBytes -is [byte[]] -and $bamBytes.Length -ge 8) {+ try {+ $fileTime = [BitConverter]::ToInt64($bamBytes, 0)+ $decoded = [DateTime]::FromFileTimeUtc($fileTime).ToLocalTime()+ # Plausibility check: 2000-01-01 .. now + 1 day+ if ($decoded -ge [DateTime]'2000-01-01' -and $decoded -le (Get-Date).AddDays(1)) {+ $timestamp = $decoded+ }+ else {+ $timestampNote = 'Decoded timestamp outside plausible range'+ }+ }+ catch {+ $timestampNote = 'Could not decode BAM timestamp'+ }+ }+ else {+ $timestampNote = 'No binary data available'+ }+if ($execPath -match '\.(exe|bat|cmd|ps1)$') {$results.Artifacts += [PSCustomObject]@{Source = 'BAM'@@ -322,9 +407,10 @@ function Get-ExecutionArtifacts {TimestampType = 'Last Execution (BAM)'Details = @{UserSID = Split-Path -Path $user.PSPath -Leaf+ TimestampNote = $timestampNote}}-+$results.Summary.BAM++}}@@ -416,7 +502,7 @@ function Get-ExecutionArtifacts {Where-Object { $_.ExecutableName -notlike 'ShimCache*' } |Select-Object -First 15 |ForEach-Object {- $timestamp = $_.Timestamp.ToString('yyyy-MM-dd HH:mm:ss')+ $timestamp = if ($null -ne $_.Timestamp) { $_.Timestamp.ToString('yyyy-MM-dd HH:mm:ss') } else { 'N/A' }$color = switch ($_.Source) {'Prefetch' { 'Cyan' }'UserAssist' { 'Yellow' }@@ -523,7 +609,7 @@ function Generate-ExecutionArtifactsHTML {foreach ($artifact in $Results.Artifacts) {$sourceClass = "source-$($artifact.Source.ToLower())"- $timestamp = $artifact.Timestamp.ToString('yyyy-MM-dd HH:mm:ss')+ $timestamp = if ($null -ne $artifact.Timestamp) { $artifact.Timestamp.ToString('yyyy-MM-dd HH:mm:ss') } else { 'N/A' }$fullPath = if ($artifact.FullPath) {$artifact.FullPath -replace '<', '<' -replace '>', '>'} else {diff --git a/README.md b/README.mdindex 8c8d95e..d6d4bdf 100644--- a/README.md+++ b/README.md@@ -10,7 +10,6 @@[](https://github.com/okanyildiz/WindowsSecurityAudit)[](https://github.com/okanyildiz/WindowsSecurityAudit/actions/workflows/ci.yml)[](https://github.com/okanyildiz/WindowsSecurityAudit/blob/main/tests/WindowsSecurityAudit.Tests.ps1)-[](https://github.com/okanyildiz/WindowsSecurityAudit)[](https://github.com/okanyildiz/WindowsSecurityAudit/stargazers)[](https://github.com/okanyildiz/WindowsSecurityAudit/network/members)@@ -20,91 +19,34 @@**🎯 Zero Dependencies • 🚀 Production Ready • 🌍 Community Driven • 💼 Enterprise Tested**-[What's New](#-whats-new) • [Features](#-why-windows-security-audit-module) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Support](#-support--contact)+[Features](#-full-feature-overview) • [Why](#-why-windows-security-audit-module) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Release Highlights](#-release-highlights) • [Support](#-support--contact)</div>----## ✨ What's New+## 🧰 Full Feature Overview-### 🆕 v1.3.0 — Version-Exact CVEs, MISP/TAXII & Auto-Remediation--**2 new functions** — bringing the toolkit to **65 functions across 14 modules**:--| Function | Module | What It Does |-|----------|--------|--------------|-| **`Resolve-CpeName`** | Vulnerability | Resolve an installed product to a **CPE 2.3 name** via a curated offline mapping table (~35 common products), an optional **NVD CPE API** lookup (`-UseOnlineLookup -ApiKey`), or a heuristic guess (always **Low** confidence) — returns `CpeName`, `MatchedBy`, `Confidence` and `Version` |-| **`Invoke-SecurityRemediation`** | Hardening | Close the finding→fix loop: consume an `Invoke-SecurityAssessment` JSON (or piped findings), apply a **curated map of 7 safe remediations** (firewall profiles, UAC, Defender RTP, SMBv1, Guest account, PS script block logging, RDP NLA) **WhatIf-first** with `SupportsShouldProcess`/`ConfirmImpact=High`, optional `-GenerateRollback` script capturing pre-change state — unmatched findings go to `ManualReview`, never improvised |+**65 functions across 14 modules** — the complete toolkit at a glance:-**Wired-up parameters on existing functions:**+| Module | Functions | Scope |+|--------|:---------:|-------|+| 🧱 **Core Security** | 5 | Security baseline scoring (0-100), system inventory, SFC/DISM integrity checks, Event ID context, baseline drift diffing |+| 🕵️ **Detection** | 4 | Persistence mechanisms, suspicious processes, network anomalies, authentication attacks |+| 🔬 **Analysis** | 4 | Deep-dive analysis of event logs, registry, process memory, and file system |+| 🚨 **Response** | 3 | Incident response orchestration, forensic evidence collection, HTML/JSON/CSV report export |+| 🏢 **Enterprise** | 4 | Multi-system parallel scanning, full assessment orchestration, scheduled scans with Teams/Slack/email alerts |+| 🔒 **Hardening** | 4 | Audit policies, PowerShell security, baseline enforcement, curated auto-remediation (WhatIf-first, with rollback) |+| 🛡️ **Windows Defender** | 3 | Defender health monitoring, custom scans, configuration optimization |+| 🎯 **Threat Hunting** | 7 | APT indicators, data exfiltration, lateral movement, LOLBins, ATT&CK mapping/Navigator export, threat intel (MISP/TAXII/STIX) |+| ✅ **Compliance** | 5 | CIS Benchmark, NIST 800-53, PCI-DSS 4.0 validation, compliance reports, audit evidence export |+| 🌳 **Active Directory** | 6 | AD backdoors & DCSync detection, vulnerability scan, stale objects, password policies, privileged accounts, posture |+| 🩹 **Vulnerability** | 8 | CVE assessment (real NVD data + version-exact CPE matching), EOL software, exposed services, certificates, patches |+| 🔍 **Forensics** | 5 | Memory dumps, artifact collection, execution artifacts (prefetch/UserAssist/BAM), USB history, forensic timelines |+| ☁️ **Cloud Security** | 3 | Azure AD risky sign-ins, M365 security posture, cloud compliance status |+| 📊 **Reporting** | 4 | Security metrics/KPIs, executive reports, live HTML dashboards, consolidated all-module Chart.js report |-- `Get-VulnerabilityAssessment -ExactCVEMatch` — resolve each installed product to a CPE name and query NVD for **version-exact CVE matches** (implies `-CheckCVEs`, reuses `-NVDApiKey`/`-MaxCVEChecks`); High/Medium-confidence CPE matches query via `Get-NVDCveData -CpeName`, results attach as `ExactCVEs` per application with `MatchStatus` (`CpeMatched`/`NoCpeMapping`) plus `TotalExactCVEs` and per-severity counts in the summary-- `Get-ThreatIntelligence -MISPUrl -MISPApiKey` — pull indicators from a **MISP** instance via `attributes/restSearch` (key sent only as a request header)-- `Get-ThreatIntelligence -TaxiiServerUrl -TaxiiCollection [-TaxiiUsername -TaxiiPassword]` — pull STIX indicators from a **TAXII 2.x** server (discovery → collections → objects; password is a `SecureString`, sent only as a Basic auth header)-- `Get-ThreatIntelligence -StixFilePath` — import a local **STIX 2.x bundle** fully offline; regex extraction of ipv4-addr/domain-name/url/file-hash patterns — all sources share the existing cache, entry-cap and provenance machinery--**Quality infrastructure:**--- 🧪 **353 Pester tests** (`tests/WindowsSecurityAudit.Tests.ps1`) — new coverage for v1.3 parameter help, secret-handling AST checks (no API keys in log output, `SecureString` TAXII password), and remediation safety (ShouldProcess gating, ManualReview routing)--### v1.2.0 — Live Threat Feeds & Real CVE Integration--**1 new function** — bringing the toolkit to **63 functions across 14 modules**:--| Function | Module | What It Does |-|----------|--------|--------------|-| **`Get-NVDCveData`** | Vulnerability | Query the **NVD API 2.0** by keyword or CPE name and get normalized CVE objects (ID, severity, CVSS score, dates, references) — with pagination, rate-limit handling and optional API key for higher limits |--**Wired-up parameters on existing functions:**--- `Get-VulnerabilityAssessment -CheckCVEs -NVDApiKey -MaxCVEChecks` — match installed software against **real NVD CVE data** (keyword-based candidate matching, capped by `-MaxCVEChecks`, default 10); matched CVEs attach as `RealCVEs` on each Software item plus summary counts-- `Get-ThreatIntelligence -UpdateFeeds -FeedCachePath -FeedMaxAgeHours -MaxFeedEntries -AbuseIPDBApiKey` — merge **live abuse.ch feeds** (URLhaus payload URLs, Feodo Tracker C2 IPs) plus the optional **AbuseIPDB** blacklist (with API key) into the IOC database, with freshness-aware caching, offline fallback and per-feed `Summary.FeedStats`--**Quality infrastructure:**--- 🧪 **333 Pester tests** (`tests/WindowsSecurityAudit.Tests.ps1`) covering the public API surface, API-key hygiene, and offline feed behavior--### v1.1.0 — Baseline Drift, Scheduled Scans, ATT&CK Navigator & Consolidated Reports--**4 new functions** added to the toolkit:--| Function | Module | What It Does |-|----------|--------|--------------|-| **`Compare-SecurityBaseline`** | Core | Detect configuration drift by diffing two security baselines — Improved/Degraded/New/Removed classification with JSON/CSV export |-| **`Register-ScheduledSecurityScan`** | Enterprise | Automate recurring scans (daily/weekly/monthly) via Scheduled Tasks with **Teams/Slack webhook** and email alerting on Critical findings |-| **`Export-AttackNavigatorLayer`** | Threat Hunting | Export hunt findings as a **MITRE ATT&CK Navigator layer** (JSON v4.x) with severity-based scoring and colors — visualize coverage in one click |-| **`New-ConsolidatedReport`** | Reporting | Generate a **single interactive Chart.js HTML report** combining results from all modules, with offline mode from saved JSON |--**Wired-up parameters on existing functions:**--- `Invoke-SecurityAssessment -IncludeCompliance` — now runs CIS, NIST 800-53, and PCI-DSS checks as part of the assessment-- `Get-ExposedServices -CustomPorts` — scan your own port list beyond the built-in attack-surface checks-- `Get-ComplianceReport -IncludeEvidence` — bundle audit-ready evidence directly into compliance reports-- `New-ExecutiveReport -CustomLogo` — brand executive reports with your organization's logo-- `Export-SecurityReport -IncludeCharts` — embed visual charts in exported reports--**Quality infrastructure:**--- 🧪 **Pester test suite** (`tests/WindowsSecurityAudit.Tests.ps1`) covering the public API surface (now 333 tests)-- ⚙️ **GitHub Actions CI** (`.github/workflows/ci.yml`) on windows-latest: PSScriptAnalyzer Error gate, module import verified under both **PowerShell 7 (pwsh)** and **Windows PowerShell 5.1**, plus the full Pester suite--### 📦 Already in the Toolbox (v1.0.0)--Everything below shipped with the original release and keeps getting sharper:--| Category | Highlights |-|----------|------------|-| **Core Security** | `Get-SecurityBaseline` (0-100 posture score), `Get-SystemInfo`, `Test-SystemIntegrity` (SFC/DISM), `Get-EventIdDescription` |-| **Threat Detection** | Persistence mechanisms, suspicious processes, network anomalies, authentication attacks (brute force, pass-the-hash) |-| **Threat Hunting** | APT indicators, data exfiltration, lateral movement, LOLBins abuse, MITRE ATT&CK mapping, IOC matching (incl. custom IOC files) |-| **Compliance** | CIS Benchmark, NIST 800-53, PCI-DSS 4.0 validation with audit-ready evidence export |-| **Vulnerability Management** | CVE assessment, EOL software, exposed services, certificate health, patch compliance |-| **Active Directory** | Backdoor & DCSync detection, privileged account audit, stale objects, password policies, security posture |-| **Forensics & Response** | Memory dumps, USB history, execution artifacts, forensic timelines, one-command incident response |-| **Enterprise & Reporting** | Multi-system parallel scanning, executive reports, live HTML dashboards, security metrics & KPIs |-| **Cloud Security** | Azure AD risky sign-ins, M365 security posture, cloud compliance status |-| **Hardening** | Audit policies, PowerShell security (logging, transcription), security baseline enforcement — all with `-WhatIf` support |+> 👇 **Deep dive per module below** — full function-by-function tables in [Module Categories - Detailed Breakdown](#-module-categories---detailed-breakdown).---@@ -354,13 +296,17 @@ WindowsSecurityAudit/## 📥 Installation-### Method 1: PowerShell Gallery (Recommended)+### Method 1: Git Clone (Recommended)```powershell-# Install from PowerShell Gallery-Install-Module -Name WindowsSecurityAudit -Scope CurrentUser -Force+# Clone repository+git clone https://github.com/okanyildiz/WindowsSecurityAudit.git+cd WindowsSecurityAudit-# Import the module-Import-Module WindowsSecurityAudit+# Import the module directly from the clone+Import-Module ".\WindowsSecurityAudit.psd1" -Force++# Or run the smoke test+.\Test-Module.ps1# Verify installation - should return 65(Get-Command -Module WindowsSecurityAudit).Count@@ -411,17 +357,15 @@ Import-Module ".\WindowsSecurityAudit-main\WindowsSecurityAudit.psd1" -Force> from inside the extracted ZIP folder fails with "no valid module file was found in> any module directory" unless you use the path-based import shown above.-### Method 4: Git Clone (For Developers)-```powershell-# Clone repository-git clone https://github.com/okanyildiz/WindowsSecurityAudit.git-cd WindowsSecurityAudit+### Method 4: PowerShell Gallery (Coming soon)+> **Note:** The module is **not yet published** to the PowerShell Gallery — `Install-Module -Name WindowsSecurityAudit` currently returns a 404. Use Method 1, 2 or 3 above until the gallery release lands.-# Import the module directly from the clone-Import-Module ".\WindowsSecurityAudit.psd1" -Force+```powershell+# Once published, installation will be:+Install-Module -Name WindowsSecurityAudit -Scope CurrentUser -Force-# Or run the smoke test-.\Test-Module.ps1+# Import the module+Import-Module WindowsSecurityAudit```### Troubleshooting@@ -533,10 +477,10 @@ The Detection module provides real-time threat identification capabilities using| Function | Purpose | Detection Capabilities | Risk Indicators ||----------|---------|------------------------|-----------------|-| **`Find-PersistenceMechanisms`** | Identifies malware persistence techniques across the system | • 11+ Registry autorun locations (Run, RunOnce, etc.)<br>• Scheduled Tasks (hidden, system, unusual)<br>• Windows Services (unsigned, suspicious paths)<br>• WMI Event Subscriptions<br>• Startup folders (all users, system)<br>• DLL hijacking opportunities | High: Unknown entries<br>Medium: Unsigned binaries<br>Low: Unusual locations |+| **`Find-PersistenceMechanisms`** | Identifies malware persistence techniques across the system | • 11+ Registry autorun locations (Run, RunOnce, etc.)<br>• Scheduled Tasks (hidden, system, unusual)<br>• Windows Services (unsigned, suspicious paths)<br>• WMI Event Subscriptions<br>• Startup folders (all users, system) | High: Unknown entries<br>Medium: Unsigned binaries<br>Low: Unusual locations || **`Find-SuspiciousProcesses`** | Detects malicious process behaviors and anomalies | • Unsigned or invalid signatures<br>• Execution from temporary directories<br>• Encoded PowerShell commands<br>• Process injection indicators<br>• Unusual parent-child relationships<br>• Network connections to suspicious IPs | Critical: Known malware<br>High: Injection detected<br>Medium: Unsigned from temp || **`Find-NetworkAnomalies`** | Identifies abnormal network communications | • Connections to known C2 servers<br>• Non-standard port usage<br>• DNS tunneling indicators<br>• Large data transfers<br>• Tor/proxy connections<br>• Suspicious protocol usage | Critical: Known C2<br>High: DNS tunneling<br>Medium: Unusual ports |-| **`Find-SuspiciousAuthentication`** | Detects authentication attacks and anomalies | • Brute force attempts (multiple failures)<br>• Pass-the-hash indicators<br>• Golden/Silver ticket detection<br>• After-hours authentication<br>• Impossible travel scenarios<br>• Service account anomalies | Critical: Pass-the-hash<br>High: Brute force<br>Medium: After hours |+| **`Find-SuspiciousAuthentication`** | Detects authentication attacks and anomalies | • Brute force attempts (multiple failures)<br>• Account lockout patterns<br>• After-hours authentication<br>• Explicit-credential logons (runas / net use)<br>• Impossible travel scenarios<br>• Service account anomalies | High: Brute force<br>Medium: After hours<br>Low: Explicit credentials |---@@ -548,7 +492,7 @@ The Analysis module performs deep forensic examination of system components to u|----------|---------|---------------------|--------------|| **`Get-EventLogAnalysis`** | Deep analysis of Windows event logs for security insights | • Security log correlation (4624, 4625, 4672)<br>• PowerShell operational log analysis<br>• System log anomalies<br>• Application error patterns<br>• Custom XML query execution<br>• Timeline reconstruction | Authentication patterns<br>Privilege escalations<br>System modifications<br>PowerShell abuse || **`Get-RegistryAnalysis`** | Examines registry for malicious modifications | • Autorun entry validation<br>• Security policy tampering<br>• Browser helper objects<br>• Shell extensions<br>• Recent document tracking<br>• User activity artifacts | Persistence mechanisms<br>Policy bypasses<br>User behaviors<br>Malware artifacts |-| **`Get-MemoryAnalysis`** | Analyzes process memory for advanced threats | • Process injection detection<br>• Hollowing identification<br>• Memory pattern matching<br>• String extraction<br>• Suspicious allocations<br>• Fileless malware indicators | Injected code<br>Credential theft<br>Rootkit presence<br>APT indicators |+| **`Get-MemoryAnalysis`** | Analyzes process memory for advanced threats | • Process injection heuristic indicators<br>• Hollowing heuristic indicators<br>• Memory pattern matching<br>• String extraction<br>• Suspicious allocations<br>• Fileless malware indicators | Injected code<br>Credential theft<br>Rootkit presence<br>APT indicators || **`Get-FileSystemAnalysis`** | Comprehensive file system security analysis | • Alternate Data Stream detection<br>• Hidden file discovery<br>• Suspicious extensions<br>• Recent file modifications<br>• Ransomware indicators<br>• Permission auditing | Hidden malware<br>Data staging<br>Exfiltration prep<br>Ransomware signs |---@@ -561,7 +505,7 @@ The Response module provides automated incident response capabilities, enabling|----------|---------|------------------|----------------|| **`Invoke-IncidentResponse`** | Orchestrates automated incident response procedures | • Threat containment (process termination)<br>• System isolation (network disconnection)<br>• Evidence preservation<br>• User notification<br>• Backup initiation<br>• Recovery planning | Response timeline<br>Actions taken<br>System state<br>Threat indicators || **`Invoke-ForensicCollection`** | Systematically collects forensic evidence | • Memory dump acquisition<br>• Network state capture<br>• Registry snapshot<br>• Event log extraction<br>• File artifact collection<br>• Browser history preservation | Memory dumps<br>Network captures<br>System artifacts<br>User data |-| **`Export-SecurityReport`** | Generates professional security reports | • HTML interactive dashboards<br>• PDF executive summaries<br>• JSON for SIEM integration<br>• CSV for data analysis<br>• XML for compliance tools<br>• Markdown for documentation | Multi-format reports<br>Executive summaries<br>Technical details<br>Recommendations |+| **`Export-SecurityReport`** | Generates professional security reports | • HTML interactive dashboards<br>• JSON for SIEM integration<br>• CSV for data analysis | Multi-format reports<br>Executive summaries<br>Technical details<br>Recommendations |---@@ -625,7 +569,7 @@ The Compliance module automates security framework validation and generates audi| Function | Purpose | Frameworks Supported | Automation Level ||----------|---------|---------------------|------------------|-| **`Test-CISBenchmark`** | Validates CIS security controls | • CIS Level 1 (Basic)<br>• CIS Level 2 (High Security)<br>• 100+ control points<br>• Windows 10/11/Server<br>• Remediation scripts<br>• Detailed scoring | 95% automated<br>Pass/Fail/NA results<br>Evidence collection |+| **`Test-CISBenchmark`** | Validates CIS security controls | • CIS Level 1 (Basic)<br>• ~20 automated Level 1 checks<br>• Windows 10/11/Server<br>• Remediation scripts<br>• Detailed scoring | Automated pass/fail results<br>Evidence collection || **`Test-NISTCompliance`** | Assesses NIST 800-53 controls | • Access Control (AC)<br>• Audit & Accountability (AU)<br>• System Integrity (SI)<br>• Incident Response (IR)<br>• Risk Assessment (RA)<br>• Control families mapping | Control validation<br>Gap analysis<br>Maturity scoring || **`Test-PCI-DSS`** | Validates PCI-DSS requirements | • Network segmentation<br>• Access control<br>• Encryption validation<br>• Log monitoring<br>• Vulnerability management<br>• Security testing | Requirement mapping<br>Evidence generation<br>SAQ support || **`Get-ComplianceReport`** | Generates comprehensive compliance reports | • Multi-framework dashboard<br>• Executive summaries<br>• Technical evidence<br>• Gap analysis<br>• Remediation roadmap<br>• Trend analysis | Professional reports<br>Audit-ready format<br>Action plans |@@ -640,7 +584,7 @@ The Active Directory module provides specialized security assessment for AD envi| Function | Purpose | Security Checks | Risk Areas ||----------|---------|-----------------|------------|| **`Find-ADVulnerabilities`** | Comprehensive AD vulnerability scanning | • Kerberoasting targets (SPNs)<br>• ASREP roasting accounts<br>• Weak ACLs and permissions<br>• Unconstrained delegation<br>• Trust vulnerabilities<br>• GPO security issues | Account compromise<br>Privilege escalation<br>Lateral movement |-| **`Find-ADBackdoors`** | Detects persistence in Active Directory | • AdminSDHolder modifications<br>• DCSync permissions<br>• SID history abuse<br>• Golden/Silver tickets<br>• Skeleton key indicators<br>• Shadow credentials | Domain persistence<br>Privileged access<br>Stealth backdoors |+| **`Find-ADBackdoors`** | Detects persistence in Active Directory | • AdminSDHolder modifications<br>• DCSync permissions (replication ACLs)<br>• SID history abuse<br>• Delegation misconfigurations<br>• Shadow credentials | Domain persistence<br>Privileged access<br>Stealth backdoors || **`Find-StaleADObjects`** | Identifies unused AD objects for cleanup | • Inactive user accounts<br>• Stale computer objects<br>• Empty security groups<br>• Orphaned objects<br>• Disabled accounts<br>• Service account audit | Attack surface reduction<br>Compliance cleanup<br>Performance improvement || **`Test-ADSecurityPosture`** | Evaluates overall AD security health | • Password policy strength<br>• Kerberos configuration<br>• LDAP signing/channel binding<br>• Trust relationships<br>• LAPS deployment<br>• Tier model implementation | Domain hardening<br>Best practices<br>Security maturity || **`Get-ADPasswordPolicy`** | Analyzes password security settings | • Default domain policy<br>• Fine-grained policies<br>• Complexity requirements<br>• History enforcement<br>• Lockout thresholds<br>• Expiration settings | Weak passwords<br>Brute force risk<br>Compliance gaps |@@ -671,9 +615,9 @@ The Forensics module provides digital forensic capabilities for incident investi| Function | Purpose | Forensic Capabilities | Evidence Types ||----------|---------|----------------------|----------------|-| **`Export-MemoryDump`** | Captures memory for analysis | • Full memory dump<br>• Process-specific dumps<br>• Minidump creation<br>• Hibernation file<br>• Page file extraction<br>• Crash dump analysis | RAM contents<br>Running processes<br>Network connections<br>Encryption keys |-| **`Get-ArtifactCollection`** | Collects forensic artifacts | • Browser history (all browsers)<br>• Download history<br>• Temporary files<br>• Recycle bin contents<br>• Jump lists<br>• Thumbnail cache | User activity<br>File access<br>Internet activity<br>Deleted items |-| **`Get-ExecutionArtifacts`** | Traces program execution | • Prefetch analysis<br>• Amcache parsing<br>• ShimCache examination<br>• UserAssist decoding<br>• RecentDocs<br>• BAM/DAM analysis | Program execution<br>Timestamps<br>Frequency<br>User attribution |+| **`Export-MemoryDump`** | Captures memory for analysis | • Full memory dump<br>• Process-specific dumps<br>• Minidump creation<br>• Crash dump analysis | RAM contents<br>Running processes<br>Network connections<br>Encryption keys |+| **`Get-ArtifactCollection`** | Collects forensic artifacts | • Browser history (all browsers)<br>• Download history<br>• Temporary files<br>• Thumbnail cache | User activity<br>File access<br>Internet activity<br>Deleted items |+| **`Get-ExecutionArtifacts`** | Traces program execution | • Prefetch analysis<br>• ShimCache examination<br>• UserAssist decoding<br>• RecentDocs<br>• BAM/DAM analysis | Program execution<br>Timestamps<br>Frequency<br>User attribution || **`Get-USBHistory`** | USB device forensics | • Device enumeration<br>• First/Last connection<br>• Serial numbers<br>• Volume names<br>• Drive letters<br>• User correlation | Device usage<br>Data transfer<br>Timeline<br>User activity || **`New-ForensicTimeline`** | Timeline reconstruction | • Multi-source correlation<br>• Event sequencing<br>• File system timeline<br>• Registry timeline<br>• Log correlation<br>• Visual timeline generation | Incident timeline<br>Attack chain<br>User actions<br>System events |@@ -698,12 +642,96 @@ The Reporting module transforms raw security data into actionable intelligence t| Function | Purpose | Report Types | Delivery Formats ||----------|---------|--------------|------------------|| **`Get-SecurityMetrics`** | Collects and calculates KPIs/KRIs | • Security scores<br>• Threat statistics<br>• Compliance rates<br>• Vulnerability metrics<br>• Trend analysis<br>• Benchmarking data | JSON metrics<br>Time-series data<br>Comparison charts |-| **`New-ExecutiveReport`** | Creates C-level presentations | • Risk matrices<br>• Business impact analysis<br>• Trend visualization<br>• Key findings<br>• Recommendations<br>• Action items | PDF presentation<br>PowerPoint<br>HTML dashboard |+| **`New-ExecutiveReport`** | Creates C-level presentations | • Risk matrices<br>• Business impact analysis<br>• Trend visualization<br>• Key findings<br>• Recommendations<br>• Action items | HTML dashboard<br>PDF (requires wkhtmltopdf) || **`New-SecurityDashboard`** | Interactive security dashboard | • Real-time metrics<br>• Drill-down charts<br>• Heat maps<br>• Risk indicators<br>• Compliance status<br>• Alert summary | HTML5 responsive<br>Auto-refresh<br>Export capable || **`New-ConsolidatedReport`** | Single interactive report combining all modules | • All-module data collection<br>• Chart.js severity doughnut<br>• Category score bar charts<br>• Offline mode from saved JSON<br>• Section status tracking<br>• Raw data export | Self-contained HTML<br>Interactive charts<br>JSON export |---+## 📰 Release Highlights++The full feature set is documented in the module tables above — this section only covers what changed per release, newest first:++### 🆕 v1.3.0 — Version-Exact CVEs, MISP/TAXII & Auto-Remediation++**2 new functions** — bringing the toolkit to **65 functions across 14 modules**:++| Function | Module | What It Does |+|----------|--------|--------------|+| **`Resolve-CpeName`** | Vulnerability | Resolve an installed product to a **CPE 2.3 name** via a curated offline mapping table (~35 common products), an optional **NVD CPE API** lookup (`-UseOnlineLookup -ApiKey`), or a heuristic guess (always **Low** confidence) — returns `CpeName`, `MatchedBy`, `Confidence` and `Version` |+| **`Invoke-SecurityRemediation`** | Hardening | Close the finding→fix loop: consume an `Invoke-SecurityAssessment` JSON (or piped findings), apply a **curated map of 7 safe remediations** (firewall profiles, UAC, Defender RTP, SMBv1, Guest account, PS script block logging, RDP NLA) **WhatIf-first** with `SupportsShouldProcess`/`ConfirmImpact=High`, optional `-GenerateRollback` script capturing pre-change state — unmatched findings go to `ManualReview`, never improvised |++**Wired-up parameters on existing functions:**++- `Get-VulnerabilityAssessment -ExactCVEMatch` — resolve each installed product to a CPE name and query NVD for **version-exact CVE matches** (implies `-CheckCVEs`, reuses `-NVDApiKey`/`-MaxCVEChecks`); High/Medium-confidence CPE matches query via `Get-NVDCveData -CpeName`, results attach as `ExactCVEs` per application with `MatchStatus` (`CpeMatched`/`NoCpeMapping`) plus `TotalExactCVEs` and per-severity counts in the summary+- `Get-ThreatIntelligence -MISPUrl -MISPApiKey` — pull indicators from a **MISP** instance via `attributes/restSearch` (key sent only as a request header)+- `Get-ThreatIntelligence -TaxiiServerUrl -TaxiiCollection [-TaxiiUsername -TaxiiPassword]` — pull STIX indicators from a **TAXII 2.x** server (discovery → collections → objects; password is a `SecureString`, sent only as a Basic auth header)+- `Get-ThreatIntelligence -StixFilePath` — import a local **STIX 2.x bundle** fully offline; regex extraction of ipv4-addr/domain-name/url/file-hash patterns — all sources share the existing cache, entry-cap and provenance machinery++**Quality infrastructure:**++- 🧪 **353 Pester tests** (`tests/WindowsSecurityAudit.Tests.ps1`) — new coverage for v1.3 parameter help, secret-handling AST checks (no API keys in log output, `SecureString` TAXII password), and remediation safety (ShouldProcess gating, ManualReview routing)++### v1.2.0 — Live Threat Feeds & Real CVE Integration++**1 new function** — bringing the toolkit to **63 functions across 14 modules**:++| Function | Module | What It Does |+|----------|--------|--------------|+| **`Get-NVDCveData`** | Vulnerability | Query the **NVD API 2.0** by keyword or CPE name and get normalized CVE objects (ID, severity, CVSS score, dates, references) — with pagination, rate-limit handling and optional API key for higher limits |++**Wired-up parameters on existing functions:**++- `Get-VulnerabilityAssessment -CheckCVEs -NVDApiKey -MaxCVEChecks` — match installed software against **real NVD CVE data** (keyword-based candidate matching, capped by `-MaxCVEChecks`, default 10); matched CVEs attach as `RealCVEs` on each Software item plus summary counts+- `Get-ThreatIntelligence -UpdateFeeds -FeedCachePath -FeedMaxAgeHours -MaxFeedEntries -AbuseIPDBApiKey` — merge **live abuse.ch feeds** (URLhaus payload URLs, Feodo Tracker C2 IPs) plus the optional **AbuseIPDB** blacklist (with API key) into the IOC database, with freshness-aware caching, offline fallback and per-feed `Summary.FeedStats`++**Quality infrastructure:**++- 🧪 **333 Pester tests** (`tests/WindowsSecurityAudit.Tests.ps1`) covering the public API surface, API-key hygiene, and offline feed behavior++### v1.1.0 — Baseline Drift, Scheduled Scans, ATT&CK Navigator & Consolidated Reports++**4 new functions** added to the toolkit:++| Function | Module | What It Does |+|----------|--------|--------------|+| **`Compare-SecurityBaseline`** | Core | Detect configuration drift by diffing two security baselines — Improved/Degraded/New/Removed classification with JSON/CSV export |+| **`Register-ScheduledSecurityScan`** | Enterprise | Automate recurring scans (daily/weekly/monthly) via Scheduled Tasks with **Teams/Slack webhook** and email alerting on Critical findings |+| **`Export-AttackNavigatorLayer`** | Threat Hunting | Export hunt findings as a **MITRE ATT&CK Navigator layer** (JSON v4.x) with severity-based scoring and colors — visualize coverage in one click |+| **`New-ConsolidatedReport`** | Reporting | Generate a **single interactive Chart.js HTML report** combining results from all modules, with offline mode from saved JSON |++**Wired-up parameters on existing functions:**++- `Invoke-SecurityAssessment -IncludeCompliance` — now runs CIS, NIST 800-53, and PCI-DSS checks as part of the assessment+- `Get-ExposedServices -CustomPorts` — scan your own port list beyond the built-in attack-surface checks+- `Get-ComplianceReport -IncludeEvidence` — bundle audit-ready evidence directly into compliance reports+- `New-ExecutiveReport -CustomLogo` — brand executive reports with your organization's logo+- `Export-SecurityReport -IncludeCharts` — embed visual charts in exported reports++**Quality infrastructure:**++- 🧪 **Pester test suite** (`tests/WindowsSecurityAudit.Tests.ps1`) covering the public API surface (now 333 tests)+- ⚙️ **GitHub Actions CI** (`.github/workflows/ci.yml`) on windows-latest: PSScriptAnalyzer Error gate, module import verified under both **PowerShell 7 (pwsh)** and **Windows PowerShell 5.1**, plus the full Pester suite++### 📦 Already in the Toolbox (v1.0.0)++Everything below shipped with the original release and keeps getting sharper:++| Category | Highlights |+|----------|------------|+| **Core Security** | `Get-SecurityBaseline` (0-100 posture score), `Get-SystemInfo`, `Test-SystemIntegrity` (SFC/DISM), `Get-EventIdDescription` |+| **Threat Detection** | Persistence mechanisms, suspicious processes, network anomalies, authentication attacks (brute force, lockouts, after-hours) |+| **Threat Hunting** | APT indicators, data exfiltration, lateral movement, LOLBins abuse, MITRE ATT&CK mapping, IOC matching (incl. custom IOC files) |+| **Compliance** | CIS Benchmark, NIST 800-53, PCI-DSS 4.0 validation with audit-ready evidence export |+| **Vulnerability Management** | CVE assessment, EOL software, exposed services, certificate health, patch compliance |+| **Active Directory** | Backdoor & DCSync detection, privileged account audit, stale objects, password policies, security posture |+| **Forensics & Response** | Memory dumps, USB history, execution artifacts, forensic timelines, one-command incident response |+| **Enterprise & Reporting** | Multi-system parallel scanning, executive reports, live HTML dashboards, security metrics & KPIs |+| **Cloud Security** | Azure AD risky sign-ins, M365 security posture, cloud compliance status |+| **Hardening** | Audit policies, PowerShell security (logging, transcription), security baseline enforcement — all with `-WhatIf` support |++---+## 🎯 Use Case Scenarios### For Security Operations Centers (SOC)diff --git a/ThreatHunting/Find-LateralMovement.ps1 b/ThreatHunting/Find-LateralMovement.ps1index ec1fd15..4b8a73b 100644--- a/ThreatHunting/Find-LateralMovement.ps1+++ b/ThreatHunting/Find-LateralMovement.ps1@@ -279,21 +279,39 @@ function Find-LateralMovement {} -MaxEvents 200 -ErrorAction SilentlyContinueif ($shareEvents) {- # Filter for non-admin shares- $suspiciousShares = $shareEvents | Where-Object {+ # Split share access: admin/hidden shares (IPC$, ADMIN$, C$, ...)+ # are the PRIMARY lateral movement signal; other shares are noise+ $adminShareEvents = @($shareEvents | Where-Object {$shareName = $_.Properties[7].Value- $shareName -notmatch 'IPC\$|ADMIN\$|C\$'- }-- if ($suspiciousShares) {- $groupedShares = $suspiciousShares | Group-Object -Property {+ $shareName -match 'IPC\$|ADMIN\$|[A-Za-z]\$'+ })+ $otherShareEvents = @($shareEvents | Where-Object {+ $shareName = $_.Properties[7].Value+ $shareName -notmatch 'IPC\$|ADMIN\$|[A-Za-z]\$'+ })++ $shareSets = @(+ @{ Events = $adminShareEvents; Severity = 'High'; Label = 'Admin share' }+ @{ Events = $otherShareEvents; Severity = 'Low'; Label = 'Share' }+ )++ $foundShares = $false++ foreach ($shareSet in $shareSets) {+ if ($shareSet.Events.Count -eq 0) {+ continue+ }++ $foundShares = $true++ $groupedShares = $shareSet.Events | Group-Object -Property {"$($_.Properties[1].Value)|$($_.Properties[7].Value)"} | Sort-Object Count -Descending-+foreach ($group in $groupedShares | Select-Object -First 5) {$parts = $group.Name -split '\|'$event = $group.Group[0]-+$indicator = [PSCustomObject]@{Type = 'SMBAccess'Process = 'N/A'@@ -301,17 +319,24 @@ function Find-LateralMovement {Account = $parts[0]ShareName = $parts[1]Count = $group.Count- Severity = 'Low'- Description = "SMB share access: $($parts[1]) by $($parts[0]) - $($group.Count) times"+ Severity = $shareSet.Severity+ Description = "$($shareSet.Label) access: $($parts[1]) by $($parts[0]) - $($group.Count) times"Timestamp = $event.TimeCreated.ToString("yyyy-MM-dd HH:mm:ss")}-+$results.Indicators.SMBAccess += $indicator-- Write-Host " [!] Share: $($parts[1]) by $($parts[0]) ($($group.Count) times)" -ForegroundColor Yellow++ if ($shareSet.Severity -eq 'High') {+ $results.Summary.HighFindings+++ Write-Host " [!] ADMIN SHARE: $($parts[1]) by $($parts[0]) ($($group.Count) times)" -ForegroundColor Red+ }+ else {+ Write-Host " [!] Share: $($parts[1]) by $($parts[0]) ($($group.Count) times)" -ForegroundColor Yellow+ }}}- else {++ if (-not $foundShares) {Write-Host " No suspicious SMB share access detected" -ForegroundColor Green}}