ioncodes/idacodeUma integração para IDA e VS Code que conecta ambos para executar e depurar facilmente scripts IDAPython.
O IDACode facilita a execução e depuração de scripts Python no seu ambiente IDA sem sair do Visual Studio Code.
A extensão do VS Code pode ser encontrada na marketplace.
O IDACode ainda está em um estado muito inicial e espera-se que contenha bugs. Por favor, abra um novo issue se encontrar algum problema.
debugpy para comunicação, ele sincroniza naturalmente a janela de saída com o painel de saída do VS Code.O IDACode foi testado no Windows e macOS com IDA 8.4/9.0 e Python 3.12 (versões mais antigas do Python têm problemas com depuração).
Para configurar as dependências do plugin IDA, execute:
# make sure to use the correct Python version
# IDACode supports the latest debugpy as of version 3.0.0, make sure to upgrade!
python -m pip install --user debugpy tornado
Clone este repositório ou baixe um pacote de lançamento da aqui. O ida.zip reflete o conteúdo da pasta ida neste repositório. Copie todos os arquivos para o diretório de plugins do IDA.
O próximo passo é configurar as suas configurações para corresponder ao seu ambiente (opcional). Edite idacode_utils/settings.py de acordo:
HOST: Este é o endereço do host. É sempre 127.0.0.1 a menos que você queira que seja acessível a partir de um local remoto. Tenha em mente que este plugin não utiliza autenticação.PORT: Esta é a porta na qual você deseja que o IDA ouça. É usada para comunicação websocket entre o IDA e o VS Code.DEBUG_PORT: Esta é a porta na qual você deseja ouvir as sessões de depuração recebidas.LOGGING: Determina se o depurador deve registrar em arquivos. Isso é especialmente útil quando você está enfrentando problemas com o IDACode. Por favor, envie um novo issue se encontrar algo. Os arquivos estão sempre localizados no seu diretório temp (por exemplo, Windows: %TEMP%). Os arquivos são chamados debugpy.*.log.Agora você pode iniciar o plugin clicando em IDACode no menu de plugins.
A extensão do VS Code está disponível na marketplace. Para configurar a extensão, consulte o README da extensão.
Clique em IDACode no menu de plugins. Você deve ver o seguinte texto:
IDACode listening on 127.0.0.1:7065
A partir da versão 0.2.0, o IDACode suporta "Executar ao salvar", que está habilitado por padrão. O VS Code executará automaticamente seu script no IDA assim que você salvar o documento atual (por exemplo, com CTRL+S). Esse comportamento pode ser desabilitado nas configurações. Abra o Console de Desenvolvimento de Extensão do VS Code usando Ctrl-Shift-P e digite "idacode" para ver a lista de comandos abaixo. Não use a funcionalidade "Run" ou "Debug" do VS Code, pois você receberá uma mensagem "HTTP misformed" no IDA.
Existem 4 comandos à sua disposição:
Depois de abrir uma pasta onde deseja colocar seus scripts (você deve especificar a pasta quando o VS Code solicitar!), você está pronto para se conectar ao IDA. Você pode fazer isso executando Connect to IDA ou Connect and attach a debugger to IDA. Lembre-se de que uma sessão de depuração é permanente até que você reinicie o IDA. Você não pode alterar a pasta do workspace depois que o depurador for iniciado.
Certifique-se de que a pasta do workspace seja a pasta onde seus scripts principais estão localizados.
Depois de conectado, você pode selecionar Execute script in IDA.
O IDACode usa o depurador remoto do VS Code para se conectar ao IDA. Todos os recursos do VS Code são suportados. No entanto, você precisa especificar o ponto de entrada dos scripts usando a funcionalidade embutida do Python: breakpoint. Esta instrução diz ao depurador para pausar a execução; se não houver depurador presente, ela simplesmente ignorará a função. O IDACode importa um pacote auxiliar chamado dbg que implementa uma sobrecarga de breakpoint chamada bp. Esta função suporta registro e condicionais:
name = idc.get_segm_name(segment)
dbg.bp(name==".text", f"found {name} at {segment}")
Observe também que uma chamada breakpoint() nunca deve ocorrer no final de um arquivo; deve sempre estar antes de qualquer outra linha de código, pois ele interrompe na próxima instrução do seu código. Observe também que, se você decidir usar o pacote dbg, deve remover todas as referências ou usar a variável __idacode__ como condicional antes de executá-lo como um script IDA normal.
Também é importante que anexar um depurador criará uma nova instância de depurador. Na maioria dos casos, isso não é o que você deseja. Se você se desconectar do depurador, use o depurador remoto do VS Code para reconectar.
