# sandler73/windows-security-audit-project architecture

> Architecture diagram of the GitHub repository sandler73/windows-security-audit-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sandler73/windows-security-audit-project
- Repository: https://github.com/sandler73/windows-security-audit-project

## Overview

The product is a self-contained PowerShell tool for assessing Windows security against multiple compliance frameworks and producing audit results and remediation guidance. The main documented workflow is an administrator running an audit, selecting framework checks, and receiving reports; additional capabilities include parallel execution, baseline drift comparison, rollback generation, Group Policy export, and remediation bundles. Source excerpts were not provided, so links below are limited to capabilities and relationships stated in the README; internal call ownership could not be verified.

Main entry points: [`Windows-Security-Audit.ps1`](https://github.com/sandler73/windows-security-audit-project/blob/main/Windows-Security-Audit.ps1) (Audit entry point), [`Modules`](https://github.com/sandler73/windows-security-audit-project/tree/main/Modules) (Compliance modules), [`Modules/Module-Core.ps1`](https://github.com/sandler73/windows-security-audit-project/blob/main/Modules/Module-Core.ps1) (Core checks), [`Shared_Components/audit-pipeline.ps1`](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/audit-pipeline.ps1) (Audit pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Audit execution"]
  node_runner["Audit entry point"]
  node_frameworks["Compliance modules"]
end

subgraph group_assessment["Assessment capabilities"]
  node_core["Core checks<br/>[Module-Core.ps1]"]
  node_profiles["Audit profiles<br/>[profiles.ps1]"]
  node_hostfacts["Host facts<br/>[host-facts.ps1]"]
  node_assessments["Shared assessments"]
  node_attack["Attack surface<br/>[attack-surface.ps1]"]
  node_pipeline["Audit pipeline<br/>[audit-pipeline.ps1]"]
  node_auditcommon["Audit common<br/>[audit-common.ps1]"]
  node_baselines["Baseline comparison"]
end

subgraph group_remediation["Remediation"]
  node_remediation["Remediation library"]
  node_canonical["Canonical remediations"]
  node_bundles["Remediation bundles"]
  node_rollback["Rollback scripts"]
end

subgraph group_reporting["Reporting"]
  node_reports["Audit reports"]
end

node_administrator(("Administrator"))

node_administrator -->|"runs audit"| node_runner
node_runner -->|"runs checks"| node_frameworks
node_runner -->|"generates reports"| node_reports
node_runner -.->|"compares drift"| node_baselines
node_runner -.->|"generates rollback"| node_rollback
node_runner -.->|"uses bundles"| node_bundles
node_frameworks -.->|"includes baseline"| node_core
node_runner -.->|"supports parallel execution"| node_pipeline

click node_runner "https://github.com/sandler73/windows-security-audit-project/blob/main/Windows-Security-Audit.ps1"
click node_frameworks "https://github.com/sandler73/windows-security-audit-project/tree/main/Modules"
click node_core "https://github.com/sandler73/windows-security-audit-project/blob/main/Modules/Module-Core.ps1"
click node_profiles "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/profiles.ps1"
click node_hostfacts "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/host-facts.ps1"
click node_assessments "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/shared-assessments.ps1"
click node_attack "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/attack-surface.ps1"
click node_pipeline "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/audit-pipeline.ps1"
click node_auditcommon "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/audit-common.ps1"
click node_reports "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/report-templates.ps1"
click node_remediation "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/remediation-library.ps1"
click node_canonical "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/canonical-remediations.ps1"
click node_bundles "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/remediation-bundles.ps1"
click node_rollback "https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/rollback-generator.ps1"
click node_baselines "https://github.com/sandler73/windows-security-audit-project/tree/main/Shared_Components"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_frameworks toneBlue
class node_core,node_profiles,node_hostfacts,node_assessments,node_attack,node_pipeline,node_auditcommon,node_baselines toneAmber
class node_remediation,node_canonical,node_bundles,node_rollback toneMint
class node_reports toneRose
class node_administrator toneIndigo
```

## Components

### Audit execution

- [Audit entry point](https://github.com/sandler73/windows-security-audit-project/blob/main/Windows-Security-Audit.ps1): `Windows-Security-Audit.ps1`
- [Compliance modules](https://github.com/sandler73/windows-security-audit-project/tree/main/Modules): `Modules`

### Assessment capabilities

- [Core checks](https://github.com/sandler73/windows-security-audit-project/blob/main/Modules/Module-Core.ps1): `Modules/Module-Core.ps1`
- [Audit profiles](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/profiles.ps1): `Shared_Components/profiles.ps1`
- [Host facts](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/host-facts.ps1): `Shared_Components/host-facts.ps1`
- [Shared assessments](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/shared-assessments.ps1): `Shared_Components/shared-assessments.ps1`
- [Attack surface](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/attack-surface.ps1): `Shared_Components/attack-surface.ps1`
- [Audit pipeline](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/audit-pipeline.ps1): `Shared_Components/audit-pipeline.ps1`
- [Audit common](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/audit-common.ps1): `Shared_Components/audit-common.ps1`
- [Baseline comparison](https://github.com/sandler73/windows-security-audit-project/tree/main/Shared_Components): `Shared_Components`

### Remediation

- [Remediation library](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/remediation-library.ps1): `Shared_Components/remediation-library.ps1`
- [Canonical remediations](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/canonical-remediations.ps1): `Shared_Components/canonical-remediations.ps1`
- [Remediation bundles](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/remediation-bundles.ps1): `Shared_Components/remediation-bundles.ps1`
- [Rollback scripts](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/rollback-generator.ps1): `Shared_Components/rollback-generator.ps1`

### Reporting

- [Audit reports](https://github.com/sandler73/windows-security-audit-project/blob/main/Shared_Components/report-templates.ps1): `Shared_Components/report-templates.ps1`

### Other components

- **Administrator**

## Connections

- Administrator → Audit entry point: runs audit (evidence: `README.md`)
- Audit entry point → Compliance modules: runs checks (evidence: `README.md`)
- Audit entry point → Audit reports: generates reports (evidence: `README.md`)
- Audit entry point → Baseline comparison: compares drift (evidence: `README.md`)
- Audit entry point → Rollback scripts: generates rollback (evidence: `README.md`)
- Audit entry point → Remediation bundles: uses bundles (evidence: `README.md`)
- Compliance modules → Core checks: includes baseline (evidence: `README.md`)
- Audit entry point → Audit pipeline: supports parallel execution (evidence: `README.md`)
