O Microsoft Agent Framework, biblioteca de código aberto utilizada no desenvolvimento de agentes de inteligência artificial, foi alvo de um ataque à cadeia de suprimentos que colocou em risco credenciais de nuvem, tokens de autenticação e segredos armazenados em ambientes de desenvolvimento. Invasores conseguiram publicar versões maliciosas do pacote oficial no Python Package Index (PyPI), distribuindo um malware projetado para coletar informações sensíveis de desenvolvedores e infraestruturas corporativas.
O comprometimento atingiu especificamente as versões 1.26.1 e 1.26.2, publicadas em 17 de novembro de 2026. O aspecto mais preocupante do ataque é a técnica utilizada para executar o código malicioso automaticamente durante a inicialização do Python, mesmo quando o desenvolvedor não importa explicitamente a biblioteca comprometida.
Com aproximadamente 200 mil downloads mensais, o framework representa um alvo relevante para ataques à cadeia de suprimentos de software. O incidente foi identificado por empresas especializadas em segurança, incluindo Socket, Step Security e Ox Security, que apontaram o comportamento malicioso das versões distribuídas. O episódio demonstra como até mesmo pacotes oficiais de grandes empresas podem se transformar em vetores de comprometimento quando suas credenciais de publicação são utilizadas indevidamente.
Como ocorreu o ataque ao Microsoft Agent Framework no PyPI
O ataque começou com a publicação das versões 1.26.1 e 1.26.2 do Microsoft Agent Framework no PyPI, em 17 de novembro de 2026. Embora apresentassem a aparência de atualizações legítimas, ambas continham mecanismos maliciosos destinados à coleta e à transmissão de informações confidenciais dos ambientes nos quais eram instaladas.
Uma estratégia utilizada pelos invasores foi preservar a dependência legítima agent-framework-core na versão 1.26.0. Essa decisão ajudava a reduzir as suspeitas durante uma análise superficial do pacote, pois mantinha uma dependência reconhecível e aparentemente compatível com a estrutura oficial do projeto.
O comportamento demonstra uma característica recorrente dos ataques à cadeia de suprimentos: em vez de comprometer necessariamente todas as dependências de uma aplicação, os invasores podem modificar componentes específicos e preservar elementos legítimos para dificultar a identificação da ameaça.
A reação dos responsáveis pela plataforma não impediu imediatamente uma nova tentativa. Depois que a primeira versão foi colocada em quarentena no PyPI, o invasor publicou a versão 1.26.2 apenas 2,5 minutos depois.
Essa rapidez é particularmente preocupante porque indica que a interrupção de uma distribuição maliciosa não significa necessariamente que o acesso utilizado pelo atacante foi revogado. A publicação da segunda versão mostra que o mecanismo de comprometimento continuava operacional naquele momento.

Como o malware executava código automaticamente por meio de arquivos .pth
Um dos aspectos mais perigosos do incidente foi a utilização de arquivos com extensão .pth, um mecanismo legítimo do ecossistema Python que pode ser abusado para executar código durante a inicialização do interpretador.
Normalmente, arquivos .pth são utilizados para adicionar caminhos aos locais de busca de módulos do Python. Entretanto, eles também podem conter determinadas instruções que são executadas automaticamente quando o interpretador inicializa e processa os diretórios de pacotes instalados.
Os invasores exploraram justamente esse comportamento para estabelecer uma execução silenciosa, sem depender de uma importação explícita do Microsoft Agent Framework.
Na versão 1.26.1, o mecanismo malicioso utilizava o arquivo:
– agent_framework_meta.pth
Esse arquivo acionava o componente agent_framework_meta/_telemetry.py, responsável pela execução da lógica de coleta de informações.
Na versão 1.26.2, os invasores modificaram a estrutura utilizada para manter o mecanismo de execução:
af_runtime_diag.pthaf_runtime_diag.py
A mudança de nomes e arquivos não eliminou o comportamento malicioso. O código continuava sendo acionado durante a inicialização do Python, permitindo que a ameaça operasse mesmo quando o desenvolvedor não executava nenhuma funcionalidade específica do framework.
Isso amplia consideravelmente o alcance potencial do comprometimento. Uma instalação contaminada poderia continuar executando o código malicioso durante operações aparentemente comuns, como a inicialização de ferramentas de desenvolvimento, execução de scripts e utilização de aplicações Python.
Além disso, o comportamento dificulta a identificação por quem procura exclusivamente por chamadas suspeitas de importação da biblioteca. O pacote poderia permanecer aparentemente inativo do ponto de vista da aplicação, enquanto o mecanismo instalado continuava executando sua rotina.
Quais credenciais e tokens de nuvem eram roubados
O objetivo central do malware era coletar segredos disponíveis no ambiente de execução. Isso incluía informações armazenadas em variáveis de ambiente, arquivos locais e processos acessíveis ao usuário que executava o Python.
A abrangência da coleta é especialmente preocupante para desenvolvedores que trabalham com múltiplos provedores de nuvem, serviços de inteligência artificial e plataformas de integração contínua.
Entre os dados visados estavam:
- Microsoft Azure: credenciais, informações de autenticação e tokens de identidade gerenciada.
- Amazon Web Services (AWS): credenciais de acesso e informações de autenticação disponíveis no ambiente.
- GitHub: tokens de acesso utilizados por desenvolvedores e processos automatizados.
- Docker: credenciais e informações de autenticação relacionadas aos ambientes de contêineres.
- Hugging Face: tokens utilizados para acessar modelos, repositórios e serviços da plataforma.
- OpenAI: chaves e credenciais de API disponíveis no ambiente.
- Azure Managed Identity: tokens associados à identidade gerenciada de recursos hospedados na infraestrutura Azure.
- Azure DevOps: tokens de identidade federada OIDC utilizados em processos de autenticação.
- GitHub Actions: na versão 1.26.2, a coleta também abrangia tokens OIDC e informações relacionadas aos diretórios dos runners.
O destaque para os tokens OIDC (OpenID Connect) merece atenção especial. Esse mecanismo permite que sistemas automatizados obtenham credenciais temporárias por meio de federação de identidade, reduzindo a necessidade de armazenar chaves permanentes em pipelines.
Entretanto, a presença desses tokens no ambiente de execução significa que um processo malicioso pode tentar utilizá-los para acessar recursos autorizados durante sua validade.
No caso do GitHub Actions, a ampliação da coleta para os diretórios dos runners também representa um risco importante. Esses ambientes executam tarefas automatizadas de compilação, testes e implantação, podendo ter acesso a segredos e permissões de infraestrutura.
Depois de coletar as informações, o malware utilizava o endereço webhook.site como endpoint de exfiltração. Na prática, isso significa que os dados capturados eram enviados para uma infraestrutura externa controlada ou utilizada pelos operadores do ataque.
O incidente evidencia que o comprometimento de uma dependência Python pode ultrapassar os limites da aplicação que a utiliza. Quando um pacote consegue acessar credenciais presentes no ambiente, o impacto pode alcançar serviços de nuvem, repositórios de código e pipelines de implantação.
Como proteger seu ambiente após o comprometimento do Microsoft Agent Framework
Desenvolvedores e equipes de DevOps que instalaram as versões comprometidas precisam tratar o ambiente como potencialmente exposto. Simplesmente atualizar o pacote não é suficiente, pois credenciais podem ter sido coletadas antes da remoção do código malicioso.
A resposta deve envolver isolamento, investigação, reconstrução do ambiente e substituição dos segredos potencialmente comprometidos.
1. Identifique as versões instaladas
Verifique os arquivos de dependências, ambientes virtuais, imagens de contêineres e configurações dos pipelines para identificar instalações do Microsoft Agent Framework nas versões 1.26.1 ou 1.26.2.
Também é importante verificar ambientes que receberam essas versões temporariamente, mesmo que o pacote já tenha sido atualizado posteriormente.
2. Isole os ambientes potencialmente comprometidos
Interrompa a utilização dos ambientes afetados e evite executar novamente o interpretador Python ou comandos do pip antes de realizar a limpeza.
Essa precaução é importante porque os arquivos .pth podem executar código automaticamente durante a inicialização do Python. Portanto, iniciar o interpretador em um ambiente contaminado pode acionar novamente o mecanismo malicioso.
Sempre que possível, interrompa também os processos de integração contínua que possam estar utilizando instalações comprometidas.
3. Procure sinais de exfiltração
Analise os registros de saída de rede, logs de execução e mecanismos de monitoramento disponíveis.
Um dos indicadores importantes é a comunicação com o endpoint webhook.site, utilizado para transmitir as informações coletadas.
A ausência de registros dessa comunicação não comprova que o ambiente está seguro. Os logs podem estar incompletos, e a identificação de uma tentativa de exfiltração não significa necessariamente que todos os dados tenham sido enviados com sucesso.
4. Reconstrua o ambiente utilizando uma versão segura
A recomendação é descartar os ambientes virtuais comprometidos e criar instalações novas, a partir de uma origem confiável.
A versão 1.26.0 é a referência segura indicada para retornar à utilização do framework, conforme as informações do incidente.
Fixe explicitamente essa versão nas dependências para evitar que ferramentas de instalação selecionem automaticamente uma das versões comprometidas.
Por exemplo:
pip install "agent-framework==1.26.0"
A reconstrução deve considerar também imagens Docker, ambientes de desenvolvimento compartilhados e runners de CI/CD que possam ter recebido os pacotes maliciosos.
5. Revogue e substitua todas as credenciais potencialmente expostas
Essa é uma das etapas mais importantes da resposta ao incidente.
Se o ambiente comprometido tinha acesso a credenciais, considere todas elas potencialmente expostas, independentemente de existirem evidências de utilização indevida.
Revogue e gere novas credenciais para:
- Azure e AWS: chaves, credenciais e tokens de acesso.
- GitHub: tokens pessoais e credenciais de automação.
- Docker: credenciais de registro e autenticação.
- Hugging Face: tokens de acesso.
- OpenAI: chaves de API.
- Azure DevOps e GitHub Actions: revise as permissões de federação OIDC e os recursos que poderiam ser acessados pelos tokens.
- Identidades gerenciadas: investigue possíveis acessos realizados com os tokens disponíveis durante o comprometimento.
Também é recomendável revisar registros de autenticação, alterações de permissões, criação de recursos e atividades incomuns nos serviços de nuvem.
Atualizar o pacote não invalida automaticamente os segredos roubados. A substituição das credenciais é indispensável para reduzir o risco de exploração posterior.
O impacto na segurança da cadeia de suprimentos de código aberto
O comprometimento do Microsoft Agent Framework reforça um problema importante do ecossistema de desenvolvimento moderno: a confiança depositada em pacotes oficiais não elimina os riscos associados à publicação e à distribuição de software.
O episódio também demonstra como a manutenção de permissões de publicação após a primeira quarentena pode permitir novas tentativas de distribuição maliciosa. A publicação da versão 1.26.2 apenas 2,5 minutos depois da intervenção inicial evidencia a necessidade de investigar não apenas os arquivos contaminados, mas também a origem do comprometimento e os acessos utilizados pelos invasores.
Para equipes de desenvolvimento, algumas práticas precisam deixar de ser opcionais.
A primeira é o version pinning, ou fixação de versões. Em vez de permitir atualizações automáticas sem controle, projetos devem especificar versões conhecidas e confiáveis para suas dependências.
Outra medida importante é a auditoria de dependências, com ferramentas capazes de identificar alterações inesperadas, pacotes suspeitos e comportamentos incompatíveis com a finalidade declarada de uma biblioteca.
Também é fundamental aplicar o princípio do menor privilégio. Um ambiente de desenvolvimento ou pipeline de CI/CD não deve possuir acesso irrestrito a todos os recursos da organização. Quanto menores forem as permissões disponíveis, menor será o impacto potencial de uma dependência comprometida.
Por fim, organizações que trabalham com Python precisam considerar a inicialização do interpretador como parte da superfície de ataque. Arquivos .pth e outros mecanismos de execução automática merecem atenção especial durante auditorias de segurança.
O ataque ao pacote da Microsoft mostra que a segurança de uma aplicação depende também de tudo aquilo que ela instala e executa indiretamente. Em um ecossistema no qual ferramentas de IA, automação e serviços de nuvem compartilham credenciais, uma dependência aparentemente confiável pode se transformar em uma porta de entrada para toda a infraestrutura.
