Přeskočit na obsah

macOS sandbox blokuje procesní FD, mktemp i privátní Unix socket

import { Aside } from ‘@astrojs/starlight/components’;

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.

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“.

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:

  1. přesný vzor s uloženými stdout/stderr FD a dvěma tee process substitutions musí projít;
  2. nesouvisející printf ... > /tmp/nahodny-soubor musí zůstat zamítnutý.

Pro dočasné adresáře vždy zadej explicitní šablonu:

Terminál
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 -d bez šablony; hardcoded /tmp bez kontroly návratové hodnoty; realpath prázdného výsledku; povolení /dev/fd testované pouze přes diff <(...); více sandbox filtrů bez require-all; obecné povolení network-bind; pokus vnořit Seatbelt nebo povolit celý /tmp kvůli ExposeAuthInfo.
  • 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í”
Přidal aiarchitekt.cz · 25. 8. 2026 2:00
Provozuje aiarchitekt.cz