Files
computer-playbook/tests/unit/python/plugins/lookup/test_tls.py
T
kevinveenbirkenbachandClaude Opus 5.5 e611e5ea05 fix(objstore): name the consumer when resolving its onion origin
sys-svc-objstore includes the provider role with application_id set to "{{ _provider_role }}", which is itself lookup('objstore', ...). For a consumer served only on onion the objstore lookup sets proxy_required and calls lookup('tls', consumer_id); without a consumer, align_domain_to_consumer renders variables['application_id'], which runs the objstore lookup again, and the chain repeats until Ansible stops with "Recursive loop detected" / "Maximum depth exceeded" (fork run 40042690056, jobs Moodle#2 and Nextcloud#12, log line 286323). Only web-app-matrix sets single_mode, so only its multi-mode onion deploys hit it.

The tls lookup takes a consumer= kwarg and hands it to align_domain_to_consumer, the way canonical_url already does, and the objstore lookup names its consumer. The default stays empty, so no other caller changes. Regression tests cover both lookups; an onion consumer now resolves to http://matrix.<onion>/objstore/matrix.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-24 15:26:22 +02:00

220 lines
8.4 KiB
Python

import sys
import unittest
import unittest.mock as mock
from unittest.mock import patch
from ansible.errors import AnsibleError
import utils.tls_common as _tls_common
from plugins.lookup.tls import LookupModule
sys.modules.setdefault("ansible.module_utils.tls_common", _tls_common)
class TestTlsResolveLookup(unittest.TestCase):
def setUp(self):
self.lookup = LookupModule()
self.lookup._loader = mock.MagicMock()
self.domains = {
"web-app-a": "a.example",
"web-app-b": ["b.example", "b-alt.example"],
"web-app-c": {"primary": "c.example", "api": "api.c.example"},
}
self.applications = {
"web-app-a": {},
"web-app-b": {"server": {"tls": {"flavor": "self_signed"}}},
"web-app-c": {"server": {"tls": {"enabled": False}}},
}
self.base_vars = {
"domains": self.domains,
"applications": self.applications,
"TLS_ENABLED": True,
"TLS_MODE": "letsencrypt",
}
# Route the "domains"/"applications" lookups through
# variables['domains'] / variables['applications'] so tests stay hermetic.
def _get(name, *_a, **_k):
def _run(_terms, variables=None, **__):
return [(variables or {}).get(name, {})]
return mock.MagicMock(run=_run)
loader_patcher = patch("plugins.lookup.tls.lookup_loader")
loader_mock = loader_patcher.start()
loader_mock.get.side_effect = _get
self.addCleanup(loader_patcher.stop)
def test_domain_term_auto_mode(self):
out = self.lookup.run(["a.example"], variables=self.base_vars)[0]
self.assertEqual(out["application_id"], "web-app-a")
self.assertEqual(out["domain"], "a.example")
self.assertTrue(out["enabled"])
self.assertEqual(out["mode"], "letsencrypt")
self.assertEqual(out["protocols"]["web"], "https")
self.assertEqual(out["ports"]["web"], 443)
self.assertEqual(out["url"]["base"], "https://a.example/")
def test_app_term_forced_app(self):
out = self.lookup.run(["web-app-a"], variables=self.base_vars, mode="app")[0]
self.assertEqual(out["application_id"], "web-app-a")
self.assertEqual(out["domain"], "a.example")
def test_app_override_flavor(self):
out = self.lookup.run(["web-app-b"], variables=self.base_vars, mode="app")[0]
self.assertEqual(out["mode"], "self_signed")
def test_app_override_enabled_false(self):
out = self.lookup.run(["web-app-c"], variables=self.base_vars, mode="app")[0]
self.assertFalse(out["enabled"])
self.assertEqual(out["mode"], "off")
self.assertEqual(out["protocols"]["web"], "http")
self.assertEqual(out["ports"]["web"], 80)
def test_domains_all_contains_primary_first(self):
out = self.lookup.run(["web-app-b"], variables=self.base_vars, mode="app")[0]
self.assertEqual(out["domains"]["primary"], "b.example")
self.assertEqual(out["domains"]["all"], ["b.example", "b-alt.example"])
def test_want_path_returns_scalar(self):
val = self.lookup.run(
["web-app-a", "url.base"], variables=self.base_vars, mode="app"
)[0]
self.assertEqual(val, "https://a.example/")
def test_protocols_web_path_is_http_for_an_onion_only_app(self):
onion = dict(self.base_vars)
onion["domains"] = {**self.domains, "web-app-onion": "abc123.onion"}
onion["applications"] = {**self.applications, "web-app-onion": {}}
val = self.lookup.run(
["web-app-onion", "protocols.web"], variables=onion, mode="app"
)[0]
self.assertEqual(val, "http")
def test_protocols_web_path_is_https_for_a_clearnet_app(self):
val = self.lookup.run(
["web-app-a", "protocols.web"], variables=self.base_vars, mode="app"
)[0]
self.assertEqual(val, "https")
def test_missing_required_vars(self):
with self.assertRaises(AnsibleError):
self.lookup.run(["web-app-a"], variables={})
def test_invalid_tls_mode_default(self):
bad = dict(self.base_vars)
bad["TLS_MODE"] = "invalid"
with self.assertRaises(AnsibleError):
self.lookup.run(["web-app-a"], variables=bad, mode="app")
def test_invalid_forced_mode(self):
with self.assertRaises(AnsibleError):
self.lookup.run(["web-app-a"], variables=self.base_vars, mode="nope")
def test_www_prefix_falls_back_to_bare_domain(self):
out = self.lookup.run(["www.a.example"], variables=self.base_vars)[0]
self.assertEqual(out["application_id"], "web-app-a")
self.assertEqual(out["domain"], "a.example")
def test_www_prefix_with_unknown_bare_still_raises(self):
with self.assertRaises(AnsibleError) as ctx:
self.lookup.run(["www.unknown.example"], variables=self.base_vars)
self.assertIn("not found", str(ctx.exception))
def test_non_www_unregistered_still_raises(self):
with self.assertRaises(AnsibleError) as ctx:
self.lookup.run(["unknown.example"], variables=self.base_vars)
self.assertIn("not found", str(ctx.exception))
def test_app_term_family_aligned_for_clearnet_consumer(self):
v = dict(self.base_vars)
v["domains"] = {
**self.domains,
"web-svc-cdn": ["cdn.abc.onion", "cdn.example"],
}
v["application_id"] = "web-app-a"
out = self.lookup.run(["web-svc-cdn"], variables=v, mode="app")[0]
self.assertEqual(out["domain"], "cdn.example")
self.assertTrue(out["enabled"])
self.assertEqual(out["url"]["base"], "https://cdn.example/")
def test_app_term_onion_consumer_stays_onion(self):
v = dict(self.base_vars)
v["domains"] = {
**self.domains,
"web-svc-cdn": ["cdn.abc.onion", "cdn.example"],
"web-app-dashboard": ["dash.abc.onion"],
}
v["application_id"] = "web-app-dashboard"
out = self.lookup.run(["web-svc-cdn"], variables=v, mode="app")[0]
self.assertEqual(out["domain"], "cdn.abc.onion")
self.assertFalse(out["enabled"])
self.assertEqual(out["url"]["base"], "http://cdn.abc.onion/")
def test_domain_term_keeps_explicit_onion(self):
v = dict(self.base_vars)
v["domains"] = {
**self.domains,
"web-svc-cdn": ["cdn.abc.onion", "cdn.example"],
}
v["application_id"] = "web-app-a"
out = self.lookup.run(["cdn.abc.onion"], variables=v)[0]
self.assertEqual(out["domain"], "cdn.abc.onion")
self.assertFalse(out["enabled"])
def test_app_term_onion_only_target_falls_back(self):
v = dict(self.base_vars)
v["domains"] = {
**self.domains,
"web-svc-cdn": ["cdn.abc.onion"],
}
v["application_id"] = "web-app-a"
out = self.lookup.run(["web-svc-cdn"], variables=v, mode="app")[0]
self.assertEqual(out["domain"], "cdn.abc.onion")
self.assertFalse(out["enabled"])
def test_explicit_consumer_outranks_application_id(self):
class _Templar:
def template(self, value):
if value == "{{ _provider_role }}":
raise AssertionError("application_id must not be rendered")
return value
self.lookup._templar = _Templar()
v = dict(self.base_vars)
v["domains"] = {
**self.domains,
"web-svc-cdn": ["cdn.abc.onion", "cdn.example"],
}
v["application_id"] = "{{ _provider_role }}"
out = self.lookup.run(
["web-svc-cdn"], variables=v, mode="app", consumer="web-app-a"
)[0]
self.assertEqual(out["domain"], "cdn.example")
def test_term_with_unresolved_jinja_is_templated(self):
class _FakeTemplar:
def __init__(self, mapping):
self._mapping = mapping
self.calls = []
def template(self, value):
self.calls.append(value)
return self._mapping.get(value, value)
fake = _FakeTemplar({"{{ MY_DOMAIN }}": "a.example"})
self.lookup._templar = fake
out = self.lookup.run(["{{ MY_DOMAIN }}"], variables=self.base_vars)[0]
self.assertEqual(out["application_id"], "web-app-a")
self.assertEqual(out["domain"], "a.example")
self.assertIn("{{ MY_DOMAIN }}", fake.calls)
if __name__ == "__main__":
unittest.main()