DeepSurface: Virtual Box

Documentation
Installation Guide
Overview
Let DeepSurface Host For You
Getting Started
System Requirements
Self Hosted Quick Start - Installing to Cloud Platforms
Self Hosted - Installation Using an OVA
Registration, Package Installation, and Initialization
First Steps After Initialization of the Console
Deployment Options
Main and Subordinate Consoles
Agent-Based Deployment
User Managed Scan Deployment
Credentialed Scanning Deployment
Mixed Environment
Deployment Tools
Active Directory Group Policy
Microsoft Endpoint Configuration Manager (part of InTune)
Tanium Deploy
HCL BigFix
Ivanti
Virtual Machines
VMWare
Virtual Box
VirtualBox Guest Additions
AWS EC2 (BYOL)
AWS EC2 (Usage Based)
Azure Cloud
Google Cloud
Additional Items to Consider
Main Console Server Certificates
LDAP
TOFU
Clock Sync
DeepSurface Commands
Multiple Vulnerability Sources
API Documentation
User Guide
Reporting
Dashboards
Exports
Risk Insight
Hosts
Patches
Vulnerabilities
Vulnerability Instances
Users
Remediation Workflow Manager
Plans
Settings
Integrations
Workflow
Exporting
Accepted Risk Plans
Accepted Risk Workflow
Explore
Model
Paths
Activity
Tasks
Configuration Alerts
Scan Logs
Notification Settings
Scanning
Status
Agents
User Managed
Credentialed Scanning Settings
Credentials
Scan Groups
General Settings
Cloud Scanning
Network Connectivity
Subordinates
Vulnerability Sources
Setup
Sensitive Assets: Polices
Sensitive Assets: Manual
Admin Settings
SMTP Settings
Certificates
Outbound Proxy
Authentication Providers
Users
Tags
Integrations Guide
Vulnerability Sources
CrowdStrike Spotlight
SentinelOne
Carbon Black Cloud
Microsoft Defender for Endpoint
Wazuh
Lansweeper Cloud
Nessus API
Tenable.io API
Security Center/Tenable.sc API
Rapid7 InsightVM API
Qualys API
Nozomi Guardian
Eclypsium
AWS Inspector
Remediation
Jira Software
Tanium (BETA)
Authentication Providers
LDAP (Active Directory)
SAML (Azure Active Directory)
SAML (Google)
SAML (Okta)
PAM
CyberArk
Delinea (Thycotic)
Microsoft LAPS
Security Guide
Firewall Configuration
Base Network Requirements
Agent Network Requirements
Credentialed Scanning Network Requirements
API Network Requirements
How DeepSurface Scans Work
Domain (LDAP) Scanning
Host Scanning Routine
Reasons for the Administrative Access Requirement
Endpoint Protection Considerations
Other Items
Scope of Data Storage and Retention
IPS/IDS Considerations
Logging
Resetting the DSADMIN password
Product Information
Changelogs
Open source Licenses
End User License Agreement (EULA)

While VirtualBox on a desktop is likely not the best place set up a production deployment of DeepSurface, it's perfectly fine for doing experimentation and evaluation. In this section, we show the steps for using VirtualBox, but these steps will be similar for any OVA installation.

The Diagram below represents the basic flow of installation:

Virtual Machine Flow

Download VirtualBox and the Import DeepSurface OVA

Download VirtualBox here (provided VirtualBox is not already installed)

Download the appliance from DeepSurface Security. You should have been provided a URL and an installation code. If you don't have these, please request them from your DeepSurface Security support contact.

In VirtualBox, choose File > Import Appliance

It will take some time to complete the import.

Configure a Network Adapter (before starting the VM)

For this example, we will choose NAT from Settings > Network > Attached to as shown in the following screenshot.

vb

Optional: Setup Port Forwarding

If you chose NAT, you should set up port forwarding so your local machine (where you will run the DeepSurface web console) can easily SSH into the virtual machine. In this example, I have chosen port 2222 on the local machine (host) and select the default SSH port on the VM (guest) (port 22). HTTPS can also be configured so you can access the web console of your VirtualBox image. See the screen shot which follows.

First Screen

For this example, you can login to the DeepSurface VM using this command:

ssh -L 8443:127.0.0.1:443 -p 2222 dsadmin@localhost

To view the web console in a browser, set <DS_IP> to the IP address of the DeepSurface VM. You can get the IP address of the machine when you are SSH'd in and reading the output of hostname -I. Then navigate to 127.0.0.1:8443 while the VM is running.

If you are familiar with VirtualBox, feel free to configure any other settings you like. Now we are ready to start the virtual machine.

Proceed to Installation using an OVA to register with DeepSurface and begin the system initialization process.