Skip to content

The agent that grows with you

feat(backend): read the dashboard session token from a file

ethernetde4a083d6c85
diff --git a/hermes_cli/web_server.py b/hermes_cli/web_server.py
index 07005e0b202..92044137c66 100644
--- a/hermes_cli/web_server.py
+++ b/hermes_cli/web_server.py
@@ -221,7 +221,27 @@ app.include_router(_memory_oauth_router)
# HERMES_DASHBOARD_SESSION_TOKEN; otherwise fresh per server start. It dies with
# the process and is injected into the SPA HTML so only the web UI can use it.
def _resolve_session_token() -> str:
- return os.environ.get("HERMES_DASHBOARD_SESSION_TOKEN") or secrets.token_urlsafe(32)
+ env_token = os.environ.get("HERMES_DASHBOARD_SESSION_TOKEN")
+ if env_token:
+ return env_token
+ # Deployment managers hand the token over as a file path (agenix,
+ # sops-nix, systemd credentials) so the secret never enters a store
+ # path or a process listing. The Nix modules set this from
+ # backend.sessionTokenFile instead of exporting the token itself.
+ token_file = os.environ.get("HERMES_DASHBOARD_SESSION_TOKEN_FILE")
+ if token_file:
+ try:
+ token = Path(token_file).read_text(encoding="utf-8").strip()
+ except OSError as exc:
+ raise SystemExit(
+ f"HERMES_DASHBOARD_SESSION_TOKEN_FILE names an unreadable file ({token_file}): {exc}"
+ ) from exc
+ if not token:
+ raise SystemExit(
+ f"HERMES_DASHBOARD_SESSION_TOKEN_FILE names an empty file ({token_file})"
+ )
+ return token
+ return secrets.token_urlsafe(32)
_SESSION_TOKEN = _resolve_session_token()
diff --git a/tests/hermes_cli/test_dashboard_session_token_file.py b/tests/hermes_cli/test_dashboard_session_token_file.py
new file mode 100644
index 00000000000..9ac3027e7bf
--- /dev/null
+++ b/tests/hermes_cli/test_dashboard_session_token_file.py
@@ -0,0 +1,56 @@
+"""The dashboard session token resolves from the environment or a secret file."""
+
+import pytest
+
+
+def test_env_token_wins_over_file(monkeypatch, tmp_path):
+ from hermes_cli import web_server
+
+ token_file = tmp_path / "token"
+ token_file.write_text("file-token\n", encoding="utf-8")
+ monkeypatch.setenv("HERMES_DASHBOARD_SESSION_TOKEN", "env-token")
+ monkeypatch.setenv("HERMES_DASHBOARD_SESSION_TOKEN_FILE", str(token_file))
+
+ assert web_server._resolve_session_token() == "env-token"
+
+
+def test_file_token_is_read_and_stripped(monkeypatch, tmp_path):
+ from hermes_cli import web_server
+
+ token_file = tmp_path / "token"
+ token_file.write_text(" file-token \r\n", encoding="utf-8")
+ monkeypatch.delenv("HERMES_DASHBOARD_SESSION_TOKEN", raising=False)
+ monkeypatch.setenv("HERMES_DASHBOARD_SESSION_TOKEN_FILE", str(token_file))
+
+ assert web_server._resolve_session_token() == "file-token"
+
+
+def test_missing_token_file_fails_loudly(monkeypatch, tmp_path):
+ from hermes_cli import web_server
+
+ monkeypatch.delenv("HERMES_DASHBOARD_SESSION_TOKEN", raising=False)
+ monkeypatch.setenv("HERMES_DASHBOARD_SESSION_TOKEN_FILE", str(tmp_path / "absent"))
+
+ with pytest.raises(SystemExit, match="unreadable"):
+ web_server._resolve_session_token()
+
+
+def test_empty_token_file_fails_loudly(monkeypatch, tmp_path):
+ from hermes_cli import web_server
+
+ token_file = tmp_path / "token"
+ token_file.write_text("\n", encoding="utf-8")
+ monkeypatch.delenv("HERMES_DASHBOARD_SESSION_TOKEN", raising=False)
+ monkeypatch.setenv("HERMES_DASHBOARD_SESSION_TOKEN_FILE", str(token_file))
+
+ with pytest.raises(SystemExit, match="empty"):
+ web_server._resolve_session_token()
+
+
+def test_no_source_mints_a_token(monkeypatch):
+ from hermes_cli import web_server
+
+ monkeypatch.delenv("HERMES_DASHBOARD_SESSION_TOKEN", raising=False)
+ monkeypatch.delenv("HERMES_DASHBOARD_SESSION_TOKEN_FILE", raising=False)
+
+ assert len(web_server._resolve_session_token()) > 0