Hanzo
OpenapiLicensing

Fingerprint turns raw device signals into the opaque value that binds a license…

Fingerprint turns raw device signals into the opaque value that binds a license to one machine.

POST /v1/licensing/fingerprint

Addresshttps://api.hanzo.ai/v1/licensing/fingerprint
MethodPOST
Operationpost_licensing_fingerprint
AuthAuthorization: Bearer $HANZO_API_KEY

Fingerprint turns raw device signals into the opaque value that binds a license to one machine.

This is the anti-copy step: the value returned here is folded into the signed token, so a token minted with it runs only on the device it was bound to. The derivation is one-way and salted — the signals are never stored and never echoed back — so the response is safe to persist client-side and pass to issue. Signals too weak to identify a machine (a hostname alone) are refused rather than turned into a binding that would collide with other machines.

Request

9 fields, body application/json (required).

FieldInTypeRequiredDescription
signalsbodylicensing.DeviceSignals
signals.archbodystring
signals.cpuidbodystringCPUID is a CPU/board identifier string.
signals.disk_serialbodystringDiskSerial of the boot/root volume.
signals.hostnamebodystringHostname is a weak signal, used only as a tiebreaker.
signals.install_idbodystringInstallID is a per-install random the agent persists locally on first run.
signals.machine_idbodystringMachineID is a stable per-host id (e.g.
signals.macsbodystring[]MAC addresses of stable interfaces (order-insensitive; we sort).
signals.osbodystringOS / Arch coarse platform tags.

Response

StatusBodyMeaning
200licensing.FingerprintResponseok

200 body — 2 fields.

FieldInTypeAlwaysDescription
fingerprintbodystringFingerprint is the OPAQUE binding value to pass to POST /v1/licensing/issue.
versionbodystringVersion is the binding algorithm revision, so a stored fingerprint stays recognizable across a recipe rotation.

Failure carries the platform error shape — see Errors.

Examples

hanzo licensing fingerprint

Licensing API · All Hanzo APIs · Interactive reference

How is this guide?

On this page