mirror of
https://github.com/HackTricks-wiki/hacktricks.git
synced 2025-10-10 18:36:50 +00:00
271 lines
12 KiB
Markdown
271 lines
12 KiB
Markdown
# AVD - Android Virtuele Toestel
|
|
|
|
{{#include ../../banners/hacktricks-training.md}}
|
|
|
|
Baie dankie aan [**@offsecjay**](https://twitter.com/offsecjay) vir sy hulp tydens die skep van hierdie inhoud.
|
|
|
|
## Wat is
|
|
|
|
Android Studio maak dit moontlik om **Android virtuele masjiene te draai wat jy kan gebruik om APKs te toets**. Om dit te gebruik benodig jy:
|
|
|
|
- Die **Android SDK tools** - [Download here](https://developer.android.com/studio/releases/sdk-tools).
|
|
- Of **Android Studio** (met Android SDK tools) - [Download here](https://developer.android.com/studio).
|
|
|
|
Op Windows (in my geval) **na die installasie van Android Studio** het ek die **SDK Tools geïnstalleer in**: `C:\Users\<UserName>\AppData\Local\Android\Sdk\tools`
|
|
|
|
Op mac kan jy die **SDK tools** aflaai en hulle in die PATH hê deur die volgende uit te voer:
|
|
```bash
|
|
brew tap homebrew/cask
|
|
brew install --cask android-sdk
|
|
```
|
|
Of vanaf **Android Studio GUI** soos aangedui in [https://stackoverflow.com/questions/46402772/failed-to-install-android-sdk-java-lang-noclassdeffounderror-javax-xml-bind-a](https://stackoverflow.com/questions/46402772/failed-to-install-android-sdk-java-lang-noclassdeffounderror-javax-xml-bind-a) wat hulle in `~/Library/Android/sdk/cmdline-tools/latest/bin/` en `~/Library/Android/sdk/platform-tools/` en `~/Library/Android/sdk/emulator/` sal installeer
|
|
|
|
Vir die Java-probleme:
|
|
```java
|
|
export JAVA_HOME=/Applications/Android\ Studio.app/Contents/jbr/Contents/Home
|
|
```
|
|
## GUI
|
|
|
|
### Prepare Virtual Machine
|
|
|
|
As jy Android Studio geïnstalleer het, kan jy net die hoofprojek-oorsig oopmaak en toegang kry tot: _**Tools**_ --> _**AVD Manager.**_
|
|
|
|
<div align="center" data-full-width="false">
|
|
|
|
<figure><img src="../../images/image (1142).png" alt="" width="293"><figcaption></figcaption></figure>
|
|
|
|
</div>
|
|
|
|
Then, click on _**Create Virtual Device**_
|
|
|
|
<figure><img src="../../images/image (1143).png" alt="" width="188"><figcaption></figcaption></figure>
|
|
|
|
_**kies** die telefoon wat jy wil gebruik_ en klik op _**Next.**_
|
|
|
|
> [!WARNING]
|
|
> As jy 'n telefoon met Play Store geïnstalleer benodig, kies een met die Play Store-ikoon daarop!
|
|
>
|
|
> <img src="../../images/image (1144).png" alt="" data-size="original">
|
|
|
|
In die huidige aansig kan jy **kies en aflaai die Android image** wat die telefoon gaan gebruik:
|
|
|
|
<figure><img src="../../images/image (1145).png" alt="" width="375"><figcaption></figcaption></figure>
|
|
|
|
So, select it and if it isn't downloaded click on the _**Download**_ symbol next to the name (**now wait until the image is downloaded).**\
|
|
Once the image is downloaded, just select **`Next`** and **`Finish`**.
|
|
|
|
Die virtuele masjien sal geskep word. Nou sal dit **elke keer as jy die AVD Manager oopmaak, beskikbaar wees**.
|
|
|
|
### Run Virtual Machine
|
|
|
|
Om dit te begin, druk net die _**Start button**_.
|
|
|
|
.png>)
|
|
|
|
## Command Line tool
|
|
|
|
> [!WARNING]
|
|
> Vir macOS kan jy die `avdmanager` tool vind in `/Users/<username>/Library/Android/sdk/tools/bin/avdmanager` en die `emulator` in `/Users/<username>/Library/Android/sdk/emulator/emulator` as jy dit geïnstalleer het.
|
|
|
|
Eerstens moet jy **besluit watter telefoon jy wil gebruik**, om die lys van moontlike telefone te sien voer uit:
|
|
```
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\bin\avdmanager.bat list device
|
|
|
|
d: 0 or "automotive_1024p_landscape"
|
|
Name: Automotive (1024p landscape)
|
|
OEM : Google
|
|
Tag : android-automotive-playstore
|
|
---------
|
|
id: 1 or "Galaxy Nexus"
|
|
Name: Galaxy Nexus
|
|
OEM : Google
|
|
---------
|
|
id: 2 or "desktop_large"
|
|
Name: Large Desktop
|
|
OEM : Google
|
|
Tag : android-desktop
|
|
---------
|
|
id: 3 or "desktop_medium"
|
|
Name: Medium Desktop
|
|
OEM : Google
|
|
Tag : android-desktop
|
|
---------
|
|
id: 4 or "Nexus 10"
|
|
Name: Nexus 10
|
|
OEM : Google
|
|
[...]
|
|
```
|
|
Sodra jy die naam van die toestel wat jy wil gebruik bepaal het, moet jy **bepaal watter Android image jy op hierdie toestel wil laat loop.**\
|
|
Jy kan al die opsies lys met `sdkmanager`:
|
|
```bash
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\bin\sdkmanager.bat --list
|
|
```
|
|
En **laai af** die een (of almal) wat jy wil gebruik met:
|
|
```bash
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\bin\sdkmanager.bat "platforms;android-28" "system-images;android-28;google_apis;x86_64"
|
|
```
|
|
Sodra jy die Android-beeld wat jy wil gebruik afgelaai het, kan jy **al die afgelaaide Android-beelde lys** met:
|
|
```
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\bin\avdmanager.bat list target
|
|
----------
|
|
id: 1 or "android-28"
|
|
Name: Android API 28
|
|
Type: Platform
|
|
API level: 28
|
|
Revision: 6
|
|
----------
|
|
id: 2 or "android-29"
|
|
Name: Android API 29
|
|
Type: Platform
|
|
API level: 29
|
|
Revision: 4
|
|
```
|
|
Op hierdie stadium het jy besluit watter toestel jy wil gebruik en jy het die Android image afgelaai, dus **kan jy die virtuele masjien skep met behulp van**:
|
|
```bash
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\bin\avdmanager.bat -v create avd -k "system-images;android-28;google_apis;x86_64" -n "AVD9" -d "Nexus 5X"
|
|
```
|
|
In die laaste opdrag **het ek 'n VM geskep genaamd** "_AVD9_" deur die **toestel** "_Nexus 5X_" en die **Android-image** "_system-images;android-28;google_apis;x86_64_" te gebruik.\
|
|
Nou kan jy **lys die virtuele masjiene** wat jy geskep het met:
|
|
```bash
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\bin\avdmanager.bat list avd
|
|
|
|
Name: AVD9
|
|
Device: Nexus 5X (Google)
|
|
Path: C:\Users\cpolo\.android\avd\AVD9.avd
|
|
Target: Google APIs (Google Inc.)
|
|
Based on: Android API 28 Tag/ABI: google_apis/x86_64
|
|
|
|
The following Android Virtual Devices could not be loaded:
|
|
Name: Pixel_2_API_27
|
|
Path: C:\Users\cpolo\.android\avd\Pixel_2_API_27_1.avd
|
|
Error: Google pixel_2 no longer exists as a device
|
|
```
|
|
### Voer Virtuele Masjien uit
|
|
|
|
> [!WARNING]
|
|
> Vir macOS kan jy die `avdmanager` tool in `/Users/<username>/Library/Android/sdk/tools/bin/avdmanager` en die `emulator` in `/Users/<username>/Library/Android/sdk/emulator/emulator` vind as jy hulle geïnstalleer het.
|
|
|
|
Ons het reeds gesien hoe jy die gemaakte virtuele masjiene kan lys, maar **jy kan hulle ook lys met behulp van**:
|
|
```bash
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\emulator.exe -list-avds
|
|
AVD9
|
|
Pixel_2_API_27
|
|
```
|
|
Jy kan eenvoudig **enige geskepte virtuele masjien uitvoer** met:
|
|
```bash
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\emulator.exe -avd "VirtualMachineName"
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\emulator.exe -avd "AVD9"
|
|
```
|
|
Of deur meer gevorderde opsies te gebruik, kan jy 'n virtuele masjien soos die volgende laat loop:
|
|
```bash
|
|
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\emulator.exe -avd "AVD9" -http-proxy 192.168.1.12:8080 -writable-system
|
|
```
|
|
### Command line options
|
|
|
|
Daar is egter **a lot of different command line useful options** wat jy kan gebruik om 'n virtuele masjien te begin. Hieronder kan jy 'n paar interessante opsies vind maar kan [**find a complete list here**](https://developer.android.com/studio/run/emulator-commandline)
|
|
|
|
**Opstart**
|
|
|
|
- `-snapshot name` : Start VM snapshot
|
|
- `-snapshot-list -snapstorage ~/.android/avd/Nexus_5X_API_23.avd/snapshots-test.img` : Lys alle geregistreerde snapshots
|
|
|
|
**Netwerk**
|
|
|
|
- `-dns-server 192.0.2.0, 192.0.2.255` : Laat toe om die DNS-bedieners as 'n komma-geskeide lys aan die VM aan te dui.
|
|
- **`-http-proxy 192.168.1.12:8080`** : Laat toe om 'n HTTP-proxy aan te dui om te gebruik (baie nuttig om verkeer met Burp vas te vang)
|
|
- If the proxy settings aren't working for some reason, try to configure them internally or using an pplication like "Super Proxy" or "ProxyDroid".
|
|
- `-netdelay 200` : Stel die netwerklatensie-emulasie in millisekondes.
|
|
- `-port 5556` : Stel die TCP-poortnommer wat vir die konsole en adb gebruik word.
|
|
- `-ports 5556,5559` : Stel die TCP-poorte wat vir die konsole en adb gebruik word.
|
|
- **`-tcpdump /path/dumpfile.cap`** : Neem al die verkeer in 'n lêer op
|
|
|
|
**Stelsel**
|
|
|
|
- `-selinux {disabled|permissive}` : Stel die Security-Enhanced Linux sekuriteitsmodule op 'n Linux-bedryfstelsel.
|
|
- `-timezone Europe/Paris` : Stel die tydsone vir die virtuele toestel
|
|
- `-screen {touch(default)|multi-touch|o-touch}` : Stel die geëmuleerde raakskermmodus in.
|
|
- **`-writable-system`** : Gebruik hierdie opsie om 'n skryfbare stelselbeeld tydens jou emulasiesessie te hê. Jy sal ook moet `adb root; adb remount`. Dit is baie nuttig om 'n nuwe sertifikaat in die stelsel te installeer.
|
|
|
|
## Linux CLI setup (SDK/AVD quickstart)
|
|
|
|
Die amptelike CLI-instrumente maak dit maklik om vinnige, ontfoutbare emulators te skep sonder Android Studio.
|
|
```bash
|
|
# Directory layout
|
|
mkdir -p ~/Android/cmdline-tools/latest
|
|
|
|
# Download commandline tools (Linux)
|
|
wget https://dl.google.com/android/repository/commandlinetools-linux-13114758_latest.zip -O /tmp/cmdline-tools.zip
|
|
unzip /tmp/cmdline-tools.zip -d ~/Android/cmdline-tools/latest
|
|
rm /tmp/cmdline-tools.zip
|
|
|
|
# Env vars (add to ~/.bashrc or ~/.zshrc)
|
|
export ANDROID_HOME=$HOME/Android
|
|
export PATH=$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$PATH
|
|
|
|
# Install core SDK components
|
|
sdkmanager --install "platform-tools" "emulator"
|
|
|
|
# Install a debuggable x86_64 system image (Android 11 / API 30)
|
|
sdkmanager --install "system-images;android-30;google_apis;x86_64"
|
|
|
|
# Create an AVD and run it with a writable /system & snapshot name
|
|
avdmanager create avd -n PixelRootX86 -k "system-images;android-30;google_apis;x86_64" -d "pixel"
|
|
emulator -avd PixelRootX86 -writable-system -snapshot PixelRootX86_snap
|
|
|
|
# Verify root (debuggable images allow `adb root`)
|
|
adb root
|
|
adb shell whoami # expect: root
|
|
```
|
|
Aantekeninge
|
|
- Stelselbeeld-variante: google_apis (debuggable, laat `adb root` toe), google_apis_playstore (nie-rootbaar nie), aosp/default (liggewig).
|
|
- Bouwtipes: userdebug laat dikwels `adb root` toe op debug-ondersteunende images. Play Store images is produksie-boues en blokkeer root.
|
|
- Op x86_64-gashere is volstelsels ARM64-emulasie nie ondersteun vanaf API 28+ nie. Vir Android 11+ gebruik Google APIs/Play images wat per-app ARM-na-x86-vertaling insluit om baie ARM-only apps vinnig te laat loop.
|
|
|
|
### Snapshots vanaf die CLI
|
|
```bash
|
|
# Save a clean snapshot from the running emulator
|
|
adb -s emulator-5554 emu avd snapshot save my_clean_setup
|
|
|
|
# Boot from a named snapshot (if it exists)
|
|
emulator -avd PixelRootX86 -writable-system -snapshot my_clean_setup
|
|
```
|
|
## ARM→x86 binary translation (Android 11+)
|
|
|
|
Google APIs en Play Store-images op Android 11+ kan ARM-app-binaire per proses vertaal terwyl die res van die stelsel native x86/x86_64 bly. Dit is dikwels vinnig genoeg om baie slegs-ARM-apps op 'n lessenaar te toets.
|
|
|
|
> Tip: Verkies Google APIs x86/x86_64-images tydens pentests. Play-images is gerieflik maar blokkeer `adb root`; gebruik hulle slegs wanneer jy spesifiek Play services benodig en die gebrek aan root aanvaar.
|
|
|
|
## Rooting a Play Store device
|
|
|
|
If you downloaded a device with Play Store you are not going to be able to get root directly, and you will get this error message
|
|
```
|
|
$ adb root
|
|
adbd cannot run as root in production builds
|
|
```
|
|
Deur [rootAVD](https://github.com/newbit1/rootAVD) met [Magisk](https://github.com/topjohnwu/Magisk) te gebruik, kon ek dit root (volg byvoorbeeld [**this video**](https://www.youtube.com/watch?v=Wk0ixxmkzAI) of [**this one**](https://www.youtube.com/watch?v=qQicUW0svB8)).
|
|
|
|
## Installeer Burp Sertifikaat
|
|
|
|
Kyk na die volgende bladsy om te leer hoe om 'n pasgemaakte CA cert te installeer:
|
|
|
|
|
|
{{#ref}}
|
|
install-burp-certificate.md
|
|
{{#endref}}
|
|
|
|
## Nuttige AVD-opties
|
|
|
|
### Neem 'n Snapshot
|
|
|
|
Jy kan **die GUI gebruik** om te eniger tyd 'n snapshot van die VM te neem:
|
|
|
|
.png>)
|
|
|
|
## References
|
|
|
|
- [Build a Repeatable Android Bug Bounty Lab: Emulator vs Magisk, Burp, Frida, and Medusa](https://www.yeswehack.com/learn-bug-bounty/android-lab-mobile-hacking-tools)
|
|
- [Android Emulator command line](https://developer.android.com/studio/run/emulator-commandline)
|
|
- [Run ARM apps on the Android Emulator (x86 translation)](https://android-developers.googleblog.com/2020/03/run-arm-apps-on-android-emulator.html)
|
|
|
|
{{#include ../../banners/hacktricks-training.md}}
|