binnaviダウンロード - binnaviソースコードのダウンロード

binnavi

JAVAソースコード

vi 1.2 (Historical Version)

ダウンロード

ビンナビ

著作権 2011-2020 Google LLC

導入

BinNavi はバイナリ分析 IDE です。ユーザーが逆アセンブルされたコードの制御フローグラフを検査、ナビゲート、編集、注釈を付けたり、実行可能ファイルのコールグラフに対して同じことを実行したり、実行トレースを収集して結合したり、一般に追跡したりできる環境です。アナリストのグループ間での分析結果の共有。

注: BinNavi プロジェクトは現在、活発な開発は行われていません。

商用サードパーティへの依存関係

BinNavi は、グラフの表示とレイアウトに商用のサードパーティのグラフ視覚化ライブラリ (yFiles) を使用します。このライブラリは非常に強力ですが、簡単に置き換えることはできません。

yFiles を使用して直接開発を実行するには、yFiles の開発者ライセンスが必要です。同時に、商用 yFiles ライセンスを必要とせずにコミュニティが BinNavi に貢献できるようにしたいと考えています。これを実行し、yFiles ライセンスに準拠するには、yFiles へのすべてのインターフェイスを適切に難読化する必要があります。

これを達成するために、次のことを行いました。

BinNavi とすべてのライブラリは 2 つに分割されました。 yFiles に直接依存するプロジェクトの部分は、「yfileswrap」と呼ばれるサブパッケージに分割されました。

com.google.security.zynamics.binnavi
com.google.security.zynamics.binnavi.yfileswrap
com.google.security.zynamics.zylib
com.google.security.zynamics.zylib.yfileswrap
com.google.security.zynamics.reil
com.google.security.zynamics.reil.yfileswrap

yfileswrapサブパッケージ内のすべてのコードを含む事前構築済みの JAR ファイルを配布しています。事前にリンクされ、yFiles に対して難読化されています。 BinNavi でコードを変更または追加したいが、yFiles ライセンスを持っていない場合は、非 yfileswrap パッケージでほとんど何でも自由に行うことができます。単にlib/yfileswrap-obfuscated.jarクラスパスに置くだけで済みます。テストして結果を確認します。

yfileswrapサブディレクトリに変更を加えたい場合は、有効な yFiles ライセンスが必要であることに注意してください。また、BinNavi プロジェクトに貢献する場合は、そのライセンス契約に従う必要があります。これは、内部 API を別の名前などで単純に公開することはできないことを意味します。

私たちはこれを強制します。yFiles 依存関係を持つ BinNavi をオープンソースにする方法を見つけられたことを非常にうれしく思います。また、取得するコードが yFiles ライセンスに準拠していることを確認します。

メンテナー/yFiles ライセンス所有者向けの注意事項

yFiles ラッパーライブラリを再構築するには、まずy.jarとysvg.jar third_party/java/yfilesにコピーします。次に、次のようにして再構築します。

 mvn dependency:copy-dependencies
ant build-yfiles-wrapper-jar
mvn install:install-file 
    -Dfile=target/yfileswrap-obfuscated.jar 
    -DgroupId=com.google.security.zynamics.binnavi 
    -DartifactId=yfileswrap-obfuscated 
    -Dversion=6.1 
    -Dpackaging=jar 
    -DlocalRepositoryPath=lib

BinNaviをゼロから構築する

BinNavi は依存関係の管理に Maven を使用しますが、実際のビルドには使用しません。 Java 11 はサポートされる最小バージョンです。

最初から構築するには、次のコマンドを使用します。

 mvn dependency:copy-dependencies
ant build-binnavi-fat-jar

初めてビンナビを起動する

BinNavi は、逆アセンブリ/コメント/トレースを保存するために中央の PostgreSQL データベースを利用することに注意してください。そのため、アクセス可能な場所でそのようなインスタンスを実行する必要があります。 BinNavi は次のように起動できます。

 java -jar target/binnavi-all.jar

プロジェクトを Eclipse にインポートする

さらに開発を進めるためにコードを Eclipse にロードするには、少しの設定が必要です。

(前述のとおり) 依存関係をインストールし、1.8 言語に準拠した Java SDK がインストールされていることを確認してください。
新しい「既存の Ant ビルドファイルからの Java プロジェクト」を作成し、ファイルbuild.xmlを使用します。
ターゲット「build-binnavi-jar」にある「javac」タスクを選択します。
「プロジェクトプロパティ」ダイアログを開き、「ソース」タブが表示されている「Java ビルドパス」を選択します。
1 つを除くすべてのソースフォルダーを削除し、次のプロパティを持つように編集します。
- リンクされたフォルダーの場所: PROJECT_LOC/src/main/java
- フォルダ名： java
- 「次へ」をクリックします
除外するディレクトリのリストに**/yfileswrap/**を追加します。
「実行」->「実行」に移動し、「Java アプリケーション」を選択して、 CMainを検索します。

ここから出発する準備ができているはずです。

IDA からの逆アセンブリのエクスポート

このプロジェクトの一環として、IDA から BinNavi が必要とする PostgreSQL データベース形式に逆アセンブリをエクスポートする IDA Pro プラグインを配布しています。 BinNavi を実行するときは、IDA の正しいパスを設定し、必要に応じて「プラグインのインストール」ボタンをクリックするだけで、逆アセンブリをインポートできるようになります。

IDA 以外の逆アセンブラの使用

現時点では、IDA エクスポートプラグインしかありませんが、近い将来、誰かが他の逆アセンブラ用のエクスポート機能の構築を手伝ってくれることを非常に期待しています。

Gradle を使用して BinNavi を構築する

現時点では、Maven ビルドが BinNavi の信頼できるビルドシステムであることに注意してください。 Gradle は純粋に実験的なものであり、変更される可能性があります。

次のコマンドを実行すると、gradle を使用して BinNavi をビルドできます。

Linux / OS X の場合:

 $ ./gradlew clean jar

Windows の場合:

 /gradlew.bat clean jar

これにより、 build/libs/の下のプロジェクトルートに jar が生成されます。

Gradle を使用してプロジェクトを Eclipse にロードする

Linux / OS X の場合:

 $ ./gradlew eclipse

Windows の場合:

 ./gradlew.bat eclipse

プロジェクト作成プロセスの一環として、依存関係がダウンロードされます。完了したら、次の手順を実行して Eclipse にロードします。

エクリプスを開きます。
メニューバーから「ファイル」>「インポート...」を選択します。
表示されるウィンドウから、「一般」>「既存のプロジェクトをワークスペースに」を選択します。
[ルートディレクトリの選択] ラジオボタンが選択されていることを確認します。
[参照...] をクリックし、プロジェクトディレクトリに移動します。
プロジェクト領域には「binnavi」とその横にチェックマークが付いているはずです。
「完了」を押します。

これで Eclipse ワークスペースがセットアップされ、BinNavi が完成しました。

Gradle を使用してプロジェクトを IntelliJ にロードする

Linux / OS X の場合:

 $ ./gradlew idea

Windows の場合:

 ./gradlew.bat idea

プロジェクト作成プロセスの一環として、依存関係がダウンロードされます。完了したら、次の手順を実行して IntelliJ にロードします。

IntelliJ を開きます。
メインウィンドウから「開く」を選択します。
プロジェクトフォルダーに移動すると、IntelliJ アイコンが表示されます。これはプロジェクトであることを示します。
[OK] を押して、インポートしてロードするまで待ちます。
IntelliJ はこれを Gradle プロジェクトとして認識しない可能性があります。ポップアップウィンドウから有効を選択し、ローカル gradle を使用します。

これで、IntelliJ 環境がセットアップされ、IntelliJ 用に完成しました。

拡大する

追加情報