LeastPrivilegedMSGraph

Author(s)

• Morten Mynster

Functions

Export-PermissionAnalysisReport Get-AppActivityData Get-AppRoleAssignment Get-AppThrottlingData Get-PermissionAnalysis Initialize-LogAnalyticsApi

Dependencies

• • EntraAuth

Release Notes

## [0.1.1-preview] - 2025-11-26

### Added

- Initial release of LeastPrivilegedMSGraph module
- **Core Cmdlets:**
 - `Get-AppRoleAssignment` - Retrieves all Enterprise Applications with their assigned Microsoft Graph permissions
 - `Get-AppActivityData` - Analyzes application activity from Azure Log Analytics workspace logs
 - `Get-AppThrottlingData` - Collects throttling statistics and error rates from Log Analytics
 - `Get-PermissionAnalysis` - Analyzes application permissions against actual API usage to identify least privileged permissions
 - `Export-PermissionAnalysisReport` - Generates comprehensive HTML reports with interactive visualizations
 - `Initialize-LogAnalyticsApi` - Registers the Log Analytics service for API queries
- **Permission Analysis Features:**
 - Automatic mapping of Graph API endpoints to least privileged permissions
 - Support for both v1.0 and beta Graph API endpoints
 - Detection of excess permissions granted to applications
 - Identification of unmatched API activities
 - Optimal permission recommendations based on actual usage
- **Reporting Capabilities:**
 - Interactive HTML reports with dark mode support
 - Filterable application grid with search functionality
 - Detailed permission breakdown and activity analysis
 - Throttling statistics and error rate visualization
 - Color-coded permission status indicators
- **Data Files:**
 - `permissions-v1.0.json` - Permission mappings for Microsoft Graph v1.0 API (1,885+ endpoints)
 - `permissions-beta.json` - Permission mappings for Microsoft Graph beta API (6,464+ endpoints)
 - `base.html` - HTML template for report generation with Tailwind CSS styling
- **GitHub Workflows:**
 - Automated Microsoft Graph permissions extraction workflow
 - Daily scheduled updates of permission mappings
 - Discord webhook notifications for permission updates
 - Support for manual workflow dispatch with test mode
- **Module Infrastructure:**
 - Built using Sampler framework for standardized module structure
 - PlatyPS integration for automatic documentation generation
 - Pester test framework support
 - Versioned module output with proper manifest configuration
 - Pipeline-enabled cmdlets for flexible data processing
- **Dependencies:**
 - Integration with EntraAuth module for authentication
 - Requires EntraAuth for Microsoft Graph and Log Analytics connectivity
- **Documentation:**
 - Comprehensive README with usage examples
 - Full pipeline example for end-to-end analysis
 - Individual cmdlet documentation
 - Data anonymization script for sharing reports

### Technical Details

- **Module Structure:**
 - Public functions: 5 user-facing cmdlets
 - Private functions: Internal helper functions for data processing
 - Data directory: JSON permission mappings and HTML templates
 - Build automation: Sampler-based build system with GitHub Actions
- **Permission Mapping:**
 - Extracted from official Microsoft Graph OpenAPI specifications
 - Regular expression-based endpoint matching
 - Support for path parameters and complex routes
 - Least privileged permission identification logic
- **Performance:**
 - Permission extraction using concurrent Node.js processing - Note that we can not speed it up due to limitation on function app
 - Batch processing for Log Analytics queries
 - Efficient pipeline support for processing multiple applications
 - Optimized JSON file loading and caching