Registering Hosts

How to register hosts

In order to access a host through SSH Connect, the host must first be registered with Webscale in the appropriate account. This is a two step process (registration followed by approval).

Registering SSH hosts

The first of these steps can be done either through the API directly or via the Webscale Monitoring Agent (WMA) running on the host with SSH enabled.

Webscale Monitoring Agent Registration

When SSH is enabled on WMA, the agent will reach out directly to Webscale’s API with the relevant information needed to register including name (hostname), address, and host keys. Approval, and associating the server with a Via host (bastion), must still be done through the Control Plane.

Registering through the API

If registering through the API, please reference the appropriate documentation here.

Field Description
Name* This is what the host will be referred to in the Control Panel. This can be changed later. WMA registration will automatically default to the hostname.
Address* The address used to access the host. If this is a private address, you will want to include via (below).
Host Keys The host keys of the host. WMA registration will fetch these automatically.
Via The registered host that serves as a jump through to access a privately accessible host.

Approving SSH hosts

Registering the host will make it available for approval in the SSH connect management table. A user with authority to PATCH /v2/ssh-hosts (included in Editor role) should then confirm the address and name of the host and click approve to make the host accessible through SSH Connect.

Approve host dialogue

Registered, but unapproved hosts will not appear in the SSH connect drawer.

Last modified October 1, 2024