限制管理员重置为显式启动并隔离终端输入
This commit is contained in:
1 parent
0df6e0ee66
commit
f7325210ff
12 files changed
+646
-18
No files matched your search
@@ -0,0 +1,50 @@
|
||||
# 管理员重置命令限制验收
|
||||
|
||||
日期:2026-09-19。
|
||||
|
||||
## 需求与任务状态
|
||||
|
||||
- [✓] 仅显式 `systemctl start smail-admin` 进入重置流程,`systemctl stop smail-admin` 终止流程。
|
||||
- [✓] `restart`、`reload` 及相关变体不能开启新的重置交互。
|
||||
- [✓] 交互绑定启动终端,取消后无系统共享密码请求残留。
|
||||
- [✓] 保留邮箱、动态码、安全码验证及受保护本机 IPC,不调整账户密码或生产数据库。
|
||||
- [✓] Windows 定向测试、Linux 测试、服务器实际命令验证和部署完成。
|
||||
|
||||
## 原因与修改
|
||||
|
||||
systemd 会将 `restart` 的启动阶段转换成 `start` Job,因此只检查 `list-jobs` 无法识别原始动作。`Restart=no` 只禁止自动重启,不限制管理员手工重启。`reload` 本身已被拒绝,但 systemctl 创建的密码代理会显示已有的系统共享输入请求。
|
||||
|
||||
管理程序现在要求唯一、本机 root、前台终端的显式 `systemctl start smail-admin` 进程,同时校验可执行文件、参数、进程启动时间及终端设备,继续保留 systemd 上下文及本机 IPC 校验。非交互启动、多服务、通配符、并发启动及重启命令均不授权。
|
||||
|
||||
输入直接绑定启动终端,验证内容可见,新密码不回显。保留终端行编辑、信号和换行设置,避免停止过程中与 shell 的终端恢复竞争。监测原启动进程退出或 PID 复用,取消输入并关闭连接。服务使用 `KillMode=mixed`,主进程先处理取消,再由 systemd 兜底清理。
|
||||
|
||||
## 实机验证
|
||||
|
||||
环境:部署服务器的 systemd 259,使用两个独立 SSH 终端;只进入菜单或输入无效选项,没有发送邮件或执行真实改密。
|
||||
|
||||
| 场景 | 实际结果 |
|
||||
| --- | --- |
|
||||
| `start` | 显示安全验证方式列表,仅启动终端可见 |
|
||||
| `stop` | 流程终止,`inactive`、`Result=success`,终端模式正常 |
|
||||
| Ctrl+C | systemctl 退出,管理程序随后结束,无遗留输入请求 |
|
||||
| 未运行时 `restart` | 拒绝启动,退出码 1,无验证菜单 |
|
||||
| 正在输入时 `restart` | systemd 先终止现有流程;新启动被拒绝,不重新显示菜单 |
|
||||
| `reload` | systemd 报不支持;另一终端现有输入不被接管,原流程可继续 |
|
||||
| `reload-or-restart` | 拒绝启动,退出码 1,无验证菜单 |
|
||||
| 未运行时 `try-restart`、`try-reload-or-restart` | systemd 返回成功但不执行动作,管理进程 PID 为 0 |
|
||||
| 无效选项及结果提示 | 显示失败原因,按回车结束 |
|
||||
| 系统密码请求目录 | 验证期间及结束后均无本次重置产生的 `ask.*` |
|
||||
|
||||
## 自动化验证
|
||||
|
||||
- 本机:`go test ./services/adminreset ./cmd/smail-admin` 通过。
|
||||
- Linux:交叉编译后的 `adminreset` 完整测试在服务器隔离目录运行通过。
|
||||
- 覆盖显式命令、危险参数变体、进程启动时间/PID 重用、root 身份、真实伪终端输入、密码无回显、输入取消和终端恢复。
|
||||
- `go vet ./services/adminreset ./cmd/smail-admin`、`git diff --check` 通过。
|
||||
- unit 校验通过;systemd 对现有其他服务的 `CPUAccounting` 弃用提示与本次修改无关。
|
||||
|
||||
## systemd 行为边界
|
||||
|
||||
systemd 没有独立禁止手工 `restart`、同时允许 `start`/`stop` 的 unit 指令。因此不能删除 systemctl 自身的命令,也不能阻止它先执行重启的停止阶段。本次保证这些命令无法启动或重新进入重置流程。只读的 `status`、`show` 和日志查询继续可用。
|
||||
|
||||
原始命令检查约束正常部署操作,不构成对主机 root 的隔离;安全凭据验证和受保护本机 IPC 必须独立保留。验证二进制保存在 `/run/smail-command-validation-20260919/`,部署前备份保存在 `/var/backups/smail-admin-command-20260919/`。
|
||||
+1
-1
@@ -1211,7 +1211,7 @@ type SuperAdminResetChannelService interface {
|
||||
|
||||
Linux systemd 单元必须使用 `Type=oneshot`、`RemainAfterExit=no` 和 `Restart=no`,不得包含 `[Install]`、`WantedBy`、`RequiredBy`、`Alias`、`ExecReload`、启动依赖、重启传播或自动重启策略。安装和升级流程不得执行 `enable`、`preset`、`start` 或 `restart smail-admin`,并应清理旧版本遗留的启用关系。主服务未运行时使用 `Requisite=smail.service` 安全拒绝,不得为了重置自动拉起主服务。
|
||||
|
||||
正式管理程序启动时必须同时验证有效 UID、systemd 进程上下文、`INVOCATION_ID`、可用时的 `SYSTEMD_EXEC_PID`,以及当前 `smail-admin.service` Job 类型。只有显式 `start` Job 可以进入重置流程;`restart`、`try-restart`、`reload`、`reload-or-restart`、`stop` 和其他 Job 类型必须拒绝。`stop` 由 systemd 负责终止正在运行的事务,不调用重置逻辑。`status`、`show`、`is-active` 和日志查询属于只读观察命令,不授予任何重置能力。
|
||||
正式管理程序启动时必须同时验证有效 UID、systemd 进程上下文、`INVOCATION_ID`、可用时的 `SYSTEMD_EXEC_PID`,以及当前 `smail-admin.service` Job 类型。systemd 会把 `restart` 的启动阶段标为 `start`,因此 Job 类型不能单独证明原始操作;还须检查唯一的、本机 root 前台 `systemctl start smail-admin` 进程,校验真实可执行文件、命令参数、进程启动时间及终端设备。并发启动、重启动作、通配符、多服务和非交互启动均拒绝。交互直接绑定此终端,密码保持无回显,不向系统共享密码代理发布请求。启动进程退出、终端断开、Ctrl+C、超时或 `stop` 均取消输入并关闭本机连接;`KillMode=mixed` 允许主进程先恢复终端。`status`、`show`、`is-active` 和日志查询仍可使用。该检查约束部署命令使用方式,不构成对主机 root 的安全隔离,受保护 IPC 身份校验和业务安全验证必须独立保留。
|
||||
|
||||
安全要求:
|
||||
|
||||
|
||||
Reference in new issue
Block a user