/ForensicMiner

A really good DFIR automation for collecting and analyzing evidence designed for cybersecurity professionals.

Primary LanguagePowerShellMIT LicenseMIT

ForensicMiner v1.4

"ForensicMiner, Redefine DFIR Automations"

Created & Maintained by: Eilay Yosfan

Banner

What is ForensicMiner ?

ForensicMiner, a PowerShell-based DFIR automation tool, revolutionizes the field of digital investigations. Designed for efficiency, it automates artifact and evidence collection from Windows machines. Compatibility with Flacon Crowdstrike RTR and Palo Alto Cortex XDR Live Terminal, along with its swift performance and user-friendly interface, makes ForensicMiner an indispensable asset for investigators navigating the complexities of forensic analysis. Streamlined and effective, this tool sets a new standard in the realm of digital forensics.

How To Install ?

How To Install

Know This Before Installation

  • Always install ForensicMiner on "C:" drive.
  • Always run ForensicMiner as administrator, if not, some things may not work properly.
  • Don't run the tool using Windows PowerShell (x86)! if you do, some things may not work properly.
  • Make sure your PowerShell Execution Policy is on Bypass, if not, scripts could not run on your system.

Installation Process - Text Guide

  1. In this GitHub repository, click on "<> Code," and then select "Download ZIP."
  2. Extract "ForensicMiner" folder from "ForensicMiner-main.zip".
  3. Move "ForensicMiner" folder to C:\ drive.
  4. That's it! ForensicMiner is now installed. Enjoy

Installation Process - Video Guide

Installation.Process.-.Video.Guide.mp4

How To Install On Falcon Crowdstrike ?

Installation Process On - Falcon Crowdstrike RTR - Video Guide

Installation.Process.On.-.Falcon.Crowdstrike.RTR.-.Video.Guide.mp4

How To Install On Palo Alto Cortex XDR ?

Installation Process On - Palo Alto Cortex XDR - Video Guide

Installation.Process.On.-.Palo.Alto.Cortex.XDR.-.Video.Guide.mp4

Quick Start Guide - How To Use ForensicMiner ?

https://github.com/YosfanEilay/ForensicMiner/assets/132997318/0f32bc7c-b4fe-4ac5-88cb-09ea701878bd After installing ForensicMiner on the machine using the execution of "FM-Extractor.ps1"
A new folder should be created on the "C:" drive, called "ForensicMiner".

Navigate to This folder using the following command:

PS C:\> cd ForensicMiner

And now you can execute ForensicMiner menu page to view all available features and options using this command:

PS C:\ForensicMiner> .\ForensicMiner.ps1 -O Menu

Show Menu - Video Guide

Show.Menu.-.Video.Guide.mp4

Running Feature Example - RunMRU

In this example you will see how ForensicMiner manage to collect all the Run.exe execution history
of all the users (Online or Offline) in the machine and log them under "C:\ForensicMiner\MyEvidence"

RunMRU.Example.mp4

Credits Section

Name Why is the credit ?
Ido Naor, Security Joes CEO For supporting this project
Warren Frame (RamblingCookieMonster) Using Warre's PSSQLite in ForensicMiner
Jan Moronia & Felipe Duarte Helping to manage time spent on this project
Nir Avron For letting me test on his machine