Az - Інструменти для енумерації

Reading time: 17 minutes

Встановлення PowerShell в linux

sudo apt-get update
sudo apt-get install -y wget apt-transport-https software-properties-common

# Ubuntu 20.04
wget -q https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb

# Update repos
sudo apt-get update
sudo add-apt-repository universe

# Install & start powershell
sudo apt-get install -y powershell
pwsh

# Az cli
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Встановлення PowerShell на MacOS

Інструкції з documentation:

1. Встановіть brew, якщо він ще не встановлений:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Встановіть останній стабільний реліз PowerShell:

brew install powershell/tap/powershell

3. Запустіть PowerShell:

pwsh

4. Оновлення:

brew update
brew upgrade powershell

Основні інструменти енумерації

az cli

Azure Command-Line Interface (CLI) є кросплатформним інструментом, написаним на Python, для керування й адміністрування (більшості) ресурсів Azure та Entra ID. Він підключається до Azure і виконує адміністративні команди через командний рядок або скрипти.

Перейдіть за цим посиланням для installation instructions¡.

Команди в Azure CLI мають структуру за шаблоном: az <service> <action> <parameters>

Налагодження | MitM az cli

Використовуючи параметр --debug, можна побачити всі запити, які інструмент az відправляє:

az account management-group list --output table --debug

Щоб виконати MitM інструменту та вручну перевірити всі запити, які він надсилає, ви можете:

export ADAL_PYTHON_SSL_NO_VERIFY=1
export AZURE_CLI_DISABLE_CONNECTION_VERIFICATION=1
export HTTPS_PROXY="http://127.0.0.1:8080"
export HTTP_PROXY="http://127.0.0.1:8080"

# If this is not enough
# Download the certificate from Burp and convert it into .pem format
# And export the following env variable
openssl x509 -in ~/Downloads/cacert.der -inform DER -out ~/Downloads/cacert.pem -outform PEM
export REQUESTS_CA_BUNDLE=/Users/user/Downloads/cacert.pem

set ADAL_PYTHON_SSL_NO_VERIFY=1
set AZURE_CLI_DISABLE_CONNECTION_VERIFICATION=1
set HTTPS_PROXY="http://127.0.0.1:8080"
set HTTP_PROXY="http://127.0.0.1:8080"

# If this is not enough
# Download the certificate from Burp and convert it into .pem format
# And export the following env variable
openssl x509 -in cacert.der -inform DER -out cacert.pem -outform PEM
set REQUESTS_CA_BUNDLE=C:\Users\user\Downloads\cacert.pem

$env:ADAL_PYTHON_SSL_NO_VERIFY=1
$env:AZURE_CLI_DISABLE_CONNECTION_VERIFICATION=1
$env:HTTPS_PROXY="http://127.0.0.1:8080"
$env:HTTP_PROXY="http://127.0.0.1:8080"

Az PowerShell

Azure PowerShell — модуль з cmdlets для керування ресурсами Azure безпосередньо з командного рядка PowerShell.

Follow this link for the installation instructions.

Commands in Azure PowerShell AZ Module are structured like: <Action>-Az<Service> <parameters>

Debug | MitM Az PowerShell

За допомогою параметра -Debug можна побачити всі запити, які відправляє інструмент:

Get-AzResourceGroup -Debug

In order to do a MitM to the tool and check all the requests it's sending manually you can set the env variables HTTPS_PROXY and HTTP_PROXY according to the docs.

Microsoft Graph PowerShell

Microsoft Graph PowerShell — кросплатформений SDK, який дозволяє отримувати доступ до всіх Microsoft Graph APIs, включно зі сервісами, такими як SharePoint, Exchange та Outlook, використовуючи єдину точку входу. Він підтримує PowerShell 7+, сучасну автентифікацію через MSAL, зовнішні ідентичності та розширені запити. Орієнтований на принцип найменших привілеїв, він забезпечує безпечну роботу та регулярно оновлюється, щоб відповідати останнім можливостям Microsoft Graph API.

Перейдіть за цим посиланням для installation instructions.

Команди в Microsoft Graph PowerShell мають структуру: <Action>-Mg<Service> <parameters>

Debug Microsoft Graph PowerShell

Використовуючи параметр -Debug, можна побачити всі запити, які інструмент надсилає:

Get-MgUser -Debug

AzureAD Powershell

Модуль Azure Active Directory (AD), тепер застарілий, є частиною Azure PowerShell для керування ресурсами Azure AD. Він надає cmdlets для завдань, таких як керування користувачами, групами та реєстраціями додатків в Entra ID.

Перейдіть за цим посиланням для інструкцій з встановлення.

Автоматизована розвідка та інструменти відповідності

turbot azure plugins

Turbot у поєднанні зі steampipe та powerpipe дозволяє збирати інформацію з Azure та Entra ID, виконувати перевірки відповідності та виявляти неправильні налаштування. Наразі найбільш рекомендовані до запуску модулі Azure:

• https://github.com/turbot/steampipe-mod-azure-compliance
• https://github.com/turbot/steampipe-mod-azure-insights
• https://github.com/turbot/steampipe-mod-azuread-insights

# Install
brew install turbot/tap/powerpipe
brew install turbot/tap/steampipe
steampipe plugin install azure
steampipe plugin install azuread

# Config creds via env vars or az cli default creds will be used
export AZURE_ENVIRONMENT="AZUREPUBLICCLOUD"
export AZURE_TENANT_ID="<tenant-id>"
export AZURE_SUBSCRIPTION_ID="<subscription-id>"
export AZURE_CLIENT_ID="<client-id>"
export AZURE_CLIENT_SECRET="<secret>"

# Run steampipe-mod-azure-insights
cd /tmp
mkdir dashboards
cd dashboards
powerpipe mod init
powerpipe mod install github.com/turbot/steampipe-mod-azure-insights
steampipe service start
powerpipe server
# Go to http://localhost:9033 in a browser

Prowler

Prowler — це інструмент безпеки з відкритим кодом для проведення оцінок відповідності найкращим практикам безпеки, аудитів, реагування на інциденти, постійного моніторингу, посилення безпеки та готовності до судово-експертних розслідувань в середовищах AWS, Azure, Google Cloud і Kubernetes.

Він дозволяє виконати сотні перевірок середовища Azure для виявлення конфігураційних помилок безпеки та зібрати результати у форматі json (та інших текстових форматах) або переглянути їх у веб-інтерфейсі.

# Create a application with Reader role and set the tenant ID, client ID and secret in prowler so it access the app

# Launch web with docker-compose
export DOCKER_DEFAULT_PLATFORM=linux/amd64
curl -LO https://raw.githubusercontent.com/prowler-cloud/prowler/refs/heads/master/docker-compose.yml
curl -LO https://raw.githubusercontent.com/prowler-cloud/prowler/refs/heads/master/.env
## If using an old docker-compose version, change the "env_file" params to: env_file: ".env"
docker compose up -d
# Access the web and configure the access to run a scan from it

# Prowler cli
python3 -m pip install prowler --break-system-packages
docker run --rm toniblyx/prowler:v4-latest azure --list-checks
docker run --rm toniblyx/prowler:v4-latest azure --list-services
docker run --rm toniblyx/prowler:v4-latest azure --list-compliance
docker run --rm -e "AZURE_CLIENT_ID=<client-id>" -e "AZURE_TENANT_ID=<tenant-id>" -e "AZURE_CLIENT_SECRET=<secret>" toniblyx/prowler:v4-latest azure --sp-env-auth
## It also support other authentication types, check: prowler azure --help

Monkey365

Дозволяє автоматично виконувати перевірки конфігурації безпеки підписок Azure та Microsoft Entra ID.

HTML-звіти зберігаються в каталозі ./monkey-reports всередині папки репозиторію github.

git clone https://github.com/silverhack/monkey365
Get-ChildItem -Recurse monkey365 | Unblock-File
cd monkey365
Import-Module ./monkey365
mkdir /tmp/monkey365-scan
cd /tmp/monkey365-scan

Get-Help Invoke-Monkey365
Get-Help Invoke-Monkey365 -Detailed

# Scan with user creds (browser will be run)
Invoke-Monkey365 -TenantId <tenant-id> -Instance Azure -Collect All -ExportTo HTML

# Scan with App creds
$SecureClientSecret = ConvertTo-SecureString "<secret>" -AsPlainText -Force
Invoke-Monkey365 -TenantId <tenant-id> -ClientId <client-id> -ClientSecret $SecureClientSecret -Instance Azure -Collect All -ExportTo HTML

ScoutSuite

Scout Suite збирає дані конфігурації для ручної перевірки та виділяє області ризику. Це багатохмарний інструмент аудиту безпеки, який дозволяє оцінювати стан безпеки хмарних середовищ.

virtualenv -p python3 venv
source venv/bin/activate
pip install scoutsuite
scout --help

# Use --cli flag to use az cli credentials
# Use --user-account to have scout prompt for user credentials
# Use --user-account-browser to launch a browser to login
# Use --service-principal to have scout prompt for app credentials

python scout.py azure --cli

Azure-MG-Sub-Governance-Reporting

Це powershell-скрипт, який допомагає вам візуалізувати всі ресурси та дозволи всередині Management Group і Entra ID tenant та виявляти помилки конфігурації безпеки.

Він працює з використанням Az PowerShell module, тому підтримуються будь-які методи автентифікації, які підтримує цей інструмент.

import-module Az
.\AzGovVizParallel.ps1 -ManagementGroupId <management-group-id> [-SubscriptionIdWhitelist <subscription-id>]

Автоматизовані Post-Exploitation інструменти

ROADRecon

Енумерація ROADRecon надає інформацію про конфігурацію Entra ID, таку як користувачі, групи, ролі, політики умовного доступу...

cd ROADTools
pipenv shell
# Login with user creds
roadrecon auth -u test@corp.onmicrosoft.com -p "Welcome2022!"
# Login with app creds
roadrecon auth --as-app --client "<client-id>" --password "<secret>" --tenant "<tenant-id>"
roadrecon gather
roadrecon gui

AzureHound

AzureHound — колектор BloodHound для Microsoft Entra ID та Azure. Це один статичний Go-бінарний файл для Windows/Linux/macOS, який безпосередньо взаємодіє з:

• Microsoft Graph (каталог Entra ID, M365) та
• Azure Resource Manager (ARM) control plane (subscriptions, resource groups, compute, storage, key vault, app services, AKS тощо)

Ключові характеристики

• Працює з будь-якої точки публічного інтернету проти tenant APIs (доступ до внутрішньої мережі не потрібен)
• Виводить JSON для імпорту в BloodHound CE, щоб візуалізувати шляхи атаки між ідентичностями та хмарними ресурсами
• Значення User-Agent за замовчуванням: azurehound/v2.x.x

Параметри автентифікації

• Username + password: -u -p
• Refresh token: --refresh-token
• JSON Web Token (access token): --jwt
• Service principal secret: -a -s
• Service principal certificate: -a --cert <cert.pem> --key <key.pem> [--keypass ]

Приклади

# Full tenant collection to file using different auth flows
## User creds
azurehound list -u "<user>@<tenant>" -p "<pass>" -t "<tenant-id|domain>" -o ./output.json

## Use an access token (JWT) from az cli for Graph
JWT=$(az account get-access-token --resource https://graph.microsoft.com -o tsv --query accessToken)
azurehound list --jwt "$JWT" -t "<tenant-id>" -o ./output.json

## Use a refresh token (e.g., from device code flow)
azurehound list --refresh-token "<refresh_token>" -t "<tenant-id>" -o ./output.json

## Service principal secret
azurehound list -a "<client-id>" -s "<secret>" -t "<tenant-id>" -o ./output.json

## Service principal certificate
azurehound list -a "<client-id>" --cert "/path/cert.pem" --key "/path/key.pem" -t "<tenant-id>" -o ./output.json

# Targeted discovery
azurehound list users -t "<tenant-id>" -o users.json
azurehound list groups -t "<tenant-id>" -o groups.json
azurehound list roles -t "<tenant-id>" -o roles.json
azurehound list role-assignments -t "<tenant-id>" -o role-assignments.json

# Azure resources via ARM
azurehound list subscriptions -t "<tenant-id>" -o subs.json
azurehound list resource-groups -t "<tenant-id>" -o rgs.json
azurehound list virtual-machines -t "<tenant-id>" -o vms.json
azurehound list key-vaults -t "<tenant-id>" -o kv.json
azurehound list storage-accounts -t "<tenant-id>" -o sa.json
azurehound list storage-containers -t "<tenant-id>" -o containers.json
azurehound list web-apps -t "<tenant-id>" -o webapps.json
azurehound list function-apps -t "<tenant-id>" -o funcapps.json

What gets queried

• Graph endpoints (приклади):
• /v1.0/organization, /v1.0/users, /v1.0/groups, /v1.0/roleManagement/directory/roleDefinitions, directoryRoles, owners/members
• ARM endpoints (приклади):
• management.azure.com/subscriptions/.../providers/Microsoft.Storage/storageAccounts
• .../Microsoft.KeyVault/vaults, .../Microsoft.Compute/virtualMachines, .../Microsoft.Web/sites, .../Microsoft.ContainerService/managedClusters

Preflight behavior and endpoints

• Кожен azurehound list