Cockpit 基于 SSH 公钥的多主机认证机制(pam_ssh_add 与 ssh-agent 实战解析)

发布时间:2026/11/16 16:21:50

Cockpit 基于 SSH 公钥的多主机认证机制(pam_ssh_add 与 ssh-agent 实战解析) 后端运维【免费下载链接】cockpitCockpit is a web-based graphical interface for servers.项目地址https://gitcode.com/gh_mirrors/co/cockpit点击查看免费下载Cockpit 允许你通过浏览器同时监控和管理多台服务器。虽然访问主服务器primary server通常需要密码或 Kerberos 票据但通过基于公钥的认证public key based authentication你可以无密码地访问辅助服务器secondary machine。本文将围绕 doc/key-auth.md 展开深入剖析 Cockpit 如何通过pam_ssh_addPAM 模块启动 ssh-agent、自动加载 SSH 密钥并结合源码与配置说明其完整流程、权限语义及安全边界读完你就能理解 Cockpit 多主机连接时登录一次、密钥随行的原理并学会查看与调整相关 PAM 配置。适用场景主服务器 辅助服务器Cockpit 的会话模型始终存在一个主服务器浏览器直接连接的、运行 Cockpit Web 服务cockpit-ws的机器。主服务器完成认证后用户可以从 Shell 界面的主机切换host switching功能连接其他服务器或者在登录页的 Connect to 字段中直接指定目标服务器不建立主会话。这两种方式下对辅助服务器的访问均通过 SSH 完成。因此基于密钥的认证解决的是从主服务器无密码 SSH 到辅助服务器这一核心问题主服务器侧的登录依然需要密码或 Kerberos 票据而辅助服务器侧的登录则完全依赖公钥。这一设计参考 doc/modules/guide/pages/authentication.adoc 中 Logging into a secondary server from the primary session 一节其命令行等价物就是先登录主服务器再ssh usersecondary。无密码认证带来的权限语义限制一个重要且容易被忽略的事实是以密钥认证方式登录的用户其认证过程不经过密码。这意味着Cockpit 标准的 reauthorization重新授权机制无法生效——用户无法通过再次输入密码来临时提升权限用户只能获得那些不需要密码的额外特权例如已配置为 NOPASSWD 的 sudo 规则或对 polkit 中无需认证即放行的动作。从源码结构看这一限制是设计使然密钥认证把密码这个高价值凭据完全排除在辅助服务器的认证链路之外系统只能依据既有授权规则无密码可用的授权来决定权限提升。在规划多主机管理策略时应对辅助服务器上无需密码的特权授予范围格外谨慎。完整工作流程登录 → ssh-agent → ssh-add → SSH 连接根据 doc/key-auth.md 的叙述密钥认证的整体流程如下为支持密钥认证Cockpit 在自己的 PAM 栈中加入pam_ssh_add.so用户在主服务器成功登录后立即启动一个新的ssh-agent随后执行ssh-add加载默认路径下的密钥即~/.ssh/下的默认私钥——ssh-add不带任何参数若加载的密钥被口令passphrase保护ssh-add会提示输入口令此时会自动填入用户登录主服务器时使用的密码当 Cockpit 尝试向某台新服务器建立 SSH 连接时运行中的ssh-agent会把已加载的公钥提供给远端服务器作为认证选项用户登出或会话被终止时对应的ssh-agent进程也会被同步终止避免密钥常驻系统。这条链路中ssh-agent 随会话生灭的设计保证了密钥不会在用户会话结束后仍然留在内存或 socket 中与常规交互式 SSH 环境中手动启动 agent 的做法相比更贴合 Web 会话的生命周期。源码级解析pam_ssh_add 的认证与会话模块pam_ssh_add是这一机制的核心实现源码位于 src/pam-ssh-add/pam-ssh-add.c 和 src/pam-ssh-add/pam-ssh-add.h对应的 man page 为 doc/modules/man/pages/pam_ssh_add.8.adoc。它提供两个 PAM 模块authentication 模块和 session 模块。Authentication 模块只存密码不做认证pam_sm_authenticate()的职责非常特殊它从 PAM 项中取出PAM_AUTHTOK即用户登录密码通过stash_password_for_session()用pam_set_data()存入会话数据键名为pam_ssh_add_authtok供后续 session 阶段使用它不执行任何实际认证而是返回PAM_CRED_INSUFFICIENT。man page 对此明确说明因为该模块本身不做认证所以在 PAM 配置中它必须与一个真正的认证模块如pam_unix.so搭配使用且通常标记为optional。返回PAM_CRED_INSUFFICIENT表示凭据信息不足、需要其它模块继续处理这恰好让真正负责认证的模块接管后续流程。Session 模块启动 agent 并加载密钥pam_sm_open_session()依次完成两步start_agent()以登录用户的身份启动ssh-agent解析其输出中的SSH_AUTH_SOCK与SSH_AGENT_PID两个环境变量源码中的agent_vars[]表写入 PAM 环境并记录 agent PID 与用户 UID 供登出时清理load_keys()读取之前暂存的密码调用pam_ssh_add_load()执行ssh-add。pam_ssh_add_load()的实现细节值得关注通过管道与ssh-add子进程交互读取其 stderr检测到输出包含 Enter passphrase 时把暂存的登录密码写入 stdinsrc/pam-ssh-add/pam-ssh-add.c检测到 Bad passphrase口令错误时只发送换行跳过该密钥并继续ssh-add以EXIT_STATUS 1退出时部分密钥加载失败模块并不视为致命错误而是记录 Failed adding some keys 后继续保证登录流程不被密钥问题阻断。子进程启动时通过setup_child()完成setuid/setgid降权、setsid()脱离终端、关闭多余文件描述符等加固步骤确保ssh-agent/ssh-add始终以目标用户身份运行src/pam-ssh-add/pam-ssh-add.c。登出清理session close 杀掉 agentpam_sm_close_session()在会话结束时执行清理先降权到该 agent 所属用户再向记录的SSH_AGENT_PID发送SIGTERM随后恢复 root 权限。源码注释表明以用户身份 kill 是为了防止误杀崩溃的 ssh-agent 以及 PID 重用带来的风险src/pam-ssh-add/pam-ssh-add.c。这与 doc/key-auth.md 所述用户登出或会话终止时 ssh-agent 同步终止完全对应。PAM 配置从示例到 Cockpit 实际栈man page doc/modules/man/pages/pam_ssh_add.8.adoc 给出了一个最小示例auth required pam_unix.so auth optional pam_ssh_add.so session optional pam_ssh_add.so注意示例中pam_ssh_add.so两处均为optional且前面必须有真正的认证模块。Cockpit 自身的 PAM 栈tools/cockpit.pam展示了它的真实落地方式auth required pam_sepermit.so auth substack password-auth auth include postlogin auth optional pam_ssh_add.so # List of users to deny access to Cockpit, by default root is included. account required pam_listfile.so itemuser sensedeny file/etc/cockpit/disallowed-users onerrsucceed account required pam_nologin.so account include password-auth password include password-auth session required pam_selinux.so close session required pam_loginuid.so session required pam_selinux.so open env_params session optional pam_keyinit.so force revoke session optional pam_ssh_add.so session include password-auth session include postlogin关键点解读pam_ssh_add.so在 auth 段中作为最后一个 optional 模块出现此时password-auth等真正的认证模块已完成密码校验pam_ssh_add只需顺势捕获PAM_AUTHTOK暂存session 段中pam_ssh_add.so置于pam_selinux.so open之后、pam_keyinit.so附近保证在用户会话环境建立的同时启动 agent该文件还展示了 Cockpit 的访问控制pam_listfile.so结合/etc/cockpit/disallowed-users拒绝特定用户默认包含 root。若你在部署中自行调整 PAM 栈务必保持真正认证模块在前、pam_ssh_add.so为 optional的顺序否则登录流程会出问题。该模块支持的唯一参数是debug开启后会将详细日志通过 syslogLOG_AUTHPRIV输出便于排查 agent 启动或密钥加载失败问题。模块构建方式见 src/pam-ssh-add/Makefile.am其单元测试使用 src/pam-ssh-add/mock-ssh-agent、src/pam-ssh-add/mock-ssh-add 等 mock 程序模拟 agent 与ssh-add行为。前端配合密钥的查看、创建与授权密钥认证不是纯后端机制Cockpit 的用户界面也提供了配套操作。在用户账户页面pkg/users模块中pkg/users/authorized-keys-panel.jsx 提供Authorized keys面板支持粘贴公钥内容并添加到~/.ssh/authorized_keysAdd public key 对话框pkg/users/authorized-keys-panel.jsx也支持删除已有密钥。底层封装在 pkg/users/authorized-keys.js它调用 pkg/users/ssh-list-public-keys.sh 读取并解析authorized_keys内容用正则^(\S)\s(\S)\s(.*)\((\S)\)$解析出密钥大小如 2048、指纹SHA256:...、注释与算法类型如 RSA通过 pkg/users/ssh-add-public-key.sh 将公钥追加写入~/.ssh/authorized_keys对密钥文件缺失、权限不足access-denied等场景都有明确的状态处理。这正好对应 doc/modules/guide/pages/authentication.adoc 中目标服务器需启用公钥认证且公钥必须存在于~/.ssh/authorized_keysCockpit 提供创建 SSH 密钥并授权的界面的描述。此外Cockpit 还提供界面将无法自动加载的密钥手动加入 agent即登录后补充ssh-add能力解决密钥不在默认路径或需要手动选择的场景。SSH 主机密钥host key与 known_hosts除了用户公钥SSH 主机密钥校验也属于密钥认证链路的一部分当 Cockpit 连接到一台未知的新服务器时会提示用户确认其 SSH host key用户确认后主机密钥会被写入~/.ssh/known_hosts后续连接不再重复提示见 doc/modules/guide/pages/authentication.adoc 的 SSH host keys 一节。这与命令行 SSH 的首次连接确认体验一致是对本主题在操作层面的自然补充。安全边界与建议信任边界从主会话切换主机时远端机器的 Cockpit 页面JavaScript会在主服务器上执行因此只应连接你信任的机器该多主机功能在部分发行版上默认关闭可通过cockpit.conf的AllowMultiHost选项启用。权限最小化由于密钥认证免密码reauthorization 机制失效应审查辅助服务器上免密 sudo/polkit 授权的范围避免权限面过大。密钥生命周期ssh-agent 随 Cockpit 会话启动与销毁登出即终止勿在系统层面为 Cockpit 用户单独常驻 agent以免绕过这一生命周期约束。口令保护私钥若有 passphrase加载时会复用登录密码若登录方式为 Kerberos 或证书等无密码形式pam_ssh_add将无法获得密码带口令的密钥则无法自动加载可通过界面手动加入 agent。延伸阅读认证总览doc/authentication.md、doc/modules/guide/pages/authentication.adocPAM 模块手册页doc/modules/man/pages/pam_ssh_add.8.adoc核心实现src/pam-ssh-add/pam-ssh-add.c、src/pam-ssh-add/pam-ssh-add.h实际 PAM 栈tools/cockpit.pam、tools/cockpit.suse.pam前端密钥管理pkg/users/authorized-keys.js、pkg/users/authorized-keys-panel.jsx赞分享后端运维【免费下载链接】cockpitCockpit is a web-based graphical interface for servers.项目地址https://gitcode.com/gh_mirrors/co/cockpit点击查看免费下载相关推荐Steam 四平台饰品价格监控实测从克隆到出数据的完整流程Steam 四平台饰品价格监控实测从克隆到出数据的完整流程 打开页面最先看到的是一个数字0.876当前挂刀指数——这个 Steam 饰品价格监控站一行后端网页爬虫libcurl CURLOPT_SSH_KNOWNHOSTS 详解基于 known_hosts 文件的 SSH 主机密钥校验libcurl CURLOPT_SSH_KNOWNHOSTS 详解基于 known_hosts 文件的 SSH 主机密钥校验 CURLOPT_SSH_KNOWCLI网络通信gliderlabs/ssh认证机制全解析密码、公钥、键盘交互三合一终极指南gliderlabs/ssh认证机制全解析密码、公钥、键盘交互三合一终极指南 想要快速构建功能强大的Go语言SSH服务器吗gliderlabs/ssh提供了网络通信认证鉴权创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/12 20:25:10

3个避坑点,一文搞懂gpy底层原理

3个避坑点,一文搞懂gpy底层原理 面对满屏红色的 StackTrace,你是否觉得像看天书?别慌,今天带你一文搞懂 gpy 的底层逻辑,把报错变成线索。很多开发者卡在报错信息上,其实问题往往出在调用链的断点上。 一句话原理:GPy…

2026/11/11 8:34:42

UE5 C++软引用详解:路径、指针与Actor异步生成实战

UE5 C开发里,软引用这个知识点说大不大,说小不小。FSoftObjectPath、FSoftClassPath、TSoftObjectPtr、TSoftClassPtr这几个类型,我刚接触的时候也绕了好一阵:明明看起来都是"引用"外加大一堆模板参数,怎么四…

2026/11/16 17:19:58

办理电工证的表格行业前景与薪资待遇

电工证报考避坑指南:真实经历告诉你如何避开中介陷阱 你是不是也遇到过这种情况?想办理电工证,却不知道从哪儿开始?跑了几家中介,价格五花八门,连表格都不一样,心里直打鼓, 不知道去哪报名怕被中介坑…

2026/11/16 17:19:58

3个实操考试避坑指南,郑州报考建委办法电工证怎么稳过?

3个实操考试避坑指南,郑州报考建委办法电工证怎么稳过? 实操考试心里没底怕挂科,尤其是郑州的小伙伴,报考建委办法电工证时,总担心流程复杂、材料不齐、培训不到位,最后白费钱还拿不到证。今天从新乡培训机构学员的角度,给你讲清楚整个流程,避开那些…

2026/11/16 17:19:58

电工证年审到多少岁?过期了不知道在哪考怎么办?

电工证年审到多少岁?过期了不知道在哪考怎么办? 证书过期了不知道怎么复审延期,这事儿真不是小事。很多人在电工证到期后才发现,不是随便找个机构就能续证,也不是所有平台都能帮你搞定。特别是像 在哪考…

2026/11/16 17:19:58

重庆电工证模拟试卷4通过率揭秘,工地太忙根本没时间复习考试

重庆电工证模拟试卷4通过率揭秘,工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,这是大多数一线施工人员的真实写照。尤其是像重庆这样工程密集的城市,很多电工证持证人平时工作强度大、时间紧,备考成了“奢侈品”。但如果你正在准备【重庆电工…

2026/11/16 17:19:57

安阳电工证考证通过率揭秘:工地太忙根本没时间复习考试?

安阳电工证考证通过率揭秘:工地太忙根本没时间复习考试? 工地太忙根本没时间复习考试,这是很多一线电工的真实写照。尤其是像安阳这样的施工大市,电工证几乎是每个项目开工前的“硬门槛”。可问题来了,考证流程复杂、复习资料多、时间紧张,…

2026/11/16 17:14:56

电工证可以延迟换证吗 电子证书怎么换不影响工作

电工证可以延迟换证吗 电子证书怎么换不影响工作 之前考的证在外省能不能转过来?这个问题几乎每个电工人都问过,尤其是那些在外地工作、换城市的,现在国家推行电子证书,很多流程都简化了,但换证这件事还是让人有点发愁。特别是 电工证可以延迟换证吗…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/16 0:00:11

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱 你是不是也和我一样,想考电工证,但不知道去哪报名,怕被中介坑?最近网上有不少人问“黎城电工证查询报名费多少钱”,结果一查,信息五花八门,真假难辨。别担心,今天我就从一线从业者的角度…

2026/11/16 0:00:11

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来?

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来? 之前考的证在外省能不能转过来?这个问题困扰着很多在外地打工的电工,尤其是像南阳卧龙区的建筑工人,他们常年在工地作业,手上持有电工证是基本要求,但很多人因为工作流动性大,担心证书不能转到本…

2026/11/15 4:46:37

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑