mvt/docs/android/download_apks.md

29 lines
1.5 KiB
Markdown
Raw Normal View History

2021-07-18 14:33:34 +00:00
# Downloading APKs from an Android phone
2021-07-16 06:05:01 +00:00
2021-08-17 14:36:48 +00:00
MVT allows to attempt to download all available installed packages (APKs) in order to further inspect them and potentially identify any which might be malicious in nature.
2021-07-16 06:05:01 +00:00
2021-08-17 14:36:48 +00:00
You can do so by launching the following command:
2021-07-16 06:05:01 +00:00
```bash
mvt-android download-apks --output /path/to/folder
```
2021-08-18 08:34:31 +00:00
It might take several minutes to complete.
!!! info
MVT will likely warn you it was unable to download certain installed packages. There is no reason to be alarmed: this is typically expected behavior when MVT attempts to download a system package it has no privileges to access.
2021-08-17 14:36:48 +00:00
Optionally, you can decide to enable lookups of the SHA256 hash of all the extracted APKs on [VirusTotal](https://www.virustotal.com). While these lookups do not provide any conclusive assessment on all of the extracted APKs, they might highlight any known malicious ones:
2021-07-16 06:05:01 +00:00
```bash
MVT_VT_API_KEY=<key> mvt-android download-apks --output /path/to/folder --virustotal
2021-07-16 06:05:01 +00:00
```
Please note that in order to use VirusTotal lookups you are required to provide your own API key through the `MVT_VT_API_KEY` environment variable. You should also note that VirusTotal enforces strict API usage. Be mindful that MVT might consume your hourly search quota.
In case you have a previous extraction of APKs you want to later check against VirusTotal, you can do so with the following arguments:
2021-07-16 06:05:01 +00:00
```bash
MVT_VT_API_KEY=<key> mvt-android download-apks --from-file /path/to/folder/apks.json --virustotal
2021-07-16 06:05:01 +00:00
```