keystone

Disk unlock server

keystone

keystone is a Tang server for clevis network-bound disk encryption, run as a Cloudflare Worker. A disk unlocks at boot without a passphrase. Delete a stolen computer's key set and its disk stays locked. Set it up, read the architecture or the source.

Install Architecture Source

What it does, below

What it does

An encrypted disk asks for its passphrase at every start. A server with no one at the keyboard waits at the prompt.

keystone supplies the missing half of a second key the computer keeps on the disk, so the disk opens without the passphrase. It suits computers that reach the internet at boot but have no unlock server on their network.

Until you delete a stolen computer's key set, anyone who starts it online unlocks the disk, unless the set limits who can ask.

At boot the computer asks keystone for the missing half of its disk key.

How it works

  1. 1 · bind

    Bind the disk once

    clevis adds a second way into the LUKS disk, tied to a key set: two keys keystone holds under one name.

  2. 2 · boot

    Unlock at startup

    The initramfs, which runs before the disk opens, asks keystone for the missing half and opens the disk.

  3. 3 · delete

    Delete a stolen disk's key set

    keystone stops answering for that set, and the disk stays locked.

If keystone is offline or past its daily request limit, the disk asks for its passphrase.

Where the secrets are

keystone never receives the disk's passphrase or its second key. It keeps each key set's private keys as one secret in your Cloudflare account, and the computer sends its header value blinded, so keystone never sees it.

Anyone who can deploy keystone in your account can read the key sets. A copied key set opens its disk even after a delete, and rolling back the Worker past a delete serves the deleted set again. Protect the account and your offline copy like the disks. To split trust across two servers, see the architecture.

Who can ask

A key set can name the networks allowed to unlock it and who approves the rest. Other networks are held while the approvers are mailed a link. An approval lets that network unlock for 10 minutes. Listed networks are never held. The architecture has the mechanism.

What you need

  • A Linux computer with a LUKS disk and clevis.
  • A Cloudflare account and a domain on it. The free plan works with --curve P-256; the default curve needs the paid Workers plan.
  • Node.js, git and jq, to create and deploy key sets.
  • An offline place for key sets, such as pass.
  • Each disk's passphrase, for when keystone cannot answer.
  • Reference

    Architecture

    Each mechanism in figures.

  • Setup

    Install

    Deploy keystone and bind a first disk.

  • Code

    Source

    Shared as-is: no roadmap, no support promise.