Files
Andriy Oblivantsev 6c26135cad
CI / test (push) Successful in 4s
Update
2026-03-02 21:21:21 +00:00
..
2026-03-02 21:21:21 +00:00

Server Service Keys

Server Ed25519 keypair for client authentication and registration.

Generate

./bin/gen-server-keys.sh

Creates:

  • server-service.pub — public key; clients download via GET /v1/service-key
  • server-service.key — private key (keep secret)
  • server-service.env — env vars for docker compose (ADMIN_PUBLIC_KEY, SERVICE_PUBLIC_KEY)

Client Usage

Clients fetch the server public key and use it to:

  1. Register — sign the server pubkey, post to POST /v1/auth/register-by-signature
  2. Verify server identity — for future signed responses or request validation

Docker Compose

The api service uses env_file: etc/server-service.env and mounts ./etc so keys are available. Run ./bin/gen-server-keys.sh before first docker compose up.