How securigeek/m365-investigation-toolkit works
This is a read-only Microsoft 365 and Entra ID investigation toolkit. Analysts launch a guided investigation, authenticate through delegated browser sign-in, collect tenant evidence (optionally using investigation pivots), then receive verdicts and structured reports. The graph preserves the documented Exchange, identity, audit, threat-detection, and branded-reporting capabilities. Source excerpts were unavailable, so relationships are limited to those stated in the README; the README does not identify every internal call or output format.
Main entry points: Invoke-InvestigationCollector.ps1 Investigation orchestration · Run-Investigation-Collector.ps1 Investigation launcher · reporting.ps1 Investigation reports · auth.ps1 Delegated authentication
Components 19
Investigation workflow
- Investigation launcher
Run-Investigation-Collector.ps1 - Investigation orchestration
src/Invoke-InvestigationCollector.ps1 - Delegated authentication
src/lib/auth.ps1
Exchange evidence
- Exchange checks
src/collectors - Mailbox forwarding
src/collectors/Get-TenantMailboxForwarding.ps1 - Inbox rules
src/collectors/Get-TenantInboxRules.ps1 - Transport and connectors
src/collectors/Get-TenantTransportRules.ps1 - Message trace pivots
src/collectors/Get-TenantMessageTracePivot.ps1 - Quarantine pivots
src/collectors/Get-TenantQuarantinePivot.ps1
Identity and audit
- Identity sign-ins
src/collectors/Get-TenantInteractiveSignins.ps1 - Directory audit
src/collectors/Get-TenantDirectoryAuditLog.ps1 - Unified audit log
src/collectors/Get-TenantUnifiedAuditLog.ps1 - Consent and roles
src/collectors/Get-TenantConsentGrants.ps1
Detection and reporting
- Threat detections
src/lib/detections.ps1 - Confidence-aware verdict
src/lib/forensic-normalization.ps1 - Investigation reports
src/lib/reporting.ps1 - Branded presentations
src/lib/branded-pptx-generator.ps1
Other components
- Analyst
- Microsoft 365 services
Connections 18
- Analyst → Investigation launcher: starts investigation
README.md - Investigation launcher → Investigation orchestration: runs collection
README.md - Investigation orchestration → Delegated authentication: signs in
README.md - Investigation orchestration → Exchange checks: collects evidence
README.md - Investigation orchestration → Identity sign-ins: collects evidence
README.md - Investigation orchestration → Directory audit: collects evidence
README.md - Investigation orchestration → Unified audit log: collects evidence
README.md - Investigation orchestration → Consent and roles: collects evidence
README.md - Investigation orchestration → Message trace pivots: applies pivots
README.md - Investigation orchestration → Quarantine pivots: applies pivots
README.md - Investigation orchestration → Mailbox forwarding: collects evidence
README.md - Investigation orchestration → Inbox rules: collects evidence
README.md - Investigation orchestration → Transport and connectors: collects evidence
README.md - Investigation orchestration → Microsoft 365 services: queries tenant
README.md - Investigation orchestration → Threat detections: assesses indicators
README.md - Investigation orchestration → Confidence-aware verdict: generates verdict
README.md - Investigation orchestration → Investigation reports: generates outputs
README.md - Investigation reports → Branded presentations: creates presentations
README.md