plan: TLS is optional via config, default off

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
ariandClaude Sonnet 5.5 committed 2026-10-16 06:53:58 -04:00
1 parent 90e30bd771
commit 1a2e744b79
2 files changed
+2 -1

No files matched your search

+1 -1
View File
@@ -144,6 +144,6 @@ Tokens are minted with `slinuxm token create <name>`, printed once, and never st
**Status:** Proposed
Bearer tokens over plain HTTP are readable on the wire, and LAN exposure is the intended deployment. The service gets native TLS: `server.tls.enabled`, `cert_file`, `key_file`, with certificate reload on SIGHUP so ACME or sops-managed rotation needs no restart. A reverse proxy still works and nothing depends on it. rustls is already in the dependency tree and openssl stays out. When TLS is enabled the MCP Origin allowlist uses `https://`. A non-loopback bind without TLS logs a startup warning but is not refused.
Bearer tokens over plain HTTP are readable on the wire, and LAN exposure is the intended deployment. The service gets native TLS: `server.tls.enabled`, `cert_file`, `key_file`, with certificate reload on SIGHUP so ACME or sops-managed rotation needs no restart. A reverse proxy still works and nothing depends on it. rustls is already in the dependency tree and openssl stays out. When TLS is enabled the MCP Origin allowlist uses `https://`. TLS is optional and off by default; with it off nothing changes. A non-loopback bind without TLS logs a startup warning but is not refused.
**Decision:**
+1
View File
@@ -34,6 +34,7 @@ Tick these in [`TODO.md`](../../TODO.md).
## Notes
- **TLS is optional (user requirement, 2026-10-16).** `server.tls.enabled` defaults to `false`. With it off the server behaves exactly as before: plain HTTP, no cert or key files read, MCP origins stay `http://`. It is configurable by file, env (`SKYG_SERVER__TLS__*`) and shown by `--print-config`. Existing tests pass unchanged with the default config.
- DEC-12 holds the rationale. The NixOS module (WS-H) passes certificate paths through systemd `LoadCredential` so the service user never needs read access to the original key file.
## Log