"""Firewall (firewalld) management API blueprint. Exposed at /api/firewall/* and delegates all operations to vacuum-walld. """ import logging from flask import Blueprint, request from daemon.client import BadRequest, NotFound, delete, get, patch, post from webui.api.common import _error, _ok logger = logging.getLogger(__name__) bp = Blueprint("firewall", __name__) # --------------------------------------------------------------------------- # Declarative config (two-step: save -> apply) # --------------------------------------------------------------------------- @bp.route("/config", methods=["GET"]) def config_list(): try: return _ok(get("/firewall/config")) except RuntimeError as exc: logger.error("Failed to read firewall config: %s", exc) return _error(str(exc), 500) @bp.route("/config", methods=["POST"]) def config_save(): body = request.get_json(silent=True) or {} if "zones" not in body: return _error("'zones' key is required", 400) if not isinstance(body["zones"], dict): return _error("'zones' must be a dict", 400) try: post("/firewall/config", body) try: pending = get("/firewall/config/pending") pending_data = { "pending": pending.get("pending", []), "needs_apply": pending.get("needs_apply", False), "unmanaged_zones": pending.get("unmanaged_zones", {}), } except RuntimeError as exc: pending_data = None logger.warning("Failed to read pending state after config save: %s", exc) logger.info("Firewall config saved (%d zones)", len(body["zones"])) return _ok( { "config_saved": True, **(pending_data or {}), } ) except BadRequest as exc: logger.info("Firewall config save rejected: %s", exc) return _error(str(exc), 400) except RuntimeError as exc: logger.error("Failed to save firewall config: %s", exc) return _error(str(exc), 500) @bp.route("/config", methods=["PATCH"]) def patch_config(): body = request.get_json(silent=True) or {} if not isinstance(body, dict): return _error("Request body must be a JSON object", 400) try: patch("/firewall/config", body) try: pending = get("/firewall/config/pending") pending_data = { "pending": pending.get("pending", []), "needs_apply": pending.get("needs_apply", False), "unmanaged_zones": pending.get("unmanaged_zones", {}), } except RuntimeError as exc: pending_data = None logger.warning("Failed to read pending state after config patch: %s", exc) return _ok( { "config_saved": True, **(pending_data or {}), } ) except BadRequest as exc: logger.info("Firewall config patch rejected: %s", exc) return _error(str(exc), 400) except RuntimeError as exc: logger.error("Failed to patch firewall config: %s", exc) return _error(str(exc), 500) @bp.route("/config/apply", methods=["POST"]) def config_apply_bp(): try: result = post("/firewall/config/apply") logger.info("Firewall config applied: %s", result.get("applied_zones", [])) return _ok(result) except RuntimeError as exc: logger.error("Failed to apply firewall config: %s", exc) return _error(str(exc), 500) @bp.route("/config/pending", methods=["GET"]) def config_pending_bp(): try: return _ok(get("/firewall/config/pending")) except RuntimeError as exc: logger.error("Failed to check pending config: %s", exc) return _error(str(exc), 500) # --------------------------------------------------------------------------- # Zones # --------------------------------------------------------------------------- @bp.route("/zones", methods=["GET"]) def list_zones(): try: data = get("/firewall/zones") return _ok( {"active": data.get("active", {}), "available": data.get("available", [])} ) except RuntimeError as exc: logger.error("Failed to list zones: %s", exc) return _error(str(exc), 500) @bp.route("/zones/", methods=["GET"]) def zone_details(name: str): try: info = get("/firewall/zones/info", {"zone": name}) return _ok(info) except NotFound as exc: logger.info("Zone '%s' not found: %s", name, exc) return _error(str(exc), 404) except RuntimeError as exc: logger.error("Failed to get zone '%s' info: %s", name, exc) return _error(str(exc), 500) @bp.route("/zones", methods=["POST"]) def create_zone_bp(): body = request.get_json(silent=True) or {} zone_name = body.get("name", "").strip() target = body.get("target", "default").strip() or "default" if not zone_name: return _error("Zone name is required", 400) try: post("/firewall/zones/create", {"name": zone_name, "target": target}) logger.info("Zone '%s' created via API", zone_name) return _ok(None) except BadRequest as exc: logger.info("Zone '%s' creation rejected: %s", zone_name, exc) return _error(str(exc), 400) except RuntimeError as exc: logger.error("Failed to create zone '%s': %s", zone_name, exc) return _error(str(exc), 500) @bp.route("/zones/", methods=["DELETE"]) def delete_zone_bp(name: str): try: delete("/firewall/zones/delete", {"zone": name}) logger.info("Zone '%s' deleted via API", name) return _ok(None) except NotFound as exc: logger.info("Zone '%s' not found: %s", name, exc) return _error(str(exc), 404) except RuntimeError as exc: logger.error("Failed to delete zone '%s': %s", name, exc) return _error(str(exc), 500) # --------------------------------------------------------------------------- # Zone interfaces # --------------------------------------------------------------------------- @bp.route("/zones//interfaces", methods=["POST"]) def set_zone_interfaces_bp(name: str): body = request.get_json(silent=True) or {} interfaces = body.get("interfaces", []) if not isinstance(interfaces, list): return _error("'interfaces' must be a list", 400) try: post("/firewall/zones/interfaces", {"zone": name, "interfaces": interfaces}) logger.info("Zone '%s' interfaces updated: %s", name, interfaces) return _ok({"zone": name, "interfaces": interfaces}) except BadRequest as exc: logger.info("Set interfaces for zone '%s' rejected: %s", name, exc) return _error(str(exc), 400) except NotFound as exc: logger.info("Zone '%s' not found: %s", name, exc) return _error(str(exc), 404) except RuntimeError as exc: logger.error("Failed to set interfaces for zone '%s': %s", name, exc) return _error(str(exc), 500) # --------------------------------------------------------------------------- # Zone services # --------------------------------------------------------------------------- @bp.route("/zones//services", methods=["POST"]) def set_zone_services_bp(name: str): body = request.get_json(silent=True) or {} services = body.get("services", []) if not isinstance(services, list): return _error("'services' must be a list", 400) try: post("/firewall/zones/services", {"zone": name, "services": services}) return _ok({"zone": name, "services": services}) except BadRequest as exc: logger.info("Set services for zone '%s' rejected: %s", name, exc) return _error(str(exc), 400) except NotFound as exc: logger.info("Zone '%s' not found: %s", name, exc) return _error(str(exc), 404) except RuntimeError as exc: logger.error("Failed to set services for zone '%s': %s", name, exc) return _error(str(exc), 500) # --------------------------------------------------------------------------- # Available services and interfaces # --------------------------------------------------------------------------- @bp.route("/services", methods=["GET"]) def list_services(): try: return _ok(get("/firewall/services")) except RuntimeError as exc: logger.error("Failed to list services: %s", exc) return _error(str(exc), 500) @bp.route("/interfaces", methods=["GET"]) def list_interfaces(): try: return _ok(get("/firewall/interfaces")) except RuntimeError as exc: logger.error("Failed to list interfaces: %s", exc) return _error(str(exc), 500) # --------------------------------------------------------------------------- # Rich rules # --------------------------------------------------------------------------- @bp.route("/rich-rules", methods=["POST"]) def add_rich_rule_bp(): body = request.get_json(silent=True) or {} zone = body.get("zone", "").strip() rule = body.get("rule", "").strip() if not zone or not rule: return _error("Both 'zone' and 'rule' are required", 400) try: entry = post("/firewall/rich-rules/add", {"zone": zone, "rule": rule}) logger.info("Rich rule added to zone '%s': %s", zone, rule[:80]) return _ok({"zone": zone, "id": entry["id"], "rule": rule}) except BadRequest as exc: logger.info("Add rich rule for zone '%s' rejected: %s", zone, exc) return _error(str(exc), 400) except RuntimeError as exc: logger.error("Failed to add rich rule to zone '%s': %s", zone, exc) return _error(str(exc), 500) @bp.route("/rich-rules/", methods=["GET"]) def list_rich_rules(zone: str): try: return _ok(get("/firewall/rich-rules", {"zone": zone})) except RuntimeError as exc: logger.error("Failed to get rich rules for zone '%s': %s", zone, exc) return _error(str(exc), 500) @bp.route("/rich-rules//", methods=["DELETE"]) def remove_rich_rule_bp(zone: str, rule_id: str): try: delete("/firewall/rich-rules/remove", {"zone": zone, "id": rule_id}) logger.info("Rich rule '%s' removed from zone '%s'", rule_id, zone) return _ok({"zone": zone, "id": rule_id}) except NotFound as exc: logger.info("Rich rule '%s' not found in zone '%s': %s", rule_id, zone, exc) return _error(str(exc), 404) except RuntimeError as exc: logger.error("Failed to remove rich rule from zone '%s': %s", zone, exc) return _error(str(exc), 500) # --------------------------------------------------------------------------- # Masquerade (NAT) # --------------------------------------------------------------------------- @bp.route("/masquerade", methods=["POST"]) def set_masquerade_bp(): body = request.get_json(silent=True) or {} zone = body.get("zone", "").strip() enable = body.get("enable") if not zone or enable is None: return _error("'zone' and 'enable' (bool) are required", 400) try: post("/firewall/masquerade", {"zone": zone, "enable": bool(enable)}) logger.info( "Masquerade %s on zone '%s' via API", "enabled" if enable else "disabled", zone, ) return _ok({"zone": zone, "masquerade": bool(enable)}) except BadRequest as exc: logger.info("Set masquerade for zone '%s' rejected: %s", zone, exc) return _error(str(exc), 400) except RuntimeError as exc: logger.error("Failed to set masquerade on zone '%s': %s", zone, exc) return _error(str(exc), 500) # --------------------------------------------------------------------------- # Port forwarding # --------------------------------------------------------------------------- @bp.route("/forward-port", methods=["POST"]) def add_forward_port_bp(): body = request.get_json(silent=True) or {} zone = body.get("zone", "").strip() port = body.get("port") proto = body.get("proto", "").strip() toaddr = body.get("toaddr") toport = body.get("toport") if not zone or port is None or not proto: return _error("'zone', 'port', and 'proto' are required", 400) try: port_int = int(port) except ValueError: return _error("'port' must be an integer", 400) toport_int = None if toport is not None: try: toport_int = int(toport) except ValueError: return _error("'toport' must be an integer", 400) toaddr_str = str(toaddr) if toaddr else None try: entry = post( "/firewall/forward-port/add", { "zone": zone, "port": port_int, "proto": proto, "toaddr": toaddr_str, "toport": toport_int, }, ) return _ok({"zone": zone, "id": entry["id"], "port": port_int, "proto": proto}) except BadRequest as exc: logger.info("Add forward port rejected: %s", exc) return _error(str(exc), 400) except RuntimeError as exc: logger.error("Failed to add forward port: %s", exc) return _error(str(exc), 500) @bp.route("/forward-port///", methods=["DELETE"]) def remove_forward_port_bp(zone: str, port: int, proto: str): try: delete( "/firewall/forward-port/remove", {"zone": zone, "port": port, "proto": proto}, ) logger.info("Forward port %s/%s removed from zone '%s'", port, proto, zone) return _ok({"zone": zone, "port": port, "proto": proto}) except NotFound as exc: logger.info( "Forward port %s/%s not found in zone '%s': %s", port, proto, zone, exc ) return _error(str(exc), 404) except RuntimeError as exc: logger.error("Failed to remove forward port from zone '%s': %s", zone, exc) return _error(str(exc), 500)