PortEx

Bem-vindo ao PortEx

PortEx é uma biblioteca Java para análise estática de malware de arquivos Portable Executable. Seu foco está na robustez contra malformações de PE e na detecção de anomalias. PortEx é escrito em Java e Scala, e é direcionado para aplicações Java.

Funcionalidades

• Leitura de informações de cabeçalho de: MSDOS Header, COFF File Header, Optional Header, Section Table
• Leitura de estruturas PE: Imports, Resources, Exports, Debug Directory, Relocations, Delay Load Imports, Bound Imports
• Extração (dumping) de seções, recursos, overlay, arquivos ZIP, JAR ou .class embutidos
• Escaneamento de anomalias no formato do arquivo, incluindo anomalias estruturais, valores obsoletos, reservados, incorretos ou não padrão.
• Visualizar estrutura do arquivo PE, entropias locais e byteplot do arquivo com cores e tamanhos variáveis
• Calcular Entropia de Shannon e Qui-Quadrado para arquivos e seções
• Calcular hashes ImpHash, Rich e RichPV para arquivos e seções
• Analisar o RichHeader e verificar a soma de verificação (checksum)
• Calcular e verificar a soma de verificação do Optional Header
• Escanear assinaturas PEiD, assinaturas internas de tipo de arquivo ou seu próprio banco de dados de assinaturas
• Escanear por wrappers Jar-para-EXE (ex.: exe4j, jsmooth, jar2exe, launch4j)
• Extrair strings Unicode e ASCII contidas no arquivo
• Extração e conversão de arquivos .ICO a partir de ícones na seção de recursos
• Extração de informações de versão e manifesto do arquivo
• Leitura de metadados e streams .NET (Alpha)

Para mais informações, veja a Wiki do PortEx e a Documentação

PortexAnalyzer CLI e GUI

PortexAnalyzer CLI é uma ferramenta de linha de comando que executa a biblioteca PortEx internamente.

Se você está procurando por um scanner PE de linha de comando já compilado para analisar arquivos, encontrará a versão mais recente aqui PortexAnalyzer.jar

A versão de lançamento de longo prazo da ferramenta CLI está na página de releases.

A versão GUI está disponível aqui: PortexAnalyzerGUI

Usando PortEx

Incluindo PortEx em um Projeto Maven

Você pode incluir PortEx no seu projeto adicionando a seguinte dependência Maven:

<dependency>
   <groupId>io.github.struppigel</groupId>
   <artifactId>portex_2.12</artifactId>
   <version>5.0.6</version>
</dependency> 

Para usar uma compilação local, adicione a biblioteca da seguinte forma:

<dependency>
   <groupId>io.github.struppigel</groupId>
   <artifactId>portex_2.12</artifactId>
   <version>5.0.6</version>
   <scope>system</scope>
   <systemPath>$PORTEXDIR/target/scala-2.12/portex_2.12-5.0.6.jar</systemPath>
</dependency> 

Incluindo PortEx em um Projeto SBT

Adicione a dependência da seguinte forma no seu build.sbt

libraryDependencies += "io.github.struppigel" % "portex_2.12" % "5.0.6"

Compilando PortEx

Requisitos

PortEx é compilado com sbt

Compilar e Construir com sbt

Para simplesmente compilar o projeto, execute:

$ sbt compile

Para criar um jar:

$ sbt package

Para compilar um fat jar que pode ser usado como ferramenta de linha de comando, digite:

$ sbt assembly

Criar Projeto Eclipse

Você pode criar um projeto Eclipse usando o plugin sbteclipse. Adicione a seguinte linha ao project/plugins.sbt:

addSbtPlugin("com.typesafe.sbteclipse" % "sbteclipse-plugin" % "2.4.0")

Gere os arquivos de projeto para Eclipse:

$ sbt eclipse

Importe o projeto para Eclipse através do Import Wizard.

Doações

Eu desenvolvo o PortEx e o PortexAnalyzer como um hobby no meu tempo livre. Se você gosta, considere me pagar um café: https://ko-fi.com/struppigel

Autor

Karsten Hahn

Twitter/X: @Struppigel

Mastodon: [email protected]

Bluesky: https://bsky.app/profile/struppigel.bsky.social

Youtube: MalwareAnalysisForHedgehogs

Licença

Apache License, Version 2.0