- V7.1.3: env known-insecure-default error no longer echoes the rejected secret value. - V9.1.4: syslog-over-TLS forwarder + listener pin minimum_version=TLSv1_2. - V12.1.2: updater tarball SHA-256 verification is now mandatory and fail-closed — /update and /update-self reject a missing digest (400), the executor rejects missing/mismatched digests before extract/apply. Every push path supplies it. - V13.1.4: reject a wildcard '*' in DECNET_CORS_ORIGINS at startup. - V13.1.5: enforce application/json on JSON write endpoints (415 otherwise), exempting multipart upload routes. - BUG-17: SSE error log records the user uuid, not the resume cursor. Also completes V2.1.7 consistently: the attacker-injectable PYTEST* env bypass is replaced with explicit DECNET_TESTING=1 in the three remaining sites (env.validate_public_binding, config logging, mysql url builder). Tests added for every fix; unanimous adversarial review (no update-outage risk — all push paths verified to send the digest).
104 lines
4.1 KiB
Python
104 lines
4.1 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""validate_public_binding refuses footgun configs at master startup.
|
|
|
|
The validator no-ops under the test harness (DECNET_TESTING=1) by design (so
|
|
unit tests in unrelated modules don't have to set five env vars per fixture);
|
|
these tests clear that flag before calling it so the real code path runs.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import importlib
|
|
import sys
|
|
|
|
import pytest
|
|
|
|
|
|
def _reimport_env(monkeypatch: pytest.MonkeyPatch):
|
|
for mod in list(sys.modules):
|
|
if mod == "decnet.env" or mod.startswith("decnet.env."):
|
|
sys.modules.pop(mod)
|
|
return importlib.import_module("decnet.env")
|
|
|
|
|
|
def _strip_test_flag(monkeypatch: pytest.MonkeyPatch) -> None:
|
|
# The validator short-circuits on DECNET_TESTING=1 (set globally by
|
|
# conftest). Clear it so the real production code path runs.
|
|
monkeypatch.delenv("DECNET_TESTING", raising=False)
|
|
|
|
|
|
def test_validator_noop_on_loopback_binding(monkeypatch: pytest.MonkeyPatch) -> None:
|
|
monkeypatch.setenv("DECNET_API_HOST", "127.0.0.1")
|
|
monkeypatch.setenv("DECNET_CORS_ORIGINS", "http://localhost:8080")
|
|
env = _reimport_env(monkeypatch)
|
|
_strip_test_flag(monkeypatch)
|
|
env.validate_public_binding() # no raise
|
|
|
|
|
|
def test_validator_rejects_loopback_cors_on_public_bind(
|
|
monkeypatch: pytest.MonkeyPatch,
|
|
) -> None:
|
|
monkeypatch.setenv("DECNET_API_HOST", "0.0.0.0")
|
|
monkeypatch.setenv("DECNET_CORS_ORIGINS", "http://localhost:8080")
|
|
env = _reimport_env(monkeypatch)
|
|
_strip_test_flag(monkeypatch)
|
|
with pytest.raises(ValueError, match="loopback origin"):
|
|
env.validate_public_binding()
|
|
|
|
|
|
def test_validator_accepts_public_cors_on_public_bind(
|
|
monkeypatch: pytest.MonkeyPatch,
|
|
) -> None:
|
|
monkeypatch.setenv("DECNET_API_HOST", "0.0.0.0")
|
|
monkeypatch.setenv("DECNET_CORS_ORIGINS", "https://dashboard.example.com")
|
|
env = _reimport_env(monkeypatch)
|
|
_strip_test_flag(monkeypatch)
|
|
env.validate_public_binding() # no raise
|
|
|
|
|
|
def test_validator_rejects_plaintext_canary_on_public_bind(
|
|
monkeypatch: pytest.MonkeyPatch,
|
|
) -> None:
|
|
monkeypatch.setenv("DECNET_API_HOST", "0.0.0.0")
|
|
monkeypatch.setenv("DECNET_CORS_ORIGINS", "https://dashboard.example.com")
|
|
monkeypatch.setenv("DECNET_CANARY_HTTP_BASE", "http://canary.example.com:8088")
|
|
env = _reimport_env(monkeypatch)
|
|
_strip_test_flag(monkeypatch)
|
|
with pytest.raises(ValueError, match="plaintext HTTP"):
|
|
env.validate_public_binding()
|
|
|
|
|
|
def test_validator_allows_loopback_canary_even_on_public_bind(
|
|
monkeypatch: pytest.MonkeyPatch,
|
|
) -> None:
|
|
# Local canary endpoint behind the master is fine; only public-facing
|
|
# plaintext is the footgun.
|
|
monkeypatch.setenv("DECNET_API_HOST", "0.0.0.0")
|
|
monkeypatch.setenv("DECNET_CORS_ORIGINS", "https://dashboard.example.com")
|
|
monkeypatch.setenv("DECNET_CANARY_HTTP_BASE", "http://localhost:8088")
|
|
env = _reimport_env(monkeypatch)
|
|
_strip_test_flag(monkeypatch)
|
|
env.validate_public_binding() # no raise
|
|
|
|
|
|
def test_validator_skips_under_test_harness(monkeypatch: pytest.MonkeyPatch) -> None:
|
|
# With DECNET_TESTING=1 still in env (set by conftest), even a misconfigured
|
|
# env passes — this is the deliberate bypass so unrelated tests don't trip.
|
|
monkeypatch.setenv("DECNET_TESTING", "1")
|
|
monkeypatch.setenv("DECNET_API_HOST", "0.0.0.0")
|
|
monkeypatch.setenv("DECNET_CORS_ORIGINS", "http://localhost:8080")
|
|
env = _reimport_env(monkeypatch)
|
|
env.validate_public_binding() # no raise — guard short-circuits
|
|
|
|
|
|
def test_validator_pytest_var_leak_does_not_bypass(monkeypatch: pytest.MonkeyPatch) -> None:
|
|
# V2.1.7 regression: a leaked PYTEST_* env var must NOT disable the guard.
|
|
# With DECNET_TESTING cleared, a misconfigured public binding still raises
|
|
# even though a PYTEST_* var is present.
|
|
monkeypatch.delenv("DECNET_TESTING", raising=False)
|
|
monkeypatch.setenv("PYTEST_CURRENT_TEST", "x")
|
|
monkeypatch.setenv("DECNET_API_HOST", "0.0.0.0")
|
|
monkeypatch.setenv("DECNET_CORS_ORIGINS", "http://localhost:8080")
|
|
env = _reimport_env(monkeypatch)
|
|
with pytest.raises(ValueError, match="loopback origin"):
|
|
env.validate_public_binding()
|