
Ferramenta automatizada de pré-análise para aplicativos Android que desmonta amostras, extrai propriedades por meio de correspondência de padrões configurável e organiza a saída para engenharia reversa e análise de malware aceleradas.
DroidLysis é uma ferramenta de pré-análise para aplicações Android: realiza tarefas repetitivas e entediantes que normalmente faríamos no início de qualquer engenharia reversa. Ela desmonta a amostra Android, organiza a saída em diretórios e procura por pontos suspeitos no código para serem analisados. A saída ajuda o engenheiro reverso a acelerar as primeiras etapas da análise.
DroidLysis pode ser usado em pacotes Android (apk), executáveis Dalvik (dex), arquivos Zip (zip), arquivos Rar (rar) ou diretórios de arquivos.
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
Instale a partir do Git num ambiente virtual Python (python3 -m venv, ou ambientes virtuais pyenv, etc).
$ python3 -m venv venv
$ source ./venv/bin/activate
(venv) $ pip3 install git+https://github.com/cryptax/droidlysis
Como alternativa, você pode instalar o DroidLysis diretamente do PyPi (pip3 install droidlysis).
conf/general.conf. Em particular, certifique-se de alterar /home/axelle para os diretórios apropriados.[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
O arquivo de configuração é ./conf/general.conf (você pode alternar para outro arquivo com a opção --config).
É aqui que você configura a localização de várias ferramentas externas (por exemplo, Apktool), o nome dos arquivos de padrões
(por padrão ./conf/smali.conf, ./conf/wide.conf, ./conf/arm.conf, ./conf/kit.conf) e o nome do
arquivo de banco de dados (usado apenas se você especificar --enable-sql)
Certifique-se de especificar os caminhos corretos para as ferramentas de desmontagem, ou o DroidLysis não as encontrará.
O DroidLysis usa Python 3. Para iniciá-lo e obter as opções:
droidlysis --help
Por exemplo, teste-o no APK do Signal:
droidlysis --input Signal-website-universal-release-6.26.3.apk --output /tmp --config /PATH/TO/DROIDLYSIS/conf/general.conf

O DroidLysis produz:
--output /tmp, a análise será escrita em /tmp/Signalwebsiteuniversalrelease4.52.4.apk-f3c7d5e38df23925dd0b2fe1f44bfa12bac935a6bc8fe3a485a4436d4487a290.droidlysis.db) contendo as propriedades que detetou.Obtenha a utilização com droidlysis --help
A entrada pode ser um ficheiro ou um diretório de ficheiros a analisar recursivamente. O DroidLysis sabe como processar pacotes Android, DEX, ODEX e executáveis ARM, ZIP, RAR. O DroidLysis não falhará com outros tipos de ficheiros (a menos que haja um bug...) mas não conseguirá compreender o conteúdo.
Ao processar diretórios de ficheiros, é normalmente bastante útil mover as amostras processadas para outro local para saber o que foi processado. Isto é tratado pela opção --movein. Além disso, se estiver apenas interessado em estatísticas, provavelmente deverá limpar o diretório de saída que contém informação detalhada para cada amostra: esta é a opção --clearoutput. Se quiser armazenar todas as estatísticas numa base de dados SQL, use --enable-sql (ver aqui)
A análise do DroidLysis não inspeciona SDKs de terceiros conhecidos por predefinição, ou seja, por exemplo, não reportará qualquer atividade suspeita destes. Se quiser que sejam inspecionados, use a opção --no-kit-exception. Isto normalmente cria muitas mais propriedades detetadas para a amostra, uma vez que os SDKs (por exemplo, de publicidade) usam muitas APIs sinalizadas (obter localização GPS, obter IMEI, obter IMSI, HTTP POST...).
--output DIR)Este diretório contém (quando aplicável):
AndroidManifest.xml legívelreslib, assets assetssmali (e outros)META-INF./unzippedclasses.dex (e outros), e convertido para jar: classes-dex2jar.jar, e descompactado em ./unjarredOs seguintes ficheiros são gerados pelo DroidLysis:
autoanalysis.md: lista cada padrão detetado pelo DroidLysis e onde.report.md: o mesmo que foi impresso no consoleSe não precisar que o diretório de saída da amostra seja gerado, use a opção --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
Trackers do Exodus que não estão presentes no seu kit.conf inicial são anexados a ~/.cache/droidlysis/kit.conf. Compare os 2 arquivos e verifique quais trackers você deseja adicionar.
Se você quiser processar um diretório de amostras, provavelmente vai querer armazenar as propriedades encontradas pelo DroidLysis em um banco de dados, para analisar e consultar facilmente os resultados. Nesse caso, use a opção --enable-sql. Isso irá automaticamente despejar todos os resultados em um banco de dados chamado droidlysis.db, em uma tabela chamada samples. Cada entrada na tabela é relativa a uma determinada amostra. Cada coluna representa propriedades rastreadas pelo DroidLysis.
Por exemplo, para recuperar todos os nomes de arquivo, somas SHA256 e propriedades smali do banco de dados: