AtlatestRepositorysigil-http3
sigil-http3 / tree / scriptspunch-firewall.mjs
1
// Generate one exact root command pair; this module never executes firewall tools.2
import { writeFileSync, mkdirSync } from 'node:fs';3
import { join } from 'node:path';4
import { isIP } from 'node:net';5
import { execFileSync } from 'node:child_process';6
const quote = value => "'" + String(value).replaceAll("'", "'\\''") + "'";8
export 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 bash19
set -euo pipefail20
(( EUID == 0 )) || { printf 'Run with sudo bash.\\n' >&2; exit 1; }21
umask 02222
firewall=/gnu/store/c3fa94c62chbj42q905zfi33x7z7kr9m-iptables-1.8.11/sbin/ip6tables23
directory=${quote(directory)}24
rule=(-i ${quote(interfaceName)} -d ${quote(bindAddress + '/128')} -p udp --dport ${destination} -m comment --comment ${quote(ruleComment)} -j ACCEPT)25
verify_close() {26
local result27
"$firewall" -w 5 -S INPUT >/dev/null28
if "$firewall" -w 5 -C INPUT "\${rule[@]}" 2>/dev/null; then29
"$firewall" -w 5 -D INPUT "\${rule[@]}"30
else31
result=$?32
(( result == 1 )) || return "$result"33
fi34
if "$firewall" -w 5 -C INPUT "\${rule[@]}" 2>/dev/null; then35
printf 'ERROR: matching punch allowance remains.\\n' >&236
return 137
else38
result=$?39
(( result == 1 )) || return "$result"40
fi41
if [[ ! -e "$directory/closed.json" ]]; then42
(set -C; printf '{"schema":1,"verifiedAbsent":true,"closedEpoch":%s}\\n' "$(date +%s)" > "$directory/closed.json")43
fi44
printf 'Matching punch allowance absent.\\n'45
}46
`;47
const open = common + `48
controller_alive() {49
local stat_line rest50
local -a fields51
[[ -r /proc/${supervisor.pid}/stat ]] || return 152
[[ $(stat -c %u /proc/${supervisor.pid}) == ${supervisor.uid} ]] || return 153
read -r stat_line < /proc/${supervisor.pid}/stat || return 154
rest=\${stat_line##*) }55
read -r -a fields <<< "$rest"56
[[ \${fields[19]:-} == ${quote(supervisor.start)} && \${fields[0]:-} != Z ]]57
}58
controller_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; }60
if "$firewall" -w 5 -C INPUT "\${rule[@]}" 2>/dev/null; then61
printf 'Matching punch allowance already exists; do not adopt it.\\n' >&262
exit 163
fi64
installed=065
cleanup() { if (( installed )); then verify_close; fi; }66
trap cleanup EXIT67
trap 'exit 130' INT68
trap 'exit 143' TERM HUP69
installed=170
"$firewall" -w 5 -I INPUT 1 "\${rule[@]}"71
"$firewall" -w 5 -C INPUT "\${rule[@]}"72
opened=$(date +%s)73
expires=$(( 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")75
printf 'Punch allowance opened; automatic close at 75 minutes or recorded controller exit. Keep this foreground guard running.\\n'76
while (( $(date +%s) < expires )) && controller_alive && [[ ! -e "$directory/closed.json" ]]; do sleep 1; done77
`;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')]);82
}