shouganaiyo-loader: Java エージェントの強制ロード

shouganaiyo-loader は、Frida ベースのクロスプラットフォームな Node.js コマンドラインツールで、JVM がエージェントアタッチ API を無効化しているかどうかに関係なく、 Java プロセスに Java/JVMTI エージェントのロードを強制します。

インストール

$ sudo npm install -g shouganaiyo-loader

ソースからのビルド

$ git clone https://github.com/nccgroup/shouganaiyo-loader
$ cd shouganaiyo-loader
$ npm install
$ sudo npm install -g

使い方

Java エージェントの注入

# shouganaiyo-loader --pid <pid> -t <hotspot|openj9> -a /path/to/agent.jar "args..."
# shouganaiyo-loader --pid <pid> -t <hotspot|openj9> -j instrument "/path/to/agent.jar=args..."
# shouganaiyo-loader --pid <pid> -t <hotspot|openj9> -j "/path/to/(lib)?instrument.(so|dylib|dll)" "/path/to/agent.jar=args..."

JVMTI エージェントの注入

# shouganaiyo-loader --pid <pid> -t <hotspot|openj9> -j /path/to/agent.so  'jvmti agent args...'

ライセンス

shouganaiyo-loader は、 Apache License, Version 2.0 の下でライセンスされています。

対応プラットフォーム

shouganaiyo-loader は、HotSpot と OpenJ9 の両方の JVM について、Linux、Windows、MacOS 上の Java 6-17+ をサポートするように書かれています。

MacOS 11+

MacOS 11+ の変更により、Get Task Allow エンタイトルメントを持たないコード署名済みバイナリは、 ルートプロセスからアタッチできなくなりました。 AdoptOpenJDK JDK11+HotSpot を除くすべての AdoptOpenJDK/Adoptium Temurin/IBM Semeru リリースは、 Get Task Allow エンタイトルメントなしでコード署名されているため、 デフォルトではアタッチできず、壊れていると見なされます。

この問題を短期的に修正するには:

1. Java バイナリのコード署名を削除します:

   root@kitploit:~

   $ codesign --remove-signature /path/to/jdk/Contents/Home/bin/javac
   

2. バイナリから「Mark of the Web」を削除します:

   root@kitploit:~

   $ cp /path/to/jdk/Contents/Home/bin/java /path/to/jdk/Contents/Home/bin/java.bak
   $ curl -o /path/to/jdk/Contents/Home/bin/java.clean file:///path/to/jdk/Contents/Home/bin/java
   $ mv /path/to/jdk/Contents/Home/bin/java.clean /path/to/jdk/Contents/Home/bin/java