Connect

SSH keys and authentication

Choose the identity your server expects and protect private material separately from ordinary profile details.

2 min read User guide

Two identities are involved

SSH verifies the server's identity and authenticates your user account. Your private key proves who you are; the server's fingerprint helps prove which machine you reached. Neither check replaces the other.

A key passphrase protects a private key. It is separate from your server password, LeapTerm sign-in and vault password. Check which credential a prompt is requesting before entering it.

Use an SSH identity

  1. Open the supported identity-management options under Keys & Security. Import private material only from a source you trust.
  2. Have the corresponding public key authorized for your username on the server.
  3. Edit the server profile and select that identity under Authentication & Security. Where offered, use Key from encrypted Vault or Choose private key file, and check its credential reference before saving.
  4. Unlock the vault or private key when requested, then connect.
  5. Verify the server fingerprint independently before trusting a new host.

The server must permit your chosen method. A key-only server does not additionally require a password; a password or interactive login can have a different prompt sequence.

After Import hosts, select your credentials again in the host or vault editor. An imported key-file path or credential reference does not automatically bind a usable secret to the profile.

Handle keys carefully

Private keys must not appear in tags, snippets, support messages or screenshots. An unavailable native keyring is not an instruction to save them unprotected elsewhere.

With an enrolled relay route, your client can also prove permission to reach the agent. That check is separate from logging in to the destination server. A relay token does not replace the destination's authentication requirements.

The installed Protected workspace uses a locally generated device key that the customer must explicitly approve for the enrolled agent. This is separate from the destination's SSH identity. Follow the protected browser connection steps; do not paste a customer root private key or target password into Device enrollment.

For a failed login, check username, selected identity, passphrase and server-side authorization. For an identity warning, follow host verification, not a password-reset workflow.

Features vary by release, platform and connection route. Check availability before planning your setup.

Search the guides

Search runs in your browser.

Your search stays here. No account or external search service.