Shannon: ferramenta de teste de penetração com IA white-box com 41.4K estrelas
🤖 Shannon: ferramenta de teste de penetração com IA white-box com 41.4K estrelas, No PoC No Report
Shannon é uma ferramenta de teste de penetração com IA white-box que opera de forma autônoma, voltada para aplicações web e APIs:
- 41.4K GitHub Stars: um dos projetos de código aberto mais populares da área de segurança
- No PoC No Report: sem PoC não há relatório, zero falsos positivos
- 96.15% no benchmark XBOW: taxa de sucesso de exploração de vulnerabilidades que supera as ferramentas comerciais
- US$ 50 por execução: custo por teste, com relatório pronto em 1–1,5 horas
- Teste white-box: exige acesso ao código-fonte; análise de código + ataques dinâmicos
Ele é a camada de verificação dinâmica da cadeia de ferramentas de segurança, preenchendo a lacuna do teste de penetração tradicional.
🔍 Por que o Shannon existe?
O problema da lacuna de segurança
Sua equipe usa ferramentas de programação com IA e implanta código todos os dias, mas o teste de penetração acontece uma vez por ano — a lacuna de segurança dos 364 dias entre eles, quem vai preencher?
- Scanners tradicionais: relatam uma série de vulnerabilidades que "podem existir", e os engenheiros de segurança precisam verificar uma a uma
- Testes de penetração manuais: levam semanas e custam dezenas de milhares de dólares
- Lacuna de segurança: nos 364 dias intermediários, vulnerabilidades podem estar sendo implantadas em produção
A resposta do Shannon
A resposta do Shannon é: um agente de teste de penetração totalmente autônomo capaz de ler o código-fonte, operar o navegador por conta própria para lançar ataques e que não reporta o que não consegue invadir.
⚠️ Não é um scanner: No Exploit, No Report
O primeiro passo para entender o Shannon
O primeiro passo para entender o Shannon é deixar claro o que ele não é:
- Não é DAST: não é uma ferramenta de teste dinâmico de segurança de aplicações
- Não é SAST: não é uma ferramenta de teste estático de segurança de aplicações
- Não é correspondência de padrões: não é varredura de padrões perigosos conhecidos
As ferramentas tradicionais são, em essência, correspondência de padrões — varrem padrões perigosos conhecidos no código ou nas respostas HTTP e geram uma lista de "suspeitas de vulnerabilidade".
O princípio central de design do Shannon
O princípio central de design do Shannon se resume em uma frase:"POC or it didn't happen"(sem PoC, é como se não tivesse acontecido):
| Característica | Descrição |
|---|---|
| Lança ataques de verdade | injeta SQL, monta payloads de XSS e envia requisições SSRF por meio da automação do navegador |
| Só reporta o que explorou com sucesso | apenas vulnerabilidades exploradas com sucesso entram no relatório final |
| Inclui PoC pronto para copiar e colar | cada descoberta vem com código de PoC que pode ser copiado e colado diretamente |
| Falsos positivos não entram no relatório | vulnerabilidades não exploráveis são marcadas como "falso positivo" ou "potencial" e não entram no relatório |
Isso significa que a equipe de segurança recebe todas as descobertas já verificadas e reproduzíveis.
Teste no OWASP Juice Shop
No relatório de teste oficial do OWASP Juice Shop, o Shannon encontrou mais de 20 vulnerabilidades:
- Bypass de autenticação por injeção de SQL(Crítica)
- Extração de dados por injeção UNION(Crítica)
- SSRF(Alta)
- XSS(Alta)
- Diversos bypasses de autorização(Alta)
Vale notar que, em outros dois alvos de teste, a detecção de XSS do Shannon teve zero falsos positivos — ele identificou corretamente que essas aplicações tinham defesas robustas contra XSS e não gerou alarmes falsos.
🔬 Arquitetura de pipeline em cinco estágios
Pipeline de cinco estágios + múltiplos agentes em paralelo
A arquitetura técnica do Shannon tem duas palavras-chave: pipeline de cinco estágios e múltiplos agentes em paralelo:
| Estágio | Nome | Descrição |
|---|---|---|
| Estágio 1 | Pre-Recon | varredura externa + análise de código-fonte (Nmap, Subfinder, WhatWeb) |
| Estágio 2 | Recon | faz a ponte entre análise estática e análise dinâmica, valida endpoints e mapeia fluxos de autenticação |
| Estágio 3 | Vulnerability Analysis | 5 agentes em paralelo, cada um responsável por uma categoria de vulnerabilidade |
| Estágio 4 | Exploitation | 5 agentes em paralelo, executando ataques reais |
| Estágio 5 | Reporting | gera relatório executivo no nível de teste de penetração |
Motor de raciocínio subjacente
O Shannon é baseado no Anthropic Claude Agent SDK e adota uma configuração de modelos em três camadas:
- Claude Haiku 4.5: resumos
- Claude Sonnet 4.6: análise de segurança
- Claude Opus 4.6: raciocínio profundo
📊 5 agentes em paralelo para 5 categorias de vulnerabilidade
5 agentes de análise independentes
O Shannon inicia simultaneamente 5 agentes de análise independentes, cada um responsável por uma categoria de vulnerabilidade:
| Agente | Método | Vulnerabilidades cobertas |
|---|---|---|
| Injection | rastreamento de taint Source→Sink | injeção de SQL/comandos/arquivos/templates/desserialização |
| XSS | rastreamento de taint Sink→Source | cross-site scripting em contextos de renderização de HTML |
| SSRF | rastreamento de taint Sink→Source | clientes HTTP, sockets brutos, abridores de URL |
| Auth | verificação por Guard | controles de segurança ausentes (limitação de taxa, gerenciamento de sessão etc.) |
| Authz | verificação por Guard | verificações de autorização ausentes (horizontal/vertical/contextual) |
Os 5 agentes executam em concorrência, sem se bloquearem mutuamente. Assim que cada agente de análise termina, o agente de exploração correspondente inicia imediatamente.
Estados de classificação das vulnerabilidades
O agente de exploração classifica cada descoberta em três estados:
- EXPLOITED(explorada): entra no relatório final
- POTENTIAL(potencial): não entra no relatório
- FALSE POSITIVE(falso positivo): não entra no relatório
Somente as EXPLOITED entram no relatório final.
🔥 96.15% no benchmark XBOW
Benchmark XBOW
No benchmark XBOW, o Shannon alcançou 96.15% de taxa de sucesso de exploração de vulnerabilidades (100/104):
| Tipo de vulnerabilidade | Total | Sucessos | Taxa de sucesso |
|---|---|---|---|
| Broken Authorization | 25 | 25 | 100% |
| SQL Injection | 7 | 7 | 100% |
| Blind SQL Injection | 3 | 3 | 100% |
| SSRF / Misconfiguration | 22 | 21 | 95.45% |
| XSS | 23 | 22 | 95.65% |
| Server-Side Template Injection | 13 | 12 | 92.31% |
| Command Injection | 11 | 10 | 90.91% |
| Total | 104 | 100 | 96.15% |
Notas sobre as condições de teste
- Benchmark XBOW: 104 aplicações com vulnerabilidades inseridas intencionalmente
- Versões higienizadas: removeram-se nomes de variáveis, comentários e dicas de caminhos de arquivos
- Modo white-box: o Shannon pode acessar o código-fonte da aplicação
Comparação com ferramentas comerciais
- Shannon: 96.15% (modo white-box)
- KinoSec: 92.3% (modo black-box)
- Xfenser AI: 88.5%
- Plataforma comercial XBOW: cerca de 85% (black-box)
💰 Custos e primeiros passos
Custo
Uma varredura completa:
- Tempo: 1–1,5 horas
- Custo de API: cerca de US$ 50 (com base no Claude Sonnet 4.6)
- Faixa: US$ 40–55, dependendo do preço dos modelos e da complexidade da aplicação
ComparaçãoTeste de penetração manual tradicional: dezenas de milhares de dólares por teste e semanas de trabalho.
Como começar
Modo npx(recomendado, zero instalação):
# 一次性配置 npx @keygraph/shannon setup # 运行渗透测试 npx @keygraph/shannon start -u https://your-app.com -r /path/to/repo
Modo local(build completo):
# 克隆仓库 git clone https://github.com/KeygraphHQ/shannon.git cd shannon # 配置 API Key echo "ANTHROPIC_API_KEY=your-key" > .env # 安装和构建 pnpm install && pnpm build # 运行 ./shannon start -u https://your-app.com -r /path/to/repo
Pré-requisitos
- Docker: runtime de contêineres
- Node.js 18+: ambiente de execução
- Anthropic API Key: recomendada
- Acesso ao código-fonte: exigido por uma ferramenta white-box
🤝 Shannon Lite vs Shannon Pro
As duas versões
| Versão | Licença | Posicionamento |
|---|---|---|
| Shannon Lite | AGPL-3.0 | testar localmente seus próprios aplicativos |
| Shannon Pro | comercial | plataforma de AppSec para organizações (SAST + SCA + Pentest) |
Recursos do Shannon Pro
Shannon Pro é uma plataforma de segurança de aplicações completa:
- Code Property Graph: motor de análise estática
- Testes de segurança de lógica de negócio: descoberta automatizada de invariantes
- Análise de alcançabilidade de SCA: rastreamento de alcançabilidade de CVEs
- Detecção de segredos: detecção com regex + LLM
- Correlação estático-dinâmica: achados estáticos alimentam automaticamente o pentest dinâmico
- Integração com CI/CD: varredura de PRs no GitHub
⚠️ Precauções de uso
Avisos importantes
- Nunca use em sistemas sem autorização: o Shannon executa ataques reais; varredura sem autorização é ilegal
- Não recomendado executar em ambiente de produção: os ataques podem causar impactos destrutivos
- O repositório pode estar sujeito a injeção de prompts contra IA: esse é um risco de segurança listado explicitamente pela equipe oficial
- O Shannon Lite é uma ferramenta white-box: requer acesso ao repositório de código-fonte
Risco de alucinação do LLM
Aviso oficial: LLMs ainda podem alucinar; é necessário que humanos verifiquem a legitimidade e a severidade de todas as descobertas.
📝 Resumo
O Shannon representa um paradigma de ferramenta de segurança que está se consolidando:
- No PoC No Report: só reporta o que explorou com sucesso
- 41.4K estrelas: o projeto de código aberto mais popular da área de segurança
- 96.15% no benchmark XBOW: taxa de sucesso no teste white-box que supera as ferramentas comerciais
- Pipeline de cinco estágios: Pre-Recon → Recon → Vuln → Exploit → Report
- 5 agentes em paralelo: Injection, XSS, SSRF, Auth e Authz
- US$ 50 por execução, 1–1,5 horas: custo muito inferior ao do teste de penetração manual
- Ferramenta white-box: requer acesso ao código-fonte
Sem PoC não há relatório; o Shannon transforma o teste de penetração em um único comando.
GitHub: https://github.com/KeygraphHQ/shannon
Site oficial: https://keygraph.io