
Androidアプリの自動事前分析ツール。サンプルを逆アセンブルし、設定可能なパターンマッチングでプロパティを抽出し、出力を整理することで、リバースエンジニアリングやマルウェア解析を加速します。
DroidLysisはAndroidアプリの事前解析ツールです。リバースエンジニアリングの開始時に行うのが一般的な、反復的で退屈な作業を実行します。Androidサンプルを逆アセンブルし、出力をディレクトリに整理し、コード内の疑わしい箇所を検索して確認できるようにします。 その出力は、リバースエンジニアが解析の最初の数ステップを迅速に進めるのに役立ちます。
DroidLysisは、Androidパッケージ(apk)、Dalvik実行ファイル(dex)、Zipファイル(zip)、Rarファイル(rar)、またはファイルのディレクトリに対して使用できます。
sudo apt-get install default-jre git python3 python3-pip unzip wget libmagic-dev libxml2-dev libxslt-dev
$ mkdir -p ~/softs
$ cd ~/softs
$ wget https://bitbucket.org/iBotPeaches/apktool/downloads/apktool_2.9.3.jar
$ wget https://bitbucket.org/JesusFreke/smali/downloads/baksmali-2.5.2.jar
$ wget https://github.com/pxb1988/dex2jar/releases/download/v2.4/dex-tools-v2.4.zip
$ unzip dex-tools-v2.4.zip
$ rm -f dex-tools-v2.4.zip
Python 仮想環境(python3 -m venv、または pyenv 仮想環境など)で Git からインストールします。
$ python3 -m venv venv
$ source ./venv/bin/activate
(venv) $ pip3 install git+https://github.com/cryptax/droidlysis
あるいは、PyPi から直接 DroidLysis をインストールすることもできます(pip3 install droidlysis)。
conf/general.conf を設定します。特に、/home/axelle を適切なディレクトリに変更してください。[tools]
apktool = /home/axelle/softs/apktool_2.9.3.jar
baksmali = /home/axelle/softs/baksmali-2.5.2.jar
dex2jar = /home/axelle/softs/dex-tools-v2.4/d2j-dex2jar.sh
keytool = /usr/bin/keytool
...
python3 ./droidlysis3.py --help
設定ファイルは ./conf/general.conf です(--config オプションで別のファイルに切り替えられます)。
ここでは、各種外部ツール(例: Apktool)の場所、パターンファイルの名前
(デフォルトでは ./conf/smali.conf、./conf/wide.conf、./conf/arm.conf、./conf/kit.conf)、および
データベースファイルの名前(--enable-sql を指定した場合にのみ使用)を設定します。
逆アセンブリツールの正しいパスを必ず指定してください。そうしないと DroidLysis はそれらを見つけられません。
DroidLysis は Python 3 を使用します。起動してオプションを取得するには:
droidlysis --help
例えば、SignalのAPKでテストしてください:
droidlysis --input Signal-website-universal-release-6.26.3.apk --output /tmp --config /PATH/TO/DROIDLYSIS/conf/general.conf

DroidLysis の出力:
--output /tmp を設定した場合、解析結果は /tmp/Signalwebsiteuniversalrelease4.52.4.apk-f3c7d5e38df23925dd0b2fe1f44bfa12bac935a6bc8fe3a485a4436d4487a290 に書き込まれます。droidlysis.db)。droidlysis --help で使用方法を確認できます。
入力はファイル、または再帰的に調査するファイルのディレクトリにできます。DroidLysis は Android パッケージ、DEX、ODEX、ARM 実行ファイル、ZIP、RAR を処理できます。DroidLysis は他の種類のファイルでも失敗しません(バグがない限り...)が、その内容を理解することはできません。
ファイルのディレクトリを処理する場合、処理済みのサンプルを別の場所に移動して、何が処理されたかを把握できると通常は非常に便利です。これはオプション --movein で処理されます。また、統計情報のみに関心がある場合は、各サンプルの詳細情報を含む出力ディレクトリをクリアすることをお勧めします。これがオプション --clearoutput です。すべての統計情報を SQL データベースに保存したい場合は、--enable-sql を使用してください(こちらを参照)。
DroidLysis の解析はデフォルトでは既知のサードパーティ SDK を検査しません。つまり、例えばこれらの SDK からの疑わしいアクティビティは報告されません。これらを検査したい場合は、オプション --no-kit-exception を使用してください。通常、SDK(例: 広告)はフラグ付けされた API(GPS 位置情報の取得、IMEI の取得、IMSI の取得、HTTP POST など)を多数使用するため、サンプルで検出されるプロパティが大幅に増えます。
--output DIR)このディレクトリには(該当する場合)以下が含まれます:
AndroidManifest.xmlres 内の可読なリソースlib、アセット assetssmali(およびその他)META-INF./unzipped に単純に展開されたパッケージ内容classes.dex(およびその他)、および jar に変換された classes-dex2jar.jar、さらに ./unjarred に展開されたもの以下のファイルは DroidLysis によって生成されます:
autoanalysis.md: DroidLysis が検出した各パターンとその場所を一覧表示します。report.md: コンソールに出力された内容と同じものサンプル出力ディレクトリを生成する必要がない場合は、オプション --clearoutput を使用してください。
--import-exodus)$ python3 ./droidlysis3.py --import-exodus --verbose
Processing file: ./droidurl.pyc ...
DEBUG:droidconfig.py:Reading configuration file: './conf/./smali.conf'
DEBUG:droidconfig.py:Reading configuration file: './conf/./wide.conf'
DEBUG:droidconfig.py:Reading configuration file: './conf/./arm.conf'
DEBUG:droidconfig.py:Reading configuration file: '/home/axelle/.cache/droidlysis/./kit.conf'
DEBUG:droidproperties.py:Importing ETIP Exodus trackers from https://etip.exodus-privacy.eu.org/api/trackers/?format=json
DEBUG:connectionpool.py:Starting new HTTPS connection (1): etip.exodus-privacy.eu.org:443
DEBUG:connectionpool.py:https://etip.exodus-privacy.eu.org:443 "GET /api/trackers/?format=json HTTP/1.1" 200 None
DEBUG:droidproperties.py:Appending imported trackers to /home/axelle/.cache/droidlysis/./kit.conf
初期の kit.conf に存在しない Exodus のトラッカーは ~/.cache/droidlysis/kit.conf に追加されます。2 つのファイルを diff して、追加したいトラッカーを確認してください。
サンプルのディレクトリを処理する場合、DroidLysis が見つけたプロパティをデータベースに保存して、検出結果を簡単に解析・クエリできるようにしたくなるでしょう。その場合は、オプション --enable-sql を使用します。これにより、すべての結果が droidlysis.db という名前のデータベースの samples という名前のテーブルに自動的にダンプされます。テーブルの各エントリは特定のサンプルに対応しています。各カラムは DroidLysis が追跡するプロパティです。
例えば、データベースからすべてのファイル名、SHA256 ハッシュ、および smali プロパティを取得するには、次のようにします:
sqlite> select sha256, sanitized_basename, smali_properties from samples;
f3c7d5e38df23925dd0b2fe1f44bfa12bac935a6bc8fe3a485a4436d4487a290|Signalwebsiteuniversalrelease4.52.4.apk|{"send_sms": true, "receive_sms": true, "abort_broadcast": true, "call": false, "email": false, "answer_call": false, "end_call": true, "phone_number": false, "intent_chooser": true, "get_accounts": true, "contacts": false, "get_imei": true, "get_external_storage_stage": false, "get_imsi": false, "get_network_operator": false, "get_active_network_info": false, "get_line_number": true, "get_sim_country_iso": true,
...
DroidLysisが検出する内容は、./conf ディレクトリ内のファイルで設定および拡張できます。
パターンは以下で構成されます:
send_sms。これはプロパティに名前を付けるためのものです。.conf ファイル全体で一意である必要があります。;->sendTextMessage|;->sendMultipartTextMessage|SmsManager;->sendDataMessage。smali.conf ファイルでは、この正規表現はSmaliコードに対してマッチされます。この特定のケースでは、コードからSMSメッセージを送信する方法が3つあります: sendTextMessage、sendMultipartTextMessage、sendDataMessageです。[send_sms]
pattern=;->sendTextMessage|;->sendMultipartTextMessage|SmsManager;->sendDataMessage
description=Sending SMS messages
Exodus Privacy は、conf/kit.conf を介した分析で除外する対象として関心のある各種 SDK のリストを管理しています。droidlysis のコマンドラインに --import_exodus オプションを追加してください。これにより、Exodus Privacy が把握している既存のトラッカーのうち、まだ kit.conf に含まれていないものが解析されます。最後に、すべての新しいトラッカーが ~/.cache/droidlysis/kit.conf に追記されます。
その後、kit.conf ファイルをソートするとよいでしょう:
import configparser
import collections
import os
config = configparser.ConfigParser({}, collections.OrderedDict)
config.read(os.path.expanduser('~/.cache/droidlysis/kit.conf'))
# Order all sections alphabetically
config._sections = collections.OrderedDict(sorted(config._sections.items(), key=lambda t: t[0] ))
with open('sorted.conf','w') as f:
config.write(f)
このスクリプトは、JEB UI上でsmaliパターンに一致するコードを含むメソッドを検索し、それらの関数へ簡単に移動できるようにするものです。スクリプトを読み込み、droidlysisの解析ファイルの中からdetails.mdファイルを選択すると、検索ボックスが表示されます。移動後は、最近のスクリプト実行ショートカットを使って検索ウィンドウを簡単に再表示できます。
script/DroidlysisSearch.py