detecting-entra-offensive-tools-in-graph-logs
Faz seu agente caçar ferramentas ofensivas no Microsoft Graph. Ele analisa logs para identificar atividades de reconhecimento e exploração.
O que ela faz
Esta ferramenta procura por sinais de programas maliciosos usados para coletar informações sobre sua conta Microsoft. Ela verifica os registros de atividades do Microsoft Graph e do Azure AD Graph para identificar atividades suspeitas.
Quando usar
- ✓Quando você suspeita que suas credenciais da Microsoft foram roubadas.
- ✓Ao investigar atividades incomuns na sua conta Microsoft.
- ✓Durante testes de segurança para ver se ferramentas de ataque são detectáveis.
Exemplo do que pedir para a IA
“Procure por atividades suspeitas de coleta de informações na minha conta Microsoft.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta analisa os logs de atividades do Microsoft Graph e do Azure AD Graph. Ela procura por padrões específicos de uso e por assinaturas de programas conhecidos por coletar dados.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add mukul975/Anthropic-Cybersecurity-Skills --skill detecting-entra-offensive-tools-in-graph-logsOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/mukul975/Anthropic-Cybersecurity-Skills/main/skills/detecting-entra-offensive-tools-in-graph-logs/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Detecção de Ferramentas Ofensivas do Entra em Logs do Graph
Visão Geral
Por quase uma década, a antiga API do Azure AD Graph (graph.windows.net) foi um ponto cego para os defensores: requisições a ela não produziam um log de atividade de primeira classe, então ferramentas como ROADtools (roadrecon) e AADInternals — que dependem fortemente do AAD Graph — podiam enumerar um tenant inteiro com poucos rastros. Isso mudou quando a Microsoft lançou AADGraphActivityLogs (disponibilidade geral em 2026), o contraponto ao já disponível MicrosoftGraphActivityLogs (graph.microsoft.com). Juntas, essas duas tabelas dão aos SOCs visibilidade em nível de requisição para o tráfego da API de diretório: a identidade do chamador, o aplicativo, o IP de origem, o método HTTP, o URI da requisição e, crucialmente, o User-Agent.
Essa habilidade é o complemento defensivo para ferramentas ofensivas do Entra. Ela busca nas duas tabelas de atividade do Graph as impressões digitais comportamentais e de string que essas ferramentas deixam para trás. Muitos operadores esquecem de falsificar o User-Agent, então o ROADtools (construído sobre o aiohttp do Python) emite um User-Agent como Python/3.12 aiohttp/3.10.4, e o AADInternals frequentemente deixa AADInternals ou strings de biblioteca no agente. Mesmo quando o agente é falsificado, as ferramentas se traem através de um padrão característico de varredura de endpoints: roadrecon gather puxa users, groups, applications, serviceprincipals, devices, directoryroles, roledefinitions, oauth2permissiongrants e mais dentro de uma janela de tempo curta — uma assinatura que sobrevive à falsificação de cabeçalhos.
A atividade que está sendo detectada mapeia para o T1078.004 – Contas Válidas: Contas na Nuvem do MITRE ATT&CK: um adversário usando credenciais de nuvem legítimas (frequentemente phished ou roubadas via token) para enumerar e operar contra o tenant através das APIs do Graph. Essas detecções tanto expõem intrusões ativas quanto validam que as técnicas ofensivas nas habilidades de red-team complementares são observáveis.
Quando Usar
- Construindo ou ajustando detecções para Microsoft Sentinel / Log Analytics cobrindo o Entra ID
- Threat hunting após suspeita de roubo de credenciais, phishing de código de dispositivo ou abuso de consentimento OAuth
- Exercícios de purple-team validando que a atividade do ROADtools/AADInternals/AzureHound é detectável
- Investigando um alerta e precisando correlacionar chamadas da API do Graph de volta a um login/sessão
- Fechando a lacuna de visibilidade da antiga API do Azure AD Graph após habilitar o AADGraphActivityLogs
Pré-requisitos
- Um workspace do Microsoft Sentinel (ou Log Analytics) ingerindo:
- MicrosoftGraphActivityLogs (configuração de diagnóstico no Microsoft Entra ID -> graph.microsoft.com)
- AADGraphActivityLogs (configuração de diagnóstico no Microsoft Entra ID -> antiga API do Azure AD Graph)
SigninLogseAADNonInteractiveUserSignInLogspara correlação- RBAC do Microsoft Sentinel Reader/Responder (ou Log Analytics Reader) para executar KQL
- Familiaridade com Kusto Query Language (KQL)
- Habilitar as configurações de diagnóstico (Portal do Azure -> Microsoft Entra ID -> Configurações de diagnóstico -> enviar
MicrosoftGraphActivityLogseAADGraphActivityLogspara seu workspace), ou via CLI:az monitor diagnostic-settings create \ --name "entra-graph-logs" \ --resource "/providers/microsoft.aadiam/diagnosticSettings" \ --logs '[{"category":"MicrosoftGraphActivityLogs","enabled":true},{"category":"AADGraphActivityLogs","enabled":true}]' \ --workspace "<log-analytics-workspace-id>"
Objetivos
- Confirmar que ambas as tabelas de atividade do Graph estão fluindo para o workspace
- Detectar impressões digitais de strings de User-Agent do ROADtools, AADInternals e AzureHound
- Detectar a impressão digital comportamental de varredura de endpoints que sobrevive à falsificação de User-Agent
- Correlacionar atividade suspeita do Graph de volta a um login/sessão e identidade de origem
- Operacionalizar as melhores queries como regras de análise agendadas
Mapeamento MITRE ATT&CK
| ID | Técnica | Aplicação nesta habilidade |
|---|---|---|
| T1078.004 | Contas Válidas: Contas na Nuvem | Detectando adversários usando credenciais/tokens de nuvem válidos para enumerar o tenant via APIs do Microsoft Graph e da antiga API do Azure AD Graph |
Técnicas relacionadas expostas por essas caçadas: T1087.004 Descoberta de Conta: Conta na Nuvem, T1069.003 Descoberta de Grupos de Permissão: Grupos na Nuvem, T1526 Descoberta de Serviço na Nuvem.
Fluxo de Trabalho
Etapa 1: Confirmar que ambas as tabelas estão sendo ingeridas
Antes de caçar, verifique se os dados existem e inspecione os campos de esquema nos quais você irá pivotar.
union withsource=Tbl MicrosoftGraphActivityLogs, AADGraphActivityLogs
| where TimeGenerated > ago(1d)
…
Perguntas frequentes
O que são 'Graph Logs'?
São registros detalhados de todas as interações feitas com os serviços do Microsoft Graph e do Azure AD Graph, que são usados para gerenciar sua conta e recursos na Microsoft.
O que são 'ROADtools', 'AADInternals' e 'AzureHound'?
São exemplos de ferramentas que podem ser usadas para coletar informações sobre um ambiente Microsoft, às vezes de forma maliciosa. Esta ferramenta ajuda a detectá-las.
O que é 'User-Agent'?
É uma informação enviada pelo seu navegador ou programa para o site/serviço, identificando qual programa está se conectando. Ferramentas maliciosas podem tentar disfarçar essa informação.
Detalhes
Descrição original do autor
Hunt AADGraphActivityLogs and MicrosoftGraphActivityLogs in Microsoft Sentinel/Log Analytics using KQL to fingerprint offensive Entra ID enumeration tools such as ROADtools, AADInternals, and AzureHound, including User-Agent signatures, roadrecon endpoint sweeps, and sign-in correlation. Use when investigating suspicious Microsoft Graph API activity, Entra ID reconnaissance, or building Sentinel a
Popularidade
- Estrelas no GitHub
- 35 mil
- Posição no ranking
- #5664
- Licença
- Apache-2.0
- Atualizada em
- 31/08/2026
Comentários
- …
Mais skills deste repositório
abusing-dpapi-for-credential-access
Dá ao seu agente de IA instruções prontas para uma tarefa específica, para ele fazer melhor e mais rápido.
mukul975/Anthropic-Cybersecurity-Skills
abusing-shadow-credentials-for-privesc
Ensina seu agente de IA a escrever textos claros e bem estruturados.
mukul975/Anthropic-Cybersecurity-Skills
achieving-cmmc-level-2-compliance
Ajuda seu agente a preparar um ambiente para conformidade com CMMC Nível 2. Ele implementa requisitos de segurança e gerencia a documentação necessária.
mukul975/Anthropic-Cybersecurity-Skills
acquiring-disk-image-with-dd-and-dcfldd
Ajuda seu agente a criar cópias exatas de discos rígidos. Isso é útil para garantir que nenhuma informação seja perdida ou alterada durante investigações.
mukul975/Anthropic-Cybersecurity-Skills
Skills parecidas
dashboard-builder
Ajuda seu agente a criar painéis de monitoramento úteis. Ele transforma dados em gráficos que respondem a perguntas importantes sobre o sistema.
affaan-m/ECC
dev-team
Simula uma equipe de desenvolvimento colaborativa, onde diferentes papéis respondem a um problema juntos. É útil para obter múltiplas perspectivas sem trocar de agente manualmente.
affaan-m/ECC
ecc-council
Faz seu agente reunir um conselho de quatro vozes para tomar decisões difíceis. É útil quando há várias opções boas e é preciso debater antes de escolher.
affaan-m/ECC