完善证书管理与初始化流程
This commit is contained in:
1 parent
07636abe44
commit
c74372284a
84 files changed
+10151
-3502
No files matched your search
+1
-1
@@ -60,7 +60,7 @@ systemctl start Scert-admin
|
||||
systemctl stop Scert-admin
|
||||
```
|
||||
|
||||
该服务只允许回环监听,不应为其创建公网或局域网入站规则。云安全组仍需由管理员根据初始化提示手动放行主服务端口。
|
||||
`Scert-admin` 不监听任何 TCP/UDP 端口。启动后,它只维护 Scert 主服务 `/reset` 路径的短时激活租约并输出一次性校验码;停止后入口立即失效,异常退出后入口会在租约过期时失效。云安全组只需由管理员根据初始化提示放行主服务端口。
|
||||
|
||||
## 参数说明
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
[Unit]
|
||||
Description=Scert-admin 本地密码重置服务
|
||||
Description=Scert-admin 临时密码重置入口激活器
|
||||
Documentation=file:///scert/docs/Scert-admin服务管理说明.md
|
||||
After=network-online.target
|
||||
Wants=network-online.target
|
||||
@@ -14,14 +14,15 @@ ExecStart=/scert/scert-admin --config /scert/conf/scert.json
|
||||
KillSignal=SIGTERM
|
||||
TimeoutStopSec=15
|
||||
Restart=no
|
||||
RuntimeMaxSec=30min
|
||||
UMask=0077
|
||||
NoNewPrivileges=yes
|
||||
PrivateTmp=yes
|
||||
ProtectHome=yes
|
||||
ProtectSystem=full
|
||||
ReadWritePaths=/scert/conf /scert/data /scert/log /scert/backups
|
||||
RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6
|
||||
ReadWritePaths=/scert/data /scert/log
|
||||
RestrictAddressFamilies=AF_UNIX
|
||||
|
||||
# Scert-admin 由程序层强制只允许监听回环地址;本服务不创建公网防火墙规则。
|
||||
# Scert-admin 不监听任何 TCP/UDP 端口,只维护主服务 /reset 路径的短时激活租约。
|
||||
# 刻意不提供 [Install] 段,禁止通过 systemctl enable 纳入开机启动。
|
||||
# 不配置 ExecReload,reload 不属于受支持的控制操作。
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
## 服务边界
|
||||
|
||||
`Scert-admin` 是超级管理员密码重置服务,仅允许在本机回环地址监听。它不应被配置为公网服务,也不应为其创建本机防火墙入站规则。
|
||||
`Scert-admin` 是超级管理员密码重置入口激活器,本身不监听任何 TCP/UDP 端口。Scert 核心服务固定提供 `/reset` 路由,但只有 `Scert-admin` 正在运行且短时租约有效时才显示重置页面,其余时间统一返回 `404`。
|
||||
|
||||
Linux 安装程序必须同时安装 `Scert` 和 `Scert-admin` 的 systemd 单元,但不得执行 `systemctl enable Scert-admin`,不得为 `Scert-admin` 创建开机启动软链接,也不得配置 `Restart=always` 或其他自动拉起策略。
|
||||
|
||||
@@ -15,8 +15,8 @@ systemctl start Scert-admin
|
||||
systemctl stop Scert-admin
|
||||
```
|
||||
|
||||
- `start`:按配置启动本机密码重置服务。
|
||||
- `stop`:停止本机密码重置服务。
|
||||
- `start`:生成一次性校验码,激活由 Web 管理域名或公网 IP 自动生成的 `/reset` 地址,并开始刷新短时租约。
|
||||
- `stop`:立即使 `/reset` 入口失效;异常退出时,入口会在当前租约到期后自动失效。
|
||||
- `restart`、`reload`、`try-restart` 等操作不属于 Scert-admin 的支持范围;单元不提供 `ExecReload`,且不配置自动重启。
|
||||
- `enable` 不应使用:该单元没有 `[Install]` 段,因此不会注册开机启动目标。
|
||||
- `daemon-reload` 仅允许由安装、升级程序在替换 unit 文件后执行,不属于日常服务控制命令。
|
||||
@@ -27,12 +27,14 @@ systemd 无法阻止 root 或具备等效系统权限的操作者调用 `status`
|
||||
|
||||
1. 单元不提供 `[Install]` 段,默认不会开机自启动。
|
||||
2. 单元使用 `Restart=no`,异常退出不会被 systemd 自动拉起。
|
||||
3. 进程使用 `Scert` 用户运行,并由程序层拒绝非回环监听地址。
|
||||
4. 初始化程序不开放 `Scert-admin` 端口,不创建其防火墙规则。
|
||||
3. 进程使用 `Scert` 用户运行,systemd 通过 `RestrictAddressFamilies=AF_UNIX` 禁止其建立 IPv4 或 IPv6 网络监听。
|
||||
4. `Scert-admin` 不配置独立端口,初始化程序只放行 Scert 主服务端口。
|
||||
5. 安装器、桌面端和运维文档只提供 `start`、`stop` 两个日常控制入口。
|
||||
6. 任何需要重新加载 unit 的行为仅限安装或升级阶段,不能通过 Web 管理界面触发。
|
||||
7. 激活租约有效期为 90 秒,每 30 秒刷新;systemd 使用 `RuntimeMaxSec=30min` 将单次激活最长时间限制为 30 分钟。
|
||||
8. 启动时生成的一次性校验码只在当前终端显示,状态文件仅保存 SHA-256 摘要,不保存明文校验码。
|
||||
|
||||
这组限制可以避免服务因安装配置被纳入开机启动、避免服务自动反复拉起,并避免密码重置端口暴露给公网;不能把拥有 root 权限的恶意操作者从 systemd 管理能力中排除。
|
||||
这组限制可以避免服务因安装配置被纳入开机启动、避免服务自动反复拉起,并彻底取消独立密码重置监听端口。需要注意:`/reset` 与 Scert 主服务共享 HTTPS 端口,激活期间仍可能被外部访问,因此完整密码重置实现还必须校验一次性校验码、限制请求频率、单次消费校验码并记录审计日志。不能把拥有 root 权限的恶意操作者从 systemd 管理能力中排除。
|
||||
|
||||
## 安装阶段约定
|
||||
|
||||
@@ -50,4 +52,6 @@ systemctl start Scert-admin
|
||||
systemctl restart Scert-admin
|
||||
```
|
||||
|
||||
安装完成后只提示管理员在确有需要时手动执行 `systemctl start Scert-admin`;不需要密码重置时保持服务停止。
|
||||
安装完成后只提示管理员在确有需要时手动执行 `systemctl start Scert-admin`;不需要密码重置时保持服务停止,完成重置后立即执行 `systemctl stop Scert-admin`。
|
||||
|
||||
当前实现已经接入一次性校验码、单次消费、密码复杂度校验、CSRF、同源校验、失败限流、配置原子保存和审计日志。密码重置成功后 `/reset` 立即关闭,Scert-admin 后续刷新旧租约也会自动终止。一次性校验码仍会在直接运行或 systemd 标准输出中呈现;正式上线前必须替换为不把明文校验码长期保留在持久日志中的受保护本地呈现机制。
|
||||
@@ -16,7 +16,11 @@ systemctl daemon-reload
|
||||
|
||||
## 日常服务控制
|
||||
|
||||
核心服务的启停应由初始化和运维流程根据配置状态执行。`Scert-admin` 与核心服务相互独立,不能把密码重置服务当作核心服务的自动启动依赖。
|
||||
核心服务的启停应由初始化和运维流程根据配置状态执行。核心服务固定注册 `/reset` 路由,但未检测到有效的 `Scert-admin` 激活租约时统一返回 `404`。`Scert-admin` 不监听独立端口,也不能作为核心服务的自动启动依赖。
|
||||
|
||||
密码重置地址根据初始化时配置的 Web 管理域名或公网 IP 自动生成:主端口为 `443` 时使用 `https://域名或IP/reset`,其他端口使用 `https://域名或IP:主端口/reset`。云安全组和本机防火墙都不需要额外放行密码重置端口。
|
||||
|
||||
`/reset` 页面只有在 `Scert-admin` 显式启动且租约有效时开放。提交时必须提供一次性校验码、CSRF 校验值和两次一致的新密码;校验码成功消费后立即失效,密码摘要使用 bcrypt 保存。正式生产部署仍需完成核心服务真实 HTTPS 终止、受保护校验码呈现和目标平台实机验收。
|
||||
|
||||
## 默认目录
|
||||
|
||||
@@ -34,4 +38,4 @@ systemctl daemon-reload
|
||||
- 核心服务使用 `Scert` 用户运行。
|
||||
- 配置目录仅允许服务用户和 root 管理。
|
||||
- 证书私钥由服务用户生成和使用,Linux 权限应保持为 `0600`;root 仍可进行系统级管理。
|
||||
- 安装、升级和卸载不得删除用户证书、数据库和备份。
|
||||
- 安装、升级和卸载不得删除用户证书、数据库和备份。
|
||||
Reference in new issue
Block a user