Skip to content

Commit 3f9becd

Browse files
authored
Update README with script purposes and usage details
Clarified the purpose of each script and added details on their specific functions, including auditing and risk assessment for Microsoft Entra applications.
1 parent 61b11cb commit 3f9becd

1 file changed

Lines changed: 17 additions & 6 deletions

File tree

README.md

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -289,6 +289,18 @@ Connect-MgGraph -Scopes "User.Read.All", "Organization.Read.All", "LicenseAssign
289289
### `list_all_applications.ps1`
290290
Enumerates all Microsoft Entra application registrations and enterprise application service principals visible to the current Microsoft Graph session. Exports separate application and service-principal reports, plus a normalized combined CSV inventory. Reuses an existing Graph session by default and supports optional interactive connection using Application.Read.All.
291291

292+
The three scripts now have separated purposes:
293+
294+
BulkMultiPermExploitability.ps1
295+
Finds high-risk application and delegated permissions across the inventory.
296+
297+
Profile-App.ps1
298+
Creates a complete governance profile for one application.
299+
300+
Audit-AppDelegationRisks.ps1
301+
Performs a focused delegated-consent risk assessment for one application.
302+
303+
292304
### `BulkMultiPermExploitability.ps1`
293305
BulkMultiPermExploitability.ps1 reviews Microsoft Entra applications for granted Microsoft Graph permissions that match a configurable high-risk permission catalog.
294306
The script evaluates both:
@@ -318,19 +330,18 @@ Run ad hoc when investigating findings from BulkMultiPermExploitability.ps1, rev
318330
```
319331

320332
### `Audit-AppDelegationRisks.ps1`
321-
- **Purpose:** Focuses on delegated OAuth2 grants. Profiles a single service principal to audit delegated permission grants and identify high‑risk delegated scopes (e.g., mail, calendars, device management).
322-
- **Use Case:** Flags **tenant‑wide consents** with risky scopes and resolves who can access the app.
323-
- **Frequency:** Run **ad‑hoc** when reviewing suspicious or high‑risk apps.
333+
Audits delegated OAuth consent grants for a single Microsoft Entra application, expands each granted scope into an individual record, and identifies high-impact delegated permissions using a built-in or caller-supplied risk catalog.
334+
335+
Identifies tenant-wide AllPrincipals consent, privileged delegated scopes, missing ownership, and principals assigned to access an enterprise application. Intended for evidence-driven application reviews, consent investigations, and least-privilege validation.
336+
337+
Run ad hoc when investigating suspicious applications, validating findings from BulkMultiPermExploitability.ps1, or reviewing privileged third-party integrations.
324338

325-
All scripts rely on the **[Microsoft.Graph PowerShell SDK](https://learn.microsoft.com/powershell/microsoftgraph/overview)**
326-
Before running the scripts, establish a Graph session with sufficient rights:
327339
```powershell
328340
.\list_all_applications.ps1 //Generates CSV files
329341
330342
.\BulkMultiPermExploitability.ps1 -ScopeCsvPath ScopeBreakdown.csv //This parses previously generated CSV file
331343
```
332344

333-
When you see "Problem!" this is how you dig deeper into the app details
334345
```powershell
335346
.\Profile-App.ps1 -TargetAppId dddddd-ba25-43c7-a710-cxxxx
336347

0 commit comments

Comments
 (0)