Encyclopedia for Executables
Encyclopedia for Executables
The xCyclopedia project attempts to document all executable binaries (and eventually scripts) that reside on a typical operating system. Currently, this includes all observed EXE and DLL files, as well as COM Objects (new!). It provides a web page to view the data as well as a machine-readable format (JSON and CSV) that can be immediately usable in other systems such as SIEMs to enrich observed executions with contextual data.
The results provided in the output directory were gathered in virtual machines of various Windows OS versions and patch levels (currently a very manual process). For your own usage, it is always recommended these scripts be first executed in test environments.
The Get-Xcyclopedia script iterates recursively through all directories and starts any executables found. It then gathers a multitude of artifacts (which is slowly being improved). For example, it grabs the command line output, in search of helpful syntax messages. And if a window is visible, it will take a screenshot.
The Get-ComObjects script iterates through each CLSID and enumerates its associated registry keys and exposed methods/properties.
For the machine-readable data (JSON & CSV):
For a web-based view of the data click here: strontic.github.io/xcyclopedia. Note: the web view includes a few bonus features that the JSON/CSV files do not currently include; namely the following:
Sure! The powershell scripts are here! See syntax/usage section below.
Get-Xcyclopedia
#Synopsis: Iterate through all executable files in a specified directory (default target is .EXE). Gather CLI usage/syntax, screenshots, file hashes, file metadata, signature validity, and child processes.
-save_path #path to save output
-target_path #target path for enumerating files (non-recursive). Comma-delimited for multiple paths.
-target_path_recursive #target path for enumerating files (recursive). Comma-delimited for multiple paths.
-target_file_extension #File extension to target (default = ".exe")
-execute_files [bool] #Execute each for gathering syntax/usage info (stdout/stderr)
-take_screenshots [bool] #Take a screenshot if a given process has a window visible. This requires execute_files to be enabled.
-minimize_windows [bool] #Minimizing windows helps with screenshots, so that other windows do not get in the way. This only takes effect if execute_files and $take_screenshots are both enabled.
-xcyclopedia_verbose [bool] #Verbose Output
-transcript_file [bool] #Write console output to a file (job.txt)
-export_ssdeep_list [bool] #Export ssdeep results to a ssdeep-compatible csv file
-export_ssdeep_list_with_md5 [bool] #Include MD5 with ssdeep file export. Useful for determining similarity of unique files.
-get_sigcheck [bool] #Use Sigcheck (Sysinternals) to obtain additional file signatures and PE metadata.
-get_virustotal [bool] #Use Sigcheck (Sysinternals) to obtain VirusTotal detection ratio. It does NOT submit file by default.
-accept_virustotal_tos [bool] #Accept VirusTotal's Terms of Service (https://www.virustotal.com/en/about/terms-of-service/)
-path_to_file_arg1 #This filepath will be provided as an argument to each binary (to test their response to a file being provided as input)
-path_to_file_arg2 #This filepath will be provided as an argument to each binary (to test their response to a file being provided as input)
-convert_to_csv [bool] #CSV export is enabled by default but can be disabled if desired -- JSON will always be exported.
Coalesce-Json
#Synopsis: Combine JSON files into a single file. Only works with PowerShell-compatible JSON files.
-target_files #List of JSON files (comma-delimited) to combine. NOTE: The first file listed takes precedence in case of duplicates.
-save_path #Path to save the combined JSON file.
-verbose_output [bool]
-save_json [bool] #Save file as JSON
-save_csv [bool] #Save file as CSV
Get-ComObjects
#Iterate through all COM Objects by CLSID. Gather ProgIDs, File Paths, Descriptions, and any other data present in the Classes Root. COM Methods can also be collected. Saves as JSON and CSV.
-save_path #path to save output
-transcript_file [bool] #Write console output to a file (job.txt)
-create_instance [bool] #UNSAFE! System crash may occur. When enabled, a COM instance is created for CLSID. This is required for determining COM methods.
-verbose [bool]
Get-Xcyclopedia -save_path "c:\xCyclopedia\out\" -target_path "$env:windir\system32" -target_file_extension ".exe"
Coalesce-Json -save_path "c:\xCyclopedia\out\" -target_files "c:\temp\A.json","c:\temp\B.json"
Get-ComObjects -save_path "c:\xCyclopedia\out\" -create_instance $true
handle64.exe
(available here) in a subfolder called "bin/sysinternals/handle".sigcheck64.exe
(available here) in a subfolder called "bin/sysinternals/sigcheck".dllexp.exe
(available here) in a subfolder called "bin/dllexp-x64".