PortEx

Benvenuti in PortEx

PortEx è una libreria Java per l'analisi statica del malware di file eseguibili portatili. Il suo focus è sulla robustezza contro malformazioni PE e sul rilevamento di anomalie. PortEx è scritto in Java e Scala ed è destinato ad applicazioni Java.

Funzionalità

• Lettura delle informazioni dell'intestazione da: MSDOS Header, COFF File Header, Optional Header, Section Table
• Lettura delle strutture PE: Imports, Resources, Exports, Debug Directory, Relocations, Delay Load Imports, Bound Imports
• Dump di sezioni, risorse, overlay, file ZIP, JAR o .class incorporati
• Scansione per anomalie del formato file, incluse anomalie strutturali, valori deprecati, riservati, errati o non predefiniti.
• Visualizzazione della struttura del file PE, entropie locali e byteplot del file con colori e dimensioni variabili
• Calcolo dell'entropia di Shannon e del Chi Quadrato per file e sezioni
• Calcolo dei valori hash ImpHash, Rich e RichPV per file e sezioni
• Analisi del RichHeader e verifica del checksum
• Calcolo e verifica del checksum dell'Optional Header
• Scansione per firme PEiD, firme di tipi di file interni o il proprio database di firme
• Scansione per wrapper Jar to EXE (ad es. exe4j, jsmooth, jar2exe, launch4j)
• Estrazione delle stringhe Unicode e ASCII contenute nel file
• Estrazione e conversione di file .ICO da icone nella sezione delle risorse
• Estrazione delle informazioni sulla versione e del manifest dal file
• Lettura dei metadati e degli stream .NET (Alpha)

Per maggiori informazioni, consulta la Wiki di PortEx e la Documentazione

PortexAnalyzer CLI e GUI

PortexAnalyzer CLI è uno strumento da riga di comando che utilizza la libreria PortEx internamente.

Se stai cercando uno scanner PE da riga di comando già compilato per analizzare file, troverai la versione più recente qui: PortexAnalyzer.jar

La versione a lungo termine dello strumento CLI si trova nella pagina delle release.

La versione GUI è disponibile qui: PortexAnalyzerGUI

Utilizzo di PortEx

Includere PortEx in un Progetto Maven

Puoi includere PortEx nel tuo progetto aggiungendo la seguente dipendenza Maven:

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

Per utilizzare una build locale, aggiungi la libreria come segue:

<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> 

Includere PortEx in un progetto SBT

Aggiungi la dipendenza come segue nel tuo build.sbt

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

Compilare PortEx

Requisiti

PortEx è compilato con sbt

Compilare e Creare con sbt

Per compilare semplicemente il progetto esegui:

$ sbt compile

Per creare un jar:

$ sbt package

Per compilare un fat jar utilizzabile come strumento da riga di comando, digita:

$ sbt assembly

Creare un Progetto Eclipse

Puoi creare un progetto Eclipse utilizzando il plugin sbteclipse. Aggiungi la seguente riga a project/plugins.sbt:

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

Genera i file di progetto per Eclipse:

$ sbt eclipse

Importa il progetto in Eclipse tramite la Procedura guidata di importazione.

Donazioni

Sviluppo PortEx e PortexAnalyzer come hobby nel mio tempo libero. Se ti piace, considera l'idea di offrirmi un caffè: https://ko-fi.com/struppigel

Autore

Karsten Hahn

Twitter/X: @Struppigel

Mastodon: [email protected]

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

Youtube: MalwareAnalysisForHedgehogs

Licenza

Apache License, Version 2.0