DeepSurface: Subordinates

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)

The Subordinate Scanners area is where you configure additional DeepSurface installations. For instance, if you need to segment the scans on different parts of your site, setting up subordinate installations is helpful.

Go to Scanning > Settings > Subordinates. You should see a screen that looks like the following.

subordinates

Notice the icons for adding, editing, and deleting subordinate scanners.

Adding a New Subordinate Scanner

To add a Subordinate scanner click on the + Subordinate Scanner button. You will see a form that looks like this.

subordinates

Enter a Name for your subordinate scanner in the New field

Click the Save button to continue. You will get an informational screen that looks like the following. Notice the download link at the bottom of the modal.

subordinates

Here are the steps

Step 1 - Download the registration file to a convenient location. Step 2 - Copy the file to your new DeepSurface Virtual Machine (the one which will be your subordinate server).

We recommend you set up an SSH connection to your VM so that you can login with a regular terminal to more easily copy/paste, etc. If you are using VirtualBox and would like to share a file folder, you need to set up Guest Additions. See here for some brief instructions.

Step 3 - Create a DeepSurface Virtual Machine for your subordinate scanner as described in the Virtual Machine Instructions

Step 4 - Configure the Virtual Machine's network settings as described in the those Virtual Machine instructions.

Step 5 - Login to the DeepSurface Virtual Machine for your subordinate scanner and run the following command.

sudo deepsurface-install

Step 6 - You will first get a screen asking you to accept the license agreement. Select "<AGREE>".

Step 7 - The next screen asks if you would like to install a DeepSurface main console or a subordinate, at which point you should choose "SUBORDINATE". See the following screenshot.

Subordinate

Step 8 - You can either paste the contents of the subordinate registration file into the console or upload the file to the new system (via SCP, SFTP, or another method) and choose the file from the filesystem. Select "<CHOOSE FILE>" to choose the file from the VM host's filesystem after copying it. If you prefer to paste the file, select the "<PASTE FILE>" option and paste the file contents when the text box appears.

Subordinate

Step 9 - Choose "<OK>". At this point the new DeepSurface subordinate scanner will attempt to connect to the DeepSurface main console on a port and IP address provided by the main console. That information can sometimes be incorrect (e.g. if NAT is in use). If the subordinate scanner fails to contact the main console, you will be prompted to enter different IP and port information. Subordinates can contact the DeepSurface main console on either port 443/TCP or 44305/TCP.

After successfully completing this process, the subordinate's status in the web console will change from "unregistered" to "online". See the following two screenshots for an example.