API reference

Authenticate and pin the computer

Configure the service, send the bearer token, pin its key and rotate credentials safely.

Configuration

{
  "enabled": true,
  "listen": "0.0.0.0",
  "port": 3333,
  "token": "<48 hex characters>",
  "fingerprint": "sha256//<base64>"
}

api.json is in the per-user settings folder. api-cert.der and api-key.der sit beside it.

Bearer token

Authorization: Bearer <token>

The token controls every machine available to the service user. Never put it in a URL for a new integration.

Certificate pinning

Validate the certificate public key’s SHA-256 fingerprint. Public-CA validation is not the identity mechanism for this self-issued certificate.

Rotation

Replace the token and restart VMBook. Delete both DER certificate files only to replace host identity; every caller must then verify the new fingerprint.

Browser sessions

POST /v1/session signs in a locally provisioned user, GET reports it, and DELETE signs out. Changes require X-VMBook.