azurefox 1.4.0

AzureFox - offensive-focused Azure situational awareness CLI

AzureFox

Find attack paths, pivot opportunities, and movement across Azure before you drown in inventory.

Most Azure tools tell you what exists. AzureFox tells you how an identity can move between those resources. Most Azure tools dump permissions. AzureFox highlights which relationships, pivots, and escalation paths matter first.

Why This Matters

You have:

• a compromised user
• service principal access
• a managed identity foothold
• partial subscription visibility

You need to answer quickly:

• What identity am I actually holding?
• What can it control right now?
• Where can it pivot next?
• Which path is most likely to become privilege escalation or broader Azure control?

AzureFox is built for that workflow.

Why This Is Different

• Attack-path thinking, not inventory-first reporting
• Pivot-first workflow, not isolated command output
• Identity and permission relationships, not just raw role listings
• Operator guidance that points to the next path worth investigating
• Broader than a foothold check: useful for movement, consequence, and follow-on access across Azure

Core Capabilities

• Show the active Azure identity, token context, and scope you are operating from
• Surface high-impact RBAC and permission relationships that change what the current identity can do
• Map identity trust, service principal ownership, federated credentials, and cross-tenant edges
• Highlight pivot paths through workloads, managed identities, deployment systems, and secret-bearing configuration
• Expose escalation opportunities and likely next steps instead of leaving you to sort raw Azure data

Install

pipx install azurefox

Operator Workflow

Start with the identity you have, then work outward toward movement and consequence:

azurefox whoami
azurefox permissions
azurefox privesc
azurefox role-trusts
azurefox cross-tenant
azurefox tokens-credentials
azurefox chains

Typical flow:

• whoami: confirm the current foothold, token context, and subscription scope
• permissions: identify where that identity already has meaningful control
• privesc: surface direct abuse or escalation paths rooted in the current access
• role-trusts and cross-tenant: find identity-control transforms and tenant boundary pivots
• tokens-credentials and chains: follow token, secret, and deployment clues toward the next usable path

Operator Outcome

After one pass, you should know:

• which identity matters
• what access is real versus merely visible
• where the best pivot opportunities are
• which attack path deserves follow-up first

AzureFox reduces noise by ranking consequence, not just returning Azure objects.

Use Cases

• Triage a compromised user, service principal, or managed identity and determine what Azure control it enables
• Assess whether a service principal or application relationship creates a pivot or escalation path
• Work outward from subscription or tenant visibility to identify cross-resource and cross-tenant movement

Run It

Start with the current Azure identity and the strongest visible control paths:

azurefox whoami
azurefox permissions

Currently Supported Azure Commands

Orchestration

Grouped Command

Live Families

chains Grouped path views that pull the strongest Azure pivot stories to the top.

credential-path Turns exposed secret and token clues into the downstream target most likely to widen access. deployment-path Surfaces the build, pipeline, and automation paths most likely to let an attacker change Azure next. escalation-path Highlights the clearest visible route from the current foothold to stronger Azure control. compute-control Finds workloads that can already mint identity-backed access and pivot into broader control.

Flat Commands

Section	Commands
core	inventory
identity	whoami, rbac, principals, permissions, privesc, role-trusts, lighthouse, auth-policies, managed-identities
config	arm-deployments, env-vars
secrets	keyvault, tokens-credentials
resource	automation, devops, acr, api-mgmt, databases, resource-trusts
storage	storage
network	nics, dns, endpoints, network-effective, network-ports
compute	workloads, app-services, functions, container-apps, container-instances, aks, vms, vmss, snapshots-disks

Need A Test Lab?

Don't have an Azure environment handy? The companion repo AzureFox OpenTofu Proof Lab spins up a deliberately insecure Azure lab for demos, validation, and practice.

Use a disposable subscription you control. It is risky on purpose.

CLI Invocation

Shared flags like --tenant, --subscription, --output, --outdir, and --debug work before or after the command.

These forms are equivalent:

azurefox dns --output json --outdir ./azurefox-demo
azurefox --output json --outdir ./azurefox-demo dns

Use azurefox <command> --help or azurefox help <command> for command-specific help.

Install Profiles

AzureFox installs the live Azure runtime dependencies by default so pip install azurefox is ready for real Azure command execution.

If you prefer an isolated virtual environment:

python -m venv .venv
# macOS/Linux
source .venv/bin/activate
# Windows PowerShell
# .venv\Scripts\Activate.ps1
pip install azurefox

For local source-based development, use pip install -e '.[dev]'.

AzureFox is intended to work on macOS, Linux, and Windows. The command examples below use portable relative paths like ./azurefox-demo; shell syntax mainly differs for virtualenv activation and environment-variable export.

Live operator guidance is built into azurefox help and azurefox help <command>.

• pip install azurefox installs the normal operator profile from PyPI, including the Azure SDK dependencies used by the implemented live commands
• pip install -e . installs the same live Azure command profile from a local checkout
• pip install -e '.[dev]' installs contributor tooling on top of the default live Azure dependencies; this is the normal repo development profile

Auth Precedence

1. Azure CLI credential
2. Environment credential

Supported auth matrix

Path	How it starts	Current support	Metadata auth_mode
Interactive user via Azure CLI	az login	supported	azure_cli_user
Service principal via Azure CLI	az login --service-principal ...	supported through Azure CLI	azure_cli_service_principal
Managed identity via Azure CLI	az login --identity	supported through Azure CLI	azure_cli_managed_identity
Service principal via environment client secret	AZURE_TENANT_ID + AZURE_CLIENT_ID + AZURE_CLIENT_SECRET	supported	environment_client_secret
Service principal via environment certificate	AZURE_TENANT_ID + AZURE_CLIENT_ID + AZURE_CLIENT_CERTIFICATE_PATH	supported	environment_client_certificate

AzureFox does not launch its own browser or managed-identity login flow. It relies on Azure Identity:

• AzureCliCredential for the active Azure CLI sign-in state
• EnvironmentCredential for service principal environment variables

Interactive user via Azure CLI

If you want web-based authentication, run az login first (outside AzureFox), then run AzureFox. AzureFox does not currently launch its own browser auth flow.

Azure CLI example:

az login
az account set --subscription <subscription-id>
azurefox inventory --subscription <subscription-id>

Service principal via Azure CLI

This is useful for headless automation that still wants Azure CLI to hold the active login state.

With a client secret:

az login --service-principal \
  --username <client-id> \
  --password <client-secret> \
  --tenant <tenant-id>
az account set --subscription <subscription-id>
azurefox whoami --subscription <subscription-id>

With a certificate:

az login --service-principal \
  --username <client-id> \
  --certificate /path/to/certificate.pem \
  --tenant <tenant-id>
az account set --subscription <subscription-id>
azurefox whoami --subscription <subscription-id>

Service principal via environment client secret

If you do not want to use Azure CLI login state, set service principal environment variables and pass CLI flags for tenant/subscription targeting.

Environment client-secret example:

# macOS/Linux
export AZURE_TENANT_ID=<tenant-id>
export AZURE_CLIENT_ID=<client-id>
export AZURE_CLIENT_SECRET=<client-secret>
export AZUREFOX_DEVOPS_ORG=<org-name> # only needed for the devops command
azurefox whoami --tenant <tenant-id> --subscription <subscription-id>

# Windows PowerShell
$env:AZURE_TENANT_ID="<tenant-id>"
$env:AZURE_CLIENT_ID="<client-id>"
$env:AZURE_CLIENT_SECRET="<client-secret>"
$env:AZUREFOX_DEVOPS_ORG="<org-name>" # only needed for the devops command
azurefox whoami --tenant <tenant-id> --subscription <subscription-id>

Service principal via environment certificate

# macOS/Linux
export AZURE_TENANT_ID=<tenant-id>
export AZURE_CLIENT_ID=<client-id>
export AZURE_CLIENT_CERTIFICATE_PATH=/path/to/certificate.pem
export AZURE_CLIENT_CERTIFICATE_PASSWORD=<optional-password>
azurefox whoami --tenant <tenant-id> --subscription <subscription-id>

# Windows PowerShell
$env:AZURE_TENANT_ID="<tenant-id>"
$env:AZURE_CLIENT_ID="<client-id>"
$env:AZURE_CLIENT_CERTIFICATE_PATH="C:\\path\\to\\certificate.pem"
$env:AZURE_CLIENT_CERTIFICATE_PASSWORD="<optional-password>"
azurefox whoami --tenant <tenant-id> --subscription <subscription-id>

Azure-hosted managed identity via Azure CLI

This works when you are running on an Azure resource that already has a managed identity attached.

az login --identity
az account set --subscription <subscription-id>
azurefox whoami --subscription <subscription-id>

For a user-assigned managed identity:

az login --identity --client-id <user-assigned-managed-identity-client-id>
az account set --subscription <subscription-id>
azurefox whoami --subscription <subscription-id>

AZUREFOX_DEVOPS_ORG is only needed when running the devops command. The identity used for devops still needs access to the Azure DevOps organization, not just ARM access to the tenant or subscription.

Output Modes

• --output table (default)
• --output json
• --output csv

All commands write artifacts under <outdir>/:

• loot/<command>.json

• json/<command>.json

• table/<command>.txt

• csv/<command>.csv Artifact intent:

• json/ is the full structured command record.

• loot/ is the smaller high-value handoff, focused on the top-ranked targets for quick operator follow-up and later chain-oriented workflows.

• table/ and csv/ are convenience views rendered from the same underlying command result.

Sections And Chains

AzureFox keeps flat standalone commands and also supports grouped execution through chains.

For narrower current work:

• run the flat commands directly when you already know the lane you want
• use chains when you want a higher-value grouped answer instead of every source command on its own

Current section mappings:

• identity: whoami, rbac, principals, permissions, privesc, role-trusts, lighthouse, auth-policies, managed-identities
• config: arm-deployments, env-vars
• secrets: keyvault, tokens-credentials
• resource: automation, devops, acr, api-mgmt, databases, resource-trusts
• storage: storage
• network: nics, dns, endpoints, network-effective, network-ports
• compute: workloads, app-services, functions, aks, vms, vmss, snapshots-disks
• core: inventory

Help

AzureFox supports generic and scoped help:

azurefox help
azurefox help identity
azurefox help permissions
azurefox dns --help
azurefox -h identity
azurefox -h permissions

Command help includes ATT&CK cloud leads as investigation prompts, not proof that a technique occurred.

Help also points grouped follow-up toward chains where those presets exist.

For ad hoc demos or local testing, use a dedicated path like --outdir ./azurefox-demo so artifacts do not pile up in the repo root.

Fixture Mode

Set AZUREFOX_FIXTURE_DIR to run against local fixture files rather than Azure APIs.

# macOS/Linux
AZUREFOX_FIXTURE_DIR=tests/fixtures/lab_tenant azurefox rbac --output json

# Windows PowerShell
$env:AZUREFOX_FIXTURE_DIR="tests/fixtures/lab_tenant"
azurefox rbac --output json

Development

pip install -e '.[dev]'
ruff check .
pytest

CI runs lint plus unit, contract, and smoke tests. Integration tests are opt-in.

Attribution

AzureFox is inspired by CloudFox, created by Bishop Fox.

License

AzureFox is licensed under the MIT License. See LICENSE.