Dois segundos depois do npm install: investigando um script de instalação malicioso
O desafio
Um npm install do Fleetboard vazou dados. Ache o script de instalação, decodifique o alvo. Diga o host que recebeu as variáveis de ambiente.
O que você vai aprender
- Explicar quando o npm roda os scripts de instalação de uma dependência
- Descobrir quais pacotes rodaram scripts, pelo log de debug do npm ou pelo lockfile
- Distinguir um script de instalação legítimo de um malicioso
- Decodificar uma string base64 invertida com ferramentas de shell
- Reforçar as instalações: ignore-scripts, allowlists, período de espera para releases, rotação de segredos
Habilidades testadas
Pré-requisitos
- Comandos básicos de shell (ls, cat, grep)
- O que são o npm e o package.json
Como funciona
Um package.json pode declarar scripts de ciclo de vida. Quando o npm instala uma dependência, ele roda automaticamente os scripts preinstall, install e postinstall daquele pacote, com as permissões e o ambiente de quem está instalando. Módulos nativos usam isso de forma legítima para compilar ou carregar um binário. Um atacante que consegue publicar uma versão de um pacote popular usa o mesmo mecanismo para executar código em todo notebook de desenvolvedor e em todo runner de CI que instalar essa versão.
O npm registra cada script que executa no seu log de debug (info run <package> <event> <path> <command>), e o lockfile v3 marca esses pacotes com "hasInstallScript": true. Scripts maliciosos raramente mostram o destino em texto claro: aqui a URL fica guardada invertida e codificada em base64, e só é remontada em tempo de execução.
Em setembro de 2025, o worm Shai-Hulud se espalhou por centenas de pacotes npm dessa forma: um bundle.js executado pelo postinstall coletava segredos e usava os tokens npm encontrados para publicar versões infectadas dos próprios pacotes das vítimas.
Erros comuns
- Responder huecraft.example. A URL no comentário de cabeçalho do bundle é a página da biblioteca, a única URL em texto claro no arquivo. O destino é a string codificada.
- Culpar o bcrypt. O script
installdele,node-gyp-build, carrega o módulo nativo pré-compilado para a plataforma. É isso que pacotes nativos devem fazer. - Responder registry.npmjs.org. Toda linha
http fetchdo log do npm vai para o registry público: é o npm baixando pacotes, não o script. - Parar depois do base64 -d. O texto decodificado está de trás para frente. O código chama
.reverse()nele, então passe o resultado pelorev. - Tentar executar o script. Nunca execute um script suspeito para ver o que ele faz. Esta máquina não tem node de propósito.
Como se proteger
- Instale com
npm ci --ignore-scripts(ouignore-scripts=trueno.npmrc) e rode explicitamente os poucos scripts de que você precisa. O pnpm 10 não roda scripts de dependências a menos que estejam em uma allowlist. - Não faça merge automático de atualizações de dependência na hora em que a versão aparece: um período de espera (o
minimumReleaseAgedo Renovate, ominimumReleaseAgedo pnpm) dá tempo para o registry retirar uma release maliciosa antes. - Mantenha segredos de longa duração fora dos shells de desenvolvedores e dos ambientes de CI. Use tokens de curta duração e com escopo restrito.
- Depois de um incidente: bloqueie o host, remova a versão e troque todo segredo que estava no ambiente (chaves de nuvem, tokens do npm e do GitHub).