Skip to main content

Step CA

Connect to hosts with short-lived SSH certificates from a smallstep step-ca server.

Access & SecuritySourceAPIChangelog
  • Adds the Step CA auth type to hosts
  • Sign in with your identity provider in the browser
  • Certificates are kept until they expire
  • No step binary needed

Step CA lets you connect to hosts with short-lived SSH certificates from a smallstep step-ca server. You sign in with your identity provider in the browser, the CA signs a certificate, and Termix uses it until it expires. No passwords or long-lived keys on your hosts.

No step binary is needed on the Termix server.

Before you start​

  • A step-ca server with SSH certificates on and an OIDC provisioner, set up with your identity provider. See smallstep's SSH guide.
  • Your hosts set to trust the CA's SSH user key.

Set it up​

  1. Install the plugin from the Plugins tab.
  2. Open Settings, Step CA:
    • CA URL: your CA's https address.
    • Root fingerprint (SHA-256): from step ca bootstrap or step certificate fingerprint root_ca.crt.
    • OIDC provisioner name: the provisioner's name on the CA.
  3. Copy the Redirect URI, like https://termix.example.com/plugin-api/step-ca/callback, and register it with the identity provider behind the provisioner.
  4. If the CA or your identity provider is on your own network, list their hosts under Allowed private Step CA hosts.
  5. Save.

Leave the CA URL, fingerprint and provisioner empty to turn Step CA off.

Use it on a host​

  1. Open the host in Manage.
  2. Set Authentication Method to Step CA and save.
  3. Connect. Termix asks you to sign in with your identity provider in the browser, then carries on.

The certificate is kept until it expires, so you only sign in again after that. It works for the terminal, file manager, Docker and every other plugin that connects over SSH.

More than one Termix server​

Several Termix servers behind one load balancer already share a database, and sign in state goes through it, so a sign in started on one server finishes there even when the identity provider sends you back to another. Nothing else to set up.