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.