Collection of offensive tools targeting Microsoft Azure written in Python to be platform agnostic. The current list of tools can be found below with a brief description of their functionality.

• ./Device_Code/device_code_easy_mode.py
  • Generates a code to be entered by the target user
  • Can be used for general token generation or during a phishing/social engineering campaign.
• ./Access_Tokens/token_juggle.py
  • Takes in a refresh token in various ways and retrieves a new refresh token and an access token for the resource specified
• ./Access_Tokens/read_token.py
  • Takes in an access token and parses the included claims information, checks for expiration, attempts to validate signature
• ./Outsider_Recon/outsider_recon.py
  • Takes in a domain and enumerates as much information as possible about the tenant without requiring authentication
• ./User_Enum/user_enum.py
  • Takes in a username or list of usernames and attempts to enumerate valid accounts using one of three methods
  • Can also be used to perform a password spray
• ./Azure_AD/get_tenant.py
  • Takes in an access token or refresh token, outputs tenant ID and tenant Name
  • Creates text output file as well as BloodHound compatible aztenant file
• ./Azure_AD/get_users.py
  • Takes in an access token or refresh token, outputs all users in Azure AD and all available user properties in Microsoft Graph
  • Creates three data files, a condensed json file, a raw json file, and a BloodHound compatible azusers file
• ./Azure_AD/get_groups.py
  • Takes in an access token or refresh token, outputs all groups in Azure AD and all available group properties in Microsoft Graph
  • Creates three data files, a condensed json file, a raw json file, and a BloodHound compatible azgroups file
• ./Azure_AD/get_group_members.py
  • Takes in an access token or refresh token, outputs all group memberships in Azure AD and all available group member properties in Microsoft Graph
  • Creates three data files, a condensed json file, a raw json file, and a BloodHound compatible azgroups file
• ./Azure_AD/get_subscriptions.py
  • Takes in an ARM token or refresh token, outputs all subscriptions in Azure and all available subscription properties in Azure Resource Manager
  • Creates three data files, a condensed json file, a raw json file, and a BloodHound compatible azgroups file
• ./Azure_AD/get_resource_groups.py
  • Takes in an ARM token or refresh token, outputs all resource groups in Azure and all available resource group properties in Azure Resource Manager
  • Creates two data files, a raw json file, and a BloodHound compatible azgroups file
• ./Azure_AD/get_vms.py
  • Takes in an ARM token or refresh token, outputs all virtual machines in Azure and all available VM properties in Azure Resource Manager
  • Creates two data files, a raw json file, and a BloodHound compatible azgroups file

Offensive Azure can be installed in a number of ways or not at all.

You are welcome to clone the repository and execute the specific scripts you want. A requirements.txt file is included for each module to make this as easy as possible.

The project is built to work with poetry. To use, follow the next few steps:

git clone https://github.com/blacklanternsecurity/offensive-azure.git
cd ./offensive-azure
poetry install

The packaged version of the repo is also kept on pypi so you can use pip to install as well. We recommend you use pipenv to keep your environment as clean as possible.

pipenv shell
pip install offensive_azure

It is up to you for how you wish to use this toolkit. Each module can be ran independently, or you can install it as a package and use it in that way. Each module is exported to a script named the same as the module file. For example:

poetry install
poetry run outsider_recon your-domain.com

pipenv shell
pip install offensive_azure
outsider_recon your-domain.com