How snifsnsort/mailguard works
MailGuard audits connected Microsoft 365 and Google Workspace tenants, scores security findings, and reports posture and lookalike-domain risks. The principal workflow is tenant connection, scan initiation, platform-specific checks, persisted scan results, and dashboard/history review. README capabilities are included where source excerpts are limited; dashed edges mark relationships that are documented at the product level or not directly demonstrated by the sampled code.
Main entry points: scan_engine.py Scan orchestrator · App.jsx React application · main.py API router · google_auth.py Google OAuth
Components 31
Dashboard
- React application
frontend/src/App.jsx - API client
frontend/src/utils/api.js - Posture dashboard
frontend/src/pages/Dashboard.jsx - Security checks
frontend/src/pages/Checks.jsx - Scan history
frontend/src/pages/History.jsx - Lookalike review
frontend/src/pages/LookalikeScan.jsx
API workflows
- API router
backend/app/main.py - Tenant management
backend/app/api/tenants.py - Scan operations
backend/app/api/scans.py - PDF reports
backend/app/api/reports.py - Lookalike endpoints
backend/app/api/aggressive_scan.py - Onboarding
backend/app/api/onboarding.py
Security analysis
- Scan orchestrator
backend/app/services/scan_engine.py - M365 checks
backend/app/services/graph_client.py - Exchange checks
backend/app/services/exchange_checker.py - MX analysis
backend/app/services/mx_analyzer.py - Google checks
backend/app/services/google_workspace_checker.py - Lookalike detection
backend/app/services/lookalike_detector.py - Threat enrichment
backend/app/services/aggressive_lookalike.py - Report generation
backend/app/services/report_generator.py
Tenant connections
- Google OAuth
backend/app/api/google_auth.py - Authentication
backend/app/api/auth.py - Token encryption
backend/app/core/security.py
Persistence
- Tenant records
backend/app/models/tenant.py - Scan records
backend/app/models/scan.py - Threat scan records
backend/app/models/aggressive_scan.py - Database access
backend/app/core/database.py
Other components
- Tenant admin
- Microsoft 365
- Google Workspace
- Public DNS
Connections 38
- Tenant admin → React application: uses
- React application → API client: requests data
frontend/src/App.jsx - React application → Posture dashboard: renders
frontend/src/App.jsx - React application → Security checks: routes to
frontend/src/App.jsx - React application → Scan history: routes to
frontend/src/App.jsx - React application → Lookalike review: routes to
frontend/src/App.jsx - API client → API router: calls API
- API router → Tenant management: registers
backend/app/main.py - API router → Scan operations: registers
backend/app/main.py - API router → PDF reports: registers
backend/app/main.py - API router → Lookalike endpoints: registers
backend/app/main.py - API router → Onboarding: registers
backend/app/main.py - Tenant management → Tenant records: reads and writes
backend/app/api/tenants.py - Scan operations → Scan orchestrator: starts scan
backend/app/api/scans.py - Scan operations → Scan records: reads and writes
backend/app/api/scans.py - Scan orchestrator → M365 checks: queries
backend/app/services/scan_engine.py - Scan orchestrator → Exchange checks: queries
backend/app/services/scan_engine.py - Scan orchestrator → MX analysis: uses
backend/app/services/scan_engine.py - Scan orchestrator → Google checks: queries
backend/app/services/scan_engine.py - Scan orchestrator → Lookalike detection: checks domains
backend/app/services/scan_engine.py - Scan orchestrator → Scan records: persists results
- M365 checks → Microsoft 365: queries tenant
backend/app/services/graph_client.py - Google checks → Google Workspace: checks tenant
- MX analysis → Public DNS: resolves records
- Lookalike detection → Public DNS: enriches domains
- Lookalike endpoints → Threat enrichment: runs enrichment
backend/app/api/aggressive_scan.py - Lookalike endpoints → Threat scan records: reads and writes
backend/app/api/aggressive_scan.py - Tenant admin → Google OAuth: connects account
- Google OAuth → Google Workspace: authorizes access
backend/app/api/google_auth.py - Google OAuth → Tenant records: registers tenant
backend/app/api/google_auth.py - Google OAuth → Token encryption: encrypts token
backend/app/api/google_auth.py - Authentication → Token encryption: protects credentials
- PDF reports → Report generation: generates report
backend/app/api/reports.py - PDF reports → Scan records: reads results
backend/app/api/reports.py - Onboarding → Scan orchestrator: starts scan
backend/app/api/onboarding.py - Database access → Tenant records: persists
backend/app/core/database.py - Database access → Scan records: persists
backend/app/core/database.py - Database access → Threat scan records: persists
backend/app/core/database.py