LeastPrivilegedMSGraph.psd1
|
# # Module manifest for module 'LeastPrivilegedMSGraph' # # Generated by: Morten Mynster # # Generated on: 2025 # @{ # Script module or binary module file associated with this manifest. RootModule = 'LeastPrivilegedMSGraph.psm1' # Version number of this module. ModuleVersion = '0.1.1' # Supported PSEditions # CompatiblePSEditions = @() # ID used to uniquely identify this module GUID = 'a36f8f7d-ae1a-41d2-a957-cae8c22216aa' # Author of this module Author = 'Morten Mynster' # Company or vendor of this module CompanyName = 'Mynster' # Copyright statement for this module Copyright = '(c) Morten Mynster. All rights reserved.' # Description of the functionality provided by this module Description = 'Analyzes Microsoft Graph permissions and provides least privileged recommendations' # Minimum version of the PowerShell engine required by this module PowerShellVersion = '5.0' # Name of the PowerShell host required by this module # PowerShellHostName = '' # Minimum version of the PowerShell host required by this module # PowerShellHostVersion = '' # Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only. # DotNetFrameworkVersion = '' # Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only. # ClrVersion = '' # Processor architecture (None, X86, Amd64) required by this module # ProcessorArchitecture = '' # Modules that must be imported into the global environment prior to importing this module RequiredModules = @('EntraAuth') # Assemblies that must be loaded prior to importing this module # RequiredAssemblies = @() # Script files (.ps1) that are run in the caller's environment prior to importing this module. # ScriptsToProcess = @() # Type files (.ps1xml) to be loaded when importing this module # TypesToProcess = @() # Format files (.ps1xml) to be loaded when importing this module # FormatsToProcess = @() # Modules to import as nested modules of the module specified in RootModule/ModuleToProcess # NestedModules = @() # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export. FunctionsToExport = @('Export-PermissionAnalysisReport','Get-AppActivityData','Get-AppRoleAssignment','Get-AppThrottlingData','Get-PermissionAnalysis','Initialize-LogAnalyticsApi') # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export. CmdletsToExport = @() # Variables to export from this module VariablesToExport = @() # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export. AliasesToExport = @() # DSC resources to export from this module DscResourcesToExport = @() # List of all modules packaged with this module # ModuleList = @() # List of all files packaged with this module FileList = @( 'data/permissions-v1.0.json', 'data/permissions-beta.json', 'data/base.html' ) # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell. PrivateData = @{ PSData = @{ # Tags applied to this module. These help with module discovery in online galleries. # Tags = @() # A URL to the license for this module. # LicenseUri = '' # A URL to the main website for this project. # ProjectUri = '' # A URL to an icon representing this module. # IconUri = '' # ReleaseNotes of this module ReleaseNotes = '## [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 ' # Prerelease string of this module Prerelease = 'preview' # Flag to indicate whether the module requires explicit user acceptance for install/update/save # RequireLicenseAcceptance = $false # External dependent modules of this module # ExternalModuleDependencies = @() } # End of PSData hashtable } # End of PrivateData hashtable # HelpInfo URI of this module # HelpInfoURI = '' # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix. # DefaultCommandPrefix = '' } |