Nodes

Read a server's SSH host key, without logging in, so the operator can confirm it before adding the server.

post/nodes/ssh/host-key

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/nodes/ssh/host-key
  • Auth: HTTP bearer

Request body

hoststring required

Hostname or IP address.

portinteger nullable

SSH port (default 22).

Response

The server's host key

addressstring required

ip:port the control plane connected to.

algorithmstring required

e.g. ssh-ed25519.

fingerprintstring required

SHA256:…, as ssh-keygen -l prints it.

Changes