Compatibilidade do Burp Suite e Relato de Erros

Esta extensão tem como alvo a versão mais recente do Burp Suite. Foi testada pela última vez com a versão pro 2026.4.3, a versão estável mais recente no momento desta documentação. Também é compatível com a edição comunitária. A versão mínima suportada é o Burp Suite 2024.2, pois é a primeira versão que requer Java 21.

Todas as alterações são lançadas a partir do ramo main. Consulte CHANGES.md para obter o histórico de alterações de cada lançamento.

Utilizamos ativamente esta extensão e, ocasionalmente, observamos potenciais erros, especialmente quando o Burp Suite atualiza as suas funcionalidades principais ou a interface. Como projeto de código aberto, dependemos fortemente do feedback da comunidade para melhorias e correções de erros. Se encontrar algum problema, reporte-o na nossa página de issues. Além disso, se valoriza o nosso trabalho, considere patrocinar este projeto.

Utilizar a Extensão Legada

Na versão mais recente desta extensão, apenas a versão mais recente do Burp Suite é suportada, conforme indicado acima. Para versões mais antigas do Burp Suite, pode utilizar a versão legada da extensão ou consultar o repositório original.

As versões mais antigas desta extensão podem ser transferidas a partir do ramo legado (sem suporte):

• Lançamentos do ramo Legacy-Extension
• Lançamentos do repositório original

Sobre Este Repositório

Continuação do projeto Burp Suite Sharpener, originalmente lançado como código aberto pela MDSec em mdsecresearch/BurpSuiteSharpener.

Sugerir Novas Funcionalidades

O objetivo é adicionar funcionalidades simples mas eficazes que faltam a esta extensão única, para facilitar a vida do testador como um companheiro indispensável ao utilizar o Burp Suite (por isso, não conseguimos "Burp" sem ela!).

Não hesite em enviar os seus pedidos de novas funcionalidades usando FR: no título em issues.

Seria ótimo também listar quaisquer extensões disponíveis conhecidas que possam ter implementado as funcionalidades sugeridas.

Talvez as melhores funcionalidades possam ser importadas de diferentes extensões de código aberto, de modo a reduzir a sobrecarga de adicionar diferentes extensões.

Atalhos de Teclado

Todos os atalhos do Sharpener podem ser vistos e alterados dentro do Burp: utilize o menu superior Sharpener > Keyboard Shortcuts, ou o item Keyboard Shortcuts na parte inferior do menu de clique direito de um separador do Repeater/Intruder. As alterações são validadas (os atalhos padrão do próprio Burp, como Ctrl+R, não podem ser assumidos) e aplicadas de imediato.

Cada ação configurável tem UM atalho. Na caixa de diálogo, defina-o clicando na célula e premindo a combinação de teclas (sem escrever). Um atalho funciona em qualquer lugar do Burp, mesmo enquanto escreve no editor, pelo que precisa de Ctrl, Alt ou de uma tecla de função. Se premir uma tecla já utilizada, a caixa de diálogo propõe movê-la.

Atalhos configuráveis para os separadores do Repeater e do Intruder (padrão):

Teclas fixas do cabeçalho do separador (sempre ativas quando um título de separador tem o foco, não editáveis):

Estas teclas simples só atuam quando um cabeçalho de separador tem o foco, pelo que nunca perturbam o editor. Clique num título de separador (ou utilize um salto por atalho) para focar o cabeçalho e, em seguida, utilize as setas para se mover entre separadores e a seta para baixo para entrar no editor de pedidos e editar. Utilize Alt+Up (ou clique) para voltar ao separador. Após um salto por teclado iniciado no cabeçalho, o foco permanece no cabeçalho, pelo que premir uma seta várias vezes continua a navegar.

Notas:

• Ctrl+C e Ctrl+V não estão atribuídos por padrão, pelo que um colar nunca pode renomear um separador acidentalmente. Copiar e colar títulos utiliza Ctrl+Shift+C e Ctrl+Shift+V, e um título colado pode ser revertido a partir do menu do separador em Títulos Anteriores.

Atalho padrão para a janela principal do Burp:

Ações de rato fixas nos separadores do Repeater e do Intruder (não configuráveis):

Dicas de Utilização

• Depois de definir o estilo num sub-separador, definir o mesmo título noutro sub-separador copiará o seu estilo
• Alt + Qualquer Clique do Rato funciona em partes vazias dos separadores que não contenham texto
• Utilize a opção Debug em Global Settings se estiver a reportar um erro ou se quiser ver o que está a acontecer
• Consulte o repositório GitHub da extensão em vez da BApp Store para obter as últimas atualizações
• Ícones de exemplo estão disponíveis nos diretórios burpicon-sample/ e hacker-sample-icons/

Contribuir

Pull requests são bem-vindos. Algumas regras mantêm o pipeline de lançamento automatizado a funcionar:

• Todas as alterações passam por pull requests para o ramo main (pushes diretos são bloqueados).
• Compile com ./gradlew jar (requer JDK 21). A suíte de testes deve passar: ./gradlew build executa-a sem interface gráfica.
• Comportamentos novos ou alterados devem ser cobertos por casos de teste em src/test/java. A extensão não pode ser executada fora do Burp Suite, pelo que os testes utilizam interfaces Montoya simuladas e componentes Swing simples.
• Os lançamentos são criados automaticamente quando um pull request que incrementa a versão é integrado. Para fazer um lançamento:
  • Incremente version em src/main/resources/extension.properties. Deve permanecer interpretável como número (por exemplo 4.7), porque o verificador de atualizações compara-o numericamente.
  • Adicione uma secção correspondente no topo de CHANGES.md com o formato exato de cabeçalho ## Version X.Y (YYYY-MM-DD). O CI copia essa secção para as notas de lançamento do GitHub.

Agradecimentos

• Corey Arthur CoreyD97 por Burp-Montoya-Utilities. Uma pequena parte dela (as classes de preferências) é agora mantida dentro deste repositório em libs/thirdparty/; o resto da biblioteca já não é incluída. Consulte o ficheiro NOTICE.
• Bruno Demarche (pela inspiração inicial para o hack de Swing)

Não hesite em reportar erros, sugerir funcionalidades ou enviar pull requests.

Licença

Copyright (C) 2021-2026 Soroush Dalili (@irsdl).

Lançado sob a Licença Pública Geral Affero GNU v3.0 com termos adicionais ao abrigo da secção 7 da licença: cópias e versões modificadas devem manter os avisos de direitos de autor e a atribuição "Developed by Soroush Dalili (@irsdl)". Consulte os ficheiros LICENSE e NOTICE.