Skip to main content

USP Client

USP Client is an auxiliary component used to support reverse SSH tunneling in environments where the USP Server cannot reach internal targets directly due to firewall restrictions. It establishes and maintains a secure tunnel with a USP Server, enabling secure proxying of traffic to the internal network.

Configuration Overview

USP Client uses a small set of required settings to run. Some values have no defaults, so you must define them before running the service.

USP Client reads configuration from two sources:

info
Any configuration value defined via an environment variable overrides the corresponding value in the HCL file.

Configuration File

You can specify the path to the configuration file using one of the following options (in order of precedence):

  1. Environment Variable: USP_CLIENT_CONFIG
  2. Command Line Flag: -c or --config
  3. Default File: usp-client.hcl (lowest precedence)

Commands Usage

To view the available commands and options, run:

usp-client -h

To run a command, run:

usp-client [command]

Available Commands

CommandDescription
usp-client [command] --helpGet more information about a command.
completionGenerate the autocompletion script.
helpDisplay help about any command.
startStart the USP Client and initiate the tunnel connection.

Available Flags

-h, --help      help for usp-client
-v, --version version for usp-client

Start USP Client

To start the USP Client, use:

usp-client start [flags] 

Flags:

  • -c, --config string: Path to the configuration file (default: usp-client.hcl)
  • -h, --help: Displays help information for the start command