Git Product home page Git Product logo

posh-triage's Introduction

POSH-Triage

Tools for DFIR

  • Get-ZimmermanTools.ps1 - automates download and extraction of Eric Zimmerman's tools
  • Start-ImageParsing.ps1 - automates the use of artifact parsing tool against mounted images and volume shadow copies

Get-ZimmermanTools.ps1

PowerShell script that automates the download and extraction of Eric Zimmerman's tools

Requirements

  • Windows PowerShell 5 or greater

Examples

  • The easiest method is to right click and select 'Run with PowerShell'. Tools will be saved to default location: C:\Forensic Program Files\Zimmerman

  • Example using -outDir parameter to specify path to save tools

.\Get-ZimmermanTools.ps1 -outDir C:\Utilities\Zimmerman

Version History

0.3

  • Updated base URL as file hosting provider had changed

0.2

  • Added RBCmd.exe

0.1

  • Initial release

Start-ImageParsing.ps1

PowerShell script that automates the use of artifact parsing tool against mounted images and volume shadow copies.

The following tools are run where applicable to the image being processed:

Eric Zimmerman Tools (https://ericzimmerman.github.io/)

  • JLECmd.exe
  • LEcmd.exe
  • PEcmd.exe
  • SBECmd.exe
  • AppCompatParser.exe
  • AmcacheParser.exe
  • RecentFileCacheParser.exe
  • WxTCmd.exe
  • MFTECmd.exe
  • Registry Explorer project file creation
  • VSCMount.exe

Obsidian Forensics - Hindsight (https://github.com/obsidianforensics/hindsight)

  • Hindsight.exe

NirSoft BrowsingHistoryView (https://www.nirsoft.net/utils/browsing_history_view.html)

  • BrowsingHistoryView.exe

Requirements

  • Eric Zimmerman tools should all be located in the same directory
  • Script should be run from an administrator prompt
  • Windows 10/PowerShell 5 or greater

The default location of tools can be set by modifying the lines below in Start-ImageParsing.ps1:

 [string]$toolPath = "C:\forensic program files\zimmerman", # Change to directory containing Zimmerman tools
 [string]$hindsightPath = "C:\forensic program files\Hindsight\hindsight.exe", # Change to location of Hindsight.exe
 [string]$nirsoftPath = "C:\forensic program files\Nirsoft", # Change to directory containing Nirsoft tools

Examples

Note that that intent of this example is to show that the path to the various tools can be specified using parameters. The recommendation is to update the script so these parameters aren't needed.

.\Start-ImageParsing.ps1 -imagePath D:\[root] -toolPath C:\Utilities\Zimmerman -hindsightPath c:\Utilities\Hindsight\Hindsight.exe -nirsoftPath c:\utilities\Nirsoft -outPath \\SERVER\Cases\2018-06-01_1520_Laptop1 

Example using:

  • -imagePath to specify the path to the mounted image
  • -toolPath to specify the path to directory containing Eric Zimmerman tools
  • -hindSightpath to specify path to Hindsight.exe
  • -nirsoftPath to specify path to Nirsoft utlities
  • -outPath to specify location to save processed files
.\Start-ImageParsing.ps1 -imagePath J: -outPath \\SERVER\Cases\2018-06-01_1520_Laptop1 -vsc

Example using:

  • -imagePath to specify the path to the mounted image
  • -outPath to specify location to save processed files
  • -vsc switch parameter to mount Volume Shadow Copies and parse each using tools in script
.\Start-ImageParsing.ps1 -imagePath "\\SIFTWORKSTATION\mnt\shadow_mount\VSS1" -outPath G:\Cases

Example using:

  • -imagePath to specify mounted Volume Shadow Copy on SIFT Workstation
  • -toolPath parameter is not specified and will therefore use the default location
  • -outPath to specify location to save processed files

To Do

  • Provide ability to combine exported files into timeline
  • Add functions for additional tools
  • Combine and dedupe VSC output files

Known Issues and Limtitations

  • Arsenal Image Mounter - Unable to parse $MFT. Hindsight displays locked file message on some Volume Shadow Copies.
  • FTK Imager - Unable to mount and parse Volume Shadow Copies. SBECmd.exe fails to process NTUSER.DAT files when hive is dirty. Hold SHIFT while script is executing to allow parsing of dirty hive
  • SIFT Workstation - Unable to mount/parse Volume Shadow copies and Shellbags

Version History

0.5

  • Added functions to mount and parse Volume Shadow Copies
  • Added functions for Hindsight.exe and BrowsingHistoryView.exe
  • Added logic to detect image mounting source and provide alert of limitations of mount type
  • Modified logging. Now includes Start-ImageParsing_Commands.log which includes command history and Start-ImageParsing_Detailed.log which includes all output streams
  • Revisions to some commands to fix bugs and better support multiple image mounting methods

0.4

  • Added function to create Registry Explorer project file containing SAM, SECURITY, SOFTWARE, SYSTEM hives and all NTUSER.DAT, USRClass.DAT hives on the image

0.3

  • Fixed AmcacheParser failure when hive was dirty and disk was mounted using FTK Imager

0.2

  • Added function to parse MFT using MTECmd.exe. Corrected issue with AMCacheParser. Refactored commands to support toolPath containing spaces

0.1

  • Initial release

posh-triage's People

Contributors

grayfold3d avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

posh-triage's Issues

Feature Request: Registry Explorer

Eventually it would be great to create a session file for Registry Explorer for all of the registry hives.
The session files are text based so shouldn't be too difficult to generate dynamically

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.