diff --git a/docs/pt/how-tos/02-how-to-enable-developer-options/index.md b/docs/pt/how-tos/02-how-to-enable-developer-options/index.md new file mode 100644 index 000000000..53522454b --- /dev/null +++ b/docs/pt/how-tos/02-how-to-enable-developer-options/index.md @@ -0,0 +1,223 @@ +--- + +title: ¿Cómo habilitar las opciones de desarrollador en diferentes dispositivos Android? +summary: Cómo habilitar las opciones de desarrollador en diferentes dispositivos Android. +keywords: triage, android, developer options +lang: es +tags: [how-to, intro] +last_updated: 2025-07-28 +some_url: +created: 2025-07-28 +comments: true +author: + name: Daniel + url: https://socialtic.org/quienes-somos/ + description: SocialTIC + +translation-review-pending: true +--- + +# Guia: Como ativar as opções de desenvolvedor em diferentes dispositivos Android? + + +Este recurso se enquadra na categoria de **guias de instruções** e mostra as etapas a serem seguidas para **ativar o menu de opções do desenvolvedor em diferentes dispositivos Android**, bem como uma breve explicação sobre **o que são as opções do desenvolvedor** e **por que elas são úteis** ao fazer perícia digital. Este é um material **introdutório**, complementar a outros recursos, como o [explicador forense baseado em registro para dispositivos Android](../../explainers/03-explainer-log-forensics-android/), e **faz parte das etapas a serem seguidas para realizar a triagem inicial**. + +Somos gratos pela **colaboração** do [Reporters Without Borders security lab] (https://rsf.org/en/digital-security-lab), que forneceu a contribuição inicial necessária para a produção deste guia. + +## O que são e por que são úteis? + +As [**opções do desenvolvedor**](https://developer.android.com/studio/debug/dev-options) referem-se a um **menu oculto** do sistema operacional **Android** que permite configurar algumas **funções adicionais**, especialmente destinadas a apoiar o processo de [depuração](https://es.wikipedia.org/wiki/Depuraci%C3%B3n_de_programas) durante a **criação de novos aplicativos ou alterações no sistema**. Entre as opções do desenvolvedor, algumas **configurações avançadas** também são frequentemente colocadas, como o ajuste das preferências do driver gráfico ou configurações avançadas de rede e até mesmo **opções experimentais** que ainda estão em teste ou desenvolvimento. + +Do ponto de vista da **forense digital** e, em particular, ao fazer [investigações baseadas em logs](../../explainers/03-explainer-log-forensics-android/) usando ferramentas como MVT e AndroidQF, as opções do desenvolvedor **permitem ativar os principais recursos**, como **[depuração USB](../../references/00-glossary/index.md#adb)**, o **consolo do ADB** ou a **geração de relatórios de erros***. É por isso que, em muitos casos, a **primeira etapa** será ativar o menu de opções do desenvolvedor. + +## Por que há diferentes maneiras de ativá-las? + +O sistema operacional Android é baseado no projeto de código aberto [*Android Open Source Project*](https://source.android.com/)*.* No entanto, [a maioria dos fabricantes usa uma versão proprietária do Google](https://www.makeuseof.com/tag/android-really-open-source-matter/), sobre a qual são adicionadas camadas de personalização adicionais, que, na maioria dos casos, também são proprietárias. Há algumas alternativas, como [LineageOS](https://lineageos.org/), [Graphene OS](https://grapheneos.org/) ou [CalyxOS](https://calyxos.org/), que se baseiam inteiramente em princípios de **fonte aberto** e buscam se afastar dos ecossistemas proprietários. + +O resultado desses desenvolvimentos adicionais sobre o projeto básico significa que há uma **grande variedade de interfaces gráficas** para o sistema operacional. Os exemplos incluem: + +* [Pixel UI] (https://en.wikipedia.org/wiki/Google_Pixel): interface de usuário desenvolvida pelo **Google** para dispositivos Pixel. Ela é semelhante à versão básica do Android, mas inclui [personalizações adicionais e proprietárias desenvolvidas pelo Google] (https://www.howtogeek.com/google-pixel-devices-stock-android/). +* One UI](https://es.wikipedia.org/wiki/One_UI): interface de usuário desenvolvida pela **Samsung** para dispositivos inteligentes, incluindo dispositivos móveis Android desde 2017. Há versões da One UI para telefones, tablets, smartwatches e computadores. +* HyperOS](https://es.wikipedia.org/wiki/Xiaomi_HyperOS): interface de usuário desenvolvida pela **Xiaomi**, lançada em 2023, substituindo a interface de usuário anterior conhecida como [MIUI](https://es.wikipedia.org/wiki/MIUI). +* ColorOS](https://es.wikipedia.org/wiki/ColorOS): o ColorOS é um sistema operacional móvel e uma interface de usuário criada pela **Oppo Electronics**. +* Realme UI](https://en.wikipedia.org/wiki/Realme): interface de usuário desenvolvida pela **Realme**, que, por sua vez, é uma subsidiária da [Oppo Electronics](https://en.wikipedia.org/wiki/Oppo), que também é proprietária da marca **OnePlus**. +* Oxygen OS](https://en.wikipedia.org/wiki/OxygenOS): sistema operacional desenvolvido pela **OnePlus** exclusivamente para telefones celulares. +* Harmony OS](https://en.wikipedia.org/wiki/HarmonyOS): sistema operacional desenvolvido pela **Huawei**. Embora às vezes seja posicionado como um sistema operacional diferente, ele é baseado no Android e na camada de personalização anterior, conhecida como [EMUI](https://en.wikipedia.org/wiki/EMUI). +* Hello UI] (https://beebom.com/motorola-hello-ui-review/): interface desenvolvida pela **Motorola**, parte da **Lenovo**. [Este vídeo](https://www.google.com/url?q=https://www.youtube.com/watch?v%3Di3ZU9-TGJlE&sa=D&source=docs&ust=1753486266796661&usg=AOvVaw14C09MkoaBDTU4pbef9Aqq) mostra aspectos relevantes da interface. +* Xperia UI](https://en.wikipedia.org/wiki/Sony_Xperia): interface de usuário desenvolvida pela **Sony** para dispositivos [Xperia](https://en.wikipedia.org/wiki/Sony_Xperia). +* Magic OS](https://en.wikipedia.org/wiki/Honor_(brand)#MagicOS): sistema operacional desenvolvido pelo fabricante [**Honor](https://en.wikipedia.org/wiki/Honor_), anteriormente uma subsidiária da **Huawei**. + +## Lista de instruções passo a passo + +Abaixo estão os **passos a serem seguidos** para ativar o menu de opções do desenvolvedor em **diferentes dispositivos**, bem como uma captura de tela dos menus a serem seguidos para exibir esse menu. + + + +### Google (Pixel OS) + +Para habilitar as opções de desenvolvedor em dispositivos **Google** que usam **Pixel OS**, você pode seguir as seguintes etapas, também exemplificadas na **imagem 1.**. + +1. abra o menu **Configurações** ⚙️ +Navegue até a última opção **Sobre o telefone** 📱 3. +3. Localize as informações sobre o **Build number** 🔢 +4. Pressione **7 vezes** no número de compilação, até ver uma mensagem de confirmação. 👆 + +![Etapas para ativar as opções de desenvolvedor em um dispositivo Google Pixel com Android 13](.../../../../../assets/02-how-to/enable-dev-options-Google.gif "image 1"){ loading=lazy } +/// legenda +**Imagem 1**. Etapas para ativar as opções de desenvolvedor em um dispositivo Google Pixel com Android 13. +/// + +As opções do desenvolvedor aparecerão como um novo submenu em **Sistema** e permanecerão **habilitadas** até serem desativadas (no menu de opções do desenvolvedor). + +### Honor (Magic OS) + +Para ativar as opções de desenvolvedor nos dispositivos **Honor** que usam a versão **Magic OS** do Android, você pode seguir as etapas abaixo, também mostradas na **imagem 2**. + +1. abra o menu **Configurações** ⚙️ +Navegue até a última opção **Sobre o telefone** 📱 3. +3. Localize as informações sobre o **Número de compilação** 🔢 +4. Pressione **7 vezes** no número de compilação, até ver uma mensagem de confirmação. 👆 + +As opções do desenvolvedor aparecerão como um novo submenu em **Sistema** e permanecerão **habilitadas** até serem desabilitadas (no menu de opções do desenvolvedor). + +Etapas para ativar as opções de desenvolvedor em um dispositivo Honor Magic Lite com Magic OS 7.1 no Android 13](.../../../../assets/02-how-to/02-like-enable-dev-options/developer-options/assets/enable-dev-options-Honor.gif "image 2"){ loading=lazy } +/// legenda +**imagem 2**. Etapas para ativar as opções de desenvolvedor em um dispositivo Honor Magic Lite com Magic OS 7.1 no Android 13. +/// + +### Motorola (Hello UI) + +Para ativar as opções de desenvolvedor em dispositivos **Motorola** que usam a versão 13 do Android, você pode seguir as etapas abaixo, também exemplificadas na **imagem 3. + +1. abra o menu **Configurações** ⚙️ +Navegue até a última opção **Sobre o telefone** 📱 3. +3. Localize as informações sobre o **Build number** 🔢 +4. Pressione **7 vezes** no número de compilação, até ver uma mensagem de confirmação. 👆 + +![Etapas para ativar as opções de desenvolvedor em um dispositivo Motorola Edge Neo 40 usando o Hi OS no Android 13](.../../../../assets/02-how-to/02-like-enable-dev-options-developer-options/assets/enable-dev-options-Motorola.gif "image 4"){ loading=lazy } +/// legenda +**imagem 3**. Etapas para ativar as opções do desenvolvedor em um dispositivo Motorola Edge Neo 40 usando o Hi OS no Android 13. +/// + + +### Nokia + +Para ativar as opções de desenvolvedor em dispositivos **Nokia** que usam a versão 13 ou superior do Android, você pode seguir as etapas abaixo, também mostradas na **imagem 4. + +1. abra o menu **Configurações** ⚙️ +Navegue até a última opção **Sobre o telefone** 📱 3. +3. Localize as informações sobre o **Número de compilação** 🔢 +4. Pressione **7 vezes** no número de compilação, até ver uma mensagem de confirmação. 👆 + +As opções do desenvolvedor aparecerão como um novo submenu em **Sistema** e permanecerão **habilitadas** até serem desabilitadas (no menu de opções do desenvolvedor). + +Etapas para ativar as opções do desenvolvedor em um dispositivo Nokia G42 5G usando o Android 13](.../../../../assets/02-how-to/02-como-ativar-opções-do-desenvolvedor/assets/enable-dev-options-Nokia.gif "image 4"){ loading=lazy } +/// legenda +**imagem 4**. Etapas para habilitar as opções de desenvolvedor em um dispositivo Nokia G42 5G usando o Android 13. +/// + +### Oppo Reno 10 (Color OS) + +Para ativar as opções de desenvolvedor em um dispositivo Nokia G42 5G usando o Android 13.Se você **OPPO** estiver usando o Android versão 13 ou superior, poderá seguir as etapas a seguir, também exemplificadas na **imagem 5. + +1. abra o menu **Configurações** ⚙️ +Navegue até a última opção **Sobre o telefone** 📱 3. +3. Localize as informações sobre o **Número da versão** 🔢 4. +4. Pressione **7 vezes** no número da versão, até ver uma mensagem de confirmação. 👆 + +As opções do desenvolvedor aparecerão como um novo submenu em **Sistema** e permanecerão **habilitadas** até serem desabilitadas (no menu de opções do desenvolvedor). + +Etapas para ativar as opções de desenvolvedor em um dispositivo Oppo Android 13](.../../../../assets/02-how-to/02-like-enable-dev-options/dev-options/assets/enable-dev-options-oppo.gif "image 5"){: style="height:480x;width:216px"} +/// legenda +**Imagem 5**. Etapas para ativar as opções de desenvolvedor em um dispositivo Oppo. +/// + +### Realme (Realme UI) + +Para ativar as opções de desenvolvedor em dispositivos **Realme** usando a camada de personalização da Realme UI, você pode seguir as etapas abaixo, também exemplificadas na **imagem 6. + +1. abra o menu **Configurações** ⚙️ +Navegue até a última opção **Sobre o dispositivo** 📱 3. +3. Entre no menu **versão** 📝 4. +4. Localize as informações do **Build Number** 🔢 🔢 5. +5. Pressione **7 vezes** no número de compilação até ver uma mensagem de confirmação. 👆 + +![Etapas para ativar as opções de desenvolvedor em um dispositivo Realme GT2 Pro com RealMe UI 4.0 usando o Android 13](../../../../assets/02-how-to/02-like-enable-dev-options/developer-options/assets/enable-dev-options-Realme.gif "image 6"){ loading=lazy } +/// legenda +**imagem 6**. Etapas para ativar as opções de desenvolvedor em um dispositivo Realme GT2 Pro com RealMe UI 4.0 usando o Android 13 +/// + +### Samsung (One UI) + +Para ativar as opções de desenvolvedor em dispositivos **Samsung** usando a camada de personalização One UI, você pode seguir as etapas abaixo, também exemplificadas na **imagem 7. + +1. abra o menu **Configurações ⚙️** 2. +Navegue até a última opção **Sobre o telefone** 📱 3. +3. Entre no menu **Informações de software** 📝 4. +4. Localize as informações do **Build Number** 🔢 🔢 5. +5. Pressione **7 vezes** no número de compilação até ver uma mensagem de confirmação. 👆 + +Etapas para ativar as opções de desenvolvedor em um dispositivo Samsung Galaxy A54 com One UI em um dispositivo com Android 13](https://media0.giphy.com/media/v1.Y2lkPTc5MGI3NjExdnB4bTJ0dWpnaWVsY2s0aWVnYTZyejN3a3N1bnhwZnV2NW10cGN2eSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/ctCvv5Is6UZ6CEhQ4D/giphy.gif "image 7"){ loading=lazy } +/// legenda +**Imagem 7**. Etapas para ativar as opções de desenvolvedor em um dispositivo Samsung Galaxy A54 com One UI em um dispositivo com Android 13 +/// + +### Sony (Xperia UI) + +Para ativar as opções de desenvolvedor em dispositivos **Xperia** usando a camada de personalização da Xperia UI, você pode seguir as etapas abaixo, também exemplificadas na **imagem 8. + +1. abra o menu **Configurações** ⚙️ +Navegue até a última opção **Sobre o telefone** 📱 3. +3. Localize as informações sobre o **Número de compilação** 🔢 +4. Pressione **7 vezes** no número de compilação até ver uma mensagem de confirmação. 👆 + +![Etapas para ativar as opções de desenvolvedor em um dispositivo Sony Xperia 10V com Xperia UI 4.0 usando o Android 14](../../../assets/02-how-to/02-like-enable-dev-options/assets/enable-dev-options-Sony.gif "image 8"){ loading=lazy } +/// legenda +**imagem 8**. Etapas para habilitar as opções de desenvolvedor em um dispositivo Sony Xperia 10V com Xperia UI 4.0 usando o Android 14.0. +/// + + +### Techno (Hi OS) + +Para ativar as opções de desenvolvedor nos dispositivos **Tecno Spark** que usam a camada de personalização Hi OS, você pode seguir as etapas abaixo, também exemplificadas na **imagem 9. + +1. abra o menu **Settings** (Configurações) ⚙️ +Navegue até a opção **My Phone** 📱 3. +3. Localize a informação **Compilation number** 🔢 🔢 4. +4. Pressione **7 vezes** no número de compilação até ver uma mensagem de confirmação. 👆 + +Etapas para ativar as opções de desenvolvedor em um dispositivo Tecno Spark Go com Hi OS usando o Android 13](../../../../../assets/02-how-to/02-as-enable-dev-options-developer-options/assets/enable-dev-options-Tecno.gif "image 9"){ loading=lazy } +/// legenda +**imagem 9**. Etapas para ativar as opções de desenvolvedor em um dispositivo Tecno Spark Go com Hi OS usando o Android 13. +/// + +### Xiaomi (Hyper OS) + +Para ativar as opções de desenvolvedor em dispositivos **Xiaomi** que usam a camada de personalização do Hyper OS, você pode seguir as etapas abaixo, também exemplificadas na **imagem 10.**. + +1. abra o menu **Configurações** ⚙️ +2. vá para a opção **About** (Sobre). do telefone** 📱 +3. Localize as informações da **Versão do sistema operacional** 🔢 🔢 4. +4. Pressione **7 vezes** no número de compilação até ver uma mensagem de confirmação. 👆 + +![Etapas para ativar as opções de desenvolvedor em um dispositivo Xiamoi](.../../../../assets/02-how-to/02-like-enable-dev-options/assets/enable-dev-options-Xiaomi.gif "image 10"){ loading=lazy } +/// legenda +**imagem 10**. Etapas para habilitar as opções de desenvolvedor em um dispositivo Xiamoi. +/// + +As opções do desenvolvedor aparecerão como um novo submenu em **Opções avançadas** e permanecerão **habilitadas** até serem desativadas (no menu de opções do desenvolvedor). + +## Conclusão + +A interface gráfica dos dispositivos Android varia entre os fabricantes que usam o [Android Open Source Project (AOSP)] (https://source.android.com/?hl=es-419) como base. Cada fabricante constrói seus próprios desenvolvimentos sobre essa camada de base, com diferentes níveis de personalização, resultando em interfaces com **aparência, menus e opções diferentes**. + +O menu **developer options** é um menu oculto, que é ativado por meio de um procedimento simples na GUI, e é necessário para modificar **as principais opções necessárias durante um processo de extração forense**, como o console ADB ou um relatório de bug. Esse recurso compila **capturas de tela de diferentes fabricantes** e interfaces, com a intenção de **facilitar aos analistas da sociedade civil a ativação das opções do desenvolvedor**. + +Se **você tem acesso a uma GUI que não é mostrada na lista** e gostaria de incorporar a captura de tela correspondente a esse recurso, escreva para nós por meio de um *[issue](../../community/how-to-contribute/index.md#proposals-for-improvements-or-corrections-through-issues)* ou, se você estiver familiarizado com markdown, pode enviar uma solicitação de integração por meio de um *[pull request](../../community/how-to-contribute/index.md#requests-for-integration-through-pull-request)*. + + +## Comentários + +Você tem **comentários ou sugestões** sobre este recurso? Você pode usar a função **comentário abaixo** para nos deixar suas ideias ou comentários. Certifique-se de seguir nosso [código de conduta](../../community/code-of-conduct/). A função de comentário está vinculada diretamente à seção [_Discussions_ do Github] (https://github.com/Socialtic/forensics/discussions), onde você também pode **participar diretamente das discussões**, se preferir. + + diff --git a/docs/pt/how-tos/03-how-to-enable-adb/index.md b/docs/pt/how-tos/03-how-to-enable-adb/index.md new file mode 100644 index 000000000..df85a1e31 --- /dev/null +++ b/docs/pt/how-tos/03-how-to-enable-adb/index.md @@ -0,0 +1,240 @@ +--- + +title: ¿Cómo habilitar ADB en diferentes dispositivos Android? +summary: Cómo habilitar ADB en diferentes dispositivos Android. +keywords: triage, android, ADB, debug bridge, usb debug +lang: es +tags: [how-to, intro] +last_updated: 2025-07-30 +some_url: +created: 2025-07-30 +comments: true +author: + name: Daniel + url: https://socialtic.org/quienes-somos/ + description: SocialTIC + +translation-review-pending: true +--- + +# Guia: Como ativar o ADB em diferentes dispositivos Android? + +Este recurso se enquadra na categoria de **guias de instruções** e mostra as etapas a serem seguidas para **ativar a depuração USB ou *Android Debug Bridge* em diferentes dispositivos Android**, bem como uma breve explicação sobre **o que é a depuração USB** e **por que ela é útil** ao fazer perícia digital. Este é um material **introdutório**, complementar a outros recursos, como o [explicador forense baseado em registro para dispositivos Android](../../explainers/03-explainer-log-forensics-android/) e o [guia para ativar as opções do desenvolvedor](../how-tos/02-as-enabling-developer-options/02-as-enabling-developer-options.html) ; e **faz parte das etapas a serem seguidas para realizar a triagem inicial**. + +Somos gratos pela **colaboração** do [Reporters Without Borders security lab] (https://rsf.org/en/digital-security-lab), que forneceu os insumos iniciais necessários para a produção deste guia. + +## O que é *ADB* ou depuração USB e por que ela é útil? + +ADB significa *Android Debug Bridge*. O ADB é uma **ferramenta de linha de comando** **que permite que você se comunique diretamente via USB com um dispositivo Android** e inicie diferentes ações e comandos. + +Do ponto de vista da **forense digital** e, em particular, ao fazer [investigações baseadas em logs](../../explainers/03-explainer-log-forensics-android/) usando ferramentas como o AndroidQF, o **ADB permite estabelecer comunicação direta com um dispositivo**. Ele é útil em situações em que **você tem acesso físico ao dispositivo** e quando deseja obter informações diretamente do dispositivo por meio de **comandos nativos**, sem usar ferramentas adicionais. + + + +## Como ativar o ADB? + +Em geral, a depuração de USB ou ADB **é encontrada no menu [developer-options] (../../references/00-glossary/index.md#developer-mode)**. Portanto, se esse menu ainda não tiver sido ativado, siga as instruções correspondentes para ativá-lo. + +Abaixo estão os **passos a seguir para diferentes modelos e versões** do sistema operacional Android. + + +Pergunta "Por que as instruções mudam entre dispositivos diferentes?" + + O sistema operacional Android baseia seu núcleo no projeto de código aberto [*Android Open Source Project*](https://source.android.com/)*.* No entanto, [a maioria dos fabricantes usa uma versão proprietária do Google](https://www.makeuseof.com/tag/android-really-open-source-matter/), sobre a qual são adicionadas camadas de personalização adicionais, que, na maioria dos casos, também são proprietárias. + + [:octicons-arrow-right-24: Leia mais sobre isso aqui](../02-how-to-enable-developer-options/index.md#why-there-are-different-ways-of-enabling-them) + + + +### Google (Pixel OS) + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor no Pixel](../02-how-to-enable-developer-options/index.md#google-pixel-os)**. + +Depois de ativar as opções de desenvolvedor, siga estas **etapas para ativar o ADB**, demonstradas na **imagem 2**. + +1. abra o menu **Configurações ⚙️**. +2. navegue até a última opção **System and Updates 📱** 3. +3. navegue até a opção **Developer Options 🤖**. +4. Ative a primeira opção **USB Debugging 🖥️** +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + +Etapas para ativar o ADB em um dispositivo Google Pixel com Android 13](.../../../../../assets/03-how-to/activating-adb-honor-magic-lite.gif "image 1"){: style="height:480x;width:216px"} +/// legenda +**Imagem 1**. Etapas para ativar o ADB em um dispositivo Google Pixel com Android 13. +/// + + +### Honor (Magic OS) + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor no Honor](../02-how-to-enable-developer-options/index.md#honor-magic-os)**. + +Depois de ativar as opções de desenvolvedor, siga estas **etapas para ativar o ADB**, mostradas na **imagem 2**. + +1. abra o menu **Configurações ⚙️**. +2. navegue até a última opção **System and Updates 📱** 3. +3. navegue até a opção **Developer Options 🤖**. +4. Ative a primeira opção **USB Debugging 🖥️** +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + +Etapas para ativar o ADB em um dispositivo Honor Magic Lite executando o Magic OS 7.1 no Android 13](../../../../../assets/03-how-to/activating-adb-honor-magic-lite.gif "image 2"){: style="height:480x;width:216px"} +/// legenda +**Imagem 2**. Etapas para ativar o ADB em um dispositivo Honor Magic Lite com a versão Magic OS 7.1 no Android 13. +/// + +### Motorola (Hello UI) + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Motorola](../02-how-to-enable-developer-options/index.md#motorola-hello-ui)**. + +Depois de ativar as opções do desenvolvedor, siga estas **etapas para ativar o ADB**, mostradas na **figura 3**. + +1. abra o menu **Settings (Configurações) ⚙️**. +2. navegue até a última opção **System 📱** 3. +3. navegue até a opção **Developer Options 🤖**. +4. Habilite a primeira opção **USB Debugging 🖥️** 5. +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + +Etapas para ativar o ADB em um dispositivo Motorola Edge Neo 40 usando o Hello UI no Android 13](../../../../../assets/03-how-to/activating-adb-motorola-edge-40-neo.gif "image 4"){: style="height:480x;width:216px"} +/// legenda +**imagem 3**. Etapas para ativar o ADB em um dispositivo Motorola Edge Neo 40 usando o Hello UI no Android 13. +/// + + +### Nokia + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Nokia](../02-how-to-enable-developer-options/index.md#nokia)**. + +Depois de ativar as opções do desenvolvedor, siga estas **etapas para ativar o ADB**, demonstradas na **imagem 4**. + +1. abra o menu **Configurações ⚙️**. +2. navegue até a última opção **Sistema 📱** 3. +3. navegue até a opção **Developer Options 🤖**. +4. Habilite a primeira opção **USB Debugging 🖥️** 5. +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + +Etapas para ativar o ADB em um dispositivo Nokia G42 5G usando o Android 13](../../../assets/03-how-to/activating-adb-nokia-g42.gif "image 4"){: style="height:480x;width:216px"} +/// legenda +**Imagem 4**. Etapas para ativar o ADB em um dispositivo Nokia G42 5G usando o Android 13. +/// + +### Oppo (Magic OS) + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor**. Depois de ativar as opções do desenvolvedor, siga estas **[etapas para ativar as opções do desenvolvedor em dispositivos Oppo](../02-how-to-enable-developer-options/index.md#oppo-reno-10-color-os)**. + +Depois de ativar as opções de desenvolvedor, siga estas **etapas para ativar o ADB**, demonstradas na **imagem 5**. + + +1. abra o menu **Configurações ⚙️**. +2. navegue até a última opção **Additional Tools 📱** 3. +3. navegue até a opção **Developer Options 🤖**. +4. Ative a terceira opção **USB Debugging 🖥️** +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + +![Etapas para ativar o ADB em um dispositivo OPPO Reno 10 usando o Android 13](.../../../assets/03-how-to/activating-adb-oppo-reno10-5g.gif "image 5"){: style="height:480x;width:216px"} +/// legenda +**Imagem 5**. Etapas para ativar o ADB em um dispositivo OPPO Reno 10 usando o Android 13 +/// + + +### Realme (Realme UI) + +Para ativar o **ADB**, você precisa ter acesso às opções de desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções de desenvolvedor nos dispositivos Realme](../02-how-to-enable-developer-options/index.md#realme-realme-ui)**. + +Depois de ativar as opções de desenvolvedor, siga estas **etapas para ativar o ADB**, demonstradas na **imagem 6**. + +1. abra o menu **Settings (Configurações) ⚙️**. +2. navegue até a última opção **Additional Tools 📱** 3. +3. navegue até a opção **Developer Options 🤖**. +4. Ative a terceira opção **USB Debugging 🖥️** +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + + +![Etapas para ativar o ADB em um dispositivo Realme GT2 Pro com RealMe UI 4.0 usando o Android 13](../../../assets/03-how-to/activating-adb-realme-gt2-pro.gif "image 6"){: style="height:480x;width:216px"} +/// legenda +**Imagem 6**. Etapas para ativar o ADB em um dispositivo Realme GT2 Pro com RealMe UI 4.0 usando o Android 13 +/// + +### Samsung (One UI) + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Samsung](../02-how-to-enable-developer-options/index.md#samsung-one-ui)**. + +Depois de ativar as opções de desenvolvedor, siga estas **etapas para ativar o ADB**, mostradas na **figura 7.**. + + +1. abra o menu **Configurações ⚙️**. +2. navegue até a opção **Developer Options 🤖**. +3. Habilite a terceira opção **USB Debugging 🖥️** +4. **Confirme** que você desejaativar a depuração USB no menu pop-up ✅. + +![Etapas para ativar o ADB em um dispositivo Samsung Galaxy A54 com One UI em um dispositivo com Android 13](.../../../../../assets/03-how-to/activating-adb-samsung-galaxy-a54-5g.gif "image 7"){: style="height:480x;width:216px"} +/// legenda +**Imagem 7**. Etapas para ativar o ADB em um dispositivo Samsung Galaxy A54 com One UI em um dispositivo com Android 13 +/// + +### Sony (Xperia UI) + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Sony](../02-how-to-enable-developer-options/index.md#sony-xperia-ui)**. + + Depois de ativar as opções de desenvolvedor, siga estas **etapas para ativar o ADB**, mostradas na **imagem 8. + +1. abra o menu **Settings (Configurações) ⚙️** 2. +2. entre no **menu System 📱** 3. +3. navegue até as **Opções do desenvolvedor 🤖** 4. +4. Habilite a terceira opção **USB Debugging 🖥️** +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + +Etapas para ativar o ADB em um dispositivo Sony Xperia 10V com Xperia UI 4.0 usando o Android 14](../../../assets/03-how-to/activating-adb-sony-xperia-10-v.gif "image 8"){: style="height:480x;width:216px"} +/// legenda +**Imagem 8**. Etapas para ativar o ADB em um dispositivo Sony Xperia 10V com Xperia UI 4.0 usando o Android 14. +/// + + +### Techno (Hi OS) + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções de desenvolvedor nos dispositivos Tecno](../02-how-to-enable-developer-options/index.md#tecno-hi-os)**. + +Depois de habilitar as opções de desenvolvedor, siga estes **passos para habilitar o ADB**, mostrados na **imagem 9.**. + +1. abra o menu **Settings (Configurações) ⚙️** 2. +2. entre no menu **Sistema 📱** 3. +3. navegue até as **Opções do desenvolvedor 🤖** 4. +4. Habilite a terceira opção **USB Debugging 🖥️** +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + +![Etapas para ativar o ADB em um dispositivo Tecno Spark Go com Hi OS usando Android 13](../../../assets/03-how-to/activating-adb-tecno-spark-go-2023.gif "image 9"){: style="height:480x;width:216px"} +/// legenda +**Imagem 9**. Etapas para ativar o ADB em um dispositivo Tecno Spark Go com Hi OS usando o Android 13. +/// + +### Xiaomi (Hyper OS) + +Para ativar o **ADB**, você precisa ter acesso às opções do desenvolvedor. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Xiaomi](../02-how-to-enable-developer-options/index.md#xiaomi-hyper-os)**. + +Depois de habilitar as opções de desenvolvedor, siga estes **passos para habilitar o ADB**, mostrados na **imagem 10.**. + +1. abra o menu **Configurações ⚙️**. +2. navegue até a última opção **Additional Tools 📱** 3. +Navegue até a opção **Developer Options 🤖** 4. +4. Habilite a terceira opção **USB Debugging 🖥️** +5. **Confirme** que deseja ativar a depuração USB no menu pop-up ✅ + +Etapas para ativar o ADB em um dispositivo Xiaomi 13T](.../../../assets/03-how-to/activating-adb-xiaomi-13t.gif "image 10"){: style="height:480x;width:216px"} +/// legenda +**imagem 10**. Etapas para ativar o ADB em um dispositivo Xiaomi 13T. +/// + +As opções do desenvolvedor aparecerão como um novo submenu em **Opções avançadas** e permanecerão **habilitadas** até serem desativadas (no menu de opções do desenvolvedor). + +## Conclusão + +**ADB** significa *Android Debug Bridge* e é uma **ferramenta de linha de comando nativa do Android** que permite a interação direta com um dispositivo. Em contextos de análise forense, ela pode ser **útil para obter informações que facilitem a triagem**, sem a necessidade de usar ferramentas de terceiros. + +Devido à **diversidade de fabricantes** e versões do sistema operacional Android, apresentamos neste material uma lista de fabricantes e **instruções passo a passo para ativar o ADB**, **facilitando e promovendo a análise forense consensual** em benefício da sociedade civil. + +Se **você tem acesso a uma interface gráfica que não é mostrada na lista** e deseja incorporar a captura de tela correspondente a este recurso, escreva para nós via *issue* ou, se estiver familiarizado com markdown, envie uma solicitação de integração via *pull request*. + + +## Comentários + +Você tem **comentários ou sugestões** sobre este recurso? Você pode usar a função **comentário abaixo** para nos deixar suas ideias ou comentários. Certifique-se de seguir nosso [código de conduta](.../../community/code-of-conduct/). A função de comentário está vinculada diretamente ao nosso [código de conduta](.../.../community/code-of-conduct/).Acesse a seção [_Discussions_ do Github] (https://github.com/Socialtic/forensics/discussions), onde você também pode **participar das discussões diretamente**, se preferir. + + diff --git a/docs/pt/how-tos/04-how-to-extract-with-androidqf/index.md b/docs/pt/how-tos/04-how-to-extract-with-androidqf/index.md new file mode 100644 index 000000000..e6b6c79be --- /dev/null +++ b/docs/pt/how-tos/04-how-to-extract-with-androidqf/index.md @@ -0,0 +1,353 @@ +--- + +title: Adquisición y extracción de dispositivos Android mediante AndroidQF +summary: Adquisición y extracción de dispositivos Android mediante AndroidQF +keywords: android, adquisicion, extraccion, androidqf +authors: +tags: [androidqf, extraction, acquisition, adquisicion, extraccion] +last_updated: 2025-12-09 +some_url: +created: 2025-08-01 +comments: true +name: jose +translation-review-pending: true +--- + +# Guia: Como realizar uma aquisição e extração usando o AndroidQF? + +Este documento faz parte de um **repositório de documentação técnica** que visa estabelecer uma base de conhecimento comprovada, flexível e acessível para **promover a análise forense consensual em benefício da sociedade civil**. Para organizar o conteúdo, é usada a [estrutura de referência de documentação técnica Diataxis](../../references/00-glossary/index.md#ditaxis). + +Esse recurso se enquadra na categoria [Guide, how-to](../) e contém instruções para realizar uma extração forense com a ferramenta [AndroidQF](../../references/00-glossary/index.md#androidqf). + +## O que é o AndroidQF? + +O [AndroidQF] (https://github.com/mvt-project/androidqf) é uma ferramenta de software gratuita e de código aberto **focada na extração forense de dispositivos Android**. Atualmente é mantida pelo [Amnesty International Security Lab](https://securitylab.amnesty.org/es/). + +Seu foco é especificamente para jornalistas, ativistas, defensores dos direitos humanos e os **laboratórios técnicos que acompanham casos de vigilância digital e ameaças de spyware**. + +O AndroidQF funciona como um [wrapper] forense (https://developer.mozilla.org/en-US/docs/Glossary/Wrapper) no [ADB](.../../references/00-glossary/index.md#adb), automatizando comandos comuns por meio de módulos que **permitem extrações rápidas, seguras e locais de qualquer sistema operacional (Linux, Windows ou macOS)**, sem depender de serviços em nuvem ou instalações complexas. + +Sua utilidade em contextos da sociedade civil está em sua **[portabilidade](../../references/00-glossary/index.md#portable-tool), facilidade de uso e execução local. + +Este guia é complementado por outros materiais, como o [dicionário de arquivos gerados pelo AndroidQF](../../references/01-reference-androidqf-dictionary/), seus formatos e recomendações de uso ou o [explicador sobre análise forense baseada em registros para dispositivos Android](../../explainers/03-explainer-log-forensics-android/). + +## Pré-requisitos para realizar a extração forense + +Para poder realizar uma extração com o AndroidQF, é **necessário**: + +* O **dispositivo Android a ser analisado**: habilitar o **[modo de desenvolvedor](../../references/00-glossary/index.md#developer-mode)** e **[habilitar a depuração USB](../../references/00-glossary/index.md#adb)**. Se necessário, consulte nossos [guias sobre como ativar as opções do desenvolvedor](../02-how-to-enable-developer-options/) ou [guia sobre como ativar o ADB](../03-how-to-enable-adb/). +* Computador Windows, Linux ou Mac**: será usado para realizar a extração. Você precisa saber qual é o chip [chip incorporado do computador] (https://servernet.com.ar/como-saber-si-mi-procesador-es-amd-o-arm/) +* Tenha um **cabo de transferência de arquivos** para o telefone-computador. + +### Criptografia das extrações + +Esse procedimento permite a criptografia automática das extrações geradas pelo AndroidQF usando uma chave pública *AGE*. É recomendado quando a extração é feita remotamente, quando você precisa enviar ou compartilhar informações por meio de mídia virtual, quando há risco de exposição ou quando você segue alguma política de privacidade. + +Para isso, siga as etapas abaixo: + +* Se for você quem estiver descriptografando as informações, deverá criar uma chave pública e uma chave privada seguindo a [documentação oficial] (https://github.com/FiloSottile/age). +Se você for um cifrador em nome de uma organização ou de outro analista, peça à pessoa a chave pública [*AGE*](https://github.com/FiloSottile/age) **.** **. +* No mesmo diretório em que o binário do AndroidQF está localizado, crie um arquivo chamado: *key.txt*. +* Abra o *key.txt*, cole a chave pública completa em uma única linha e salve as alterações. + +Para descriptografar o *.zip*, tudo o que você precisa fazer é o seguinte: + +* Crie um arquivo *.txt* chamado **private.key** no diretório em que o binário andoridqf está localizado, abra-o e cole a chave privada que começa com: *AGE-SECRET-KEY-...*. + +* Execute o seguinte comando para descriptografar as informações: + +````shell +$ age --decrypt -i ~/path/to/privatekey.txt -o .zip .zip.age +``` + +!!! observe "Verificar o par de chaves". + + Certifique-se de que a chave privada seja o par de chaves públicas. + + +## Etapas para obter uma extração forense com o AndroidQF + +Abaixo estão as etapas detalhadas para realizar a extração forense: + +### :material-numeric-1-box: Faça o download do binário no AndroidQF + +* **Baixe** a versão mais recente do [binário](../../references/00-glossary/index.md#binary), e que **corresponda à arquitetura do computador** onde ele será executado. O download é feito a partir das versões do repositório: [https://github.com/mvt-project/androidqf/releases/](https://github.com/mvt-project/androidqf/releases/) + + !!! pergunta "Como identificar a arquitetura?" + + Se não tiver certeza de qual é a arquitetura do equipamento que está usando, consulte este [recurso para descobrir qual chip está incorporado no dispositivo] (https://servernet.com.ar/como-saber-si-mi-procesador-es-amd-o-arm/). + +* Crie uma nova pasta** para armazenar o download do dispositivo. Mova o binário recém-baixado para essa pasta. + +### :material-numeric-2-box: Atribua permissões de execução ao binário baixado (**Linux e macOS somente**) + +* Se estiver usando uma máquina **Linux ou macOS** para a extração, será necessário atribuir permissão de execução ao arquivo antes de poder executá-lo. Para fazer isso, **abra um terminal e navegue até a pasta onde o binário está localizado** e, em seguida, execute: + + + !!! Aviso "Complete o nome" + + Ao executar o comando, **certifique-se de completar o nome** *androidqf_* com o nome completo do binário baixado na etapa 1. O comando resultante será semelhante a: + + ``` + chmod +x ./androidqf_v1.7.1_linux_amd64 + ``` + + + **No linux:** + + ``` + chmod +x ./androidqf_ + ``` + + **No macOS:** + + ``` + chmod +x ./androidqf_ + ``` + + +### :material-numeric-3-box: Conectando o telefone + +* **Conecte** o dispositivo desbloqueado ao computador usando um cabo de dados USB. + + !!! falha "Nem todos os cabos USB são iguais". + + Alguns cabos USB não têm as conexões necessárias para transferir dados entre o dispositivo móvel e o computador. Certifique-se de usar um cabo que possa transferir dados. É [difícil distinguir à primeira vista] (https://support.konnected.io/how-to-tell-a-usb-charge-only-cable-from-a-usb-data-cable), mas geralmente os cabos de carregamento rápido ou aqueles incluídos nos dispositivos são cabos de dados. + +* Quando o telefone estiver conectado, uma nova mensagem será exibida. Selecione **permitir** quando o dispositivo Android **solicitar permissão para acessar dados no dispositivo**, conforme mostrado na imagem 1. + + !!! falha "Nenhuma mensagem aparece". + + Se você não receber nenhuma mensagem sobre permissões ao conectar o dispositivo ao computador, verifique o seguinte: + + * Certifique-se de que [a depuração USB esteja ativada](../03-how-to-enable-adb/). + * Verifique as **configurações USB** e certifique-se de que a opção _transferência de arquivos_ esteja ativada. + * Certifique-se de que o cabo USB seja um **cabo de dados**. + + Captura de tela do dispositivo móvel Samsung Android solicitando permissões de acesso a dados](.../../../../assets/04-how-to/01-capture-android-data-permissions.png "image 1") + /// legenda + **Imagem 1**. Captura de tela do dispositivo móvel Samsung Android solicitando permissão de acesso a dados. + /// + +* Verifique se o arquivo key.txt está na mesma pasta que o binário andoridqf se você quiser criptografar a extração. + + +### Material-numeric-4-box: execute o AndroidQF + +Neste ponto, é possível executar o androidQF seguindo estas instruções: + +=== "Linux e MacOS" + + Execute com o **seguinte comando**. **Certifique-se de preencher **androidqf_* com o nome completo do binário baixado. + + ``` + ./androidqf-linux-v? + ./androidqf-macos-v? + ``` + + ![Captura de tela do terminal Linux com binário em execução para inicialização da extração](../../../../../assets/04-how-to/02-capture-terminal-linux-running.png "image 2") + /// legenda + **Imagem 2**. Captura de tela do terminal Linux com binário em execução para inicialização da extração + /// + +=== "Windows" === "Windows" === "Windows" === "Windows" === "Windows" === "Windows" === "Windows + + * Vá para a pasta em que o binário baixado na etapa 1 foi salvo e **clique duas vezes no arquivo** Uma janela de proteção do Windows será exibida; clique em **"More information "**. + + Captura de tela da janela pop-up de proteção do Windows](../../../../assets/04-how-to/03-capture-terminal-windows-run.png "image 3") + /// legenda + **Imagem 3**. Captura de tela da janela pop-up de proteção do Windows. + /// + + * Selecione **"Executar mesmo assim "**. + + Captura de tela da janela pop-up de proteção do Windows com a seleção de executar mesmo assim...](../../../../../assets/04-how-to/04-capture-screenshot-protection-windows.png "image 4") + /// legenda + **Imagem 4**. Captura de tela do pop-up de proteção do Windows com a opção de executar de qualquer forma. + /// + + + +### :material-numeric-5-box: Confirmar e configurar a extração + +As próximas etapas serão aplicadas da **mesma forma** nos 3 sistemas operacionais considerados neste tutorial: **Linux, Windows e macOS**. + +**O AndroidQF identificará automaticamente o dispositivo quando ele permitir a depuração USB** e gerará uma pasta com um identificador exclusivo (UUID). A extração será armazenada nessa pasta. + + !!! pergunta O que é um UUID? + + É um número gerado aleatoriamente, expresso por 32 dígitos hexadecimais divididos em cinco grupos separados por hífens no formato 8-4-4-4-4-12 para um total de 36 caracteres (32 dígitos e 4 hífens), por exemplo, ```0caba18f-20a7-48d0-b9ba-724fdaa3ff85````. + +* Em seguida, o **AndroidQF solicitará o tipo de backup** a ser realizado pela ferramenta: + + ** **Only** **SMS**: Executa um backup limitado que inclui apenas mensagens SMS e MMS. + **Everything**: Executa um backup completo do dispositivo usando o adb backup. + ** **No** **Backup**: Ignora completamente a geração de backup; extrai apenas outros artefatos via ADB. + + + !!! aviso "Alternativa" + + No exemplo, usamos a opção **Only-SMS** para limitar a extração apenas a mensagens, reduzindo a exposição de dados pessoais desnecessários. Se o **contexto do caso for considerado de alto risco** ou envolver uma investigação mais sofisticada, é recomendável verificar a opção **Everything**, embora a opção **Only-SMS** na maioria dos casos ainda seja suficiente para pesquisar tentativas de phishing por SMS. + + + Captura de tela do terminal Linux com o menu de backup do AndroidQF e a opção Somente SMS selecionada](.../../../../assets/04-how-to/06-captura-linux-only-sms.png "image 7") + /// legenda + **Imagem 6**. Captura de tela do terminal Linux com o menu de backup do AndroidQF e a opção Somente SMS selecionada. + /// + +* Ao selecionar o tipo de backup, o telefone solicitará o uso de uma **senha de criptografia temporária** para criptografar o [backup gerado pelo ADB](.../../references/00-glossary/index.md#backup-generated-by-adb). Em nosso exemplo, usamos **a senha "sd "** para segurança digital em espanhol, conforme mostrado na imagem 7. + + !!! aviso "Alternativa" + + Essa senha permite criptografar o backup gerado ao executar o androidqf. Caso você gere **senhas aleatórias**, certifique-se de usar um **gerenciador com boas práticas de backup**. Caso contrário, e se não for um risco, defina uma senha simples e equivalente para todas as suas extrações. + + Captura de tela do dispositivo móvel Samsung Android solicitando senha temporária para backup do sd](.../../../../../assets/04-how-to/07-capture-android-password.png "image 7") + /// legenda + **Imagem 7**. Captura de tela do dispositivo móvel Samsung Android solicitando a senha de backup temporário "sd". + /// + +* Selecione: **"Backup my data" **. + + Captura de tela do dispositivo móvel Samsung Android com a opção "Backup my data" selecionada](../../../../../assets/04-how-to/08-capture-android-backup-data.png "image 8") + /// legenda + **Imagem 8**. Captura de tela do dispositivo móvel Samsung Android com a opção "Backup my data" selecionada. + /// + + !!! falha "Mensagens de erro esperadas". + + Ocasionalmente, erros sobre como encontrar os caminhos onde os pacotes estão localizados são encontrados com frequência, portanto, é comum ver algumas dessas marcas de erro; no entanto, **essas marcas de erro não afetam a extração de dados forenses no dispositivo. + + captura de tela do terminal Linux indicando a coleção de informações do pacote de aplicativos do AndroidQF](../../../../../assets/04-how-to/09-capture-linux-collection.png "image 9") + /// legenda + **Imagem 9**. Captura de tela do terminal Linux indicando a coleta de informações do pacote de aplicativos pelo AndroidQF. + /// + +* Quando o AndoridQF encontrar todos os pacotes instalados no dispositivo, ele perguntará que **tipo de cópias de aplicativos você deseja baixar; há três opções**: + + * **All**: Baixe o [APK](../../references/00-glossary/index.md#apk) de todos os aplicativos, inclusive os aplicativos do sistema. + ** **Only** **non-system** **packages**: Baixe apenas os APKs dos aplicativos instalados pelo usuário. + **Do** **not** **download** **any**: ignora completamente o download de APKs do dispositivo. + + + !!! aviso "Alternativa" + + Embora nossa recomendação seja selecionar "Only non-system packages" (Somente pacotes que não sejam do sistema), a seleção depende de sua abordagem de análise e investigação, portanto, em casos com suspeita de ataques sofisticados, a opção "All" (Todos) pode ser usada. + + + captura de tela do terminal Linux com o menu de cópia de pacotes do aplicativo AndroidQF e a opção Only non-system packages selecionada](../../../assets/04-how-to/10-capture-linux-copy-packages.png "image 10") + /// legenda + **Imagem 10**. Captura de tela do terminal Linux com o menu de cópia de pacotes de aplicativos do AndroidQF e a opção Only non-system packages selecionada. + /// + +* Quando a opção de baixar cópias de pacotes for selecionada, o **AndroidQF perguntará sobre a remoção da opção de cópias de pacotes.ar [APKs](../../references/00-glossary/index.md#apk)** assinados por desenvolvedores ou entidades confiáveis (como o Google ou o fabricante do dispositivo), a fim de reduzir o tamanho da pasta de extração. + + * Responda **"Yes "** para que, ao revisar as informações, você possa **focar a análise em pacotes potencialmente suspeitos** e economizar tempo e espaço de armazenamento. + + + !!! aviso "Alternativa" + + Embora nossa recomendação seja selecionar "Yes", a seleção depende de sua abordagem de análise e investigação, portanto, em casos com suspeita de ataques sofisticados, a opção "No" pode ser usada. + + + Captura de tela do terminal Linux com o menu de desvio do aplicativo de certificado confiável AndroidQF e a opção Sim selecionada](../../../assets/04-how-to/11-capture-linux-omission-applications.png "image 11") + /// legenda + **Imagem 11**. Captura de tela do terminal Linux com o menu padrão de aplicativos com o certificado confiável AndroidQF e a opção Yes selecionada. + /// + +**Aguarde** que todos os módulos do AndroidQF sejam executados de acordo com sua programação. + + !!! info "Process duration" (Duração do processo) + + **Esta etapa pode levar vários minutos**, dependendo do modelo do telefone e da quantidade de dados armazenados. O progresso é exibido linha por linha no terminal e não requer nenhuma outra intervenção, exceto no final, onde você deve pressionar Enter para concluir. + + ![Captura de tela do terminal Linux com o menu padrão do aplicativo AndroidQF trusted-certificate e a opção Yes selecionada](../../../assets/04-how-to/12-capture-screenshot-execute-correct.png "image 12") + /// legenda + **imagem 12**. Captura de tela do terminal Linux com informações da execução bem-sucedida da extração forense com o AndroidQF e solicitação para pressionar enter para concluir. + /// + + +### :material-numeric-6-box: Verificando a extração + +Depois que o AndroidQF terminar de ser executado, é importante **validar se a aquisição foi concluída corretamente**. Para fazer isso, execute as seguintes etapas: + +* Se você recebeu uma extração criptografada, é necessário descriptografar essas informações primeiro. Consulte a seção sobre [criptografia de extração] (#extraction-encryption). + + +* Abra o arquivo command.log com um editor de texto e **procure as palavras warning ou error**. Se elas aparecerem, verifique se correspondem a falhas críticas ou eventos não relevantes. + + +=== "Linux / MacOS" + + Você pode usar o seguinte comando dentro da pasta de aquisição: + + ``` + grep -i "AVISO\|ERRO" command.log + ``` + + ![Captura de tela do terminal Linux com o comando grep para procurar erros no arquivo command.log gerado pelo AndoridQF.](../../../assets/04-how-to/13-screenshot-linux-terminal-linux-errors.png "image 12") + /// legenda + **Imagem 13**. Captura de tela do terminal Linux com o comando grep para procurar erros no arquivo command.log gerado pelo AndoridQF. + /// + + +=== "Windows" === "Windows" === "Windows" === "Windows" === "Windows" === "Windows" === "Windows + + Abra o arquivo com o "*Notepad "*, selecione a combinação de teclas **ctrl+b** e digite ***WARNING*** ou ***ERROR*****.** + + Captura de tela do terminal Linux com o comando grep para procurar erros no arquivo command.log gerado pelo AndoridQF](../../../assets/04-how-to/14-screenshot-windows-errors.png "image 14") + /// legenda + **Imagem 14**. Captura de tela do Windows Notepad com a pesquisa de erros no arquivo command.log gerado pelo AndoridQF. + /// + +* Verifique a **existência do arquivo *acquisition.json*** e se seu conteúdo parece apropriado. + + Captura de tela do Sublime Text com a saída do arquivo acquisition.json gerado pelo AndoridQF](../../../../../assets/04-how-to/15-screenshot-acquisition.png "image 15") + /// legenda + **Imagem 15**. Captura de tela do Sublime Text com a saída do arquivo acquisition.json gerado pelo AndoridQF. + /// + +* Verifique a criação de arquivos e pastas de saída. **Certifique-se de que os seguintes arquivos e pastas tenham sido gerados:** **/// **Imagem 15**. + + ``` + ├── apks/ + ├─── logs/ + ├──── tmp/ + .json + ├─── backup.ab + Relatório de erros.zip + command.log + dumpsys.txt + ├──── env.txt + ├─── files.json + getprop.txt ├───── getprop.txt + ├─── hashes.csv + ├─── logcat.txt + ├─── packages.json + ├─── processes.txt + root_binaries.json ├─── raiz_binários.json + selinux.txt + ├─── services.txt + ├─── settings_global.txt + Configurações_seguras.txt + └└─── settings_system.txt + ``` + + Captura de tela dos arquivos de aplicativos no PopOS! mostrando a pasta de saída dos arquivos e diretórios gerados com a extração forense com o AndroidQF.](../../../assets/04-how-to/16-screenshot-files-output.png "image 15") + /// legenda + **imagem 16**. Captura de tela do aplicativomostrando a pasta de saída dos arquivos e diretórios gerados pela extração forense com o AndroidQF. + /// + +## Conclusão + +O AndroidQF permite que você adquira e extraia evidências forenses de dispositivos Android. É uma **ferramenta amplamente utilizada por laboratórios da sociedade civil**, devido à sua praticidade, simplicidade e portabilidade. Neste guia, detalhamos o passo a passo a ser seguido para realizar extrações usando Windows, MacOS ou Linux. + +A extração de possíveis evidências é uma das **[primeiras etapas de uma investigação forense](../../explainers/01-explainer-introduction-digital-forensics/index.md#what-are-the-stages-of-a-forensic-investigation)** e é fundamental para iniciar uma triagem. A partir dessas informações extraídas, é possível iniciar um estágio de análise, seja manualmente ([você pode consultar o dicionário de arquivos aqui](../../references/01-reference-androidqf-dictionary/) ou usando uma ferramenta como o [MVT](https://docs.mvt.re/en/latest/). + +Se quiser contribuir para o desenvolvimento, a tradução ou a disseminação desse recurso ou de outros recursos, **consulte nossa [seção da comunidade](../../community/)** para obter mais informações. + + +## Comentários + +Você tem **comentários ou sugestões** sobre este recurso? Você pode usar a função **comentário abaixo** para nos deixar suas ideias ou comentários. Certifique-se de seguir nosso [código de conduta](../../community/code-of-conduct/). A função de comentário está vinculada diretamente à seção [_Discussions_ do Github] (https://github.com/Socialtic/forensics/discussions), onde você também pode **participar diretamente das discussões**, se preferir. + + diff --git a/docs/pt/how-tos/05-how-to-extract-bugreport/index.md b/docs/pt/how-tos/05-how-to-extract-bugreport/index.md new file mode 100644 index 000000000..da0d529ef --- /dev/null +++ b/docs/pt/how-tos/05-how-to-extract-bugreport/index.md @@ -0,0 +1,337 @@ +--- + +title: ¿Cómo extraer un reporte de errores de un dispositivo Android? +summary: Cómo extraer un reporte de errores de un dispositivo Android +keywords: triage, android, bugreport, +lang: es +tags: [how-to, intro] +last_updated: 2025-08-18 +some_url: +created: 2025-08-18 +comments: true +author: + name: Daniel + url: https://socialtic.org/quienes-somos/ + description: SocialTIC + +translation-review-pending: true +--- + +# Guia: Como extrair um relatório de bug de um dispositivo Android? + +Este documento é **parte de um repositório de documentação técnica** que visa estabelecer uma base de conhecimento comprovada, flexível e acessível para **impulsionar a análise forense consensual em benefício da sociedade civil**. Para organizar o conteúdo, é usada a estrutura de referência de documentação técnica [Diataxis](../../references/00-glossary/index.md#diataxis). + +Esse recurso específico se enquadra na categoria de **guias de instruções** e mostra as etapas necessárias para **gerar um relatório de bug ou *bugreport****,* usando o **consolo de depuração do ADB** e por meio da **interface gráfica** de um dispositivo. Este é um material **introdutório**, complementar a outros recursos, como o explicador forense baseado em registro para dispositivos Android e o guia de habilitação do ADB; e **faz parte das etapas a serem seguidas para realizar a triagem inicial**. + +Agradecemos a **colaboração** do [Reporters Without Borders security lab] (https://rsf.org/en/digital-security-lab), que forneceu as imagens necessárias para a produção deste guia. + + +## O que é um relatório de bug ou *bugreport*? + +Como o nome sugere, um *relatório de bugs* é uma **compilação de registros e informações de diagnóstico** que permite a **identificação e correção de bugs** durante o desenvolvimento do aplicativo. Nativamente, o sistema operacional Android permite que os relatórios de bugs sejam gerados por meio da **interface gráfica e do console ADB**. + +No contexto da análise forense consensual, o *relatório de bugs* é um artefato forense útil para **rastrear dispositivos Android, inclusive por meio da ferramenta MVT**. Por exemplo, a equipe da Amnesty Tech usou uma técnica semelhante para a detecção do spyware NoviSpy. + + +## O que é necessário para extrair um *bugreport*? + +Abaixo estão os requisitos para extrair um relatório de bug por meio da GUI e do console ADB. + +=== "GUI" + + Para extrair um relatório de bug por meio da GUI, **só é necessário o dispositivo Android** a ser analisado. + + Para gerar o relatório de bug, é necessário **ativar o modo de desenvolvedor** no dispositivo Android a ser testado. Se necessário, consulte o guia sobre *Como ativar o modo de desenvolvedor em diferentes modelos de Android*. + +=== "Por meio do ADB" + + Para extrair um relatório de bug, é necessário usar o console ADB: + + * **O dispositivo Android a ser testado**: Habilite o [modo de desenvolvedor](../../references/00-glossary/index.md#developer-mode) e [habilite a depuração USB](../../references/00-glossary.md#adb). Se necessário, consulte nossos guias sobre como ativar as opções de desenvolvedor ou o guia sobre como ativar o ADB. + * Computador Windows, Linux ou Mac:** Será usado para realizar a extração. + * Tenha um telefone-computador com **cabo de transferência de arquivos**. + + +## Etapas para gerar um _bugreport_ por meio da interface gráfica + +Na maioria dos dispositivos Android, é possível gerar um relatório de bug sem fazer download de ferramentas adicionais, apenas navegando pelos menus do dispositivo. Esse será o **método de escolha** **quando um defensor for solicitado a compartilhar esse artefato forense**. + +!!! Dica "Gerar relatório de bug usando o ADB". + + Também é possível extrair um **relatório de bugs do console ADB**. Esse procedimento pode ser mais ágil e adequado para analistas que desejam extrair relatórios de bugs de vários dispositivos. + + [:octicons-arrow-right-24: Take me to the instructions](#passos-para-gerar-um-relatório-de-bugs-através-da-interface-gráfica) + +Devido à forma como o sistema operacional Android é desenvolvido e às camadas de personalização adicionadas por cada fabricante, as **instruções exatas para gerar um relatório de bug variam um pouco**. Abaixo estão as instruções para diferentes fabricantes e versões do sistema operacional Android. + +!!! pergunta "Por que as instruções mudam entre dispositivos diferentes?" + + O sistema operacional Android baseia seu núcleo no projeto de código aberto [*Android Open Source Project*](https://source.android.com/)*.* No entanto, [a maioria dos fabricantes usa uma versão proprietária do Google](https://www.makeuseof.com/tag/android-really-open-source-matter/), sobre a qual são adicionadas camadas de personalização adicionais, que, na maioria dos casos, também são proprietárias. + + [:octicons-arrow-right-24: Leia mais sobre isso aqui](../02-how-to-enable-developer-options/index.md#why-there-are-different-ways-to-enable-them) + + +### Honor Magic 5 Lite (Magic OS) + +Para gerar um relatório de bug, você precisa **ter acesso às opções de desenvolvedor**. Seesse menu ainda não foi ativado, você pode seguir estas **[etapas para ativar as opções de desenvolvedor em um dispositivo Honor](../02-how-to-enable-developer-options/index.md#honor-magic-os)**. + +Depois de ativar as opções de desenvolvedor, siga estas **gerar um relatório de bug**, mostradas na **imagem 1**. + +1. abra o menu **Configurações**. +2. navegue até a última opção **System**. +3. navegue até a opção **Developer Options**. +4. Selecione a opção para "**Gerar um relatório de bug**". +5. Escolha a opção "**Relatório completo "**. +6. Clique em "**Relatório "**. +7. Quando ele estiver **completo**, você verá uma notificação. Toque em **tocar para compartilhar**. +8. Uma **mensagem de alerta** sobre informações pessoais será exibida. Toque em **OK**. +9. Selecione seu mecanismo preferido e **compartilhe o relatório de bug**. + + +Etapas para gerar um relatório de bug em um dispositivo Honor Magic Lite executando o Magic OS 7.1 no Android 13](../../../../../assets/05-how-to/bug-report-honor-magic5-lite.gif "image 1"){: style="height:480x;width:216px"} +/// legenda +**Imagem 1**. Etapas para gerar um relatório de bug em um dispositivo Honor Magic Lite com Magic OS 7.1 no Android 13. +/// + + +### Motorola (Hello UI) + +Para gerar um relatório de bug, você precisa **ter acesso às opções do desenvolvedor**. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Motorola](../02-how-to-enable-developer-options/index.md#motorola-hello-ui)**. + +Depois de ativar as opções de desenvolvedor, siga estas **gerar um relatório de bug**, mostradas na **imagem 2**. + +1. abra o menu **Configurações**. +2. navegue até a última opção **System**. +3. navegue até a opção **Developer Options**. +4. Selecione a opção para "**Gerar um relatório de bug**". +5. Escolha a opção "**Relatório completo "**. +6. Clique em "**Relatório "**. +7. Quando ele estiver **completo**, você verá uma notificação. Toque em **tocar para compartilhar**. +8. Uma **mensagem de alerta** sobre informações pessoais será exibida. Toque em **OK**. +9. Selecione seu mecanismo preferido e **compartilhe o relatório de bug**. + +![Etapas para gerar um relatório de bug em um dispositivo Motorola Edge Neo 40 usando Hello UI no Android 13](../../../../../assets/05-how-to/bug-report-motorola-edge-40-neo.gif "image 4"){: style="height:480x;width:216px"} +/// legenda +**Imagem 2**. Etapas para gerar um relatório de bug em um dispositivo Motorola Edge Neo 40 usando o Hello UI no Android 13. +/// + +### Nokia + +Para gerar um relatório de bug, você precisa **ter acesso às opções de desenvolvedor**. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Nokia](../02-how-to-enable-developer-options/index.md#nokia)**. + +Depois de ativar as opções de desenvolvedor, siga estas **gerar um relatório de bug**, mostradas na **imagem 3**. + +1. abra o menu **SETTINGS**. +2. navegue até a última opção **System**. +3. navegue até a opção **Developer Options**. +4. Selecione a opção para "**Gerar um relatório de bug**". +5. Escolha a opção "**Relatório completo "**. +6. Clique em "**Relatório "**. +7. Quando ele estiver **completo**, você verá uma notificação. Toque em **tocar para compartilhar**. +8. Uma **mensagem de alerta** sobre informações pessoais será exibida. Toque em **OK**. +9. Selecione seu mecanismo preferido e **compartilhe o relatório de bug**. + + +![Etapas para gerar um relatório de bug em um dispositivo Nokia G42 5G usando o Android 13](.../../../assets/05-how-to/bug-report-nokia-g42.gif "image 4"){: style="height:480x;width:216px"} +/// legenda +**imagem 3**. Etapas para gerar um relatório de bug em um dispositivo Nokia G42 5G usando o Android 13. +/// + +### Oppo (Magic OS) + +Para gerar um relatório de bug, você precisa **ter acesso às opções de desenvolvedor**. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Oppo](../02-how-to-enable-developer-options/index.md#oppo-reno-10-color-os)**. + +Depois de ativar as opções de desenvolvedor, siga estas **gerar um relatório de bug**, mostradas na **imagem 4**. + +1. abra o menu **Configurações**. +2. navegue até a última opção **Additional Tools**. +3. navegue até a opção **Developer Options**. +4. Selecione a opção "**Error Reporting**" (Relatório de erros). +5. Escolha a opção "**Complete Report**" (Relatório completo). 6. +6. Clique em "**Report "**. +7. Quando ele estiver **completo**, você verá uma notificação. Toque em **tocar para compartilhar**. +8. Uma **mensagem de alerta** sobre informações pessoais será exibida. Toque em **OK**. +9. Selecione seu mecanismo preferido e **compartilhe o relatório de bug**. + + +Etapas para gerar um relatório de bug em um dispositivo OPPO Reno 10 usando o Android 13](../../../../assets/05-how-to/bug-report-oppo-reno10-5g.gif "image 5"){: style="height:480x;width:216px"} +/// legenda +**Imagem 4**. Etapas para gerar um relatório de bug em um dispositivo OPPO Reno 10 usando o Android 13 +/// + + +### Realme (Realme UI) + +Para gerar um relatório de bug, você precisa **ter acesso às opções de desenvolvedor**. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções de desenvolvedor em um dispositivo Realme](../02-how-to-enable-developer-options/index.md#realme-realme-ui)**. + +Depois de ativar as opções de desenvolvedor, siga estas **gerar um relatório de bug**, mostrado na **imagem 5**. + +1. abra o menu **Configurações**. +2. navegue até a última opção **Additional Tools**. +3. navegue até a opção **Developer Options**. +4. Selecione a opção para "**Gerar um relatório de bug**". +5. Escolha a opção "**Relatório completo "**. +6. Clique em "**Relatório "**. +7. Quando ele estiver **completo**, você verá uma notificação. Toque em **tocar para compartilhar**. +8. Uma **mensagem de alerta** sobre informações pessoais será exibida. Toque em **OK**. +9. Selecione seu mecanismo preferido e **compartilhe o relatório de bug**. + + +![Etapas para gerar um relatório de bug em um dispositivo Realme GT2 Pro com RealMe UI 4.0 usando o Android 13](../../../assets/05-how-to/bug-report-realme-gt2-pro.gif "image 6"){: style="height:480x;width:216px"} +/// legenda +**Imagem 5**. Etapas para gerar um relatório de bug em um dispositivo Realme GT2 Pro com RealMe UI 4.0 usando o Android 13 +/// + +### Samsung (One UI) + +Para gerar um relatório de bug, você precisa **ter acesso às opções de desenvolvedor**. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções de desenvolvedor em um dispositivo Samsung](../02-how-to-enable-developer-options/index.md#samsung-one-ui)**. + +Depois de ativar as opções do desenvolvedor, siga estas **gerar um relatório de bug**, mostradas na **imagem 6**. + +1. abra o menu **Configurações**. +2. navegue até a opção **Developer Options**. +3. selecione a opção para "**Gerar um relatório de bug**". +4. Escolha a opção "**Relatório completo "**. +5. Toque em "**Reportar "**. +6. Quando ele estiver **completo**, você verá uma notificação. Toque em **tocar para compartilhar**. +7. Uma **mensagem de alerta** sobre informações pessoais será exibida. Toque em **OK**. +8. Selecione seu mecanismo preferido e **compartilhe o relatório de bug**. + +![Etapas para gerar um relatório de bug em um dispositivo Samsung Galaxy A54 com One UI em um dispositivo com Android 13](../../../../../assets/05-how-to/bug-report-samsung-galaxy-a54-5g.gif "image 7"){: style="height:480x;width:216px"} +/// legenda +**Imagem 6**. Etapas para gerar um relatório de bug em um dispositivo Samsung Galaxy A54 com One UI em um dispositivo com Android 13 +/// + +### Sony (Xperia UI) + + +Para gerar um relatório de bug, você precisa **ter acesso às opções de desenvolvedor**. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções do desenvolvedor em dispositivos Sony](../02-how-to-enable-developer-options/index.md#sony-xperia-ui)**. + +Depois de ativar as opções de desenvolvedor, siga estas **gerar um relatório de bug**, mostradas na **imagem 7.**. + +1. abra o menu **Configurações**. +2. navegue até a última opção **Sistema** 3. +3. navegue até a opção **Developer options**. +4. Selecione a opção para "**Gerar um relatório de bug**". +5. Escolha a opção "**Relatório completo "**. +6. Clique em "**Relatório "**. +7. Quando ele estiver **completo**, você verá uma notificação. Toque em **tocar para compartilhar**. +8. Uma **mensagem de alerta** sobre informações pessoais será exibida. Toque em **OK**. +9. Selecione seu mecanismo preferido e **compartilhe o relatório de bug**. + +![Etapas para gerar um relatório de bug em um dispositivo Sony Xperia 10V com Xperia UI 4.0 usando o Android 14](../../../assets/05-how-to/bug-report-sony-xperia-10-v.gif "image 8"){: style="height:480x;width:216px"} +/// legenda +**Imagem 7**. Etapas para gerar um relatório de bug em um dispositivo Sony Xperia 10V com Xperia UI 4.0 usando o Android 14. +/// + + +### Techno (Hi OS) + +Para gerar um relatório de bug, você precisa **ter acesso às opções do desenvolvedor**. Se esse menu ainda não tiver sido ativado, você pode seguir estas **[etapas para ativar as opções de desenvolvedor nos dispositivos Tecno](../02-how-to-enable-developer-options/index.md#tecno-hi-os)**. . + +Depois de ativar as opções de desenvolvedor, siga estas **gerar um relatório de bug**, mostradas na **imagem 8.**. + +1. abra o menu **Configurações**. +2. navegue até a última opção **System** 3. +3. navegue até a opção **Developer options**. +4. Selecione a opção para "**Gerar um relatório de bug**". +5. Escolha a opção "**Relatório completo "**. +6. Clique em "**Reportartransporte "**. +7. Quando estiver **completo**, você verá uma notificação. Clique em **tocar para compartilhar**. +8. Uma **mensagem de alerta** sobre informações pessoais será exibida. Toque em **OK**. +9. Selecione seu mecanismo preferido e **compartilhe o relatório de bug**. + +![Etapas para gerar um relatório de bug em um dispositivo Tecno Spark Go com Hi OS usando Android 13](../../../assets/05-how-to/bug-report-tecno-spark-go-2023.gif "image 9"){: style="height:480x;width:216px"} +/// legenda +**Imagem 8**. Etapas para gerar um relatório de bug em um dispositivo Tecno Spark Go com Hi OS usando o Android 13. +/// + +### Xiaomi (Hyper OS) + +Para gerar um relatório de bug, você precisa **ter acesso às opções de desenvolvedor**. Se esse menu ainda não tiver sido ativado, você pode seguir estas **passo para ativar as opções de desenvolvedor em um dispositivo Xiaomi**. + +Depois de ativar as opções do desenvolvedor, siga estes **gerar um relatório de bug**, mostrados na **imagem 9. + +1. abra o menu **Configurações**. +2. navegue até a última opção **About Device** 3. +3. navegue até a opção **Device Details** (Detalhes do dispositivo). +4. Localize as **Informações da CPU e toque 5 vezes** 5. +5. Você verá um alerta de notificação sobre informações pessoais. Clique em **Concordo**. +6. Quando estiver **completo**, você verá uma notificação. **Toque nela para ir para a pasta de arquivos. +7. **Localize o relatório de bug recém-gerado** e clique para compartilhar. +8. Selecione o mecanismo preferido e **compartilhe o relatório de bug**. + +Etapas para gerar um relatório de bug em um dispositivo Xiaomi 13T](../../../assets/05-how-to/bug-report-xiaomi-13t.gif "image 10"){: style="height:480x;width:216px"} +/// legenda +**imagem 9**. Etapas para gerar um relatório de bug em um dispositivo Xiaomi 13T. +/// + + +## Etapas para gerar um *relatório de bug* por meio do console ADB + +Além do método para gerar um relatório de bug por meio da interface gráfica, é possível gerar um relatório de bug por meio do console ADB seguindo estas etapas. É importante lembrar que, antes de seguir essas instruções, você deve ativar a depuração USB. + +### Gerar o relatório de bug + +Se você tiver **apenas um dispositivo conectado**, poderá obter um relatório de erro com o adb, como segue: + +``` +$ adb bugreport +``` + + +Se **você não especificar um caminho** para o relatório de bug, ele será armazenado no **diretório local**. Se quiser incluir um caminho específico, você pode adicioná-lo como um parâmetro da seguinte forma: + +``` +$ adb bugreport E:\Reports MyBugReportsPath + +``` + +!!! aviso "Vários dispositivos" + + Se você tiver **múltiplos dispositivos conectados**, deverá **especificar o dispositivo com a opção. Execute o comando `adb devices` para obter o número de série do dispositivo e gerar o relatório de erro: + + ``` + $ adb devices + Lista de dispositivos conectados + Dispositivo emulator-5554 + Dispositivo 8XV7N15C31003476 + + $ adb -s 8XV7N15C31003476 bugreport + + ``` + +### Extrair relatório de bug + +Depois que o sinal é enviado ao dispositivo para gerar o relatório de erros, é possível **extraí-lo diretamente para o computador** de onde o ADB está sendo executado. + +Primeiro, devemos **identificar o relatório de erro a ser extraído**. Você pode usar o comando `adb shell ls /bugreports/` para visualizar os relatórios armazenados, que, por padrão, estarão na pasta `/bugreports/.`. + +``` +$ adb shell ls /bugreports/` para ver os relatórios armazenados na pasta `/bugreports/.``. +bugreport-foo-bar.xxx.YYYYY-MM-DD-HH-MM-SS-dumpstate_log-yyy.txt +bugreport-foo-bar.xxx.YYYYY-MM-DD-HH-MM-SS.zip +dumpstate-stats.txt +``` + +Depois que o relatório de bug a ser extraído for identificado, ele poderá ser **copiado para o computador** por meio do seguinte comando: + +``` +$ adb pull /bugreports/bugreport-foo-bar.xxx.YYYYYY-MM-DD-HH-MM-SS.zip +``` + +Depois que esse comando for executado, o arquivo será **copiado para o diretório de onde o ADB está sendo executado**. + +## Conclusão + +Um **relatório de bug** refere-se a um relatório de bug gerado pelo sistema operacional Android e inclui informações úteis, especialmente para depurar bugs durante o desenvolvimento de aplicativos. No entanto, **muitos dos registros e comportamentos incluídos no *relatório de bugs** são úteis para análise forense**. A extração do relatório de bugs é uma das primeiras etapas do ciclo de investigação e é uma maneira comum de iniciar o processo de triagem em dispositivos Android. + +Devido à **diversidade de fabricantes** e versões do sistema operacional Android, apresentamos neste material uma lista de fabricantes e **instruções passo a passo para gerar um relatório de bug**, para **facilitar e promover a análise forense consensual** em benefício da sociedade civil. Lembre-se de sempre discutir e obter consentimento informado antes de extrair informações forenses. + +Se você **tiver acesso a uma interface gráfica que não sejae mostrado na lista**, e você deseja incorporar a captura correspondente a esse recurso, pode escrever para nós por meio de um *issue* ou, se estiver familiarizado com markdown, pode enviar uma solicitação de integração por meio de uma *pull request*. + + +## Comentários + +Você tem **comentários ou sugestões** sobre este recurso? Você pode usar a função **comentário abaixo** para nos deixar suas ideias ou comentários. Certifique-se de seguir nosso [código de conduta] (../../community/code-of-conduct/). A função de comentário está vinculada diretamente à seção [_Discussions_ do Github] (https://github.com/Socialtic/forensics/discussions), onde você também pode **participar diretamente das discussões**, se preferir. +