Watch
0
0
Fork
You've already forked hyperhive
0

correct the ssh revocation docs and say the sign permission is shared

This commit is contained in:
atlas 2026-11-16 16:35:40 +01:00 • committed by mara
commit aeb9317ad1
3 changed files with 30 additions and 6 deletions

View file

@ -5,11 +5,17 @@ key onto it. The agent holds no standing SSH key. It asks the swarm's secret
store for a certificate that lasts an hour, and the machine trusts the swarm's store for a certificate that lasts an hour, and the machine trusts the swarm's
SSH certificate authority (CA) instead of a list of keys. SSH certificate authority (CA) instead of a list of keys.
Nothing changes until you do both of these: Agent-side, nothing changes until you do both of these:
1. Switch SSH on for the agent and name the machines it may reach. 1. Switch SSH on for the agent and name the machines it may reach.
2. Make each machine trust the CA and list the agents allowed in. 2. Make each machine trust the CA and list the agents allowed in.
The permission to get a certificate is in the policy every agent shares, so
every agent with a store identity can already get a certificate for its own
name, whether or not you switch SSH on for it. That's harmless: no machine
trusts a name it doesn't list. Switching SSH on only sets up the key, the
renewal and the client config.
## 1. Switch it on for an agent ## 1. Switch it on for an agent
In the agent's config: In the agent's config:
@ -82,9 +88,15 @@ module writes no `authorized_keys`.
- **One agent from one machine:** remove its name from that user's - **One agent from one machine:** remove its name from that user's
`principals` and deploy the machine. The next login attempt fails. `principals` and deploy the machine. The next login attempt fails.
- **One agent from every machine:** delete its cert-auth role - **One agent from every machine:** remove its name from every machine's
`hive-agent-<name>` in the store. It can no longer log in to the store, so `principals`. That's the revocation. No swarm-wide switch
nothing signs for it, and its last certificate lapses within three hours. stops signing for an agent that a hive still declares: if you delete
its cert-auth role `hive-agent-<name>` in the store, `swarm-controller`
writes it back within five minutes. Signing stops only once no hive declares
the agent any more (you destroyed it); the controller then stops renewing
its store identity, and the identity lapses with its 7-day certificate.
- **A certificate already issued** stays valid until it expires, at most three
hours, whatever you remove. Removing a principal blocks new logins at once.
- **The CA itself:** if the CA key changes, every machine needs the - **The CA itself:** if the CA key changes, every machine needs the
new public key. Nothing replaces the CA by itself. new public key. Nothing replaces the CA by itself.

View file

@ -81,3 +81,14 @@ NixOS then writes `/etc/ssh/authorized_principals.d/<user>` and sets
Egress. The default `egress.forward = "log"` lets a direct connection from an Egress. The default `egress.forward = "log"` lets a direct connection from an
agent to a machine's SSH port through, and `reject` blocks it; there is no agent to a machine's SSH port through, and `reject` blocks it; there is no
per-agent allowance for it yet. per-agent allowance for it yet.
## Revocation
Every agent shares the role, which holds nothing per agent, so there is no
per-agent signing switch. `swarm-controller`'s renewal pass (`agent_renewal.rs`) re-mints
the store identity, and writes the cert-auth role `hive-agent-<name>` back, for
every agent a hive still declares, so deleting the role doesn't stick. Nothing
in the controller deletes the role when you destroy an agent; the renewal pass
skips a destroyed agent and its identity lapses with its 7-day
certificate. A target's `principals` list is the immediate control. A
certificate already signed stays valid for at most `max_ttl` (180 minutes).

View file

@ -9,8 +9,9 @@
# a certificate, the agent's name, so listing an agent here is what lets it in. # a certificate, the agent's name, so listing an agent here is what lets it in.
# No `authorized_keys` entry is written or needed. Removing a name from # No `authorized_keys` entry is written or needed. Removing a name from
# `principals` ends that agent's logins at the next attempt, whatever # `principals` ends that agent's logins at the next attempt, whatever
# certificate it holds; the swarm stops signing for an agent whose store # certificate it holds. The swarm has no switch that stops signing for an
# identity is gone, and the certificates it has lapse within three hours. # agent that is still declared; a certificate already signed expires within
# three hours.
# #
# The agent's side is ../agent-modules/ssh.nix. # The agent's side is ../agent-modules/ssh.nix.
{ {