diff --git a/CHANGELOG.md b/CHANGELOG.md index 92fe721..aaa2e1f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,12 @@ All notable changes to this driver. The format follows 3.12 venv no longer has. ### Fixed +- `configure_snmp_agent()` works on OPNsense 26.x again. The configure step sent + fields the os-net-snmp model does not have (`contact`, `location`, `sysobjid`, + `bindip`) and `listen` in the shape `get` returns rather than as a string, which + 26.x refuses with HTTP 500. It now sends `syscontact`/`syslocation`, and only when + the caller gives them, so an operator's sysContact and sysLocation are no longer + blanked (#36). - `get_arp_table()` and `get_ipv6_neighbors_table()` report an unknown age as `-1.0` (napalm-device-types' `ARP_AGE_UNKNOWN`). They reported `expires`, the seconds left until the entry expires, which is no age: an entry refreshed a second ago diff --git a/napalm_opnsense/opnsense.py b/napalm_opnsense/opnsense.py index 8d9a0b1..4769975 100644 --- a/napalm_opnsense/opnsense.py +++ b/napalm_opnsense/opnsense.py @@ -2438,6 +2438,8 @@ class OPNsenseDriver( #: old any-source rule is recognised by its older description. _SNMP_RULE_PREFIX = "napalm-opnsense: SNMP from " _SNMP_RULE_OLD = "[netork] Allow SNMP" + #: The caller's system values and the os-net-snmp fields they go to. + _SNMP_SYSTEM_FIELDS = {"contact": "syscontact", "location": "syslocation"} def _install_snmp_agent(self) -> FixStepOutcomeDict: # Installing over an installed os-net-snmp starts an async reinstall that @@ -2458,28 +2460,21 @@ class OPNsenseDriver( raise ValueError("the community must be one word without quotes or #") listen = settings.get("listen") or self.hostname try: - listen_val = {str(ipaddress.ip_address(listen)): {"selected": 1}} + listen_val = str(ipaddress.ip_address(listen)) except ValueError: - listen_val = {} # a DNS name binds nothing; snmpd then listens everywhere - result = self._post( - "/api/netsnmp/general/set", - { - "general": { - "enabled": "1", - "community": community, - "contact": settings.get("contact", ""), - "location": settings.get("location", ""), - "sysobjid": "", - "bindip": "", - "listen": listen_val, - } - }, - ) + listen_val = "" # a DNS name binds nothing; snmpd then listens everywhere + general = {"enabled": "1", "community": community, "listen": listen_val} + # Only what the caller gives: an empty one would blank the operator's. + for key, field in self._SNMP_SYSTEM_FIELDS.items(): + if settings.get(key): + general[field] = settings[key] + # The plugin's model refuses any field it does not have, with a 500 (#36). + result = self._post("/api/netsnmp/general/set", {"general": general}) if result.get("result") != "saved": return {"ok": False, "output": f"configuration refused: {result}"} return { "ok": True, - "output": f"community set, listen {list(listen_val) or 'all addresses'}", + "output": f"community set, listen {listen_val or 'all addresses'}", } def _allow_snmp_sources(self, settings: SnmpAgentSettingsDict) -> FixStepOutcomeDict: diff --git a/tests/unit/test_snmp_agent.py b/tests/unit/test_snmp_agent.py index 38f0154..d976edb 100644 --- a/tests/unit/test_snmp_agent.py +++ b/tests/unit/test_snmp_agent.py @@ -12,9 +12,25 @@ from __future__ import annotations from unittest.mock import MagicMock import pytest +import requests from napalm_opnsense.opnsense import OPNsenseDriver +#: The plugin's settings as OPNsense 26.7 serves them (gw-01, 2026-10-31). Its +#: model knows exactly these fields, and a set naming any other one, or giving a +#: field anything but a string, is a 500 (#36). +MODEL = { + "enabled": "0", + "community": "public", + "syslocation": "Home", + "syscontact": "admin@example.org", + "l3visibility": "1", + "versionoid": "1", + "enableagentx": "1", + "enableobservium": "1", + "listen": {"10.0.0.1": {"value": "10.0.0.1", "selected": 1}}, +} + SETTINGS = { "community": "c0mm", "allowed_sources": ["10.7.224.20", "10.7.225.0/24"], @@ -34,12 +50,15 @@ class _Api: def get(self, path): if path == "/api/netsnmp/general/get": - return {"general": {"enabled": "0"}} if self.installed else {} + return {"general": dict(MODEL)} if self.installed else {} raise AssertionError(path) def post(self, path, body=None): self.posts.append((path, body)) if path == "/api/netsnmp/general/set": + general = (body or {}).get("general", {}) + if any(k not in MODEL or not isinstance(v, str) for k, v in general.items()): + raise requests.HTTPError(f"500 Server Error: Internal Server Error for url: {path}") return {"result": self.saved} if path == "/api/firewall/filter/searchRule": return {"rows": self.rules} @@ -83,12 +102,24 @@ class TestTheCallersValues: assert result["success"] is True general = _body(api, "/api/netsnmp/general/set")["general"] assert general["enabled"] == "1" - assert (general["community"], general["contact"], general["location"]) == ( + assert (general["community"], general["syscontact"], general["syslocation"]) == ( "c0mm", "ops", "rack 1", ) - assert general["listen"] == {"10.0.0.1": {"selected": 1}} + assert general["listen"] == "10.0.0.1" + + def test_only_fields_the_plugins_model_has_are_sent(self, driver, api): + result = driver.configure_snmp_agent({**SETTINGS, "listen": "10.0.0.1"}) + + assert result["success"] is True + assert set(_body(api, "/api/netsnmp/general/set")["general"]) <= set(MODEL) + + def test_contact_and_location_the_caller_leaves_out_stay_as_they_are(self, driver, api): + driver.configure_snmp_agent({"community": "c0mm", "allowed_sources": []}) + + general = _body(api, "/api/netsnmp/general/set")["general"] + assert "syscontact" not in general and "syslocation" not in general def test_nothing_of_an_application_is_built_in(self, driver, api): driver.configure_snmp_agent({"community": "c0mm", "allowed_sources": []}) @@ -103,7 +134,7 @@ class TestTheCallersValues: d.configure_snmp_agent({"community": "c0mm", "allowed_sources": []}) - assert _body(api, "/api/netsnmp/general/set")["general"]["listen"] == {} + assert _body(api, "/api/netsnmp/general/set")["general"]["listen"] == "" def test_a_rejected_configuration_fails_the_fix(self, driver, api): api.saved = "failed"