plan: add WS-H NixOS module + CLI install card, TODO phase 4, DEC-9..11
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
936efaf97e
commit
af73d118bb
5 files changed
+109
No files matched your search
@@ -105,3 +105,33 @@ Options:
|
||||
The MCP spec requires Origin validation on Streamable HTTP servers. If the pinned `rmcp` version has a built-in allowed-hosts or Origin option, use it. Otherwise add a small tower layer on `/mcp` that rejects requests whose `Origin` is present and not in an allowlist. Default allowlist: loopback origins plus `server.bind`.
|
||||
|
||||
**Decision:** Resolved by spike P0-3, 2026-10-15. `rmcp` 3.5.1 validates both headers itself: `StreamableHttpServerConfig::with_allowed_hosts` (default: loopback names only) and `with_allowed_origins` (default empty = Origin validation off; requests without `Origin` always pass). **No custom tower layer is needed.** F8 must set both. Hosts: loopback names + `server.bind` + `server.allowed_hosts`. Origins: `http://localhost:*`, `http://127.0.0.1:*`, `http://[::1]:*`, `http://<bind>:*` + `server.allowed_origins`. The config keys `server.allowed_hosts` and `server.allowed_origins` already exist.
|
||||
|
||||
---
|
||||
|
||||
## DEC-9 — Port 1984 lives in the NixOS module
|
||||
|
||||
**Status:** Proposed
|
||||
|
||||
The module defaults `port = 1984` and `bind = 127.0.0.1`. The binary's own default is unchanged, so non-Nix installs are unaffected. Exposure beyond loopback is an explicit opt-in (`openFirewall` or an interface-scoped rule). Bearer tokens over plain HTTP are readable on a LAN, so Tailscale or a TLS proxy is the recommended path.
|
||||
|
||||
**Decision:**
|
||||
|
||||
---
|
||||
|
||||
## DEC-10 — CLI wrapper for token commands
|
||||
|
||||
**Status:** Proposed
|
||||
|
||||
The DB is in a 0700 state dir owned by the service user, so a login user cannot run `slinuxm token …` directly. The module installs `slinuxm` on `PATH` as a wrapper that re-execs `token` subcommands via `sudo -u <service user>` and passes everything else through. Alternative: ship the bare binary and document `sudo -u`.
|
||||
|
||||
**Decision:**
|
||||
|
||||
---
|
||||
|
||||
## DEC-11 — No declarative or bootstrap tokens in v1
|
||||
|
||||
**Status:** Proposed
|
||||
|
||||
A `bootstrapTokens` option would write plaintext secrets to disk, and importing pre-hashed tokens needs a `slinuxm` change. Tokens stay imperative: printed once, never stored in plaintext.
|
||||
|
||||
**Decision:**
|
||||
Reference in new issue
Block a user