@takodotid/circuit 0.34.0 → 0.34.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -33,10 +33,6 @@ var AMPLIFIERS = {
33
33
  };
34
34
  var ASKED = new Set([AMPLIFIERS.dns, AMPLIFIERS.ntp, AMPLIFIERS.snmp]);
35
35
  function antiAmplification(destinations, options = {}) {
36
- const below1024Except = (port) => [
37
- { min: 0, max: port - 1 },
38
- { min: port + 1, max: 1023 }
39
- ];
40
36
  return destinations.flatMap((dst) => [
41
37
  ...(options.keep_fragments ?? []).filter((prefix) => contains2(dst, prefix)).map((prefix) => ({
42
38
  description: `UDP fragments to ${prefix} kept`,
@@ -44,11 +40,18 @@ function antiAmplification(destinations, options = {}) {
44
40
  action: "accept"
45
41
  })),
46
42
  { description: `UDP fragments to ${dst}`, match: { protocol: "udp", dst, src_port: 0 }, action: "drop" },
47
- ...Object.entries(AMPLIFIERS).map(([name, port]) => ({
48
- description: ASKED.has(port) ? `UDP to ${dst} from ${name}, to a port below 1024` : `UDP to ${dst} from ${name}`,
49
- match: { protocol: "udp", dst, src_port: port, ...ASKED.has(port) ? { dst_port: below1024Except(port) } : {} },
50
- action: "drop"
51
- }))
43
+ ...Object.entries(AMPLIFIERS).flatMap(([name, port]) => ASKED.has(port) ? [
44
+ {
45
+ description: `UDP to ${dst} from ${name}, between two servers`,
46
+ match: { protocol: "udp", dst, src_port: port, dst_port: port },
47
+ action: "accept"
48
+ },
49
+ {
50
+ description: `UDP to ${dst} from ${name}, to a port below 1024`,
51
+ match: { protocol: "udp", dst, src_port: port, dst_port: { min: 0, max: 1023 } },
52
+ action: "drop"
53
+ }
54
+ ] : [{ description: `UDP to ${dst} from ${name}`, match: { protocol: "udp", dst, src_port: port }, action: "drop" }])
52
55
  ]);
53
56
  }
54
57
  var BAD_TCP_FLAGS = [
@@ -37,7 +37,7 @@ export type AntiAmplificationOptions = {
37
37
  * Hardware ACL rules dropping reflected UDP floods toward `destinations`, in the switch chip, without limiting anything else.
38
38
  *
39
39
  * - Replies from an amplifier no host asks across the internet are dropped.
40
- * - Replies from DNS, NTP and SNMP are dropped only toward a port below 1024 that is not the service's own. A host that runs its own resolver, time server or monitoring keeps its answers.
40
+ * - Replies from DNS, NTP and SNMP are dropped only toward a port below 1024 that is not the service's own. A host that runs its own resolver, time server or monitoring keeps its answers. The service's own port passes first, so every drop takes the one range 0 to 1023: a switch chip has few port-range checkers, and on RouterOS a rule past them is invalid with every rule after it.
41
41
  * - The fragments after the first carry no port, and a switch chip reads them as port 0. They are dropped, but toward `keep_fragments`.
42
42
  */
43
43
  export declare function antiAmplification(destinations: readonly Prefix[], options?: AntiAmplificationOptions): AclRule<never>[];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@takodotid/circuit",
3
- "version": "0.34.0",
3
+ "version": "0.34.1",
4
4
  "description": "Declarative, vendor-neutral network configuration: describe each device in TypeScript, and Circuit makes the device match. Alpha.",
5
5
  "keywords": [
6
6
  "network",
@@ -44,3 +44,5 @@ Behaviour that looks like something else. Each one has been hit on a real device
44
44
  - On the serial console, the prompt can come twice after a login. The console echoes a long command wrapped at 80 columns, and a `print` that fills the screen stops at `-- [Q quit|D dump|down]`, where `D` prints the rest.
45
45
  - Every VLAN interface on the bridge has the bridge's MAC, and the bridge keeps a frame to that MAC on whatever VLAN it arrives. A gateway in front of a transparent firewall then never gets its replies: they come back on the inside VLAN and stop at the bridge. A MACVLAN on the VLAN interface gives the gateway a MAC of its own, and its replies cross the firewall back; proved with a FortiGate 3700D in transparent mode, the session offloaded to its NP6.
46
46
  - A second VLAN interface with the same VLAN ID on the same interface is refused, `already have such vlan`, so a VLAN interface is known by its interface and VLAN ID, and a new name is a rename.
47
+ - A switch rule the chip cannot hold is flagged `I`, invalid, and every rule after it is invalid too, with no log line. On a CCR2216 (98DX8525, 7.23) it came at the sixth distinct `dst-port` range, with 66 rules in all, far below the 1,024 MikroTik lists: the amplifier drops toward every VLAN after it did nothing. Few distinct ranges, and check `print count-only where invalid` after an apply.
48
+ - A MACVLAN on a VLAN interface is not routed in the switch chip: its connected route never takes the `H` flag, even with `l3-hw-offloading=yes` on the VLAN under it.
@@ -54,15 +54,10 @@ export type AntiAmplificationOptions = {
54
54
  * Hardware ACL rules dropping reflected UDP floods toward `destinations`, in the switch chip, without limiting anything else.
55
55
  *
56
56
  * - Replies from an amplifier no host asks across the internet are dropped.
57
- * - Replies from DNS, NTP and SNMP are dropped only toward a port below 1024 that is not the service's own. A host that runs its own resolver, time server or monitoring keeps its answers.
57
+ * - Replies from DNS, NTP and SNMP are dropped only toward a port below 1024 that is not the service's own. A host that runs its own resolver, time server or monitoring keeps its answers. The service's own port passes first, so every drop takes the one range 0 to 1023: a switch chip has few port-range checkers, and on RouterOS a rule past them is invalid with every rule after it.
58
58
  * - The fragments after the first carry no port, and a switch chip reads them as port 0. They are dropped, but toward `keep_fragments`.
59
59
  */
60
60
  export function antiAmplification(destinations: readonly Prefix[], options: AntiAmplificationOptions = {}): AclRule<never>[] {
61
- const below1024Except = (port: number) => [
62
- { min: 0, max: port - 1 },
63
- { min: port + 1, max: 1023 },
64
- ];
65
-
66
61
  return destinations.flatMap((dst) => [
67
62
  ...(options.keep_fragments ?? [])
68
63
  .filter((prefix) => contains(dst, prefix))
@@ -72,11 +67,22 @@ export function antiAmplification(destinations: readonly Prefix[], options: Anti
72
67
  action: "accept",
73
68
  })),
74
69
  { description: `UDP fragments to ${dst}`, match: { protocol: "udp", dst, src_port: 0 }, action: "drop" },
75
- ...Object.entries(AMPLIFIERS).map(([name, port]): AclRule<never> => ({
76
- description: ASKED.has(port) ? `UDP to ${dst} from ${name}, to a port below 1024` : `UDP to ${dst} from ${name}`,
77
- match: { protocol: "udp", dst, src_port: port, ...(ASKED.has(port) ? { dst_port: below1024Except(port) } : {}) },
78
- action: "drop",
79
- })),
70
+ ...Object.entries(AMPLIFIERS).flatMap(([name, port]): AclRule<never>[] =>
71
+ ASKED.has(port)
72
+ ? [
73
+ {
74
+ description: `UDP to ${dst} from ${name}, between two servers`,
75
+ match: { protocol: "udp", dst, src_port: port, dst_port: port },
76
+ action: "accept",
77
+ },
78
+ {
79
+ description: `UDP to ${dst} from ${name}, to a port below 1024`,
80
+ match: { protocol: "udp", dst, src_port: port, dst_port: { min: 0, max: 1023 } },
81
+ action: "drop",
82
+ },
83
+ ]
84
+ : [{ description: `UDP to ${dst} from ${name}`, match: { protocol: "udp", dst, src_port: port }, action: "drop" }]
85
+ ),
80
86
  ]);
81
87
  }
82
88