Skip to content
forked from gillespiej/ir2go

IR2Go - Incident Response Toolkit on a USB Drive

Notifications You must be signed in to change notification settings

birdman4512/ir2go

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Australian Cyber Security Centre (ACSC) - IR2Go

IR2Go is an Incident Response tool kit designed to help in the acquisition of forensic artifacts such as disk, memory and network. The tool can be installed onto any basic type USB drive that is over 64GB and includes primary and secondary tools, plus guides on how to perform the capture. The IR2Go tool is deployable from any computer with a internet connection and is easy to deploy.

Getting Started

  1. Install windows onto USB drive.
  2. Run script
  3. Coffee
  4. Respond to incident.

Prerequisites

  • USB Drive (64GB or larger)
  • S3 Bucket name
  • S3 Access key and Secret Key
  • Windows 10 install.wim
  • Internet access

See the items below for further details

Hardware

The tool is designed to run on any BASIC type USB drive that is 64GB or larger. - See Compatible USB drives for drives. (Larger will result in more room for the Tools Partition) The drive should be USB3. Support for additional USB drives is always trying to be achieved

Compatible USB Drives

IR2Go has been working on the following USB drives.

  • SANDISK - Extreme USB 3.0 (64GB) - SDCZ80-064G
  • Kingston DataTraveler Workspace (64GB) - DTWS/64GBBK
  • Seagate Expansion (2TB) - STEA2000400

Download Tools

The tools are a vital part of the IR2Go environment. The tools listed below are an example of the tools you can use. This list is not an endorsement and you should assess each tool against your requirements.

Acquisition Files

Other Utilities

Each tool should run without needing to be installed and will need to be zipped ready for deployment.
There is one tool per zip file and the structure of the zip file should reflect. (An example is provided aswell)

Root of ZIP/ 
├── Tool Name (FTK Imager Lite X.X.X)
│   ├── Tool files (FTK Imager.exe)
│   ├── Tool files (adefs.dll)
etc. etc.

AWS S3 Setup

The following components of AWS need to be configured as for each item below

  • S3 Bucket

Setup a S3 Bucket with the following directory strucutre:

IR2Go /
├── Acquisition
│   ├── Windows
│   │   ├── _ZIP Files as prepared in the section above_
├── General
│   ├── _General Files such as background images, PDF Viewer_
├── Menu
│   ├── _Menu Application (PStart)_

  • S3 IAM Account

A user account created with only Read Only access to the S3 bucket created above, and Key access.

WIM Prep

The install.wim file can be mounted and both the shortcut file and unattended install file can be pre-loaded into the correct locations. This allows users to skip step 5 below.

For information on managing WIM files see https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/mount-and-modify-a-windows-image-using-dism

Installing

The following steps need to be completed on a windows machine

  1. A install.wim file needs to be obtained from the installation media of a Windows 10 Environment. A Windows 10 installation disk can be created using the Windows 10 Media Creation Tool. (You may need to extract the WIM from a ESD File)

  2. Partition the USB Drive -(In the example below, Disk 1 is the USB drive)_

#Start Diskpart
diskpart

#List disks
LIST DISK

#Select the correct disk
SELECT DISK 1

#CLEAN the drive - ***WARNING!!! All data will be lost in this process***
CLEAN

#Create a boot partition, format it etc
CREATE PARTITION PRIMARY SIZE=350
FORMAT FS=FAT32 QUICK
ACTIVE
ASSIGN LETTER=Y

#Repeat to create the primary partition
SELECT DISK 1
CREATE PARTITION PRIMARY
FORMAT FS=NTFS QUICK
ASSIGN LETTER=X
  1. Apply the WIM file to the newly created partition
#Using DISM from the same directory as the install.wim file
DISM /apply-image /imagefile:install.wim /index:1 /ApplyDir:X:\
  1. Set the device as bootable
BCDBOOT.EXE X:\Windows /S Y: /F ALL

#If the command above fails, try 
BCDBOOT.EXE X:\Windows /S Y:
  1. Install the required files to the USB Drive. (This step can be skipped if the files are added to the WIM file)
#Copy the shortcut to the all users desktop
https://github.com/certau/ir2go/blob/master/WIM-Files/Start%20Setup%20of%20IR2Go.lnk --> X:\Users\Public\Desktop\Start Setup of IR2Go.lnk

#Copy the unattended XML file to the Windows Directory (The Panther directory needs to be created.)
https://github.com/certau/ir2go/blob/master/WIM-Files/unattend.xml --> X:\Windows\Panther\unattend.xml
  1. Boot to the USB device. This may take a few restarts as drivers and Windows is setup.

  2. Connect to Wi-Fi during the setup wizard.

  3. Run the 'Start Setup of IR2Go' icon on the desktop as an administrator (Right Click --> Run As Administrator) When prompted, enter your AWS S3 bucket details

Alternative Installation

The script can be run on any Windows 10 machine using the following command

powershell -exec bypass -c "(New-Object Net.WebClient).Proxy.Credentials=[Net.CredentialCache]::DefaultNetworkCredentials;iwr('https://raw.githubusercontent.com/certau/ir2go/master/Setup-IR2Go.ps1')|iex"

Authors

  • Dean B - Initial work - CERT Australia / Australian Cyber Security Centre (ACSC)

Known issues

Feedback is always welcome, however the following issues may occur.

  • The script may fail due to being unable to resize the windows partition. The script needs to be able to resize the primary windows partition to 20GB. if it can not do this, the script will continue to run, but will fail.

About

IR2Go - Incident Response Toolkit on a USB Drive

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PowerShell 100.0%