VaultOne: Install a Connector

VaultOne operates with a hybrid software architecture, meaning part of the system runs in the cloud and another part operates within your company's infrastructure. Connectors are a crucial component of this architecture, serving three main functions: acting as an access proxy, recording sessions (if your subscription includes this feature), and performing password backups.

Only VaultOne administrators can perform the connector installation.

Prerequisites

Operational System

Ubuntu

Ubuntu Server 24.04

Hardware

To install the VaultOne Connector correctly, make sure you meet one of the hardware requirements options based on the number of concurrent sessions per Connector:

Network

Some basic firewall settings must be applied on the server by the network administrator. This configuration consists of allowing the Connector's Server to receive connections (Inbound) on ports 443 and 2222 (For bastion access only), in addition to its default SSH port. It will also be necessary to ensure that this server, where the connector will be installed, can communicate with the resources that will be accessed through communication protocols (HTTP, HTTPS, RDP, SSH, Telnet or VNC).

If you need help with VaultOne Topology, access the following article:

How VaultOne Topology Works.

Installing a VaultOne Connector

Installation of a new VaultOne Connector is a two stage process. The first stage involves creating and configuring a new connector. And the second stage involves installation of the connector.

Configuring the Connector in VaultOne

1. Log in to VaultOne platform.
2. Go to Administration > Connectors. A list of available connectors is displayed.
3. Click +Add Connector. The Create new connector page is displayed.
4. On the Create new connector, configure the connector by entering the following details:
   • Name
   • IP
   • Web Port
   • Default
   • Shell Port
   • Record Video
5. Click Save to save the details and register the connector.

Install the Connector on a Linux Machine

After saving the connector's configuration in VaultOne, you'll be redirected to the connectors board. From there, you can proceed with the actual installation on your designated Linux machine.

1. Access Installation Options: Locate the newly registered connector on the board. Click on Actions next to it, then select Install.
2. Choose Installation Method: At this point, you'll have two main options for installing the connector on a Linux machine:
   • Copy and Paste Commands: You can copy the provided installation data/commands directly from VaultOne and paste them into the terminal of your Linux machine.
   • Download Script: Alternatively, you can download the installation script and then run it on your Linux machine, which should be prepared to host the connector.
3. Complete Installation: After executing one of these methods on your Linux machine, click Close in the VaultOne interface.

Verify Installation

To confirm that the connector has been successfully installed, check the connectors menu in your VaultOne platform. If the software version and the last access date of your newly installed connector appear correctly, the installation was successful.