Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shkudw/entramail
A PowerShell tool designed to identify valid users in Entra-ID (Azure AD).
https://github.com/shkudw/entramail
azure entra-id pentesting powershell reconnaissance redteam
Last synced: 2 days ago
JSON representation
A PowerShell tool designed to identify valid users in Entra-ID (Azure AD).
- Host: GitHub
- URL: https://github.com/shkudw/entramail
- Owner: ShkudW
- Created: 2024-08-05T20:38:31.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-29T20:27:46.000Z (9 days ago)
- Last Synced: 2024-10-29T22:48:28.515Z (9 days ago)
- Topics: azure, entra-id, pentesting, powershell, reconnaissance, redteam
- Language: PowerShell
- Homepage:
- Size: 840 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
**EntraMail** is a PowerShell based tool for penetration testers and Red Teamers to enumerate user accounts within EntraID (Azure AD) environments. It uses multiple APIs to identify valid User Principal Names (UPNs) and provides detailed HTML reports. The tool offers flexible options for querying by first names, last names, usernames, and supports both single queries and bulk operations via files.
## Features
- **Multiple Query Options:** Supports querying by first name, last name, or full username, as well as bulk queries from files.
- **Domain-Specific UPN Enumeration:** Validate UPNs within a specific domain to identify active accounts in EntraID.
- **Stop On First Match:** Optionally stop searching after finding the first valid user to optimize large-scale enumeration efforts.
- **Customizable Delays:** Control the delay between requests to prevent rate-limiting or IP blocking.
- **Detailed HTML Reporting:** Generate comprehensive, user-friendly HTML reports of the results.
- **Flexible Input Sources:** Accepts individual names or files containing multiple names or usernames for streamlined bulk enumeration.
### Prerequisites
- PowerShell 5.0 or higher
### Command Line Usage
```powershell
# Load The Script
Import-Module .\EntraMail.psm1
```
```powershell
# Searching by single first name and last name
Invoke-EntraMail -FirstName Shaked -LastName Wiessman -DomainName example.com
```
```powershell
# Searching by Names-File it is recommended to use -StopOnFirstMatch flag
Invoke-EntraMail -NamesFile names.txt -DomainName example.com -StopOnFirstMatch
```
```powershell
# Searching by NUserNames File
Invoke-EntraMail -UsernameFile usernames.txt -DomainName example.com -OutputFilePath report.html
```
### PoC
