django-webadb

Overview

A web application (Django 5) designed for wired/wireless (remote) acquisition of data from Android devices, based on WebADB, which I recently used, but with slightly more powerful features.

This project is essentially my final thesis from college, called RAAS (Remote Acquisition Android Smartphone), but I am now working to improve it to make it more useful and to contribute more to the DFIR community.

Getting Started

To begin using this app, follow these steps to set up your development environment:

Note:

• I don't provide feature to root the device, so you need to root the device if you want to use the physical acquisition (but some basic task doesn't need root)
• Maybe some phone will not work with other features, because need some adjustment for the device
• I can say this forensically sound tool and still in the development stage for stable use

Prerequisites

Also documented here with how to use. Or you can follow the instructions below to ensure the dependencies are installed on your system:

• Python 3.10+
• SDK Platform Tools (Add to your PATH)
• pip (Python package installer)
• node.js (Install node.js first if you don't have it in your machine, min version 18.0 for this package)
• yarn (Install yarn first if you don't have it in your machine) for installing the frontend dependencies
• Redis server (You can install it on the same server)
• Virtualenv (Optional but recommended for creating isolated Python environments)
• ewf-tools (Tools for working with EWF files), you can install it with sudo apt install ewf-tools
• netcat-openbsd (For seamless device communication over the network), you can install it with sudo apt install netcat-openbsd

For The Device

• You need to enable USB Debugging on your device and connect it to your computer via USB/IP Address
• And then you can check if the device is connected by running adb devices on your terminal

Step-by-Step Setup Guide

1. Clone the Repository or Extract the Source Code:

   git clone [repository_url]    # or extract the folder
   cd django-webadb\

2. Install yarn packages for the frontend:

   cd apps\    # Go to the apps directory
   yarn install

3. Create and Activate a Virtual Environment:

   cd ..   # Go back to the root directory
   python3 -m venv venv
   source venv/bin/activate   # On Windows use `venv\Scripts\activate`

4. Install Dependencies:

   pip install -r requirements.txt

5. Install Django and Set Up the Database:

   python manage.py migrate

6. Create a Superuser (Optional):

   python manage.py createsuperuser

7. Collect Static Files:

   python manage.py collectstatic

8. Run the Server:

   daphne core.asgi:application

9. Run the Worker (New Terminal):

   cd django-webadb\
   source venv/bin/activate   # On Windows use `venv\Scripts\activate`
   celery -A core worker --concurrency=3 -l info

   For the worker, you can adjust the concurrency parameter to your needs. This means that the worker will process 3 tasks concurrently. You can increase or decrease this number based on your system's capabilities.

10. Access the Application: Open your web browser and navigate to http://127.0.0.1:8000/ to access the RAAS application. Use the superuser account to access the admin interface at http://127.0.0.1:8000/admin/.

Future Enhancements

I understand that this application is still less than perfect and that there are many aspects that need improvement. I will continue to work on developing it as effectively and efficiently as possible.

Stay tuned for more features that will be released next year. These features will enhance the capabilities of RAAS, providing more powerful tools for data acquisition and analysis.

Todo List

• Physical Acquisition (USB & Wireless)
• Logical Acquisition
• Full File System Acquisition
• Selective Full File System Acquisition [BETA] (USB & Wireless)
• Reporting System
• Improvement for Log Management (70%)
• Improvement for Case Management and Evidence Management
• Enhancement for Security (Endless)

License

This project use Stisla (Dashboard Template), and Stisla is under the MIT License.