2. Collecting Data From A Remote Host

The first step to investigating the remote host is to collect data from it. This section outlines how to collect data and add it to Cyber Triage® for analysis.

2.1. Incidents and Hosts

Cyber Triage® uses the following data management terminology:

  • An Incident represents an investigation and can contain data from one or more hosts.

  • A Host represents a computer that is being investigated. There are a variety of ways to get data from hosts into the application.

The basic workflow for adding a host is:

  1. Create a new incident or open an existing one.

  2. Choose the collection method to get data into Cyber Triage®. Details are given below.

  3. Choose the kinds of data you want to collect.

  4. Choose your malware scanner settings.

2.2. Creating an Incident

Every host needs to be part of an incident. An incident will have its own good and bad lists and its own database. You can create an incident from the opening Cyber Triage® screen:

../../_images/2_1.jpg

Cyber Triage® screen

  1. Press New Incident and add:

    • Incident Name: Must be unique and not have special characters

    • Description: Optional

../../_images/2_2.jpg

New Incident Form

  1. That will then bring you to the Incident Dashboard:

../../_images/2_3.jpg

Incident Dashboard

From here, you can add data from hosts and open existing hosts.

2.3. Adding Host Data

To add data from a host, press Add New Host and you’ll be presented with this screen, which gives you six options:

../../_images/2_4.jpg

Adding New Host

The collection methods to get data into Cyber Triage® are:

  1. Live Automatic: Cyber Triage® will push the collection tool to a remote host over the network using PsExec. Collected data is sent directly back to Cyber Triage®. See Live Automatic for details. This is not available in the Lite version.

  2. Live File: The collection tool is manually run from a network or USB drive on the remote host. Data is saved to the USB drive, network share, or S3 bucket and then manually imported into Cyber Triage®. This is useful when the host has been unplugged from the network or for consultants who have clients perform the acquisition. See Live File for details.

  3. Live Manual: The collection tool is manually run from a network or USB drive on the remote host (like Live File), but the data is sent over the network instead of being saved to the USB drive. See Live Manual for details.

  4. Disk Image: The collection tool is run on a disk image that was previously acquired in either raw or E01 format. See Disk Image for details.

  5. Memory Image: Volatility v2 is run on a memory image that was previously acquired (using your own tools - Cyber Triage® does not do memory acquisition). See Memory Image for details.

  6. KAPE Import: The collection tool is run on the VHD or logical file outputs of the third-party KAPE collection tool. See KAPE Outputs for more information.

  7. Logical Files Import: The collection tool is run on a set of local files and folders. Hives and event logs are parsed if they are in the correct relative path. See Logical Files for more information.

The following sections provide more details of each method.

2.3.1. Queueing Up Data

If you have a Standard Pro or Team version of Cyber Triage, then you can add more than one host at a time. You can do this in two ways:

  1. Some of the UIs will allow you to add multiple files or hosts in a single step. Those files or hosts will get added to the scheduler.

  2. While a host is being analyzed, you can add others. If there is capacity, it will automatically add that host. If there is not, then it will add it to the scheduler.

At any point, you can see the status of the queue by looking at the “All Hosts” dialog from the opening window. Or, from the Incident Dashboard.

../../_images/2_26.jpg

All Hosts Panel - Queued Data

2.3.2. Live Automatic

With Live Automatic, Cyber Triage® will push the collection tool to a live system and it will send its results back to Cyber Triage® over the network. This feature is not available in the Lite version. To do this, the following configuration must exist on the remote system:

  • Running Windows XP or later

  • File and network sharing enabled

  • Domain account with administrator privileges

2.3.2.1. Adding a Single Live Host

To perform the collection on a single host, select the Live Automatic icon. You will be presented with a panel to enter:

  • Hostname of computer to collect from

  • User name, domain, and password for an account on the remote system that has administrator privileges

If you did not configure PsExec as described in Configuring PsExec for Remote Collection, then you will be prompted to do so.

../../_images/2_5.jpg

Live Collection - Automatic

After pressing Continue, you will be prompted to choose what data types to collect and what malware scanner settings to use. Refer to Collection Settings for details on those panels.

If this is your first time running the program, you may also be prompted by Windows or a security program to allow Cyber Triage® to open a network port. You will need to allow this to happen so that the collection tool can send data to Cyber Triage® on TCP port 443.

See Configuring Remote Systems for Collection if the administrator account on the remote system is a local account and you are having problems.

After the collection has started, you will be able to see the results. Proceed to Analyzing The Host Data for an overview of the analysis techniques.

2.3.2.2. Adding Multiple Live Hosts

If you have a Team deployment of Cyber Triage®, you can submit multiple host names to collect from. This allows you to enter a set of hosts, have basic data collected from them, and then you can prioritize what you review. To do this, use the Add Multiple button when entering host details.

../../_images/2_6.jpg

Live Collection - Automatic

You can then enter a list of host names.

../../_images/2_7.jpg

Add Multiple Host Names

Cyber Triage® will then validate the credentials with those host names and then queue them up. You can see progress from either the Incident Dashboard (which is where Cyber Triage® will redirect you to) or by choosing the All Hosts button from the main panel.

../../_images/2_8.jpg

All Hosts

2.3.3. Live File

This approach saves the collected data from the live host to a file (typically on a USB drive). That file is then manually imported into Cyber Triage®. The first thing you’ll need to do is get access to the Cyber Triage® Collection Tool. Follow the instructions in Extracting the Collection Tool for Live Collections to do this.

2.3.3.1. Collecting From Live System

To perform a collection, the following are performed on the remote computer:

  1. Insert the USB device into the target computer or make the collection tool available on a network share.

  2. Decide if you want to use the graphical interface or command line interface. The graphical interface will ultimately call the command line interface tool with arguments based on your UI selections.

  3. To use the graphical interface:
    1. Double click on the CyberTriageGUI.exe program.

    2. Confirm that the data is going to the correct location (path, S3 bucket, etc.)

    3. Add an optional password if you want to encrypt the output. NOTE there is no recovery mechanism if you forget it.

    4. Choose the data types you want to collect. See Data Collection Types for details.

    5. Choose Start.

  4. To use the command line interface:
    1. Open a window that shows the CyberTriageCLI.exe executable. Right-click the CyberTriageCLI.exe file and select Run as Administrator. This will start collection of the host.

    2. Alternatively, you can launch a command prompt with admin privileges and run the CyberTriageCLI.exe program with no arguments.
      If you want to customize what data types are collected, then there are arguments you can give. Run with —help to get the list.

  5. When the collection tool has finished its collection, there will be a directory called CyberTriage_<timestamp> on the USB device, network share, or S3 bucket.

The next step is to import the collected data into Cyber Triage®. If you have Standard Pro or Team, then you can add multiple files at the same time.

Warning

It is important to have AutoRun disabled on the computer running Cyber Triage® so that it does not get infected by malware that spreads by USB devices.

2.3.3.2. Adding a Single Host File

Use the following steps if you have a single file to add.

  1. From the Incident Dashboard, choose Add New Host and then choose the Live File box.

  2. Enter a host name for the remote host.

  3. In the file selector, navigate to the folder that was created for the collection on the USB drive or downloaded S3 bucket.
    Choose the JSON file in that folder. This will import the data into Cyber Triage®.

../../_images/2_9.jpg

Live Collection - File

  1. You will then be prompted to configure malware scanning settings, see File Reputation / Malware Scanning Settings.

After collection has started, proceed to Analyzing The Host Data for an overview of the analysis techniques.

2.3.3.3. Adding Multiple Host Files

You can add multiple files in one step if you have Team or Standard Pro. The multiple files must be either:

  • In the same folder. This is the default behavior of the Collection Tool, which will save files into a single ‘CyberTriageOutput’ folder.

  • In a subfolder of the same folder. This is the behavior of previous versions of the Collection Tool.

As an example of the subfolders, you could have two JSONs at the following paths:

  • C:incident1host1file.JSON.gz

  • C:incident1host2file.JSON.gz

You can point Cyber Triage at the ‘C:incident1’ folder and it will go down into the ‘host1’ and ‘host2’ folders to find JSON files in there.

To specify a folder of files to add, use the following steps:

  1. From the Incident Dashboard, choose Add New Host and then choose the Live File box.

  2. Enter a host name for the remote host.

  3. Select Browse next to Multiple Files and select the folder that contains your JSONs.

Once you select the folder, the number of files found will be listed under the source folder path, like so:

../../_images/2_24.jpg
  1. Press Continue on bottom right and the files will begin to process.

  2. You will then be prompted to configure malware scanning settings, see File Reputation / Malware Scanning Settings.

  3. Return to the Incident Summary Panel to show the status and open the ones that have been processed.

../../_images/2_25.jpg

Note that there are two steps to this scheduling process. The first is for each file to get added to the “ingest scheduler” and then it needs to be fully processed.

2.3.4. Importing from S3

Some users use S3 buckets as a way to get data from remote sites. To do this:

  • Extract the Collection Tool with S3 configured (see Extracting the Collection Tool for Live Collections).

  • On the target system, launch CyberTriageGUI.exe and choose S3 Cloud Bucket as the destination (it should be the default if you configured the S3 destination)

  • Pick an optional encryption password.

After the collection has locally saved the data, it will then perform an upload to S3.

To get data into Cyber Triage® from S3, you need to manually download it to a local file and then add it using Live File using the above sections.

2.3.5. Live Manual

Live Manual is for cases when you cannot automatically push the collection tool to the remote system. In this approach, you run the collection tool from the remote system and it sends the results over the network to Cyber Triage®.

As with Live Automated, the collection tool will need to be able to communicate with the Cyber Triage® system over TCP port 443.

If you haven’t already done so, extract the collection tool to a USB drive using the steps outlined in Extracting the Collection Tool for Live Collections.

To perform the collection, you will need to interact with both Cyber Triage® and the remote system.

2.3.5.1. Prepare Cyber Triage For the Data

In Cyber Triage®:

  1. Choose the Live Manul box from the Add New Host area.

  2. You will be prompted to enter information about the host being collected from:

../../_images/2_10.jpg

Live Collection - Manual

  1. If this is the first time that you are running Cyber Triage®, you maybe prompted by Windows Firewall or another security application to allow Cyber Triage® to accept connections. You will need to do this to allow data to be imported into Cyber Triage®.

  2. Cyber Triage® will tell you what settings to use on the remote system.

../../_images/2_11.jpg

Live Collection - Manual

  1. You will then be prompted to configure malware scanning settings, see File Reputation / Malware Scanning Settings.

At this point, Cyber Triage is waiting for an incoming connection.

2.3.5.2. Start Collection on Remote Host

Next, perform the following on the remote system.

  1. Insert the USB device with the collection tool, or ensure that the collection tool is available via a network share. See Extracting the Collection Tool for Live Collections for details.

  2. Decide you are going to use the graphical interface or command line interface.

  3. To use the graphical interface:
    1. Open the USB drive in file explorer.

    2. Double click on the CyberTriageGUI.exe program.

    3. Choose Remote Server as the Destination and enter the hostname of the computer running Cyber Triage®.

    4. Press Start after configuring the other collection options

    ../../_images/2_12.jpg

    Collection Tool

  4. To use the command line interface:
    1. Open a command prompt with Administrator privileges and change directory to the collection tool folder.

    2. Type the command that was given by Cyber Triage®. Something like:
      CyberTriageCLI.exe --server host1
      
    3. You should see the collection tool start to produce output:
      ../../_images/2_13.jpg

      Command Output

After collection has started, proceed to Analyzing The Host Data for an overview of the analysis techniques.

2.3.6. Disk Image

Disk image-based analysis is useful if a full disk image has already been performed of the system. To collect data from a disk image:

  1. Choose the Disk Image button from the Add New Host area.

  2. Browse to your raw or E01 file.

  3. Choose a name for the host.

  4. You will need to configure what data to collect and malware settings. Refer to add-settings.

After collection has started, proceed to Analyzing The Host Data for an overview of the analysis techniques.

If you are using the Team version of Cyber Triage, then note that the client will do the parsing of the disk image and send the results to the server. The client must continue to run until the disk image has been parsed.

2.3.7. Memory Image

Memory image-based analysis allows you to review volatile data from a system and bypass advanced rootkits and malware. Cyber Triage® uses the open source Volatility 2 program to parse the memory images. You need to acquire the memory with your own software. Cyber Triage® will not make an image of memory.

To import a memory image:

  1. Choose the Memory Image button from the Add New Host area.

  2. Browse to your memory image file

  3. Choose the Volatility profile, if you know it. Cyber Triage® will use Volatility’s auto detection features, but sometimes they are not correct and manually picking will provide better results.

  4. Choose a name for the host.

  5. You will need to configure what data to collect and malware settings. Refer to add-settings.

After collection has started, proceed to Analyzing The Host Data for an overview of the analysis techniques.

If you are using the Team version of Cyber Triage, then note that the client will do the parsing of the memory image and send the results to the server. The client must continue to run until the memory image has been parsed.

Note

A session created from a memory image will not have all of the data and fields that you’d see from the Cyber Triage® Collection Tool. The interface will identify places that have incomplete data.

2.3.8. KAPE Outputs

KAPE is an external collection tool, the output of which can be imported into Cyber Triage®. If you use KAPE to collect data from a computer, but want to take advantage of the analytics in Cyber Triage, then you can import the KAPE VHD or ZIP file.

Note

Currently Cyber Triage imports only the KAPE .vhd and ZIP file contents. It ignores any other KAPE outputs (such as those from SysInternals).

To import a KAPE .vhd:

  1. Choose the KAPE button on the right-hand side of the Add New Host area.

../../_images/2_18.jpg
  1. Browse to your .vhd file

../../_images/2_19.jpg
  1. Give your host a name and press Continue.

../../_images/2_20.jpg
  1. You will need to configure what data to collect and malware settings. Refer to add-settings.

If you are using the Team version of Cyber Triage, then note that the client will do the parsing of the VHD image and send the results to the server. The client must continue to run until the VHD image has been parsed.

After collection has started, proceed to Analyzing The Host Data for an overview of the analysis techniques.

To import a KAPE .ZIP, you must first expand the ZIP file an then point Cyber Triage to the root of that folder.

2.3.9. Logical Files

If you have a folder of files, you can import them by using the Logical Files feature. If registry hives and event logs are at the correct relative offset, then they will be parsed. For example: * The SAM registry hive could be locally stored at c:casescase1host1windowssystem32configSAM. * You should import the c:casescase1host1 folder so that the SAM file is at its usual relative offset.

All files in the imported folder will be added to the Incident.

To import logical files:

  1. Choose the Logical Files button from the Add New Host screen.

  2. Enter the hostname.

  3. Browse to the logical file directory, press Select.

  4. Press Continue to select your parsing options and continue to the Cyber Triage® dashboard.

../../_images/collect_data_section-Add-logical-files-screen.jpg

The software will warn you if it cannot find a Windows folder, which may indicate that the incorrect folder was specified.

2.4. Extracting the Collection Tool for Live Collections

If you are going to use either Live Manual or Live File methods to create a session, you will need to first extract the collection tools from the Cyber Triage® UI.

To extract, choose the Collection Tools feature from the opening Cyber Triage® window.
Choose a folder and it will make a CyberTriageCollectionTool folder with the command line and graphic interface programs.
This folder will typically go on either a USB drive, a network share, or emailed to someone.

../../_images/2_14.jpg

Extract Collection Tool

2.4.1. Configuring S3 Bucket Uploads

If the collection tool is going to automatically upload data to an S3 bucket (on AWS or some other provider), then you will need to configure those settings before you extract it.

The settings will be saved to a configuration file. The intended use case is that the Cyber Triage® user will configure the S3 details and pass off the extracted folder to an end user.

You will need to pick:

  • Provider: Amazon AWS or another S3-equivalent

  • Region: If using AWS, you’ll need to pick the region your bucket is in.

  • Service URL: If using a non-AWS provider, you’ll need to specify the Service URL. It should have the region in the URL. + For example: S3.us-east-2.wasabisys.com

  • Bucket: The name of the bucket to save the results to. The bucket will be created if it does not already exist. There are limits on bucket names, so please be mindful of them. For example, no spaces or capital letters.

  • Access Key ID and Key: You will need to get an access key from the provider. These will be saved unencrypted in the configuration file.

  • Session Token: An optional field if you are using temporary credentials. You can generate this via the AWS Command Line Tool:

../../_images/2_15.jpg

S3 Configuration

After these settings are entered, you need to press Test Connection to verify they are correct.

Note

Version 2.14.0 does not currently support proxies with S3. So, the test may fail if your network has a proxy.

2.4.2. S3 Access Control

The extracted collection tool will have S3 credentials in a configuration file. We recommend:

  • You create a bucket that the collection user will upload to

  • You create access keys that have only write (not read) permissions for the target bucket

  • Consider using temporary credentials that works for your situation

With this design, if the S3 credentials are compromised, the data already uploaded cannot be accessed.

2.5. Collection Settings

Regardless of the method used to get data from the target system into Cyber Triage®, you will need to decide at some point about what data types to collect and how to detect malware.

2.5.1. Data Collection Types

The Add New Host wizard will show you a dialog such as this:

../../_images/2_16.jpg

Scan Type

This is where you pick what types of data will be collected. The Collection tool has a similar interface and set of options.

Cyber Triage® groups the types based on the concepts in the Divide and Conquer DFIR Process:

Users

  • Accounts: Collects information about all users on the system and who is actively logged in.

  • Logins: Collects user login information from event logs and the registry.

  • Network Shares: Collects information about mounted network shares.

  • Programs Run: Collects information about what programs were executed by users and collects the corresponding executable file.

  • Web Artifacts: Collects Firefox, Chrome, IE and Edge databases and analyzes them for downloads, cookies, and history. Also collects files from Downloads folder.

Malware

  • Startup Items: Collects the programs that are run each time the computer is started or a user logs in.

  • Scheduled Tasks: Collects Schedule Task information and the associated executable files.

  • Processes: Collects information about running processes. Includes executable files being used by processes.

  • Network: Collects information about active network connections and open ports

  • Network Caches: Collects DNS cache, ARP cache, and routing tables.

System Configuration

  • System Configuration: Collects information about the system, such as audit and security settings.

Full File System Scan: Scans each file on the system and collects the file content if they are suspicious. This is the most time intensive step of the collection process.

The default is Full Scan, which includes all of the types listed above. You can also skip the most time intensive process and choose Skip File Scan.

If time is very limited and you what you are looking for, you can choose Custom and select only certain types.

2.5.2. File Reputation / Malware Scanning Settings

You will also be prompted to choose how the files will be analyzed for malware.

../../_images/2_17.jpg

Scan Type - File Reputation

Cyber Triage® uses its Online File Reputation Service to analyze files for malware. This service uses ReversingLabs, the NIST NSRL, and other sources to assign a score to each file.

You need to configure what data is uploaded. See Analyzing The Host Data for details on how these results are used.

  • Upload MD5 hashes: This will send only the MD5 hash of your files to the service. If the service knows that the file content is associated with malware, then it will identify it as such. Note that any minor change to malware will change its MD5 and it will not be flagged as malware using this technique.

  • Upload file content: This will send the full file to the service if the SHA1 value was not found. It will be scanned and a result will be returned. The raw content will not be visible to other users, only the analysis results.

  • Mark unknown file as suspicious: If the file was not known to the service and you do not want to upload file content, you can choose to have those files marked as suspicious so that you can be aware of them and decide that they are worth additional analysis or ignored.

If you use Cyber Triage® on a computer not connected to the Internet, then you have two options:

  • You can export hash values and manually submit them to the online file reputation service using a website (Advanced Topics)

  • You can use a local copy of the NIST NSRL to ignore known files (see Advanced Topics)

Note

To scan files using the Recorded Future Sandbox malware scanning service after your collection is processed, see Scanning Files in the Recorded Future Sandbox

2.6. Collection Tool Arguments

The Collection Tool is a command line program with various optional arguments that allow you (or other applications) to control what it will collect. To see the options, you can choose supply the —help option. If you supply no arguments, the Collection Tool will collect from the live running system using default settings.

CyberTriageCLI --help
usage:

CyberTriageCLI -i image_name -o output_file <options>

     --encrypt_outfile password password : Encrypt the output file with the given password (password specified twice)
     --s3_upload_config s3_config_file : Upload output file to S3 storage
     --server host : Stream data back to the given Cyber Triage server hostname/IP
     --port port : Port number to connect to the Cyber Triage server
     --sessionid sessionID : Session ID
     --serverkey serverkey : Get from CyberTriage server config panel
     --incident : Use with --serverkey to set the incident for the session
     --fast : Skips full file by file scan. Faster but less comprehensive triage
     --dtypes : Comma list of data types
     --tempdir : Path where temp files are written to
     --skip_file_contents : Report only MD5 hashes and not content for files of interest.
     --skip_source_file_contents : Report only MD5 hashes and not content for source files (registry hives, prefetch, etc..)