macOS sandbox blokuje procesní FD, mktemp i privátní Unix socket
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Shellový gate funguje mimo sandbox, ale uvnitř macOS sandbox-exec skončí na Operation not permitted při řádku typu exec > >(tee ...). Jiný test může selhat už při mktemp -d, přestože proces dostal privátní TMPDIR.
Node runner může navíc skončit na listen EPERM .../runner.pipe: vytvoření souboru socketu je povolené, ale samotný bind stále blokuje síťová politika sandboxu.
Izolovaný integrační test s vlastním sshd může autentizaci ukončit hláškou sandbox initialization failed: Operation not permitted. Po vypnutí vnitřního OpenSSH sandboxu může další krok selhat na prepare_auth_info_file: mkstemp: Operation not permitted, jakmile konfigurace zapne ExposeAuthInfo.
Příliš široká domnělá oprava může následně nechtěně povolit libovolný zápis provedený Bashem.
Root cause
Sekce “Root cause”Bash implementuje process substitution přes /dev/fd/<N>. Vstupní varianta jako diff <(...) potřebuje čtení, ale transcriptový vzor exec > >(tee ...) vyžaduje, aby Bash mohl příslušný deskriptor také otevřít pro zápis.
macOS mktemp -d bez explicitní šablony navíc nemusí použít předaný TMPDIR; může zvolit systémový uživatelský temp adresář. Ten není součástí privátního write allowlistu.
Starší testy mohou mít naopak absolutní šablonu /tmp/nazev-XXXXXX. V sandboxu zápis selže, ale složený příkaz může pokračovat s prázdným výstupem; následný realpath("") pak označí pracovní adresář jako fixture root a test znečistí samotný repozitář.
Unix-domain socket má dvě nezávislé stránky: souborovou cestu a operaci network-bind. Povolit zápis do adresáře tedy nestačí. Naopak obecné (allow network-bind) by zbytečně otevřelo všechny lokální bindy.
macOS Seatbelt se v již omezeném procesu nedá spolehlivě inicializovat podruhé. Portable OpenSSH na Darwin proto může uvnitř vnějšího sandbox-exec selhat ještě před spuštěním testovaného forced commandu. Jde o vlastnost topologie sandboxů, ne o chybějící běžné unixové oprávnění. Produkční sshd navíc při ExposeAuthInfo yes vytváří soubor podle pevné šablony /tmp/sshauth.* před startem uživatelského příkazu; předaný TMPDIR tuto cestu neovlivní.
V sandbox profilu jsou samostatné filtry u jedné operace alternativy, ne automaticky logická konjunkce. Tohle pravidlo je proto nebezpečně široké:
(allow file-write* (subpath "/dev/fd") (process-path "/bin/bash"))Prakticky může znamenat „cesta je /dev/fd NEBO proces je Bash“.
Fix
Sekce “Fix”Pro transcriptovou process substitution povol jen průnik procesu a cesty:
(allow file-read* (subpath "/dev/fd"))(allow file-write* (require-all (subpath "/dev/fd") (process-path "/bin/bash")))Do regresní sady přidej dva behaviorální testy:
- přesný vzor s uloženými stdout/stderr FD a dvěma
teeprocess substitutions musí projít; - nesouvisející
printf ... > /tmp/nahodny-soubormusí zůstat zamítnutý.
Pro dočasné adresáře vždy zadej explicitní šablonu:
work=$(mktemp -d "${TMPDIR:-/tmp}/gate.XXXXXX")Pokud musí centrální runner podporovat staré neměnné testy, vlož před ně úzký mktemp shim: přijímej jen bezpečný basename absolutní /tmp šablony a přepiš jej pod privátní TMPDIR. Nikdy nepovoluj celý sdílený /tmp a po mktemp vždy ověř neprázdnou cestu před realpath či mazáním.
Pokud runner používá Unix IPC, přidej po obecném zákazu sítě jen cestově omezenou výjimku:
(deny network*)(allow network-bind (prefix "/private/tmp/gate-jednoho-behu"))Regrese musí doložit obě strany: socket uvnitř privátního adresáře projde, socket v jinak zapisovatelném pracovním stromu zůstane zamítnutý.
Pro produkčně věrný OpenSSH test na macOS použij samostatně sestavenou testovací runtime bez vnitřního sandbox backendu. Binárky i pomocné procesy hashově ukotvi a jejich digest ověř před každým během gate. Tato runtime patří jen do testů; nesmí nahrazovat systémový produkční démon.
Pokud test zapíná ExposeAuthInfo, povol ve vnějším Seatbelt profilu pouze přesnou generovanou šablonu /private/tmp/sshauth. a její /tmp alias. Nepovoluj celý sdílený temp. Přidej behaviorální zuby pro úspěšnou atestaci, podvržený hash testovací runtime a nesouvisející zápis do /tmp, který musí zůstat zamítnutý.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: spusť celý skutečný gate v cílovém sandbox profilu, ne jen jednotlivé příkazy mimo sandbox.
- Anti-pattern:
mktemp -dbez šablony; hardcoded/tmpbez kontroly návratové hodnoty;realpathprázdného výsledku; povolení/dev/fdtestované pouze přesdiff <(...); více sandbox filtrů bezrequire-all; obecné povolenínetwork-bind; pokus vnořit Seatbelt nebo povolit celý/tmpkvůliExposeAuthInfo. - Lepší přístup: behaviorální pozitivní zub pro přesný wrapper a současně negativní zub dokazující, že obecný zápis mimo privátní temp zůstává zakázaný.
Sister bugs / související
Sekce “Sister bugs / související”- macOS Unix socket path limit u SSH ControlMaster
- Obecně stejný princip platí pro FIFO, heredoc a další FD orchestrace: test musí kopírovat skutečnou topologii deskriptorů, ne její zjednodušenou náhradu.