c2siorg/openmf

An Open Source Mobile Forensics Investigation Tool for Android Platform

                                   

Project Overview

OpenMF is an open source forensic tool for Android smartphones that helps digital forensic investigators throughout the life cycle of digital forensic investigation.

For e.g. let us say we have a crime scene in which we have captured some suspects and we have their mobile phones. If we want to extract all the data from their phones and see which of them are actually involved in the crime scene then we require a software to perform this task and produce Meaningful evidence and Analysis report for every phone (Digital forensic case). The OpenMF project is a dedicated software to:

1. Extract the relevant data
2. Manage all the cases separately
3. Produce Analysis report

This open source project is an important tool for Digital forensic organization. At present OpenMF is only a commmand line tool but we are planing to make a complete web client with additional features like Admin, Management and Extractor. These roles will have different privileges to the tool and as a whole it will become a complete open source forensic tool for Android smartphones which then can be used by any Digital forensic investigation organization.

User Guide

Step:1 - Cloning the project.
Clone the master branch of OpenMF locally by running git clone https://github.com/scorelab/OpenMF.git or download the project by clicking here.

Step:2 - Installing the project dependencies
Install the required dependencies of the project by running pip3 install -r requirements.txt.

Step:3 - Extract data from rooted Android device
Connect a rooted Android device using a data cable to your system, make sure that you have enabled the USB debugging. Once connected, you can run python3 collector.py --option all --session_name CaseNo1 --tags tag1,tag2​ or python3 collector.py -o all -sn CaseNo1 --tag tag1,tag2. Please ​note that this script will extract the requested data in .db format in the project directory inside session name (CaseNo1 for the above command) folder.

Step:4 - Convert the data .db files to readable format like .tsv/.json
Run converter.py and pass three arguments, the first one contains path to .db file, the second argument contains desired path to store converted files and the last argument contains file type (either .json or .tsv) for e.g. python3 converter.py /home/user/Downloads/accounts.db /home/user/data/ json converts accounts.db files in .json format.

Step:5 - Setting up Backend and Frontend
Backend: flask-backend
Frontend: React-frontend

Developer Guide

Follow all the instructions given in the User Guide. Explore the project repository. The major files are collector.py, converter.py, and all the files which are present inside scripts folder. Also, explore the current issues, and pull requests.

Contact information

Please join the Gitter channel for further discussions.

openmf's Issues

Failed to start the web app (OpenMF - React-frontend)

Describe the bug
Can not start the react frontend in the frontend project

To Reproduce
Steps to reproduce the behavior:

1. install dependencies
2. runt the frontend server

Expected behavior
React application should start without any issue

Screenshots

Desktop (please complete the following information):

• OS: Ubuntu
• Browser: Chrome

Overriding peer dependencies in the React-frontend project

Describe the bug
When installing the dependencies, peer dependency are having conflicts over their versions.

To Reproduce
Steps to reproduce the behavior:

1. install dependencies by 'npm install'

Expected behavior
Dependencies should be installed without any issues on the dependency versions

Screenshots

Desktop (please complete the following information):

• OS: Ubuntu
• Browser: Chrome