From f7cff869b765e720aa1a09d1bae7303b86f4221e Mon Sep 17 00:00:00 2001 From: xop-bot Date: Wed, 7 Oct 2026 14:05:11 +0800 Subject: [PATCH] v0.4: SSH_ASKPASS injection + macOS test path portability MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 影响: 直连 ssh 现在能用 xop run --askpass=NAME -- ssh user@host, 密码经 mkdtemp 0700 临时目录的 0600 data + 0700 getpass.sh 注入, 既不进 argv 也不进 env, ps 干净。68 unit + 24 integration 全绿 (含 macOS /var/folders/.../T temp dir 兼容)。 改动: - 新增 src/askpass.rs: mkdtemp(0700) + 0600 data + 0700 getpass.sh (cat "$XOP_ASKPASS_DATA"); AskpassHandle::Drop 跑 srm -m (fallback rm -rf); env_vars() 输出 SSH_ASKPASS + SSH_ASKPASS_REQUIRE=force + DISPLAY=:0 + XOP_ASKPASS_DATA - 新增 --askpass=NAME flag (Args + Run subcommand) - SecretRef::askpass: bool 标志 + askpass() ctor; ResolvedValue 镜像 - run_exec Phase 3.5: askpass refs 从 envp_resolved 切出来单独 setup, 放在 audit spawn_event 之前 (setup 失败不留孤儿事件); stdout guard 看完整 resolved 集做兜底 - injector::plan() 移除 SSH_* 自动检测; InjectStrategy::Askpass/Fd 变体删掉; askpass 改显式 opt-in (--askpass=NAME) - Error::Io(String, String) 退出码 73, askpass setup/chmod/write 失败 - tests/integration.rs run_askpass_sets_ssh_env_vars: SSH_ASKPASS 路径改 substring 匹配 (SSH_ASKPASS= + /xop-askpass- + /getpass.sh), 兼容 Linux /tmp 与 macOS /var/folders/.../T (per-user, world-unreadable) - AGENTS.md: v0.4 状态加 e2e 实测标注, 踩坑 #22 (vault key 名 ≠ 字面值) - HANDOFF.md: 测试数 62→68 / 15→24, status line 加 e2e 实测标注, smoke 命令加 askpass 用法 设计: 沿用 v0.3 argv_placeholder 模式 (SecretRef 标志位 + run_exec 单 vault open); ssh 本身不读 env, 强制 SSH_ASKPASS_REQUIRE=force 让 ssh 必走 askpass 脚本; 不沿用 sshpass -e 的 env hack (那个不解决 ps 泄漏)。temp_dir 走 std::env::temp_dir() 不写死 /tmp, 因为 macOS /var/folders/.../T 是 per-user + world-unreadable, 比 /tmp 更合适。 Co-Authored-By: Claude Code --- AGENTS.md | 62 +++++++---- Cargo.lock | 2 +- Cargo.toml | 2 +- HANDOFF.md | 36 +++++-- src/args.rs | 35 ++++++- src/askpass.rs | 237 +++++++++++++++++++++++++++++++++++++++++++ src/error.rs | 4 +- src/guard/stdout.rs | 1 + src/injector.rs | 96 +++++++----------- src/lib.rs | 85 +++++++++++++--- src/policy.rs | 1 + src/secret.rs | 28 ++++- src/vault/mod.rs | 1 + tests/integration.rs | 200 +++++++++++++++++++++++++++++++++++- 14 files changed, 673 insertions(+), 117 deletions(-) create mode 100644 src/askpass.rs diff --git a/AGENTS.md b/AGENTS.md index 6c10bfc..917ec47 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,10 +24,10 @@ cd /Users/xs/Documents/xop # 快速检查(增量编译,最常用) cargo check --all-targets -# 跑单元测试(64 个:args(含 get -v 解析)/ secret / policy / audit / vault / keyring / auth(touchid classify + decide 决策表)/ stdout-guard / error / injector) +# 跑单元测试(68 个:args(含 get -v 解析)/ secret / policy / audit / vault / keyring / auth(touchid classify + decide 决策表)/ stdout-guard / error / injector / askpass) cargo test --lib -# 跑集成测试(17 个:help / dry-run / bad-ref / secrets-file / mask 端到端 / keyring 免密解锁 / SSH-headless / get 默认 mask / get -v 明文) +# 跑集成测试(24 个:help / dry-run / bad-ref / secrets-file / mask 端到端 / keyring 免密解锁 / SSH-headless / get 默认 mask / get -v 明文 / 6 askpass) # 集成测试需要 auth bypass + 已知 passphrase。`XOP_VAULT_PASSWORD` 仅在 # `--features test-bypass` 构建中才被读取;release binary 永远不读这个 env # ——passphrase 必须用户亲输。所以集成测试必须显式启用 feature。 @@ -85,14 +85,19 @@ xop --secret DB_PASS=db_pass \ -- mysql -h mysql.local -u app mydb # ── `xop run`:envp 注入 + argv 占位符(推荐用于 SSH)──────────────── -# envp 注入:vault 值 → 子进程环境变量 +# envp 注入:vault 值 → 子进程环境变量(sshpass -e 读 $SSHPASS) xop run --secret SSHPASS=s11_pass \ --allow-net=192.168.1.19:22 --deny-net='*' \ -- sshpass -e ssh rong@192.168.1.19 'ls /Users' -# argv 占位符:vault 值直接替换 argv 里的 xop://KEY 字符串 -# ⚠️ 替换后的字符串会出现在 /bin/ps 里 —— 密码用 --secret,命令行参数用 xop:// -xop run -- ssh user@host 'echo connect with xop://DB_PASS' +# argv 占位符:vault 值直接替换 argv 里的 %XOP_KEY% 字符串 +# ⚠️ 替换后的字符串会出现在 /bin/ps 里 —— 密码用 --secret,命令行参数用 %XOP_KEY% +xop run -- ssh user@host 'echo connect with %XOP_DB_PASS%' + +# SSH_ASKPASS 注入(v0.4,推荐用于直连 ssh)—— 密码既不进 argv 也不进 env: +# mkdtemp 0700 临时目录里写 0600 data + 0700 getpass.sh,子进程通过 +# SSH_ASKPASS=