ATEAM: Módulo de Enumeração e Atribuição de Inquilinos do Azure

Uma ferramenta de reconhecimento em Python projetada para descobrir serviços do Azure e atribuir informações de propriedade de inquilinos com base em suas respostas.

Autor, Contribuidores e Licença

• Autores:
  • Karl Fosaaen (@kfosaaen - Na maioria das plataformas), NetSPI
  • Thomas Elling (@thomaselling1), NetSPI
• Licença: BSD 3-Clause

🎯 Propósito

Esta ferramenta ajuda pesquisadores de segurança, testadores de penetração e administradores do Azure a descobrir recursos do Azure associados a IDs de inquilinos específicos.

✨ Funcionalidades

Descoberta Multi-Serviço

Testa nomes de recursos contra 6 serviços diferentes do Azure e seus subdomínios:

• Azure App Services (.azurewebsites.net e .scm.azurewebsites.net)
• Azure DevOps (dev.azure.com)
• Azure Key Vault (.vault.azure.net)
• Azure Storage Accounts (.blob.core.windows.net)
• SharePoint Online (.sharepoint.com)
• Azure Databricks (.azuredatabricks.net)

Capacidades Adicionais

• Processamento Concorrente: Varredura multi-thread para resultados mais rápidos
• Processamento em Lotes: Processa recursos em lotes configuráveis para evitar problemas de memória
• Validação de DNS: Confirma registros DNS antes de fazer requisições HTTP
• Geração de Permutações: Gera automaticamente variações de nomes de recursos
• Armazenamento em Banco de Dados: Banco de dados SQLite para resultados persistentes
• Múltiplos Formatos de Exportação: Exportação CSV, JSON e HTML
• Registro Detalhado: Informações de depuração detalhadas para solução de problemas

📋 Pré-requisitos

• Python 3.7 ou superior
• Conexão com a internet
• Pacotes Python necessários (veja Instalação abaixo)

🚀 Instalação

1. Clone ou baixe a ferramenta:

   root@kitploit:~

   git clone https://github.com/NetSPI/ATEAM.git
   cd ATEAM
   

2. Instale as dependências necessárias:

   root@kitploit:~

   pip install -r requirements.txt
   

   Ou instale manualmente:

   root@kitploit:~

   pip install requests dnspython urllib3
   

3. Verifique a instalação:

   root@kitploit:~

   python ateam.py --help
   

📖 Uso

Uso Básico

Escanear um único recurso:

python ateam.py -r "myapp"

Escanear múltiplos recursos:

python ateam.py -r "app1" "app2" "app3"

Escanear a partir de um arquivo de texto com lista de recursos:

python ateam.py -f resources.txt

Uso Avançado

Saída detalhada com (20) workers:

python ateam.py -f resources.txt -v -w 20

Gerar permutações e escanear:

python ateam.py -f resources.txt -p

Gerar permutações com tamanho de lote menor (recomendado para varreduras grandes):

python ateam.py -f resources.txt -p -b 100

Exportar resultados para HTML:

python ateam.py -e html

Limpar banco de dados e começar do zero:

python ateam.py -f resources.txt --clear

Opções de Linha de Comando

📁 Estrutura de Arquivos

ATEAM/
├── ateam.py    # Script principal
├── requirements.txt          # Dependências Python
├── permutations.txt          # Permutações de nomes de recursos
└── README.md                 # Este arquivo

🔧 Configuração

Arquivo de Permutações

O arquivo permutations.txt contém prefixos e sufixos comuns para gerar variações de nomes de recursos:

dev
prod
test
staging
api
web
...

Isso gerará combinações como:

• devmyapp
• myappdev
• prodmyapp
• myapp-prod
• etc.

Banco de Dados

Os resultados são armazenados em azure_tenants.db (SQLite) com o seguinte esquema:

• resource_uri: A URL do recurso descoberto
• resource_type: Tipo de serviço do Azure
• tenant_id: ID do inquilino extraído
• discovered_at: Carimbo de data/hora da descoberta

📊 Exemplos de Saída

Saída do Console

2025-06-27 14:37:39 - INFO - Found Storage Account tenant ID 72f988bf-86f1-41af-91ab-2d7cd011db47 for mars
2025-06-27 14:37:40 - INFO - Found App Service SCM tenant ID 'common' for notarealapplication
2025-06-27 14:37:47 - INFO - Found Key Vault tenant ID 72f988bf-86f1-41af-91ab-2d7cd011db47 for mdo

Listagem do Banco de Dados

Resource URI                             Type            Tenant ID                      	  Discovered At
-----------------------------------------------------------------------------------------------------------------
hanover.scm.azurewebsites.net            AppServices-SCM 72f988bf-86f1-41af-91ab-2d7cd011db47 2025-06-27 21:37:41
dev.azure.com/microsoft                  DevOps          72f988bf-86f1-41af-91ab-2d7cd011db47 2025-06-27 21:37:12
mdo.vault.azure.net                      KeyVault        72f988bf-86f1-41af-91ab-2d7cd011db47 2025-06-27 21:37:47
mars.blob.core.windows.net               StorageAccount  72f988bf-86f1-41af-91ab-2d7cd011db47 2025-06-27 21:37:46

🔍 Como Funciona

1. Validação de DNS: Verifica se existem registros DNS para o recurso
2. Sondagem de Serviço: Faz requisições HTTP aos endpoints de serviço do Azure aplicáveis
3. Análise de Resposta: Dependendo do recurso, extrai IDs de inquilinos de:
   • Cabeçalhos WWW-Authenticate
   • URLs de redirecionamento OAuth
   • Cabeçalhos de resposta
   • Mensagens de erro
4. Armazenamento de Dados: Salva resultados no banco de dados SQLite
5. Exportação: Gera relatórios em vários formatos

🛡️ Considerações de Segurança

• Limitação de Taxa: A ferramenta inclui atrasos e respeita limites de serviço
• Tratamento de Erros: Tratamento elegante de timeouts e erros
• Registro: Logs detalhados para trilhas de auditoria
• Não Intrusivo: Usa requisições HTTP padrão sem autenticação para fazer enumeração anônima

⚠️ Importante: Sempre garanta que você tenha autorização adequada antes de escanear qualquer recurso. Escaneamento não autorizado pode violar termos de serviço ou leis aplicáveis.

🐛 Solução de Problemas

Modo de Depuração

Você pode habilitar o registro detalhado para informações detalhadas, mas pode ser um pouco excessivo:

python ateam.py -f resources.txt -v

Problemas de Memória com Permutações

Se você receber mensagens 'killed' ao usar permutações, tente reduzir o tamanho do lote:

python ateam.py -f resources.txt -p -b 100 -w 5

Isso processa recursos em lotes menores com menos workers simultâneos para evitar esgotamento de memória.

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar:

• Relatórios de bugs
• Solicitações de funcionalidades
• Melhorias de código
• Atualizações de documentação

Blogs Relacionados

• Sabemos o que você fez (no Azure) no verão passado

Apresentações

• Sabemos o que você fez (no Azure) no verão passado - DEF CON 33 - Cloud Village
  • Slides