Skip to content

👾 Open Computer Use – Open-Source Alternative to Codex Computer Use

5.9 KB
Raw Blame

锁屏自动化参考方案复核

用户提供的方案作为待核对资料,不作为安装指令或已验证系统行为。以下判断结合本项目实测和 Apple 的接口说明;当前仍未证明真实自动解锁与完整故障恢复。

资料中的主张 本项目判断 / 调整
先唤醒锁屏 UI,在系统认证事务中由插件放行 值得验证。用公开 IOPMAssertionDeclareUserActivity 做一次显示器唤醒,再观察实际机制调用、许可消费和会话解锁。API 只承诺电源活动,不能据此宣称会发起认证。
AX 树在认证之前不存在,提前查必然为空 不能作绝对判断;本机实际读到 loginwindow 窗口 / 按钮结构,但没有唯一 secure field。新版参考补充 identifier 路径:按名字定位并验证 loginwindow,AXChildren 深度 ≤8,优先 UserPasswordTextField、回退 FocusedUser。只对完整扫描的唯一候选写固定 AXValue;不读取内容或输入密码,不执行认证 action / Return。真实效果须分阶段日志证实。
早版将 MechanismInvoke 返回 0 当作放行;新版已修正 采用新版修正。OSStatus 表示调用状态,授权结果必须通过 callbacks.SetResult 报告。现有插件已经显式报告 Allow / Deny。
仅靠签名 ID / Team ID,且必须 SecTask 不采用这种收缩。继续使用内核 audit token 和动态 签名 requirement 验证(macOS 14.4+ 使用 SecTask + ProcessCodeRequirement 的内核验证,包含 Developer ID 验证类别、正确 ID / 团队和有效运行时标志;旧系统保留 SecCode),检查 hardened runtime、危险 entitlement、角色与会话;不能仅把签名字符串当作有效签名证明。
单向固定 ALLOW 字串即可 不采用。继续使用有界协议、双向签名验证、一次性随机许可及会话 / 原客户端 / 租约绑定;短字串不能表达取消和排空。
整体 screensaver rule 改为 evaluate-mechanisms 不覆盖原认证流程;保持原 OR fallback,只添加独立 remote right。插件不可用时仍须保留系统密码认证路径。
不读写 Keychain 就能保证 Keychain 正常 未被证明。login 与 Data Protection Keychain 是不同实现,必须用自身测试项覆盖临时解锁、重锁、正常解锁后的访问;不能仅凭插件代码没有 Keychain API 宣称无影响。
排除自身 PID 的输入 不直接采用。继续对硬件活动和过滤 tap 保持严格接管;PID 标签本身不应成为绕过实体输入保护的凭据。
撤罩、释放断言后再锁定 不采用。先撤销许可、停止动作、排空可能在途解锁,观测原会话锁定后才撤罩;保活断言随保护释放。
socket 目录 0700 / 文件 0600 要结合跨用户 SecurityAgent 与 root Broker 拓扑。当前系统路径不可由普通用户写入,连接准入由内核身份和签名控制;不能照搬单用户私有目录而使系统 helper 无法连接。

本轮验证顺序

  1. 离线证明认证服务器卡住时 Broker 的协调队列仍可处理恢复,策略过期时不会签发许可。
  2. 独立进程 deadline 与纯恢复 barrier 回归。
  3. 仅限管理员验证 profile 的 recovery-only 实机事务:不签发任何解锁许可,确认两个保护 ACK 与恢复耗时。
  4. 单次显示器唤醒实测:按日志区分“唤醒成功”“机制调用”“许可消费”“实际解锁”,失败后验证正常登录恢复。
  5. 自动解锁通过后继续 AX / SCK、两种 Keychain、Secure Input、故障和显示器变化。全部通过后再合并 / 开放生产。

一手依据

系统行为随 macOS 版本变化。以上 API 文档不能替代本机真实锁屏和正常密码 / Touch ID 恢复验证。

此前用户补充的分析认为参考样本只写固定 AXValue、没有事件合成;本机 build 1001365 的后续调用链核对发现实际写入空字符串、AXValue 是属性名,并有可达的 SynthesizedEvent.click / send。该差异不能推广到所有版本,详见 认证时序复核。本项目仍保留取消可阻断的固定 AXValue 观察性探测,没有据此加入空输入认证。Keychain API 仅存在于隔离验证测试项路径,不参与解锁;系统认证自身的 Keychain 影响仍需验证。

探针与裁决链的证据区分

固定 AXValue 写入成功记录为锁屏 UI 探针成功,不能单独证明插件已执行、许可被消费或 GUI 会话已解锁。此前将缺少机制日志直接称为“认证没有开始”不够准确;应区分界面可交互、authd right 求值、机制调用、Broker 裁决、SetResult 回报及真实会话。

本项目不是只有 screensaver 的两分支数组:独立 remote right 已定义 class=evaluate-mechanisms 和 mechanisms。正常手动登录与不锁屏探测都曾实际调用插件,证明分支 / bundle 可达。wire 是 4 字节网络序长度加 JSON,不采用 ALLOW 文本或换行协议。插件显式 SetResult;新的正负裁决日志不保留 nonce、身份或原始字段。历史恢复握手的预期拒绝和无租约诊断不能混算为一次解锁的失败原因。