Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/theresafewconors/mssprinkler
MSSprinkler is a password spraying utility for organizations to test their Microsoft Online accounts from an external perspective. It employs a 'low-and-slow' approach to avoid locking out accounts, and provides verbose information related to accounts and tenant information.
https://github.com/theresafewconors/mssprinkler
offensive-security password passwordspray passwordspraying powershell powershell-module redteam
Last synced: 7 days ago
JSON representation
MSSprinkler is a password spraying utility for organizations to test their Microsoft Online accounts from an external perspective. It employs a 'low-and-slow' approach to avoid locking out accounts, and provides verbose information related to accounts and tenant information.
- Host: GitHub
- URL: https://github.com/theresafewconors/mssprinkler
- Owner: TheresAFewConors
- License: mit
- Created: 2024-09-15T09:54:53.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-12-18T14:40:43.000Z (about 1 month ago)
- Last Synced: 2025-01-08T13:21:13.176Z (14 days ago)
- Topics: offensive-security, password, passwordspray, passwordspraying, powershell, powershell-module, redteam
- Language: PowerShell
- Homepage:
- Size: 304 KB
- Stars: 71
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/theresafewconors/mssprinkler)
[](https://github.com/theresafewconors/mssprinkler)
[](https://github.com/theresafewconors/mssprinkler)
[](https://github.com/theresafewconors/mssprinkler)
MSSprinkler is sponsored by CyberMaxx.
# Overview
MSSprinkler is a password spraying utility for organizations to test their Microsoft Online accounts from an external perspective. It employs a 'low-and-slow' approach to avoid locking out accounts, and provides verbose information related to accounts and tenant information.
## Contents
- [Description](#description)
- [Current Feature](#current-features)
- [Installation](#install-and-usage)
- [Help](#help)
- [Disclaimer](#disclaimer)
## Description
MSSprinkler is written in PowerShell and can be imported directly as a module. It has no other dependencies. MSSprinkler relies on the verbose error messaging provided by Microsoft to identify additional information beyond standard password spray success or failed authentication attempts, which allows for the gathering of additional information related to the user account. MSSprinkler also allows for a configurable threshold to prevent locking out accounts by mistake. By default, this is set to 8 (n-2 under Microsoft's default) however this can be adjusted based on the organizations lockout policy. Additionally, successful sign-in to an account with MFA enabled will not produce an MFA push to the user, allowing for covert information gathering.
## Current Features
- Automatically spray a list of Microsoft Online accounts with a password list.
- Automatically retrieve and log the tenant ID associated with the domain and store in JSON format.
- Stored under `/jsonModules/domainCache.json`
- Automatically retrieve the access & refresh tokens for successful user sign-ins, providing long-term persistence.
- Stored under `/jsonModules/tokenCache.json`
- Low-and-slow approach to avoid locking out accounts.
- Smart detect accounts that do not exist or are locked out, skipping over these to reduce unnecessary traffic and speed up testing.
- Ability to override the default threshold to better match the organizations policy, if required.
- Verbose output, revealing additional information about accounts:
- Detect if an account is locked out.
- Detect if a user exists in the tenant or not.
- Detect if MFA is in use for a given user without triggering the MFA push.
- Output and store results into a csv file.
Domain Cache Output example
Token Cache Output example
## Install and Usage
```PowerShell
# Import the module
Import-Module MSSprinkler.ps1
# Use the module
Invoke-MSSprinkler
# EXAMPLE USAGE
# Spray using a provided userlist and password list, default URL and threshold
Invoke-MSSprinkler -user userlist.txt -pass passwordlist.txt
# Spray using a provided userlist and password list, increase threshold to 12 attempts per min and output results to output.csv
Invoke-MSSprinkler -user userlist.txt -pass passwordlist.txt -threshold 12 -output .\output.csv
```
## Help
The userlist file should contain a list of users in the format `[email protected]`, one per line. Example below:
```
[email protected]
[email protected]
...
[email protected]
```
The password list should follow the same format. One password per line:
```
password1
password2
...
password10
```
Additional help can be viewed within the tool via PowerShells built-in module:
```PowerShell
Get-Help .\mssprinkler.ps1 -detailed
```
Timestamps in the output file are in UTC timezone with the applicable offset for the local user, eg for 2:11pm local time:
```
09/17/2024 13:11 +01
```
## Reporting An Issue
If you encounter an issue with an unhandled error MSSprinkler will provide you with the error code. Please open an issue and reference this error code so that it can be added and handled correctly.
## Disclaimer
This tool is to be used only against accounts that you either own or have permission to test during legitimate penetration tests or internal assessments. The author accepts no liability for actions taken by its users.