hacktricks/mobile-pentesting/android-app-pentesting/avd-android-virtual-device.md

11 KiB

AVD - Dispositivo Virtual Android

Aprenda hacking AWS do zero ao herói com htARTE (HackTricks AWS Red Team Expert)!

Outras formas de apoiar o HackTricks:

Muito obrigado a @offsecjay por sua ajuda na criação deste conteúdo.

O que é

O Android Studio permite executar máquinas virtuais do Android que você pode usar para testar APKs. Para usá-las, você precisará de:

  • As ferramentas Android SDK - Baixe aqui.
  • Ou o Android Studio (com as ferramentas Android SDK) - Baixe aqui.

No Windows (no meu caso) após instalar o Android Studio eu tive as Ferramentas SDK instaladas em: C:\Users\<NomeDoUsuário>\AppData\Local\Android\Sdk\tools

No Mac, você pode baixar as ferramentas SDK e tê-las no PATH executando:

brew tap homebrew/cask
brew install --cask android-sdk

Ou a partir da interface gráfica do Android Studio conforme indicado em https://stackoverflow.com/questions/46402772/failed-to-install-android-sdk-java-lang-noclassdeffounderror-javax-xml-bind-a que os instalará em ~/Library/Android/sdk/cmdline-tools/latest/bin/ e ~/Library/Android/sdk/platform-tools/ e ~/Library/Android/sdk/emulator/

Para os problemas de Java:

export JAVA_HOME=/Applications/Android\ Studio.app/Contents/jbr/Contents/Home

GUI

Preparar Máquina Virtual

Se você instalou o Android Studio, você pode simplesmente abrir a visualização do projeto principal e acessar: Ferramentas --> Gerenciador AVD.

Em seguida, clique em Criar Dispositivo Virtual

selecione o telefone que deseja usar e clique em Avançar.

{% hint style="warning" %} Se você precisa de um telefone com a Play Store instalada, selecione um com o ícone da Play Store nele!

{% endhint %}

Na visualização atual, você poderá selecionar e baixar a imagem do Android que o telefone irá executar:

Então, selecione e se não estiver baixado, clique no símbolo de Download ao lado do nome (agora aguarde até que a imagem seja baixada).
Assim que a imagem for baixada, basta selecionar Avançar e Concluir.

A máquina virtual será criada. Agora, toda vez que você acessar o gerenciador AVD, ela estará presente.

Executar Máquina Virtual

Para executá-la, basta pressionar o botão Iniciar.

Ferramenta de Linha de Comando

Primeiramente, você precisa decidir qual telefone deseja usar, para ver a lista de telefones possíveis execute:

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
[...]

Depois de decidir o nome do dispositivo que deseja usar, você precisa decidir qual imagem do Android deseja executar neste dispositivo.
Você pode listar todas as opções usando sdkmanager:

C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\bin\sdkmanager.bat --list

E baixe aquele (ou todos) que deseja usar com:

{% code overflow="wrap" %}

C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\bin\sdkmanager.bat "platforms;android-28" "system-images;android-28;google_apis;x86_64"

{% endcode %}

Depois de ter baixado a imagem do Android que deseja usar, você pode listar todas as imagens do Android baixadas com:

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

Neste momento, você decidiu o dispositivo que deseja usar e baixou a imagem do Android, então você pode criar a máquina virtual usando:

{% code overflow="wrap" %}

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"

{% endcode %}

No último comando criei uma VM chamada "AVD9" usando o dispositivo "Nexus 5X" e a imagem do Android "system-images;android-28;google_apis;x86_64".
Agora você pode listar as máquinas virtuais que você criou com:

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

Executar Máquina Virtual

Já vimos como você pode listar as máquinas virtuais criadas, mas você também pode listá-las usando:

C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\emulator.exe -list-avds
AVD9
Pixel_2_API_27

Você pode simplesmente executar qualquer máquina virtual criada usando:

{% code overflow="wrap" %}

C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\emulator.exe -avd "VirtualMachineName"
C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\emulator.exe -avd "AVD9"

{% endcode %}

Ou usando opções mais avançadas, você pode executar uma máquina virtual como:

{% code overflow="wrap" %}

C:\Users\<UserName>\AppData\Local\Android\Sdk\tools\emulator.exe -avd "AVD9" -http-proxy 192.168.1.12:8080 -writable-system

{% endcode %}

Opções da linha de comando

No entanto, existem muitas opções úteis de linha de comando diferentes que você pode usar para iniciar uma máquina virtual. Abaixo você pode encontrar algumas opções interessantes, mas pode encontrar uma lista completa aqui

Inicialização

  • -snapshot name : Iniciar snapshot da VM
  • -snapshot-list -snapstorage ~/.android/avd/Nexus_5X_API_23.avd/snapshots-test.img : Listar todos os snapshots gravados

Rede

  • -dns-server 192.0.2.0, 192.0.2.255 : Permite indicar separados por vírgula os servidores DNS para a VM.
  • -http-proxy 192.168.1.12:8080 : Permite indicar um proxy HTTP a ser usado (muito útil para capturar o tráfego usando o Burp)
  • -port 5556 : Define o número da porta TCP usado para o console e adb.
  • -ports 5556,5559 : Define as portas TCP usadas para o console e adb.
  • -tcpdump /path/dumpfile.cap : Captura todo o tráfego em um arquivo

Sistema

  • -selinux {disabled|permissive} : Define o módulo de segurança Linux Security-Enhanced Linux como desativado ou em modo permissivo em um sistema operacional Linux.
  • -timezone Europe/Paris : Define o fuso horário para o dispositivo virtual
  • -screen {touch(default)|multi-touch|o-touch} : Define o modo de tela sensível ao toque emulado.
  • -writable-system : Use esta opção para ter uma imagem de sistema gravável durante sua sessão de emulação. Você também precisará executar adb root; adb remount. Isso é muito útil para instalar um novo certificado no sistema.

Fazendo root em um dispositivo da Play Store

Se você baixou um dispositivo com a Play Store, não será possível obter acesso root diretamente e você receberá esta mensagem de erro

$ adb root
adbd cannot run as root in production builds

Usando rootAVD com Magisk consegui fazer root nele (siga, por exemplo, este vídeo ou este).

Instalar Certificado Burp

Verifique a seguinte página para aprender como instalar um certificado CA personalizado:

{% content-ref url="install-burp-certificate.md" %} install-burp-certificate.md {% endcontent-ref %}

Ótimas Opções AVD

Tirar um Snapshot

Você pode usar a GUI para tirar um snapshot da VM a qualquer momento:

Aprenda hacking AWS do zero ao herói com htARTE (HackTricks AWS Red Team Expert)!

Outras maneiras de apoiar o HackTricks: