# mayyhem/misconfiguration-manager architecture

> Architecture diagram of the GitHub repository mayyhem/misconfiguration-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mayyhem/misconfiguration-manager
- Repository: https://github.com/mayyhem/misconfiguration-manager

## Overview

##### Project Type and Purpose
- This is an open-source “knowledge base + tool” repository aimed at cataloging Microsoft Configuration Manager (SCCM) attack and defense techniques alongside a PowerShell audit script.
- The primary deliverables are:
- A structured set of Markdown documents (attack-techniques, defense-techniques, glossary, resources).
- A PowerShell script (`MisconfigurationManager.ps1`) that connects to SCCM infrastructure to detect misconfigurations.
- Community contribution workflow via GitHub (PRs, issues, Slack).

##### High-Level Component Breakdown
- Content Repository (GitHub)
- Markdown folders: `attack-techniques/`, `defense-techniques/`, `GLOSSARY.md`, `RESOURCES.md`, `README.md`, etc.
- Contribution pipeline: Git + CI (if any) → merges → live repo.
- PowerShell Audit Tool
- MisconfigurationManager.ps1
- Interfaces with SCCM via WMI/PowerShell cmdlets.
- Target Environment (SCCM Infrastructure)
- Primary Site Server(s)
- Site Database (SQL)
- Distribution Points
- Management Points / Site Systems
- Clients
- Active Directory
- Consumers and Contributors
- Offensive/Defensive security practitioners
- IT administrators
- Project maintainers

##### Relationships and Data Flows
- Users clone the GitHub repo → read/author Markdown content → submit PRs.
- Administrator runs `MisconfigurationManager.ps1` → script queries SCCM Site Server and Site DB → returns audit findings.
- Findings reference remediation steps documented in the repo.
- Community feedback loops via GitHub Issues/PRs and Slack #sccm channel.

##### Architectural Patterns and Principles
- Separation of Concerns: Documentation vs. Execution code.
- Content-driven design: technique folders enforce taxonomy (CRED, EXEC, RECON, etc.).
- Extensibility: New techniques are added as new Markdown subfolders (plug-in style).
- Minimal runtime dependencies: PowerShell + SCCM native interfaces.

– Overarching “Active Directory” boundary around the whole cluster

##### Final Recommendations
- Related elements in containers (e.g., “SCCM Environment,” “Content Repo,” “Community Channels”).

## Diagram (Mermaid)

```mermaid
graph TB
  Users["Community Contributors"]:::comm

  subgraph "GitHub Repo"
    subgraph "Documentation"
      Attack["attack-techniques/"]:::docs
      Defense["defense-techniques/"]:::docs
      Glossary["GLOSSARY.md"]:::docs
      Resources["RESOURCES.md"]:::docs
    end
    Readme["README.md"]:::docs
    Contrib["CONTRIBUTING.md"]:::docs
    Script["MisconfigurationManager.ps1"]:::script
  end

  subgraph "PowerShell Runner"
    Runner["PowerShell Runner"]:::script
  end

  subgraph "SCCM Environment"
    AD["Active Directory"]:::infra
    SiteServer["SCCM Site Server"]:::infra
    SiteDB["Site Database (SQL)"]:::infra
    DistPoints["Distribution Points"]:::infra
    SiteSystems["Management Points / Site Systems"]:::infra
    Clients["Clients"]:::infra
  end

  subgraph "Community Channels"
    Slack["Slack #sccm"]:::comm
    Issues["GitHub Issues/PRs"]:::comm
  end

  Users -->|"clones/submits PRs"|Attack
  Users -->|"clones/submits PRs"|Defense
  Users -->|"clones/submits PRs"|Readme

  Runner -->|"executes script"|Script
  Runner -->|"queries via WMI/PowerShell"|SiteServer
  Runner -->|"queries SQL"|SiteDB
  SiteServer -->|"connects to"|SiteDB
  SiteServer -->|"serves content to"|DistPoints
  SiteSystems -->|"manages"|Clients
  Runner -->|"references remediation"|Attack

  Slack -->|"feedback"|Issues
  Issues -->|"triggers PRs"|Attack

  classDef docs fill:#D0E6FF,stroke:#0366d6,color:#0366d6;
  classDef script fill:#e6ffe6,stroke:#28a745,color:#22863a;
  classDef infra fill:#fff4e6,stroke:#d39e00,color:#b67800;
  classDef comm fill:#f0f0f0,stroke:#6a737d,color:#6a737d;

  click Attack "https://github.com/mayyhem/misconfiguration-manager/tree/main/attack-techniques/"
  click Defense "https://github.com/mayyhem/misconfiguration-manager/tree/main/defense-techniques/"
  click Glossary "https://github.com/mayyhem/misconfiguration-manager/blob/main/GLOSSARY.md"
  click Resources "https://github.com/mayyhem/misconfiguration-manager/blob/main/RESOURCES.md"
  click Readme "https://github.com/mayyhem/misconfiguration-manager/blob/main/README.md"
  click Contrib "https://github.com/mayyhem/misconfiguration-manager/blob/main/CONTRIBUTING.md"
  click Script "https://github.com/mayyhem/misconfiguration-manager/blob/main/MisconfigurationManager.ps1"
```
