Dois segundos depois do npm install: investigando um script de instalação malicioso

Forense Digital & Resposta a Incidentes Nível 3/4 ~5 min 16 de novembro de 2026

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

Resposta a incidentesSegurança da cadeia de suprimentosBusca de arquivos no LinuxDecodificação

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 install dele, 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 fetch do 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 pelo rev.
  • 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 (ou ignore-scripts=true no .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 minimumReleaseAge do Renovate, o minimumReleaseAge do 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).

Solução completa

Membros Pro e Max desbloqueiam o passo a passo completo.

Assinar Pro

Estatísticas da comunidade

152 resoluções
79% taxa de sucesso
M2F14M3 Primeiro sangue

Hacks de hoje relacionados

40.000+ Hackers Labs reais Grátis
Comece Grátis ou resolva o hack de hoje, sem conta