Provenance-Graph

Prerequisites

Before you begin, ensure you have the following installed on your system:

• Node.js
• Live Server (VS Code extension)

Installation

1. Clone the repository:

   git clone https://github.com/your-username/your-repository.git

2. Check and make sure that your working directory ends in /prov-graph-js (if not, use cd and ls):

   pwd

   

3. Install the project dependencies:

   npm install

   or

   npm i

   

   This should create a node_modules folder.

Running the Server

1. Connect to the VPN:

2. Start the server:

   node server.js

   You should see the following output in the console:

   running on port xxxx

   

Launching the Project

1. Open tree.html with Live Server:

   • Right-click on tree.html in VS Code and select "Open with Live Server".

   or

   • Use the command palette (Ctrl+Shift+P) and type Live Server: Open with Live Server.

Using the Project

Search

1. Enter an event ID and number of layers into the respective input fields (to test, you can use HcLR0ooBBBvBsP_nxiNu and '4'):

2. Click the search button to begin: The screen should have two nodes, the node on the right represents the current process, and the node on the left represents the parent process.

Explore the Graph

1. Clicking on a leaf node will generate any child processes and display a dialog box with the necessary information about that node:

2. Clicking on a parent node will minimize the graph:

3. Selecting the reverse box and clicking on a node will generate the parent process:

4. Selecting the file or network box and clicking on a node will generate any child files or networks as well:

5. Selecting the Hide File, Hide Process or Hide Network checkboxes will hide all nodes of that respective nature:

Contributing

If you wish to contribute to this project, please follow the contributing guidelines.