diff --git a/docs/networking/snapshot-store.md b/docs/networking/snapshot-store.md index 72adf238..d06f171b 100644 --- a/docs/networking/snapshot-store.md +++ b/docs/networking/snapshot-store.md @@ -123,8 +123,8 @@ somebody already thought of. ## Reachability The receiver is socket-activated, and the socket binds **this host's -mesh address**, never a wildcard. Both the mesh being enabled and the -address being set are assertions, not documentation --- bound to +mesh address**, never a wildcard. The module asserts two things: the +mesh is on, and the address isn't empty --- neither is just documentation: bound to `0.0.0.0` this socket is an unauthenticated remote write into agent state. @@ -161,7 +161,7 @@ The boundary is the machine. The intended deployments are: The second is worth keeping deliberately, and not only for convenience: it means every local deployment exercises the confined path. The usual failure mode for an isolated variant is that -nobody runs it day to day, so it rots and is discovered broken in +nobody runs it day to day, so it rots and turns up broken in production. ⚠️ **The assumption to keep true over time:** the store host runs @@ -175,8 +175,8 @@ Which makes it the highest-value target in the swarm by a wide margin, and means it should get the treatment a backup host gets --- restricted access, and a decision (rather than an omission) on encryption at rest. -The trap is the label: this box holds backup-grade data while not being -called a backup, so it can end up with backup-grade _exposure_ and +The trap is the label: this box holds backup-grade data while nobody +calls it a backup, so it can end up with backup-grade _exposure_ and non-backup-grade _controls_. Nobody puts a migration staging area on the access-review list.