What is Spray365?
Spray365 is a password spraying tool that identifies valid credentials for Microsoft accounts (Office 365 / Azure AD). How is Spray365 different from the many other password spraying tools that are already available? Spray365 enables passwords to be sprayed from an "execution plan". While having a pre-generated execution plan that describe the spraying operation well before it occurs has many other benefits that Spray365 leverages, this also allows password sprays to be resumed (-R option) after a network error or other interruption. While it is easiest to generate a Spray365 execution plan using Spray365 directly, other tools that produce a compatible JSON structure make it easy to build unique password spraying workflows.
Spray365 exposes a few options that are useful when spraying credentials. Random user agents can be used to detect and bypass insecure conditional access policies that are configured to limit the types of allowed devices. Similarly, the --shuffle_auth_order argument is a great way to spray credentials in a less-predictable manner. This option was added in an attempt to bypass intelligent account lockouts (e.g., Azure Smart Lockout). While it’s not perfect, randomizing the order in which credentials are attempted have other benefits too, like making the detection of these spraying operations even more difficult. Spray365 also supports proxying traffic over HTTP/HTTPS, which integrates well with other tools like Burp Suite for manipulating the source of the spraying operation.
Generating an Execution Plan (Step 1)
Spraying Credentials with an Execution Plan (Step 2)
Getting Started
Installation
Clone the repository, install the required Python packages, and run Spray365!
$ git clone https://github.com/MarkoH17/Spray365
$ cd Spray365
~/Spray365$ pip3 install -r requirements.txt
~/Spray365$ python3 spray365.py
Usage
Generate an Execution Plan
An execution plan is needed to spray credentials, so we need to create one! Spray365 can generate its own execution plan by running it in "generate" (-g) mode.
$ python3 spray365.py -g <path_for_saved_execution_plan> -d <domain_name> -u <file_containing_usernames> -pf <file_containing_passwords>
e.g.
$ python3 spray365.py -g ex-plan.s365 -d example.com -u usernames -pf passwords
Spraying an Execution Plan
Once an execution plan is available, Spray365 can be used to process it. Running Spray365 in "spray" (-s) mode will process the specified execution plan and spray the appropriate credentials.
$ python3 spray365.py -s <path_to_execution_plan>
e.g.
$ python3 spray365.py -s ex-plan.s365
Other Options for Advanced Usage
Generate Mode Options
--delay
: Delay in seconds to wait between authentication attempts (default: 30)
-cID / --aad_client
: Client ID to use during authentication workflow (None for random selection, specify multiple in a comma-separated string) (default: None)
-eID / --aad_endpoint
: Endpoint ID to use during authentication workflow (None for random selection, specify multiple in a comma-separated string) (default: None)
-S / --shuffle_auth_order: Shuffle order of authentication attempts so that each iteration (User1:Pass1, User2:Pass1, User3:Pass1) will be sprayed in a random order, and with a random arrangement of passwords, e.g. (User4:Pass16, User13:Pass25, User19:Pass40). Be aware this option introduces the possibility that the time between consecutive authentication attempts for a given user may occur as quickly as DELAY seconds apart. Consider using the -mD / --min_cred_loop_delay option to enforce a minimum delay between authentication attempts for any given user. (default: False)
-SO / --shuffle_optimization_attempts
: Number of random execution plans to generate for identifying the fastest execution plan (default: 10)
-mD / --min_cred_loop_delay
: Minimum time to wait between authentication attempts for a given user. This option takes into account the time one spray iteration will take, so a pre-authentication delay may not occur every time (disable with 0) (default: 0)
-cUA / --custom_user_agent
: Set custom user agent for authentication requests (default: None)
-rUA, --random_user_agent: Randomize user agent for authentication requests (default: False)
Spray Mode Options
--lockout
: Number of account lockouts to observe before aborting spraying session (disable with 0) (default: 5)
--proxy
: HTTP Proxy URL (format: http[s]://proxy.address:port) (default: None)
-R / --resume_index
: Resume spraying passwords from this position in the execution plan (default: 0)
Acknowledgements
| Author | Tool / Other | Link |
|---|---|---|
| @__TexasRanger | msspray: Conduct password spray attacks against Azure AD as well as validate the implementation of MFA on Azure and Office 365 endpoints | https://github.com/SecurityRiskAdvisors/msspray |
Disclaimer
Usage of this software for attacking targets without prior mutual consent is illegal. It is the end user’s responsibility to obey all applicable local, state and federal laws, in addition to any applicable acceptable use policies. Using this software releases the author(s) of any responsiblity for misuse or damage caused.
0 Dec 20, 2021
5 Feb 02, 2022
9 Jun 01, 2022
59 Dec 01, 2022
9 Jul 04, 2022
2 Jan 24, 2022
9.4k Jan 04, 2023
23 Dec 02, 2022
3.8k Jan 06, 2023
7 Nov 09, 2022
92 Dec 29, 2022
9 Sep 27, 2022
2 Jan 09, 2022
3 Dec 13, 2021
1 Dec 24, 2021
1 Jan 14, 2022
168 Nov 09, 2022
2 Nov 20, 2021
1.5k Jan 04, 2023