PortEx

PortEx へようこそ

PortExは、ポータブル実行可能ファイルの静的マルウェア解析のためのJavaライブラリです。その焦点は、PEの不正な構造に対する堅牢性と異常検出にあります。PortExはJavaとScalaで書かれており、Javaアプリケーションを対象としています。

特徴

• ヘッダー情報の読み取り: MSDOSヘッダー、COFFファイルヘッダー、オプショナルヘッダー、セクションテーブル
• PE構造の読み取り: インポート、リソース、エクスポート、デバッグディレクトリ、リロケーション、遅延ロードインポート、バインドインポート
• セクション、リソース、オーバーレイ、埋め込まれたZIP、JAR、.classファイルのダンプ
• ファイル形式の異常のスキャン（構造異常、非推奨、予約済み、誤った値または非デフォルト値を含む）
• PEファイル構造、局所エントロピー、ファイルのバイトプロットを可変色とサイズで可視化
• ファイルとセクションのシャノンエントロピーとカイ二乗値を計算
• ファイルとセクションのImpHash、Richハッシュ、RichPVハッシュ値を計算
• RichHeaderの解析とチェックサムの検証
• オプショナルヘッダーのチェックサムの計算と検証
• PEiDシグネチャ、内部ファイルタイプシグネチャ、または独自のシグネチャデータベースのスキャン
• Jar to EXEラッパーのスキャン（例: exe4j, jsmooth, jar2exe, launch4j）
• ファイルに含まれるUnicodeおよびASCII文字列の抽出
• リソースセクションのアイコンからの.ICOファイルの抽出と変換
• ファイルからのバージョン情報とマニフェストの抽出
• .NETメタデータとストリームの読み取り（アルファ版）

詳細については、PortEx Wiki と ドキュメント をご覧ください。

PortexAnalyzer CLI および GUI

PortexAnalyzer CLIは、内部でPortExライブラリを実行するコマンドラインツールです。

コンパイル済みのコマンドラインPEスキャナをお探しの場合は、最新版をこちらで入手できます：PortexAnalyzer.jar

CLIツールの長期リリース版はリリースページにあります。

GUI版はこちらで入手可能です：PortexAnalyzerGUI

PortExの使用方法

MavenプロジェクトへのPortExの組み込み

以下のMaven依存関係を追加することで、PortExをプロジェクトに組み込むことができます：

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

ローカルビルドを使用する場合は、次のようにライブラリを追加します：

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

SBTプロジェクトへのPortExの組み込み

build.sbtに以下の依存関係を追加します：

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

PortExのビルド

要件

PortExはsbtでビルドされます。

sbtでのコンパイルとビルド

プロジェクトを単純にコンパイルするには、次を実行します：

$ sbt compile

jarを作成するには：

$ sbt package

コマンドラインツールとして使用できるファットjarをコンパイルするには、次を入力します：

$ sbt assembly

Eclipseプロジェクトの作成

sbteclipseプラグインを使用してEclipseプロジェクトを作成できます。 次の行をproject/plugins.sbtに追加します：

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

Eclipseのプロジェクトファイルを生成します：

$ sbt eclipse

インポートウィザードを使用して、プロジェクトをEclipseにインポートします。

寄付

PortExとPortexAnalyzerは余暇に趣味として開発しています。気に入っていただけましたら、コーヒーを一杯ごちそういただけると幸いです：https://ko-fi.com/struppigel

著者

Karsten Hahn

Twitter/X: @Struppigel

Mastodon: [email protected]

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

Youtube: MalwareAnalysisForHedgehogs

ライセンス

Apache License, Version 2.0