Entraspray: Password spraying tool for Microsoft Online accounts

Entraspray

Entraspray is a rewrite of MSOLSpray in Python. The main purpose of this tool remains the same: to perform password spraying against Microsoft Azure accounts while also providing detailed information about account status and errors; such as if MFA is enabled, if a tenant or user doesn’t exist, if the account is locked or disabled, and more.

Enhancements:

  • The script will remove “compromised” users from the input list. This feature prevents password spraying against accounts where the correct password has already been identified in the previous execution of the script. A backup of the original user input list is created in the output directory. While seemingly minor, this change can reduce repeated password spraying and account lockouts, a feature I have not seen in most of the other password-spraying tools. The operator can safely keep using the same user input list without risking unnecessary account lockout and alerting.
  • Random selection of user-agent for each request.
  • Some additional error codes have also been added based on the conditional access policy.

The tool supports using FireProx to rotate source IP addresses on authentication requests, avoiding being blocked by Microsoft Entra Smart Lockout.

Install

Create/activate virtual env and install requirements:

git clone https://github.com/dunderhay/entraspray.git
python3 -m venv venv
source venv/bin/activate
python3 -m pip install -r requirements.txt

Use

 

Password Spraying

provide a userlist file with the target email addresses one per line for example ‘user@example.com’. Use caution to avoid locking out accounts, as this tool can trigger Microsoft Entra Smart Lockout if used incorrectly.

python3 entraspray.py –userlist userlist.txt –password Password123
Copyright (C) 2024 dunderhay