user-viewfinderWhat is SSH ID

This page explains how SSH ID works in Termius, how it manages device-bound SSH passkeys, and how to use it to securely connect to servers without sharing private keys.

SSH ID is an easy-to-use system for managing SSH passkeys. It generates and aggregates device-bound passkeys, including FIDO2 and biometric keys, so you can connect to servers without copying or sharing private keys.

How it works

When setting up an SSH ID, you create a unique public handle (@username) that lets anyone fetch all your public keys at once.

On your device

  • Termius generates a unique set of device-bound SSH keys (passkeys)

  • The set includes ECDSA-SK (hardware key protected with biometrics), ECDSA, ED25519, and RSA (for legacy devices)

  • Each key is signed by your unique certificate and can be verified

circle-info

The private parts of the keys generated with SSH ID never leave your device.

circle-info

Public parts are pushed to the server and are publicly available via your handle, along with certificates at sshid.io/<your_handle>arrow-up-right.

On your servers

Once the SSH ID is set up, you can add all your public keys from all devices using one single command.

curl https://sshid.io/<your_handle> >> ~/.ssh/authorized_keys

This allows you to connect from all your devices using device-bound keys.


Proceed to Setup & usage to enable SSH ID for your Termius account.

See SSH ID Security for the security model and verification details.


FAQ

chevron-rightWhy do I need a Termius account to use SSH ID?hashtag

An account is required because SSH ID relies on your Termius account to sync public keys securely across all your devices. Without it, SSH ID can't make your identity available from multiple devices.

Your private keys never leave your device, only the latest public keys are synchronized.

chevron-rightWhy the public keys are accessible online publicly?hashtag

Only the public keys are accessible online via the handle that you specified during the SSH ID setup.

The corresponding private keys never leave devices where they were generated.

chevron-rightCan I remove a particular key from the SSH ID profile?hashtag

The keys in your profile are device-bound. New keys are generated every time you login with your Termius account on a new device.

To remove particular keys, you need to log out from your account on the corresponding devices.

chevron-rightHow can I regenerate the keys generated for SSH ID?hashtag

To regenerate the keys, you need to log out and then log back in on your devices.

The new public keys should be then provisioned to the affected servers.

Last updated

Was this helpful?