Agent Framework no PyPI: alcance as identidades expostas
Duas releases maliciosas do Agent Framework chegaram ao projeto oficial no PyPI em 17 de novembro. A resposta empresarial precisa alcançar ambientes, caches e identidades que o código poderia acessar.
Read in EnglishPor Pentesty
Uma janela curta pode deixar cópias duradouras
As análises de Aikido e Wiz situam as publicações em 17 de novembro de 2026, às 20:35 e 21:08 UTC. Wiz registra que ambas já estavam indisponíveis por volta de 21:30 UTC. Na consulta de 18 de novembro, o PyPI apresentava 1.26.0 como versão atual. Esse recorte não limita a investigação aos minutos de distribuição pública.
Caches de dependências, mirrors internos e imagens podem conservar arquivos adquiridos anteriormente. Uma empresa que resolveu dependências naquele período deve relacionar o arquivo obtido aos builds e ambientes que o receberam, inclusive reexecuções posteriores. Comece por registros de instalação e resolução, com horário, versão, hash disponível e responsável pelo serviço. Uma referência em um arquivo de requisitos, sozinha, não demonstra instalação.
A execução não exigia importar o framework
Segundo a análise estática da StepSecurity, as distribuições adicionavam arquivos .pth em site-packages. Quando o Python processa esses arquivos na inicialização, suas linhas de importação podem executar código, comportamento documentado pelo projeto Python. O primeiro pacote usava agent_framework_meta.pth; o segundo, af_runtime_diag.pth, com o coletor em outro módulo. Verificar apenas os nomes da primeira versão deixa uma lacuna.
Isso não significa que toda instalação executou o payload imediatamente, nem que todos os ambientes virtuais do mesmo computador foram afetados. É preciso determinar qual interpretador processou o diretório comprometido e quando. Isole o ambiente antes de inspecioná-lo e use ferramentas confiáveis: iniciar seu Python ou pip pode acionar o gancho. Reconstrua a partir de uma base limpa e preserve os registros necessários à investigação.
Não transforme indicadores em conclusões maiores
Wiz relata, em atualização de 18 de novembro às 14:00 UTC, indícios de comprometimento de certificado e chave privada do serviço ESRP da Microsoft. Essa é uma conclusão dos pesquisadores; não a apresentamos como causa confirmada pela Microsoft. A consulta direta à issue 10411 estava indisponível durante esta apuração. Também não atribuímos os uploads a uma conta apenas por aparecer como mantenedora.
A StepSecurity orienta distinguir conexão ao domínio compartilhado webhook.site, tentativa bloqueada e transferência concluída para o caminho específico do incidente. Correlacione processo, horário e resultado HTTP quando esses dados existirem. Registros ausentes ou retenção insuficiente deixam incerteza. O volume mensal de downloads do projeto não corresponde ao número de instalações maliciosas nem ao de empresas atingidas.
Defina a retomada com evidências
Antes de retomar o fluxo, reúna a lista de ambientes reconstruídos, o bloqueio das duas versões nos controles de pacotes e a revisão de caches e imagens. Ligue cada identidade potencialmente exposta à decisão de contenção e aos eventos investigados. Preserve a distinção entre exposição presumida para resposta e uso malicioso comprovado.
Uma versão anterior limpa não elimina a necessidade de revisar toda a resolução de dependências. Nosso guia sobre proveniência de arquivos no PyPI complementa esse aceite. Para encerrar a parte de identidade, use a abordagem de revogação verificável: confirme o fim do acesso anterior, o funcionamento necessário e a recusa de operações fora do escopo, em testes autorizados.
Perguntas frequentes
Usar Agent Framework significa que minha empresa foi afetada?
Não automaticamente. Procure especificamente 1.26.1 e 1.26.2 nos registros de resolução, instalações, caches e imagens. Depois determine se o Python processou os ganchos naquele ambiente e quais identidades estavam acessíveis.
É seguro começar com pip show ou pip uninstall?
Não no ambiente suspeito antes da contenção. Essas ferramentas iniciam Python e podem processar o gancho. Preserve evidências com ferramentas confiáveis e planeje a reconstrução a partir de uma base limpa.
Trocar as chaves resolve toda a exposição?
A rotação é parte da resposta. Investigue também tokens já emitidos, identidades gerenciadas, confiança federada e atividade nos recursos. Documente o que foi invalidado e o que continua dependendo de restrições ou monitoramento.
Um build bem-sucedido descarta a execução maliciosa?
Não. Os relatos descrevem coleta em segundo plano e manutenção das dependências legítimas. Relacione o build às evidências de execução e rede, sem usar o resultado funcional como atestado de segurança.
Fontes e referências
- Wiz: análise e atualização de 18 de novembro
- StepSecurity: análise estática e contenção
- SafeDep: coleta de credenciais e limites de identidade
- Aikido: cronologia e diferenças entre as releases
- PyPI: estado atual do projeto agent-framework
- Python: processamento de arquivos de inicialização
- BleepingComputer: cobertura do incidente
- The Hacker News: cobertura do incidente
- SecurityWeek: cobertura e limites da investigação
Análise original da Pentesty, publicada em 18 de novembro de 2026. Os cenários propostos são orientações editoriais, com escopo e validação a definir para cada ambiente.