AtlatestRepositorysigil-http3

sigil-http3 / tree / scriptspunch-firewall.mjs

1// Generate one exact root command pair; this module never executes firewall tools.
2import { writeFileSync, mkdirSync } from 'node:fs';
3import { join } from 'node:path';
4import { isIP } from 'node:net';
5import { execFileSync } from 'node:child_process';
6const quote = value => "'" + String(value).replaceAll("'", "'\\''") + "'";
7
8export function preparePunchFirewall(directory, { bindAddress, interfaceName, supervisor,
9 ruleComment = 'sigil-http3-example', webrtc = false }) {
10 if (isIP(bindAddress) !== 6 || !/^[23][0-9a-f:]+$/i.test(bindAddress) ||
11 !/^[-a-zA-Z0-9_.]+$/.test(interfaceName) || !Number.isInteger(supervisor?.pid) ||
12 !/^[0-9]+$/.test(supervisor.start) || !Number.isInteger(supervisor.uid) ||
13 !(webrtc ? /^sigil-http3-webrtc-phone-[0-9]{3}$/ : /^sigil-http3-ipv6-punch-[0-9]{3}$/).test(ruleComment))
14 throw new Error('Invalid exact firewall target/controller');
15 const destination = webrtc ? '44000:44009' : '43443';
16 const portProof = webrtc ? '"minPort":44000,"maxPort":44009' : '"port":43443';
17 mkdirSync(directory, { mode: 0o700 });
18 const common = `#!/usr/bin/env bash
19set -euo pipefail
20(( EUID == 0 )) || { printf 'Run with sudo bash.\\n' >&2; exit 1; }
21umask 022
22firewall=/gnu/store/c3fa94c62chbj42q905zfi33x7z7kr9m-iptables-1.8.11/sbin/ip6tables
23directory=${quote(directory)}
24rule=(-i ${quote(interfaceName)} -d ${quote(bindAddress + '/128')} -p udp --dport ${destination} -m comment --comment ${quote(ruleComment)} -j ACCEPT)
25verify_close() {
26 local result
27 "$firewall" -w 5 -S INPUT >/dev/null
28 if "$firewall" -w 5 -C INPUT "\${rule[@]}" 2>/dev/null; then
29 "$firewall" -w 5 -D INPUT "\${rule[@]}"
30 else
31 result=$?
32 (( result == 1 )) || return "$result"
33 fi
34 if "$firewall" -w 5 -C INPUT "\${rule[@]}" 2>/dev/null; then
35 printf 'ERROR: matching punch allowance remains.\\n' >&2
36 return 1
37 else
38 result=$?
39 (( result == 1 )) || return "$result"
40 fi
41 if [[ ! -e "$directory/closed.json" ]]; then
42 (set -C; printf '{"schema":1,"verifiedAbsent":true,"closedEpoch":%s}\\n' "$(date +%s)" > "$directory/closed.json")
43 fi
44 printf 'Matching punch allowance absent.\\n'
46`;
47 const open = common + `
48controller_alive() {
49 local stat_line rest
50 local -a fields
51 [[ -r /proc/${supervisor.pid}/stat ]] || return 1
52 [[ $(stat -c %u /proc/${supervisor.pid}) == ${supervisor.uid} ]] || return 1
53 read -r stat_line < /proc/${supervisor.pid}/stat || return 1
54 rest=\${stat_line##*) }
55 read -r -a fields <<< "$rest"
56 [[ \${fields[19]:-} == ${quote(supervisor.start)} && \${fields[0]:-} != Z ]]
58controller_alive || { printf 'Recorded punch controller is gone.\\n' >&2; exit 1; }
59[[ ! -e "$directory/opened.json" && ! -e "$directory/closed.json" ]] || { printf 'Choose a fresh window.\\n' >&2; exit 1; }
60if "$firewall" -w 5 -C INPUT "\${rule[@]}" 2>/dev/null; then
61 printf 'Matching punch allowance already exists; do not adopt it.\\n' >&2
62 exit 1
63fi
64installed=0
65cleanup() { if (( installed )); then verify_close; fi; }
66trap cleanup EXIT
67trap 'exit 130' INT
68trap 'exit 143' TERM HUP
69installed=1
70"$firewall" -w 5 -I INPUT 1 "\${rule[@]}"
71"$firewall" -w 5 -C INPUT "\${rule[@]}"
72opened=$(date +%s)
73expires=$(( opened + 4500 ))
74(set -C; printf '{"schema":1,${portProof},"address":"${bindAddress}","supervisorPID":${supervisor.pid},"supervisorStart":"${supervisor.start}","openedEpoch":%s,"expiresEpoch":%s}\\n' "$opened" "$expires" > "$directory/opened.json")
75printf 'Punch allowance opened; automatic close at 75 minutes or recorded controller exit. Keep this foreground guard running.\\n'
76while (( $(date +%s) < expires )) && controller_alive && [[ ! -e "$directory/closed.json" ]]; do sleep 1; done
77`;
78 writeFileSync(join(directory, 'open.sh'), open, { mode: 0o600 });
79 writeFileSync(join(directory, 'close.sh'), common + '\nverify_close\n', { mode: 0o600 });
80 execFileSync('bash', ['-n', join(directory, 'open.sh')]);
81 execFileSync('bash', ['-n', join(directory, 'close.sh')]);