🚀 省流助手
- 日常 SSH 钥匙可以交给 Secretive,创建时选择“仅通知”:Git/SSH 请求签名时不逐次确认,私钥由 Mac 的 Secure Enclave 保护,无法导出到别的机器使用。
- 备用方案另用一对普通 SSH 密钥,设置强口令、离线保存。它负责主力电脑不可用时恢复访问,平时不加载进 agent。
- 配置的关键是
IdentityAgent指向 Secretive、IdentityFile指向对应公钥,再用ssh -vT git@github.com确认实际用上的身份。 - 这套选择仍有取舍:“仅通知”不拦截能访问 agent 的本机程序;备用私钥的强口令,也保护不了被控制的解锁环境。
一、让日常签名少打断,也保留恢复入口
Git 拉取、推送和 SSH 登录经常发生在连续工作的过程中,每次都要求输入口令或确认身份,会打断操作。普通私钥交给 agent 缓存、使用硬件保护的密钥,都能改善体验,但保护范围和恢复方式不同。
本文讨论一种组合:日常签名由 Secretive 完成,独立的加密私钥用于恢复访问。重点是配置、身份验证和使用边界。
| 使用需求 | 对应的安排 |
|---|---|
| 日常 Git/SSH 少打断 | Secretive 创建钥匙时选“仅通知” |
| 日常私钥不能被拷到别处用 | 由 Secure Enclave 保护密钥材料 |
| Mac 坏了以后还能登录 | 另准备一对强口令保护的备用密钥 |
日常入口和备用入口需要分别配置、分别验收。主力钥匙可用,并不能证明设备不可用时仍有恢复能力。
界面选项以 Secretive 4.0 为例,主机名和身份路径使用示例值;实际配置以所用版本的向导为准。
二、普通私钥加口令,与使用 Secretive 有什么区别
普通 SSH 私钥加上口令,再交给 ssh-agent,同样能减少重复输入。选择方案前,可以先检查 agent 和目标配置:
ssh-add -l
ssh -G git@github.com | grep -E '^(identityagent|identityfile|identitiesonly) '
对于仍然可信的钥匙,ssh-add ~/.ssh/id_ed25519 就能把它加载到 agent;缓存能留多久,取决于 agent 生命周期和系统集成。OpenSSH ssh-agent 手册
如果旧钥匙疑似泄露,仅给手里的副本补口令,并不能保护已流出的副本,需要生成新身份并撤销旧授权。Secretive 提供了另一种密钥保护方式:在 Secure Enclave 中生成密钥,应用通过系统接口请求签名,拿不到可导出的普通私钥。
Git / SSH 发起认证
↓
Secretive 的 SecretAgent 接收签名请求
↓
本文选择“仅通知”,不要求每次验证
↓
Secure Enclave 完成签名
↓
远端用已登记的公钥验证签名
“不可导出”指的是密钥材料的保护方式,并不等于磁盘上没有相关数据:Keychain 仍会保存密钥引用和受保护的数据。这条路线使用 P-256,旧的 Ed25519 私钥也不能直接导入,需要生成新身份、替换远端公钥。Apple 机制说明、Secretive FAQ
三、日常钥匙选择“仅通知”
安装可以从 Secretive 官方 Releases 下载,也可以用 Homebrew:
brew install secretive
Secretive 使用 MIT 许可证。作为本机 SSH 签名链路的一环,它的安装来源和后续更新也需要保持可信。
打开应用、启用 SecretAgent,然后按用途新建钥匙,例如 github、dev-server。创建时会选择每次验证还是仅通知,下文按“仅通知”模式介绍配置与取舍。在这个模式下,Git/SSH 可以直接请求签名,钥匙使用时会发送通知。官方访问控制与通知说明
| 选择 | 使用时的区别 | 共同点 |
|---|---|---|
| 每次验证 | 签名前需要用户验证,例如 Touch ID | 私钥仍由 Secure Enclave 保护 |
| 仅通知 | 不逐次确认,收到使用通知 | 私钥仍由 Secure Enclave 保护 |
这项选择减少了日常打断,也保留了私钥不可导出的保护。它的边界是:能访问 agent 的本机恶意程序仍可能请求签名,通知无法阻止这类操作。需要逐次确认的高权限入口,可以单独建钥匙并启用验证,不必把所有用途都设成同一种模式。
两类钥匙说的是日常与备用两种用途。不同账号、不同服务器仍可以分别生成,便于以后撤销和定位。
四、把 Secretive 接到 Git 和 SSH:这三行最关键
先把新公钥加到 GitHub/Gitee 的 SSH 公钥设置,或者目标用户的 ~/.ssh/authorized_keys。更换期间保留一个可用登录会话,可以在新配置失效时修正授权。
Secretive 会显示每把钥匙的 Public Key Path。下面假设把公钥分别复制到了 ~/.ssh/secretive/github.pub 和 ~/.ssh/secretive/dev-server.pub,在已有 ~/.ssh/config 中合并这些配置:
Host github.com
User git
IdentityAgent ~/Library/Containers/com.maxgoedjen.Secretive.SecretAgent/Data/socket.ssh
IdentityFile ~/.ssh/secretive/github.pub
IdentitiesOnly yes
Host dev-server
HostName server.example.com
User dev
IdentityAgent ~/Library/Containers/com.maxgoedjen.Secretive.SecretAgent/Data/socket.ssh
IdentityFile ~/.ssh/secretive/dev-server.pub
IdentitiesOnly yes
| 配置 | 在这里负责什么 |
|---|---|
IdentityAgent | 找到 Secretive 的签名服务;socket 路径以安装向导为准 |
IdentityFile | 用这份公钥选择 agent 中对应的身份 |
IdentitiesOnly yes | 限制尝试的身份,避免把 agent 里的其他钥匙挨个试一遍 |
这里需要留意的是 .pub。OpenSSH 支持用公钥文件选择 agent 中对应的私钥身份,所以这里确实填公钥路径;私钥没有导出步骤。OpenSSH 配置手册
另一个容易漏的细节是 IdentityFile 会累加。即使这个 Host 写了新公钥,其他匹配段,例如 Host *,仍可能把旧钥匙加进候选列表。IdentitiesOnly yes 不会自动清掉那些配置,因此还需要单独确认实际使用的身份。
服务端只需要认识公钥,不需要安装 Secretive。Windows OpenSSH 的管理员账号默认使用 C:\ProgramData\ssh\administrators_authorized_keys,还有专门的 ACL 要求;WSL 的 SSH 服务则使用 WSL 用户自己的授权文件,两个入口要分开配置。Microsoft 公钥管理说明
五、确认登录真正用上了新钥匙
新旧钥匙同时存在时,连接成功只能说明“有一把钥匙能用”。确认 Secretive 是否生效,需要将新公钥指纹与详细认证日志对照:
ssh-keygen -lf ~/.ssh/secretive/github.pub
ssh -vT git@github.com
认证日志中需要核对所出示的身份,以及服务端是否接受该公钥。下面仅示意关键输出结构,路径和指纹均为占位值;这两行之后,还要确认最终认证成功:
debug1: Offering public key: <new-public-key-path> ECDSA SHA256:<fingerprint> debug1: Server accepts key: <new-public-key-path> ECDSA SHA256:<fingerprint>
每个入口都要独立验证。Git 托管平台的认证成功提示,与普通服务器上的命令执行结果,需要按各自的服务行为判断;一个目标通过,不能代替其他目标的验收。
对于历史配置较多的环境,可以用一份临时配置排除干扰。创建临时文件,把上一节的 Host github.com 整段复制进去:
secretive_test_config="$(mktemp "${TMPDIR:-/tmp/}secretive-ssh.XXXXXX")"
chmod 600 "$secretive_test_config"
nano "$secretive_test_config"
保存后,在同一终端里检查解析结果,再发起一次不复用主连接的认证:
ssh -G -F "$secretive_test_config" git@github.com |
grep -E '^(identityagent|identityfile|identitiesonly) '
ssh -F "$secretive_test_config" -o ControlMaster=no -o ControlPath=none \
-o PreferredAuthentications=publickey -vT git@github.com
ssh -G 不会连接服务器,适合检查最终选中的路径;第二条命令才验证实际签名。首次连接仍要核对服务端主机指纹。GitHub 不提供 shell,所以即使出现成功认证提示,退出码也可能是 1,这里应结合提示内容判断。GitHub 测试文档
回到正常配置后,再核对一次实际身份,并在使用 SSH remote 的仓库执行 git ls-remote origin,确认仓库可读。它不会推送代码;HTTPS remote 的成功也不能算这套 SSH 配置的验证结果。
新的身份和恢复入口确认可用后,再逐项撤销旧公钥。撤销发生在 Git 平台或服务器端:只删除本机的旧私钥,别人手里的副本仍可能继续登录。
六、备用钥匙放到另一条恢复通道
Secure Enclave 钥匙不能备份到新 Mac。换机可以趁旧机还可用时添加新公钥,但设备损坏、丢失或被抹掉后,就需要提前留好的入口。Secretive 备份说明
备用通道可以采用一对独立的普通密钥,设置强口令,离线保存。方案是否可用,要通过独立的恢复演练确认;日常 Secretive 登录成功,不能替代备用钥匙的测试。
ssh-keygen -t ed25519 -a 100 -f ~/.ssh/recovery_ed25519 -C ssh-recovery
这条命令适用于支持 Ed25519 的目标,在可信环境执行,交互输入独立的强口令。文件名已经被占用时就换一个,避免覆盖原有钥匙。-a 100 增加口令派生的计算成本,减慢私钥副本被盗后的离线猜解;它仍然需要足够强的口令。OpenSSH ssh-keygen 手册
备用方案还需要安排好公钥授权、私钥存放和口令保管:
- 公钥提前添加到需要恢复的入口,权限只覆盖恢复所需的范围。
- 加密私钥保存到离线介质,另外留一份独立副本;两份都确认可读、可解锁后,再移除日常工作机上的私钥工作副本。
- 口令通过密码管理器等方式单独保管,确保主力 Mac 不可用时仍能取到。离线介质平时断开,备用钥匙不常驻 agent,也不设成日常连接失败后的自动回退身份。
移除工作副本不能保证历史数据已被安全擦除,也无法收回已经泄露的副本。因此,备用钥匙需要在可信环境重新生成,不能沿用疑似泄露的旧钥匙。
备用钥匙的测试重点是能否独立完成认证。下面这组参数排除 agent、其他 SSH 配置和连接复用;路径、用户名、主机以及必要的端口或跳板机配置,需要换成实际值:
ssh -F /dev/null -o IdentityAgent=none -o IdentitiesOnly=yes \
-o ControlMaster=no -o ControlPath=none \
-o PreferredAuthentications=publickey \
-i /path/to/recovery_ed25519 -v dev@server.example.com
测试时同样核对服务端主机指纹、备用公钥指纹和最终认证结果。能拿到加密文件、能取到口令、能用它登录,才算备用通道可用。
七、日常操作中突然索要备用口令,先检查触发原因
在这套配置中,日常签名由 Secretive 完成,不依赖备用私钥及其口令。普通 Git 操作突然要求输入备用口令时,需要先核对提示来源:是否主动发起了恢复?要求解锁的是哪份私钥?提示是否实际在索要服务器账号密码?
| 遇到的情况 | 检查或处理方向 |
|---|---|
| 命令行突然连不上 | Secretive 是否运行,IdentityAgent 是否指向正确 socket |
| 命令行能连,Git 图形客户端不能 | 客户端使用系统 SSH 还是内置实现,是否支持 SSH_AUTH_SOCK |
| 主力电脑损坏、丢失或日常钥匙确实不可用 | 在可信设备上取出备用钥匙,恢复后再配置新的日常身份 |
| 网页或“修复脚本”说必须输入备用口令 | 独立核实原因,不把私钥解密口令提交给它 |
图形客户端的 SSH 实现确实可能不同,官方 FAQ 也专门说明了这类兼容问题。Secretive 客户端说明
真故障和诱导提示都可能出现,甚至可能有人故意制造故障。强口令主要保护静态私钥副本;如果怀疑当前系统被控制,应换可信设备恢复,避免在可疑环境中输入口令。恢复后再撤销失效或疑似泄露的身份,重新安排日常钥匙。