|
@@ -1,69 +0,0 @@
|
1
|
|
-# Virtual Machines (VirtualBox)
|
2
|
|
-
|
3
|
|
-This folder documents two pre-configured VirtualBox VMs used for the project.
|
4
|
|
-
|
5
|
|
-## Download
|
6
|
|
-
|
7
|
|
-Access the VMs here:
|
8
|
|
-[Google Drive - VM Files](https://drive.google.com/drive/folders/1CVwy99dX74vCIcA0fG_m4aKY5IReCafv?usp=sharing)
|
9
|
|
-
|
10
|
|
----
|
11
|
|
-
|
12
|
|
-## 1. Vulnerability Scanner VM
|
13
|
|
-
|
14
|
|
-**Base OS:** Ubuntu
|
15
|
|
-**Purpose:** Hosts the full NVSRCO scanning tool, including:
|
16
|
|
-
|
17
|
|
-- Python scripts for host discovery, port scanning, and vulnerability scanning
|
18
|
|
-- OpenVAS container
|
19
|
|
-- Dash web dashboard
|
20
|
|
-- Python scheduler
|
21
|
|
-
|
22
|
|
-**How to Use:**
|
23
|
|
-
|
24
|
|
-- Start the VM
|
25
|
|
-- Ensure Docker is running (`docker ps`)
|
26
|
|
-- Run the Python scheduler:
|
27
|
|
- ```bash
|
28
|
|
- sudo ./venv/bin/python scheduler.py
|
29
|
|
- ```
|
30
|
|
-
|
31
|
|
----
|
32
|
|
-
|
33
|
|
-## 2. WireGuard Client VM
|
34
|
|
-
|
35
|
|
-**Base OS:** Ubuntu
|
36
|
|
-**Purpose:** Acts as a remote client with a pre-configured WireGuard client setup.
|
37
|
|
-
|
38
|
|
-**Configuration Path:**
|
39
|
|
-```bash
|
40
|
|
-/etc/wireguard/wg0.conf
|
41
|
|
-```
|
42
|
|
-
|
43
|
|
-**What You Must Edit Before Use:**
|
44
|
|
-
|
45
|
|
-- `Endpoint`: Set this to the IP of your **scanner**
|
46
|
|
-- `PublicKey`: Set this to the public key of your **scanner**
|
47
|
|
-
|
48
|
|
-**Example:**
|
49
|
|
-```ini
|
50
|
|
-[Peer]
|
51
|
|
-PublicKey = <SCANNER_PUBLIC_KEY>
|
52
|
|
-Endpoint = <SCANNER_IP>:51820
|
53
|
|
-AllowedIPs = 0.0.0.0/0
|
54
|
|
-```
|
55
|
|
-
|
56
|
|
-After editing, start WireGuard:
|
57
|
|
-
|
58
|
|
-```bash
|
59
|
|
-sudo wg-quick down wg0
|
60
|
|
-sudo wg-quick up wg0
|
61
|
|
-```
|
62
|
|
-
|
63
|
|
-
|
64
|
|
-
|
65
|
|
----
|
66
|
|
-
|
67
|
|
-## Notes
|
68
|
|
-
|
69
|
|
-- Ensure your virtual network settings (bridged or host-only) allow communication between the client and scanner
|