Files
mesh-catalog/modules/nftables/module.json
T
jschoubben 83482a4513 nftables: allowances per machine, refused unproven or adopted, written in the hand-act log
The security and seams reviews of the packet filter's control verbs: the
allowances state is one bucket per machine whose keys carry the node, so a
holder lists and writes its own node's only; allow and disallow refuse an
unproven caller, an adopted node and a converged that does not answer within
10 s, and are written in the hand-act log before the state is; allow refuses a
port the loaded mesh table accepts from given sources only unless a source is
given, and more than the setting allowances-max; allowed answers none on an
adopted node and asks converged again while none answered; rules marks loaded
only on an equal at and lists loaded allowance comments nobody keeps. The event
is said through the seat's generated package; the claim says it, so emits
stays without it.

Builds: design 33 control-verbs §1-§11, §14; ADR 0683; design 47 H H-A-314 (3), (5), (6), H-A-315 (1)-(3), (5), (7), H-A-316, H-A-317, H-A-318, H-A-319
2026-11-21 20:52:34 +01:00

118 lines
2.4 KiB
JSON

{
"module": "nftables",
"version": "0.1",
"upgrade": {
"policy": "record",
"why": "the machine's packet filter: a build that breaks it can cut the machine off from the bus, and then neither the gate's rollback nor a push reaches it (hq ADR 0236)"
},
"capabilities": [
"firewall"
],
"claims": [
{
"name": "node-packet-filter",
"scope": "node",
"serves": [
"rules",
"reload",
"remove",
"allow",
"disallow",
"allowed"
]
}
],
"requires": [
{
"name": "allowances",
"storage": "key-value",
"template": "state",
"options": {
"history": 1,
"per-machine": true
}
}
],
"invokes": [
"seat:node-engine.converged",
"seat:mesh-hand-acts.hand-act"
],
"filtering": {
"into": "/etc/nftables.conf"
},
"resources": [
{
"id": "package",
"type": "package",
"package": "nftables"
},
{
"id": "legacy-tools",
"type": "package",
"package": "iptables"
},
{
"id": "unit",
"type": "file",
"path": "/etc/systemd/system/mesh-filter.service",
"template": "files/mesh-filter.service",
"mode": "0644"
},
{
"id": "stock-unit-stop",
"type": "file",
"path": "/etc/systemd/system/nftables.service.d/mesh.conf",
"template": "files/mesh.conf",
"mode": "0644"
},
{
"id": "load",
"type": "service",
"unit": "mesh-filter.service",
"state": "running",
"boot": "enabled",
"restart-on": [
"unit",
"stock-unit-stop"
],
"reload-on": [
"filtering"
]
},
{
"id": "front-end",
"type": "package",
"package": "ufw",
"absent": true
}
],
"tools": [
"firewall_rules"
],
"config": {
"allowances-max": {
"type": "number",
"description": "The most allowances this machine keeps, which allow refuses past (design 33 control-verbs §3): it keeps the rendered chain readable and allowed in one answer.",
"trusted": false,
"default": 100
}
},
"build": {
"artifacts": [
{
"name": "tools",
"kind": "bundle",
"language": "typescript",
"entrypoints": [
"tools/index.js"
]
},
{
"name": "files",
"kind": "archive",
"from": "files"
}
]
}
}