https://github.com/kero99/mftmactime

MFT and USN parser that allows direct extraction in filesystem timeline format (mactime), dump all resident files in the MFT in their original folder structure and run yara rules over them all.
https://github.com/kero99/mftmactime

forensics-tools mft ntfs ntfs-ads ntfs-journal python

Last synced: about 1 month ago
JSON representation

MFT and USN parser that allows direct extraction in filesystem timeline format (mactime), dump all resident files in the MFT in their original folder structure and run yara rules over them all.

• Host: GitHub
• URL: https://github.com/kero99/mftmactime
• Owner: kero99
• Created: 2022-08-03T14:49:39.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-05-10T17:45:48.000Z (about 1 year ago)
• Last Synced: 2024-02-14T20:39:32.145Z (4 months ago)
• Topics: forensics-tools, mft, ntfs, ntfs-ads, ntfs-journal, python
• Language: Python
• Homepage:
• Size: 32.2 KB
• Stars: 9
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Lists

• awesome-forensics - MFTMactime - MFT and USN parser that allows direct extraction in filesystem timeline format (mactime), dump all resident files in the MFT in their original folder structure and run yara rules over them all. (Tools / Windows Artifacts)

README

        
# Description

This is an MFT and USN parser that allows direct extraction in filesystem timeline format (mactime), dump all resident files in the MFT in their original folder structure and run yara rules over them all.

It uses Omer BenAmram's (https://github.com/omerbenamram/mft) great MFT rust parsing libraries, which allows a great speed and efficiency in the process.

The integration with the USN Journal parser allows to have in the same timeline the combined MFT and USN data. 

You can use as input files either individual files derived from a triage or a forensic image in RAW format or a mixture of both modes. In case the input is RAW the artifacts will be dumped in a selected directory.

# Requirement

pip install mft argparse tqdm pytz pytsk3 yara-python

# Use

usage: mftmactime [-h] [-V] -f FILE -o OUTPUT [-m DRIVE] [-n] [-tz TIMEZONE] [-r RESIDENT] [-u USN] [-s OFFSET] [-d DUMP_PATH] [-y YARA_RULES] [-yc YARA_COMPILED]

                        

# Example

mftmactime.py -f /mnt/comp001/\\$MFT -o comp001_fstl.csv -n

![image](https://user-images.githubusercontent.com/143736/183637088-0089c8c4-ef23-46e1-bbd5-8321422108cb.png)

# Example with dump resident files

mftmactime -f MFT -o test.csv -n -r recovery_output

![Screenshot at 2022-09-07 11-29-48](https://user-images.githubusercontent.com/143736/188844076-9eefc9b7-9801-4c23-a0df-0ef794b92dc1.png)

# Example of inode entries with USN Journal and MFT mixed data

![image](https://user-images.githubusercontent.com/143736/191730418-ba1f5a8d-2ff0-4e88-aa30-236c5169e580.png)

# Example of dump and process from RAW Evidence

mftmactime -n -f ../evidence/Testing/test-img.dd -u ../evidence/Testing/test-img.dd -o ./filesystem_tln.csv -d dump -r resindents

![image](https://user-images.githubusercontent.com/143736/191998130-097e69ea-80dc-4684-80ba-d4dfbe861452.png)

# Example of run yara rules over resident files

![mftmactime-yara](https://user-images.githubusercontent.com/143736/218285321-effe1042-9695-4e88-abe9-de9d30fbaa7f.png)