JSHunter

Sobre

JSHunter é uma ferramenta de linha de comando abrangente para análise de segurança em JavaScript e descoberta de endpoints. Desenvolvida para profissionais de segurança, testadores de penetração e desenvolvedores, oferece capacidades de análise de nível empresarial com algoritmos de detecção de alta precisão e recursos de relatórios profissionais.

https://github.com/user-attachments/assets/5a5f60fa-f8dc-4aac-bd06-2e93779f9af4

JSHunter em ação — uma captura real do terminal da CLI (todo segredo exibido é dado de teste fictício)

---

Índice

• Sobre
• Recursos
• Instalação
• Início Rápido
• Exemplos de Uso
• Referência de Comandos
• Uso Avançado
• Contribuindo
• Licença
• Suporte

---

Recursos

Capacidades Principais

• Descoberta Abrangente de Endpoints: Extrai automaticamente URLs, endpoints de API e parâmetros ocultos de arquivos JavaScript
• Análise de Segurança Avançada: Identifica chaves de API, tokens JWT, credenciais e potenciais vulnerabilidades com alta precisão
• Métodos de Entrada Flexíveis: Suporta URLs, listas de arquivos, arquivos locais, entrada via stdin e descoberta recursiva
• Arquitetura de Alto Desempenho: Processamento concorrente multithread com limitação de taxa inteligente
• Recursos Profissionais de Furtividade: Suporte a proxy, cabeçalhos personalizados, rotação de user-agent e detecção de bypass

Motor de Detecção Inteligente

Precisão de nível empresarial com algoritmos avançados de análise

• Detecção Inteligente de Base64: Filtragem de alta precisão elimina falsos positivos de conteúdo de mídia e dados codificados
• Interface Profissional: Terminologia, documentação e formatos de relatório abrangentes prontos para uso empresarial
• Análise Sensível ao Contexto: Algoritmos avançados distinguem tokens de segurança reais de dados de mídia codificados
• Análise de Entropia: Algoritmos matemáticos identificam tokens de segurança e credenciais genuínos com precisão

Motor de Detecção Estrutural

O JSHunter analisa o JavaScript que escaneia em vez de apenas aplicar correspondência de padrões. Um scanner ECMAScript de passagem única classifica cada byte da resposta como literal de string, literal de template, comentário, literal de expressão regular ou código, e as regras de detecção são avaliadas com base nessa classificação.

Isso importa porque uma regex não tem ideia do que correspondeu. Os mesmos quarenta caracteres base64 significam "credencial" dentro de um literal de string, "hash de chunk" dentro de um identificador minificado, e absolutamente nada quando atravessam a emenda entre dois tokens adjacentes. Saber qual é o caso substitui uma pilha de heurísticas de proximidade por uma resposta estrutural:

• Restrição por região: uma correspondência dentro de um literal de regex é um padrão, não um valor. Uma correspondência que cruza um limite de token não é um único literal. Uma correspondência em código é um fragmento de identificador. Todas as três são rejeitadas de imediato.
• Contexto de vinculação: em vez de escanear uma janela fixa de caracteres em busca da palavra key, o motor recupera o identificador ou a chave de propriedade à qual o valor está de fato vinculado — const stripeSecret = "..." lê-se de forma muito diferente de {contentHash: "..."}, e uma regra baseada apenas em forma agora exige essa vinculação.
• Conjuntos de chaves irmãs: os membros de uma configuração web do Firebase, de uma configuração de busca do Algolia, de uma configuração de analytics do Segment e de um cliente de navegador do Supabase são reconhecidos pela forma do objeto em que se encontram.
• Forma do valor: digests, UUIDs, texto corrido, caminhos, placeholders e base64 que decodifica para um PNG, uma fonte, um documento JSON ou uma frase em inglês são cada um identificado pelo que realmente é.
• Classificação de exposição: valores que o emissor publica de propósito — chaves publicáveis do Stripe, tokens públicos do Mapbox, JWTs anon do Supabase lidos de sua própria claim role, SIDs do Twilio — são classificados em vez de reportados como vazamentos. --include-public os reporta mesmo assim.
• Surpresa relativa ao arquivo: um modelo de transição de caracteres construído a partir do arquivo sendo escaneado pontua o quão dissimilar do restante daquele arquivo um candidato se lê.

Toda rejeição é condicional ao corpo ser confiavelmente JavaScript ou JSON. Em qualquer outra coisa — um arquivo .env, texto corrido, HTML bruto — o motor contribui com evidências mas nunca suprime, de modo que uma entrada mal classificada jamais pode ocultar um segredo. --no-structural desativa toda a camada e restaura o comportamento da v0.7.

Os achados carregam o raciocínio como um objeto evidence em --json, --ndjson e no property bag do SARIF:```json "exposure": "secret", "evidence": { "region": "string-literal", "role": "assignment", "bound_to": "awsAccessKeyId", "shape": "opaque-token", "charset": "alphanumeric", "signals": [ {"name": "in-literal", "delta": 0.04, "detail": "value is a complete string-literal"}, {"name": "credential-binding", "delta": 0.12, "detail": "bound to 'awsAccessKeyId'"} ] }

`--stats` informa o que cada estágio descartou, para que o pipeline permaneça auditável.

### Grafo de Chunks e Descoberta de Rotas

Uma aplicação moderna entrega um bundle de entrada e várias centenas de chunks
carregados sob demanda cujas URLs são montadas em tempo de execução a partir de um manifesto que o bundler embute. Nada aponta para eles, então um crawler nunca os vê. `-G` recupera esse manifesto
e imprime a lista completa de assets e a tabela de rotas do cliente:```console
$ jshunter -u https://target.example/_next/static/chunks/main-a1b2c3.js -G
[CHUNKS] https://target.example/...: next runtime, 214 chunks, 37 routes
[CHUNK]  https://target.example/...  https://target.example/_next/static/chunks/settings.11aa22bb33cc.js
[ROUTE]  https://target.example/...  /admin/users/:id

Runtimes suportados: webpack 4 e 5 (__webpack_require__.u, miniCssF, jsonpScriptSrc), manifestos de build do Next.js, Vite e Rollup (__vite__mapDeps, __vitePreload), import() dinâmico simples, e tabelas de rotas do React Router, Vue Router e Angular. A saída é separada por tabulações e deduplicada, pelo que pode ser encaminhada diretamente como lista de entrada de uma análise subsequente:```bash jshunter -u https://target.example/main.js -G -q | awk -F'\t' '/^[CHUNK]/{print $3}' > chunks.txt jshunter -l chunks.txt -s -j > findings.json

### Suíte Profissional de HTTP e Rede
<details>
<summary><strong>Configuração de Rede de Nível Empresarial</strong></summary>