mAudit is a production-grade, automated Microsoft 365 security posture management (CSPM) platform. It inspects an organization's Microsoft Entra ID and M365 tenant using read-only permissions via OAuth2 Admin Consent, evaluates configurations against CIS benchmarks, maps gaps directly to CIS Microsoft 365 Foundations, SOC 2 Type II, NIS2 (Directive (EU) 2022/2555 Art. 21), and GDPR (Art. 32), and delivers an interactive, actionable, shareable web report.
Interactive cloud security report displaying executive health score, operational KPIs, multi-framework compliance readiness (CIS, SOC 2, NIS2, GDPR), and deep-dive remediation cards.
- Dynamic License Awareness:
- Automatically queries tenant SKUs (
subscribedSkus) before executing security checks. - Gracefully marks premium checks as
NOT_APPLICABLEfor tenants without Entra ID P1/P2 licenses, evaluating Security Defaults instead of applying unfair score penalties.
- Automatically queries tenant SKUs (
- Actionable Remediation Engine:
- Every finding includes both a direct Microsoft 365 Admin Center click-path and copy-pasteable PowerShell CLI remediation snippets.
- Multi-Framework Regulatory & Standards Mapping:
- CIS Microsoft 365 Foundations Benchmark: Technical baseline controls (Level 1 & Level 2).
- SOC 2 Type II: Trust Services Criteria for logical access and system operations (CC6 / CC7).
- NIS2 Directive: European cybersecurity risk management measures (Directive (EU) 2022/2555 Art. 21).
- GDPR Security of Processing: Technical safeguards against data leakage and unauthorized access (Regulation (EU) 2016/679 Art. 32).
- Scan Diffing ("Before & After"):
- Tracks tenant remediation progress over time by matching tenant ID hashes, highlighting score deltas (
+X points), resolved risks, and new misconfigurations.
- Tracks tenant remediation progress over time by matching tenant ID hashes, highlighting score deltas (
- Zero-Retention Privacy Architecture:
- No Directory Mirroring: Never stores employee lists, passwords, emails, or personal identifiers.
- Stores only aggregated statistics and SHA-256 tenant hashes.
- Built-in 14-day expiration with a prominent 1-click permanent data wipe button.
- Nordic Minimalist Dark UX:
- Built with Next.js 15 App Router, React 19, and Tailwind CSS.
- Dedicated Pre-Consent Trust Screen explaining permissions, zero-content access, and 10-second Enterprise App offboarding.
- Bilingual By Design (English & Swedish):
- Full application localization for both English and Swedish.
- Instant language switcher (
🇬🇧 EN/🇸🇪 SV) in the navigation bar withlocalStoragepreference persistence.
mAudit evaluates your Microsoft 365 tenant across 20 technical controls organized into 6 domains:
| Category | Checks | Description & Standards Aligned |
|---|---|---|
| 1. Identity & MFA | 5 | Global MFA registration rate, Security Defaults, SSPR, stale accounts (90+ days), and NIST-aligned password expiration. |
| 2. Global Administrators | 4 | Number of Global Admins (2–4), phishing-resistant admin MFA, separate non-mailbox admin accounts, and restricting non-admins from the Entra admin portal. |
| 3. Conditional Access | 2 | Legacy authentication blocking (POP3/IMAP/SMTP) and dedicated cloud-only break-glass emergency account exclusion. |
| 4. Email Hygiene & DNS | 4 | SPF HardFail (-all), DMARC policy enforcement (p=quarantine/p=reject), DKIM cryptographic signing, and external email auto-forwarding blocking. |
| 5. Sharing & Collaboration | 2 | Anonymous link restriction in SharePoint/OneDrive and setting default sharing links to "Specific People". |
| 6. Application Governance & Audit | 3 | Restricting user consent for third-party OAuth apps, guest invitation boundary controls, and Unified Audit Logging (UAL) enforcement. |
- Node.js 20.x or later
- npm or pnpm
Clone the repository and install dependencies:
git clone https://github.com/MaxVonk/mAudit.git
cd mAudit
npm installmAudit includes a portable SQLite setup out of the box (PostgreSQL-compatible via Prisma):
npx prisma db pushnpm run devOpen http://localhost:3000 in your browser.
Run the built-in verification test suite to validate scoring calculations, license fallback handling, scan diffing, and database lifecycle:
npx tsx tests/engine-verification.tsRun the production build:
npm run buildYou can test and evaluate the entire end-to-end application without needing an active Microsoft Azure tenant:
- Click "Try demo (Nordic Retail)" on the homepage or navigation bar.
- Generates a complete security evaluation report for a sample organization (Nordic Retail AB).
- Click "Simulate re-scan (Diff)" inside the report to see scan diffing in action with positive score deltas and resolved vulnerabilities.
- Filter findings by framework: click CIS, SOC 2, NIS2, or GDPR cards to see related technical checks.
- Click "Delete data" to test the one-click permanent database purge.
To connect live enterprise tenants, register a Multi-Tenant Application in the Microsoft Entra Admin Center:
- Name:
mAudit - Supported account types:
Accounts in any organizational directory (Multitenant) - Redirect URI (Web):
https://your-domain.com/api/auth/callback(orhttp://localhost:3000/api/auth/callbackfor development)
Add the following Microsoft Graph Application Permissions:
Directory.Read.All— Reads tenant users, groups, and licensing metadata.Organization.Read.All— Discovers verified custom domains for DNS inspection.Policy.Read.All— Inspects Security Defaults, Conditional Access, and authorization policies.Reports.Read.All— Reads credential registration details to calculate MFA metrics.RoleManagement.Read.Directory— Inspects active Global Administrators and privileged role assignments.AuditLog.Read.All— Required by Microsoft Graph to read authentication methods & MFA registration reports.
Create a .env file in the project root based on .env.example:
DATABASE_URL="file:./dev.db"
NEXT_PUBLIC_APP_URL="http://localhost:3000"
# Microsoft Entra ID App Credentials
AZURE_CLIENT_ID="your-azure-application-client-id"
AZURE_CLIENT_SECRET="your-azure-client-secret"
AZURE_REDIRECT_URI="http://localhost:3000/api/auth/callback"
# Session Encryption Secret
SESSION_SECRET="your-32-byte-hex-secret"mAudit/
├── app/
│ ├── layout.tsx # Root dark theme layout & typography
│ ├── page.tsx # Landing page (Hero, Categories, NIS2)
│ ├── connect/
│ │ └── page.tsx # Pre-Consent Trust Screen & Permissions
│ ├── scan/
│ │ └── [id]/page.tsx # Real-time scan progression & ticker
│ ├── report/
│ │ └── [token]/page.tsx # Assessment Report, framework tabs & PDF view
│ └── api/
│ ├── auth/
│ │ ├── consent/route.ts # Microsoft OAuth2 Consent URL generator
│ │ └── callback/route.ts # Admin consent OAuth redirect handler
│ ├── scan/
│ │ ├── demo/route.ts # Instant demo scan generator
│ │ └── live/route.ts # Live Microsoft Graph scanner API
│ └── report/
│ └── [token]/route.ts # Report retrieval & one-click purge
├── components/
│ ├── navbar.tsx # Header navigation & quick demo launcher
│ ├── trust-card.tsx # Pre-consent security & privacy disclosure
│ ├── score-gauge.tsx # SVG radial score gauge (90/70 score bands)
│ ├── finding-card.tsx # Accordion card with PowerShell snippets
│ └── diff-badge.tsx # Scan diffing indicator
├── lib/
│ ├── db.ts # Prisma database client singleton
│ ├── types.ts # Domain models & TypeScript interfaces
│ ├── scoring.ts # Health index calculation (90/70 bands)
│ ├── compliance.ts # CIS Foundations & SOC 2 Type II compliance mapping engine
│ ├── finding-translations.ts # Comprehensive EN/SV dictionary for findings & values
│ ├── diff.ts # Scan comparison engine
│ ├── i18n.tsx # English & Swedish localization context & dictionary
│ └── scanner/
│ ├── capabilities.ts # Tenant SKU & license capability detector
│ ├── graph-client.ts # Graph client & safe query 403 runner
│ ├── dns-scanner.ts # SPF, DKIM, DMARC validation via dns/promises
│ ├── live-scanner.ts # Live Microsoft Graph audit orchestrator
│ └── mock-data.ts # Demo tenant profiles & mock findings
├── prisma/
│ └── schema.prisma # ScanReport database schema
├── screenshots/
│ └── result.png # Posture report visual preview
└── tests/
└── engine-verification.ts # Automated unit & integration test suite
This project is open source and distributed under the MIT License.
Copyright (c) 2026 Max Krabbenhöft (MaxVonk).