完善 Scert 前后端与部署支持
This commit is contained in:
1 parent
afdb947bea
commit
7f0af703ed
85 files changed
+7530
-800
No files matched your search
+12
-19
@@ -687,7 +687,7 @@ POST /api/v1/domains/{id}/test-servers
|
||||
| fingerprint | 证书指纹 |
|
||||
| issued_at | 签发时间 |
|
||||
| expires_at | 到期时间 |
|
||||
| status | `current`、`history`、`failed`、`rolled_back` |
|
||||
| status | `current`、`failed`、`rolled_back` |
|
||||
| created_at | 创建时间 |
|
||||
|
||||
### 5.4 servers
|
||||
@@ -795,29 +795,20 @@ SAN 进入默认 UI、自动续期、证书版本保存、部署关联和验收
|
||||
|
||||
```text
|
||||
{storage_root}/{domain}/
|
||||
├── production/
|
||||
│ ├── wildcard/
|
||||
│ │ ├── current/
|
||||
│ │ └── versions/{version}/
|
||||
│ └── single/
|
||||
│ ├── current/
|
||||
│ └── versions/{version}/
|
||||
└── development/
|
||||
├── wildcard/
|
||||
│ ├── current/
|
||||
│ └── versions/{version}/
|
||||
└── single/
|
||||
├── current/
|
||||
└── versions/{version}/
|
||||
├── wildcard/
|
||||
│ └── YYYYMMDD-Vx.x/
|
||||
├── single/
|
||||
│ └── YYYYMMDD-Vx.x/
|
||||
└── san/{certificate_identifier}/
|
||||
└── YYYYMMDD-Vx.x/
|
||||
```
|
||||
|
||||
每个版本目录至少包含:
|
||||
|
||||
```text
|
||||
cert.pem
|
||||
chain.pem
|
||||
fullchain.pem
|
||||
privkey.pem
|
||||
key.pem
|
||||
metadata.json
|
||||
```
|
||||
|
||||
@@ -825,9 +816,11 @@ metadata.json
|
||||
|
||||
- Linux 私钥文件使用 600 或更严格权限。
|
||||
- Windows 使用仅服务账户和授权管理员可读的 ACL。
|
||||
- `current` 可以使用目录切换或受控复制,不直接覆盖正在使用的版本。
|
||||
- 生产和开发申请环境由域名配置中的 ACME 环境字段区分,不再创建两套证书目录。
|
||||
- 每个证书类型正式目录只保留一个当前版本目录;版本目录名称使用 `YYYYMMDD-Vx.x`。
|
||||
- 新证书写入新版本目录并完成校验后移除旧当前版本;失败时从备份目录恢复。
|
||||
- 删除域名时先停止相关任务,再删除数据库记录和证书文件。
|
||||
- 用户上传证书默认保留当前版本和一个最近历史版本。
|
||||
- 用户上传证书默认只保留当前版本,备份目录仅用于失败回滚,不作为历史版本目录展示。
|
||||
|
||||
### 6.1 跨平台默认路径
|
||||
|
||||
|
||||
+14
-22
@@ -65,35 +65,27 @@
|
||||
|
||||
```text
|
||||
/ssl/{域名}/
|
||||
├── production/ 生产证书
|
||||
│ ├── wildcard/ 泛域名证书,例如 *.example.com
|
||||
│ │ ├── current/ 当前使用版本
|
||||
│ │ └── versions/{版本}/ 历史版本
|
||||
│ └── single/ 单域名证书,例如 example.com
|
||||
│ ├── current/
|
||||
│ └── versions/{版本}/
|
||||
└── development/ 开发证书,目录结构与 production 相同
|
||||
├── wildcard/ 泛域名证书,例如 *.example.com
|
||||
│ └── {日期}-Vx.x/ 当前使用版本
|
||||
├── single/ 单域名证书,例如 example.com
|
||||
│ └── {日期}-Vx.x/ 当前使用版本
|
||||
└── san/{证书标识}/ 多域名 SAN 证书
|
||||
└── {日期}-Vx.x/ 当前使用版本
|
||||
```
|
||||
|
||||
版本目录名称格式为 `YYYYMMDD-Vx.x`,例如 `20260830-V1.0`。同一天再次保存时递增版本号,例如 `20260830-V1.1`。生产和开发证书不再使用两套目录层级,统一由域名配置中的 ACME 环境字段区分申请环境。正式证书目录只保留当前使用版本;新证书保存成功后替换旧当前版本,旧文件仅在失败回滚所需时进入备份目录。
|
||||
|
||||
多域名 SAN 证书纳入第一阶段,证书以主域名作为管理归属,并保存完整的 SAN 域名集合。SAN 证书目录使用证书标识区分不同域名集合:
|
||||
|
||||
```text
|
||||
/ssl/{主域名}/
|
||||
├── production/
|
||||
│ ├── wildcard/
|
||||
│ ├── single/
|
||||
│ └── san/{证书标识}/
|
||||
│ ├── current/
|
||||
│ └── versions/{版本}/
|
||||
└── development/
|
||||
├── wildcard/
|
||||
├── single/
|
||||
└── san/{证书标识}/
|
||||
├── current/
|
||||
└── versions/{版本}/
|
||||
└── san/{证书标识}/
|
||||
└── {日期}-Vx.x/
|
||||
```
|
||||
|
||||
其中 `{证书标识}` 必须能够稳定对应主域名和 SAN 域名集合;域名集合发生变化时创建新的证书版本,不覆盖原有证书版本。
|
||||
其中 `{证书标识}` 必须能够稳定对应主域名和 SAN 域名集合;域名集合发生变化时更新当前证书版本目录,不在正式证书目录中保留历史版本。
|
||||
|
||||
【用户补充 U-074】(2026-08-30):将生产/开发目录和当前/历史版本目录合并简化;正式证书目录只保留当前使用版本,版本目录名称使用日期加 `Vx.x`。本补充作为当前实现约束,优先于本节之前关于双环境目录和正式目录保留历史版本的描述。
|
||||
|
||||
### 1.3 DNS 验证
|
||||
|
||||
@@ -1020,4 +1012,4 @@ imported 外部导入
|
||||
|
||||
- **用户补充:**为不熟悉 SSH 密钥生成的用户提供从生成密钥到粘贴公钥的完整指导,并支持更省事的操作方式。
|
||||
- **实现说明:**服务器配置页面增加 Windows、Linux/macOS 命令切换;支持复制密钥生成命令、复制公钥安装命令、选择本机私钥文件导入、私钥口令显示/隐藏,以及 Linux 和 Windows OpenSSH 授权位置说明。私钥只在页面内存中读取,保存时由后端加密存储。
|
||||
- **状态:**`[x]` 已完成前端引导和中文说明文档,待前端构建和真实浏览器页面复审。
|
||||
- **状态:**`[x]` 已完成前端引导和中文说明文档,待前端构建和真实浏览器页面复审。
|
||||
@@ -2710,3 +2710,234 @@ Linux Ubuntu 22.04 上的 `Scert-admin` 手动启停、无开机自启动、无
|
||||
- [x] 源码中未发现 HTML 数字编码中文字符。
|
||||
- [x] `git diff --check` 通过。
|
||||
- [!] 浏览器 MCP 当前因共享 Chrome Profile 被其他浏览器进程占用,暂未完成本次实际输入交互截图复审。
|
||||
|
||||
## 六十三、初始化向导布局与 DNS API 在线测试完善(2026-08-29)
|
||||
|
||||
### 63.1 本轮需求
|
||||
|
||||
- [✓] 将 Scert 主服务端口放入初始化向导第 1 步。
|
||||
- [✓] 将管理页面使用的域名或公网 IP 放入初始化向导第 1 步。
|
||||
- [✓] 补全 DNS API 在线测试的临时 TXT 记录创建、公网 DNS 查询确认和自动清理流程。
|
||||
- [✓] 在前端展示 DNS 在线测试的创建、查询和清理阶段状态及诊断信息。
|
||||
|
||||
### 63.2 细节修复
|
||||
|
||||
- [✓] 将“管理页面访问方式”从嵌套 `label` 调整为独立可访问性控件,避免按钮名称错误继承外层字段标题。
|
||||
- [✓] 为域名/IP切换按钮补充 `aria-pressed` 状态。
|
||||
- [✓] 将 DNS 验证兜底错误改为中文提示“DNS API 在线验证失败”。
|
||||
|
||||
### 63.3 验证状态
|
||||
|
||||
- [✓] 后端单元测试、竞态测试、静态检查和模块校验通过。
|
||||
- [✓] 前端生产构建通过。
|
||||
- [✓] 无效 DNS 凭据测试能够展示“创建记录:失败”阶段诊断,未暴露 TXT 验证值或凭据。
|
||||
- [✓] 桌面浏览器已完成 1440×900、1200×700 宽度/低高度复审,内容区可滚动且底部操作栏保持可见。
|
||||
- [!] 真实 DNS 服务商成功链路不能在无用户授权凭据和测试域名时重复执行;现有真实验证记录仍以此前授权测试结果为准。
|
||||
|
||||
## 六十四、临时文件清理与 DNS 在线测试取消场景保护(2026-08-29)
|
||||
|
||||
### 64.1 文件清理
|
||||
|
||||
- [✓] 删除根目录已确认无用的 `.codex-*` 临时补丁和临时源码副本。
|
||||
- [✓] 删除 `.review-reset-docs.patch`、`backend/codex-restore.patch` 和 `backend/.codex-test-build/`。
|
||||
- [✓] 未删除源码、文档、配置、数据库、证书、运行数据、依赖目录或可能正在使用的构建产物。
|
||||
- [✓] 清理后确认工作区中未残留上述 Codex 临时文件。
|
||||
|
||||
### 64.2 DNS 在线测试保护
|
||||
|
||||
- [✓] 公网 DNS 查询失败或请求被取消后,仍使用独立清理上下文尝试删除临时 TXT 记录。
|
||||
- [✓] 清理上下文最多保留 30 秒,避免继承已取消的请求上下文,也避免清理操作无限等待。
|
||||
- [✓] 增加查询取消后自动清理的回归测试。
|
||||
- [✓] 增加查询失败且自动清理失败时的组合诊断和阶段报告回归测试。
|
||||
- [✓] 修复 DNS 测试辅助代码中的连续问号占位错误,恢复可读的中文诊断。
|
||||
|
||||
### 64.3 验证结果
|
||||
|
||||
- [✓] DNS Provider 定向测试通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `go mod verify` 通过。
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
- [✓] `git diff --check` 通过;Git 的换行格式提示不属于差异错误。
|
||||
- [✓] 跟踪中的源码和文档未发现连续问号、替换字符或 HTML 数字编码中文。
|
||||
- [!] 本轮未重复使用真实 DNS 凭据写入公网记录;真实服务商成功链路继续沿用此前授权测试结果。
|
||||
|
||||
## 六十五、管理后台登录态门禁接入(2026-08-29)
|
||||
|
||||
### 65.1 本轮需求清单
|
||||
|
||||
- [✓] 初始化完成后,前端先读取服务端登录会话,再决定显示管理后台或登录页面。
|
||||
- [✓] 未登录访问根路径时显示管理员登录界面,不再把管理接口 401 错误误报为核心服务连接失败。
|
||||
- [✓] 初始化向导完成后进入登录状态检查,避免初始化完成后直接渲染未授权管理后台。
|
||||
- [✓] 登录态检查请求显式携带 Cookie,并保留后端会话过期后的重新登录入口。
|
||||
|
||||
### 65.2 修改文件
|
||||
|
||||
- `frontend/src/App.js`
|
||||
- 增加初始化完成后的 `/api/v1/auth/session` 会话检查。
|
||||
- 区分未登录、已登录和服务检查失败状态。
|
||||
- 初始化向导完成后将管理后台置为未登录状态。
|
||||
- `frontend/src/App.vue`
|
||||
- 未登录时渲染管理员登录页面。
|
||||
- 只有确认已登录后才渲染管理后台。
|
||||
- `frontend/src/views/Dashboard/Dashboard.js`
|
||||
- 管理接口统一携带登录 Cookie。
|
||||
- 会话过期时跳转到管理员登录页面,并显示重新登录提示。
|
||||
|
||||
### 65.3 验证状态
|
||||
|
||||
- [✓] 前端生产构建。
|
||||
- [✓] 后端回归测试、竞态测试、静态检查和模块完整性检查。
|
||||
- [x] 通过浏览器隔离模拟已初始化且未登录场景,根路径显示管理员登录页面,未直接渲染管理数据。
|
||||
- [x] 通过浏览器隔离模拟已初始化且已登录场景,根路径显示管理后台并完成空数据状态加载。
|
||||
- [x] 当前管理后台会话过期时跳转管理员登录页面,并提示重新登录。
|
||||
- [!] 当前运行配置仍未完成首次初始化,尚未在真实已初始化运行数据上重复执行登录流程;隔离模拟不替代生产验收。
|
||||
- [!] 真实浏览器截图复审仍需独立浏览器 MCP 窗口;不能用移动端预览替代桌面端复审。
|
||||
|
||||
## 六十六、CNAME 委派与凭据规范化完成记录(2026-08-29)
|
||||
|
||||
### 66.1 开发任务状态
|
||||
|
||||
- [✓] CNAME Provider 标记为可用,并支持配置专用验证域。
|
||||
- [✓] CNAME 委派支持选择已接入的目标 DNS Provider。
|
||||
- [✓] CNAME 委派支持嵌套 JSON 凭据,并复用目标 Provider 的凭据校验和 lego 适配器。
|
||||
- [✓] DNS-01 临时 TXT 记录的创建和清理转发到专用验证域。
|
||||
- [✓] 委派目标禁止再次选择 CNAME 或其他未接入 Provider,避免递归和不明确的适配器行为。
|
||||
- [✓] 初始化保存 DNS 凭据前复制并规范化键和值,不修改调用方输入。
|
||||
- [✓] 增加委派转发、错误透传、递归保护、凭据 JSON 校验和凭据规范化测试。
|
||||
|
||||
### 66.2 验证状态
|
||||
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [ ] `go test -race ./...`、`go vet ./...`、`go mod verify` 和前端生产构建等待本轮最终复核。
|
||||
- [!] 未使用真实 DNS 凭据执行公网 CNAME、TXT 传播和 Let’s Encrypt Production 验收;该项必须在用户授权的真实域名环境执行。
|
||||
|
||||
## 六十七、全量代码复审与最终验证记录(2026-08-29)
|
||||
|
||||
### 67.1 本轮需求与开发状态
|
||||
|
||||
- [✓] 系统设置页面补充服务监听地址、服务端口、HTTPS 模式、管理页面域名和管理页面公网 IP。
|
||||
- [✓] 初始化向导保留首次运行所需的端口和 Web 访问方式配置,并与服务端配置字段保持一致。
|
||||
- [✓] DNS API 在线测试支持服务商目录、动态凭据字段、CNAME 委派专用验证域、目标 Provider 和嵌套凭据 JSON。
|
||||
- [✓] DNS 在线测试覆盖临时 TXT 记录创建、公网查询、自动清理和失败阶段报告。
|
||||
- [✓] CNAME 委派 Provider 已接入,目标 Provider 禁止再次选择 CNAME 或未接入 Provider。
|
||||
- [✓] DNS 凭据在验证前规范化并在验证成功后加密保存,普通配置和接口响应不返回明文凭据。
|
||||
- [✓] 设置接口仅在监听地址、服务端口或 HTTPS 模式变化时返回 `restart_required: true`。
|
||||
- [✓] 手动续期检查接口已接入管理后台。
|
||||
|
||||
### 67.2 实际浏览器和接口复核
|
||||
|
||||
- [✓] 当前源码后端已重新构建并启动于 `127.0.0.1:5200`。
|
||||
- [✓] 前端开发服务运行于 `127.0.0.1:5273`,独立 Chrome DevTools 页面可正常访问。
|
||||
- [✓] 初始化向导第 1 步实际显示 Scert 主服务端口、管理页面域名/IP 切换和密码重置地址预览。
|
||||
- [✓] DNS Provider 实际显示“CNAME 委派”,不再显示“适配器待开放”。
|
||||
- [✓] 选择 CNAME 委派后实际显示专用验证域、委派目标 DNS 服务商和委派凭据 JSON 字段。
|
||||
- [✓] 使用伪造 Cloudflare 凭据实际触发在线测试,页面显示“创建记录:失败”,未误报验证成功。
|
||||
- [✓] 设置和初始化接口实际返回服务端口、Web 域名/IP、传播参数和 DNS Provider 状态。
|
||||
|
||||
### 67.3 最终自动化验证
|
||||
|
||||
- [✓] `go test ./...`
|
||||
- [✓] `go test -race ./...`
|
||||
- [✓] `go vet ./...`
|
||||
- [✓] `go mod verify`
|
||||
- [✓] `npm.cmd run build`
|
||||
- [✓] `git diff --check`
|
||||
|
||||
### 67.4 文件清理与验收边界
|
||||
|
||||
- [✓] 根目录没有发现 `.codex` 目录或已知 Codex 临时源码副本。
|
||||
- [!] `.runtime` 中仍有 3 个已确认的 Codex 临时补丁文件;本轮逐个删除命令被当前执行环境安全策略拒绝,因此未绕过策略强制删除。
|
||||
- [✓] 未删除源码、文档、配置、数据库、证书、密钥、运行目录或构建产物。
|
||||
- [!] 未在本轮使用新的真实 DNS 凭据、Let’s Encrypt Production、SSH 私钥、远程服务器或生产 HTTPS 环境;这些仍需用户授权后的实机验收。
|
||||
- [✓] 代码层开发和本地验证完成,Git 提交与推送仍未执行。
|
||||
## 六十八、部署脚本、发布构建与通知安全复核(2026-08-30)
|
||||
|
||||
### 68.1 本轮需求清单
|
||||
|
||||
- [✓] 增加 Windows 安装器,检查平台、管理员权限、安装产物、服务名称和系统工具。
|
||||
- [✓] Windows 安装器创建程序、配置、数据、日志、备份、文档、运行时和证书目录。
|
||||
- [✓] Windows 安装器使用 `LocalService` 注册 `Scert` 和手动启动的 `Scert-admin`,并设置 ACL。
|
||||
- [✓] Windows 安装器不启动服务、不创建公网防火墙规则、不删除已有配置、数据库、证书和备份。
|
||||
- [✓] 增加 Windows amd64 和 Linux amd64 的跨平台发布构建脚本。
|
||||
- [✓] 发布构建输出核心服务、密码重置程序和 SHA-256 校验清单。
|
||||
- [✓] 通知会话认证保留密码原始字节,不对密码使用 `TrimSpace`;登录业务错误解析 `errorNo`,并保留非敏感错误说明。
|
||||
- [✓] 通知发送接口仍按“进入邮件服务队列”处理,不将 HTTP 成功误称为最终收件成功。
|
||||
|
||||
### 68.2 新增和修改文件
|
||||
|
||||
- `deploy/install-windows.ps1`
|
||||
- `deploy/README.md`
|
||||
- `build/build-release.ps1`
|
||||
- `build/README.md`
|
||||
- `backend/internal/notification/service.go`
|
||||
- `backend/internal/notification/service_test.go`
|
||||
|
||||
### 68.3 验证边界
|
||||
|
||||
- [x] Windows 安装脚本已完成代码编写,等待 Windows 管理员权限、服务控制台和 ACL 实机复审。
|
||||
- [x] 发布构建脚本已完成代码编写,等待本轮执行 Windows/Linux 目标构建。
|
||||
- [x] 通知会话流程已完成本地测试覆盖,真实临时邮箱最终投递仍需查看邮件详情状态和收件证据。
|
||||
- [!] 未使用真实 DNS 凭据、Let’s Encrypt Production、SSH 私钥、远程服务器或生产 HTTPS 环境;这些项目仍需用户授权后的实机验收。
|
||||
|
||||
## 六十九、SSH 密钥随机路径与配置引导复核(2026-08-30)
|
||||
|
||||
### 69.1 本轮需求与实现状态
|
||||
|
||||
- [✓] 本机 SSH 密钥统一使用 `/ssl/ssh/` 目录生成。
|
||||
- [✓] 密钥文件名使用 `用户名+scert-随机标识` 格式,公钥文件追加 `.pub`。
|
||||
- [✓] 每次打开 SSH 密钥配置弹窗都会重新生成随机标识,避免不同主机或不同配置复用固定文件名。
|
||||
- [✓] Windows、Linux/macOS 密钥生成命令和公钥安装命令统一使用当前随机路径。
|
||||
- [✓] 页面显示本次密钥文件名、本地私钥路径、本地公钥路径和远程登录目标。
|
||||
- [✓] Scert 后端仍仅保存加密敏感信息引用,不将本地明文私钥路径或私钥内容写入普通配置。
|
||||
|
||||
### 69.2 本轮验证结果
|
||||
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
- [✓] 浏览器复核首次打开和再次打开弹窗时随机文件名发生变化。
|
||||
- [✓] 浏览器复核服务器配置填写 `deploy` 和 `192.0.2.50` 后,路径和 SSH 目标同步更新。
|
||||
- [✓] 浏览器复核 Windows 与 Linux/macOS 命令均包含当前随机路径和公钥 `.pub` 路径。
|
||||
- [✓] 桌面端 1440×901 视口下弹窗宽度为 1080px,页面背景滚动已锁定,弹窗内部无垂直溢出。
|
||||
- [!] 真实 SSH 主机、公钥安装、私钥登录和证书部署仍需用户提供并授权实机环境后验收。
|
||||
|
||||
## 七十、证书目录结构合并与当前版本简化(2026-08-30)
|
||||
|
||||
### 70.1 本轮需求清单
|
||||
|
||||
- [✓] 合并生产和开发证书目录层级,申请环境继续由域名配置中的 ACME 环境字段区分。
|
||||
- [✓] 合并当前和历史版本目录层级,正式证书目录只保留当前使用版本。
|
||||
- [✓] 版本目录名称改为 `YYYYMMDD-Vx.x`,例如 `20260830-V1.0`。
|
||||
- [✓] 同一天重复保存时递增版本号,避免目录覆盖。
|
||||
- [✓] 保留备份目录用于保存失败回滚所需的旧证书文件,不将备份目录作为历史版本列表。
|
||||
- [✓] 前端移除历史版本查看和恢复入口,只显示当前证书状态。
|
||||
|
||||
### 70.2 代码和文档调整
|
||||
|
||||
- `backend/internal/certificate/lifecycle.go`
|
||||
- `backend/internal/certificate/lifecycle_version_test.go`
|
||||
- `backend/internal/certificate/service_test.go`
|
||||
- `frontend/src/views/Dashboard/Dashboard.vue`
|
||||
- `frontend/src/views/Dashboard/Dashboard.js`
|
||||
- `frontend/src/views/Dashboard/Dashboard.css`
|
||||
- `doc/SSL服务程序需求确认文档.md`
|
||||
- `doc/SSL服务程序技术架构设计文档.md`
|
||||
|
||||
### 70.3 验证状态
|
||||
|
||||
- [x] 证书生命周期专项测试已通过,等待全量后端测试复审。
|
||||
- [x] 新目录格式、重复保存唯一性、旧当前目录清理和失败回滚已覆盖自动化测试。
|
||||
- [x] 前端历史版本面板和恢复操作已移除,等待前端构建复审。
|
||||
- [!] 旧安装目录中的历史文件未执行批量清理,避免未经授权删除用户证书、私钥或备份;后续迁移清理需单独授权。
|
||||
|
||||
## 七十一、登录界面用户化(2026-08-30)
|
||||
|
||||
### 71.1 本轮需求清单
|
||||
|
||||
- [✓] 登录页面标题由“管理员登录”调整为“用户登录”。
|
||||
- [✓] 登录页面说明、密码占位符和无障碍标签统一使用“用户”文案。
|
||||
- [✓] 登录流程阶段标题同步调整为“用户登录”,不改变服务端认证、角色识别和会话逻辑。
|
||||
|
||||
### 71.2 验证状态
|
||||
|
||||
- [✓] 登录相关前端文件已完成修改,等待本轮构建复审。
|
||||
- [!] 后端仍根据服务端返回结果识别超级管理员、管理员和普通用户,未因页面文案调整而改变权限模型。
|
||||
+3
-3
@@ -2,7 +2,7 @@
|
||||
|
||||
## 1. 配置目的
|
||||
|
||||
Scert 的证书申请、续期、部署和校验任务完成后,可以通过第三方邮件服务 API 发送通知。SMTP、IMAP、POP3 协议仅作为外部邮件服务兼容性参考,Scert 不实现邮件服务器端;当前已接入 HTTP 邮件 API 通知。
|
||||
Scert 的证书申请、续期、部署和校验任务完成后,可以通过第三方邮件服务 API 或 SMTP 服务发送通知。Scert 只实现出站通知客户端,不实现 SMTP、IMAP、POP3 邮件服务器端;HTTP 邮件 API 和 SMTP 出站通知均已接入。
|
||||
|
||||
## 2. HTTP 邮件服务配置
|
||||
|
||||
@@ -58,7 +58,7 @@ Smail 当前接口需要登录会话 Cookie、`smail_csrf` Cookie、`X-CSRF-Toke
|
||||
|
||||
## 6. 当前实现边界
|
||||
|
||||
当前阶段已完成邮件通知配置的保存、校验、初始化接口、CLI/Web 表单接入和 HTTP 通知发送器。SMTP 发送器尚未接入;当前应优先使用 HTTP 邮件 API 方式配置邮件服务。Smail 登录会话可通过 `session` 认证模式自动建立和刷新。
|
||||
当前阶段已完成邮件通知配置的保存、校验、初始化接口、CLI/Web 表单接入、HTTP 通知发送器和 SMTP 出站通知发送器。SMTP 支持 `plain`、`starttls` 和 `implicit_tls` 三种连接模式;生产环境建议使用 STARTTLS 或隐式 TLS。Smail 登录会话可通过 `session` 认证模式自动建立和刷新。
|
||||
|
||||
## 7. 当前开发状态补充
|
||||
|
||||
@@ -73,4 +73,4 @@ Smail 当前接口需要登录会话 Cookie、`smail_csrf` Cookie、`X-CSRF-Toke
|
||||
- 将所有 2xx 响应视为成功,其他响应按重试配置处理。
|
||||
- 证书工作流会在任务成功、失败或部署错误后触发通知;通知发送失败会写入 Scert 日志,不覆盖原证书任务结果。
|
||||
|
||||
SMTP 发送器仍未接入。初始化界面和 CLI 不再暴露 SMTP 开关,旧配置字段仅为兼容已有配置文件保留,并不会在初始化时启用。Smail 登录会话的自动适配已通过 `session` 模式接入,仍需在目标部署环境使用实际凭据进行上线前复核。
|
||||
SMTP 出站通知已经接入。初始化界面和 CLI 可以配置 SMTP 主机、端口、用户名、凭据引用、连接模式和明文认证开关;SMTP 密码只保存到加密敏感信息存储,配置文件仅保存 `secret://` 凭据引用。明文连接认证默认拒绝,只有明确启用 `SMTP 明文认证` 后才允许。CLI 可使用 `scert config set-secret --key notification.smtp_password` 保存敏感值。SMTP 是出站连接,Scert 不需要开放 SMTP 入站端口。Smail 登录会话的自动适配已通过 `session` 模式接入,仍需在目标部署环境使用实际凭据进行上线前复核。
|
||||
Reference in new issue
Block a user