julian.kiedaisch/mdg-filius
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: F4.6g3 a computer's firewall window, measured against Java's with traffic from two networks

Browse Source 
The firewall-pc scenario and FirewallWindowRun use Java's window as a person
does and send a ping, a TCP connection and a DNS question from the server's
network and from behind the router after each step. The core adds and
removes port rules (personalFirewall.ts) and writes both into the firewall's
log, which now carries each line's time; the room takes the window's
actions and sends its view and the log as lines; the editor shows Java's
window with its two tabs. Not adopted from Java: any integer as a port,
a port after a space refused without a word, a log one can type into.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
julian.kiedaisch
2026-10-03 21:18:05 +00:00
co-authored by Claude Opus 5.5
parent 065b42430d
commit 2b85e7432c
25 changed files with 2092 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/core/src/index.ts
+1
View File
@@ -26,6 +26,7 @@ export * from './runtime/apps/dnsServer.js';
export * from './runtime/apps/web.js';
export * from './runtime/apps/routerPages.js';
export * from './runtime/apps/firewallSettings.js';
export * from './runtime/apps/personalFirewall.js';
export * from './runtime/apps/emailServer.js';
export * from './runtime/apps/emailClient.js';
export * from './runtime/apps/filePrograms.js';
packages/core/src/runtime/apps/personalFirewall.ts
+49
View File
@@ -0,0 +1,49 @@
// A computer's firewall as its window changes it, after Java's
// GUIApplicationFirewallWindow (measured with tools/java-oracle's
// FirewallWindowRun): a port rule added — the port opened for TCP, UDP or
// both, for all senders or only those of the computer's networks — and a
// rule removed. The three boxes are the configuration's fields; what the
// firewall does with a packet is the engine's (evaluateFirewall), as for a
// router.
//
// Departures from Java (firewallWindow.test.ts names each):
// - a port is 1 to 65535, spaces around it allowed. Java takes any int:
// -1 opens every port of both protocols (the table shows no port), 0 or
// 70000 make a rule that never matches; and refuses " 80" without a word.
import { DIRECTLY_CONNECTED_SOURCE_MARKER, firewallRule, type FirewallConfiguration, type FirewallProtocol, type FirewallRule } from '../config.js';
/** The protocols of the window's list: TCP, UDP, "*" for both. */
export type PortRuleProtocol = Exclude<FirewallProtocol, 'icmp'>;
/** The port typed, as the window takes it: 1 to 65535; undefined for anything else. */
export function firewallPortOfText(text: string): number | undefined {
const trimmed = text.trim();
if (!/^[0-9]+$/.test(trimmed)) return undefined;
const port = Number(trimmed);
return port >= 1 && port <= 65_535 ? port : undefined;
}
/** "Hinzufügen" (hinzuRegel): a rule accepting the port, at the end; Java's FirewallRule("", "", "", "", port, protocol, ACCEPT). */
export function withPortRule(configuration: FirewallConfiguration, port: number, protocol: PortRuleProtocol, sameNetworkOnly: boolean): FirewallConfiguration {
const rule = firewallRule({ port, protocol, action: 'accept', sourceIPAddress: sameNetworkOnly ? DIRECTLY_CONNECTED_SOURCE_MARKER : '' });
return { ...configuration, rules: [...configuration.rules, rule] };
}
/** "Löschen" (loescheRegel): the rule chosen; undefined when there is none at that row. */
export function withoutRule(configuration: FirewallConfiguration, index: number): FirewallConfiguration | undefined {
if (!Number.isInteger(index) || index < 0 || index >= configuration.rules.length) return undefined;
return { ...configuration, rules: configuration.rules.filter((_, each) => each !== index) };
}
/**
* How the window's table shows a rule: Java's sender column, or none for a
* rule the window cannot make (one from a file that drops, or names an
* address; a mask without its address counts for nothing). Java shows such a
* rule as a port opened for all senders.
*/
export function portRuleSender(rule: FirewallRule): 'all' | 'sameNetwork' | undefined {
if (rule.action !== 'accept' || rule.destinationIPAddress !== '') return undefined;
if (rule.sourceIPAddress === '') return 'all';
return rule.sourceIPAddress === DIRECTLY_CONNECTED_SOURCE_MARKER ? 'sameNetwork' : undefined;
}
packages/core/src/runtime/apps/routerPages.ts
+19 -3
View File
@@ -11,6 +11,7 @@
import type { FirewallRule } from '../config.js';
import type { FirewallLogEntry } from '../engine.js';
import type { PortRuleProtocol } from './personalFirewall.js';
import { formatIPv4, maskAddress, parseIPv4 } from '../ipv4.js';
import type { RouteRow } from '../routeTable.js';
import { DIRECTLY_CONNECTED_SOURCE_MARKER } from '../config.js';
@@ -40,6 +41,8 @@ interface PageTexts {
readonly logBody: string;
readonly ruleMatched: string;
readonly icmpDropped: string;
readonly portRuleAdded: string;
readonly portRuleRemoved: string;
readonly accept: string;
readonly drop: string;
readonly ripHint: string;
@@ -57,6 +60,9 @@ const TEXTS: Record<PageLanguage, PageTexts> = {
/** sw_firewall_msg8, firewallthread_msg1, jfirewalldialog_msg33, msg34. */
ruleMatched: 'Firewall-Regel hat gegriffen:',
icmpDropped: 'ICMP-Paket verworfen:',
/** sw_firewall_msg5, msg7: a computer's window writes them (no router has one). */
portRuleAdded: 'Portregel wurde hinzugefügt:',
portRuleRemoved: 'Portregel wurde entfernt.',
accept: 'akzeptieren',
drop: 'verwerfen',
/** sw_vermittlungweb_msg1, msg3, msg4, msg5, msg6. */
@@ -71,6 +77,8 @@ const TEXTS: Record<PageLanguage, PageTexts> = {
logBody: '\n\t</head>\n\t<body>\n\t\t<h2>Log-data set entry of the firewall</h2>',
ruleMatched: 'Firewall rule matched:',
icmpDropped: 'Dropped ICMP packet:',
portRuleAdded: 'Port rule is added:',
portRuleRemoved: 'Delete port rule.',
accept: 'accept',
drop: 'drop',
ripHint: 'This table is generated and updated by the Routing Information Protocol (RIP).',
@@ -113,11 +121,19 @@ export function firewallRuleText(rule: FirewallRule, firstInterface: { readonly
return text + (rule.action === 'accept' ? 'ACCEPT' : 'DROP');
}
/** A line of the firewall's log, as Firewall tells its observers. */
/** The window's protocol list (GUIApplicationFirewallWindow): its items name a port rule in the log. */
export const PORT_RULE_PROTOCOL_NAMES: Readonly<Record<PortRuleProtocol, string>> = { tcp: 'TCP', udp: 'UDP', all: '*' };
/** A line of the firewall's log, as Firewall tells its observers (and a computer's window writes). */
export function firewallLogText(entry: FirewallLogEntry, language: PageLanguage): string {
const texts = TEXTS[language];
if (entry.kind === 'icmpDropped') {
return `${texts.icmpDropped} ${entry.senderIPAddress} -> ${entry.receiverIPAddress} (code: ${entry.code}, type: ${entry.type})`;
switch (entry.kind) {
case 'icmpDropped':
return `${texts.icmpDropped} ${entry.senderIPAddress} -> ${entry.receiverIPAddress} (code: ${entry.code}, type: ${entry.type})`;
case 'portRuleAdded':
return `${texts.portRuleAdded} ${entry.port}/${PORT_RULE_PROTOCOL_NAMES[entry.protocol]}`;
case 'portRuleRemoved':
return texts.portRuleRemoved;
}
return `${texts.ruleMatched} #${entry.ruleNumber} (${firewallRuleText(entry.rule, entry.firstInterface)}) -> ${firewallActionText(entry.accepted ? 'accept' : 'drop', language)}`;
}
packages/core/src/runtime/engine.ts
+38 -8
View File
@@ -124,6 +124,8 @@ import { EmailServer } from './apps/emailServer.js';
import { Terminal } from './apps/terminal.js';
import { firewallLogPage, forwardingTablePage, ripTablePage, routerIndexPage } from './apps/routerPages.js';
import { applyFirewallSettings, firewallSettingsPage } from './apps/firewallSettings.js';
import { withoutRule, withPortRule, type PortRuleProtocol } from './apps/personalFirewall.js';
import type { LogLine } from './apps/program.js';
import { parentPath, VirtualFileSystem } from '../model/virtualFileSystem.js';
import { clientAccountFileText, EMAIL_CLIENT_ACCOUNT_FILE, EMAIL_SERVER_ACCOUNTS_FILE, serverAccountsFileText } from './emailAccountsFile.js';
import { GNUTELLA_FOLDER, GnutellaPeer } from './apps/gnutella.js';
@@ -320,10 +322,11 @@ export interface FirewallDecision {
/**
* A line of a firewall's log (Firewall.benachrichtigeBeobachter, shown by
* the router's page "log"): a rule that matched a TCP or UDP packet, with
* the node's first interface (the rule's text names its network for "any
* directly connected network"), or an ICMP packet dropped by the general
* setting.
* the router's page "log" and a computer's firewall window): a rule that
* matched a TCP or UDP packet, with the node's first interface (the rule's
* text names its network for "any directly connected network"), or an ICMP
* packet dropped by the general setting; and, from a computer's window
* (Java writes them into the window only), a port rule added or removed.
*/
export type FirewallLogEntry =
| {
@@ -333,7 +336,9 @@ export type FirewallLogEntry =
readonly firstInterface: { readonly ipAddress: string; readonly subnetMask: string } | undefined;
readonly accepted: boolean;
}
| { readonly kind: 'icmpDropped'; readonly senderIPAddress: string; readonly receiverIPAddress: string; readonly type: number; readonly code: number };
| { readonly kind: 'icmpDropped'; readonly senderIPAddress: string; readonly receiverIPAddress: string; readonly type: number; readonly code: number }
| { readonly kind: 'portRuleAdded'; readonly port: number; readonly protocol: PortRuleProtocol }
| { readonly kind: 'portRuleRemoved' };
export type RuntimePhase = 'stopped' | 'running';
@@ -945,7 +950,7 @@ export class NetworkRuntimeEngine {
/** The time of day a program writes into a mail (Java's new Date()). */
private readonly wallClock: () => number;
/** Each node's firewall log; it outlives a stop and a new start, as Java's log page does. */
private readonly firewallLogsByNodeId = new Map<Id, FirewallLogEntry[]>();
private readonly firewallLogsByNodeId = new Map<Id, LogLine<FirewallLogEntry>[]>();
/** Accepted connections a program has taken (acceptTcpSteps). */
private readonly handedOutTcpSocketIds = new Set<Id>();
private nextApplicationWakeId = 1;
@@ -1127,12 +1132,12 @@ export class NetworkRuntimeEngine {
}
/** The node's firewall log, since the engine was made. */
firewallLog(nodeId: Id): readonly FirewallLogEntry[] {
firewallLog(nodeId: Id): readonly LogLine<FirewallLogEntry>[] {
return this.firewallLogsByNodeId.get(nodeId) ?? [];
}
private logFirewall(nodeId: Id, entry: FirewallLogEntry): void {
getOrCreate(this.firewallLogsByNodeId, nodeId, () => []).push(entry);
getOrCreate(this.firewallLogsByNodeId, nodeId, () => []).push({ ...entry, timeMilliseconds: this.stateValue.currentTimeMilliseconds });
}
/** Firewall.notifyRuleApplication. */
@@ -5615,6 +5620,31 @@ export class NetworkRuntimeEngine {
return this.stateValue.topologySnapshot.firewallConfigurationsByNodeId.get(nodeId) ?? firewallConfiguration();
}
/** A computer's firewall, when it has one installed (a router's is no program; its page changes it). */
personalFirewall(nodeId: Id): FirewallConfiguration | undefined {
const node = this.nodeSnapshot(nodeId);
return node !== undefined && isPcClassEndpoint(node.kind) ? this.stateValue.topologySnapshot.firewallConfigurationsByNodeId.get(nodeId) : undefined;
}
/** The window's "Hinzufügen": the port opened, written into its log; false for a computer without a firewall. */
addFirewallPortRule(nodeId: Id, port: number, protocol: PortRuleProtocol, sameNetworkOnly: boolean): boolean {
const configuration = this.personalFirewall(nodeId);
if (configuration === undefined) return false;
this.setFirewallConfiguration(nodeId, withPortRule(configuration, port, protocol, sameNetworkOnly));
this.logFirewall(nodeId, { kind: 'portRuleAdded', port, protocol });
return true;
}
/** The window's "Löschen": the rule of that row removed, written into its log; false when there is none. */
removeFirewallRule(nodeId: Id, index: number): boolean {
const configuration = this.personalFirewall(nodeId);
const changed = configuration === undefined ? undefined : withoutRule(configuration, index);
if (changed === undefined) return false;
this.setFirewallConfiguration(nodeId, changed);
this.logFirewall(nodeId, { kind: 'portRuleRemoved' });
return true;
}
setFirewallConfiguration(nodeId: Id, configuration: FirewallConfiguration): void {
const configurations = new Map(this.stateValue.topologySnapshot.firewallConfigurationsByNodeId);
configurations.set(nodeId, configuration);
packages/core/test/firewallWindow.java.json
+620
View File
@@ -0,0 +1,620 @@
{
"steps": [
{
"step": "open",
"traffic": {
"local": {
"ping": "ICMP 0/0 from 10.0.0.10",
"tcp": "TimeOutException: Zeitüberschreitung beim Verbindungsaufbau",
"dns": "TimeOutException"
},
"remote": {
"ping": "ICMP 0/0 from 10.0.0.10",
"tcp": "TimeOutException: Zeitüberschreitung beim Verbindungsaufbau",
"dns": "TimeOutException"
}
},
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": true,
"enabled": true
},
"udp": {
"selected": true,
"enabled": true
},
"port": "",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [],
"log": "",
"logEditable": true
},
{
"step": "add port abc",
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": true,
"enabled": true
},
"udp": {
"selected": true,
"enabled": true
},
"port": "abc",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [],
"log": "",
"logEditable": true
},
{
"step": "add an empty port",
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": true,
"enabled": true
},
"udp": {
"selected": true,
"enabled": true
},
"port": "",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [],
"log": "",
"logEditable": true
},
{
"step": "add 55555 TCP for all senders",
"traffic": {
"local": {
"ping": "ICMP 0/0 from 10.0.0.10",
"tcp": "connected",
"dns": "TimeOutException"
},
"remote": {
"ping": "ICMP 0/0 from 10.0.0.10",
"tcp": "connected",
"dns": "TimeOutException"
}
},
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": true,
"enabled": true
},
"udp": {
"selected": true,
"enabled": true
},
"port": "",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\n",
"logEditable": true
},
{
"step": "add 53 UDP for the same network",
"traffic": {
"local": {
"ping": "ICMP 0/0 from 10.0.0.10",
"tcp": "connected",
"dns": "10.0.0.10"
},
"remote": {
"ping": "ICMP 0/0 from 10.0.0.10",
"tcp": "connected",
"dns": "TimeOutException"
}
},
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": true,
"enabled": true
},
"udp": {
"selected": true,
"enabled": true
},
"port": "",
"protocol": "UDP",
"sender": "Absender im gleichen Rechnernetz",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
],
[
"UDP",
"53",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\n",
"logEditable": true
},
{
"step": "ICMP no longer allowed",
"traffic": {
"local": {
"ping": "null",
"tcp": "connected",
"dns": "10.0.0.10"
},
"remote": {
"ping": "null",
"tcp": "connected",
"dns": "TimeOutException"
}
},
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": true,
"enabled": true
},
"port": "",
"protocol": "UDP",
"sender": "Absender im gleichen Rechnernetz",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
],
[
"UDP",
"53",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\n",
"logEditable": true
},
{
"step": "UDP filter off",
"traffic": {
"local": {
"ping": "null",
"tcp": "connected",
"dns": "10.0.0.10"
},
"remote": {
"ping": "null",
"tcp": "connected",
"dns": "10.0.0.10"
}
},
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": false,
"enabled": true
},
"port": "",
"protocol": "UDP",
"sender": "Absender im gleichen Rechnernetz",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
],
[
"UDP",
"53",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\n",
"logEditable": true
},
{
"step": "add -1 for all protocols",
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": false,
"enabled": true
},
"port": "",
"protocol": "*",
"sender": "Alle Absender",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
],
[
"UDP",
"53",
"Nur lokales Rechnernetz"
],
[
"*",
"",
"Alle Absender"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: -1/*\n",
"logEditable": true
},
{
"step": "add 0 TCP",
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": false,
"enabled": true
},
"port": "",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
],
[
"UDP",
"53",
"Nur lokales Rechnernetz"
],
[
"*",
"",
"Alle Absender"
],
[
"TCP",
"0",
"Alle Absender"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: -1/*\nPortregel wurde hinzugefügt: 0/TCP\n",
"logEditable": true
},
{
"step": "add 70000 TCP for the same network",
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": false,
"enabled": true
},
"port": "",
"protocol": "TCP",
"sender": "Absender im gleichen Rechnernetz",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
],
[
"UDP",
"53",
"Nur lokales Rechnernetz"
],
[
"*",
"",
"Alle Absender"
],
[
"TCP",
"0",
"Alle Absender"
],
[
"TCP",
"70000",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: -1/*\nPortregel wurde hinzugefügt: 0/TCP\nPortregel wurde hinzugefügt: 70000/TCP\n",
"logEditable": true
},
{
"step": "add a port after a space",
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": false,
"enabled": true
},
"port": " 80",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
],
[
"UDP",
"53",
"Nur lokales Rechnernetz"
],
[
"*",
"",
"Alle Absender"
],
[
"TCP",
"0",
"Alle Absender"
],
[
"TCP",
"70000",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: -1/*\nPortregel wurde hinzugefügt: 0/TCP\nPortregel wurde hinzugefügt: 70000/TCP\n",
"logEditable": true
},
{
"step": "delete with no row chosen",
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": false,
"enabled": true
},
"port": " 80",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [
[
"TCP",
"55555",
"Alle Absender"
],
[
"UDP",
"53",
"Nur lokales Rechnernetz"
],
[
"*",
"",
"Alle Absender"
],
[
"TCP",
"0",
"Alle Absender"
],
[
"TCP",
"70000",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: -1/*\nPortregel wurde hinzugefügt: 0/TCP\nPortregel wurde hinzugefügt: 70000/TCP\n",
"logEditable": true
},
{
"step": "delete row 0",
"traffic": {
"local": {
"ping": "null",
"tcp": "connected",
"dns": "10.0.0.10"
},
"remote": {
"ping": "null",
"tcp": "connected",
"dns": "10.0.0.10"
}
},
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": false,
"enabled": true
},
"port": " 80",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [
[
"UDP",
"53",
"Nur lokales Rechnernetz"
],
[
"*",
"",
"Alle Absender"
],
[
"TCP",
"0",
"Alle Absender"
],
[
"TCP",
"70000",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: -1/*\nPortregel wurde hinzugefügt: 0/TCP\nPortregel wurde hinzugefügt: 70000/TCP\nPortregel wurde entfernt.\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #2 (*/* -> */*; *:* => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #2 (*/* -> */*; *:* => ACCEPT) -> akzeptieren\n",
"logEditable": true
},
{
"step": "firewall off",
"traffic": {
"local": {
"ping": "ICMP 0/0 from 10.0.0.10",
"tcp": "connected",
"dns": "10.0.0.10"
},
"remote": {
"ping": "ICMP 0/0 from 10.0.0.10",
"tcp": "connected",
"dns": "10.0.0.10"
}
},
"active": {
"selected": false,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": false
},
"udp": {
"selected": false,
"enabled": false
},
"port": " 80",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [
[
"UDP",
"53",
"Nur lokales Rechnernetz"
],
[
"*",
"",
"Alle Absender"
],
[
"TCP",
"0",
"Alle Absender"
],
[
"TCP",
"70000",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: -1/*\nPortregel wurde hinzugefügt: 0/TCP\nPortregel wurde hinzugefügt: 70000/TCP\nPortregel wurde entfernt.\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #2 (*/* -> */*; *:* => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #2 (*/* -> */*; *:* => ACCEPT) -> akzeptieren\n",
"logEditable": true
},
{
"step": "firewall on again",
"active": {
"selected": true,
"enabled": true
},
"icmp": {
"selected": false,
"enabled": true
},
"udp": {
"selected": false,
"enabled": true
},
"port": " 80",
"protocol": "TCP",
"sender": "Alle Absender",
"rows": [
[
"UDP",
"53",
"Nur lokales Rechnernetz"
],
[
"*",
"",
"Alle Absender"
],
[
"TCP",
"0",
"Alle Absender"
],
[
"TCP",
"70000",
"Nur lokales Rechnernetz"
]
],
"log": "Portregel wurde hinzugefügt: 55555/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: 53/UDP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nFirewall-Regel hat gegriffen: #2 (10.0.0.0/255.255.255.0 -> */*; UDP:53 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:55555 => ACCEPT) -> akzeptieren\nPortregel wurde hinzugefügt: -1/*\nPortregel wurde hinzugefügt: 0/TCP\nPortregel wurde hinzugefügt: 70000/TCP\nPortregel wurde entfernt.\nICMP-Paket verworfen: 10.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #2 (*/* -> */*; *:* => ACCEPT) -> akzeptieren\nICMP-Paket verworfen: 20.0.0.2 -> 10.0.0.10 (code: 0, type: 8)\nFirewall-Regel hat gegriffen: #2 (*/* -> */*; *:* => ACCEPT) -> akzeptieren\n",
"logEditable": true
}
]
}
packages/core/test/firewallWindow.test.ts
+238
View File
@@ -0,0 +1,238 @@
// A computer's firewall as Java's window changes it, against Java's
// (firewallWindow.java.json, FirewallWindowRun) on firewall-pc's server:
// Java's steps played on the engine — the boxes, the rules as the window's
// table shows them, the log, and after the steps that ask, what reaches the
// server from a computer of its network and one behind the router (a ping,
// a TCP connection to its echo server, its DNS server asked) — and where
// Java errs, what the firewall does instead (apps/personalFirewall.ts names
// each): only a port is taken.
import { readFileSync } from 'node:fs';
import { dirname, join } from 'node:path';
import { fileURLToPath } from 'node:url';
import { describe, expect, it } from 'vitest';
import {
DIRECTLY_CONNECTED_SOURCE_MARKER,
firewallLogText,
firewallPortOfText,
firewallRule,
JAVA_PERSONAL_FIREWALL_DEFAULTS,
NetworkRuntimeEngine,
portRuleSender,
VirtualFileSystem,
withoutRule,
withPortRule,
withSnapshot,
type FirewallRule,
type PortRuleProtocol,
type Steps,
} from '../src/index.js';
import { snapshotOf, type Scenario } from './scenario.js';
interface Reached {
readonly ping: string;
readonly tcp: string;
readonly dns: string;
}
interface JavaStep {
readonly step: string;
readonly traffic?: { readonly local: Reached; readonly remote: Reached };
readonly active: { readonly selected: boolean; readonly enabled: boolean };
readonly icmp: { readonly selected: boolean; readonly enabled: boolean };
readonly udp: { readonly selected: boolean; readonly enabled: boolean };
readonly rows: readonly (readonly string[])[];
readonly log: string;
readonly logEditable: boolean;
}
const here = dirname(fileURLToPath(import.meta.url));
const java = JSON.parse(readFileSync(join(here, 'firewallWindow.java.json'), 'utf8')) as { readonly steps: readonly JavaStep[] };
const scenario = JSON.parse(readFileSync(join(here, 'scenarios/firewall-pc.scenario.json'), 'utf8')) as Scenario;
const LOCAL = '00000000-0000-0000-0000-000000000201';
const REMOTE = '00000000-0000-0000-0000-000000000203';
const SERVER = '00000000-0000-0000-0000-000000000204';
const SERVER_ADDRESS = '10.0.0.10';
const TIMED_OUT = 'TimeOutException: Zeitüberschreitung beim Verbindungsaufbau';
/** Java's ruleToVector: protocol, port, sender. */
function javaRow(rule: FirewallRule): string[] {
const protocol = rule.protocol === 'tcp' ? 'TCP' : rule.protocol === 'udp' ? 'UDP' : '*';
return [protocol, rule.port >= 0 ? String(rule.port) : '', rule.sourceIPAddress === DIRECTLY_CONNECTED_SOURCE_MARKER ? 'Nur lokales Rechnernetz' : 'Alle Absender'];
}
function setUp() {
const engine = new NetworkRuntimeEngine(scenario.seed);
engine.handle({
type: 'start',
snapshot: withSnapshot(snapshotOf(scenario), {
fileSystemsByNodeId: new Map([[SERVER, new VirtualFileSystem()]]),
echoServersByNodeId: new Map([[SERVER, { port: 55555, isActive: true }]]),
firewallConfigurationsByNodeId: new Map([[SERVER, JAVA_PERSONAL_FIREWALL_DEFAULTS]]),
}),
seed: scenario.seed,
initialTimeMilliseconds: 0,
});
const run = (milliseconds: number) => engine.handle({ type: 'advance', toMilliseconds: engine.state.currentTimeMilliseconds + milliseconds });
const blocking = <T>(steps: Steps<T>, milliseconds: number): T | undefined => {
let result: T | undefined;
engine.startThread(
(function* (): Steps {
result = yield* steps;
})(),
);
run(milliseconds);
return result;
};
let sequenceNumber = 1;
const reached = (from: string): Reached => {
const answer = blocking(engine.icmpEchoSteps(from, SERVER_ADDRESS, { identifier: 1, sequenceNumber: sequenceNumber++ }), 30_000);
const ping = answer?.message.kind === 'echoReply' ? `ICMP 0/0 from ${answer.packet.senderIPAddress}` : 'null';
const socket = engine.openTcpClientSocket(from, SERVER_ADDRESS, 55555)!;
const connected = blocking(engine.connectTcpSteps(socket), 60_000);
// Held a moment, as the oracle holds it.
run(500);
engine.closeSocket(socket);
run(1000);
const tcp = connected === 'connected' ? 'connected' : connected === 'timedOut' ? TIMED_OUT : String(connected);
const resolution = blocking(engine.resolveDnsAddressSteps(from, 'www.filius.de'), 30_000);
const dns = resolution === undefined || resolution.type === 'timedOut' ? 'TimeOutException' : String(resolution.address ?? null);
return { ping, tcp, dns };
};
return { engine, reached };
}
describe("a computer's firewall window, against Java's", () => {
it("plays Java's steps: the same where Java is right, as named where it errs", () => {
const { engine, reached } = setUp();
const configuration = () => engine.personalFirewall(SERVER)!;
const log = () => engine.firewallLog(SERVER).map((entry) => `${firewallLogText(entry, 'de')}\n`);
// Java's log lines, less those of what Java takes and the firewall does not (and with those the firewall takes instead).
let javaLines = (step: JavaStep) => step.log.split(/(?<=\n)/).filter((line) => line !== '');
const at = (name: string) => java.steps.find((step) => step.step === name)!;
const check = (name: string, traffic: { readonly local: Reached; readonly remote: Reached } | undefined = at(name).traffic) => {
const step = at(name);
if (traffic !== undefined) expect({ local: reached(LOCAL), remote: reached(REMOTE) }, name).toEqual(traffic);
expect({ active: configuration().isActive, icmp: !configuration().dropIcmp, udp: configuration().filterUdp, rows: configuration().rules.map(javaRow), log: log() }, name).toEqual({
active: step.active.selected,
icmp: step.icmp.selected,
udp: step.udp.selected,
rows: step.rows,
log: javaLines(step),
});
};
const add = (port: string, protocol: PortRuleProtocol, sameNetworkOnly: boolean) => {
const number = firewallPortOfText(port);
return number !== undefined && engine.addFirewallPortRule(SERVER, number, protocol, sameNetworkOnly);
};
const set = (fields: Partial<ReturnType<typeof configuration>>) => engine.setFirewallConfiguration(SERVER, { ...configuration(), ...fields });
// Active as Java installs it: a ping goes through, TCP and UDP only by a rule.
check('open');
expect(at('open').logEditable).toBe(true);
expect([add('abc', 'tcp', false), add('', 'tcp', false)]).toEqual([false, false]);
check('add port abc');
check('add an empty port');
expect(add('55555', 'tcp', false)).toBe(true);
check('add 55555 TCP for all senders');
expect(add('53', 'udp', true)).toBe(true);
check('add 53 UDP for the same network');
set({ dropIcmp: true });
check('ICMP no longer allowed');
set({ filterUdp: false });
check('UDP filter off');
// No port, none taken (Java takes each: -1 a rule for every port of both protocols, 0 and 70000 rules that never match).
expect([add('-1', 'all', false), add('0', 'tcp', false), add('70000', 'tcp', true)]).toEqual([false, false, false]);
const notTaken = ['Portregel wurde hinzugefügt: -1/*\n', 'Portregel wurde hinzugefügt: 0/TCP\n', 'Portregel wurde hinzugefügt: 70000/TCP\n'];
let javaRows = (step: JavaStep) => step.rows.filter(([, port]) => port !== '' && port !== '0' && port !== '70000');
const javaAll = javaLines;
javaLines = (step) => javaAll(step).filter((line) => !notTaken.includes(line));
const sameAsJava = (name: string) => expect({ rows: configuration().rules.map(javaRow), log: log() }, name).toEqual({ rows: javaRows(at(name)), log: javaLines(at(name)) });
for (const name of ['add -1 for all protocols', 'add 0 TCP', 'add 70000 TCP for the same network']) sameAsJava(name);
// A port after a space is taken (Java refuses it without a word).
expect(add(' 80', 'tcp', false)).toBe(true);
const tookPort = javaLines(at('add 70000 TCP for the same network')).length;
const javaTaken = javaLines;
javaLines = (step) => javaTaken(step).toSpliced(tookPort, 0, 'Portregel wurde hinzugefügt: 80/TCP\n');
const javaListed = javaRows;
javaRows = (step) => [...javaListed(step), ['TCP', '80', 'Alle Absender']];
sameAsJava('add a port after a space');
// "Löschen" with no row chosen does nothing; row 0 goes. Without Java's rule for every port, TCP is no longer let through.
sameAsJava('delete with no row chosen');
expect(engine.removeFirewallRule(SERVER, 0)).toBe(true);
const javaKept = javaLines;
javaLines = (step) => javaKept(step).filter((line) => !line.includes('*/* -> */*; *:*'));
const javaDelete = at('delete row 0');
const closed = (reach: Reached): Reached => ({ ...reach, tcp: TIMED_OUT });
expect({ local: reached(LOCAL), remote: reached(REMOTE) }).toEqual({ local: closed(javaDelete.traffic!.local), remote: closed(javaDelete.traffic!.remote) });
sameAsJava('delete row 0');
// Off: everything goes through, nothing is written; on again.
set({ isActive: false });
const javaOff = at('firewall off');
expect({ local: reached(LOCAL), remote: reached(REMOTE) }).toEqual(javaOff.traffic);
sameAsJava('firewall off');
expect([javaOff.icmp.enabled, javaOff.udp.enabled, at('firewall on again').icmp.enabled]).toEqual([false, false, true]);
set({ isActive: true });
expect(configuration()).toMatchObject({ isActive: true, dropIcmp: true, filterUdp: false });
});
});
describe("a computer's firewall beyond the steps", () => {
it('takes a port of 1 to 65535 only, spaces around it allowed', () => {
expect(['1', '65535', ' 80 ', '+80', '80a', '0', '65536', '-1', '', ' '].map(firewallPortOfText)).toEqual([
1,
65535,
80,
undefined,
undefined,
undefined,
undefined,
undefined,
undefined,
undefined,
]);
});
it('adds Java’s rule and removes the row chosen only', () => {
const added = withPortRule(withPortRule(JAVA_PERSONAL_FIREWALL_DEFAULTS, 80, 'tcp', false), 53, 'udp', true);
expect(added.rules).toEqual([
firewallRule({ port: 80, protocol: 'tcp', action: 'accept' }),
firewallRule({ port: 53, protocol: 'udp', action: 'accept', sourceIPAddress: DIRECTLY_CONNECTED_SOURCE_MARKER }),
]);
expect(withoutRule(added, 1)!.rules).toEqual([added.rules[0]]);
expect([withoutRule(added, 2), withoutRule(added, -1), withoutRule(added, 0.5)]).toEqual([undefined, undefined, undefined]);
});
it("names the window's sender for the rules it makes only", () => {
expect(
[
firewallRule({ action: 'accept' }),
firewallRule({ action: 'accept', sourceIPAddress: DIRECTLY_CONNECTED_SOURCE_MARKER, sourceSubnetMask: '255.0.0.0' }),
firewallRule({ action: 'accept', sourceSubnetMask: '255.0.0.0' }),
firewallRule({ action: 'drop' }),
firewallRule({ action: 'accept', sourceIPAddress: '10.0.0.0', sourceSubnetMask: '255.0.0.0' }),
firewallRule({ action: 'accept', destinationIPAddress: '10.0.0.10' }),
].map(portRuleSender),
).toEqual(['all', 'sameNetwork', 'all', undefined, undefined, undefined]);
});
it('has nothing for a computer without a firewall, nor a router', () => {
const engine = new NetworkRuntimeEngine(scenario.seed);
// The router has a firewall, as every one has in Java; it is no program of a computer.
const ROUTER = '00000000-0000-0000-0000-000000000202';
engine.handle({
type: 'start',
snapshot: withSnapshot(snapshotOf(scenario), { firewallConfigurationsByNodeId: new Map([[ROUTER, JAVA_PERSONAL_FIREWALL_DEFAULTS]]) }),
seed: scenario.seed,
initialTimeMilliseconds: 0,
});
expect([engine.personalFirewall(SERVER), engine.personalFirewall(ROUTER)]).toEqual([undefined, undefined]);
expect(engine.addFirewallPortRule(ROUTER, 80, 'tcp', false)).toBe(false);
expect([engine.addFirewallPortRule(SERVER, 80, 'tcp', false), engine.removeFirewallRule(SERVER, 0)]).toEqual([false, false]);
expect(engine.firewallLog(SERVER)).toEqual([]);
});
});
packages/core/test/scenarios/firewall-pc.scenario.json
+146
View File
@@ -0,0 +1,146 @@
{
"seed": 21,
"nodes": [
{
"id": "00000000-0000-0000-0000-000000000201",
"kind": "pc",
"ports": [
{
"id": "00000000-0000-0000-0000-000000000211",
"label": "eth0"
}
]
},
{
"id": "00000000-0000-0000-0000-000000000202",
"kind": "router",
"ports": [
{
"id": "00000000-0000-0000-0000-000000000221",
"label": "rt1"
},
{
"id": "00000000-0000-0000-0000-000000000222",
"label": "rt2"
}
]
},
{
"id": "00000000-0000-0000-0000-000000000203",
"kind": "pc",
"ports": [
{
"id": "00000000-0000-0000-0000-000000000213",
"label": "eth0"
}
]
},
{
"id": "00000000-0000-0000-0000-000000000204",
"kind": "pc",
"ports": [
{
"id": "00000000-0000-0000-0000-000000000214",
"label": "eth0"
}
]
},
{
"id": "00000000-0000-0000-0000-000000000205",
"kind": "networkSwitch",
"ports": [
{
"id": "00000000-0000-0000-0000-000000000251",
"label": "sw1"
},
{
"id": "00000000-0000-0000-0000-000000000252",
"label": "sw2"
},
{
"id": "00000000-0000-0000-0000-000000000253",
"label": "sw3"
},
{
"id": "00000000-0000-0000-0000-000000000254",
"label": "sw4"
}
]
}
],
"links": [
{
"id": "00000000-0000-0000-0000-00000000F301",
"sourceNode": "00000000-0000-0000-0000-000000000201",
"sourcePort": "00000000-0000-0000-0000-000000000211",
"targetNode": "00000000-0000-0000-0000-000000000205",
"targetPort": "00000000-0000-0000-0000-000000000251"
},
{
"id": "00000000-0000-0000-0000-00000000F302",
"sourceNode": "00000000-0000-0000-0000-000000000204",
"sourcePort": "00000000-0000-0000-0000-000000000214",
"targetNode": "00000000-0000-0000-0000-000000000205",
"targetPort": "00000000-0000-0000-0000-000000000252"
},
{
"id": "00000000-0000-0000-0000-00000000F303",
"sourceNode": "00000000-0000-0000-0000-000000000202",
"sourcePort": "00000000-0000-0000-0000-000000000221",
"targetNode": "00000000-0000-0000-0000-000000000205",
"targetPort": "00000000-0000-0000-0000-000000000253"
},
{
"id": "00000000-0000-0000-0000-00000000F304",
"sourceNode": "00000000-0000-0000-0000-000000000202",
"sourcePort": "00000000-0000-0000-0000-000000000222",
"targetNode": "00000000-0000-0000-0000-000000000203",
"targetPort": "00000000-0000-0000-0000-000000000213"
}
],
"devices": {
"00000000-0000-0000-0000-000000000201": {
"ip": "10.0.0.2",
"mask": "255.255.255.0",
"gateway": "10.0.0.1",
"dns": "10.0.0.10"
},
"00000000-0000-0000-0000-000000000202": {
"ip": "10.0.0.1",
"mask": "255.255.255.0"
},
"00000000-0000-0000-0000-000000000203": {
"ip": "20.0.0.2",
"mask": "255.255.255.0",
"gateway": "20.0.0.1",
"dns": "10.0.0.10"
},
"00000000-0000-0000-0000-000000000204": {
"ip": "10.0.0.10",
"mask": "255.255.255.0",
"gateway": "10.0.0.1"
}
},
"interfaces": [
{
"node": "00000000-0000-0000-0000-000000000202",
"port": "00000000-0000-0000-0000-000000000221",
"ip": "10.0.0.1",
"mask": "255.255.255.0"
},
{
"node": "00000000-0000-0000-0000-000000000202",
"port": "00000000-0000-0000-0000-000000000222",
"ip": "20.0.0.1",
"mask": "255.255.255.0"
}
],
"dnsServers": {
"00000000-0000-0000-0000-000000000204": {
"records": [
"www.filius.de A 10.0.0.10"
]
}
}
,"steps": []
}
packages/editor/browser/firewall.spec.ts
+110
View File
@@ -0,0 +1,110 @@
// A computer's firewall on its desktop in Chromium (F4.6g3), on FILIUS'
// example email_komplett with the firewall installed on its web server:
// Java's boxes, a port refused and one added, a notebook's browser let
// through by the rule, ICMP no longer allowed and a ping dropped (both in the
// log), the firewall switched off (the boxes beneath it can no longer be
// changed), the rule chosen and removed.
import { expect, test, type Page } from '@playwright/test';
import { drawing, onDevice, openEditor, serveEditor } from './editorPage.js';
let server: { readonly base: string; readonly close: () => Promise<void> };
test.beforeAll(async () => {
server = await serveEditor();
});
test.afterAll(async () => {
await server.close();
});
async function desktopOf(page: Page, name: string) {
const id = (await drawing(page)).nodes.find((node) => node.name === name)!.id;
const at = await onDevice(page, id);
await page.mouse.click(at.x, at.y);
return page.locator(`section[data-desktop="${id}"]`);
}
async function install(page: Page, desktop: ReturnType<Page['locator']>, program: string) {
await desktop.locator('[data-program="installation"]').click();
const installation = desktop.locator('[data-program-window="installation"]');
await installation.locator('[data-list="available"] [role="option"]').filter({ hasText: program }).click();
await installation.getByRole('button', { name: 'Installieren' }).click();
await installation.getByRole('button', { name: 'Änderungen annehmen' }).click();
}
test('keeps a computer’s firewall as Java’s window does, and the firewall lets through what its rules open', async ({ page }) => {
test.setTimeout(120_000);
await openEditor(page, server.base, 'email_komplett.fls');
await page.getByRole('button', { name: 'Wechselt in den Aktionsmodus' }).click();
await expect(page.locator('svg.filius-canvas')).toHaveAttribute('data-mode', 'simulation');
const desktop = await desktopOf(page, 'Web-Server');
await install(page, desktop, 'Firewall');
await desktop.locator('[data-program="firewall"]').click();
const window = desktop.locator('[data-program-window="firewall"]');
await expect(window.locator('.program-titlebar h3')).toHaveText('Firewall');
await expect(window.getByRole('tab')).toHaveText(['Konfiguration', 'Log']);
const active = window.getByRole('checkbox', { name: 'Firewall aktivieren' });
const icmp = window.getByRole('checkbox', { name: 'Internet Control Message Protocol (Ping etc.) erlauben' });
await expect(active).toBeChecked();
await expect(icmp).toBeChecked();
await expect(window.getByRole('checkbox', { name: 'Aktiviere UDP-Datenverkehrfilter' })).toBeChecked();
await expect(window.getByText('Die Firewall blockiert alle eingehenden IP-Pakete')).toBeVisible();
// A port that is none is marked and not handed over; 80 is added and the field emptied.
const port = window.getByRole('textbox', { name: 'Zulässiger Port/Protokoll:' });
const add = window.getByRole('button', { name: 'Hinzufügen' });
await port.fill('70000');
await expect(port).toHaveAttribute('aria-invalid', 'true');
await expect(add).toBeDisabled();
await port.fill('80');
await add.click();
const rows = window.getByRole('table', { name: 'Regeln' }).locator('tbody tr');
await expect(rows).toHaveCount(1);
await expect(rows.first().locator('td')).toHaveText(['TCP', '80', 'Alle Absender']);
await expect(port).toHaveValue('');
// A notebook's browser is let through by the rule; the log says so.
await desktop.locator('.desktop-close').click();
const notebook = await desktopOf(page, 'Rechner 1');
await notebook.locator('[data-program="webBrowser"]').click();
const browser = notebook.locator('[data-program-window="webBrowser"]');
const address = browser.getByRole('textbox', { name: 'Adresse' });
await address.fill('141.99.50.231');
await address.press('Enter');
await expect(browser.frameLocator('iframe[title="Seite"]').locator('body')).not.toBeEmpty({ timeout: 30_000 });
// ICMP no longer allowed: the notebook's ping is dropped.
await notebook.locator('.desktop-close').click();
await desktopOf(page, 'Web-Server');
await desktop.locator('[data-program="firewall"]').click();
await icmp.click();
await expect(icmp).not.toBeChecked();
await desktop.locator('.desktop-close').click();
await desktopOf(page, 'Rechner 1');
await install(page, notebook, 'Befehlszeile');
await notebook.locator('[data-program="commandPrompt"]').click();
const input = notebook.locator('input[name="terminalInput"]');
await input.fill('ping 141.99.50.231');
await input.press('Enter');
await expect(notebook.locator('.terminal-text')).toContainText('0 Paket(e) empfangen', { timeout: 60_000 });
await notebook.locator('.desktop-close').click();
await desktopOf(page, 'Web-Server');
await desktop.locator('[data-program="firewall"]').click();
await window.getByRole('tab', { name: 'Log' }).click();
const log = window.getByRole('tabpanel', { name: 'Log' });
await expect(log).toContainText('Portregel wurde hinzugefügt: 80/TCP\nFirewall-Regel hat gegriffen: #1 (*/* -> */*; TCP:80 => ACCEPT) -> akzeptieren');
await expect(log).toContainText('ICMP-Paket verworfen: 141.99.50.181 -> 141.99.50.231 (code: 0, type: 8)');
// Off: the two boxes beneath it can no longer be changed; the rule chosen and removed.
await window.getByRole('tab', { name: 'Konfiguration' }).click();
await active.click();
await expect(active).not.toBeChecked();
await expect(icmp).toBeDisabled();
await expect(window.getByRole('button', { name: 'Löschen' })).toBeDisabled();
await rows.first().dispatchEvent('pointerdown');
await window.getByRole('button', { name: 'Löschen' }).click();
await expect(rows).toHaveCount(0);
await window.getByRole('tab', { name: 'Log' }).click();
await expect(log).toContainText('Portregel wurde entfernt.');
});
packages/editor/src/desktop/DesktopWindow.tsx
+3 -1
View File
@@ -41,6 +41,7 @@ import { TextEditorPanel, useTextEditorWindow } from './TextEditorPanel.js';
import { FileExplorerPanel } from './FileExplorerPanel.js';
import { EchoServerPanel, SimpleClientPanel } from './EchoPanels.js';
import { DnsServerPanel } from './DnsServerPanel.js';
import { PersonalFirewallPanel } from './PersonalFirewallPanel.js';
import { ImageViewerPanel, useImageViewer } from './ImageViewerPanel.js';
import { WebServerPanel } from './WebServerPanel.js';
import './desktop.css';
@@ -71,7 +72,7 @@ export interface DesktopWindowProps {
export type DesktopWindowName = DesktopProgram | 'installation';
/** The programs whose windows are built so far. */
const WITH_WINDOW: ReadonlySet<DesktopProgram> = new Set(['commandPrompt', 'webBrowser', 'webServer', 'emailClient', 'emailServer', 'textEditor', 'fileExplorer', 'imageViewer', 'echoServer', 'simpleClient', 'dnsServer']);
const WITH_WINDOW: ReadonlySet<DesktopProgram> = new Set(['commandPrompt', 'webBrowser', 'webServer', 'emailClient', 'emailServer', 'textEditor', 'fileExplorer', 'imageViewer', 'echoServer', 'simpleClient', 'dnsServer', 'firewall']);
/** The document's desktop of a computer, read anew after every change (a program installed, the label changed). */
function useDesktopView(doc: Y.Doc, id: string) {
@@ -189,6 +190,7 @@ export function DesktopWindow({ doc, id, simulation, active, x, y, z, program: o
{shown === 'echoServer' ? <EchoServerPanel node={id} simulation={simulation} /> : null}
{shown === 'simpleClient' ? <SimpleClientPanel node={id} simulation={simulation} /> : null}
{shown === 'dnsServer' ? <DnsServerPanel node={id} simulation={simulation} /> : null}
{shown === 'firewall' ? <PersonalFirewallPanel node={id} simulation={simulation} /> : null}
</ProgramFrame>
)}
{info ? (
packages/editor/src/desktop/PersonalFirewallPanel.tsx
+159
View File
@@ -0,0 +1,159 @@
// A computer's firewall, after Java's GUIApplicationFirewallWindow (measured
// with tools/java-oracle's FirewallWindowRun): two tabs. The first holds the
// three boxes — the firewall on, ICMP allowed, UDP filtered; the last two
// only while it is on —, the port with its protocol (TCP, UDP, "*") and its
// senders (all, or those of the same network), "Hinzufügen" (the field is
// emptied after it), "Löschen" of the row chosen, and the table of rules.
// The second holds the log: the firewall's lines and the rules added or
// removed. The firewall is the room's: the panel shows its view and lines
// and hands over what is done.
//
// Better than Java:
// - a port that is none (Java takes any number, and refuses one after a
// space without a word) is marked red and not handed over.
// - Java writes the firewall's explanation but never shows it; here it
// stands under the boxes.
// - a rule the window cannot make (from a file: one that drops, or names an
// address) shows what it is in the sender column; Java shows it as a port
// opened for all senders.
// - the log cannot be typed into (Java's can).
import { useEffect, useLayoutEffect, useRef, useState, type KeyboardEvent } from 'react';
import { firewallPortOfText, type FirewallLogEntry, type LogLine, type PortRuleProtocol } from '@mdg-filius/core';
import type { FirewallView, FirewallViewRule } from '@mdg-filius/protocol';
import { useTranslate, type Translate } from '../i18n/i18n.js';
import type { Simulation } from '../simulation/useSimulation.js';
import { firewallLine } from './serverLines.js';
const NO_LINES: readonly LogLine<FirewallLogEntry>[] = [];
const PROTOCOL_NAMES: Readonly<Record<FirewallViewRule['protocol'], string>> = { tcp: 'TCP', udp: 'UDP', all: '*', icmp: 'ICMP' };
/** Java's list: TCP, UDP, "*". */
const PROTOCOLS: readonly PortRuleProtocol[] = ['tcp', 'udp', 'all'];
/** A rule's cells as Java's ruleToVector writes them: protocol, port (none for every port), sender. */
export function firewallRow(rule: FirewallViewRule, t: Translate): readonly [string, string, string] {
const sender = rule.sender === 'all' ? t('personalFirewall.allSenders') : rule.sender === 'sameNetwork' ? t('personalFirewall.localNetwork') : rule.text;
return [PROTOCOL_NAMES[rule.protocol], rule.port >= 0 ? String(rule.port) : '', sender];
}
export function PersonalFirewallPanel({ node, simulation }: { readonly node: string; readonly simulation: Simulation }) {
const t = useTranslate();
const topic = `app:${node}/firewall` as const;
const { watch, act } = simulation;
useEffect(() => watch([topic]), [watch, topic]);
const view = simulation.views.get(topic) as FirewallView | null | undefined;
const [tab, setTab] = useState<'setup' | 'log'>('setup');
const [port, setPort] = useState('');
const [protocol, setProtocol] = useState<PortRuleProtocol>('tcp');
const [sameNetworkOnly, setSameNetworkOnly] = useState(false);
const [chosen, setChosen] = useState<number | null>(null);
const lines = (simulation.apps.get(topic as never)?.lines as readonly LogLine<FirewallLogEntry>[] | undefined) ?? NO_LINES;
const log = lines.map((each) => `${firewallLine(each, t)}\n`).join('');
const logElement = useRef<HTMLPreElement>(null);
useLayoutEffect(() => {
if (logElement.current !== null) logElement.current.scrollTop = logElement.current.scrollHeight;
}, [log, tab]);
if (view === null || view === undefined) return <div className="web-server" />;
const typed = firewallPortOfText(port);
const chosenRow = chosen !== null && chosen < view.rules.length ? chosen : null;
const add = () => {
if (typed === undefined) return;
act(node, 'firewall', 'addRule', { port: typed, protocol, sameNetworkOnly });
setPort('');
};
const remove = () => {
if (chosenRow === null) return;
act(node, 'firewall', 'removeRule', { row: chosenRow });
setChosen(null);
};
const choose = (row: number) => (event: KeyboardEvent<HTMLTableRowElement>) => {
if (event.key !== 'Enter' && event.key !== ' ') return;
event.preventDefault();
setChosen(row);
};
return (
<div className="web-server personal-firewall">
<div className="mail-tabs" role="tablist">
{(['setup', 'log'] as const).map((each) => (
<button key={each} type="button" role="tab" aria-selected={tab === each} onClick={() => setTab(each)}>
{t(`personalFirewall.${each}`)}
</button>
))}
</div>
{tab === 'log' ? (
<pre className="web-server-log" ref={logElement} role="tabpanel" aria-label={t('personalFirewall.log')} tabIndex={0}>
{log}
</pre>
) : (
<div className="personal-firewall-page" role="tabpanel" aria-label={t('personalFirewall.setup')}>
<div className="personal-firewall-boxes">
<label>
<input type="checkbox" checked={view.active} onChange={(event) => act(node, 'firewall', 'setActive', { active: event.target.checked })} />
{t('firewall.active')}
</label>
<label>
<input type="checkbox" checked={view.icmpAllowed} disabled={!view.active} onChange={(event) => act(node, 'firewall', 'setIcmpAllowed', { allowed: event.target.checked })} />
{t('personalFirewall.allowIcmp')}
</label>
<label>
<input type="checkbox" checked={view.filterUdp} disabled={!view.active} onChange={(event) => act(node, 'firewall', 'setFilterUdp', { enabled: event.target.checked })} />
{t('personalFirewall.filterUdp')}
</label>
</div>
<p className="personal-firewall-hint">{t('personalFirewall.hint')}</p>
<div className="web-server-bar">
<label>
{t('personalFirewall.port')}
<input
value={port}
inputMode="numeric"
aria-invalid={port !== '' && typed === undefined ? 'true' : undefined}
onChange={(event) => setPort(event.target.value)}
onKeyDown={(event) => event.key === 'Enter' && add()}
/>
</label>
<select aria-label={t('firewall.protocol')} value={protocol} onChange={(event) => setProtocol(event.target.value as PortRuleProtocol)}>
{PROTOCOLS.map((each) => (
<option key={each} value={each}>
{PROTOCOL_NAMES[each]}
</option>
))}
</select>
<select aria-label={t('personalFirewall.sender')} value={sameNetworkOnly ? 'sameNetwork' : 'all'} onChange={(event) => setSameNetworkOnly(event.target.value === 'sameNetwork')}>
<option value="all">{t('personalFirewall.allSenders')}</option>
<option value="sameNetwork">{t('personalFirewall.sameNetwork')}</option>
</select>
</div>
<div className="web-server-bar">
<button type="button" disabled={typed === undefined} onClick={add}>
{t('personalFirewall.add')}
</button>
<button type="button" disabled={chosenRow === null} onClick={remove}>
{t('personalFirewall.delete')}
</button>
</div>
<table className="dns-server-table personal-firewall-table" aria-label={t('personalFirewall.rules')}>
<thead>
<tr>
<th>{t('firewall.protocol')}</th>
<th>{t('personalFirewall.portColumn')}</th>
<th>{t('personalFirewall.sender')}</th>
</tr>
</thead>
<tbody>
{view.rules.map((rule, row) => (
<tr key={row} tabIndex={0} aria-selected={row === chosenRow} onPointerDown={() => setChosen(row)} onKeyDown={choose(row)}>
{firewallRow(rule, t).map((cell, column) => (
<td key={column}>{cell}</td>
))}
</tr>
))}
</tbody>
</table>
</div>
)}
</div>
);
}
packages/editor/src/desktop/desktop.css
+62
View File
@@ -1140,3 +1140,65 @@
.dns-server-table tr[aria-selected='true'] input {
background: #b8cfe5;
}
/* A computer's firewall (GUIApplicationFirewallWindow): two tabs, the boxes,
* the port with its two lists, two buttons and the table of rules; the log. */
.personal-firewall-page {
flex: 1;
min-height: 0;
overflow: auto;
display: flex;
flex-direction: column;
gap: 6px;
}
.personal-firewall-boxes {
display: flex;
flex-direction: column;
}
.personal-firewall-boxes label {
display: flex;
align-items: center;
gap: 6px;
min-height: 44px;
cursor: pointer;
}
.personal-firewall-boxes input {
width: 20px;
height: 20px;
}
.personal-firewall-hint {
margin: 0;
}
.personal-firewall input:not([type='checkbox']),
.personal-firewall select {
min-height: 32px;
padding: 0 6px;
border: 1px solid #a0a0a0;
background: #ffffff;
color: #000000;
font: 16px Dialog, sans-serif;
}
.personal-firewall input:not([type='checkbox']) {
width: 6em;
}
.personal-firewall [aria-invalid='true'] {
border-color: #ff0000;
color: #ff0000;
}
.personal-firewall-table td {
min-height: 32px;
padding: 6px;
overflow-wrap: anywhere;
}
.personal-firewall-table tr {
cursor: pointer;
}
packages/editor/src/desktop/serverLines.ts
+20 -2
View File
@@ -2,9 +2,10 @@
// ServerMitarbeiter, TCPSocket's failures), and the generic client's as its
// window writes them (ClientBaustein, Socket, TCPSocket), in the person's
// language: one line each (a failed connection two), as Java appends them to
// its window's text area.
// its window's text area. And a computer's firewall's log as its window
// writes it (Firewall.benachrichtigeBeobachter, GUIApplicationFirewallWindow).
import type { ServerLogEntry, SimpleClientLogEntry } from '@mdg-filius/core';
import { firewallRuleText, PORT_RULE_PROTOCOL_NAMES, type FirewallLogEntry, type ServerLogEntry, type SimpleClientLogEntry } from '@mdg-filius/core';
import type { Translate } from '../i18n/i18n.js';
export function serverLine(entry: ServerLogEntry, t: Translate): string {
@@ -45,3 +46,20 @@ export function simpleClientLine(entry: SimpleClientLogEntry, t: Translate): str
return t(`server.sendFailed.${entry.failure}`);
}
}
export function firewallLine(entry: FirewallLogEntry, t: Translate): string {
switch (entry.kind) {
case 'ruleMatched':
return t('personalFirewall.ruleMatched', {
number: entry.ruleNumber,
rule: firewallRuleText(entry.rule, entry.firstInterface),
action: t(entry.accepted ? 'firewall.accept' : 'firewall.drop'),
});
case 'icmpDropped':
return t('personalFirewall.icmpDropped', { sender: entry.senderIPAddress, receiver: entry.receiverIPAddress, code: entry.code, type: entry.type });
case 'portRuleAdded':
return t('personalFirewall.portRuleAdded', { port: entry.port, protocol: PORT_RULE_PROTOCOL_NAMES[entry.protocol] });
case 'portRuleRemoved':
return t('personalFirewall.portRuleRemoved');
}
}
packages/editor/src/i18n/de.json
+18
View File
@@ -248,6 +248,24 @@
"network.ipAddress": "IP-Adresse:",
"network.macAddress": "MAC-Adresse:",
"network.subnetMask": "Netzmaske:",
"personalFirewall.add": "Hinzufügen",
"personalFirewall.allSenders": "Alle Absender",
"personalFirewall.allowIcmp": "Internet Control Message Protocol (Ping etc.) erlauben",
"personalFirewall.delete": "Löschen",
"personalFirewall.filterUdp": "Aktiviere UDP-Datenverkehrfilter",
"personalFirewall.hint": "Die Firewall blockiert alle eingehenden IP-Pakete, wenn sie aktiviert wurde. Ausnahmen müssen explizit angegeben werden. Regeln bestimmen TCP-/UDP-Ports, für die Daten zugelassen werden und ob die Ausnahme nur für alle Absender oder nur für Absender im lokalen Rechnernetz gilt.",
"personalFirewall.icmpDropped": "ICMP-Paket verworfen: {sender} -> {receiver} (code: {code}, type: {type})",
"personalFirewall.localNetwork": "Nur lokales Rechnernetz",
"personalFirewall.log": "Log",
"personalFirewall.port": "Zulässiger Port/Protokoll:",
"personalFirewall.portColumn": "Port",
"personalFirewall.portRuleAdded": "Portregel wurde hinzugefügt: {port}/{protocol}",
"personalFirewall.portRuleRemoved": "Portregel wurde entfernt.",
"personalFirewall.ruleMatched": "Firewall-Regel hat gegriffen: #{number} ({rule}) -> {action}",
"personalFirewall.rules": "Regeln",
"personalFirewall.sameNetwork": "Absender im gleichen Rechnernetz",
"personalFirewall.sender": "Absender",
"personalFirewall.setup": "Konfiguration",
"program.commandPrompt": "Befehlszeile",
"program.dnsServer": "DNS-Server",
"program.echoServer": "Echo-Server",
packages/editor/src/i18n/en.json
+18
View File
@@ -248,6 +248,24 @@
"network.ipAddress": "IP address:",
"network.macAddress": "MAC address:",
"network.subnetMask": "Netmask:",
"personalFirewall.add": "Add",
"personalFirewall.allSenders": "All sender",
"personalFirewall.allowIcmp": "Allow Internet Control Message Protocol (Ping etc.)",
"personalFirewall.delete": "Delete",
"personalFirewall.filterUdp": "Activate UDP traffic filter",
"personalFirewall.hint": "The firewall blocks incoming IP packets, if it is activated. Exceptions must be declared. Rules define opened ports and whether they are opened for global or local sender.",
"personalFirewall.icmpDropped": "Dropped ICMP packet: {sender} -> {receiver} (code: {code}, type: {type})",
"personalFirewall.localNetwork": "Local network",
"personalFirewall.log": "Log",
"personalFirewall.port": "Opened port/protocol:",
"personalFirewall.portColumn": "Port",
"personalFirewall.portRuleAdded": "Port rule is added: {port}/{protocol}",
"personalFirewall.portRuleRemoved": "Delete port rule.",
"personalFirewall.ruleMatched": "Firewall rule matched: #{number} ({rule}) -> {action}",
"personalFirewall.rules": "Rules",
"personalFirewall.sameNetwork": "Local sender",
"personalFirewall.sender": "Sender",
"personalFirewall.setup": "Setup",
"program.commandPrompt": "Command Line",
"program.dnsServer": "DNS server",
"program.echoServer": "Echo server",
packages/editor/test/i18n.test.ts
+17
View File
@@ -175,6 +175,20 @@ const FROM_JAVA: Readonly<Record<string, string>> = {
'firewall.dropIcmp': 'jfirewalldialog_msg40',
'firewall.dropIcmpHint': 'jfirewalldialog_msg41',
'firewall.filterSyn': 'jfirewalldialog_msg42',
'personalFirewall.hint': 'firewall_msg2',
'personalFirewall.port': 'firewall_msg3',
'personalFirewall.allSenders': 'firewall_msg4',
'personalFirewall.sameNetwork': 'firewall_msg5',
'personalFirewall.add': 'firewall_msg6',
'personalFirewall.delete': 'firewall_msg7',
'personalFirewall.portColumn': 'firewall_msg8',
'personalFirewall.sender': 'firewall_msg9',
'personalFirewall.setup': 'firewall_msg10',
'personalFirewall.log': 'firewall_msg11',
'personalFirewall.localNetwork': 'firewall_msg12',
'personalFirewall.allowIcmp': 'firewall_msg13',
'personalFirewall.filterUdp': 'firewall_msg14',
'personalFirewall.portRuleRemoved': 'sw_firewall_msg7',
'sheet.connections': 'jvermittlungsrechnerkonfiguration_msg23',
'connections.local': 'jvermittlungsrechnerkonfiguration_msg22',
'connections.add': 'jvermittlungsrechnerkonfiguration_msg24',
@@ -319,6 +333,9 @@ const FROM_JAVA_JOINED: Readonly<Record<string, readonly [string, string, string
/** Java's words before a value, joined as its programs join them (SMTPMitarbeiter, SMTPClient, the server window's question). */
const FROM_JAVA_BEFORE: Readonly<Record<string, readonly [string, string, string?]>> = {
'personalFirewall.ruleMatched': ['sw_firewall_msg8', ' #{number} ({rule}) -> {action}'],
'personalFirewall.icmpDropped': ['firewallthread_msg1', ' {sender} -> {receiver} (code: {code}, type: {type})'],
'personalFirewall.portRuleAdded': ['sw_firewall_msg5', ' {port}/{protocol}'],
'mail.sendFailed': ['sw_smtpmitarbeiter_msg14', ' {address}'],
'mail.mailSent': ['sw_smtpclient_msg4', ' {recipients}'],
// "'" + name + "'", the question's two halves written against it.
packages/editor/test/serverLines.test.ts
+47 -3
View File
@@ -1,13 +1,17 @@
// A server's lines as Java's web server window wrote them
// (packages/sim/test/browserWindow.java.json, BrowserWindowRun): each kind
// the window got there, in Java's words.
// the window got there, in Java's words. And a computer's firewall's log and
// table as Java's firewall window wrote them
// (packages/core/test/firewallWindow.java.json, FirewallWindowRun).
import { readFileSync } from 'node:fs';
import { dirname, join } from 'node:path';
import { fileURLToPath } from 'node:url';
import { describe, expect, it } from 'vitest';
import type { ServerLogEntry, SimpleClientLogEntry } from '@mdg-filius/core';
import { serverLine, simpleClientLine } from '../src/desktop/serverLines.js';
import { DIRECTLY_CONNECTED_SOURCE_MARKER, firewallRule, type FirewallLogEntry, type ServerLogEntry, type SimpleClientLogEntry } from '@mdg-filius/core';
import type { FirewallViewRule } from '@mdg-filius/protocol';
import { firewallRow } from '../src/desktop/PersonalFirewallPanel.js';
import { firewallLine, serverLine, simpleClientLine } from '../src/desktop/serverLines.js';
import { translate } from '../src/i18n/i18n.js';
const java = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../../sim/test/browserWindow.java.json'), 'utf8')) as { steps: { step: string; log?: string }[] };
@@ -78,3 +82,43 @@ describe("the echo windows' lines", () => {
]).toEqual(['Fehler beim Verbindungsaufbau', 'Fehler beim Verbindungsaufbau\nAktives Öffnen des Sockets fehlgeschlagen', 'Keine Verbindung hergestellt!', 'Verbindung nicht aufgebaut!']);
});
});
describe("a computer's firewall's lines", () => {
const firewallJava = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../../core/test/firewallWindow.java.json'), 'utf8')) as { steps: { step: string; log: string }[] };
const javaLog = firewallJava.steps.find((step) => step.step === 'delete row 0')!.log.split('\n');
it("are Java's, line by line", () => {
const network = { ipAddress: '10.0.0.10', subnetMask: '255.255.255.0' };
const entries: FirewallLogEntry[] = [
{ kind: 'portRuleAdded', port: 55555, protocol: 'tcp' },
{ kind: 'ruleMatched', ruleNumber: 1, rule: firewallRule({ port: 55555, protocol: 'tcp', action: 'accept' }), firstInterface: network, accepted: true },
{ kind: 'ruleMatched', ruleNumber: 2, rule: firewallRule({ port: 53, protocol: 'udp', action: 'accept', sourceIPAddress: DIRECTLY_CONNECTED_SOURCE_MARKER }), firstInterface: network, accepted: true },
{ kind: 'icmpDropped', senderIPAddress: '10.0.0.2', receiverIPAddress: '10.0.0.10', type: 8, code: 0 },
{ kind: 'portRuleAdded', port: -1, protocol: 'all' },
{ kind: 'portRuleRemoved' },
];
const lines = entries.map((entry) => firewallLine(entry, t));
for (const line of lines) expect(javaLog, line).toContain(line);
expect(firewallLine({ kind: 'ruleMatched', ruleNumber: 3, rule: firewallRule({ port: 80 }), firstInterface: undefined, accepted: false }, t)).toBe(
'Firewall-Regel hat gegriffen: #3 (*/* -> */*; TCP:80 => DROP) -> verwerfen',
);
});
it("are the table's rows as Java's ruleToVector writes them, and name a rule the window cannot make", () => {
expect(
[
{ protocol: 'tcp', port: 55555, sender: 'all', text: '' },
{ protocol: 'udp', port: 53, sender: 'sameNetwork', text: '' },
{ protocol: 'all', port: -1, sender: 'all', text: '' },
{ protocol: 'tcp', port: 0, sender: 'all', text: '' },
{ protocol: 'icmp', port: -1, sender: null, text: '10.0.0.0/255.0.0.0 -> */*; ?:* => DROP' },
].map((rule) => firewallRow(rule as FirewallViewRule, t)),
).toEqual([
['TCP', '55555', 'Alle Absender'],
['UDP', '53', 'Nur lokales Rechnernetz'],
['*', '', 'Alle Absender'],
['TCP', '0', 'Alle Absender'],
['ICMP', '', '10.0.0.0/255.0.0.0 -> */*; ?:* => DROP'],
]);
});
});
packages/protocol/src/firewall.ts
+24
View File
@@ -0,0 +1,24 @@
// What a computer's firewall window shows besides its log, as the room keeps
// it and every client shows it (plan §7.3), after
// GUIApplicationFirewallWindow (measured with tools/java-oracle's
// FirewallWindowRun): its three boxes and the rules of its table. Its log
// comes as the window's lines: the firewall's log entries.
/** A rule as the window's table shows it. */
export interface FirewallViewRule {
readonly protocol: 'all' | 'tcp' | 'udp' | 'icmp';
/** The port, or -1 for every port. */
readonly port: number;
/** Java's sender column; null for a rule the window cannot make (one from a file that drops, or names an address). */
readonly sender: 'all' | 'sameNetwork' | null;
/** The rule whole, as the log names it (FirewallRule.toString). */
readonly text: string;
}
export interface FirewallView {
readonly active: boolean;
/** "Internet Control Message Protocol (Ping etc.) erlauben": the firewall does not drop ICMP. */
readonly icmpAllowed: boolean;
readonly filterUdp: boolean;
readonly rules: readonly FirewallViewRule[];
}
packages/protocol/src/index.ts
+1
View File
@@ -4,5 +4,6 @@ export * from './sim.js';
export * from './terminal.js';
export * from './dns.js';
export * from './echo.js';
export * from './firewall.js';
export * from './mail.js';
export * from './web.js';
packages/protocol/src/sim.ts
+1 -1
View File
@@ -9,7 +9,7 @@ import type { CaptureRow, PageLanguage } from '@mdg-filius/core';
export const SIM_PROTOCOL_VERSION = 1;
/** The programs whose windows a client can watch and act in. */
export const APP_KINDS = ['terminal', 'webBrowser', 'webServer', 'emailClient', 'emailServer', 'echoServer', 'simpleClient', 'gnutella', 'dnsServer'] as const;
export const APP_KINDS = ['terminal', 'webBrowser', 'webServer', 'emailClient', 'emailServer', 'echoServer', 'simpleClient', 'gnutella', 'dnsServer', 'firewall'] as const;
export type AppKind = (typeof APP_KINDS)[number];
/**
packages/sim/src/room.ts
+46
View File
@@ -48,7 +48,9 @@ import {
DEFAULT_SPEED_PERCENT,
NetworkRuntimeEngine,
captureRows,
firewallRuleText,
interfaceKey,
portRuleSender,
stableGeneratedMacAddress,
type CapturedFrame,
type CaptureRow,
@@ -73,6 +75,7 @@ import {
type EmailServerView,
type DnsServerView,
type EchoServerView,
type FirewallView,
type SimpleClientView,
type TraceFrame,
type WebServerView,
@@ -463,6 +466,8 @@ export class SimulationRoom {
return this.actInSimpleClient(input);
case 'dnsServer':
return this.actInDnsServer(input);
case 'firewall':
return this.actInFirewall(input);
default:
return 'unknownAction';
}
@@ -498,6 +503,36 @@ export class SimulationRoom {
}
}
/** A computer's firewall window: its three boxes, "Hinzufügen" with the port, the protocol and the senders chosen, "Löschen" of the row chosen. */
private actInFirewall(input: Extract<ClientMessage, { kind: 'input' }>): ErrorCode | undefined {
const configuration = this.engine.personalFirewall(input.node);
if (configuration === undefined) return 'unknownApp';
const { args } = input;
const set = (fields: Partial<typeof configuration>) => this.engine.setFirewallConfiguration(input.node, { ...configuration, ...fields });
switch (input.action) {
case 'setActive':
if (typeof args.active !== 'boolean') return 'badArgs';
set({ isActive: args.active });
return undefined;
case 'setIcmpAllowed':
if (typeof args.allowed !== 'boolean') return 'badArgs';
set({ dropIcmp: !args.allowed });
return undefined;
case 'setFilterUdp':
if (typeof args.enabled !== 'boolean') return 'badArgs';
set({ filterUdp: args.enabled });
return undefined;
case 'addRule':
if (!isPort(args.port) || args.port === 0 || (args.protocol !== 'tcp' && args.protocol !== 'udp' && args.protocol !== 'all') || typeof args.sameNetworkOnly !== 'boolean') return 'badArgs';
this.engine.addFirewallPortRule(input.node, args.port, args.protocol, args.sameNetworkOnly);
return undefined;
case 'removeRule':
return Number.isInteger(args.row) && this.engine.removeFirewallRule(input.node, args.row as number) ? undefined : 'badArgs';
default:
return 'unknownAction';
}
}
/** The start button with the port typed (Java's window sets the port before and after it starts the server). */
private actInEchoServer(input: Extract<ClientMessage, { kind: 'input' }>): ErrorCode | undefined {
const server = this.engine.echoServer(input.node);
@@ -680,6 +715,14 @@ export class SimulationRoom {
const view: DnsServerView = { active: server.isActive, recursive: server.recursiveResolutionEnabled, rows: { A: rows('A'), MX: rows('MX'), NS: rows('NS') } };
return view;
}
case 'firewall': {
const configuration = this.engine.personalFirewall(node);
if (configuration === undefined) return null;
const first = this.engine.networkInterfaces(node)[0];
const rules = configuration.rules.map((rule) => ({ protocol: rule.protocol, port: rule.port, sender: portRuleSender(rule) ?? null, text: firewallRuleText(rule, first) }));
const view: FirewallView = { active: configuration.isActive, icmpAllowed: !configuration.dropIcmp, filterUdp: configuration.filterUdp, rules };
return view;
}
case 'echoServer': {
const server = this.engine.echoServer(node);
if (server === undefined) return null;
@@ -725,6 +768,9 @@ export class SimulationRoom {
return this.engine.simpleClient(node);
case 'gnutella':
return this.engine.gnutella(node);
case 'firewall':
// Its log outlives a stop, as the engine keeps it.
return this.engine.personalFirewall(node) === undefined ? undefined : { log: { all: this.engine.firewallLog(node) } };
}
}
packages/sim/test/firewallWindow.test.ts
+129
View File
@@ -0,0 +1,129 @@
// A computer's firewall window in the room, on FILIUS' example
// email_komplett with a firewall installed on its web server: its view (the
// three boxes, the rules as the table shows them), its actions, its log as
// the window's lines (also over a stop), and what a run leaves in the
// project. The firewall's steps against Java's window are
// packages/core/test/firewallWindow.test.ts.
import { readFileSync } from 'node:fs';
import { dirname, join } from 'node:path';
import { fileURLToPath } from 'node:url';
import { describe, expect, it } from 'vitest';
import * as Y from 'yjs';
import { DIRECTLY_CONNECTED_SOURCE_MARKER, firewallRule } from '@mdg-filius/core';
import { addFirewallRule, readProject, setSoftware, writeProject } from '@mdg-filius/doc';
import { openProjectArchive } from '@mdg-filius/fls';
import type { FirewallView, HostMessage } from '@mdg-filius/protocol';
import { SimulationRoom, TICK_MILLISECONDS } from '../src/index.js';
const here = dirname(fileURLToPath(import.meta.url));
const corpus = join(here, '../../../corpus/java-examples');
function setUp(name = 'Web-Server', fromFile = false) {
let ids = 0;
const doc = new Y.Doc();
writeProject(
doc,
openProjectArchive(new Uint8Array(readFileSync(join(corpus, 'email_komplett.fls'))), () => `00000000-0000-0000-0000-${(++ids).toString(16).padStart(12, '0')}`),
);
const idOf = (displayName: string) => readProject(doc).graph.nodes.find((node) => node.displayName === displayName)!.id;
setSoftware(doc, idOf('Web-Server'), { install: ['firewall'], remove: [] }, 'de', 'me');
// A rule as a file may hold it and the window cannot make: TCP, every port, dropped.
if (fromFile) addFirewallRule(doc, idOf('Web-Server'), 'me');
const id = idOf(name);
let now = 0;
const room = new SimulationRoom(doc, { now: () => now, seed: () => 5 });
let view: FirewallView | null | undefined;
const errors: string[] = [];
const lines: unknown[] = [];
const client = room.connect((message: HostMessage) => {
if (message.kind === 'app' && message.app === 'firewall') {
lines.length = message.from;
lines.push(...message.lines);
}
if (message.kind === 'view' && message.app === 'firewall') view = message.view as FirewallView | null;
if (message.kind === 'error') errors.push(message.code);
});
const send = (fields: object) => room.receive(client, { v: 1, ...fields });
send({ kind: 'sub', topics: [`app:${id}/firewall`] });
send({ kind: 'start' });
const run = (milliseconds: number) => {
for (let elapsed = 0; elapsed < milliseconds; elapsed += TICK_MILLISECONDS) {
now += TICK_MILLISECONDS;
room.tick();
}
};
run(TICK_MILLISECONDS);
const act = (action: string, args: object = {}) => send({ kind: 'input', node: id, app: 'firewall', action, args, reqId: action });
return { doc, id, view: () => view, errors, lines, act, run, send, now: () => now };
}
describe("a computer's firewall window in the room", () => {
it('shows the boxes and the rules, takes its actions, and sends its log as lines', () => {
const { view, act, errors, lines, send, run, now } = setUp();
// Active as Java installs it.
expect(view()).toEqual({ active: true, icmpAllowed: true, filterUdp: true, rules: [] });
run(1000);
act('addRule', { port: 80, protocol: 'tcp', sameNetworkOnly: false });
// A line carries the time of the simulation it was written at.
expect(lines).toEqual([{ kind: 'portRuleAdded', port: 80, protocol: 'tcp', timeMilliseconds: now() }]);
act('addRule', { port: 53, protocol: 'all', sameNetworkOnly: true });
expect(view()!.rules).toEqual([
{ protocol: 'tcp', port: 80, sender: 'all', text: '*/* -> */*; TCP:80 => ACCEPT' },
{ protocol: 'all', port: 53, sender: 'sameNetwork', text: '141.99.50.128/255.255.255.128 -> */*; *:53 => ACCEPT' },
]);
act('setIcmpAllowed', { allowed: false });
act('setFilterUdp', { enabled: false });
act('setActive', { active: false });
expect(view()).toMatchObject({ active: false, icmpAllowed: false, filterUdp: false });
act('removeRule', { row: 0 });
expect(view()!.rules.map((rule) => rule.port)).toEqual([53]);
expect(errors).toEqual([]);
expect(lines).toMatchObject([{ kind: 'portRuleAdded', port: 80, protocol: 'tcp' }, { kind: 'portRuleAdded', port: 53, protocol: 'all' }, { kind: 'portRuleRemoved' }]);
// The log outlives a stop and a new start, as the engine keeps it.
send({ kind: 'stop' });
send({ kind: 'start' });
act('addRule', { port: 25, protocol: 'tcp', sameNetworkOnly: false });
expect(lines.map((line) => (line as { kind: string }).kind)).toEqual(['portRuleAdded', 'portRuleAdded', 'portRuleRemoved', 'portRuleAdded']);
});
it('shows a rule the window cannot make as what it is', () => {
const { view } = setUp('Web-Server', true);
expect(view()!.rules).toEqual([{ protocol: 'tcp', port: -1, sender: null, text: '*/* -> */*; TCP:* => DROP' }]);
});
it('leaves in the project what the run made of the firewall', () => {
const { doc, id, act, send } = setUp();
act('addRule', { port: 80, protocol: 'udp', sameNetworkOnly: true });
act('setIcmpAllowed', { allowed: false });
send({ kind: 'stop' });
expect(readProject(doc).firewallConfigurationsByNodeId.get(id)).toMatchObject({
isActive: true,
dropIcmp: true,
filterUdp: true,
rules: [firewallRule({ port: 80, protocol: 'udp', action: 'accept', sourceIPAddress: DIRECTLY_CONNECTED_SOURCE_MARKER })],
});
});
it('refuses what the window never hands over', () => {
const { act, errors } = setUp();
act('setActive', { active: 'no' });
act('setIcmpAllowed', {});
act('setFilterUdp', { enabled: 1 });
act('addRule', { port: 0, protocol: 'tcp', sameNetworkOnly: false });
act('addRule', { port: 65_536, protocol: 'tcp', sameNetworkOnly: false });
act('addRule', { port: 80, protocol: 'icmp', sameNetworkOnly: false });
act('addRule', { port: 80, protocol: 'tcp' });
act('removeRule', { row: 0 });
act('removeRule', { row: 'x' });
act('restart');
expect(errors).toEqual(['badArgs', 'badArgs', 'badArgs', 'badArgs', 'badArgs', 'badArgs', 'badArgs', 'badArgs', 'badArgs', 'unknownAction']);
});
it('has no window on a computer without a firewall', () => {
const { view, act, errors } = setUp('DNS-Server');
expect(view()).toBeNull();
act('setActive', { active: false });
expect(errors).toEqual(['unknownApp']);
});
});