From b2833b761dcc25c382a13153b4cef5cbdda81266 Mon Sep 17 00:00:00 2001 From: xuans Date: Fri, 28 Aug 2026 15:23:23 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E5=96=84=E8=AF=81=E4=B9=A6=E7=AE=A1?= =?UTF-8?q?=E7=90=86=E4=B8=8E=E9=82=AE=E4=BB=B6=E9=80=9A=E7=9F=A5=E6=B5=81?= =?UTF-8?q?=E7=A8=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 4 + backend/go.mod | 50 ++ backend/go.sum | 332 ++++++++ backend/internal/app/app.go | 40 +- backend/internal/app/certificate_workflow.go | 94 ++- backend/internal/certificate/lifecycle.go | 303 ++++++- .../certificate/lifecycle_version_test.go | 132 +++ backend/internal/certificate/service.go | 155 +++- backend/internal/certificate/service_test.go | 30 + backend/internal/certificate/validation.go | 272 +++++++ .../internal/certificate/validation_test.go | 96 +++ backend/internal/cli/operations.go | 649 +++++++++++++++ .../internal/cli/operations_review_test.go | 65 ++ backend/internal/cli/operations_test.go | 75 ++ backend/internal/cli/root.go | 80 +- backend/internal/config/config.go | 112 ++- backend/internal/database/database.go | 49 ++ backend/internal/database/database_test.go | 30 +- backend/internal/database/migrate.go | 42 +- .../migrations/mysql/0004_task_attempts.sql | 20 + .../migrations/sqlite/0004_task_attempts.sql | 20 + .../internal/database/review_runtime_test.go | 42 + backend/internal/database/review_test.go | 2 +- backend/internal/deployment/ssh_test.go | 4 +- backend/internal/dnsprovider/catalog.go | 18 +- backend/internal/dnsprovider/lego_factory.go | 96 ++- backend/internal/dnsprovider/tester_test.go | 88 +- backend/internal/httpapi/auth.go | 36 +- backend/internal/httpapi/certificate_api.go | 249 ++++++ .../internal/httpapi/certificate_api_test.go | 138 ++++ backend/internal/httpapi/middleware.go | 112 +++ backend/internal/httpapi/middleware_test.go | 96 +++ .../httpapi/password_reset_account.go | 73 ++ backend/internal/httpapi/reset.go | 6 +- backend/internal/httpapi/server.go | 206 +++-- backend/internal/httpapi/server_test.go | 94 +++ backend/internal/httpapi/setup.go | 195 ++++- backend/internal/httpapi/setup_test.go | 141 ++++ backend/internal/httpapi/task_api.go | 183 +++++ backend/internal/httpapi/task_api_test.go | 131 +++ backend/internal/notification/service.go | 534 ++++++++++++ backend/internal/notification/service_test.go | 273 +++++++ backend/internal/repository/audit_reader.go | 42 + .../internal/repository/task_repository.go | 324 ++++++++ .../repository/task_repository_test.go | 93 +++ backend/internal/setup/setup.go | 99 ++- backend/internal/setup/setup_test.go | 23 + deploy/systemd/Scert服务管理说明.md | 2 +- doc/SSL服务程序需求确认文档.md | 2 +- doc/Scert开发任务清单.md | 144 +++- doc/后端接口说明文档.md | 770 ++++++++++++++++++ doc/邮件通知配置说明.md | 76 ++ frontend/src/views/Dashboard/Dashboard.vue | 4 +- frontend/src/views/Login/Login.js | 34 +- .../src/views/SetupWizard/SetupWizard.css | 290 +++++++ frontend/src/views/SetupWizard/SetupWizard.js | 135 +++ .../src/views/SetupWizard/SetupWizard.vue | 154 +++- .../views/SuperAdminReset/SuperAdminReset.css | 2 +- .../views/SuperAdminReset/SuperAdminReset.vue | 2 +- .../components/AccessShell/AccessShell.css | 31 +- 60 files changed, 7340 insertions(+), 254 deletions(-) create mode 100644 backend/internal/certificate/lifecycle_version_test.go create mode 100644 backend/internal/certificate/validation.go create mode 100644 backend/internal/certificate/validation_test.go create mode 100644 backend/internal/cli/operations.go create mode 100644 backend/internal/cli/operations_review_test.go create mode 100644 backend/internal/cli/operations_test.go create mode 100644 backend/internal/database/migrations/mysql/0004_task_attempts.sql create mode 100644 backend/internal/database/migrations/sqlite/0004_task_attempts.sql create mode 100644 backend/internal/database/review_runtime_test.go create mode 100644 backend/internal/httpapi/certificate_api.go create mode 100644 backend/internal/httpapi/certificate_api_test.go create mode 100644 backend/internal/httpapi/middleware.go create mode 100644 backend/internal/httpapi/middleware_test.go create mode 100644 backend/internal/httpapi/password_reset_account.go create mode 100644 backend/internal/httpapi/task_api.go create mode 100644 backend/internal/httpapi/task_api_test.go create mode 100644 backend/internal/notification/service.go create mode 100644 backend/internal/notification/service_test.go create mode 100644 backend/internal/repository/audit_reader.go create mode 100644 backend/internal/repository/task_repository.go create mode 100644 backend/internal/repository/task_repository_test.go create mode 100644 doc/后端接口说明文档.md create mode 100644 doc/邮件通知配置说明.md diff --git a/.gitignore b/.gitignore index eed6c4e..5cfe54c 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,9 @@ backend/dist/ backend/build/ +backend/bin/ frontend/node_modules/ frontend/dist/ *.log +.runtime/ +build/ +codex-*.patch diff --git a/backend/go.mod b/backend/go.mod index d0767eb..ed82aac 100644 --- a/backend/go.mod +++ b/backend/go.mod @@ -13,21 +13,58 @@ require ( ) require ( + cloud.google.com/go/auth v0.20.0 // indirect + cloud.google.com/go/auth/oauth2adapt v0.2.8 // indirect + cloud.google.com/go/compute/metadata v0.9.0 // indirect filippo.io/edwards25519 v1.1.0 // indirect + github.com/alibabacloud-go/alibabacloud-gateway-spi v0.0.5 // indirect + github.com/alibabacloud-go/darabonba-openapi/v2 v2.2.3 // indirect + github.com/alibabacloud-go/debug v1.0.1 // indirect + github.com/alibabacloud-go/tea v1.5.2 // indirect + github.com/alibabacloud-go/tea-utils/v2 v2.0.9 // indirect + github.com/aliyun/credentials-go v1.4.7 // indirect + github.com/aws/aws-sdk-go-v2 v1.42.1 // indirect + github.com/aws/aws-sdk-go-v2/config v1.32.30 // indirect + github.com/aws/aws-sdk-go-v2/credentials v1.19.29 // indirect + github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.30 // indirect + github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.30 // indirect + github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.30 // indirect + github.com/aws/aws-sdk-go-v2/internal/v4a v1.4.31 // indirect + github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.13 // indirect + github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.30 // indirect + github.com/aws/aws-sdk-go-v2/service/route53 v1.64.1 // indirect + github.com/aws/aws-sdk-go-v2/service/signin v1.4.1 // indirect + github.com/aws/aws-sdk-go-v2/service/sso v1.32.1 // indirect + github.com/aws/aws-sdk-go-v2/service/ssooidc v1.37.1 // indirect + github.com/aws/aws-sdk-go-v2/service/sts v1.44.1 // indirect + github.com/aws/smithy-go v1.27.3 // indirect github.com/bytedance/sonic v1.11.6 // indirect github.com/bytedance/sonic/loader v0.1.1 // indirect github.com/cenkalti/backoff/v5 v5.0.3 // indirect + github.com/cespare/xxhash/v2 v2.3.0 // indirect + github.com/clbanning/mxj/v2 v2.7.0 // indirect github.com/cloudwego/base64x v0.1.4 // indirect github.com/cloudwego/iasm v0.2.0 // indirect github.com/dustin/go-humanize v1.0.1 // indirect + github.com/felixge/httpsnoop v1.0.4 // indirect github.com/gabriel-vasile/mimetype v1.4.13 // indirect github.com/gin-contrib/sse v0.1.0 // indirect + github.com/go-acme/alidns-20150109/v5 v5.5.0 // indirect + github.com/go-acme/tencentclouddnspod v1.3.24 // indirect github.com/go-jose/go-jose/v4 v4.1.4 // indirect + github.com/go-logr/logr v1.4.3 // indirect + github.com/go-logr/stdr v1.2.2 // indirect github.com/go-playground/locales v0.14.1 // indirect github.com/go-playground/universal-translator v0.18.1 // indirect github.com/go-playground/validator/v10 v10.30.3 // indirect github.com/goccy/go-json v0.10.2 // indirect + github.com/goccy/go-yaml v1.19.2 // indirect + github.com/google/s2a-go v0.1.9 // indirect github.com/google/uuid v1.6.0 // indirect + github.com/googleapis/enterprise-certificate-proxy v0.3.17 // indirect + github.com/googleapis/gax-go/v2 v2.22.0 // indirect + github.com/gorilla/websocket v1.5.3 // indirect + github.com/huaweicloud/huaweicloud-sdk-go-v3 v0.1.205 // indirect github.com/inconshreveable/mousetrap v1.1.0 // indirect github.com/json-iterator/go v1.1.13-0.20220915233716-71ac16282d12 // indirect github.com/klauspost/cpuid/v2 v2.2.7 // indirect @@ -43,18 +80,31 @@ require ( github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect github.com/rogpeppe/go-internal v1.14.1 // indirect github.com/spf13/pflag v1.0.10 // indirect + github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.3.133 // indirect + github.com/tjfoc/gmsm v1.4.1 // indirect github.com/twitchyliquid64/golang-asm v0.15.1 // indirect github.com/ugorji/go/codec v1.2.12 // indirect + go.mongodb.org/mongo-driver v1.17.9 // indirect + go.opentelemetry.io/auto/sdk v1.2.1 // indirect + go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0 // indirect + go.opentelemetry.io/otel v1.43.0 // indirect + go.opentelemetry.io/otel/metric v1.43.0 // indirect + go.opentelemetry.io/otel/trace v1.43.0 // indirect golang.org/x/arch v0.8.0 // indirect golang.org/x/exp v0.0.0-20260410095643-746e56fc9e2f // indirect golang.org/x/mod v0.37.0 // indirect golang.org/x/net v0.57.0 // indirect + golang.org/x/oauth2 v0.36.0 // indirect golang.org/x/sync v0.22.0 // indirect golang.org/x/sys v0.47.0 // indirect golang.org/x/text v0.40.0 // indirect golang.org/x/tools v0.47.0 // indirect + google.golang.org/api v0.288.0 // indirect + google.golang.org/genproto/googleapis/rpc v0.0.0-20260630182238-925bb5da69e7 // indirect + google.golang.org/grpc v1.82.0 // indirect google.golang.org/protobuf v1.36.11 // indirect gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c // indirect + gopkg.in/ini.v1 v1.67.3 // indirect gopkg.in/yaml.v3 v3.0.1 // indirect modernc.org/libc v1.62.1 // indirect modernc.org/mathutil v1.7.1 // indirect diff --git a/backend/go.sum b/backend/go.sum index fc143be..f11fa7c 100644 --- a/backend/go.sum +++ b/backend/go.sum @@ -1,15 +1,98 @@ +cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= +cloud.google.com/go/auth v0.20.0 h1:kXTssoVb4azsVDoUiF8KvxAqrsQcQtB53DcSgta74CA= +cloud.google.com/go/auth v0.20.0/go.mod h1:942/yi/itH1SsmpyrbnTMDgGfdy2BUqIKyd0cyYLc5Q= +cloud.google.com/go/auth/oauth2adapt v0.2.8 h1:keo8NaayQZ6wimpNSmW5OPc283g65QNIiLpZnkHRbnc= +cloud.google.com/go/auth/oauth2adapt v0.2.8/go.mod h1:XQ9y31RkqZCcwJWNSx2Xvric3RrU88hAYYbjDWYDL+c= +cloud.google.com/go/compute/metadata v0.9.0 h1:pDUj4QMoPejqq20dK0Pg2N4yG9zIkYGdBtwLoEkH9Zs= +cloud.google.com/go/compute/metadata v0.9.0/go.mod h1:E0bWwX5wTnLPedCKqk3pJmVgCBSM6qQI1yTBdEb3C10= filippo.io/edwards25519 v1.1.0 h1:FNf4tywRC1HmFuKW5xopWpigGjJKiJSV0Cqo0cJWDaA= filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4= +github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= +github.com/alibabacloud-go/alibabacloud-gateway-pop v0.0.6/go.mod h1:4EUIoxs/do24zMOGGqYVWgw0s9NtiylnJglOeEB5UJo= +github.com/alibabacloud-go/alibabacloud-gateway-spi v0.0.4/go.mod h1:sCavSAvdzOjul4cEqeVtvlSaSScfNsTQ+46HwlTL1hc= +github.com/alibabacloud-go/alibabacloud-gateway-spi v0.0.5 h1:zE8vH9C7JiZLNJJQ5OwjU9mSi4T9ef9u3BURT6LCLC8= +github.com/alibabacloud-go/alibabacloud-gateway-spi v0.0.5/go.mod h1:tWnyE9AjF8J8qqLk645oUmVUnFybApTQWklQmi5tY6g= +github.com/alibabacloud-go/darabonba-array v0.1.0/go.mod h1:BLKxr0brnggqOJPqT09DFJ8g3fsDshapUD3C3aOEFaI= +github.com/alibabacloud-go/darabonba-encode-util v0.0.2/go.mod h1:JiW9higWHYXm7F4PKuMgEUETNZasrDM6vqVr/Can7H8= +github.com/alibabacloud-go/darabonba-map v0.0.2/go.mod h1:28AJaX8FOE/ym8OUFWga+MtEzBunJwQGceGQlvaPGPc= +github.com/alibabacloud-go/darabonba-openapi/v2 v2.2.2/go.mod h1:CsqHkHPpAKL64jl/fChR249EL0abYEIDWmlwFYgo7/E= +github.com/alibabacloud-go/darabonba-openapi/v2 v2.2.3 h1:rec08F9BzxIiJ03h2u6BT2QqLVa8ktnpvJ27j5PsjLM= +github.com/alibabacloud-go/darabonba-openapi/v2 v2.2.3/go.mod h1:eHjVxrT9g8uVYN/nyAwOFQEfkVA154ChiqRc2XnNKYU= +github.com/alibabacloud-go/darabonba-signature-util v0.0.7/go.mod h1:oUzCYV2fcCH797xKdL6BDH8ADIHlzrtKVjeRtunBNTQ= +github.com/alibabacloud-go/darabonba-string v1.0.2/go.mod h1:93cTfV3vuPhhEwGGpKKqhVW4jLe7tDpo3LUM0i0g6mA= +github.com/alibabacloud-go/debug v0.0.0-20190504072949-9472017b5c68/go.mod h1:6pb/Qy8c+lqua8cFpEy7g39NRRqOWc3rOwAy8m5Y2BY= +github.com/alibabacloud-go/debug v1.0.0/go.mod h1:8gfgZCCAC3+SCzjWtY053FrOcd4/qlH6IHTI4QyICOc= +github.com/alibabacloud-go/debug v1.0.1 h1:MsW9SmUtbb1Fnt3ieC6NNZi6aEwrXfDksD4QA6GSbPg= +github.com/alibabacloud-go/debug v1.0.1/go.mod h1:8gfgZCCAC3+SCzjWtY053FrOcd4/qlH6IHTI4QyICOc= +github.com/alibabacloud-go/endpoint-util v1.1.0/go.mod h1:O5FuCALmCKs2Ff7JFJMudHs0I5EBgecXXxZRyswlEjE= +github.com/alibabacloud-go/openapi-util v0.1.0/go.mod h1:sQuElr4ywwFRlCCberQwKRFhRzIyG4QTP/P4y1CJ6Ws= +github.com/alibabacloud-go/tea v1.1.0/go.mod h1:IkGyUSX4Ba1V+k4pCtJUc6jDpZLFph9QMy2VUPTwukg= +github.com/alibabacloud-go/tea v1.1.7/go.mod h1:/tmnEaQMyb4Ky1/5D+SE1BAsa5zj/KeGOFfwYm3N/p4= +github.com/alibabacloud-go/tea v1.1.8/go.mod h1:/tmnEaQMyb4Ky1/5D+SE1BAsa5zj/KeGOFfwYm3N/p4= +github.com/alibabacloud-go/tea v1.1.11/go.mod h1:/tmnEaQMyb4Ky1/5D+SE1BAsa5zj/KeGOFfwYm3N/p4= +github.com/alibabacloud-go/tea v1.1.17/go.mod h1:nXxjm6CIFkBhwW4FQkNrolwbfon8Svy6cujmKFUq98A= +github.com/alibabacloud-go/tea v1.1.20/go.mod h1:nXxjm6CIFkBhwW4FQkNrolwbfon8Svy6cujmKFUq98A= +github.com/alibabacloud-go/tea v1.2.2/go.mod h1:CF3vOzEMAG+bR4WOql8gc2G9H3EkH3ZLAQdpmpXMgwk= +github.com/alibabacloud-go/tea v1.5.1/go.mod h1:hgSs82CkOiehSQMoiFN79dL6zsGX7pVGvnn9SIEs8/0= +github.com/alibabacloud-go/tea v1.5.2 h1:DUzV/cRTbJC++rmADfqVu//GuWbaD64ZJ3yW3v2ukNU= +github.com/alibabacloud-go/tea v1.5.2/go.mod h1:hgSs82CkOiehSQMoiFN79dL6zsGX7pVGvnn9SIEs8/0= +github.com/alibabacloud-go/tea-utils v1.3.1/go.mod h1:EI/o33aBfj3hETm4RLiAxF/ThQdSngxrpF8rKUDJjPE= +github.com/alibabacloud-go/tea-utils/v2 v2.0.5/go.mod h1:dL6vbUT35E4F4bFTHL845eUloqaerYBYPsdWR2/jhe4= +github.com/alibabacloud-go/tea-utils/v2 v2.0.9 h1:y6pUIlhjxbZl9ObDAcmA1H3c21eaAxADHTDQmBnAIgA= +github.com/alibabacloud-go/tea-utils/v2 v2.0.9/go.mod h1:qxn986l+q33J5VkialKMqT/TTs3E+U9MJpd001iWQ9I= +github.com/aliyun/credentials-go v1.1.2/go.mod h1:ozcZaMR5kLM7pwtCMEpVmQ242suV6qTJya2bDq4X1Tw= +github.com/aliyun/credentials-go v1.3.1/go.mod h1:8jKYhQuDawt8x2+fusqa1Y6mPxemTsBEN04dgcAcYz0= +github.com/aliyun/credentials-go v1.3.6/go.mod h1:1LxUuX7L5YrZUWzBrRyk0SwSdH4OmPrib8NVePL3fxM= +github.com/aliyun/credentials-go v1.4.5/go.mod h1:Jm6d+xIgwJVLVWT561vy67ZRP4lPTQxMbEYRuT2Ti1U= +github.com/aliyun/credentials-go v1.4.7 h1:T17dLqEtPUFvjDRRb5giVvLh6dFT8IcNFJJb7MeyCxw= +github.com/aliyun/credentials-go v1.4.7/go.mod h1:Jm6d+xIgwJVLVWT561vy67ZRP4lPTQxMbEYRuT2Ti1U= +github.com/aws/aws-sdk-go-v2 v1.42.1 h1:9eOTgu1z/dVtYpNZ3/8/XbbaX0x/BqE3HUzAzs6K0ek= +github.com/aws/aws-sdk-go-v2 v1.42.1/go.mod h1:5pKeft2eJj+gElQ38Jqg4ibCqh+/AK33/0X3hip7IjM= +github.com/aws/aws-sdk-go-v2/config v1.32.30 h1:XwsEzpTJfQYJbFicz/QMLwAZdyeNVVoOEkbF7R3gPJk= +github.com/aws/aws-sdk-go-v2/config v1.32.30/go.mod h1:Ud32SuMc+/9BGxfpSVld7HrE2o05JwKmXY4M3jOQNZU= +github.com/aws/aws-sdk-go-v2/credentials v1.19.29 h1:WHZGssHH887cO0ox07SIQZsFx3MKD4ps6w0xUEmnKYQ= +github.com/aws/aws-sdk-go-v2/credentials v1.19.29/go.mod h1:Mhl0xR6zjguiuj00XRx2wMx22sAltk7oya39sT7fdg8= +github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.30 h1:/hi1JADLEW9YYryEz1w4GQu0EtP23pP553Cf9KgsDV4= +github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.30/go.mod h1:/3AOgy4K17Dm4ucMZVC/MJkzy5kmfKUcINRHZyo0koQ= +github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.30 h1:xM/Is9cKMHa8Jj8zkvWhvrFkZsXJV9E+BB4g0HW0duQ= +github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.30/go.mod h1:WueJeNDZvK1fMYEWJIkcivBfEzUkTpBhzlrUKKY8EuA= +github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.30 h1:jn46zC9LdsVR/ZpMIJqMqb8hHv31BlLx3ulVqNspUOk= +github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.30/go.mod h1:1hTMsAgbdS/AtUi4bw8+gUuh1pceo+eXRLfpSuSQj3M= +github.com/aws/aws-sdk-go-v2/internal/v4a v1.4.31 h1:3GUprIsfmGcC5SACIyB0e7E0BM1O1b3Erl5CePYIAeQ= +github.com/aws/aws-sdk-go-v2/internal/v4a v1.4.31/go.mod h1:7PuV1yl5e2xnUbm+RqvVg5i2iBM8EyijZNoI9wsOoOc= +github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.13 h1:mbRIur/BiHK6SKPjoBIXSE/hJ6g6JGRLuxQy1jGjlN4= +github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.13/go.mod h1:ITg9em2KbJx1s0y4aqRX5OYWG6HBZ5TVR//OdpEZ2CQ= +github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.30 h1:/Z5jmNrKsSD7EmDjzAPsm/3L9IuOkzaynklJZ1qX7S4= +github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.30/go.mod h1:lEzEZnOosE7zi8Z6royW1cFJTD9fpab4Ul1SBrllewk= +github.com/aws/aws-sdk-go-v2/service/route53 v1.64.1 h1:qL5ELChQ1o1ZbzHvsl8gzQfAZdbQtrDbUyzJkjkMKcg= +github.com/aws/aws-sdk-go-v2/service/route53 v1.64.1/go.mod h1:0hIRXFez1bZsDFMGkLZvNJbByTSVZ4sFZWpxZ39NPuM= +github.com/aws/aws-sdk-go-v2/service/signin v1.4.1 h1:V7ZZ300WPXGjvkyore5DGe0ljVPOxCXie/thWdtSBXE= +github.com/aws/aws-sdk-go-v2/service/signin v1.4.1/go.mod h1:mxC0nT/C8wMMS97DemZPzvUZxvIt+2Iq+eS3JdFZGgg= +github.com/aws/aws-sdk-go-v2/service/sso v1.32.1 h1:gYFYh4iLLcAOJRLNPY2aD2g9DIhKn4eof8UkIrr1rTk= +github.com/aws/aws-sdk-go-v2/service/sso v1.32.1/go.mod h1:u8af9Nqkmqnr96f7v9nHqzZT9XBwbXEkTiqT4ROuJSE= +github.com/aws/aws-sdk-go-v2/service/ssooidc v1.37.1 h1:arjT9Cm3/WYbGmD5TUZHk4UQn4Lle1fUNZs5FC6CtF0= +github.com/aws/aws-sdk-go-v2/service/ssooidc v1.37.1/go.mod h1:DMPWJBjYs6+3+f/qhBFEFPPlQ6NlhWjai3dJNvipJ84= +github.com/aws/aws-sdk-go-v2/service/sts v1.44.1 h1:RvfHDg+xvAeZ+5741vUEjpOVtYSIm93W2zhx10Xtydw= +github.com/aws/aws-sdk-go-v2/service/sts v1.44.1/go.mod h1:9gdl4RrflIdpDb2TlXshWgR1F9TeCkvqDx77Vpr4Z/Q= +github.com/aws/smithy-go v1.27.3 h1:F3Zb497UhhskkfpJmfkXswyo+t0sh9OTBnIHjogWbVY= +github.com/aws/smithy-go v1.27.3/go.mod h1:YE2RhdIuDbA5E5bTdciG9KrW3+TiEONeUWCqxX9i1Fc= github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0= github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4= github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM= github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU= github.com/cenkalti/backoff/v5 v5.0.3 h1:ZN+IMa753KfX5hd8vVaMixjnqRZ3y8CuJKRKj1xcsSM= github.com/cenkalti/backoff/v5 v5.0.3/go.mod h1:rkhZdG3JZukswDf7f0cwqPNk4K0sa+F97BxZthm/crw= +github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU= +github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs= +github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs= +github.com/clbanning/mxj/v2 v2.7.0 h1:WA/La7UGCanFe5NpHF0Q3DNtnCsVoxbPKuyBNHWRyME= +github.com/clbanning/mxj/v2 v2.7.0/go.mod h1:hNiWqW14h+kc+MdF9C6/YoRfjEJoR3ou6tn/Qo+ve2s= +github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw= github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y= github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w= github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg= github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY= +github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f/go.mod h1:M8M6+tZqaGXZJjfX53e64911xZQV5JYwmTeXPW+k8Sc= github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g= github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E= github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= @@ -18,39 +101,95 @@ github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1 github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto= +github.com/envoyproxy/go-control-plane v0.9.0/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= +github.com/envoyproxy/go-control-plane v0.9.4/go.mod h1:6rpuAdCZL397s3pYoYcLgu1mIlRU8Am5FuJP05cCM98= +github.com/envoyproxy/protoc-gen-validate v0.1.0/go.mod h1:iSmxcyjqTsJpI2R4NaDN7+kN2VEUnK/pcBlmesArF7c= +github.com/fatih/color v1.10.0/go.mod h1:ELkj/draVOlAH/xkhN6mQ50Qd0MPOk5AAr3maGEBuJM= +github.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg= +github.com/felixge/httpsnoop v1.0.4/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U= github.com/gabriel-vasile/mimetype v1.4.13 h1:46nXokslUBsAJE/wMsp5gtO500a4F3Nkz9Ufpk2AcUM= github.com/gabriel-vasile/mimetype v1.4.13/go.mod h1:d+9Oxyo1wTzWdyVUPMmXFvp4F9tea18J8ufA774AB3s= github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE= github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI= github.com/gin-gonic/gin v1.10.1 h1:T0ujvqyCSqRopADpgPgiTT63DUQVSfojyME59Ei63pQ= github.com/gin-gonic/gin v1.10.1/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y= +github.com/go-acme/alidns-20150109/v5 v5.5.0 h1:/LUHZSQoaDqagi8wCq8f9Rx4AoVr/Jd4rKEV2IQYvxs= +github.com/go-acme/alidns-20150109/v5 v5.5.0/go.mod h1:J2B9WBwSFfZalzlCqSkeyBkqBcWPEZMDkxwhOjjF0MA= github.com/go-acme/lego/v5 v5.4.0 h1:y107z5o/Ru5qzv5ZnD7MZ1QyCbsZbfxREOxdMdx3FuY= github.com/go-acme/lego/v5 v5.4.0/go.mod h1:YGuvVqYJZvmy6t0COKHC/+z9zhF4IrJQ1iA8NLX5c9Y= +github.com/go-acme/tencentclouddnspod v1.3.24 h1:uCSiOW1EJttcnOON+MVVyVDJguFL/Q4NIGkq1CrT9p8= +github.com/go-acme/tencentclouddnspod v1.3.24/go.mod h1:RKcB2wSoZncjBA0OEFj59s1ko1XDy+ZsAtk+9uMxUF0= github.com/go-jose/go-jose/v4 v4.1.4 h1:moDMcTHmvE6Groj34emNPLs/qtYXRVcd6S7NHbHz3kA= github.com/go-jose/go-jose/v4 v4.1.4/go.mod h1:x4oUasVrzR7071A4TnHLGSPpNOm2a21K9Kf04k1rs08= +github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A= +github.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI= +github.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY= +github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag= +github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE= +github.com/go-playground/assert/v2 v2.0.1/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4= github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s= github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4= +github.com/go-playground/locales v0.13.0/go.mod h1:taPMhCMXrRLJO55olJkUXHZBHCxTMfnGwq/HNwmWNS8= github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA= github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY= +github.com/go-playground/universal-translator v0.17.0/go.mod h1:UkSxE5sNxxRwHyU+Scu5vgOQjsIJAF8j9muTVoKLVtA= github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY= github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY= +github.com/go-playground/validator/v10 v10.4.1/go.mod h1:nlOn6nFhuKACm19sB/8EGNn9GlaMV7XkbRSipzJ0Ii4= github.com/go-playground/validator/v10 v10.30.3 h1:4MU6YkEwx7GbcPJOZxrtbu+QfF3pJLJuaYTeAH0DYy8= github.com/go-playground/validator/v10 v10.30.3/go.mod h1:4Axh7oCNGcoGkqLoE4YWt6n20mcEIsPRlB7vPk3lpyc= github.com/go-sql-driver/mysql v1.9.3 h1:U/N249h2WzJ3Ukj8SowVFjdtZKfu9vlLZxjPXV1aweo= github.com/go-sql-driver/mysql v1.9.3/go.mod h1:qn46aNg1333BRMNU69Lq93t8du/dwxI64Gl8i5p1WMU= github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU= github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I= +github.com/goccy/go-yaml v1.9.8/go.mod h1:JubOolP3gh0HpiBc4BLRD4YmjEjHAmIIB2aaXKkTfoE= +github.com/goccy/go-yaml v1.19.2 h1:PmFC1S6h8ljIz6gMRBopkjP1TVT7xuwrButHID66PoM= +github.com/goccy/go-yaml v1.19.2/go.mod h1:XBurs7gK8ATbW4ZPGKgcbrY1Br56PdM69F7LkFRi1kA= +github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q= +github.com/golang/mock v1.1.1/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A= +github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= +github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= +github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw= +github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8= +github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA= +github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs= +github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w= +github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0= +github.com/golang/protobuf v1.4.2/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= +github.com/golang/snappy v0.0.1/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q= +github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M= +github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= +github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= +github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8= github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU= github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e h1:ijClszYn+mADRFY17kjQEVQ1XRhq2/JR1M3sGqeJoxs= github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e/go.mod h1:boTsfXsheKC2y+lKOCMpSfarhxDeIzfZG1jqGcPl3cA= +github.com/google/s2a-go v0.1.9 h1:LGD7gtMgezd8a/Xak7mEWL0PjoTQFvpRudN895yqKW0= +github.com/google/s2a-go v0.1.9/go.mod h1:YA0Ei2ZQL3acow2O62kdp9UlnvMmU7kA6Eutn0dXayM= github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/googleapis/enterprise-certificate-proxy v0.3.17 h1:73NfMHdiqo9JFU9+7a5ExpVa10/R29pXfZIaW559nrg= +github.com/googleapis/enterprise-certificate-proxy v0.3.17/go.mod h1:rSEsBUemEBZEexP2y6jPp16LUmUbjmSbcPMQizR0o4k= +github.com/googleapis/gax-go/v2 v2.22.0 h1:PjIWBpgGIVKGoCXuiCoP64altEJCj3/Ei+kSU5vlZD4= +github.com/googleapis/gax-go/v2 v2.22.0/go.mod h1:irWBbALSr0Sk3qlqb9SyJ1h68WjgeFuiOzI4Rqw5+aY= +github.com/gopherjs/gopherjs v0.0.0-20181017120253-0766667cb4d1/go.mod h1:wJfORRmW1u3UXTncJ5qlYoELFm8eSnnEO6hX4iZ3EWY= +github.com/gopherjs/gopherjs v0.0.0-20200217142428-fce0ec30dd00/go.mod h1:wJfORRmW1u3UXTncJ5qlYoELFm8eSnnEO6hX4iZ3EWY= +github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg= +github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= +github.com/huaweicloud/huaweicloud-sdk-go-v3 v0.1.205 h1:YnI2+56S5oxByz8BYChRrsmqTUmCp1Ww2KIzZtF4XOU= +github.com/huaweicloud/huaweicloud-sdk-go-v3 v0.1.205/go.mod h1:M+yna96Fx9o5GbIUnF3OvVvQGjgfVSyeJbV9Yb1z/wI= github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8= github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw= +github.com/json-iterator/go v1.1.10/go.mod h1:KdQUCv79m/52Kvf8AW2vK1V8akMuk1QjK/uOdHXbAo4= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= github.com/json-iterator/go v1.1.13-0.20220915233716-71ac16282d12 h1:9Nu54bhS/H/Kgo2/7xNSUuC5G28VR8ljfrLKU2G4IjU= github.com/json-iterator/go v1.1.13-0.20220915233716-71ac16282d12/go.mod h1:TBzl5BIHNXfS9+C35ZyJaklL7mLDbgUkcgXzSLa8Tk0= +github.com/jtolds/gls v4.20.0+incompatible/go.mod h1:QJZ7F/aHp+rZTRtaJ1ow/lLfFfVYBRgL+9YlvaHOwJU= +github.com/klauspost/compress v1.13.6/go.mod h1:/3/Vjq9QcHkK5uEr5lBEmyoZ1iFhe47etQ6QUkpK6sk= github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM= github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws= @@ -64,8 +203,11 @@ github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= +github.com/leodido/go-urn v1.2.0/go.mod h1:+8+nEpDfqqsY+g338gtMEUOtuK+4dEMhiQEgxpxOKII= github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ= github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI= +github.com/mattn/go-colorable v0.1.8/go.mod h1:u6P/XSegPjTcexA+o6vUJrdnUu04hMope9wVRipJSqc= +github.com/mattn/go-isatty v0.0.12/go.mod h1:cbi8OIDigv2wuxKPP5vlRcQ1OAZbq2CE4Kysco4FUpU= github.com/mattn/go-isatty v0.0.22 h1:j8l17JJ9i6VGPUFUYoTUKPSgKe/83EYU2zBC7YNKMw4= github.com/mattn/go-isatty v0.0.22/go.mod h1:ZXfXG4SQHsB/w3ZeOYbR0PrPwLy+n6xiMrJlRFqopa4= github.com/miekg/dns v1.1.72 h1:vhmr+TF2A3tuoGNkLDFK9zi36F2LS+hKTRW0Uf8kbzI= @@ -73,11 +215,15 @@ github.com/miekg/dns v1.1.72/go.mod h1:+EuEPhdHOsfk6Wk5TT2CzssZdqkmFhf8r+aVyDETo github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg= github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v0.0.0-20180701023420-4b7aa43c6742/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0= +github.com/modern-go/reflect2 v1.0.1/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0= github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= github.com/modern-go/reflect2 v1.0.3-0.20250322232337-35a7c28c31ee h1:W5t00kpgFdJifH4BDsTlE89Zl93FEloxaWZfGcifgq8= github.com/modern-go/reflect2 v1.0.3-0.20250322232337-35a7c28c31ee/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/montanaflynn/stats v0.0.0-20171201202039-1bf9dbcd8cbe/go.mod h1:wL8QJuTMNUDYhXwkmfOly8iTdp5TEcJFWZD2D7SIkUc= github.com/ncruces/go-strftime v0.1.9 h1:bY0MQC28UADQmHmaF5dgpLmImcShSi2kHU9XLdhx/f4= github.com/ncruces/go-strftime v0.1.9/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls= +github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e/go.mod h1:zD1mROLANZcx1PVRCS0qkT7pwLkGfwJo4zjcN/Tysno= github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM= github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs= github.com/pkg/diff v0.0.0-20210226163009-20ebb0f2a09e/go.mod h1:pJLUxLENpZxwdsKMEsNbx1VGcRFpLqf3715MtcvvzbA= @@ -86,64 +232,250 @@ github.com/pkg/sftp v1.13.11/go.mod h1:uNkH9roSXglNJqM+glJJi+TQXQUm0fXFWqCFmT8hs github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U= github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE= github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs= github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ= github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc= github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= +github.com/shopspring/decimal v1.4.0/go.mod h1:gawqmDU56v4yIKSwfBSFip1HdCCXN8/+DMd9qYNcwME= +github.com/smartystreets/assertions v0.0.0-20180927180507-b2de0cb4f26d/go.mod h1:OnSkiWE9lh6wB0YB77sQom3nweQdgAjqCqsofrRNTgc= +github.com/smartystreets/assertions v1.1.0/go.mod h1:tcbTF8ujkAEcZ8TElKY+i30BzYlVhC/LOxJk7iOWnoo= +github.com/smartystreets/goconvey v1.6.4/go.mod h1:syvi0/a8iFYH4r/RixwvyeAJjdLS9QV7WQ/tjFTllLA= github.com/spf13/cobra v1.10.1 h1:lJeBwCfmrnXthfAupyUTzJ/J4Nc1RsHC/mSRU2dll/s= github.com/spf13/cobra v1.10.1/go.mod h1:7SmJGaTHFVBY0jW4NXGluQoLvhqFQM+6XSKD+P4XaB0= github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg= github.com/spf13/pflag v1.0.10 h1:4EBh2KAYBwaONj6b2Ye1GiHfwjqyROoF4RwYO+vPwFk= github.com/spf13/pflag v1.0.10/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg= github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/objx v0.2.0/go.mod h1:qt09Ya8vawLte6SNmTgCsAVtYtaKzEcn8ATUoHMkEqE= github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA= github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4= +github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA= github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= +github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U= github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.3.24/go.mod h1:r5r4xbfxSaeR04b166HGsBa/R4U3SueirEUpXGuw+Q0= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.3.133 h1:EKJsaGHbifEKqWCdJ4tJNLxbJ5h/Pm3CaLKzcCS/pkw= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.3.133/go.mod h1:r5r4xbfxSaeR04b166HGsBa/R4U3SueirEUpXGuw+Q0= +github.com/tjfoc/gmsm v1.3.2/go.mod h1:HaUcFuY0auTiaHB9MHFGCPx5IaLhTUd2atbCFBQXn9w= +github.com/tjfoc/gmsm v1.4.1 h1:aMe1GlZb+0bLjn+cKTPEvvn9oUEBlJitaZiiBwsbgho= +github.com/tjfoc/gmsm v1.4.1/go.mod h1:j4INPkHWMrhJb38G+J6W4Tw0AbuN8Thu3PbdVYhVcTE= github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI= github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08= github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE= github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg= +github.com/xdg-go/pbkdf2 v1.0.0/go.mod h1:jrpuAogTd400dnrH08LKmI/xc1MbPOebTwRqcT5RDeI= +github.com/xdg-go/scram v1.1.2/go.mod h1:RT/sEzTbU5y00aCK8UOx6R7YryM0iF1N2MOmC3kKLN4= +github.com/xdg-go/stringprep v1.0.4/go.mod h1:mPGuuIYwz7CmR2bT9j4GbQqutWS1zV24gijq1dTyGkM= +github.com/youmark/pkcs8 v0.0.0-20181117223130-1be2e3e5546d/go.mod h1:rHwXgn7JulP+udvsHwJoVG1YGAP6VLg4y9I5dyZdqmA= +github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= +github.com/yuin/goldmark v1.1.30/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= +github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= +go.mongodb.org/mongo-driver v1.13.1/go.mod h1:wcDf1JBCXy2mOW0bWHwO/IOYqdca1MPCwDtFu/Z9+eo= +go.mongodb.org/mongo-driver v1.17.9 h1:IexDdCuuNJ3BHrELgBlyaH9p60JXAvdzWR128q+U5tU= +go.mongodb.org/mongo-driver v1.17.9/go.mod h1:LlOhpH5NUEfhxcAwG0UEkMqwYcc4JU18gtCdGudk/tQ= +go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64= +go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y= +go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0 h1:OyrsyzuttWTSur2qN/Lm0m2a8yqyIjUVBZcxFPuXq2o= +go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0/go.mod h1:C2NGBr+kAB4bk3xtMXfZ94gqFDtg/GkI7e9zqGh5Beg= +go.opentelemetry.io/otel v1.43.0 h1:mYIM03dnh5zfN7HautFE4ieIig9amkNANT+xcVxAj9I= +go.opentelemetry.io/otel v1.43.0/go.mod h1:JuG+u74mvjvcm8vj8pI5XiHy1zDeoCS2LB1spIq7Ay0= +go.opentelemetry.io/otel/metric v1.43.0 h1:d7638QeInOnuwOONPp4JAOGfbCEpYb+K6DVWvdxGzgM= +go.opentelemetry.io/otel/metric v1.43.0/go.mod h1:RDnPtIxvqlgO8GRW18W6Z/4P462ldprJtfxHxyKd2PY= +go.opentelemetry.io/otel/trace v1.43.0 h1:BkNrHpup+4k4w+ZZ86CZoHHEkohws8AY+WTX09nk+3A= +go.opentelemetry.io/otel/trace v1.43.0/go.mod h1:/QJhyVBUUswCphDVxq+8mld+AvhXZLhe+8WVFxiFff0= golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8= golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc= golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20191219195013-becbf705a915/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20200510223506-06a226fb4e37/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20201012173705-84dcc777aaee/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= +golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4= +golang.org/x/crypto v0.13.0/go.mod h1:y6Z2r+Rw4iayiXXAIxJIDAJ1zMW4yaTpebo8fPOliYc= +golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= +golang.org/x/crypto v0.18.0/go.mod h1:R0j02AL6hcrfOiy9T4ZYp/rcWeMxM3L6QYxlOuEG1mg= +golang.org/x/crypto v0.19.0/go.mod h1:Iy9bg/ha4yyC70EfRS8jz+B6ybOBKMaSxLj6P6oBDfU= +golang.org/x/crypto v0.21.0/go.mod h1:0BP7YvVV9gBbVKyeTG0Gyn+gZm94bibOW5BjDEYAOMs= +golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8= +golang.org/x/crypto v0.24.0/go.mod h1:Z1PMYSOR5nyMcyAVAIQSKCDwalqy85Aqn1x3Ws4L5DM= golang.org/x/crypto v0.54.0 h1:YLIA59K4fiNzHzjnZt2tUJQjQtUWfWbeHBqKtk3eScw= golang.org/x/crypto v0.54.0/go.mod h1:KWL8ny2AZdGR2cWmzeHrp2azQPGogOv+HeQaVEXC2dk= +golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= golang.org/x/exp v0.0.0-20260410095643-746e56fc9e2f h1:W3F4c+6OLc6H2lb//N1q4WpJkhzJCK5J6kUi1NTVXfM= golang.org/x/exp v0.0.0-20260410095643-746e56fc9e2f/go.mod h1:J1xhfL/vlindoeF/aINzNzt2Bket5bjo9sdOYzOsU80= +golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= +golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU= +golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= +golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= +golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= +golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= +golang.org/x/mod v0.12.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= +golang.org/x/mod v0.15.0/go.mod h1:hTbmBsO62+eylJbnUtE2MGJUyE7QWk4xUqPFrRgJ+7c= +golang.org/x/mod v0.17.0/go.mod h1:hTbmBsO62+eylJbnUtE2MGJUyE7QWk4xUqPFrRgJ+7c= golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ= golang.org/x/mod v0.37.0/go.mod h1:m8S8VeM9r4dzDwjrKO0a1sZP3YjeMamRRlD+fmR2Q/0= +golang.org/x/net v0.0.0-20180724234803-3673e40ba225/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20180826012351-8a410e7b638d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/net v0.0.0-20200506145744-7e3656a0809f/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= +golang.org/x/net v0.0.0-20201010224723-4f7140c49acb/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= +golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg= +golang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y= +golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c= +golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= +golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= +golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= +golang.org/x/net v0.15.0/go.mod h1:idbUs1IY1+zTqbi8yxTbhexhEEk5ur9LInksu6HrEpk= +golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= +golang.org/x/net v0.20.0/go.mod h1:z8BVo6PvndSri0LbOE3hAn0apkU+1YvI6E70E9jsnvY= +golang.org/x/net v0.21.0/go.mod h1:bIjVDfnllIU7BJ2DNgfnXvpSvtn8VRwhlsaeUTyUS44= +golang.org/x/net v0.23.0/go.mod h1:JKghWKKOSdJwpW2GEx0Ja7fmaKnMsbu+MWVZTokSYmg= +golang.org/x/net v0.25.0/go.mod h1:JkAGAh7GEvH74S6FOH42FLoXpXbE/aqXSrIQjXgsiwM= +golang.org/x/net v0.26.0/go.mod h1:5YKkiSynbBIh3p6iOc/vibscux0x38BZDkn8sCUPxHE= golang.org/x/net v0.57.0 h1:K5+3DljvIuDG9/Jv9rvyMywYNFCQ9RSUY6OOTTkT+tE= golang.org/x/net v0.57.0/go.mod h1:KpXc8iv+r3XplLAG/f7Jsf9RPszJzdR0f58q9vGOuEU= +golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= +golang.org/x/oauth2 v0.36.0 h1:peZ/1z27fi9hUOFCAZaHyrpWG5lwe0RJEEEeH0ThlIs= +golang.org/x/oauth2 v0.36.0/go.mod h1:YDBUJMTkDnJS+A4BP4eZBjCqtokkg1hODuPjwiGPO7Q= +golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20200317015054-43a5402ce75a/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.3.0/go.mod h1:FU7BRWz2tNW+3quACPkgCx/L+uEAv1htQ0V83Z9Rj+Y= +golang.org/x/sync v0.6.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk= +golang.org/x/sync v0.7.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk= golang.org/x/sync v0.22.0 h1:SZjpbeLmrCk4xhRSZFNZW5gFUeCeFgjekvI/+gfScek= golang.org/x/sync v0.22.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0= +golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200116001909-b77594299b42/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200223170610-d5e6a3e2c0ae/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200509044756-6aff5f38e54f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220406163625-3f8b81556e12/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.16.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.17.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.18.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.21.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs= golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw= +golang.org/x/telemetry v0.0.0-20240228155512-f48c80bd79b2/go.mod h1:TeRTkGYfJXctD9OcfyVLyj2J3IxLnKwHJR8f4D8a3YE= +golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= +golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= +golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= +golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= +golang.org/x/term v0.12.0/go.mod h1:owVbMEjm3cBLCHdkQu9b1opXd4ETQWc3BhuQGKgXgvU= +golang.org/x/term v0.13.0/go.mod h1:LTmsnFJwVN6bCy1rVCoS+qHT1HhALEFxKncY3WNNh4U= +golang.org/x/term v0.16.0/go.mod h1:yn7UURbUtPyrVJPGPq404EukNFxcm/foM+bV/bfcDsY= +golang.org/x/term v0.17.0/go.mod h1:lLRBjIVuehSbZlaOtGMbcMncT+aqLLLmKrsjNrUguwk= +golang.org/x/term v0.18.0/go.mod h1:ILwASektA3OnRv7amZ1xhE/KTR+u50pbXfZ03+6Nx58= +golang.org/x/term v0.20.0/go.mod h1:8UkIAJTvZgivsXaD6/pH6U9ecQzZ45awqEOzuCvwpFY= +golang.org/x/term v0.21.0/go.mod h1:ooXLefLobQVslOqselCNF4SxFAaoS6KujMbsGzSDmX0= golang.org/x/term v0.45.0 h1:NwWyBmoJCbfTHpxrWoZ9C6/VxOf7ic219I8xZZFdrf0= golang.org/x/term v0.45.0/go.mod h1:9aqxs0blBcrm/n0L9QW0aRVD+ktan8ssZromtqJC43w= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk= +golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= +golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= +golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ= +golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ= +golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= +golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= +golang.org/x/text v0.13.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= +golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= +golang.org/x/text v0.15.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= +golang.org/x/text v0.16.0/go.mod h1:GhwF1Be+LQoKShO3cGOHzqOgRrGaYc9AvblQOmPVHnI= golang.org/x/text v0.40.0 h1:Ub2Z6/xjgF1WrYQz2nuITOEegKFtiIy+rieRJ5lHZKs= golang.org/x/text v0.40.0/go.mod h1:hpnzDAfGV753zIKo+wk3u1bVKCGPbrnF7+7LBF/UHVY= +golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20190226205152-f727befe758c/go.mod h1:9Yl7xja0Znq3iFh3HoIrodX9oNMXvdceNzlUR8zjMvY= +golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= +golang.org/x/tools v0.0.0-20190328211700-ab21143f2384/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= +golang.org/x/tools v0.0.0-20190524140312-2c0ae7006135/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= +golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20200509030707-2212a7e161a5/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= +golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc= +golang.org/x/tools v0.6.0/go.mod h1:Xwgl3UAJ/d3gWutnCtw505GrjyAbvKui8lOU390QaIU= +golang.org/x/tools v0.13.0/go.mod h1:HvlwmtVNQAhOuCjW7xxvovg8wbNq7LwfXh/k7wXUl58= +golang.org/x/tools v0.21.1-0.20240508182429-e35e4ccd0d2d/go.mod h1:aiJjzUbINMkxbQROHiO6hDPo2LHcIPhhQsa9DLh0yGk= golang.org/x/tools v0.47.0 h1:7Kn5x/d1svx/PzryTsqeoZN4TZwqeH5pGWjefhLi/1Q= golang.org/x/tools v0.47.0/go.mod h1:dFHnyTvFWY212G+h7ZY4Vsp/K3U4/7W9TyVaAul8uCA= +golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +google.golang.org/api v0.288.0 h1:glhO/J88obKP5I269W3hB73dvBKrjU56ZfmNlNXpgTU= +google.golang.org/api v0.288.0/go.mod h1:lM2kYRzYUCBY91P9h6VF1PYmvhxii3O5hji37qRvIcY= +google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM= +google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= +google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= +google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc= +google.golang.org/genproto/googleapis/rpc v0.0.0-20260630182238-925bb5da69e7 h1:eM/YSd5bBFagF51o1E745Ta7RwzpW0h+z+QDNZOgmQ8= +google.golang.org/genproto/googleapis/rpc v0.0.0-20260630182238-925bb5da69e7/go.mod h1:4Hqkh8ycfw05ld/3BWL7rJOSfebL2Q+DVDeRgYgxUU8= +google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= +google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg= +google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY= +google.golang.org/grpc v1.31.0/go.mod h1:N36X2cJ7JwdamYAgDz+s+rVMFjt3numwzf/HckM8pak= +google.golang.org/grpc v1.82.0 h1:vguDnZUPjE26w09A63VoxZPnvPjB5Riyc0mkXPFmAIU= +google.golang.org/grpc v1.82.0/go.mod h1:yzTZ1TB1Z3SG+LIYaI+WiE8D5+PZ3ArnrSp8zF3+/ZA= +google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8= +google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0= +google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM= +google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE= +google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo= +google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE= google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= +gopkg.in/ini.v1 v1.56.0/go.mod h1:pNLf8WUiyNEtQjuu5G5vTm06TEv9tsIgeAvK8hOrP4k= +gopkg.in/ini.v1 v1.67.0/go.mod h1:pNLf8WUiyNEtQjuu5G5vTm06TEv9tsIgeAvK8hOrP4k= +gopkg.in/ini.v1 v1.67.3 h1:iM9Lhz5MRSGhHVGGwCuzG9KO8PoirCXj/m/qTmOJJQw= +gopkg.in/ini.v1 v1.67.3/go.mod h1:x/cyOwCgZqOkJoDIJ3c1KNHMo10+nLGAhh+kn3Zizss= +gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v2 v2.2.8/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= +honnef.co/go/tools v0.0.0-20190523083050-ea95bdfd59fc/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= modernc.org/cc/v4 v4.25.2 h1:T2oH7sZdGvTaie0BRNFbIYsabzCxUQg8nLqCdQ2i0ic= modernc.org/cc/v4 v4.25.2/go.mod h1:uVtb5OGqUKpoLWhqwNQo/8LwvoiEBLvZXIQ/SmO6mL0= modernc.org/ccgo/v4 v4.25.1 h1:TFSzPrAGmDsdnhT9X2UrcPMI3N/mJ9/X9ykKXwLhDsU= diff --git a/backend/internal/app/app.go b/backend/internal/app/app.go index 498562b..b68f872 100644 --- a/backend/internal/app/app.go +++ b/backend/internal/app/app.go @@ -16,6 +16,7 @@ import ( "git.pcux.cn/xuans/Scert/backend/internal/firewall" "git.pcux.cn/xuans/Scert/backend/internal/httpapi" "git.pcux.cn/xuans/Scert/backend/internal/logging" + "git.pcux.cn/xuans/Scert/backend/internal/notification" "git.pcux.cn/xuans/Scert/backend/internal/repository" "git.pcux.cn/xuans/Scert/backend/internal/secretstore" "git.pcux.cn/xuans/Scert/backend/internal/setup" @@ -28,6 +29,7 @@ type App struct { Database *database.Database Repository *repository.SQLDomainRepository Servers *repository.SQLServerRepository + Tasks *repository.SQLTaskRepository Deployment *deployment.Service SecretStore *secretstore.Store SSHKeys *sshkey.Service @@ -75,23 +77,53 @@ func NewWithConfigPath(ctx context.Context, cfg config.Config, configPath string dnsVerification := setup.NewDNSVerificationManager(dnsTester, secretStore) repo := repository.NewSQLDomainRepository(db.DB) serverRepo := repository.NewSQLServerRepository(db.DB) + taskRepo := repository.NewSQLTaskRepository(db.DB) auditRepo := repository.NewSQLAuditRepository(db.DB) sshKeys := sshkey.NewService(secretStore) accounts := certificate.NewAccountRepository(secretStore) certificates := certificate.NewService(cfg, repo, secretStore, dnsprovider.NewLegoFactory(), accounts) deploymentService := deployment.NewService(deployment.SSHFactory{Secrets: secretStore}) - workflow := &CertificateWorkflow{Certificates: certificates, Domains: repo, Servers: serverRepo, Deployment: deploymentService} + notifier := notification.New(cfg.Notification, secretStore) + remoteValidator := certificate.RemoteValidator{} + workflow := &CertificateWorkflow{ + Certificates: certificates, + Domains: repo, + Servers: serverRepo, + Deployment: deploymentService, + RemoteVerifier: func(ctx context.Context, endpoint string, expectedDomains []string) (certificate.ValidationResult, error) { + return remoteValidator.ValidateHTTPS(ctx, endpoint, expectedDomains) + }, + Notifier: notifier, + NotifyError: func(err error) { logger.Error("发送邮件通知失败", "error", err) }, + CurrentCertificate: certificates.Current, + } renewal := certificate.NewRenewalScheduler(repo, workflow, cfg.ACME.RenewalThresholdDays) server := httpapi.New(httpapi.Dependencies{ Config: cfg, ConfigPath: configPath, Logger: logger, Repository: repo, Servers: serverRepo, SSHKeys: sshKeys, SetupDNS: dnsVerification, Firewall: firewall.NewManager(), IssueCertificate: workflow.IssueForHTTP, - ResetStatePath: admin.StatePath(cfg.Paths.Data), - Audit: auditRepo, + IssueSetupCertificate: func(ctx context.Context, request certificate.SetupCertificateRequest) (certificate.SavedResource, error) { + return certificates.IssueForSetup(ctx, request) + }, + RollbackSetupCertificate: func(ctx context.Context, saved certificate.SavedResource) error { + return certificate.RollbackSavedResource(ctx, saved) + }, + ImportCertificate: func(ctx context.Context, request certificate.ImportRequest) (certificate.IssueResult, deployment.Report, error) { + result, err := workflow.Import(ctx, request) + return result.Certificate, result.Deployment, err + }, + DeployCertificate: func(ctx context.Context, domainID string) (certificate.IssueResult, deployment.Report, error) { + result, err := workflow.DeployCurrent(ctx, domainID) + return result.Certificate, result.Deployment, err + }, + CurrentCertificate: certificates, + ResetStatePath: admin.StatePath(cfg.Paths.Data), + Audit: auditRepo, + Tasks: taskRepo, }) return &App{ Config: cfg, Logger: logger, Database: db, Repository: repo, - Servers: serverRepo, Deployment: deploymentService, + Tasks: taskRepo, SecretStore: secretStore, SSHKeys: sshKeys, DNSVerification: dnsVerification, HTTP: server, Certificates: certificates, Workflow: workflow, diff --git a/backend/internal/app/certificate_workflow.go b/backend/internal/app/certificate_workflow.go index 6a8cc22..215c494 100644 --- a/backend/internal/app/certificate_workflow.go +++ b/backend/internal/app/certificate_workflow.go @@ -4,18 +4,24 @@ import ( "context" "errors" "fmt" + "strings" "time" "git.pcux.cn/xuans/Scert/backend/internal/certificate" "git.pcux.cn/xuans/Scert/backend/internal/deployment" "git.pcux.cn/xuans/Scert/backend/internal/domain" + "git.pcux.cn/xuans/Scert/backend/internal/notification" ) type CertificateWorkflow struct { - Certificates certificateService - Domains domainDeploymentRepository - Servers serverLister - Deployment savedDeployer + Certificates certificateService + Domains domainDeploymentRepository + Servers serverLister + Deployment savedDeployer + Notifier notification.Notifier + NotifyError func(error) + RemoteVerifier func(context.Context, string, []string) (certificate.ValidationResult, error) + CurrentCertificate func(context.Context, string) (certificate.IssueResult, error) } type certificateService interface { @@ -50,14 +56,25 @@ func (w *CertificateWorkflow) IssueWithReport(ctx context.Context, domainID stri if w == nil || w.Certificates == nil || w.Domains == nil || w.Servers == nil || w.Deployment == nil { return CertificateWorkflowResult{}, errors.New("证书部署流程未初始化") } + domainItem, _ := w.Domains.GetByID(ctx, domainID) certificateResult, err := w.Certificates.Issue(ctx, domainID) if err != nil { + w.notify(ctx, notification.Event{Type: "certificate_renewal", Status: "failed", DomainID: domainID, Domain: domainItem.Name, Error: err.Error()}) return CertificateWorkflowResult{}, err } report, err := w.deploy(ctx, certificateResult) if err != nil { w.markDeploymentError(certificateResult) } + status := "success" + if err != nil { + status = "error" + } + w.notify(ctx, notification.Event{ + Type: "certificate_renewal", Status: status, DomainID: certificateResult.DomainID, + Domain: domainItem.Name, Domains: certificateResult.Domains, ExpiresAt: &certificateResult.Saved.NotAfter, + Deployment: report, Error: errorText(err), + }) return CertificateWorkflowResult{Certificate: certificateResult, Deployment: report}, err } @@ -66,21 +83,71 @@ func (w *CertificateWorkflow) IssueForHTTP(ctx context.Context, domainID string) return result.Certificate, result.Deployment, err } +// DeployCurrent validates and deploys the active certificate without issuing a new one. +func (w *CertificateWorkflow) DeployCurrent(ctx context.Context, domainID string) (CertificateWorkflowResult, error) { + if w == nil || w.CurrentCertificate == nil || w.Domains == nil || w.Servers == nil || w.Deployment == nil { + return CertificateWorkflowResult{}, errors.New("当前证书部署流程未初始化") + } + result, err := w.CurrentCertificate(ctx, domainID) + if err != nil { + return CertificateWorkflowResult{}, err + } + report, err := w.deploy(ctx, result) + if err != nil { + w.markDeploymentError(result) + } + status := "success" + if err != nil { + status = "error" + } + w.notify(ctx, notification.Event{ + Type: "certificate_deploy", Status: status, DomainID: result.DomainID, + Domains: result.Domains, ExpiresAt: &result.Saved.NotAfter, Deployment: report, Error: errorText(err), + }) + return CertificateWorkflowResult{Certificate: result, Deployment: report}, err +} func (w *CertificateWorkflow) Import(ctx context.Context, request certificate.ImportRequest) (CertificateWorkflowResult, error) { if w == nil || w.Certificates == nil || w.Domains == nil || w.Servers == nil || w.Deployment == nil { return CertificateWorkflowResult{}, errors.New("证书部署流程未初始化") } + domainItem, _ := w.Domains.GetByID(ctx, request.DomainID) certificateResult, err := w.Certificates.Import(ctx, request) if err != nil { + w.notify(ctx, notification.Event{Type: "certificate_import", Status: "failed", DomainID: request.DomainID, Domain: domainItem.Name, Error: err.Error()}) return CertificateWorkflowResult{}, err } report, err := w.deploy(ctx, certificateResult) if err != nil { w.markDeploymentError(certificateResult) } + status := "success" + if err != nil { + status = "error" + } + w.notify(ctx, notification.Event{ + Type: "certificate_import", Status: status, DomainID: certificateResult.DomainID, + Domain: domainItem.Name, Domains: certificateResult.Domains, ExpiresAt: &certificateResult.Saved.NotAfter, + Deployment: report, Error: errorText(err), + }) return CertificateWorkflowResult{Certificate: certificateResult, Deployment: report}, err } +func (w *CertificateWorkflow) notify(ctx context.Context, event notification.Event) { + if w == nil || w.Notifier == nil { + return + } + if err := w.Notifier.Send(ctx, event); err != nil && w.NotifyError != nil { + w.NotifyError(err) + } +} + +func errorText(err error) string { + if err == nil { + return "" + } + return err.Error() +} + func (w *CertificateWorkflow) deploy(ctx context.Context, result certificate.IssueResult) (deployment.Report, error) { domainItem, err := w.Domains.GetByID(ctx, result.DomainID) if err != nil { @@ -109,9 +176,28 @@ func (w *CertificateWorkflow) deploy(ctx context.Context, result certificate.Iss if report.Status != "success" { return report, fmt.Errorf("证书部署未全部成功:成功 %d 台,失败 %d 台", report.Success, report.Failed) } + if w.RemoteVerifier != nil { + verificationDomain := verificationName(domainItem, result.Domains) + if verificationDomain == "" { + return report, errors.New("无法确定部署后的 HTTPS 校验域名") + } + if _, err := w.RemoteVerifier(ctx, "https://"+verificationDomain, result.Domains); err != nil { + return report, fmt.Errorf("部署后 HTTPS 校验失败:%w", err) + } + } return report, nil } +func verificationName(item domain.Domain, issuedDomains []string) string { + for _, value := range issuedDomains { + value = strings.TrimSpace(value) + if value != "" && !strings.HasPrefix(value, "*.") { + return value + } + } + return strings.TrimPrefix(strings.TrimSpace(item.Name), "*.") +} + func (w *CertificateWorkflow) markDeploymentError(result certificate.IssueResult) { if w == nil || w.Domains == nil { return diff --git a/backend/internal/certificate/lifecycle.go b/backend/internal/certificate/lifecycle.go index 06182b0..445255f 100644 --- a/backend/internal/certificate/lifecycle.go +++ b/backend/internal/certificate/lifecycle.go @@ -3,6 +3,7 @@ package certificate import ( "bytes" "context" + "crypto/sha256" "crypto/tls" "crypto/x509" "encoding/json" @@ -38,14 +39,20 @@ type Resource struct { } type SavedResource struct { - Domain string `json:"domain"` - Directory string `json:"directory"` - CertificatePath string `json:"certificate_path"` - FullChainPath string `json:"fullchain_path"` - PrivateKeyPath string `json:"private_key_path"` - NotBefore time.Time `json:"not_before"` - NotAfter time.Time `json:"not_after"` - BackupDirectory string `json:"backup_directory,omitempty"` + Domain string `json:"domain"` + CertificateType string `json:"certificate_type,omitempty"` + Version string `json:"version,omitempty"` + SANs []string `json:"sans,omitempty"` + SerialNumber string `json:"serial_number,omitempty"` + FingerprintSHA256 string `json:"fingerprint_sha256,omitempty"` + ChainLength int `json:"chain_length,omitempty"` + Directory string `json:"directory"` + CertificatePath string `json:"certificate_path"` + FullChainPath string `json:"fullchain_path"` + PrivateKeyPath string `json:"private_key_path"` + NotBefore time.Time `json:"not_before"` + NotAfter time.Time `json:"not_after"` + BackupDirectory string `json:"backup_directory,omitempty"` } type FileStore struct { @@ -148,6 +155,15 @@ func ValidateResourceForDomains(resource Resource, expected []string) (Resource, } func (s FileStore) Save(ctx context.Context, domain string, resource Resource) (SavedResource, error) { + return s.save(ctx, domain, "", resource) +} + +// SaveForType 按证书类型保存当前证书和历史版本。 +func (s FileStore) SaveForType(ctx context.Context, domain, certificateType string, resource Resource) (SavedResource, error) { + return s.save(ctx, domain, certificateType, resource) +} + +func (s FileStore) save(ctx context.Context, domain, certificateType string, resource Resource) (SavedResource, error) { if err := ctx.Err(); err != nil { return SavedResource{}, err } @@ -166,46 +182,114 @@ func (s FileStore) Save(ctx context.Context, domain string, resource Resource) ( if root == "." || root == "" { return SavedResource{}, errors.New("证书存储根目录不能为空") } - directory := filepath.Join(root, directoryName(primary)) - if err := os.MkdirAll(directory, 0o700); err != nil { + baseDirectory := filepath.Join(root, directoryName(primary)) + directory := baseDirectory + if certificateType != "" { + certificateType = strings.ToLower(strings.TrimSpace(certificateType)) + if certificateType != "single" && certificateType != "wildcard" && certificateType != "san" { + return SavedResource{}, fmt.Errorf("证书类型无效:%s", certificateType) + } + directory = filepath.Join(baseDirectory, certificateType) + } + currentDirectory := directory + if certificateType != "" { + currentDirectory = filepath.Join(directory, "current") + } + if err := os.MkdirAll(currentDirectory, 0o700); err != nil { return SavedResource{}, fmt.Errorf("创建证书目录失败:%w", err) } - backupDirectory, err := s.backupExisting(directory, primary) + backupDirectory, err := s.backupExisting(currentDirectory, primary) if err != nil { return SavedResource{}, err } - certificatePath := filepath.Join(directory, "cert.pem") - fullChainPath := filepath.Join(directory, "fullchain.pem") - privateKeyPath := filepath.Join(directory, "key.pem") fullChain := resource.Certificate if len(resource.IssuerCertificate) > 0 && !bytes.Contains(resource.Certificate, resource.IssuerCertificate) { fullChain = append(append([]byte(nil), resource.Certificate...), resource.IssuerCertificate...) } - if err := atomicWrite(certificatePath, resource.Certificate, 0o644); err != nil { - return SavedResource{}, fmt.Errorf("保存证书失败:%w", err) + version := "" + if certificateType != "" { + now := time.Now + if s.Now != nil { + now = s.Now + } + version = now().UTC().Format("20060102-150405.000000000") + versionDirectory := filepath.Join(directory, "versions", version) + for suffix := 1; ; suffix++ { + if _, statErr := os.Stat(versionDirectory); errors.Is(statErr, os.ErrNotExist) { + break + } else if statErr != nil { + return SavedResource{}, fmt.Errorf("读取证书版本目录失败:%w", statErr) + } + version = fmt.Sprintf("%s-%02d", now().UTC().Format("20060102-150405.000000000"), suffix) + versionDirectory = filepath.Join(directory, "versions", version) + } + if err := os.MkdirAll(versionDirectory, 0o700); err != nil { + return SavedResource{}, fmt.Errorf("创建证书版本目录失败:%w", err) + } + if err := writeCertificateFiles(versionDirectory, resource.Certificate, fullChain, resource.PrivateKey); err != nil { + return SavedResource{}, err + } } - if err := atomicWrite(fullChainPath, fullChain, 0o644); err != nil { - return SavedResource{}, fmt.Errorf("保存完整证书链失败:%w", err) - } - if err := atomicWrite(privateKeyPath, resource.PrivateKey, 0o600); err != nil { - return SavedResource{}, fmt.Errorf("保存私钥失败:%w", err) + if err := writeCertificateFiles(currentDirectory, resource.Certificate, fullChain, resource.PrivateKey); err != nil { + return SavedResource{}, err } + leaf, _ := parseLeafCertificate(resource.Certificate) result := SavedResource{ - Domain: primary, Directory: directory, CertificatePath: certificatePath, - FullChainPath: fullChainPath, PrivateKeyPath: privateKeyPath, - NotBefore: resource.NotBefore, NotAfter: resource.NotAfter, - BackupDirectory: backupDirectory, + Domain: primary, CertificateType: certificateType, Version: version, SANs: append([]string(nil), resource.Domains...), + Directory: currentDirectory, CertificatePath: filepath.Join(currentDirectory, "cert.pem"), + FullChainPath: filepath.Join(currentDirectory, "fullchain.pem"), PrivateKeyPath: filepath.Join(currentDirectory, "key.pem"), + NotBefore: resource.NotBefore, NotAfter: resource.NotAfter, BackupDirectory: backupDirectory, + ChainLength: certificateChainLength(fullChain), + } + if leaf != nil { + result.SerialNumber = leaf.SerialNumber.Text(16) + result.FingerprintSHA256 = fmt.Sprintf("%X", sha256.Sum256(leaf.Raw)) } metadata, err := json.MarshalIndent(result, "", " ") if err != nil { return SavedResource{}, fmt.Errorf("生成证书元数据失败:%w", err) } - if err := atomicWrite(filepath.Join(directory, "metadata.json"), metadata, 0o600); err != nil { - return SavedResource{}, fmt.Errorf("保存证书元数据失败:%w", err) + if err := atomicWrite(filepath.Join(currentDirectory, "metadata.json"), metadata, 0o600); err != nil { + return SavedResource{}, fmt.Errorf("写入证书元数据失败:%w", err) + } + if certificateType != "" { + versionMetadata := filepath.Join(directory, "versions", version, "metadata.json") + if err := atomicWrite(versionMetadata, metadata, 0o600); err != nil { + return SavedResource{}, fmt.Errorf("写入历史证书元数据失败:%w", err) + } } return result, nil } +func writeCertificateFiles(directory string, certificate, fullChain, privateKey []byte) error { + if err := atomicWrite(filepath.Join(directory, "cert.pem"), certificate, 0o644); err != nil { + return fmt.Errorf("写入证书文件失败:%w", err) + } + if err := atomicWrite(filepath.Join(directory, "fullchain.pem"), fullChain, 0o644); err != nil { + return fmt.Errorf("写入完整证书链失败:%w", err) + } + if err := atomicWrite(filepath.Join(directory, "key.pem"), privateKey, 0o600); err != nil { + return fmt.Errorf("写入私钥文件失败:%w", err) + } + return nil +} + +func certificateChainLength(data []byte) int { + count := 0 + remaining := data + for len(remaining) > 0 { + block, rest := pem.Decode(remaining) + if block == nil { + break + } + remaining = rest + if block.Type == "CERTIFICATE" { + count++ + } + } + return count +} + func (s FileStore) backupExisting(directory, domain string) (string, error) { entries, err := os.ReadDir(directory) if err != nil { @@ -328,3 +412,168 @@ func validDomain(value string) bool { } return true } + +// CurrentDirectory returns the active certificate directory for a domain and certificate type. +func (s FileStore) CurrentDirectory(domain, certificateType string) (string, error) { + primary := strings.TrimSpace(domain) + if _, err := NormalizeDomains([]string{primary}); err != nil { + return "", err + } + certificateType = strings.ToLower(strings.TrimSpace(certificateType)) + if certificateType != "single" && certificateType != "wildcard" && certificateType != "san" { + return "", fmt.Errorf("证书类型无效:%s", certificateType) + } + root := filepath.Clean(strings.TrimSpace(s.Root)) + if root == "." || root == "" { + return "", errors.New("证书存储根目录不能为空") + } + return filepath.Join(root, directoryName(primary), certificateType, "current"), nil +} + +// LoadCurrent reads the active certificate files and metadata. +func (s FileStore) LoadCurrent(ctx context.Context, domain, certificateType string) (SavedResource, Resource, error) { + if err := ctx.Err(); err != nil { + return SavedResource{}, Resource{}, err + } + directory, err := s.CurrentDirectory(domain, certificateType) + if err != nil { + return SavedResource{}, Resource{}, err + } + certificateData, err := os.ReadFile(filepath.Join(directory, "cert.pem")) + if err != nil { + return SavedResource{}, Resource{}, fmt.Errorf("读取证书文件失败:%w", err) + } + fullChainData, err := os.ReadFile(filepath.Join(directory, "fullchain.pem")) + if err != nil { + return SavedResource{}, Resource{}, fmt.Errorf("读取完整证书链失败:%w", err) + } + privateKeyData, err := os.ReadFile(filepath.Join(directory, "key.pem")) + if err != nil { + return SavedResource{}, Resource{}, fmt.Errorf("读取私钥文件失败:%w", err) + } + resource, err := ValidateResourceForDomains(Resource{ + Domains: []string{domain}, + Certificate: certificateData, + IssuerCertificate: fullChainData, + PrivateKey: privateKeyData, + }, []string{domain}) + if err != nil { + return SavedResource{}, Resource{}, err + } + resource.IssuerCertificate = nil + var saved SavedResource + metadata, metadataErr := os.ReadFile(filepath.Join(directory, "metadata.json")) + if metadataErr == nil { + if err := json.Unmarshal(metadata, &saved); err != nil { + return SavedResource{}, Resource{}, fmt.Errorf("解析证书元数据失败:%w", err) + } + } + if saved.Domain == "" { + saved = SavedResource{ + Domain: domain, + CertificateType: certificateType, + Directory: directory, + CertificatePath: filepath.Join(directory, "cert.pem"), + FullChainPath: filepath.Join(directory, "fullchain.pem"), + PrivateKeyPath: filepath.Join(directory, "key.pem"), + NotBefore: resource.NotBefore, + NotAfter: resource.NotAfter, + SANs: resource.Domains, + ChainLength: certificateChainLength(fullChainData), + } + } + return saved, resource, nil +} + +// ListVersions returns all stored certificate versions in descending order. +func (s FileStore) ListVersions(ctx context.Context, domain, certificateType string) ([]SavedResource, error) { + if err := ctx.Err(); err != nil { + return nil, err + } + current, err := s.CurrentDirectory(domain, certificateType) + if err != nil { + return nil, err + } + certificateDirectory := filepath.Dir(current) + versionsDirectory := filepath.Join(certificateDirectory, "versions") + entries, err := os.ReadDir(versionsDirectory) + if err != nil { + if errors.Is(err, os.ErrNotExist) { + return []SavedResource{}, nil + } + return nil, fmt.Errorf("读取证书版本失败:%w", err) + } + versions := make([]SavedResource, 0, len(entries)) + for _, entry := range entries { + if !entry.IsDir() { + continue + } + metadata, readErr := os.ReadFile(filepath.Join(versionsDirectory, entry.Name(), "metadata.json")) + if readErr != nil { + return nil, fmt.Errorf("读取证书版本元数据失败:%w", readErr) + } + var item SavedResource + if err := json.Unmarshal(metadata, &item); err != nil { + return nil, fmt.Errorf("解析证书版本元数据失败:%w", err) + } + versions = append(versions, item) + } + sort.SliceStable(versions, func(i, j int) bool { return versions[i].Version > versions[j].Version }) + return versions, nil +} + +// RollbackSavedResource 在初始化后续阶段失败时恢复证书目录。 +// 如果保存前存在旧证书,则从备份目录恢复;否则仅清理本次写入的固定证书文件。 +func RollbackSavedResource(ctx context.Context, saved SavedResource) error { + if err := ctx.Err(); err != nil { + return err + } + directory := filepath.Clean(strings.TrimSpace(saved.Directory)) + if directory == "." || directory == "" { + return errors.New("证书回滚目录不能为空") + } + if strings.TrimSpace(saved.BackupDirectory) != "" { + backupDirectory := filepath.Clean(strings.TrimSpace(saved.BackupDirectory)) + if backupDirectory == "." || backupDirectory == "" { + return errors.New("证书备份目录无效") + } + if _, err := os.Stat(backupDirectory); err != nil { + return fmt.Errorf("读取证书备份目录失败:%w", err) + } + if err := restoreCertificateFiles(directory, backupDirectory); err != nil { + return fmt.Errorf("恢复原证书失败:%w", err) + } + return nil + } + for _, name := range []string{"cert.pem", "fullchain.pem", "key.pem", "metadata.json"} { + path := filepath.Join(directory, name) + if err := os.Remove(path); err != nil && !errors.Is(err, os.ErrNotExist) { + return fmt.Errorf("清理失败证书文件 %s 失败:%w", name, err) + } + } + return nil +} + +func restoreCertificateFiles(directory, backupDirectory string) error { + if err := os.MkdirAll(directory, 0o700); err != nil { + return err + } + for _, name := range []string{"cert.pem", "fullchain.pem", "key.pem", "metadata.json"} { + source := filepath.Join(backupDirectory, name) + data, err := os.ReadFile(source) + if err != nil { + if errors.Is(err, os.ErrNotExist) { + continue + } + return err + } + mode := os.FileMode(0o600) + if name == "cert.pem" || name == "fullchain.pem" { + mode = 0o644 + } + if err := atomicWrite(filepath.Join(directory, name), data, mode); err != nil { + return err + } + } + return nil +} diff --git a/backend/internal/certificate/lifecycle_version_test.go b/backend/internal/certificate/lifecycle_version_test.go new file mode 100644 index 0000000..b6592ac --- /dev/null +++ b/backend/internal/certificate/lifecycle_version_test.go @@ -0,0 +1,132 @@ +package certificate + +import ( + "context" + "errors" + "os" + "path/filepath" + "runtime" + "testing" + "time" +) + +func TestFileStoreVersionedLayoutAndHistory(t *testing.T) { + root := t.TempDir() + store := FileStore{ + Root: filepath.Join(root, "ssl"), + BackupRoot: filepath.Join(root, "backups"), + Now: func() time.Time { return time.Date(2026, 8, 27, 12, 0, 0, 0, time.UTC) }, + } + resource := testResource(t, "example.com") + first, err := store.SaveForType(context.Background(), "example.com", "single", resource) + if err != nil { + t.Fatalf("保存第一版证书失败:%v", err) + } + second, err := store.SaveForType(context.Background(), "example.com", "single", resource) + if err != nil { + t.Fatalf("保存第二版证书失败:%v", err) + } + if first.Version == second.Version { + t.Fatalf("重复保存不应覆盖历史版本:%q", first.Version) + } + wantCurrent := filepath.Join(root, "ssl", "example.com", "single", "current") + if second.Directory != wantCurrent { + t.Fatalf("当前目录错误:got=%q want=%q", second.Directory, wantCurrent) + } + for _, path := range []string{ + filepath.Join(wantCurrent, "cert.pem"), + filepath.Join(wantCurrent, "fullchain.pem"), + filepath.Join(wantCurrent, "key.pem"), + filepath.Join(wantCurrent, "metadata.json"), + filepath.Join(root, "ssl", "example.com", "single", "versions", first.Version, "metadata.json"), + filepath.Join(root, "ssl", "example.com", "single", "versions", second.Version, "metadata.json"), + } { + if _, err := os.Stat(path); err != nil { + t.Fatalf("证书文件不存在:%s:%v", path, err) + } + } + if runtime.GOOS != "windows" { + info, err := os.Stat(second.PrivateKeyPath) + if err != nil { + t.Fatalf("读取私钥权限失败:%v", err) + } + if info.Mode().Perm() != 0o600 { + t.Fatalf("私钥权限错误:%o", info.Mode().Perm()) + } + } + versions, err := store.ListVersions(context.Background(), "example.com", "single") + if err != nil { + t.Fatalf("读取证书版本失败:%v", err) + } + if len(versions) != 2 || versions[0].Version != second.Version || versions[1].Version != first.Version { + t.Fatalf("证书版本历史错误:%+v", versions) + } + metadata, loaded, err := store.LoadCurrent(context.Background(), "example.com", "single") + if err != nil { + t.Fatalf("读取当前证书失败:%v", err) + } + if metadata.Version != second.Version || len(loaded.Certificate) == 0 || len(loaded.PrivateKey) == 0 { + t.Fatalf("当前证书内容错误:metadata=%+v", metadata) + } +} + +func TestFileStoreListVersionsReturnsEmptyWhenNoHistory(t *testing.T) { + store := FileStore{Root: t.TempDir()} + versions, err := store.ListVersions(context.Background(), "example.com", "san") + if err != nil { + t.Fatalf("无版本记录时查询失败:%v", err) + } + if versions == nil || len(versions) != 0 { + t.Fatalf("无版本记录时应返回空列表:%+v", versions) + } +} + +func TestRollbackSavedResourceRestoresPreviousCertificate(t *testing.T) { + root := t.TempDir() + store := FileStore{ + Root: filepath.Join(root, "ssl"), + BackupRoot: filepath.Join(root, "backups"), + Now: func() time.Time { return time.Date(2026, 8, 28, 12, 0, 0, 0, time.UTC) }, + } + resource := testResource(t, "example.com") + first, err := store.SaveForType(context.Background(), "example.com", "single", resource) + if err != nil { + t.Fatalf("保存初始证书失败:%v", err) + } + second, err := store.SaveForType(context.Background(), "example.com", "single", resource) + if err != nil { + t.Fatalf("保存新证书失败:%v", err) + } + if second.BackupDirectory == "" { + t.Fatal("替换已有证书时应生成备份目录") + } + if err := RollbackSavedResource(context.Background(), second); err != nil { + t.Fatalf("回滚证书失败:%v", err) + } + if _, err := os.Stat(first.FullChainPath); err != nil { + t.Fatalf("回滚后当前证书不存在:%v", err) + } + if _, err := os.Stat(second.PrivateKeyPath); err != nil { + t.Fatalf("回滚后当前私钥不存在:%v", err) + } +} + +func TestRollbackSavedResourceClearsNewCertificateFiles(t *testing.T) { + root := t.TempDir() + store := FileStore{ + Root: filepath.Join(root, "ssl"), + BackupRoot: filepath.Join(root, "backups"), + } + saved, err := store.SaveForType(context.Background(), "example.com", "single", testResource(t, "example.com")) + if err != nil { + t.Fatalf("保存证书失败:%v", err) + } + if err := RollbackSavedResource(context.Background(), saved); err != nil { + t.Fatalf("清理失败证书失败:%v", err) + } + for _, name := range []string{"cert.pem", "fullchain.pem", "key.pem", "metadata.json"} { + if _, err := os.Stat(filepath.Join(saved.Directory, name)); !errors.Is(err, os.ErrNotExist) { + t.Fatalf("回滚后文件仍存在:%s,错误:%v", name, err) + } + } +} diff --git a/backend/internal/certificate/service.go b/backend/internal/certificate/service.go index 99fecb0..c12b0e7 100644 --- a/backend/internal/certificate/service.go +++ b/backend/internal/certificate/service.go @@ -59,6 +59,17 @@ type ImportRequest struct { IssuerBundle string } +type SetupCertificateRequest struct { + Domains []string + CertificateType string + ProviderID string + CredentialRef string + AccountEmail string + Environment string + CertificateRoot string + BackupRoot string +} + func NewService(cfg config.Config, repository DomainStateRepository, credentials CredentialReader, providers ProviderFactory, accounts AccountManager) *Service { return &Service{ config: cfg, repository: repository, credentials: credentials, providers: providers, accounts: accounts, @@ -141,7 +152,10 @@ func (s *Service) Issue(ctx context.Context, domainID string) (IssueResult, erro if err != nil { return fail(err) } - saved, err := s.store.Save(ctx, item.Name, resource) + if err := validateIssuedResource(ctx, resource, domains); err != nil { + return fail(err) + } + saved, err := s.store.SaveForType(ctx, item.Name, string(item.CertificateType), resource) if err != nil { return fail(fmt.Errorf("保存证书文件失败:%w", err)) } @@ -151,6 +165,75 @@ func (s *Service) Issue(ctx context.Context, domainID string) (IssueResult, erro return IssueResult{DomainID: item.ID, Domains: domains, Saved: saved}, nil } +// IssueForSetup 在初始化标记完成前申请并保存管理后台证书。 +func (s *Service) IssueForSetup(ctx context.Context, request SetupCertificateRequest) (SavedResource, error) { + if s == nil || s.credentials == nil || s.providers == nil || s.accounts == nil || s.newIssuer == nil { + return SavedResource{}, errors.New("初始化证书申请服务未初始化") + } + domains, err := NormalizeDomains(request.Domains) + if err != nil { + return SavedResource{}, err + } + certificateType := strings.ToLower(strings.TrimSpace(request.CertificateType)) + if certificateType != "single" && certificateType != "wildcard" && certificateType != "san" { + return SavedResource{}, fmt.Errorf("初始化证书类型无效:%s", certificateType) + } + providerID := strings.ToLower(strings.TrimSpace(request.ProviderID)) + credentialRef := strings.TrimSpace(request.CredentialRef) + if providerID == "" || credentialRef == "" { + return SavedResource{}, errors.New("初始化证书的 DNS Provider 或凭据引用未配置") + } + environment := strings.ToLower(strings.TrimSpace(request.Environment)) + if environment == "" { + environment = s.config.ACME.Environment + } + if environment == "" { + environment = "staging" + } + credentials, err := s.credentials.Get(ctx, credentialRef) + if err != nil { + return SavedResource{}, fmt.Errorf("读取初始化证书 DNS 凭据失败:%w", err) + } + provider, err := s.providers.Create(providerID, credentials) + if err != nil { + return SavedResource{}, fmt.Errorf("创建初始化证书 DNS Provider 失败:%w", err) + } + accountEmail := strings.TrimSpace(request.AccountEmail) + if accountEmail == "" { + accountEmail = strings.TrimSpace(s.config.ACME.AccountEmail) + } + user, err := s.accounts.LoadOrCreate(ctx, environment, accountEmail) + if err != nil { + return SavedResource{}, fmt.Errorf("读取 ACME 账户失败:%w", err) + } + issuer := s.newIssuer(user, provider, environment) + resource, issueErr := issuer.Obtain(ctx, ObtainRequest{ + Domains: domains, AccountEmail: accountEmail, Environment: environment, PreferredChain: s.preferredChain, + }) + if saveErr := s.accounts.Save(ctx, environment, user); saveErr != nil { + if issueErr != nil { + return SavedResource{}, fmt.Errorf("%v;保存 ACME 账户状态失败:%w", issueErr, saveErr) + } + return SavedResource{}, fmt.Errorf("保存 ACME 账户状态失败:%w", saveErr) + } + if issueErr != nil { + return SavedResource{}, issueErr + } + resource, err = ValidateResourceForDomains(resource, domains) + if err != nil { + return SavedResource{}, fmt.Errorf("初始化证书校验失败:%w", err) + } + if err := validateIssuedResource(ctx, resource, domains); err != nil { + return SavedResource{}, err + } + store := FileStore{Root: request.CertificateRoot, BackupRoot: request.BackupRoot} + saved, err := store.SaveForType(ctx, domains[0], certificateType, resource) + if err != nil { + return SavedResource{}, fmt.Errorf("保存初始化证书失败:%w", err) + } + return saved, nil +} + func (s *Service) Import(ctx context.Context, request ImportRequest) (IssueResult, error) { if s == nil || s.repository == nil { return IssueResult{}, errors.New("证书导入服务未初始化") @@ -193,7 +276,10 @@ func (s *Service) Import(ctx context.Context, request ImportRequest) (IssueResul if err != nil { return IssueResult{}, err } - saved, err := s.store.Save(ctx, item.Name, resource) + if err := validateIssuedResource(ctx, resource, domains); err != nil { + return IssueResult{}, err + } + saved, err := s.store.SaveForType(ctx, item.Name, string(item.CertificateType), resource) if err != nil { return IssueResult{}, fmt.Errorf("保存导入证书失败:%w", err) } @@ -203,6 +289,16 @@ func (s *Service) Import(ctx context.Context, request ImportRequest) (IssueResul return IssueResult{DomainID: item.ID, Domains: resource.Domains, Saved: saved}, nil } +func validateIssuedResource(ctx context.Context, resource Resource, domains []string) error { + chainData := append([]byte(nil), resource.Certificate...) + chainData = append(chainData, resource.IssuerCertificate...) + _, err := (LocalValidator{VerifyChain: len(resource.IssuerCertificate) > 0}).ValidatePEM(ctx, chainData, domains) + if err != nil { + return fmt.Errorf("本地证书校验失败:%w", err) + } + return nil +} + func cleanInputPath(value, label string) (string, error) { value = strings.TrimSpace(value) if value == "" { @@ -229,3 +325,58 @@ func requestedDomains(item domain.Domain) ([]string, error) { } return NormalizeDomains(values) } + +// Current returns and validates the active certificate for a managed domain. +func (s *Service) Current(ctx context.Context, domainID string) (IssueResult, error) { + if s == nil || s.repository == nil { + return IssueResult{}, errors.New("当前证书服务未初始化") + } + item, err := s.repository.GetByID(ctx, strings.TrimSpace(domainID)) + if err != nil { + return IssueResult{}, fmt.Errorf("读取域名配置失败:%w", err) + } + domains, err := requestedDomains(item) + if err != nil { + return IssueResult{}, err + } + saved, resource, err := s.store.LoadCurrent(ctx, item.Name, string(item.CertificateType)) + if err != nil { + return IssueResult{}, err + } + if _, err := ValidateResourceForDomains(resource, domains); err != nil { + return IssueResult{}, err + } + saved.SANs = append([]string(nil), resource.Domains...) + return IssueResult{DomainID: item.ID, Domains: domains, Saved: saved}, nil +} + +// ValidateCurrent 校验当前证书文件、私钥、证书链和域名覆盖范围。 +func (s *Service) ValidateCurrent(ctx context.Context, domainID string) (ValidationResult, error) { + result, err := s.Current(ctx, domainID) + if err != nil { + return ValidationResult{}, err + } + validation, err := (LocalValidator{VerifyChain: true}).ValidateFiles( + ctx, + result.Saved.CertificatePath, + result.Saved.FullChainPath, + result.Saved.PrivateKeyPath, + result.Domains, + ) + if err != nil { + return ValidationResult{}, fmt.Errorf("当前证书校验失败:%w", err) + } + return validation, nil +} + +// ListVersions returns the certificate history for a managed domain. +func (s *Service) ListVersions(ctx context.Context, domainID string) ([]SavedResource, error) { + if s == nil || s.repository == nil { + return nil, errors.New("证书服务未初始化") + } + item, err := s.repository.GetByID(ctx, strings.TrimSpace(domainID)) + if err != nil { + return nil, fmt.Errorf("读取域名配置失败:%w", err) + } + return s.store.ListVersions(ctx, item.Name, string(item.CertificateType)) +} diff --git a/backend/internal/certificate/service_test.go b/backend/internal/certificate/service_test.go index df752a8..9cfbeb3 100644 --- a/backend/internal/certificate/service_test.go +++ b/backend/internal/certificate/service_test.go @@ -232,3 +232,33 @@ func testResourceForDomains(t *testing.T, names []string) Resource { PrivateKey: pem.EncodeToMemory(&pem.Block{Type: "RSA PRIVATE KEY", Bytes: x509.MarshalPKCS1PrivateKey(key)}), } } + +func TestServiceIssuesSetupCertificateWithTypedLayout(t *testing.T) { + root := t.TempDir() + cfg := certificateTestConfig(root) + issuer := &serviceIssuer{resource: testResource(t, "scert.example.com")} + service := NewService(cfg, nil, serviceCredentials{}, serviceProviderFactory{}, serviceAccounts{}) + service.newIssuer = func(*AccountUser, challenge.Provider, string) Issuer { return issuer } + + saved, err := service.IssueForSetup(context.Background(), SetupCertificateRequest{ + Domains: []string{"scert.example.com"}, CertificateType: "single", + ProviderID: "cloudflare", CredentialRef: "secret://dns/cloudflare/test", + AccountEmail: "admin@example.com", Environment: "staging", + CertificateRoot: cfg.Paths.Certificate, BackupRoot: cfg.Paths.Backup, + }) + if err != nil { + t.Fatalf("申请初始化证书失败:%v", err) + } + wantDirectory := filepath.Join(cfg.Paths.Certificate, "scert.example.com", "single", "current") + if saved.Directory != wantDirectory { + t.Fatalf("初始化证书目录错误:got=%q want=%q", saved.Directory, wantDirectory) + } + if issuer.request.AccountEmail != "admin@example.com" || len(issuer.request.Domains) != 1 { + t.Fatalf("初始化证书申请参数错误:%+v", issuer.request) + } + for _, path := range []string{saved.CertificatePath, saved.FullChainPath, saved.PrivateKeyPath} { + if _, err := os.Stat(path); err != nil { + t.Fatalf("初始化证书文件不存在:%s:%v", path, err) + } + } +} diff --git a/backend/internal/certificate/validation.go b/backend/internal/certificate/validation.go new file mode 100644 index 0000000..5c76f71 --- /dev/null +++ b/backend/internal/certificate/validation.go @@ -0,0 +1,272 @@ +package certificate + +import ( + "context" + "crypto/sha256" + "crypto/tls" + "crypto/x509" + "encoding/pem" + "errors" + "fmt" + "net" + "net/url" + "os" + "strings" + "time" +) + +// ValidationResult 保存证书校验后的关键元数据。 +type ValidationResult struct { + Domains []string `json:"domains"` + SerialNumber string `json:"serial_number"` + FingerprintSHA256 string `json:"fingerprint_sha256"` + NotBefore time.Time `json:"not_before"` + NotAfter time.Time `json:"not_after"` + ChainLength int `json:"chain_length"` +} + +// LocalValidator 校验本地证书、私钥和证书链。 +type LocalValidator struct { + Roots *x509.CertPool + Now func() time.Time + VerifyChain bool +} + +// ValidateFiles 校验证书文件、私钥文件以及期望覆盖的域名。 +func (v LocalValidator) ValidateFiles(ctx context.Context, certificatePath, fullChainPath, privateKeyPath string, expectedDomains []string) (ValidationResult, error) { + if err := ctx.Err(); err != nil { + return ValidationResult{}, err + } + certificateData, err := os.ReadFile(certificatePath) + if err != nil { + return ValidationResult{}, fmt.Errorf("读取证书文件失败:%w", err) + } + chainData := certificateData + if strings.TrimSpace(fullChainPath) != "" { + chainData, err = os.ReadFile(fullChainPath) + if err != nil { + return ValidationResult{}, fmt.Errorf("读取完整证书链失败:%w", err) + } + } + privateKeyData, err := os.ReadFile(privateKeyPath) + if err != nil { + return ValidationResult{}, fmt.Errorf("读取私钥文件失败:%w", err) + } + if _, err := tls.X509KeyPair(chainData, privateKeyData); err != nil { + return ValidationResult{}, fmt.Errorf("证书与私钥不匹配:%w", err) + } + return v.validatePEM(ctx, chainData, expectedDomains) +} + +// ValidatePEM 校验内存中的证书链和期望域名。 +func (v LocalValidator) ValidatePEM(ctx context.Context, chainData []byte, expectedDomains []string) (ValidationResult, error) { + return v.validatePEM(ctx, chainData, expectedDomains) +} + +func (v LocalValidator) validatePEM(ctx context.Context, chainData []byte, expectedDomains []string) (ValidationResult, error) { + if err := ctx.Err(); err != nil { + return ValidationResult{}, err + } + certificates, err := parseCertificates(chainData) + if err != nil { + return ValidationResult{}, err + } + leaf := certificates[0] + wanted, err := normalizeValidationNames(expectedDomains) + if err != nil { + return ValidationResult{}, err + } + now := time.Now().UTC() + if v.Now != nil { + now = v.Now().UTC() + } + if now.Before(leaf.NotBefore) || !now.Before(leaf.NotAfter) { + return ValidationResult{}, fmt.Errorf("证书当前不在有效期内:%s 至 %s", leaf.NotBefore.UTC().Format(time.RFC3339), leaf.NotAfter.UTC().Format(time.RFC3339)) + } + for _, name := range wanted { + probe := name + if strings.HasPrefix(probe, "*.") { + probe = "scert-wildcard-probe." + strings.TrimPrefix(probe, "*.") + } + if err := leaf.VerifyHostname(probe); err != nil { + return ValidationResult{}, fmt.Errorf("证书不覆盖域名 %s:%w", name, err) + } + } + if v.VerifyChain { + if err := verifyChain(certificates, v.Roots, now); err != nil { + return ValidationResult{}, err + } + } + return validationResult(leaf, len(certificates)), nil +} + +// RemoteValidator 校验远程 HTTPS 服务实际返回的证书。 +type RemoteValidator struct { + Roots *x509.CertPool + Dialer *net.Dialer + Timeout time.Duration + Now func() time.Time +} + +// ValidateHTTPS 连接目标 HTTPS 地址并校验证书链和域名。 +func (v RemoteValidator) ValidateHTTPS(ctx context.Context, endpoint string, expectedDomains []string) (ValidationResult, error) { + target, err := normalizeHTTPSURL(endpoint) + if err != nil { + return ValidationResult{}, err + } + parsed, err := url.Parse(target) + if err != nil { + return ValidationResult{}, fmt.Errorf("解析 HTTPS 地址失败:%w", err) + } + address := parsed.Host + if _, _, splitErr := net.SplitHostPort(address); splitErr != nil { + address = net.JoinHostPort(parsed.Hostname(), "443") + } + dialer := v.Dialer + if dialer == nil { + dialer = &net.Dialer{Timeout: v.timeout()} + } + ctx, cancel := context.WithTimeout(ctx, v.timeout()) + defer cancel() + tlsDialer := &tls.Dialer{ + NetDialer: dialer, + Config: &tls.Config{ + ServerName: parsed.Hostname(), + MinVersion: tls.VersionTLS12, + InsecureSkipVerify: true, + }, + } + connection, err := tlsDialer.DialContext(ctx, "tcp", address) + if err != nil { + return ValidationResult{}, fmt.Errorf("remote HTTPS connection failed: %w", err) + } + tlsConnection, ok := connection.(*tls.Conn) + if !ok { + _ = connection.Close() + return ValidationResult{}, errors.New("remote HTTPS connection type is invalid") + } + defer tlsConnection.Close() + state := tlsConnection.ConnectionState() + if len(state.PeerCertificates) == 0 { + return ValidationResult{}, errors.New("远程 HTTPS 服务未返回证书") + } + certificates := make([]*x509.Certificate, len(state.PeerCertificates)) + copy(certificates, state.PeerCertificates) + wanted := expectedDomains + if len(wanted) == 0 { + wanted = []string{parsed.Hostname()} + } + chainData := make([]byte, 0) + for _, certificate := range certificates { + chainData = append(chainData, pem.EncodeToMemory(&pem.Block{Type: "CERTIFICATE", Bytes: certificate.Raw})...) + } + validator := LocalValidator{Roots: v.Roots, Now: v.Now, VerifyChain: true} + return validator.ValidatePEM(ctx, chainData, wanted) +} + +func (v RemoteValidator) timeout() time.Duration { + if v.Timeout > 0 { + return v.Timeout + } + return 10 * time.Second +} + +func normalizeHTTPSURL(value string) (string, error) { + value = strings.TrimSpace(value) + if value == "" { + return "", errors.New("HTTPS 地址不能为空") + } + if !strings.Contains(value, "://") { + value = "https://" + value + } + parsed, err := url.Parse(value) + if err != nil || parsed.Scheme != "https" || parsed.Hostname() == "" { + return "", errors.New("HTTPS 地址格式无效") + } + return parsed.String(), nil +} + +func normalizeValidationNames(values []string) ([]string, error) { + seen := make(map[string]struct{}, len(values)) + result := make([]string, 0, len(values)) + for _, value := range values { + value = strings.ToLower(strings.TrimSuffix(strings.TrimSpace(value), ".")) + if value == "" { + continue + } + if net.ParseIP(strings.TrimPrefix(value, "*.")) == nil && !validDomain(value) { + return nil, fmt.Errorf("证书校验域名无效:%s", value) + } + if _, exists := seen[value]; exists { + continue + } + seen[value] = struct{}{} + result = append(result, value) + } + if len(result) == 0 { + return nil, errors.New("证书校验域名不能为空") + } + return result, nil +} +func parseCertificates(data []byte) ([]*x509.Certificate, error) { + remaining := data + certificates := make([]*x509.Certificate, 0, 2) + for len(remaining) > 0 { + block, rest := pem.Decode(remaining) + if block == nil { + break + } + remaining = rest + if block.Type != "CERTIFICATE" { + continue + } + certificate, err := x509.ParseCertificate(block.Bytes) + if err != nil { + return nil, fmt.Errorf("解析证书链失败:%w", err) + } + certificates = append(certificates, certificate) + } + if len(certificates) == 0 { + return nil, errors.New("未找到 PEM 证书链") + } + return certificates, nil +} + +func verifyChain(certificates []*x509.Certificate, roots *x509.CertPool, now time.Time) error { + if roots == nil { + var err error + roots, err = x509.SystemCertPool() + if err != nil || roots == nil { + roots = x509.NewCertPool() + } + } + intermediates := x509.NewCertPool() + for _, certificate := range certificates[1:] { + if !certificate.IsCA { + continue + } + intermediates.AddCert(certificate) + } + _, err := certificates[0].Verify(x509.VerifyOptions{ + Roots: roots, + Intermediates: intermediates, + DNSName: "", + CurrentTime: now, + KeyUsages: []x509.ExtKeyUsage{x509.ExtKeyUsageServerAuth}, + }) + if err != nil { + return fmt.Errorf("证书链校验失败:%w", err) + } + return nil +} + +func validationResult(leaf *x509.Certificate, chainLength int) ValidationResult { + return ValidationResult{ + Domains: append([]string(nil), leaf.DNSNames...), + SerialNumber: leaf.SerialNumber.Text(16), + FingerprintSHA256: fmt.Sprintf("%X", sha256.Sum256(leaf.Raw)), + NotBefore: leaf.NotBefore, + NotAfter: leaf.NotAfter, + ChainLength: chainLength, + } +} diff --git a/backend/internal/certificate/validation_test.go b/backend/internal/certificate/validation_test.go new file mode 100644 index 0000000..1f16d89 --- /dev/null +++ b/backend/internal/certificate/validation_test.go @@ -0,0 +1,96 @@ +package certificate + +import ( + "context" + "crypto/rand" + "crypto/rsa" + "crypto/tls" + "crypto/x509" + "crypto/x509/pkix" + "encoding/pem" + "math/big" + "net" + "net/http/httptest" + "testing" + "time" +) + +func TestLocalValidatorChecksKeyChainAndSAN(t *testing.T) { + certificateData, privateKeyData, leaf := validationTestCertificate(t, []string{"example.com", "www.example.com"}) + rootPool := x509.NewCertPool() + rootPool.AddCert(leaf) + validator := LocalValidator{Roots: rootPool, VerifyChain: true} + + result, err := validator.ValidatePEM(context.Background(), certificateData, []string{"example.com", "www.example.com"}) + if err != nil { + t.Fatalf("valid certificate should pass: %v", err) + } + if result.SerialNumber == "" || result.ChainLength != 1 || len(result.Domains) != 2 { + t.Fatalf("unexpected validation result: %+v", result) + } + if _, err := tls.X509KeyPair(certificateData, privateKeyData); err != nil { + t.Fatalf("test certificate and key should match: %v", err) + } +} + +func TestLocalValidatorRejectsMissingSAN(t *testing.T) { + certificateData, _, leaf := validationTestCertificate(t, []string{"example.com"}) + rootPool := x509.NewCertPool() + rootPool.AddCert(leaf) + _, err := (LocalValidator{Roots: rootPool, VerifyChain: true}).ValidatePEM(context.Background(), certificateData, []string{"api.example.com"}) + if err == nil { + t.Fatal("certificate without requested SAN should fail") + } +} + +func TestRemoteValidatorChecksPresentedCertificate(t *testing.T) { + certificateData, privateKeyData, leaf := validationTestCertificate(t, []string{"localhost", "127.0.0.1"}) + pair, err := tls.X509KeyPair(certificateData, privateKeyData) + if err != nil { + t.Fatal(err) + } + server := httptest.NewUnstartedServer(nil) + server.TLS = &tls.Config{Certificates: []tls.Certificate{pair}} + server.StartTLS() + defer server.Close() + + roots := x509.NewCertPool() + roots.AddCert(leaf) + result, err := (RemoteValidator{Roots: roots, Timeout: 5 * time.Second}).ValidateHTTPS(context.Background(), server.URL, []string{"127.0.0.1"}) + if err != nil { + t.Fatalf("remote certificate should pass: %v", err) + } + if result.ChainLength != 1 || len(result.FingerprintSHA256) != 64 { + t.Fatalf("unexpected remote validation result: %+v", result) + } +} + +func validationTestCertificate(t *testing.T, names []string) ([]byte, []byte, *x509.Certificate) { + t.Helper() + key, err := rsa.GenerateKey(rand.Reader, 2048) + if err != nil { + t.Fatal(err) + } + now := time.Now().UTC() + template := &x509.Certificate{ + SerialNumber: big.NewInt(99), + Subject: pkix.Name{CommonName: names[0]}, + DNSNames: names, + IPAddresses: []net.IP{net.ParseIP("127.0.0.1")}, + NotBefore: now.Add(-time.Minute), + NotAfter: now.Add(24 * time.Hour), + KeyUsage: x509.KeyUsageDigitalSignature | x509.KeyUsageKeyEncipherment, + ExtKeyUsage: []x509.ExtKeyUsage{x509.ExtKeyUsageServerAuth}, + } + der, err := x509.CreateCertificate(rand.Reader, template, template, &key.PublicKey, key) + if err != nil { + t.Fatal(err) + } + leaf, err := x509.ParseCertificate(der) + if err != nil { + t.Fatal(err) + } + certificateData := pem.EncodeToMemory(&pem.Block{Type: "CERTIFICATE", Bytes: der}) + privateKeyData := pem.EncodeToMemory(&pem.Block{Type: "RSA PRIVATE KEY", Bytes: x509.MarshalPKCS1PrivateKey(key)}) + return certificateData, privateKeyData, leaf +} diff --git a/backend/internal/cli/operations.go b/backend/internal/cli/operations.go new file mode 100644 index 0000000..252a85f --- /dev/null +++ b/backend/internal/cli/operations.go @@ -0,0 +1,649 @@ +package cli + +import ( + "bufio" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "os" + "path/filepath" + "strconv" + "strings" + "time" + + "github.com/spf13/cobra" + + "git.pcux.cn/xuans/Scert/backend/internal/app" + + "git.pcux.cn/xuans/Scert/backend/internal/config" +) + +func newCertificateCommand() *cobra.Command { + command := &cobra.Command{Use: "certificate", Short: "查询和校验证书"} + command.AddCommand(newCertificateListCommand(), newCertificateShowCommand(), newCertificateValidateCommand()) + return command +} + +func newCertificateListCommand() *cobra.Command { + return &cobra.Command{ + Use: "list", + Short: "查看证书列表", + RunE: func(cmd *cobra.Command, args []string) error { + service, err := openApp(cmd.Context()) + if err != nil { + return err + } + defer service.Close() + items, err := service.Repository.List(cmd.Context()) + if err != nil { + return err + } + result := make([]map[string]any, 0, len(items)) + for _, item := range items { + entry := map[string]any{"domain": item} + current, currentErr := service.Certificates.Current(cmd.Context(), item.ID) + if currentErr != nil { + entry["certificate_error"] = currentErr.Error() + } else { + entry["certificate"] = current + } + result = append(result, entry) + } + return printJSON(cmd, result) + }, + } +} + +func newCertificateShowCommand() *cobra.Command { + var id string + command := &cobra.Command{ + Use: "show", + Short: "查看当前证书详情", + RunE: func(cmd *cobra.Command, args []string) error { + if strings.TrimSpace(id) == "" { + return errors.New("域名 ID 不能为空") + } + service, err := openApp(cmd.Context()) + if err != nil { + return err + } + defer service.Close() + result, err := service.Certificates.Current(cmd.Context(), id) + if err != nil { + return err + } + return printJSON(cmd, result) + }, + } + command.Flags().StringVar(&id, "id", "", "域名 ID") + _ = command.MarkFlagRequired("id") + return command +} + +func newCertificateValidateCommand() *cobra.Command { + var id string + command := &cobra.Command{ + Use: "validate", + Short: "校验当前证书", + RunE: func(cmd *cobra.Command, args []string) error { + if strings.TrimSpace(id) == "" { + return errors.New("域名 ID 不能为空") + } + service, err := openApp(cmd.Context()) + if err != nil { + return err + } + defer service.Close() + result, err := service.Certificates.ValidateCurrent(cmd.Context(), id) + if err != nil { + return err + } + return printJSON(cmd, map[string]any{"valid": true, "certificate": result}) + }, + } + command.Flags().StringVar(&id, "id", "", "域名 ID") + _ = command.MarkFlagRequired("id") + return command +} + +func newRenewCommand() *cobra.Command { + var id string + command := &cobra.Command{ + Use: "renew", + Short: "执行自动续期检查或续期指定域名", + RunE: func(cmd *cobra.Command, args []string) error { + service, err := openApp(cmd.Context()) + if err != nil { + return err + } + defer service.Close() + if strings.TrimSpace(id) != "" { + result, err := service.Workflow.IssueWithReport(cmd.Context(), id) + if err != nil { + return err + } + return printJSON(cmd, result) + } + if service.Renewal == nil { + return errors.New("自动续期服务未初始化") + } + result, err := service.Renewal.RunOnce(cmd.Context()) + if err != nil { + return err + } + return printJSON(cmd, result) + }, + } + command.Flags().StringVar(&id, "id", "", "域名 ID;留空时检查所有需要续期的域名") + return command +} + +func newDeployCommand() *cobra.Command { + var id string + command := &cobra.Command{ + Use: "deploy", + Short: "部署指定域名的当前证书", + RunE: func(cmd *cobra.Command, args []string) error { + if strings.TrimSpace(id) == "" { + return errors.New("域名 ID 不能为空") + } + service, err := openApp(cmd.Context()) + if err != nil { + return err + } + defer service.Close() + result, err := service.Workflow.DeployCurrent(cmd.Context(), id) + if err != nil { + return err + } + return printJSON(cmd, result) + }, + } + command.Flags().StringVar(&id, "id", "", "域名 ID") + _ = command.MarkFlagRequired("id") + return command +} + +func newLogsCommand() *cobra.Command { + var lines int + command := &cobra.Command{ + Use: "logs", + Short: "查看服务日志", + RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + if lines < 1 || lines > 1000 { + return errors.New("日志行数必须在 1 到 1000 之间") + } + path := filepath.Join(cfg.Paths.Log, "scert.log") + file, err := os.Open(path) + if err != nil { + return fmt.Errorf("打开日志文件失败:%w", err) + } + defer file.Close() + values, err := tailLines(file, lines) + if err != nil { + return err + } + for _, value := range values { + if _, err := fmt.Fprintln(cmd.OutOrStdout(), value); err != nil { + return err + } + } + return nil + }, + } + command.Flags().IntVar(&lines, "lines", 100, "显示最后多少行日志") + return command +} + +func newConfigCommand() *cobra.Command { + command := &cobra.Command{Use: "config", Short: "查看和修改服务配置"} + command.AddCommand(newConfigShowCommand(), newConfigSetCommand(), newConfigValidateCommand()) + return command +} + +func newConfigShowCommand() *cobra.Command { + return &cobra.Command{ + Use: "show", + Short: "查看脱敏后的配置", + RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + return printJSON(cmd, safeConfigMap(cfg)) + }, + } +} + +func newConfigValidateCommand() *cobra.Command { + return &cobra.Command{ + Use: "validate", + Short: "校验服务配置", + RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + if err := cfg.Validate(); err != nil { + return err + } + _, err = fmt.Fprintln(cmd.OutOrStdout(), "配置校验通过") + return err + }, + } +} + +func newConfigSetCommand() *cobra.Command { + var key, value string + command := &cobra.Command{ + Use: "set", + Short: "修改允许调整的配置项", + RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + if err := setConfigValue(&cfg, key, value); err != nil { + return err + } + if err := cfg.Save(resolveConfigPath()); err != nil { + return err + } + _, err = fmt.Fprintf(cmd.OutOrStdout(), "配置已更新:%s\n", key) + return err + }, + } + command.Flags().StringVar(&key, "key", "", "配置项名称") + command.Flags().StringVar(&value, "value", "", "配置项值") + _ = command.MarkFlagRequired("key") + _ = command.MarkFlagRequired("value") + return command +} + +func newBackupCommand() *cobra.Command { + var output string + command := &cobra.Command{ + Use: "backup", + Short: "备份配置和 SQLite 数据库", + RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + if strings.TrimSpace(output) == "" { + output = filepath.Join(cfg.Paths.Backup, "scert-"+time.Now().UTC().Format("20060102-150405.000000000")) + } + output = filepath.Clean(output) + if err := ensureBackupDestination(output); err != nil { + return err + } + if err := os.MkdirAll(output, 0o700); err != nil { + return fmt.Errorf("创建备份目录失败:%w", err) + } + if err := copyFileExclusive(resolveConfigPath(), filepath.Join(output, "scert.json"), 0o600); err != nil { + return err + } + if cfg.Database.Driver == "sqlite" && cfg.Database.DSN != ":memory:" { + if err := copyFileExclusive(cfg.Database.DSN, filepath.Join(output, "scert.db"), 0o600); err != nil { + return err + } + } + _, err = fmt.Fprintf(cmd.OutOrStdout(), "备份已创建:%s\n", output) + return err + }, + } + command.Flags().StringVar(&output, "output", "", "备份目录") + return command +} + +func newRestoreCommand() *cobra.Command { + var input string + command := &cobra.Command{ + Use: "restore", + Short: "恢复 SQLite 数据库备份", + RunE: func(cmd *cobra.Command, args []string) error { + input, err := validateRestoreInput(input) + if err != nil { + return err + } + configFile := filepath.Join(input, "scert.json") + cfg, err := config.Load(configFile) + if err != nil { + return fmt.Errorf("读取备份配置失败:%w", err) + } + + currentPath := filepath.Clean(resolveConfigPath()) + _, currentConfigErr := config.Load(currentPath) + if currentConfigErr != nil && !errors.Is(currentConfigErr, os.ErrNotExist) { + return fmt.Errorf("读取当前配置失败:%w", currentConfigErr) + } + if info, statErr := os.Stat(currentPath); statErr == nil && !info.Mode().IsRegular() { + return errors.New("当前配置路径不是普通文件") + } else if statErr != nil && !errors.Is(statErr, os.ErrNotExist) { + return fmt.Errorf("检查当前配置失败:%w", statErr) + } + + databaseSource := filepath.Join(input, "scert.db") + databaseSourceInfo, databaseSourceErr := os.Stat(databaseSource) + databaseSourceExists := databaseSourceErr == nil + if databaseSourceErr != nil && !errors.Is(databaseSourceErr, os.ErrNotExist) { + return fmt.Errorf("检查备份数据库失败:%w", databaseSourceErr) + } + if databaseSourceExists && !databaseSourceInfo.Mode().IsRegular() { + return errors.New("备份数据库不是普通文件") + } + if cfg.Database.Driver == "sqlite" && cfg.Database.DSN != ":memory:" && databaseSourceExists { + if samePath(databaseSource, cfg.Database.DSN) { + return errors.New("备份数据库与当前数据库路径相同") + } + if err := ensureParentDirectory(cfg.Database.DSN); err != nil { + return fmt.Errorf("创建当前数据库父目录失败:%w", err) + } + if databaseTargetInfo, statErr := os.Stat(cfg.Database.DSN); statErr == nil && !databaseTargetInfo.Mode().IsRegular() { + return errors.New("当前数据库不是普通文件") + } else if statErr != nil && !errors.Is(statErr, os.ErrNotExist) { + return fmt.Errorf("检查当前数据库失败:%w", statErr) + } + } + + configBackupPath := "" + if isRegularFile(currentPath) { + configBackupPath = currentPath + ".before-restore-" + time.Now().UTC().Format("20060102-150405.000000000") + if err := copyFileExclusive(currentPath, configBackupPath, 0o600); err != nil { + return err + } + } + + databaseBackupPath := "" + if cfg.Database.Driver == "sqlite" && cfg.Database.DSN != ":memory:" && databaseSourceExists && isRegularFile(cfg.Database.DSN) { + databaseBackupPath = cfg.Database.DSN + ".before-restore-" + time.Now().UTC().Format("20060102-150405.000000000") + if err := copyFileExclusive(cfg.Database.DSN, databaseBackupPath, 0o600); err != nil { + return err + } + } + + if err := cfg.Save(currentPath); err != nil { + return err + } + if cfg.Database.Driver == "sqlite" && cfg.Database.DSN != ":memory:" && databaseSourceExists { + if err := copyFile(databaseSource, cfg.Database.DSN, 0o600); err != nil { + if configBackupPath != "" { + _ = copyFile(configBackupPath, currentPath, 0o600) + } + if databaseBackupPath != "" { + _ = copyFile(databaseBackupPath, cfg.Database.DSN, 0o600) + } + return fmt.Errorf("恢复 SQLite 数据库失败:%w", err) + } + } + _, err = fmt.Fprintf(cmd.OutOrStdout(), "恢复已完成:%s\n", input) + return err + }, + } + command.Flags().StringVar(&input, "input", "", "备份目录") + _ = command.MarkFlagRequired("input") + return command +} + +func openApp(ctx context.Context) (*app.App, error) { + cfg, err := loadConfig() + if err != nil { + return nil, err + } + return app.NewWithConfigPath(ctx, cfg, resolveConfigPath()) +} + +func tailLines(reader io.Reader, count int) ([]string, error) { + values := make([]string, 0, count) + scanner := bufio.NewScanner(reader) + scanner.Buffer(make([]byte, 4096), 1<<20) + for scanner.Scan() { + if len(values) == count { + copy(values, values[1:]) + values[len(values)-1] = scanner.Text() + continue + } + values = append(values, scanner.Text()) + } + if err := scanner.Err(); err != nil { + return nil, fmt.Errorf("读取日志失败:%w", err) + } + return values, nil +} + +func safeConfigMap(cfg config.Config) map[string]any { + data, _ := json.Marshal(cfg) + result := make(map[string]any) + _ = json.Unmarshal(data, &result) + if admin, ok := result["admin"].(map[string]any); ok { + if _, exists := admin["password_hash"]; exists { + admin["password_hash"] = "已配置" + } + } + return result +} + +func setConfigValue(cfg *config.Config, key, value string) error { + if cfg == nil { + return errors.New("配置不能为空") + } + key = strings.ToLower(strings.TrimSpace(key)) + value = strings.TrimSpace(value) + if value == "" { + return errors.New("配置值不能为空") + } + parseBool := func() (bool, error) { return strconv.ParseBool(value) } + parseInt := func() (int, error) { return strconv.Atoi(value) } + switch key { + case "server.host": + cfg.Server.Host = value + case "server.port": + parsed, err := parseInt() + if err != nil { + return fmt.Errorf("端口格式无效:%w", err) + } + cfg.Server.Port = parsed + case "server.https_mode": + cfg.Server.HTTPSMode = value + case "web.enabled": + parsed, err := parseBool() + if err != nil { + return fmt.Errorf("管理页面开关格式无效:%w", err) + } + cfg.Web.Enabled = parsed + case "web.hostname": + cfg.Web.Hostname = value + case "web.public_ip": + cfg.Web.PublicIP = value + case "paths.install": + cfg.Paths.Install = value + case "paths.certificate": + cfg.Paths.Certificate = value + case "paths.config": + cfg.Paths.Config = value + case "paths.data": + cfg.Paths.Data = value + case "paths.log": + cfg.Paths.Log = value + case "paths.backup": + cfg.Paths.Backup = value + case "acme.environment": + cfg.ACME.Environment = value + case "acme.account_email": + cfg.ACME.AccountEmail = value + case "acme.renewal_threshold_days": + parsed, err := parseInt() + if err != nil { + return fmt.Errorf("续期阈值格式无效:%w", err) + } + cfg.ACME.RenewalThresholdDays = parsed + case "dns.provider": + cfg.DNS.Provider = value + case "dns.credential_ref": + cfg.DNS.CredentialRef = value + case "dns.verification_state": + cfg.DNS.VerificationState = value + case "notification.http_enabled": + parsed, err := parseBool() + if err != nil { + return fmt.Errorf("HTTP 通知开关格式无效:%w", err) + } + cfg.Notification.HTTPEnabled = parsed + case "notification.smtp_enabled": + parsed, err := parseBool() + if err != nil { + return fmt.Errorf("SMTP 通知开关格式无效:%w", err) + } + cfg.Notification.SMTPEnabled = parsed + case "notification.provider": + cfg.Notification.Provider = value + case "notification.endpoint": + cfg.Notification.Endpoint = value + case "notification.http_path": + cfg.Notification.HTTPPath = value + case "notification.http_login_path": + cfg.Notification.HTTPLoginPath = value + case "notification.http_auth_mode": + cfg.Notification.HTTPAuthMode = value + case "notification.http_credential_ref": + cfg.Notification.HTTPCredentialRef = value + case "notification.event_mode": + cfg.Notification.EventMode = value + case "notification.sender_name": + cfg.Notification.SenderName = value + case "notification.sender_email": + cfg.Notification.SenderEmail = value + case "notification.recipients": + cfg.Notification.Recipients = splitCommaValues(value) + case "notification.timeout_secs": + parsed, err := parseInt() + if err != nil { + return fmt.Errorf("通知超时时间格式无效:%w", err) + } + cfg.Notification.TimeoutSecs = parsed + default: + return fmt.Errorf("不允许通过命令行修改配置项:%s", key) + } + return cfg.Validate() +} + +func splitCommaValues(value string) []string { + parts := strings.Split(value, ",") + result := make([]string, 0, len(parts)) + for _, part := range parts { + part = strings.TrimSpace(part) + if part != "" { + result = append(result, part) + } + } + return result +} + +func copyFile(source, target string, mode os.FileMode) error { + input, err := os.Open(source) + if err != nil { + return fmt.Errorf("打开文件失败:%w", err) + } + defer input.Close() + if err := os.MkdirAll(filepath.Dir(target), 0o700); err != nil { + return fmt.Errorf("创建目标目录失败:%w", err) + } + output, err := os.OpenFile(target, os.O_CREATE|os.O_TRUNC|os.O_WRONLY, mode) + if err != nil { + return fmt.Errorf("创建目标文件失败:%w", err) + } + if _, err := io.Copy(output, input); err != nil { + _ = output.Close() + return fmt.Errorf("复制文件失败:%w", err) + } + if err := output.Close(); err != nil { + return fmt.Errorf("关闭目标文件失败:%w", err) + } + return os.Chmod(target, mode) +} + +func copyFileExclusive(source, target string, mode os.FileMode) error { + input, err := os.Open(source) + if err != nil { + return fmt.Errorf("打开文件失败:%w", err) + } + defer input.Close() + if err := os.MkdirAll(filepath.Dir(target), 0o700); err != nil { + return fmt.Errorf("创建目标目录失败:%w", err) + } + output, err := os.OpenFile(target, os.O_CREATE|os.O_EXCL|os.O_WRONLY, mode) + if err != nil { + return fmt.Errorf("创建目标文件失败:%w", err) + } + if _, err := io.Copy(output, input); err != nil { + _ = output.Close() + return fmt.Errorf("复制文件失败:%w", err) + } + if err := output.Close(); err != nil { + return fmt.Errorf("关闭目标文件失败:%w", err) + } + return os.Chmod(target, mode) +} + +func ensureBackupDestination(path string) error { + if strings.TrimSpace(path) == "" || path == "." { + return errors.New("备份目录不能为空") + } + if _, err := os.Stat(path); err == nil { + return fmt.Errorf("备份目录已存在,为避免覆盖原备份请更换路径:%s", path) + } else if !errors.Is(err, os.ErrNotExist) { + return fmt.Errorf("检查备份目录失败:%w", err) + } + return nil +} + +func validateRestoreInput(path string) (string, error) { + path = filepath.Clean(strings.TrimSpace(path)) + if path == "." || path == "" { + return "", errors.New("备份目录不能为空") + } + info, err := os.Stat(path) + if err != nil { + return "", fmt.Errorf("检查备份目录失败:%w", err) + } + if !info.IsDir() { + return "", errors.New("备份路径必须是目录") + } + configFile := filepath.Join(path, "scert.json") + if !isRegularFile(configFile) { + return "", errors.New("备份目录缺少有效的 scert.json 文件") + } + return path, nil +} + +func isRegularFile(path string) bool { + info, err := os.Lstat(path) + return err == nil && info.Mode().IsRegular() +} + +func ensureParentDirectory(path string) error { + parent := filepath.Dir(path) + info, err := os.Stat(parent) + if err != nil { + return fmt.Errorf("目标目录不可用:%w", err) + } + if !info.IsDir() { + return errors.New("目标父路径不是目录") + } + return nil +} + +func samePath(left, right string) bool { + leftAbs, leftErr := filepath.Abs(filepath.Clean(left)) + rightAbs, rightErr := filepath.Abs(filepath.Clean(right)) + if leftErr != nil || rightErr != nil { + return false + } + return strings.EqualFold(leftAbs, rightAbs) +} diff --git a/backend/internal/cli/operations_review_test.go b/backend/internal/cli/operations_review_test.go new file mode 100644 index 0000000..f8dffad --- /dev/null +++ b/backend/internal/cli/operations_review_test.go @@ -0,0 +1,65 @@ +package cli + +import ( + "os" + "path/filepath" + "strings" + "testing" +) + +func TestValidateRestoreInputRequiresDirectoryAndConfig(t *testing.T) { + if _, err := validateRestoreInput(t.TempDir()); err == nil { + t.Fatal("缺少配置文件的备份目录未被拒绝") + } + file := filepath.Join(t.TempDir(), "backup.txt") + if err := os.WriteFile(file, []byte("backup"), 0o600); err != nil { + t.Fatalf("创建测试文件失败:%v", err) + } + if _, err := validateRestoreInput(file); err == nil { + t.Fatal("普通文件路径未被拒绝") + } +} + +func TestValidateRestoreInputAcceptsCompleteDirectory(t *testing.T) { + dir := t.TempDir() + if err := os.WriteFile(filepath.Join(dir, "scert.json"), []byte("{}"), 0o600); err != nil { + t.Fatalf("创建测试配置失败:%v", err) + } + result, err := validateRestoreInput(dir) + if err != nil { + t.Fatalf("有效备份目录未通过校验:%v", err) + } + if !strings.EqualFold(result, filepath.Clean(dir)) { + t.Fatalf("备份目录未规范化:%s", result) + } +} + +func TestCopyFileExclusiveRefusesOverwrite(t *testing.T) { + dir := t.TempDir() + source := filepath.Join(dir, "source") + target := filepath.Join(dir, "target") + if err := os.WriteFile(source, []byte("new"), 0o600); err != nil { + t.Fatalf("创建源文件失败:%v", err) + } + if err := os.WriteFile(target, []byte("old"), 0o600); err != nil { + t.Fatalf("创建目标文件失败:%v", err) + } + if err := copyFileExclusive(source, target, 0o600); err == nil { + t.Fatal("排他复制覆盖了已有文件") + } + data, err := os.ReadFile(target) + if err != nil { + t.Fatalf("读取目标文件失败:%v", err) + } + if string(data) != "old" { + t.Fatalf("目标文件内容被修改:%s", data) + } +} + +func TestSamePathNormalizesAbsolutePaths(t *testing.T) { + dir := t.TempDir() + path := filepath.Join(dir, "file") + if !samePath(path, filepath.Join(dir, ".", "file")) { + t.Fatal("相同路径未被识别") + } +} diff --git a/backend/internal/cli/operations_test.go b/backend/internal/cli/operations_test.go new file mode 100644 index 0000000..8f72f30 --- /dev/null +++ b/backend/internal/cli/operations_test.go @@ -0,0 +1,75 @@ +package cli + +import ( + "strings" + "testing" + + "git.pcux.cn/xuans/Scert/backend/internal/config" +) + +func TestTailLinesReturnsOnlyLatestEntries(t *testing.T) { + values, err := tailLines(strings.NewReader("one\ntwo\nthree\n"), 2) + if err != nil { + t.Fatalf("读取日志尾部失败:%v", err) + } + if strings.Join(values, ",") != "two,three" { + t.Fatalf("日志尾部不正确:%v", values) + } +} + +func TestSafeConfigMapRedactsPasswordHash(t *testing.T) { + cfg := config.Default(t.TempDir()) + cfg.Admin.PasswordHash = "secret-hash" + result := safeConfigMap(cfg) + admin, ok := result["admin"].(map[string]any) + if !ok { + t.Fatalf("脱敏配置缺少管理员字段:%v", result) + } + if admin["password_hash"] != "已配置" { + t.Fatalf("密码摘要未脱敏:%v", admin["password_hash"]) + } +} + +func TestSetConfigValueUpdatesAndValidatesAllowedFields(t *testing.T) { + cfg := config.Default(t.TempDir()) + if err := setConfigValue(&cfg, "server.port", "5200"); err != nil { + t.Fatalf("设置端口失败:%v", err) + } + if cfg.Server.Port != 5200 { + t.Fatalf("端口未更新:%d", cfg.Server.Port) + } + if err := setConfigValue(&cfg, "notification.recipients", "a@example.com, b@example.com"); err != nil { + t.Fatalf("设置收件人失败:%v", err) + } + if len(cfg.Notification.Recipients) != 2 { + t.Fatalf("收件人未拆分:%v", cfg.Notification.Recipients) + } + if err := setConfigValue(&cfg, "notification.http_login_path", "/api/login"); err != nil { + t.Fatalf("设置 HTTP 登录路径失败:%v", err) + } + if cfg.Notification.HTTPLoginPath != "/api/login" { + t.Fatalf("HTTP 登录路径未更新:%s", cfg.Notification.HTTPLoginPath) + } + if err := setConfigValue(&cfg, "admin.password_hash", "plain"); err == nil { + t.Fatal("不应允许直接修改密码摘要") + } +} + +func TestRootIncludesOperationalCommands(t *testing.T) { + root := newRootCommand() + for _, name := range []string{"certificate", "renew", "deploy", "logs", "config", "backup", "restore"} { + if root.CommandPath() == name || root.Commands() == nil { + t.Fatalf("根命令状态异常:%s", name) + } + found := false + for _, command := range root.Commands() { + if command.Name() == name { + found = true + break + } + } + if !found { + t.Fatalf("缺少命令:%s", name) + } + } +} diff --git a/backend/internal/cli/root.go b/backend/internal/cli/root.go index 2a5de46..5bc7362 100644 --- a/backend/internal/cli/root.go +++ b/backend/internal/cli/root.go @@ -68,7 +68,9 @@ func newRootCommand() *cobra.Command { root.PersistentFlags().StringVar(&baseDir, "base-dir", "", "Windows 默认安装根目录") root.AddCommand( &cobra.Command{Use: "version", Short: "显示版本信息", Run: func(cmd *cobra.Command, args []string) { cmd.Printf("Scert %s\n", version) }}, - newInitCommand(), newStatusCommand(), newServeCommand(), newDomainCommand(), newServerCommand(), newSSHKeyCommand(), + newInitCommand(), newStatusCommand(), newServeCommand(), newDomainCommand(), newCertificateCommand(), + newRenewCommand(), newDeployCommand(), newLogsCommand(), newConfigCommand(), newBackupCommand(), newRestoreCommand(), + newServerCommand(), newSSHKeyCommand(), ) localizeHelpFlags(root) return root @@ -111,11 +113,15 @@ func newInitCommand() *cobra.Command { func newInitCommandWithFirewall(firewallManager firewall.Manager) *cobra.Command { var ( - adminUsername, adminEmail, adminPassword, emailProvider, emailEndpoint string - recipients, dnsProvider, dnsCredentialRef, certificateRoot string - webHostname, webPublicIP, httpsMode string - serverPort int - dnsVerified, webEnabled bool + adminUsername, adminEmail, adminPassword, emailProvider, emailEndpoint string + emailHTTPPath, emailHTTPLoginPath, emailHTTPAuthMode, emailHTTPCredentialRef, emailHTTPHeaders string + emailEventMode, emailSenderName, emailSenderEmail, emailRetryIntervals string + recipients, dnsProvider, dnsCredentialRef, certificateRoot string + webHostname, webPublicIP, httpsMode string + serverPort, emailTimeoutSecs, emailRetryCount int + emailHTTPEnabled, emailIncludeDeploymentDetails bool + emailIncludeCertificateSerial, emailIncludeManagementURL bool + dnsVerified, webEnabled bool ) command := &cobra.Command{Use: "init", Short: "交互式初始化配置", RunE: func(cmd *cobra.Command, args []string) error { path := resolveConfigPath() @@ -125,10 +131,26 @@ func newInitCommandWithFirewall(firewallManager firewall.Manager) *cobra.Command return err } cfg := config.Default(baseDir) + emailHeaders, err := parseStringMap(emailHTTPHeaders) + if err != nil { + return fmt.Errorf("HTTP 自定义请求头格式无效:%w", err) + } + emailIntervals, err := splitInts(emailRetryIntervals) + if err != nil { + return fmt.Errorf("通知重试间隔格式无效:%w", err) + } input := setup.Input{ AdminUsername: adminUsername, AdminEmail: adminEmail, AdminPassword: adminPassword, ServerPort: serverPort, - EmailProvider: emailProvider, EmailEndpoint: emailEndpoint, - EmailRecipients: splitValues(recipients), DNSProvider: dnsProvider, DNSCredentialRef: dnsCredentialRef, + EmailHTTPEnabled: emailHTTPEnabled, + EmailProvider: emailProvider, EmailEndpoint: emailEndpoint, + EmailHTTPPath: emailHTTPPath, EmailHTTPLoginPath: emailHTTPLoginPath, EmailHTTPAuthMode: emailHTTPAuthMode, + EmailHTTPCredentialRef: emailHTTPCredentialRef, EmailHTTPHeaders: emailHeaders, + EmailEventMode: emailEventMode, EmailIncludeDeploymentDetails: emailIncludeDeploymentDetails, + EmailIncludeCertificateSerial: emailIncludeCertificateSerial, EmailIncludeManagementURL: emailIncludeManagementURL, + EmailSenderName: emailSenderName, EmailSenderEmail: emailSenderEmail, + EmailTimeoutSecs: emailTimeoutSecs, EmailRetryCount: emailRetryCount, + EmailRetryIntervalsSecs: emailIntervals, + EmailRecipients: splitValues(recipients), DNSProvider: dnsProvider, DNSCredentialRef: dnsCredentialRef, DNSVerified: dnsVerified, CertificateRoot: certificateRoot, WebHostname: webHostname, WebPublicIP: webPublicIP, WebEnabled: webEnabled, HTTPSMode: httpsMode, } @@ -154,9 +176,24 @@ func newInitCommandWithFirewall(firewallManager firewall.Manager) *cobra.Command command.Flags().StringVar(&adminEmail, "admin-email", "", "超级管理员绑定邮箱") command.Flags().StringVar(&adminPassword, "admin-password", "", "超级管理员密码(仅建议临时使用参数,优先交互输入)") command.Flags().IntVar(&serverPort, "server-port", 8080, "Scert 主服务端口") + command.Flags().BoolVar(&emailHTTPEnabled, "email-http-enabled", false, "是否启用 HTTP 邮件通知") + command.Flags().StringVar(&emailHTTPPath, "email-http-path", "/api/email/send", "HTTP 邮件通知请求路径") + command.Flags().StringVar(&emailHTTPLoginPath, "email-http-login-path", "/api/login", "HTTP 会话认证登录请求路径") + command.Flags().StringVar(&emailHTTPAuthMode, "email-http-auth-mode", "none", "HTTP 邮件通知认证方式:none、bearer、hmac_sha256、session") + command.Flags().StringVar(&emailHTTPCredentialRef, "email-http-credential-ref", "", "HTTP 邮件通知凭据引用") + command.Flags().StringVar(&emailHTTPHeaders, "email-http-headers", "", "HTTP 自定义请求头 JSON") + command.Flags().StringVar(&emailEventMode, "email-event-mode", "detailed", "通知事件模式:detailed、unified") + command.Flags().StringVar(&emailSenderName, "email-sender-name", "Scert", "通知发件人名称") + command.Flags().StringVar(&emailSenderEmail, "email-sender-email", "", "通知发件人地址,留空使用管理员邮箱") + command.Flags().BoolVar(&emailIncludeDeploymentDetails, "email-include-deployment-details", true, "是否发送服务器部署明细") + command.Flags().BoolVar(&emailIncludeCertificateSerial, "email-include-certificate-serial", true, "是否发送证书序列号") + command.Flags().BoolVar(&emailIncludeManagementURL, "email-include-management-url", true, "是否发送管理后台链接") command.Flags().StringVar(&emailProvider, "email-provider", "", "第三方邮箱服务标识") command.Flags().StringVar(&emailEndpoint, "email-endpoint", "", "第三方邮箱 API 地址") command.Flags().StringVar(&recipients, "recipients", "", "通知收件人,多个地址用逗号分隔") + command.Flags().IntVar(&emailTimeoutSecs, "email-timeout-secs", 10, "通知请求超时时间(秒)") + command.Flags().IntVar(&emailRetryCount, "email-retry-count", 3, "通知失败重试次数") + command.Flags().StringVar(&emailRetryIntervals, "email-retry-intervals", "30,120,600", "通知重试间隔(秒,逗号分隔)") command.Flags().StringVar(&dnsProvider, "dns-provider", "", "DNS API 服务商标识") command.Flags().StringVar(&dnsCredentialRef, "dns-credential-ref", "", "DNS 凭据引用,不保存明文密钥") command.Flags().BoolVar(&dnsVerified, "dns-verified", false, "DNS API 是否已通过外部验证测试") @@ -315,6 +352,33 @@ func splitValues(value string) []string { return strings.Split(value, ",") } +func splitInts(value string) ([]int, error) { + if strings.TrimSpace(value) == "" { + return nil, nil + } + items := strings.Split(value, ",") + result := make([]int, 0, len(items)) + for _, item := range items { + parsed, err := strconv.Atoi(strings.TrimSpace(item)) + if err != nil { + return nil, fmt.Errorf("%q 不是有效数字", strings.TrimSpace(item)) + } + result = append(result, parsed) + } + return result, nil +} + +func parseStringMap(value string) (map[string]string, error) { + if strings.TrimSpace(value) == "" { + return nil, nil + } + var result map[string]string + if err := json.Unmarshal([]byte(value), &result); err != nil { + return nil, err + } + return result, nil +} + func newStatusCommand() *cobra.Command { return &cobra.Command{Use: "status", Short: "查看服务状态", RunE: func(cmd *cobra.Command, args []string) error { cfg, err := loadConfig() diff --git a/backend/internal/config/config.go b/backend/internal/config/config.go index 8f4edbc..c661925 100644 --- a/backend/internal/config/config.go +++ b/backend/internal/config/config.go @@ -85,13 +85,25 @@ type DNSConfig struct { } type NotificationConfig struct { - HTTPEnabled bool `json:"http_enabled"` - SMTPEnabled bool `json:"smtp_enabled"` - Provider string `json:"provider"` - Endpoint string `json:"endpoint"` - Recipients []string `json:"recipients"` - TimeoutSecs int `json:"timeout_secs"` - RetryCount int `json:"retry_count"` + HTTPEnabled bool `json:"http_enabled"` + SMTPEnabled bool `json:"smtp_enabled"` + Provider string `json:"provider"` + Endpoint string `json:"endpoint"` + HTTPPath string `json:"http_path"` + HTTPLoginPath string `json:"http_login_path"` + HTTPAuthMode string `json:"http_auth_mode"` + HTTPCredentialRef string `json:"http_credential_ref"` + HTTPHeaders map[string]string `json:"http_headers"` + EventMode string `json:"event_mode"` + IncludeDeploymentDetails bool `json:"include_deployment_details"` + IncludeCertificateSerial bool `json:"include_certificate_serial"` + IncludeManagementURL bool `json:"include_management_url"` + SenderName string `json:"sender_name"` + SenderEmail string `json:"sender_email"` + Recipients []string `json:"recipients"` + TimeoutSecs int `json:"timeout_secs"` + RetryCount int `json:"retry_count"` + RetryIntervalsSecs []int `json:"retry_intervals_secs"` } func Default(baseDir string) Config { @@ -106,10 +118,20 @@ func Default(baseDir string) Config { Driver: "sqlite", DSN: filepath.Join(paths.Data, "scert.db"), MaxOpenConns: 4, MaxIdleConns: 2, ConnMaxLifetimeMins: 30, }, - Paths: paths, - ACME: ACMEConfig{CA: "letsencrypt", Environment: "staging", RenewalThresholdDays: 6}, - DNS: DNSConfig{VerificationState: "not_configured"}, - Notification: NotificationConfig{TimeoutSecs: 10, RetryCount: 3}, + Paths: paths, + ACME: ACMEConfig{CA: "letsencrypt", Environment: "staging", RenewalThresholdDays: 6}, + DNS: DNSConfig{VerificationState: "not_configured"}, + Notification: NotificationConfig{ + HTTPHeaders: map[string]string{}, + HTTPPath: "/api/email/send", + HTTPLoginPath: "/api/login", + HTTPAuthMode: "none", + EventMode: "detailed", + SenderName: "Scert", + TimeoutSecs: 10, + RetryCount: 3, + RetryIntervalsSecs: []int{30, 120, 600}, + }, } } @@ -185,6 +207,33 @@ func (c *Config) Normalize() { if c.DNS.VerificationState == "" { c.DNS.VerificationState = "not_configured" } + if c.Notification.HTTPPath == "" { + c.Notification.HTTPPath = "/api/email/send" + } + if c.Notification.HTTPLoginPath == "" { + c.Notification.HTTPLoginPath = "/api/login" + } + if c.Notification.HTTPAuthMode == "" { + c.Notification.HTTPAuthMode = "none" + } + if c.Notification.EventMode == "" { + c.Notification.EventMode = "detailed" + } + if c.Notification.SenderName == "" { + c.Notification.SenderName = "Scert" + } + if c.Notification.TimeoutSecs == 0 { + c.Notification.TimeoutSecs = 10 + } + if c.Notification.RetryCount == 0 { + c.Notification.RetryCount = 3 + } + if len(c.Notification.RetryIntervalsSecs) == 0 { + c.Notification.RetryIntervalsSecs = []int{30, 120, 600} + } + if c.Notification.HTTPHeaders == nil { + c.Notification.HTTPHeaders = map[string]string{} + } } func (c Config) Save(path string) error { if err := c.Validate(); err != nil { @@ -273,9 +322,48 @@ func (c Config) Validate() error { return fmt.Errorf("初始化完成时必须配置管理页面域名或公网 IP") } } - if c.Notification.TimeoutSecs < 1 || c.Notification.RetryCount < 0 { + if c.Notification.HTTPAuthMode != "none" && c.Notification.HTTPAuthMode != "bearer" && c.Notification.HTTPAuthMode != "hmac_sha256" && c.Notification.HTTPAuthMode != "session" { + return fmt.Errorf("HTTP 通知认证方式无效:%s", c.Notification.HTTPAuthMode) + } + if c.Notification.HTTPAuthMode != "none" && strings.TrimSpace(c.Notification.HTTPCredentialRef) == "" { + return fmt.Errorf("HTTP 通知启用认证时必须配置凭据引用") + } + if c.Notification.EventMode != "detailed" && c.Notification.EventMode != "unified" { + return fmt.Errorf("通知事件模式无效:%s", c.Notification.EventMode) + } + if strings.TrimSpace(c.Notification.HTTPPath) == "" || !strings.HasPrefix(strings.TrimSpace(c.Notification.HTTPPath), "/") { + return fmt.Errorf("HTTP 通知请求路径必须以 / 开头") + } + if strings.TrimSpace(c.Notification.HTTPLoginPath) == "" || !strings.HasPrefix(strings.TrimSpace(c.Notification.HTTPLoginPath), "/") { + return fmt.Errorf("HTTP 通知登录请求路径必须以 / 开头") + } + if endpoint := strings.TrimSpace(c.Notification.Endpoint); endpoint != "" { + parsedEndpoint, endpointErr := url.Parse(endpoint) + if endpointErr != nil || (parsedEndpoint.Scheme != "http" && parsedEndpoint.Scheme != "https") || parsedEndpoint.Host == "" { + return fmt.Errorf("第三方邮箱 API 地址格式无效") + } + } + if c.Notification.SenderEmail != "" { + senderEmail := strings.ToLower(strings.TrimSpace(c.Notification.SenderEmail)) + parsedSender, senderErr := mail.ParseAddress(senderEmail) + if senderErr != nil || parsedSender.Address != senderEmail || parsedSender.Name != "" { + return fmt.Errorf("通知发件人地址格式无效") + } + } + if c.Notification.TimeoutSecs < 1 || c.Notification.RetryCount < 0 || len(c.Notification.RetryIntervalsSecs) != c.Notification.RetryCount { return fmt.Errorf("通知配置无效") } + for _, interval := range c.Notification.RetryIntervalsSecs { + if interval < 1 { + return fmt.Errorf("通知重试间隔必须大于 0") + } + } + for header := range c.Notification.HTTPHeaders { + switch strings.ToLower(strings.TrimSpace(header)) { + case "authorization", "cookie", "origin", "referer", "content-type", "accept", "x-csrf-token", "x-scert-signature", "x-scert-request-id", "x-scert-timestamp": + return fmt.Errorf("HTTP 自定义请求头不允许覆盖安全头:%s", header) + } + } return nil } diff --git a/backend/internal/database/database.go b/backend/internal/database/database.go index d320175..497a244 100644 --- a/backend/internal/database/database.go +++ b/backend/internal/database/database.go @@ -50,9 +50,32 @@ func Open(ctx context.Context, cfg config.DatabaseConfig) (*Database, error) { _ = db.Close() return nil, fmt.Errorf("连接数据库失败:%w", err) } + if cfg.Driver == "sqlite" { + if err := configureSQLite(pingCtx, db); err != nil { + _ = db.Close() + return nil, err + } + } return &Database{DB: db}, nil } +func configureSQLite(ctx context.Context, db *sql.DB) error { + if _, err := db.ExecContext(ctx, "PRAGMA busy_timeout = 5000"); err != nil { + return fmt.Errorf("配置 SQLite 忙等待失败:%w", err) + } + var mode string + if _, err := db.ExecContext(ctx, "PRAGMA journal_mode = WAL"); err != nil { + return fmt.Errorf("配置 SQLite WAL 失败:%w", err) + } + if err := db.QueryRowContext(ctx, "PRAGMA journal_mode").Scan(&mode); err != nil { + return fmt.Errorf("读取 SQLite 日志模式失败:%w", err) + } + if strings.EqualFold(strings.TrimSpace(mode), "memory") || strings.EqualFold(strings.TrimSpace(mode), "wal") { + return nil + } + return fmt.Errorf("SQLite 日志模式无效:%s", mode) +} + func normalizeMySQLDSN(dsn string) (string, error) { cfg, err := mysql.ParseDSN(dsn) if err != nil { @@ -63,6 +86,21 @@ func normalizeMySQLDSN(dsn string) (string, error) { return cfg.FormatDSN(), nil } +// SanitizeDSN 返回可写入日志的数据库连接信息,不包含 MySQL 密码。 +func SanitizeDSN(driver, dsn string) string { + if strings.EqualFold(strings.TrimSpace(driver), "mysql") { + cfg, err := mysql.ParseDSN(dsn) + if err != nil { + return "mysql://[连接信息无效]" + } + if cfg.Passwd != "" { + cfg.Passwd = "********" + } + return cfg.FormatDSN() + } + return dsn +} + func ensureSQLiteDir(dsn string) error { path := dsn if strings.HasPrefix(path, "file:") { @@ -88,3 +126,14 @@ func (d *Database) Close() error { } return d.DB.Close() } + +// Ping 检查数据库连接是否可用。 +func (d *Database) Ping(ctx context.Context) error { + if d == nil || d.DB == nil { + return fmt.Errorf("数据库连接不能为空") + } + if err := d.DB.PingContext(ctx); err != nil { + return fmt.Errorf("数据库健康检查失败:%w", err) + } + return nil +} diff --git a/backend/internal/database/database_test.go b/backend/internal/database/database_test.go index 0b60173..1a69968 100644 --- a/backend/internal/database/database_test.go +++ b/backend/internal/database/database_test.go @@ -25,7 +25,7 @@ func TestOpenAndMigrateSQLite(t *testing.T) { if err := db.DB.QueryRow("SELECT COUNT(*) FROM schema_migrations").Scan(&count); err != nil { t.Fatalf("读取迁移版本失败:%v", err) } - if count != 3 { + if count != 4 { t.Fatalf("迁移版本数量错误:%d", count) } var autoRenew bool @@ -33,3 +33,31 @@ func TestOpenAndMigrateSQLite(t *testing.T) { t.Fatalf("检查域名选项字段失败:%v", err) } } + +func TestMySQLMigrationStatementsRecognizeRecoverableChanges(t *testing.T) { + cases := []struct { + statement string + table string + name string + }{ + {statement: "ALTER TABLE domains ADD COLUMN auto_renew BOOLEAN NOT NULL DEFAULT TRUE", table: "domains", name: "auto_renew"}, + {statement: "ALTER TABLE `tasks` ADD COLUMN `stage` VARCHAR(32) NOT NULL DEFAULT 'queued'", table: "tasks", name: "stage"}, + {statement: "CREATE INDEX idx_tasks_status ON tasks(status)", table: "tasks", name: "idx_tasks_status"}, + {statement: "CREATE INDEX `idx_tasks_idempotency` ON `tasks`(idempotency_key)", table: "tasks", name: "idx_tasks_idempotency"}, + } + for _, item := range cases { + if matches := mysqlAddColumnPattern.FindStringSubmatch(item.statement); len(matches) == 3 { + if matches[1] != item.table || matches[2] != item.name { + t.Errorf("字段迁移解析结果不正确:statement=%q matches=%v", item.statement, matches) + } + continue + } + if matches := mysqlCreateIndexPattern.FindStringSubmatch(item.statement); len(matches) == 3 { + if matches[1] != item.name || matches[2] != item.table { + t.Errorf("索引迁移解析结果不正确:statement=%q matches=%v", item.statement, matches) + } + continue + } + t.Errorf("可恢复的 MySQL 迁移语句未被识别:%q", item.statement) + } +} diff --git a/backend/internal/database/migrate.go b/backend/internal/database/migrate.go index 6582236..a2ba63d 100644 --- a/backend/internal/database/migrate.go +++ b/backend/internal/database/migrate.go @@ -5,10 +5,11 @@ import ( "database/sql" "embed" "fmt" + "regexp" "strings" ) -//go:embed migrations/sqlite/0001_initial.sql migrations/sqlite/0002_domain_options.sql migrations/sqlite/0003_deployment.sql migrations/mysql/0001_initial.sql migrations/mysql/0002_domain_options.sql migrations/mysql/0003_deployment.sql +//go:embed migrations/sqlite/0001_initial.sql migrations/sqlite/0002_domain_options.sql migrations/sqlite/0003_deployment.sql migrations/sqlite/0004_task_attempts.sql migrations/mysql/0001_initial.sql migrations/mysql/0002_domain_options.sql migrations/mysql/0003_deployment.sql migrations/mysql/0004_task_attempts.sql var migrationFiles embed.FS func Migrate(ctx context.Context, db *sql.DB, driver string) error { @@ -37,7 +38,7 @@ func Migrate(ctx context.Context, db *sql.DB, driver string) error { return nil } -const latestMigrationVersion = 3 +const latestMigrationVersion = 4 func applyMigration(ctx context.Context, db *sql.DB, driver string, version int) error { path := fmt.Sprintf("migrations/%s/%04d_%s.sql", driver, version, migrationName(version)) @@ -48,6 +49,13 @@ func applyMigration(ctx context.Context, db *sql.DB, driver string, version int) statements := migrationStatements(content) if driver == "mysql" { for _, statement := range statements { + skip, err := shouldSkipMySQLStatement(ctx, db, statement) + if err != nil { + return fmt.Errorf("检查数据库迁移状态失败:%w", err) + } + if skip { + continue + } if _, err := db.ExecContext(ctx, statement); err != nil { return fmt.Errorf("执行数据库迁移失败:%w", err) } @@ -77,6 +85,34 @@ func applyMigration(ctx context.Context, db *sql.DB, driver string, version int) return nil } +var ( + mysqlAddColumnPattern = regexp.MustCompile(`(?is)^ALTER\s+TABLE\s+` + "`?([a-zA-Z0-9_]+)`?" + `\s+ADD\s+COLUMN\s+` + "`?([a-zA-Z0-9_]+)`?") + mysqlCreateIndexPattern = regexp.MustCompile(`(?is)^CREATE\s+INDEX\s+` + "`?([a-zA-Z0-9_]+)`?" + `\s+ON\s+` + "`?([a-zA-Z0-9_]+)`?") +) + +// shouldSkipMySQLStatement 检查可恢复迁移中的字段和索引是否已经存在。 +// MySQL 5.7 不支持 ADD COLUMN IF NOT EXISTS,因此需要在执行前查询元数据。 +func shouldSkipMySQLStatement(ctx context.Context, db *sql.DB, statement string) (bool, error) { + statement = strings.TrimSpace(statement) + if matches := mysqlAddColumnPattern.FindStringSubmatch(statement); len(matches) == 3 { + var count int + err := db.QueryRowContext(ctx, ` + SELECT COUNT(*) + FROM information_schema.columns + WHERE table_schema = DATABASE() AND table_name = ? AND column_name = ?`, matches[1], matches[2]).Scan(&count) + return count > 0, err + } + if matches := mysqlCreateIndexPattern.FindStringSubmatch(statement); len(matches) == 3 { + var count int + err := db.QueryRowContext(ctx, ` + SELECT COUNT(*) + FROM information_schema.statistics + WHERE table_schema = DATABASE() AND table_name = ? AND index_name = ?`, matches[2], matches[1]).Scan(&count) + return count > 0, err + } + return false, nil +} + func migrationName(version int) string { switch version { case 1: @@ -85,6 +121,8 @@ func migrationName(version int) string { return "domain_options" case 3: return "deployment" + case 4: + return "task_attempts" default: return "unknown" } diff --git a/backend/internal/database/migrations/mysql/0004_task_attempts.sql b/backend/internal/database/migrations/mysql/0004_task_attempts.sql new file mode 100644 index 0000000..4a14509 --- /dev/null +++ b/backend/internal/database/migrations/mysql/0004_task_attempts.sql @@ -0,0 +1,20 @@ +ALTER TABLE tasks ADD COLUMN stage VARCHAR(32) NOT NULL DEFAULT 'queued'; +ALTER TABLE tasks ADD COLUMN operator_id VARCHAR(128) NOT NULL DEFAULT ''; +ALTER TABLE tasks ADD COLUMN certificate_version_id VARCHAR(128) NOT NULL DEFAULT ''; +ALTER TABLE tasks ADD COLUMN idempotency_key VARCHAR(255) NOT NULL DEFAULT ''; +ALTER TABLE tasks ADD COLUMN updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP; +CREATE INDEX idx_tasks_status ON tasks(status); +CREATE INDEX idx_tasks_idempotency ON tasks(idempotency_key); +CREATE TABLE IF NOT EXISTS task_attempts ( + id VARCHAR(36) NOT NULL PRIMARY KEY, + task_id VARCHAR(36) NOT NULL, + attempt_number INT NOT NULL, + stage VARCHAR(32) NOT NULL, + status VARCHAR(32) NOT NULL, + message TEXT NOT NULL, + started_at DATETIME NULL, + finished_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + UNIQUE KEY uq_task_attempt (task_id, attempt_number), + INDEX idx_task_attempts_task_id (task_id) +); \ No newline at end of file diff --git a/backend/internal/database/migrations/sqlite/0004_task_attempts.sql b/backend/internal/database/migrations/sqlite/0004_task_attempts.sql new file mode 100644 index 0000000..a07967c --- /dev/null +++ b/backend/internal/database/migrations/sqlite/0004_task_attempts.sql @@ -0,0 +1,20 @@ +ALTER TABLE tasks ADD COLUMN stage TEXT NOT NULL DEFAULT 'queued'; +ALTER TABLE tasks ADD COLUMN operator_id TEXT NOT NULL DEFAULT ''; +ALTER TABLE tasks ADD COLUMN certificate_version_id TEXT NOT NULL DEFAULT ''; +ALTER TABLE tasks ADD COLUMN idempotency_key TEXT NOT NULL DEFAULT ''; +ALTER TABLE tasks ADD COLUMN updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP; +CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status); +CREATE INDEX IF NOT EXISTS idx_tasks_idempotency ON tasks(idempotency_key); +CREATE TABLE IF NOT EXISTS task_attempts ( + id TEXT NOT NULL PRIMARY KEY, + task_id TEXT NOT NULL, + attempt_number INTEGER NOT NULL, + stage TEXT NOT NULL, + status TEXT NOT NULL, + message TEXT NOT NULL, + started_at DATETIME NULL, + finished_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + UNIQUE (task_id, attempt_number) +); +CREATE INDEX IF NOT EXISTS idx_task_attempts_task_id ON task_attempts(task_id); \ No newline at end of file diff --git a/backend/internal/database/review_runtime_test.go b/backend/internal/database/review_runtime_test.go new file mode 100644 index 0000000..765a54f --- /dev/null +++ b/backend/internal/database/review_runtime_test.go @@ -0,0 +1,42 @@ +package database + +import ( + "context" + "strings" + "testing" + + "git.pcux.cn/xuans/Scert/backend/internal/config" +) + +func TestDatabasePingAndSQLitePragmas(t *testing.T) { + cfg := config.Default(t.TempDir()).Database + db, err := Open(context.Background(), cfg) + if err != nil { + t.Fatalf("打开 SQLite 失败:%v", err) + } + defer db.Close() + if err := db.Ping(context.Background()); err != nil { + t.Fatalf("数据库健康检查失败:%v", err) + } + var timeout int + if err := db.DB.QueryRow("PRAGMA busy_timeout").Scan(&timeout); err != nil { + t.Fatalf("读取 SQLite 忙等待失败:%v", err) + } + if timeout != 5000 { + t.Fatalf("SQLite 忙等待不正确:%d", timeout) + } + var mode string + if err := db.DB.QueryRow("PRAGMA journal_mode").Scan(&mode); err != nil { + t.Fatalf("读取 SQLite 日志模式失败:%v", err) + } + if mode != "memory" && mode != "wal" { + t.Fatalf("SQLite 日志模式不正确:%s", mode) + } +} + +func TestSanitizeDSNRedactsMySQLPassword(t *testing.T) { + sanitized := SanitizeDSN("mysql", "user:secret@tcp(127.0.0.1:3306)/scert?charset=utf8mb4") + if sanitized == "" || strings.Contains(sanitized, "secret") { + t.Fatalf("MySQL DSN 未正确脱敏:%s", sanitized) + } +} diff --git a/backend/internal/database/review_test.go b/backend/internal/database/review_test.go index 6eb6490..6158a04 100644 --- a/backend/internal/database/review_test.go +++ b/backend/internal/database/review_test.go @@ -52,7 +52,7 @@ func TestSQLiteMigrationIsIdempotentAndCreatesBaseTables(t *testing.T) { if err := db.DB.QueryRow("SELECT COUNT(*) FROM schema_migrations").Scan(&versions); err != nil { t.Fatalf("读取迁移版本失败:%v", err) } - if versions != 3 { + if versions != 4 { t.Fatalf("重复迁移写入了多条版本记录:%d", versions) } var tables int diff --git a/backend/internal/deployment/ssh_test.go b/backend/internal/deployment/ssh_test.go index bf6f294..0a761eb 100644 --- a/backend/internal/deployment/ssh_test.go +++ b/backend/internal/deployment/ssh_test.go @@ -38,11 +38,11 @@ func TestSSHFactoryParsesEncryptedPrivateKeyBeforeDialing(t *testing.T) { Secrets: staticSecretReader{server.PrivateKeyRef: {"private_key": privateKey, "passphrase": "deployment-passphrase"}}, Timeout: 100 * time.Millisecond, } - if _, err := factory.Connect(t.Context(), server); err == nil || !strings.Contains(err.Error(), "\u8fde\u63a5 SSH \u670d\u52a1\u5668\u5931\u8d25") { + if _, err := factory.Connect(t.Context(), server); err == nil || !strings.Contains(err.Error(), "连接 SSH 服务器失败") { t.Fatalf("encrypted private key should parse before the expected dial failure: %v", err) } factory.Secrets = staticSecretReader{server.PrivateKeyRef: {"private_key": privateKey, "passphrase": "wrong-passphrase"}} - if _, err := factory.Connect(t.Context(), server); err == nil || !strings.Contains(err.Error(), "\u89e3\u6790 SSH \u79c1\u94a5\u5931\u8d25") { + if _, err := factory.Connect(t.Context(), server); err == nil || !strings.Contains(err.Error(), "解析 SSH 私钥失败") { t.Fatalf("wrong passphrase should be rejected before dialing: %v", err) } } diff --git a/backend/internal/dnsprovider/catalog.go b/backend/internal/dnsprovider/catalog.go index 0a910db..9fa83e8 100644 --- a/backend/internal/dnsprovider/catalog.go +++ b/backend/internal/dnsprovider/catalog.go @@ -47,7 +47,8 @@ var descriptors = map[string]Descriptor{ }, }, Aliyun: { - ID: Aliyun, Name: "阿里云 DNS", Description: "适配器字段已定义,在线验证将在后续任务接入。", + ID: Aliyun, Name: "阿里云 DNS", Available: true, + Description: "使用 RAM AccessKey 创建和清理 DNS-01 测试记录。", CredentialFields: []CredentialField{ {Name: "access_key_id", Label: "AccessKey ID", Required: true}, {Name: "access_key_secret", Label: "AccessKey Secret", Secret: true, Required: true}, @@ -55,7 +56,8 @@ var descriptors = map[string]Descriptor{ }, }, DNSPod: { - ID: DNSPod, Name: "DNSPod", Description: "使用腾讯云 DNSPod API 凭据;在线验证将在后续任务接入。", + ID: DNSPod, Name: "DNSPod", Available: true, + Description: "使用 DNSPod API 凭据创建和清理 DNS-01 测试记录。", CredentialFields: []CredentialField{ {Name: "secret_id", Label: "SecretId", Required: true}, {Name: "secret_key", Label: "SecretKey", Secret: true, Required: true}, @@ -70,7 +72,8 @@ var descriptors = map[string]Descriptor{ }, }, HuaweiCloud: { - ID: HuaweiCloud, Name: "华为云", Description: "适配器字段已定义,在线验证将在后续任务接入。", + ID: HuaweiCloud, Name: "华为云", Available: true, + Description: "使用 Access Key、Secret Access Key 和区域创建 DNS-01 测试记录。", CredentialFields: []CredentialField{ {Name: "access_key_id", Label: "Access Key ID", Required: true}, {Name: "secret_access_key", Label: "Secret Access Key", Secret: true, Required: true}, @@ -78,7 +81,8 @@ var descriptors = map[string]Descriptor{ }, }, TencentCloud: { - ID: TencentCloud, Name: "腾讯云", Description: "使用腾讯云 DNSPod API;在线验证将在后续任务接入。", + ID: TencentCloud, Name: "腾讯云", Available: true, + Description: "使用腾讯云 DNSPod API 凭据创建和清理 DNS-01 测试记录。", CredentialFields: []CredentialField{ {Name: "secret_id", Label: "SecretId", Required: true}, {Name: "secret_key", Label: "SecretKey", Secret: true, Required: true}, @@ -87,7 +91,8 @@ var descriptors = map[string]Descriptor{ }, }, Route53: { - ID: Route53, Name: "AWS Route 53", Description: "适配器字段已定义,在线验证将在后续任务接入。", + ID: Route53, Name: "AWS Route 53", Available: true, + Description: "使用 AWS 凭据和区域创建和清理 DNS-01 测试记录。", CredentialFields: []CredentialField{ {Name: "access_key_id", Label: "Access Key ID", Required: true}, {Name: "secret_access_key", Label: "Secret Access Key", Secret: true, Required: true}, @@ -97,7 +102,8 @@ var descriptors = map[string]Descriptor{ }, }, GoogleCloud: { - ID: GoogleCloud, Name: "Google Cloud DNS", Description: "适配器字段已定义,在线验证将在后续任务接入。", + ID: GoogleCloud, Name: "Google Cloud DNS", Available: true, + Description: "使用 Google Cloud 服务账号创建和清理 DNS-01 测试记录。", CredentialFields: []CredentialField{ {Name: "service_account_json", Label: "服务账号 JSON", Secret: true, Required: true}, {Name: "project", Label: "项目 ID", Required: true}, diff --git a/backend/internal/dnsprovider/lego_factory.go b/backend/internal/dnsprovider/lego_factory.go index de16818..f2d992e 100644 --- a/backend/internal/dnsprovider/lego_factory.go +++ b/backend/internal/dnsprovider/lego_factory.go @@ -1,11 +1,20 @@ package dnsprovider import ( + "context" + "encoding/json" "fmt" "strings" "github.com/go-acme/lego/v5/challenge" + "github.com/go-acme/lego/v5/providers/dns/alidns" "github.com/go-acme/lego/v5/providers/dns/cloudflare" + "github.com/go-acme/lego/v5/providers/dns/gcloud" + "github.com/go-acme/lego/v5/providers/dns/huaweicloud" + "github.com/go-acme/lego/v5/providers/dns/route53" + "github.com/go-acme/lego/v5/providers/dns/tencentcloud" + "golang.org/x/oauth2/google" + gdns "google.golang.org/api/dns/v1" ) type LegoFactory struct{} @@ -23,11 +32,15 @@ func (LegoFactory) Create(providerID string, credentials map[string]string) (cha if !descriptor.Available { return nil, fmt.Errorf("%w:%s", ErrProviderUnavailable, descriptor.Name) } + cleaned, err := ValidateCredentials(providerID, credentials) + if err != nil { + return nil, err + } switch providerID { case Cloudflare: cfg := cloudflare.NewDefaultConfig() - cfg.AuthToken = credentials["api_token"] - cfg.ZoneToken = credentials["zone_token"] + cfg.AuthToken = cleaned["api_token"] + cfg.ZoneToken = cleaned["zone_token"] if cfg.ZoneToken == "" { cfg.ZoneToken = cfg.AuthToken } @@ -36,6 +49,85 @@ func (LegoFactory) Create(providerID string, credentials map[string]string) (cha return nil, fmt.Errorf("创建 Cloudflare DNS Provider 失败:%w", err) } return provider, nil + case Aliyun: + cfg := alidns.NewDefaultConfig() + cfg.APIKey = cleaned["access_key_id"] + cfg.SecretKey = cleaned["access_key_secret"] + cfg.SecurityToken = cleaned["security_token"] + provider, err := alidns.NewDNSProviderConfig(cfg) + if err != nil { + return nil, fmt.Errorf("创建阿里云 DNS Provider 失败:%w", err) + } + return provider, nil + case DNSPod, TencentCloud: + cfg := tencentcloud.NewDefaultConfig() + cfg.SecretID = cleaned["secret_id"] + cfg.SecretKey = cleaned["secret_key"] + cfg.SessionToken = cleaned["session_token"] + provider, err := tencentcloud.NewDNSProviderConfig(cfg) + if err != nil { + return nil, fmt.Errorf("创建腾讯云 DNSPod Provider 失败:%w", err) + } + return provider, nil + case HuaweiCloud: + cfg := huaweicloud.NewDefaultConfig() + cfg.AccessKeyID = cleaned["access_key_id"] + cfg.SecretAccessKey = cleaned["secret_access_key"] + cfg.Region = cleaned["region"] + provider, err := huaweicloud.NewDNSProviderConfig(cfg) + if err != nil { + return nil, fmt.Errorf("创建华为云 DNS Provider 失败:%w", err) + } + return provider, nil + case Route53: + cfg := route53.NewDefaultConfig() + cfg.AccessKeyID = cleaned["access_key_id"] + cfg.SecretAccessKey = cleaned["secret_access_key"] + cfg.SessionToken = cleaned["session_token"] + cfg.Region = cleaned["region"] + cfg.HostedZoneID = cleaned["hosted_zone_id"] + provider, err := route53.NewDNSProviderConfig(cfg) + if err != nil { + return nil, fmt.Errorf("创建 AWS Route 53 DNS Provider 失败:%w", err) + } + return provider, nil + case GoogleCloud: + serviceAccountJSON := strings.TrimSpace(cleaned["service_account_json"]) + var serviceAccount struct { + ProjectID string `json:"project_id"` + } + if err := json.Unmarshal([]byte(serviceAccountJSON), &serviceAccount); err != nil { + return nil, fmt.Errorf("创建 Google Cloud DNS Provider 失败:服务账号 JSON 格式无效:%w", err) + } + if serviceAccount.ProjectID == "" { + serviceAccount.ProjectID = cleaned["project"] + if serviceAccount.ProjectID == "" { + return nil, fmt.Errorf("创建 Google Cloud DNS Provider 失败:项目 ID 不能为空") + } + var raw map[string]any + if err := json.Unmarshal([]byte(serviceAccountJSON), &raw); err != nil { + return nil, fmt.Errorf("创建 Google Cloud DNS Provider 失败:服务账号 JSON 格式无效:%w", err) + } + raw["project_id"] = serviceAccount.ProjectID + data, err := json.Marshal(raw) + if err != nil { + return nil, fmt.Errorf("创建 Google Cloud DNS Provider 失败:编码服务账号 JSON 失败:%w", err) + } + serviceAccountJSON = string(data) + } + jwtConfig, err := google.JWTConfigFromJSON([]byte(serviceAccountJSON), gdns.NdevClouddnsReadwriteScope) + if err != nil { + return nil, fmt.Errorf("创建 Google Cloud DNS Provider 失败:服务账号凭据无效:%w", err) + } + cfg := gcloud.NewDefaultConfig() + cfg.Project = serviceAccount.ProjectID + cfg.ZoneID = cleaned["zone_id"] + cfg.HTTPClient = jwtConfig.Client(context.Background()) + provider, err := gcloud.NewDNSProviderConfig(cfg) + if err != nil { + return nil, fmt.Errorf("创建 Google Cloud DNS Provider 失败:%w", err) + } + return provider, nil default: return nil, fmt.Errorf("%w:%s", ErrProviderUnavailable, descriptor.Name) } diff --git a/backend/internal/dnsprovider/tester_test.go b/backend/internal/dnsprovider/tester_test.go index 6fb28a1..15d1ec9 100644 --- a/backend/internal/dnsprovider/tester_test.go +++ b/backend/internal/dnsprovider/tester_test.go @@ -66,8 +66,94 @@ func TestValidateCredentialsRejectsUnknownField(t *testing.T) { } func TestUnavailableProviderReturnsTypedError(t *testing.T) { - _, err := NewLegoFactory().Create(Aliyun, map[string]string{"access_key_id": "id", "access_key_secret": "secret"}) + _, err := NewLegoFactory().Create(CNAME, map[string]string{"delegated_domain": "acme.example.com", "delegated_provider": "cloudflare"}) if !errors.Is(err, ErrProviderUnavailable) { t.Fatalf("未开放适配器应返回指定错误:%v", err) } } + +func TestLegoFactoryCreatesConfiguredProviders(t *testing.T) { + tests := []struct { + name string + providerID string + credentials map[string]string + }{ + { + name: "阿里云 DNS", + providerID: Aliyun, + credentials: map[string]string{ + "access_key_id": "id", + "access_key_secret": "secret", + }, + }, + { + name: "DNSPod", + providerID: DNSPod, + credentials: map[string]string{ + "secret_id": "id", + "secret_key": "secret", + }, + }, + { + name: "华为云无效区域校验", + providerID: HuaweiCloud, + credentials: map[string]string{ + "access_key_id": "id", + "secret_access_key": "secret", + "region": "invalid-region", + }, + }, + { + name: "腾讯云", + providerID: TencentCloud, + credentials: map[string]string{ + "secret_id": "id", + "secret_key": "secret", + }, + }, + { + name: "AWS Route 53", + providerID: Route53, + credentials: map[string]string{ + "access_key_id": "id", + "secret_access_key": "secret", + "region": "us-east-1", + }, + }, + } + + factory := NewLegoFactory() + for _, test := range tests { + t.Run(test.name, func(t *testing.T) { + provider, err := factory.Create(test.providerID, test.credentials) + if test.providerID == HuaweiCloud { + if err == nil { + t.Fatal("无效的华为云区域应被拒绝") + } + if errors.Is(err, ErrProviderUnavailable) { + t.Fatalf("华为云已接入,不应返回未开放错误:%v", err) + } + return + } + if err != nil { + t.Fatalf("创建 Provider 失败:%v", err) + } + if provider == nil { + t.Fatal("创建 Provider 后返回空实例") + } + }) + } +} + +func TestGoogleCloudFactoryRejectsMalformedCredentials(t *testing.T) { + _, err := NewLegoFactory().Create(GoogleCloud, map[string]string{ + "service_account_json": "{}", + "project": "test-project", + }) + if err == nil { + t.Fatal("格式错误的 Google Cloud 服务账号凭据应被拒绝") + } + if errors.Is(err, ErrProviderUnavailable) { + t.Fatalf("Google Cloud 已接入,不应返回未开放错误:%v", err) + } +} diff --git a/backend/internal/httpapi/auth.go b/backend/internal/httpapi/auth.go index 6907186..0e7447a 100644 --- a/backend/internal/httpapi/auth.go +++ b/backend/internal/httpapi/auth.go @@ -47,7 +47,7 @@ func (s *Server) authLogin(c *gin.Context) { c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, authRequestBodyLimit) var request authLoginRequest if err := c.ShouldBindJSON(&request); err != nil { - s.writeError(c, http.StatusBadRequest, "\u767b\u5f55\u8bf7\u6c42\u53c2\u6570\u65e0\u6548", err) + s.writeError(c, http.StatusBadRequest, "登录请求参数无效", err) return } @@ -55,13 +55,13 @@ func (s *Server) authLogin(c *gin.Context) { cfg := s.config s.configMu.RUnlock() if !cfg.SetupReady { - s.writeError(c, http.StatusConflict, "\u8bf7\u5148\u5b8c\u6210\u521d\u59cb\u5316\u914d\u7f6e", nil) + s.writeError(c, http.StatusConflict, "请先完成初始化配置", nil) return } key := loginAttemptKey(c.Request, request.Identifier) if !s.allowLogin(key) { - s.writeError(c, http.StatusTooManyRequests, "\u767b\u5f55\u5931\u8d25\u6b21\u6570\u8fc7\u591a\uff0c\u8bf7\u7a0d\u540e\u518d\u8bd5", nil) + s.writeError(c, http.StatusTooManyRequests, "登录失败次数过多,请稍后再试", nil) return } account, err := auth.AuthenticateAdmin( @@ -73,15 +73,15 @@ func (s *Server) authLogin(c *gin.Context) { ) if err != nil { s.recordLoginFailure(key) - s.recordAuthAudit(c, "\u767b\u5f55\u5931\u8d25", "failed", "\u767b\u5f55\u51ed\u636e\u6821\u9a8c\u5931\u8d25") - s.writeError(c, http.StatusUnauthorized, "\u8d26\u53f7\u6216\u5bc6\u7801\u9519\u8bef", nil) + s.recordAuthAudit(c, "登录失败", "failed", "登录凭据校验失败") + s.writeError(c, http.StatusUnauthorized, "账号或密码错误", nil) return } s.clearLoginFailures(key) token, err := newAuthToken() if err != nil { - s.writeError(c, http.StatusInternalServerError, "\u65e0\u6cd5\u521b\u5efa\u767b\u5f55\u4f1a\u8bdd\uff0c\u8bf7\u7a0d\u540e\u91cd\u8bd5", err) + s.writeError(c, http.StatusInternalServerError, "无法创建登录会话,请稍后重试", err) return } lifetime := authSessionLifetime @@ -98,7 +98,7 @@ func (s *Server) authLogin(c *gin.Context) { } s.authMu.Unlock() s.setAuthCookie(c, token, expiresAt) - s.recordAuthAudit(c, "\u767b\u5f55\u6210\u529f", "success", "\u8d85\u7ea7\u7ba1\u7406\u5458\u767b\u5f55\u6210\u529f") + s.recordAuthAudit(c, "登录成功", "success", "超级管理员登录成功") c.JSON(http.StatusOK, gin.H{ "authenticated": true, "account": account.Username, @@ -137,9 +137,9 @@ func (s *Server) authLogout(c *gin.Context) { } http.SetCookie(c.Writer, &http.Cookie{ Name: authCookieName, Value: "", Path: "/", MaxAge: -1, - HttpOnly: true, SameSite: http.SameSiteLaxMode, Secure: requestIsHTTPS(c.Request), + HttpOnly: true, SameSite: http.SameSiteLaxMode, Secure: s.requestIsHTTPS(c.Request), }) - c.JSON(http.StatusOK, gin.H{"authenticated": false, "message": "\u5df2\u9000\u51fa\u767b\u5f55"}) + c.JSON(http.StatusOK, gin.H{"authenticated": false, "message": "已退出登录"}) } func (s *Server) currentAuthSession(c *gin.Context) (authSession, bool) { @@ -167,7 +167,7 @@ func (s *Server) setAuthCookie(c *gin.Context, token string, expiresAt time.Time http.SetCookie(c.Writer, &http.Cookie{ Name: authCookieName, Value: token, Path: "/", Expires: expiresAt, MaxAge: max(1, int(time.Until(expiresAt).Seconds())), - HttpOnly: true, SameSite: http.SameSiteLaxMode, Secure: requestIsHTTPS(c.Request), + HttpOnly: true, SameSite: http.SameSiteLaxMode, Secure: s.requestIsHTTPS(c.Request), }) } @@ -216,7 +216,7 @@ func (s *Server) recordAuthAudit(c *gin.Context, action, status, message string) if err := s.audit.CreateAuditLog(c.Request.Context(), repository.AuditLog{ Action: action, ResourceType: "auth", ResourceID: "login", Status: status, Message: message, }); err != nil && s.logger != nil { - s.logger.Warn("\u4fdd\u5b58\u767b\u5f55\u5ba1\u8ba1\u65e5\u5fd7\u5931\u8d25", "error", err) + s.logger.Warn("保存登录审计日志失败", "error", err) } } @@ -239,11 +239,21 @@ func newAuthToken() (string, error) { return hex.EncodeToString(buffer), nil } -func requestIsHTTPS(request *http.Request) bool { +func (s *Server) requestIsHTTPS(request *http.Request) bool { if request == nil { return false } - return request.TLS != nil || strings.EqualFold(strings.TrimSpace(request.Header.Get("X-Forwarded-Proto")), "https") + if request.TLS != nil { + return true + } + s.configMu.RLock() + proxyMode := s.config.Server.HTTPSMode == "proxy" + s.configMu.RUnlock() + if !proxyMode { + return false + } + forwardedProto := strings.TrimSpace(strings.Split(request.Header.Get("X-Forwarded-Proto"), ",")[0]) + return strings.EqualFold(forwardedProto, "https") } func max(left, right int) int { diff --git a/backend/internal/httpapi/certificate_api.go b/backend/internal/httpapi/certificate_api.go new file mode 100644 index 0000000..1bdc1a3 --- /dev/null +++ b/backend/internal/httpapi/certificate_api.go @@ -0,0 +1,249 @@ +package httpapi + +import ( + "context" + "encoding/json" + "errors" + "fmt" + "io" + "mime/multipart" + "net/http" + "os" + "strings" + + "github.com/gin-gonic/gin" + + "git.pcux.cn/xuans/Scert/backend/internal/certificate" + "git.pcux.cn/xuans/Scert/backend/internal/repository" +) + +const certificateUploadLimit = 20 << 20 + +type certificateReader interface { + Current(context.Context, string) (certificate.IssueResult, error) + ListVersions(context.Context, string) ([]certificate.SavedResource, error) +} + +type certificatePathRequest struct { + CertificatePath string `json:"certificate_path"` + PrivateKeyPath string `json:"private_key_path"` + IssuerBundlePath string `json:"issuer_bundle_path"` +} + +func (s *Server) listCertificates(c *gin.Context) { + if s.repository == nil || s.currentCertificate == nil { + s.writeError(c, http.StatusNotImplemented, "证书管理接口尚未配置", errors.New("证书服务未配置")) + return + } + items, err := s.repository.List(c.Request.Context()) + if err != nil { + s.writeError(c, http.StatusInternalServerError, "查询域名证书失败", err) + return + } + result := make([]gin.H, 0, len(items)) + for _, item := range items { + entry := gin.H{"domain": item, "certificate": nil} + current, currentErr := s.currentCertificate.Current(c.Request.Context(), item.ID) + if currentErr == nil { + entry["certificate"] = current + } else { + entry["certificate_error"] = currentErr.Error() + } + result = append(result, entry) + } + c.JSON(http.StatusOK, gin.H{"items": result}) +} + +func (s *Server) getCertificate(c *gin.Context) { + if s.currentCertificate == nil { + s.writeError(c, http.StatusNotImplemented, "证书管理接口尚未配置", errors.New("证书服务未配置")) + return + } + result, err := s.currentCertificate.Current(c.Request.Context(), strings.TrimSpace(c.Param("id"))) + if err != nil { + s.writeError(c, certificateErrorStatus(err), "读取当前证书失败", err) + return + } + c.JSON(http.StatusOK, result) +} + +func (s *Server) listCertificateVersions(c *gin.Context) { + if s.currentCertificate == nil { + s.writeError(c, http.StatusNotImplemented, "证书管理接口尚未配置", errors.New("证书服务未配置")) + return + } + items, err := s.currentCertificate.ListVersions(c.Request.Context(), strings.TrimSpace(c.Param("id"))) + if err != nil { + s.writeError(c, certificateErrorStatus(err), "查询证书历史版本失败", err) + return + } + c.JSON(http.StatusOK, gin.H{"items": items}) +} + +func (s *Server) validateCertificate(c *gin.Context) { + if s.currentCertificate == nil { + s.writeError(c, http.StatusNotImplemented, "证书校验接口尚未配置", errors.New("证书服务未配置")) + return + } + result, err := s.currentCertificate.Current(c.Request.Context(), strings.TrimSpace(c.Param("id"))) + if err != nil { + s.writeError(c, certificateErrorStatus(err), "读取当前证书失败", err) + return + } + validation, err := (certificate.LocalValidator{VerifyChain: true}).ValidateFiles( + c.Request.Context(), + result.Saved.CertificatePath, + result.Saved.FullChainPath, + result.Saved.PrivateKeyPath, + result.Domains, + ) + if err != nil { + s.writeError(c, http.StatusUnprocessableEntity, "证书校验失败", err) + return + } + c.JSON(http.StatusOK, gin.H{"certificate": result, "validation": validation}) +} + +func (s *Server) deployCertificateCurrent(c *gin.Context) { + if s.deployCertificate == nil { + s.writeError(c, http.StatusNotImplemented, "证书部署接口尚未配置", errors.New("证书部署流程未配置")) + return + } + result, report, err := s.deployCertificate(c.Request.Context(), strings.TrimSpace(c.Param("id"))) + response := gin.H{"certificate": result, "deployment": report} + if err != nil { + response["error"] = err.Error() + c.JSON(http.StatusBadGateway, response) + return + } + c.JSON(http.StatusOK, response) +} + +func (s *Server) importCertificateFiles(c *gin.Context) { + if s.importCertificate == nil { + s.writeError(c, http.StatusNotImplemented, "证书导入接口尚未配置", errors.New("证书导入流程未配置")) + return + } + c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, certificateUploadLimit) + request, cleanup, err := parseCertificateImportRequest(c) + if err != nil { + s.writeError(c, http.StatusBadRequest, "证书上传参数无效", err) + return + } + defer cleanup() + result, report, err := s.importCertificate(c.Request.Context(), request) + response := gin.H{"certificate": result, "deployment": report} + if err != nil { + response["error"] = err.Error() + c.JSON(http.StatusBadGateway, response) + return + } + c.JSON(http.StatusOK, response) +} + +func parseCertificateImportRequest(c *gin.Context) (certificate.ImportRequest, func(), error) { + cleanup := func() {} + contentType := c.GetHeader("Content-Type") + if strings.HasPrefix(strings.ToLower(contentType), "multipart/form-data") { + if err := c.Request.ParseMultipartForm(certificateUploadLimit); err != nil { + return certificate.ImportRequest{}, cleanup, fmt.Errorf("解析上传表单失败:%w", err) + } + certificatePath, cleanCertificate, err := saveMultipartFile(c.Request.MultipartForm, "certificate") + if err != nil { + return certificate.ImportRequest{}, cleanup, err + } + privateKeyPath, cleanPrivateKey, err := saveMultipartFile(c.Request.MultipartForm, "private_key") + if err != nil { + cleanCertificate() + return certificate.ImportRequest{}, cleanup, err + } + issuerPath, cleanIssuer, err := saveOptionalMultipartFile(c.Request.MultipartForm, "issuer_bundle") + if err != nil { + cleanCertificate() + cleanPrivateKey() + return certificate.ImportRequest{}, cleanup, err + } + cleanup = func() { + cleanCertificate() + cleanPrivateKey() + cleanIssuer() + } + return certificate.ImportRequest{ + DomainID: c.Param("id"), Certificate: certificatePath, PrivateKey: privateKeyPath, IssuerBundle: issuerPath, + }, cleanup, nil + } + var body certificatePathRequest + if err := json.NewDecoder(c.Request.Body).Decode(&body); err != nil { + return certificate.ImportRequest{}, cleanup, fmt.Errorf("读取证书路径失败:%w", err) + } + if strings.TrimSpace(body.CertificatePath) == "" { + return certificate.ImportRequest{}, cleanup, errors.New("证书路径不能为空") + } + if strings.TrimSpace(body.PrivateKeyPath) == "" { + return certificate.ImportRequest{}, cleanup, errors.New("私钥路径不能为空") + } + return certificate.ImportRequest{ + DomainID: c.Param("id"), Certificate: body.CertificatePath, PrivateKey: body.PrivateKeyPath, IssuerBundle: body.IssuerBundlePath, + }, cleanup, nil +} + +func saveMultipartFile(form *multipart.Form, field string) (string, func(), error) { + path, cleanup, err := saveOptionalMultipartFile(form, field) + if err != nil { + return "", cleanup, err + } + if path == "" { + return "", cleanup, fmt.Errorf("缺少上传文件:%s", field) + } + return path, cleanup, nil +} + +func saveOptionalMultipartFile(form *multipart.Form, field string) (string, func(), error) { + cleanup := func() {} + if form == nil { + return "", cleanup, errors.New("上传表单为空") + } + files := form.File[field] + if len(files) == 0 { + return "", cleanup, nil + } + file, err := files[0].Open() + if err != nil { + return "", cleanup, fmt.Errorf("打开上传文件失败:%w", err) + } + defer file.Close() + temporary, err := os.CreateTemp("", "scert-upload-*") + if err != nil { + return "", cleanup, fmt.Errorf("创建上传临时文件失败:%w", err) + } + path := temporary.Name() + cleanup = func() { _ = os.Remove(path) } + if err := temporary.Chmod(0600); err != nil { + _ = temporary.Close() + cleanup() + return "", func() {}, fmt.Errorf("设置上传临时文件权限失败:%w", err) + } + written, err := io.CopyN(temporary, file, certificateUploadLimit+1) + if err != nil && !errors.Is(err, io.EOF) { + _ = temporary.Close() + cleanup() + return "", func() {}, fmt.Errorf("保存上传文件失败:%w", err) + } + if written > certificateUploadLimit { + _ = temporary.Close() + cleanup() + return "", func() {}, fmt.Errorf("上传文件超过 %d MB 限制", certificateUploadLimit>>20) + } + if err := temporary.Close(); err != nil { + cleanup() + return "", func() {}, fmt.Errorf("关闭上传临时文件失败:%w", err) + } + return path, cleanup, nil +} + +func certificateErrorStatus(err error) int { + if repository.IsNotFound(err) || errors.Is(err, os.ErrNotExist) { + return http.StatusNotFound + } + return http.StatusUnprocessableEntity +} diff --git a/backend/internal/httpapi/certificate_api_test.go b/backend/internal/httpapi/certificate_api_test.go new file mode 100644 index 0000000..359d8a3 --- /dev/null +++ b/backend/internal/httpapi/certificate_api_test.go @@ -0,0 +1,138 @@ +package httpapi + +import ( + "bytes" + "context" + "encoding/json" + "mime/multipart" + "net/http" + "net/http/httptest" + "os" + "strings" + "testing" + "time" + + "git.pcux.cn/xuans/Scert/backend/internal/certificate" + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/deployment" + "git.pcux.cn/xuans/Scert/backend/internal/domain" +) + +type certificateReaderStub struct { + result certificate.IssueResult + versions []certificate.SavedResource + err error +} + +func (s certificateReaderStub) Current(context.Context, string) (certificate.IssueResult, error) { + return s.result, s.err +} + +func (s certificateReaderStub) ListVersions(context.Context, string) ([]certificate.SavedResource, error) { + return s.versions, s.err +} + +func TestCertificateReadAPIs(t *testing.T) { + expiresAt := time.Now().UTC().Add(90 * 24 * time.Hour) + reader := certificateReaderStub{ + result: certificate.IssueResult{ + DomainID: "domain-1", + Domains: []string{"example.com", "www.example.com"}, + Saved: certificate.SavedResource{ + Domain: "example.com", + CertificateType: "san", + Version: "20260827-120000.000000000", + NotAfter: expiresAt, + }, + }, + versions: []certificate.SavedResource{{Version: "20260827-120000.000000000"}}, + } + repo := &stubDomainRepository{items: []domain.Domain{{ID: "domain-1", Name: "example.com", CertificateType: domain.CertificateSAN}}} + server := New(Dependencies{Config: config.Default(t.TempDir()), Repository: repo, CurrentCertificate: reader}) + + list := httptest.NewRecorder() + server.Handler().ServeHTTP(list, httptest.NewRequest(http.MethodGet, "/api/v1/certificates", nil)) + if list.Code != http.StatusOK || !strings.Contains(list.Body.String(), "example.com") { + t.Fatalf("证书列表响应错误:%d %s", list.Code, list.Body.String()) + } + + detail := httptest.NewRecorder() + server.Handler().ServeHTTP(detail, httptest.NewRequest(http.MethodGet, "/api/v1/certificates/domain-1", nil)) + if detail.Code != http.StatusOK || !strings.Contains(detail.Body.String(), "20260827-120000.000000000") { + t.Fatalf("证书详情响应错误:%d %s", detail.Code, detail.Body.String()) + } + + versions := httptest.NewRecorder() + server.Handler().ServeHTTP(versions, httptest.NewRequest(http.MethodGet, "/api/v1/domains/domain-1/certificate/versions", nil)) + if versions.Code != http.StatusOK || !strings.Contains(versions.Body.String(), "20260827-120000.000000000") { + t.Fatalf("证书历史版本响应错误:%d %s", versions.Code, versions.Body.String()) + } +} + +func TestCertificateImportAPIAcceptsMultipartFiles(t *testing.T) { + var received certificate.ImportRequest + importer := func(_ context.Context, request certificate.ImportRequest) (certificate.IssueResult, deployment.Report, error) { + received = request + certificateData, err := os.ReadFile(request.Certificate) + if err != nil { + return certificate.IssueResult{}, deployment.Report{}, err + } + privateKeyData, err := os.ReadFile(request.PrivateKey) + if err != nil { + return certificate.IssueResult{}, deployment.Report{}, err + } + if string(certificateData) != "certificate" || string(privateKeyData) != "private-key" { + return certificate.IssueResult{}, deployment.Report{}, os.ErrInvalid + } + return certificate.IssueResult{DomainID: request.DomainID}, deployment.Report{Status: "success"}, nil + } + server := New(Dependencies{ + Config: config.Default(t.TempDir()), + Repository: &stubDomainRepository{}, + ImportCertificate: importer, + }) + + body := &bytes.Buffer{} + writer := multipart.NewWriter(body) + certificatePart, err := writer.CreateFormFile("certificate", "cert.pem") + if err != nil { + t.Fatal(err) + } + _, _ = certificatePart.Write([]byte("certificate")) + privateKeyPart, err := writer.CreateFormFile("private_key", "key.pem") + if err != nil { + t.Fatal(err) + } + _, _ = privateKeyPart.Write([]byte("private-key")) + if err := writer.Close(); err != nil { + t.Fatal(err) + } + request := httptest.NewRequest(http.MethodPost, "/api/v1/domains/domain-1/certificate/import", body) + request.Header.Set("Content-Type", writer.FormDataContentType()) + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, request) + if response.Code != http.StatusOK || received.DomainID != "domain-1" { + t.Fatalf("证书导入响应错误:%d %s", response.Code, response.Body.String()) + } + if _, err := os.Stat(received.Certificate); !os.IsNotExist(err) { + t.Fatalf("证书上传临时文件未在请求结束后清理:%s", received.Certificate) + } +} + +func TestCertificateImportAPIRejectsMissingFiles(t *testing.T) { + server := New(Dependencies{ + Config: config.Default(t.TempDir()), + Repository: &stubDomainRepository{}, + ImportCertificate: func(context.Context, certificate.ImportRequest) (certificate.IssueResult, deployment.Report, error) { + return certificate.IssueResult{}, deployment.Report{}, nil + }, + }) + body, _ := json.Marshal(certificatePathRequest{CertificatePath: "", PrivateKeyPath: ""}) + request := httptest.NewRequest(http.MethodPost, "/api/v1/domains/domain-1/certificate/import", bytes.NewReader(body)) + request.Header.Set("Content-Type", "application/json") + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, request) + if response.Code != http.StatusBadRequest { + t.Fatalf("缺少证书路径应返回参数错误:%d %s", response.Code, response.Body.String()) + } +} diff --git a/backend/internal/httpapi/middleware.go b/backend/internal/httpapi/middleware.go new file mode 100644 index 0000000..dc4d512 --- /dev/null +++ b/backend/internal/httpapi/middleware.go @@ -0,0 +1,112 @@ +package httpapi + +import ( + "crypto/rand" + "encoding/hex" + "net/http" + "net/url" + "strings" + "time" + + "github.com/gin-gonic/gin" +) + +const requestIDHeader = "X-Scert-Request-ID" + +func (s *Server) requestMiddleware() gin.HandlerFunc { + return func(c *gin.Context) { + requestID := strings.TrimSpace(c.GetHeader(requestIDHeader)) + if !validRequestID(requestID) { + requestID = newRequestID() + } + c.Set("request_id", requestID) + c.Header(requestIDHeader, requestID) + started := time.Now() + c.Next() + if s.logger != nil { + s.logger.Info("HTTP 请求完成", + "request_id", requestID, + "method", c.Request.Method, + "path", c.Request.URL.Path, + "status", c.Writer.Status(), + "duration_ms", time.Since(started).Milliseconds(), + ) + } + } +} + +func (s *Server) requireAdmin(c *gin.Context) { + s.configMu.RLock() + setupReady := s.config.SetupReady + s.configMu.RUnlock() + if !setupReady { + c.Next() + return + } + if _, ok := s.currentAuthSession(c); !ok { + c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{ + "error": "请先登录管理后台", + "request_id": requestIDFromContext(c), + }) + return + } + if !s.sameOriginForAPI(c.Request) { + c.AbortWithStatusJSON(http.StatusForbidden, gin.H{ + "error": "请求来源校验失败", + "request_id": requestIDFromContext(c), + }) + return + } + c.Next() +} + +func (s *Server) sameOriginForAPI(request *http.Request) bool { + if request == nil { + return false + } + origin := strings.TrimSpace(request.Header.Get("Origin")) + if origin == "" { + origin = strings.TrimSpace(request.Header.Get("Referer")) + } + if origin == "" { + return true + } + parsed, err := url.Parse(origin) + if err != nil || parsed.Host == "" { + return false + } + requestScheme := "http" + if s.requestIsHTTPS(request) { + requestScheme = "https" + } + return strings.EqualFold(parsed.Host, request.Host) && strings.EqualFold(parsed.Scheme, requestScheme) +} + +func requestIDFromContext(c *gin.Context) string { + value, exists := c.Get("request_id") + if !exists { + return "" + } + requestID, _ := value.(string) + return requestID +} + +func validRequestID(value string) bool { + if len(value) < 8 || len(value) > 128 { + return false + } + for _, char := range value { + if (char < 'a' || char > 'z') && (char < 'A' || char > 'Z') && (char < '0' || char > '9') && char != '-' && char != '_' { + return false + } + } + return true +} + +func newRequestID() string { + buffer := make([]byte, 16) + if _, err := rand.Read(buffer); err != nil { + return "scert-request" + } + return "scert-" + hex.EncodeToString(buffer) +} diff --git a/backend/internal/httpapi/middleware_test.go b/backend/internal/httpapi/middleware_test.go new file mode 100644 index 0000000..50166dc --- /dev/null +++ b/backend/internal/httpapi/middleware_test.go @@ -0,0 +1,96 @@ +package httpapi + +import ( + "net/http" + "net/http/httptest" + "strings" + "testing" + + "golang.org/x/crypto/bcrypt" + + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/domain" +) + +func TestRequestMiddlewareAddsAndPreservesRequestID(t *testing.T) { + server := New(Dependencies{Config: config.Default(t.TempDir()), Repository: &stubDomainRepository{}}) + + first := httptest.NewRecorder() + server.Handler().ServeHTTP(first, httptest.NewRequest(http.MethodGet, "/healthz", nil)) + generated := first.Header().Get(requestIDHeader) + if !validRequestID(generated) { + t.Fatalf("请求 ID 未正确生成:%q", generated) + } + + secondRequest := httptest.NewRequest(http.MethodGet, "/healthz", nil) + secondRequest.Header.Set(requestIDHeader, "client-request-123") + second := httptest.NewRecorder() + server.Handler().ServeHTTP(second, secondRequest) + if actual := second.Header().Get(requestIDHeader); actual != "client-request-123" { + t.Fatalf("请求 ID 未保留:%q", actual) + } +} + +func TestAdminAPIRequiresAuthenticationAfterSetup(t *testing.T) { + cfg := config.Default(t.TempDir()) + cfg.SetupReady = true + cfg.Admin.Username = "admin" + cfg.Admin.Email = "admin@example.com" + hash, err := bcrypt.GenerateFromPassword([]byte("Password123"), bcrypt.MinCost) + if err != nil { + t.Fatalf("生成测试密码摘要失败:%v", err) + } + cfg.Admin.PasswordHash = string(hash) + + server := New(Dependencies{Config: cfg, Repository: &stubDomainRepository{}}) + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, httptest.NewRequest(http.MethodGet, "/api/v1/domains", nil)) + if response.Code != http.StatusUnauthorized { + t.Fatalf("未登录访问管理接口应返回 401,实际为 %d:%s", response.Code, response.Body.String()) + } +} + +func TestAdminAPIAcceptsAuthenticatedSessionAndRejectsCrossOrigin(t *testing.T) { + cfg := config.Default(t.TempDir()) + cfg.SetupReady = true + cfg.Admin.Username = "admin" + cfg.Admin.Email = "admin@example.com" + hash, err := bcrypt.GenerateFromPassword([]byte("Password123"), bcrypt.MinCost) + if err != nil { + t.Fatalf("生成测试密码摘要失败:%v", err) + } + cfg.Admin.PasswordHash = string(hash) + repository := &stubDomainRepository{items: []domain.Domain{}} + server := New(Dependencies{Config: cfg, Repository: repository}) + + loginBody := strings.NewReader(`{"identifier":"admin","password":"Password123"}`) + loginRequest := httptest.NewRequest(http.MethodPost, "/api/v1/auth/login", loginBody) + loginRequest.Header.Set("Content-Type", "application/json") + loginResponse := httptest.NewRecorder() + server.Handler().ServeHTTP(loginResponse, loginRequest) + if loginResponse.Code != http.StatusOK { + t.Fatalf("登录失败:%d %s", loginResponse.Code, loginResponse.Body.String()) + } + cookie := loginResponse.Result().Cookies() + if len(cookie) == 0 { + t.Fatal("登录响应未返回会话 Cookie") + } + + authenticatedRequest := httptest.NewRequest(http.MethodGet, "/api/v1/domains", nil) + authenticatedRequest.AddCookie(cookie[0]) + authenticatedResponse := httptest.NewRecorder() + server.Handler().ServeHTTP(authenticatedResponse, authenticatedRequest) + if authenticatedResponse.Code != http.StatusOK { + t.Fatalf("登录后访问管理接口失败:%d %s", authenticatedResponse.Code, authenticatedResponse.Body.String()) + } + + crossOriginRequest := httptest.NewRequest(http.MethodGet, "/api/v1/domains", nil) + crossOriginRequest.AddCookie(cookie[0]) + crossOriginRequest.Host = "127.0.0.1:5200" + crossOriginRequest.Header.Set("Origin", "https://malicious.example") + crossOriginResponse := httptest.NewRecorder() + server.Handler().ServeHTTP(crossOriginResponse, crossOriginRequest) + if crossOriginResponse.Code != http.StatusForbidden { + t.Fatalf("跨来源管理请求应返回 403,实际为 %d:%s", crossOriginResponse.Code, crossOriginResponse.Body.String()) + } +} diff --git a/backend/internal/httpapi/password_reset_account.go b/backend/internal/httpapi/password_reset_account.go new file mode 100644 index 0000000..48c722c --- /dev/null +++ b/backend/internal/httpapi/password_reset_account.go @@ -0,0 +1,73 @@ +package httpapi + +import ( + "encoding/json" + "net/http" + + "github.com/gin-gonic/gin" + + "git.pcux.cn/xuans/Scert/backend/internal/admin" + "git.pcux.cn/xuans/Scert/backend/internal/auth" +) + +const passwordResetResolveBodyLimit = 16 * 1024 + +type passwordResetResolveRequest struct { + Identifier string `json:"identifier"` +} + +type passwordResetResolution struct { + AccountType string `json:"account_type"` + AccountLabel string `json:"account_label"` + Title string `json:"title"` + Description string `json:"description"` + Action string `json:"action"` + ResetPath string `json:"reset_path,omitempty"` +} + +// resolvePasswordResetAccount 根据账户标识返回对应的密码处理内容。 +func (s *Server) resolvePasswordResetAccount(c *gin.Context) { + c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, passwordResetResolveBodyLimit) + var request passwordResetResolveRequest + decoder := json.NewDecoder(c.Request.Body) + decoder.DisallowUnknownFields() + if err := decoder.Decode(&request); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": "账户信息格式无效"}) + return + } + + identifier, err := auth.NormalizeIdentifier(request.Identifier) + if err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": "请输入有效的用户名或绑定邮箱"}) + return + } + + s.configMu.RLock() + cfg := s.config + s.configMu.RUnlock() + if !cfg.SetupReady { + c.JSON(http.StatusConflict, gin.H{"error": "Scert 尚未完成初始化,暂不能处理密码重置"}) + return + } + + if auth.IsMatch(identifier, cfg.Admin.Username, cfg.Admin.Email) { + c.JSON(http.StatusOK, passwordResetResolution{ + AccountType: "super_admin", + AccountLabel: "超级管理员", + Title: "超级管理员密码重置", + Description: "已识别为超级管理员账户。超级管理员不能通过普通重置页面修改密码,请使用 Scert-admin 开启的一次性重置入口。", + Action: "use_super_admin_entry", + ResetPath: admin.ResetPath, + }) + return + } + + // 未识别账户时不返回具体账户信息,避免通过重置入口枚举账户。 + c.JSON(http.StatusOK, passwordResetResolution{ + AccountType: "unknown", + AccountLabel: "未识别账户", + Title: "无法识别账户", + Description: "未找到匹配的账户,请检查用户名或绑定邮箱;如果账户属于其他用户类型,请联系有权限的管理员处理。", + Action: "check_identifier", + }) +} diff --git a/backend/internal/httpapi/reset.go b/backend/internal/httpapi/reset.go index 17f0178..ac494d8 100644 --- a/backend/internal/httpapi/reset.go +++ b/backend/internal/httpapi/reset.go @@ -83,7 +83,7 @@ func (s *Server) resetSubmit(c *gin.Context) { c.Status(http.StatusTooManyRequests) return } - if !sameOrigin(c.Request) { + if !s.sameOrigin(c.Request) { s.resetLimiter.failed(ip, now) s.recordResetAudit(c, "rejected", "密码重置请求来源校验失败") s.writeResetFailure(c, http.StatusForbidden, "请求来源校验失败,请从重置页面重新提交") @@ -171,12 +171,12 @@ func (s *Server) resetSubmit(c *gin.Context) { s.renderResetSuccess(c, "密码重置成功,请停止 Scert-admin 以结束本次维护窗口") } -func sameOrigin(request *http.Request) bool { +func (s *Server) sameOrigin(request *http.Request) bool { if request == nil || strings.TrimSpace(request.Host) == "" { return false } scheme := "http" - if request.TLS != nil { + if s.requestIsHTTPS(request) { scheme = "https" } origin := strings.TrimSpace(request.Header.Get("Origin")) diff --git a/backend/internal/httpapi/server.go b/backend/internal/httpapi/server.go index 85df735..77cd0f1 100644 --- a/backend/internal/httpapi/server.go +++ b/backend/internal/httpapi/server.go @@ -3,8 +3,11 @@ package httpapi import ( "context" "errors" + "fmt" "net" "net/http" + "os" + "path/filepath" "strconv" "strings" "sync" @@ -25,42 +28,54 @@ import ( ) type Dependencies struct { - Config config.Config - ConfigPath string - Logger *logging.Logger - Repository repository.DomainRepository - Servers repository.ServerRepository - SSHKeys *sshkey.Service - SetupDNS setupDNSVerifier - Firewall firewall.Manager - IssueCertificate func(context.Context, string) (certificate.IssueResult, deployment.Report, error) - ResetStatePath string - Audit repository.AuditRepository + Config config.Config + ConfigPath string + Logger *logging.Logger + Repository repository.DomainRepository + Servers repository.ServerRepository + SSHKeys *sshkey.Service + SetupDNS setupDNSVerifier + Firewall firewall.Manager + IssueCertificate func(context.Context, string) (certificate.IssueResult, deployment.Report, error) + IssueSetupCertificate func(context.Context, certificate.SetupCertificateRequest) (certificate.SavedResource, error) + RollbackSetupCertificate func(context.Context, certificate.SavedResource) error + ImportCertificate func(context.Context, certificate.ImportRequest) (certificate.IssueResult, deployment.Report, error) + DeployCertificate func(context.Context, string) (certificate.IssueResult, deployment.Report, error) + CurrentCertificate certificateReader + ResetStatePath string + Audit repository.AuditRepository + Tasks repository.TaskRepository } type Server struct { - configMu sync.RWMutex - config config.Config - configPath string - logger *logging.Logger - repository repository.DomainRepository - servers repository.ServerRepository - sshKeys *sshkey.Service - setupDNS setupDNSVerifier - firewall firewall.Manager - issueCertificate func(context.Context, string) (certificate.IssueResult, deployment.Report, error) - resetStatePath string - audit repository.AuditRepository - resetMu sync.Mutex - resetClosedHash string - resetLimiter *resetRateLimiter - authSessions map[string]authSession - authMu sync.RWMutex - loginAttempts map[string]loginAttempt - loginMu sync.Mutex - now func() time.Time - httpServer *http.Server - router *gin.Engine + configMu sync.RWMutex + config config.Config + configPath string + logger *logging.Logger + repository repository.DomainRepository + servers repository.ServerRepository + sshKeys *sshkey.Service + setupDNS setupDNSVerifier + firewall firewall.Manager + issueCertificate func(context.Context, string) (certificate.IssueResult, deployment.Report, error) + issueSetupCertificate func(context.Context, certificate.SetupCertificateRequest) (certificate.SavedResource, error) + rollbackSetupCertificate func(context.Context, certificate.SavedResource) error + importCertificate func(context.Context, certificate.ImportRequest) (certificate.IssueResult, deployment.Report, error) + deployCertificate func(context.Context, string) (certificate.IssueResult, deployment.Report, error) + currentCertificate certificateReader + resetStatePath string + audit repository.AuditRepository + tasks repository.TaskRepository + resetMu sync.Mutex + resetClosedHash string + resetLimiter *resetRateLimiter + authSessions map[string]authSession + authMu sync.RWMutex + loginAttempts map[string]loginAttempt + loginMu sync.Mutex + now func() time.Time + httpServer *http.Server + router *gin.Engine } func New(deps Dependencies) *Server { @@ -70,16 +85,23 @@ func New(deps Dependencies) *Server { server := &Server{ config: deps.Config, configPath: deps.ConfigPath, logger: deps.Logger, repository: deps.Repository, setupDNS: deps.SetupDNS, firewall: deps.Firewall, router: router, - servers: deps.Servers, - sshKeys: deps.SSHKeys, - issueCertificate: deps.IssueCertificate, - resetStatePath: deps.ResetStatePath, - audit: deps.Audit, - resetLimiter: newResetRateLimiter(), - authSessions: make(map[string]authSession), - loginAttempts: make(map[string]loginAttempt), - now: time.Now, + servers: deps.Servers, + sshKeys: deps.SSHKeys, + issueCertificate: deps.IssueCertificate, + issueSetupCertificate: deps.IssueSetupCertificate, + rollbackSetupCertificate: deps.RollbackSetupCertificate, + importCertificate: deps.ImportCertificate, + deployCertificate: deps.DeployCertificate, + currentCertificate: deps.CurrentCertificate, + resetStatePath: deps.ResetStatePath, + audit: deps.Audit, + tasks: deps.Tasks, + resetLimiter: newResetRateLimiter(), + authSessions: make(map[string]authSession), + loginAttempts: make(map[string]loginAttempt), + now: time.Now, } + router.Use(server.requestMiddleware()) server.registerRoutes() server.registerSetupRoutes() return server @@ -94,21 +116,33 @@ func (s *Server) registerRoutes() { s.router.GET("/api/v1/auth/session", s.authSession) s.router.POST("/api/v1/auth/login", s.authLogin) s.router.POST("/api/v1/auth/logout", s.authLogout) - s.router.GET("/api/v1/domains", s.listDomains) - s.router.POST("/api/v1/domains", s.createDomain) - s.router.PUT("/api/v1/domains/:id", s.updateDomain) - s.router.DELETE("/api/v1/domains/:id", s.deleteDomain) - s.router.POST("/api/v1/domains/:id/issue", s.issueDomain) - s.router.GET("/api/v1/domains/:id/servers", s.listDomainServers) - s.router.PUT("/api/v1/domains/:id/servers", s.replaceDomainServers) - s.router.GET("/api/v1/servers", s.listServers) - s.router.POST("/api/v1/servers", s.createServer) - s.router.GET("/api/v1/servers/:id", s.getServer) - s.router.PUT("/api/v1/servers/:id", s.updateServer) - s.router.DELETE("/api/v1/servers/:id", s.deleteServer) - s.router.GET("/api/v1/ssh-keys", s.listSSHKeys) - s.router.POST("/api/v1/ssh-keys", s.createSSHKey) - s.router.DELETE("/api/v1/ssh-keys/:id", s.deleteSSHKey) + s.router.POST("/api/v1/password-reset/resolve", s.resolvePasswordResetAccount) + adminAPI := s.router.Group("/api/v1", s.requireAdmin) + adminAPI.GET("/domains", s.listDomains) + adminAPI.POST("/domains", s.createDomain) + adminAPI.PUT("/domains/:id", s.updateDomain) + adminAPI.DELETE("/domains/:id", s.deleteDomain) + adminAPI.POST("/domains/:id/issue", s.issueDomain) + adminAPI.GET("/tasks", s.listTasks) + adminAPI.GET("/tasks/:id", s.getTask) + adminAPI.GET("/tasks/:id/attempts", s.listTaskAttempts) + adminAPI.GET("/audit-logs", s.listAuditLogs) + adminAPI.GET("/certificates", s.listCertificates) + adminAPI.GET("/certificates/:id", s.getCertificate) + adminAPI.POST("/domains/:id/certificate/import", s.importCertificateFiles) + adminAPI.POST("/domains/:id/certificate/validate", s.validateCertificate) + adminAPI.POST("/domains/:id/deploy", s.deployCertificateCurrent) + adminAPI.GET("/domains/:id/certificate/versions", s.listCertificateVersions) + adminAPI.GET("/domains/:id/servers", s.listDomainServers) + adminAPI.PUT("/domains/:id/servers", s.replaceDomainServers) + adminAPI.GET("/servers", s.listServers) + adminAPI.POST("/servers", s.createServer) + adminAPI.GET("/servers/:id", s.getServer) + adminAPI.PUT("/servers/:id", s.updateServer) + adminAPI.DELETE("/servers/:id", s.deleteServer) + adminAPI.GET("/ssh-keys", s.listSSHKeys) + adminAPI.POST("/ssh-keys", s.createSSHKey) + adminAPI.DELETE("/ssh-keys/:id", s.deleteSSHKey) } func (s *Server) Handler() http.Handler { @@ -119,18 +153,64 @@ func (s *Server) ListenAndServe() error { s.configMu.RLock() cfg := s.config s.configMu.RUnlock() + address, err := listenAddress(cfg) + if err != nil { + return err + } s.httpServer = &http.Server{ - Addr: net.JoinHostPort(cfg.Server.Host, strconv.Itoa(cfg.Server.Port)), + Addr: address, Handler: s.router, ReadHeaderTimeout: 10 * time.Second, ReadTimeout: 30 * time.Second, WriteTimeout: 30 * time.Second, IdleTimeout: 60 * time.Second, } - if s.logger != nil { - s.logger.Info("HTTP 服务启动", "address", s.httpServer.Addr, "https_mode", cfg.Server.HTTPSMode) + if !cfg.SetupReady { + if s.logger != nil { + s.logger.Info("HTTP 服务启动", "address", s.httpServer.Addr, "https_mode", "初始化明文 HTTP") + } + return s.httpServer.ListenAndServe() } - return s.httpServer.ListenAndServe() + certPath := strings.TrimSpace(cfg.Server.TLSCert) + keyPath := strings.TrimSpace(cfg.Server.TLSKey) + if certPath == "" || keyPath == "" { + return fmt.Errorf("初始化已完成,但 HTTPS 证书或私钥路径未配置") + } + if _, err := os.Stat(filepath.Clean(certPath)); err != nil { + return fmt.Errorf("读取 HTTPS 证书失败:%w", err) + } + if _, err := os.Stat(filepath.Clean(keyPath)); err != nil { + return fmt.Errorf("读取 HTTPS 私钥失败:%w", err) + } + if s.logger != nil { + s.logger.Info("HTTPS 服务启动", "address", s.httpServer.Addr, "https_mode", cfg.Server.HTTPSMode) + } + return s.httpServer.ListenAndServeTLS(certPath, keyPath) +} + +// listenAddress 返回当前 HTTPS 模式实际使用的监听地址。 +// 高级模式的核心服务只允许通过本机回环地址提供内部 HTTPS,避免误绑定到公网网卡。 +func listenAddress(cfg config.Config) (string, error) { + host := strings.TrimSpace(cfg.Server.Host) + if host == "" { + return "", fmt.Errorf("服务监听地址不能为空") + } + if cfg.Server.Port < 1 || cfg.Server.Port > 65535 { + return "", fmt.Errorf("服务监听端口无效:%d", cfg.Server.Port) + } + if cfg.Server.HTTPSMode == "proxy" && !isLoopbackHost(host) { + host = "127.0.0.1" + } + return net.JoinHostPort(strings.Trim(host, "[]"), strconv.Itoa(cfg.Server.Port)), nil +} + +func isLoopbackHost(host string) bool { + host = strings.Trim(strings.TrimSpace(host), "[]") + if strings.EqualFold(host, "localhost") { + return true + } + ip := net.ParseIP(host) + return ip != nil && ip.IsLoopback() } func (s *Server) Shutdown(ctx context.Context) error { @@ -302,6 +382,10 @@ func (s *Server) deleteDomain(c *gin.Context) { } func (s *Server) issueDomain(c *gin.Context) { + if s.tasks != nil { + s.issueDomainAsTask(c) + return + } if s.issueCertificate == nil { s.writeError(c, http.StatusNotImplemented, "证书申请接口尚未配置", errors.New("证书申请工作流未配置")) return diff --git a/backend/internal/httpapi/server_test.go b/backend/internal/httpapi/server_test.go index a150d2d..2a1532a 100644 --- a/backend/internal/httpapi/server_test.go +++ b/backend/internal/httpapi/server_test.go @@ -18,6 +18,7 @@ import ( "git.pcux.cn/xuans/Scert/backend/internal/config" "git.pcux.cn/xuans/Scert/backend/internal/database" "git.pcux.cn/xuans/Scert/backend/internal/deployment" + "git.pcux.cn/xuans/Scert/backend/internal/domain" "git.pcux.cn/xuans/Scert/backend/internal/logging" "git.pcux.cn/xuans/Scert/backend/internal/repository" "git.pcux.cn/xuans/Scert/backend/internal/secretstore" @@ -471,3 +472,96 @@ func resetForm(code, csrfToken, password string) url.Values { "confirm_password": {password}, } } + +func TestListenAddressKeepsDirectModeBinding(t *testing.T) { + cfg := config.Default(t.TempDir()) + cfg.Server.Host = "0.0.0.0" + cfg.Server.Port = 5200 + cfg.Server.HTTPSMode = "direct" + address, err := listenAddress(cfg) + if err != nil { + t.Fatalf("直接 HTTPS 模式监听地址生成失败:%v", err) + } + if address != "0.0.0.0:5200" { + t.Fatalf("直接 HTTPS 模式应保留配置监听地址:%s", address) + } +} + +func TestListenAddressRestrictsProxyModeToLoopback(t *testing.T) { + cfg := config.Default(t.TempDir()) + cfg.Server.Host = "0.0.0.0" + cfg.Server.Port = 5201 + cfg.Server.HTTPSMode = "proxy" + address, err := listenAddress(cfg) + if err != nil { + t.Fatalf("高级 HTTPS 模式监听地址生成失败:%v", err) + } + if address != "127.0.0.1:5201" { + t.Fatalf("高级 HTTPS 模式必须绑定本机回环地址:%s", address) + } + + cfg.Server.Host = "192.168.2.3" + address, err = listenAddress(cfg) + if err != nil { + t.Fatalf("高级 HTTPS 模式公网地址校正失败:%v", err) + } + if address != "127.0.0.1:5201" { + t.Fatalf("高级 HTTPS 模式不得绑定局域网地址:%s", address) + } +} + +func TestListenAddressAllowsLoopbackProxyBinding(t *testing.T) { + cfg := config.Default(t.TempDir()) + cfg.Server.Host = "[::1]" + cfg.Server.Port = 5202 + cfg.Server.HTTPSMode = "proxy" + address, err := listenAddress(cfg) + if err != nil { + t.Fatalf("回环 HTTPS 模式监听地址生成失败:%v", err) + } + if address != "[::1]:5202" { + t.Fatalf("已配置 IPv6 回环地址时不应被替换:%s", address) + } +} + +func TestForwardedHTTPSIsTrustedOnlyInProxyMode(t *testing.T) { + direct := config.Default(t.TempDir()) + direct.Server.HTTPSMode = "direct" + directServer := New(Dependencies{Config: direct, Repository: &stubDomainRepository{}}) + directRequest := httptest.NewRequest(http.MethodGet, "http://scert.example.test/healthz", nil) + directRequest.Header.Set("X-Forwarded-Proto", "https") + if directServer.requestIsHTTPS(directRequest) { + t.Fatal("直接 HTTPS 模式不应信任外部伪造的 X-Forwarded-Proto") + } + + proxy := config.Default(t.TempDir()) + proxy.Server.HTTPSMode = "proxy" + proxyServer := New(Dependencies{Config: proxy, Repository: &stubDomainRepository{}}) + proxyRequest := httptest.NewRequest(http.MethodGet, "http://127.0.0.1:5200/healthz", nil) + proxyRequest.Header.Set("X-Forwarded-Proto", "https, http") + if !proxyServer.requestIsHTTPS(proxyRequest) { + t.Fatal("高级 HTTPS 模式应识别可信反向代理传入的 HTTPS 协议") + } +} + +func TestProxyModeAcceptsHTTPSSameOrigin(t *testing.T) { + cfg := config.Default(t.TempDir()) + cfg.SetupReady = true + cfg.Server.HTTPSMode = "proxy" + cfg.Admin.Username = "admin" + cfg.Admin.Email = "admin@example.com" + hash, err := bcrypt.GenerateFromPassword([]byte("Password123"), bcrypt.MinCost) + if err != nil { + t.Fatalf("生成测试密码摘要失败:%v", err) + } + cfg.Admin.PasswordHash = string(hash) + server := New(Dependencies{Config: cfg, Repository: &stubDomainRepository{items: []domain.Domain{}}}) + + request := httptest.NewRequest(http.MethodGet, "http://127.0.0.1:5200/api/v1/domains", nil) + request.Host = "scert.example.test" + request.Header.Set("Origin", "https://scert.example.test") + request.Header.Set("X-Forwarded-Proto", "https") + if !server.sameOriginForAPI(request) { + t.Fatal("高级 HTTPS 模式应接受反向代理后的同源 HTTPS 请求") + } +} diff --git a/backend/internal/httpapi/setup.go b/backend/internal/httpapi/setup.go index 23f9d34..07d46ea 100644 --- a/backend/internal/httpapi/setup.go +++ b/backend/internal/httpapi/setup.go @@ -6,11 +6,13 @@ import ( "fmt" "net" "net/http" + "os" "strings" "time" "github.com/gin-gonic/gin" + "git.pcux.cn/xuans/Scert/backend/internal/certificate" "git.pcux.cn/xuans/Scert/backend/internal/dnsprovider" "git.pcux.cn/xuans/Scert/backend/internal/firewall" "git.pcux.cn/xuans/Scert/backend/internal/setup" @@ -25,22 +27,37 @@ type setupDNSVerifier interface { } type setupRequest struct { - AdminUsername string `json:"admin_username"` - AdminEmail string `json:"admin_email"` - AdminPassword string `json:"admin_password"` - ServerPort int `json:"server_port"` - EmailProvider string `json:"email_provider"` - EmailEndpoint string `json:"email_endpoint"` - Recipients []string `json:"recipients"` - DNSProvider string `json:"dns_provider"` - DNSCredentialRef string `json:"dns_credential_ref"` - DNSVerificationToken string `json:"dns_verification_token"` - DNSTestDomain string `json:"dns_test_domain"` - CertificateRoot string `json:"certificate_root"` - WebHostname string `json:"web_hostname"` - WebPublicIP string `json:"web_public_ip"` - WebEnabled *bool `json:"web_enabled"` - HTTPSMode string `json:"https_mode"` + AdminUsername string `json:"admin_username"` + AdminEmail string `json:"admin_email"` + AdminPassword string `json:"admin_password"` + ServerPort int `json:"server_port"` + EmailHTTPEnabled *bool `json:"email_http_enabled"` + EmailProvider string `json:"email_provider"` + EmailEndpoint string `json:"email_endpoint"` + EmailHTTPPath string `json:"email_http_path"` + EmailHTTPLoginPath string `json:"email_http_login_path"` + EmailHTTPAuthMode string `json:"email_http_auth_mode"` + EmailHTTPCredentialRef string `json:"email_http_credential_ref"` + EmailHTTPHeaders map[string]string `json:"email_http_headers"` + EmailEventMode string `json:"email_event_mode"` + EmailIncludeDeploymentDetails bool `json:"email_include_deployment_details"` + EmailIncludeCertificateSerial bool `json:"email_include_certificate_serial"` + EmailIncludeManagementURL bool `json:"email_include_management_url"` + EmailSenderName string `json:"email_sender_name"` + EmailSenderEmail string `json:"email_sender_email"` + Recipients []string `json:"recipients"` + EmailTimeoutSecs int `json:"email_timeout_secs"` + EmailRetryCount int `json:"email_retry_count"` + EmailRetryIntervalsSecs []int `json:"email_retry_intervals_secs"` + DNSProvider string `json:"dns_provider"` + DNSCredentialRef string `json:"dns_credential_ref"` + DNSVerificationToken string `json:"dns_verification_token"` + DNSTestDomain string `json:"dns_test_domain"` + CertificateRoot string `json:"certificate_root"` + WebHostname string `json:"web_hostname"` + WebPublicIP string `json:"web_public_ip"` + WebEnabled *bool `json:"web_enabled"` + HTTPSMode string `json:"https_mode"` } type dnsTestRequest struct { @@ -169,23 +186,42 @@ func (s *Server) applySetup(c *gin.Context) { if request.WebEnabled != nil { webEnabled = *request.WebEnabled } + emailHTTPEnabled := false + if request.EmailHTTPEnabled != nil { + emailHTTPEnabled = *request.EmailHTTPEnabled + } updated := s.config err := setup.Apply(&updated, setup.Input{ - AdminUsername: request.AdminUsername, - AdminEmail: request.AdminEmail, - AdminPassword: request.AdminPassword, - ServerPort: request.ServerPort, - EmailProvider: request.EmailProvider, - EmailEndpoint: request.EmailEndpoint, - EmailRecipients: request.Recipients, - DNSProvider: request.DNSProvider, - DNSCredentialRef: request.DNSCredentialRef, - DNSVerified: true, - CertificateRoot: request.CertificateRoot, - WebHostname: request.WebHostname, - WebPublicIP: request.WebPublicIP, - WebEnabled: webEnabled, - HTTPSMode: request.HTTPSMode, + AdminUsername: request.AdminUsername, + AdminEmail: request.AdminEmail, + AdminPassword: request.AdminPassword, + ServerPort: request.ServerPort, + EmailHTTPEnabled: emailHTTPEnabled, + EmailProvider: request.EmailProvider, + EmailEndpoint: request.EmailEndpoint, + EmailHTTPPath: request.EmailHTTPPath, + EmailHTTPLoginPath: request.EmailHTTPLoginPath, + EmailHTTPAuthMode: request.EmailHTTPAuthMode, + EmailHTTPCredentialRef: request.EmailHTTPCredentialRef, + EmailHTTPHeaders: request.EmailHTTPHeaders, + EmailEventMode: request.EmailEventMode, + EmailIncludeDeploymentDetails: request.EmailIncludeDeploymentDetails, + EmailIncludeCertificateSerial: request.EmailIncludeCertificateSerial, + EmailIncludeManagementURL: request.EmailIncludeManagementURL, + EmailSenderName: request.EmailSenderName, + EmailSenderEmail: request.EmailSenderEmail, + EmailRecipients: request.Recipients, + EmailTimeoutSecs: request.EmailTimeoutSecs, + EmailRetryCount: request.EmailRetryCount, + EmailRetryIntervalsSecs: request.EmailRetryIntervalsSecs, + DNSProvider: request.DNSProvider, + DNSCredentialRef: request.DNSCredentialRef, + DNSVerified: true, + CertificateRoot: request.CertificateRoot, + WebHostname: request.WebHostname, + WebPublicIP: request.WebPublicIP, + WebEnabled: webEnabled, + HTTPSMode: request.HTTPSMode, }) if err != nil { s.writeError(c, http.StatusBadRequest, err.Error(), err) @@ -195,6 +231,48 @@ func (s *Server) applySetup(c *gin.Context) { s.writeError(c, http.StatusInternalServerError, "服务未配置配置文件路径,无法保存初始化结果", nil) return } + if strings.TrimSpace(updated.Web.PublicIP) != "" { + s.writeError(c, http.StatusBadRequest, "公网 IP 暂不支持通过 DNS-01 自动申请管理后台证书,请先配置域名或上传自有证书", nil) + return + } + if s.issueSetupCertificate == nil { + s.writeError(c, http.StatusServiceUnavailable, "初始化证书申请服务尚未配置", nil) + return + } + updated.SetupReady = false + certificateContext, certificateCancel := context.WithTimeout(c.Request.Context(), 10*time.Minute) + savedCertificate, certificateErr := s.issueSetupCertificate(certificateContext, certificate.SetupCertificateRequest{ + Domains: []string{updated.Web.Hostname}, + CertificateType: "single", + ProviderID: updated.DNS.Provider, + CredentialRef: updated.DNS.CredentialRef, + AccountEmail: updated.Admin.Email, + Environment: updated.ACME.Environment, + CertificateRoot: updated.Paths.Certificate, + BackupRoot: updated.Paths.Backup, + }) + certificateCancel() + if certificateErr != nil { + s.writeError(c, http.StatusBadGateway, "申请管理后台证书失败,初始化尚未完成", certificateErr) + return + } + if err := validateSetupCertificateFiles(savedCertificate); err != nil { + if rollbackErr := s.rollbackIssuedSetupCertificate(savedCertificate); rollbackErr != nil && s.logger != nil { + s.logger.Error("管理后台证书文件校验失败,且证书回滚失败", "error", rollbackErr) + } + s.writeError(c, http.StatusInternalServerError, "管理后台证书文件校验失败:初始化尚未完成", err) + return + } + updated.Server.TLSCert = savedCertificate.FullChainPath + updated.Server.TLSKey = savedCertificate.PrivateKeyPath + updated.SetupReady = true + if err := updated.Validate(); err != nil { + if rollbackErr := s.rollbackIssuedSetupCertificate(savedCertificate); rollbackErr != nil && s.logger != nil { + s.logger.Error("初始化证书配置无效,且证书回滚失败", "error", rollbackErr) + } + s.writeError(c, http.StatusInternalServerError, "初始化证书配置无效:初始化尚未完成", err) + return + } firewallResult := firewall.Result{ Backend: firewall.BackendNone, Port: updated.Server.Port, Message: "未配置防火墙管理器,已跳过本机规则创建", @@ -204,23 +282,35 @@ func (s *Server) applySetup(c *gin.Context) { firewallResult, err = s.firewall.OpenTCP(firewallContext, updated.Server.Port) cancel() if err != nil { + if rollbackErr := s.rollbackIssuedSetupCertificate(savedCertificate); rollbackErr != nil && s.logger != nil { + s.logger.Error("自动配置本机防火墙失败,且证书回滚失败", "error", rollbackErr) + } s.writeError(c, http.StatusInternalServerError, "自动配置本机防火墙失败,请使用管理员权限重新运行初始化程序", err) return } } if err := updated.Save(s.configPath); err != nil { + firewallRollbackErr := error(nil) if firewallResult.Created && s.firewall != nil { rollbackContext, cancel := context.WithTimeout(context.Background(), 30*time.Second) - rollbackErr := s.firewall.Rollback(rollbackContext, firewallResult) + firewallRollbackErr = s.firewall.Rollback(rollbackContext, firewallResult) cancel() - if rollbackErr != nil { - if s.logger != nil { - s.logger.Error("保存初始化配置失败,且回滚本机防火墙规则失败", "error", rollbackErr, "rule", firewallResult.RuleName) - } - s.writeError(c, http.StatusInternalServerError, "保存初始化配置失败,且自动创建的防火墙规则回滚失败,请手动检查本机防火墙", err) - return + if firewallRollbackErr != nil && s.logger != nil { + s.logger.Error("保存初始化配置失败,且回滚本机防火墙规则失败", "error", firewallRollbackErr, "rule", firewallResult.RuleName) } } + certificateRollbackErr := s.rollbackIssuedSetupCertificate(savedCertificate) + if certificateRollbackErr != nil && s.logger != nil { + s.logger.Error("保存初始化配置失败,且初始化证书回滚失败", "error", certificateRollbackErr) + } + if firewallRollbackErr != nil { + s.writeError(c, http.StatusInternalServerError, "保存初始化配置失败,且自动创建的防火墙规则回滚失败,请手动检查本机防火墙", err) + return + } + if certificateRollbackErr != nil { + s.writeError(c, http.StatusInternalServerError, "保存初始化配置失败,且管理后台证书回滚失败,请手动检查证书目录", err) + return + } s.writeError(c, http.StatusInternalServerError, "保存初始化配置失败", err) return } @@ -231,7 +321,7 @@ func (s *Server) applySetup(c *gin.Context) { c.JSON(http.StatusOK, gin.H{ "initialized": true, "message": fmt.Sprintf( - "初始化配置已保存,DNS API 已完成在线验证且凭据已加密保存。%s。请确认云安全组已放行主服务端口 %d;Scert-admin 默认关闭,启动后通过 %s 使用临时重置入口。证书申请和 HTTPS 切换将在后续任务中完成。", + "初始化配置已保存,DNS API 已完成在线验证且凭据已加密保存。%s。请确认云安全组已放行主服务端口 %d;Scert-admin 默认关闭,启动后通过 %s 使用临时重置入口。管理后台证书申请成功。", firewallResult.Message, updated.Server.Port, updated.ResetURL(), ), "status": gin.H{ @@ -244,6 +334,33 @@ func (s *Server) applySetup(c *gin.Context) { }) } +func (s *Server) rollbackIssuedSetupCertificate(saved certificate.SavedResource) error { + if s.rollbackSetupCertificate == nil { + return nil + } + ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second) + defer cancel() + return s.rollbackSetupCertificate(ctx, saved) +} +func validateSetupCertificateFiles(saved certificate.SavedResource) error { + for label, path := range map[string]string{ + "完整证书链": saved.FullChainPath, + "私钥": saved.PrivateKeyPath, + } { + if strings.TrimSpace(path) == "" { + return fmt.Errorf("%s路径为空", label) + } + info, err := os.Stat(path) + if err != nil { + return fmt.Errorf("读取%s失败:%w", label, err) + } + if !info.Mode().IsRegular() { + return fmt.Errorf("%s不是普通文件", label) + } + } + return nil +} + func (s *Server) allowSetupRequest(c *gin.Context) bool { s.configMu.RLock() initialized := s.config.SetupReady diff --git a/backend/internal/httpapi/setup_test.go b/backend/internal/httpapi/setup_test.go index 0c58d67..a68bd63 100644 --- a/backend/internal/httpapi/setup_test.go +++ b/backend/internal/httpapi/setup_test.go @@ -12,6 +12,7 @@ import ( "testing" "time" + "git.pcux.cn/xuans/Scert/backend/internal/certificate" "git.pcux.cn/xuans/Scert/backend/internal/config" "git.pcux.cn/xuans/Scert/backend/internal/dnsprovider" "git.pcux.cn/xuans/Scert/backend/internal/firewall" @@ -35,6 +36,31 @@ type fakeFirewallManager struct { rollbackCall bool } +type setupCertificateIssuer func(context.Context, certificate.SetupCertificateRequest) (certificate.SavedResource, error) + +func newSetupCertificateIssuer(t *testing.T, baseDir string, issueErr error) setupCertificateIssuer { + t.Helper() + if issueErr != nil { + return func(context.Context, certificate.SetupCertificateRequest) (certificate.SavedResource, error) { + return certificate.SavedResource{}, issueErr + } + } + fullChainPath := filepath.Join(baseDir, "fullchain.pem") + privateKeyPath := filepath.Join(baseDir, "key.pem") + if err := os.WriteFile(fullChainPath, []byte("test certificate"), 0o644); err != nil { + t.Fatalf("创建测试文件失败:%v", err) + } + if err := os.WriteFile(privateKeyPath, []byte("test private key"), 0o600); err != nil { + t.Fatalf("创建测试文件失败:%v", err) + } + return func(context.Context, certificate.SetupCertificateRequest) (certificate.SavedResource, error) { + return certificate.SavedResource{ + FullChainPath: fullChainPath, + PrivateKeyPath: privateKeyPath, + }, nil + } +} + func (f *fakeFirewallManager) OpenTCP(_ context.Context, port int) (firewall.Result, error) { f.openedPort = port if f.result.Port == 0 { @@ -146,6 +172,7 @@ func TestSetupApplyPersistsConfigurationWithoutPlainPassword(t *testing.T) { server := New(Dependencies{ Config: cfg, ConfigPath: configPath, Repository: &stubDomainRepository{}, SetupDNS: verifier, Firewall: firewallManager, + IssueSetupCertificate: newSetupCertificateIssuer(t, baseDir, nil), }) payload := `{ "admin_username":"root-admin", @@ -317,6 +344,7 @@ func TestSetupSaveFailureDoesNotConsumeDNSToken(t *testing.T) { server := New(Dependencies{ Config: config.Default(baseDir), ConfigPath: filepath.Join(blockedParent, "scert.json"), Repository: &stubDomainRepository{}, SetupDNS: verifier, Firewall: firewallManager, + IssueSetupCertificate: newSetupCertificateIssuer(t, baseDir, nil), }) request := httptest.NewRequest(http.MethodPost, "/api/v1/setup", strings.NewReader(setupPayload(baseDir, "secure-pass-123"))) request.RemoteAddr = "127.0.0.1:53000" @@ -346,6 +374,7 @@ func TestSetupSaveFailureKeepsExistingFirewallRule(t *testing.T) { server := New(Dependencies{ Config: config.Default(baseDir), ConfigPath: filepath.Join(blockedParent, "scert.json"), Repository: &stubDomainRepository{}, SetupDNS: &fakeSetupDNSVerifier{}, Firewall: firewallManager, + IssueSetupCertificate: newSetupCertificateIssuer(t, baseDir, nil), }) request := httptest.NewRequest(http.MethodPost, "/api/v1/setup", strings.NewReader(setupPayload(baseDir, "secure-pass-123"))) request.RemoteAddr = "127.0.0.1:53000" @@ -368,6 +397,7 @@ func TestSetupFirewallFailureDoesNotSaveOrConsumeToken(t *testing.T) { server := New(Dependencies{ Config: config.Default(baseDir), ConfigPath: configPath, Repository: &stubDomainRepository{}, SetupDNS: verifier, Firewall: firewallManager, + IssueSetupCertificate: newSetupCertificateIssuer(t, baseDir, nil), }) request := httptest.NewRequest(http.MethodPost, "/api/v1/setup", strings.NewReader(setupPayload(baseDir, "secure-pass-123"))) request.RemoteAddr = "127.0.0.1:53000" @@ -401,3 +431,114 @@ func setupPayload(baseDir, password string) string { "https_mode":"direct" }` } + +func TestSetupCertificateFailureDoesNotSaveOrConsumeDNSToken(t *testing.T) { + baseDir := t.TempDir() + configPath := filepath.Join(baseDir, "config", "scert.json") + verifier := &fakeSetupDNSVerifier{} + server := New(Dependencies{ + Config: config.Default(baseDir), ConfigPath: configPath, + Repository: &stubDomainRepository{}, SetupDNS: verifier, + IssueSetupCertificate: newSetupCertificateIssuer(t, baseDir, errors.New("模拟证书申请失败")), + }) + request := httptest.NewRequest(http.MethodPost, "/api/v1/setup", strings.NewReader(setupPayload(baseDir, "secure-pass-123"))) + request.RemoteAddr = "127.0.0.1:53000" + request.Header.Set("Content-Type", "application/json") + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, request) + if response.Code != http.StatusBadGateway || !strings.Contains(response.Body.String(), "申请管理后台证书失败") { + t.Fatalf("证书申请失败应返回明确错误:%d %s", response.Code, response.Body.String()) + } + if !verifier.checked || verifier.consumed { + t.Fatalf("证书申请失败时应检查但不消费 DNS 令牌:checked=%t consumed=%t", verifier.checked, verifier.consumed) + } + if _, err := os.Stat(configPath); !errors.Is(err, os.ErrNotExist) { + t.Fatalf("证书申请失败时不得保存初始化配置:%v", err) + } +} + +func TestSetupCertificateFileValidationDoesNotSaveOrConsumeDNSToken(t *testing.T) { + baseDir := t.TempDir() + configPath := filepath.Join(baseDir, "config", "scert.json") + verifier := &fakeSetupDNSVerifier{} + issuer := func(context.Context, certificate.SetupCertificateRequest) (certificate.SavedResource, error) { + return certificate.SavedResource{ + FullChainPath: filepath.Join(baseDir, "missing-fullchain.pem"), + PrivateKeyPath: filepath.Join(baseDir, "missing-key.pem"), + }, nil + } + server := New(Dependencies{ + Config: config.Default(baseDir), ConfigPath: configPath, + Repository: &stubDomainRepository{}, SetupDNS: verifier, + IssueSetupCertificate: issuer, + }) + request := httptest.NewRequest(http.MethodPost, "/api/v1/setup", strings.NewReader(setupPayload(baseDir, "secure-pass-123"))) + request.RemoteAddr = "127.0.0.1:53000" + request.Header.Set("Content-Type", "application/json") + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, request) + if response.Code != http.StatusInternalServerError || !strings.Contains(response.Body.String(), "管理后台证书文件校验失败") { + t.Fatalf("证书文件校验失败应返回明确错误:%d %s", response.Code, response.Body.String()) + } + if verifier.consumed { + t.Fatal("证书文件校验失败时不得消费 DNS 令牌") + } + if _, err := os.Stat(configPath); !errors.Is(err, os.ErrNotExist) { + t.Fatalf("证书文件校验失败时不得保存初始化配置:%v", err) + } +} + +func TestSetupWithPublicIPRejectsDNSAutomaticCertificate(t *testing.T) { + baseDir := t.TempDir() + configPath := filepath.Join(baseDir, "config", "scert.json") + verifier := &fakeSetupDNSVerifier{} + server := New(Dependencies{ + Config: config.Default(baseDir), ConfigPath: configPath, + Repository: &stubDomainRepository{}, SetupDNS: verifier, + IssueSetupCertificate: newSetupCertificateIssuer(t, baseDir, nil), + }) + payload := strings.Replace(setupPayload(baseDir, "secure-pass-123"), + `"web_hostname":"scert.example.test",`, + `"web_hostname":"","web_public_ip":"192.0.2.10",`, 1) + request := httptest.NewRequest(http.MethodPost, "/api/v1/setup", strings.NewReader(payload)) + request.RemoteAddr = "127.0.0.1:53000" + request.Header.Set("Content-Type", "application/json") + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, request) + if response.Code != http.StatusBadRequest || !strings.Contains(response.Body.String(), "公网 IP 暂不支持") { + t.Fatalf("公网 IP 自动申请应被拒绝:%d %s", response.Code, response.Body.String()) + } + if verifier.consumed { + t.Fatal("公网 IP 场景不得消费 DNS 令牌") + } + if _, err := os.Stat(configPath); !errors.Is(err, os.ErrNotExist) { + t.Fatalf("公网 IP 场景不得保存初始化配置:%v", err) + } +} + +func TestSetupFirewallFailureRollsBackIssuedCertificate(t *testing.T) { + baseDir := t.TempDir() + verifier := &fakeSetupDNSVerifier{} + firewallManager := &fakeFirewallManager{openErr: errors.New("access denied")} + rolledBack := false + server := New(Dependencies{ + Config: config.Default(baseDir), ConfigPath: filepath.Join(baseDir, "config", "scert.json"), + Repository: &stubDomainRepository{}, SetupDNS: verifier, Firewall: firewallManager, + IssueSetupCertificate: newSetupCertificateIssuer(t, baseDir, nil), + RollbackSetupCertificate: func(_ context.Context, saved certificate.SavedResource) error { + rolledBack = true + return certificate.RollbackSavedResource(context.Background(), saved) + }, + }) + request := httptest.NewRequest(http.MethodPost, "/api/v1/setup", strings.NewReader(setupPayload(baseDir, "secure-pass-123"))) + request.RemoteAddr = "127.0.0.1:53000" + request.Header.Set("Content-Type", "application/json") + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, request) + if response.Code != http.StatusInternalServerError { + t.Fatalf("防火墙失败应返回服务器错误:%d %s", response.Code, response.Body.String()) + } + if !rolledBack { + t.Fatal("防火墙配置失败时应回滚已保存的初始化证书") + } +} diff --git a/backend/internal/httpapi/task_api.go b/backend/internal/httpapi/task_api.go new file mode 100644 index 0000000..bbfbbb1 --- /dev/null +++ b/backend/internal/httpapi/task_api.go @@ -0,0 +1,183 @@ +package httpapi + +import ( + "context" + "database/sql" + "errors" + "net/http" + "strconv" + "strings" + "time" + + "github.com/gin-gonic/gin" + + "git.pcux.cn/xuans/Scert/backend/internal/domain" + "git.pcux.cn/xuans/Scert/backend/internal/repository" +) + +func (s *Server) issueDomainAsTask(c *gin.Context) { + if s.issueCertificate == nil { + s.writeError(c, http.StatusNotImplemented, "证书申请接口尚未配置", errors.New("证书申请工作流未配置")) + return + } + domainID := strings.TrimSpace(c.Param("id")) + if _, err := s.repository.GetByID(c.Request.Context(), domainID); err != nil { + if repository.IsNotFound(err) { + s.writeError(c, http.StatusNotFound, "域名不存在", err) + return + } + s.writeError(c, http.StatusInternalServerError, "读取域名失败", err) + return + } + if active, err := s.tasks.FindActiveTaskByDomain(c.Request.Context(), domainID, "certificate_issue"); err == nil { + c.JSON(http.StatusConflict, gin.H{"error": "该域名已有正在执行的证书任务", "task": active}) + return + } else if !errors.Is(err, sql.ErrNoRows) { + s.writeError(c, http.StatusInternalServerError, "检查正在执行的任务失败", err) + return + } + now := time.Now().UTC() + task := repository.Task{ + ID: domain.NewID(), + DomainID: domainID, + TaskType: "certificate_issue", + Status: "queued", + Stage: "queued", + Message: "等待执行证书申请", + CreatedAt: now, + UpdatedAt: now, + } + if err := s.tasks.CreateTask(c.Request.Context(), task); err != nil { + s.writeError(c, http.StatusInternalServerError, "创建证书任务失败", err) + return + } + attempt := repository.TaskAttempt{ + ID: domain.NewID(), + TaskID: task.ID, + AttemptNumber: 1, + Stage: "certificate_issue", + Status: "running", + Message: "开始申请证书", + StartedAt: &now, + CreatedAt: now, + } + if err := s.tasks.CreateAttempt(c.Request.Context(), attempt); err != nil { + _ = s.tasks.UpdateTask(context.Background(), task.ID, "failed", "certificate_issue", "创建任务尝试失败", &now, &now) + s.writeError(c, http.StatusInternalServerError, "创建任务尝试失败", err) + return + } + if err := s.tasks.UpdateTask(c.Request.Context(), task.ID, "running", "certificate_issue", "正在申请证书并部署", &now, nil); err != nil { + s.writeError(c, http.StatusInternalServerError, "更新任务状态失败", err) + return + } + certificateResult, deploymentReport, issueErr := s.issueCertificate(c.Request.Context(), domainID) + finished := time.Now().UTC() + status := "success" + message := "证书申请和部署完成" + if issueErr != nil { + status = "failed" + message = issueErr.Error() + } + _ = s.tasks.UpdateTask(context.Background(), task.ID, status, "certificate_issue", message, &now, &finished) + _ = s.tasks.FinishAttempt(context.Background(), attempt.ID, status, message, &finished) + if s.audit != nil { + auditStatus := status + if issueErr != nil { + auditStatus = "error" + } + _ = s.audit.CreateAuditLog(context.Background(), repository.AuditLog{ + Action: "certificate_issue", + ResourceType: "domain", + ResourceID: domainID, + Status: auditStatus, + Message: message, + }) + } + response := gin.H{ + "task": task, + "certificate": certificateResult, + "deployment": deploymentReport, + "task_status": status, + "finished_at": finished, + } + if issueErr != nil { + response["error"] = issueErr.Error() + c.JSON(http.StatusBadGateway, response) + return + } + task.Status = status + task.Stage = "certificate_issue" + task.Message = message + task.StartedAt = &now + task.FinishedAt = &finished + task.UpdatedAt = finished + response["task"] = task + c.JSON(http.StatusOK, response) +} + +func (s *Server) listTasks(c *gin.Context) { + if s.tasks == nil { + s.writeError(c, http.StatusNotImplemented, "任务管理接口尚未配置", errors.New("任务仓储未配置")) + return + } + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "50")) + items, err := s.tasks.ListTasks(c.Request.Context(), c.Query("domain_id"), limit) + if err != nil { + s.writeError(c, http.StatusInternalServerError, "查询任务失败", err) + return + } + c.JSON(http.StatusOK, gin.H{"items": items}) +} + +func (s *Server) getTask(c *gin.Context) { + if s.tasks == nil { + s.writeError(c, http.StatusNotImplemented, "任务管理接口尚未配置", errors.New("任务仓储未配置")) + return + } + item, err := s.tasks.GetTask(c.Request.Context(), c.Param("id")) + if err != nil { + if errors.Is(err, sql.ErrNoRows) { + s.writeError(c, http.StatusNotFound, "任务不存在", err) + return + } + s.writeError(c, http.StatusInternalServerError, "读取任务失败", err) + return + } + c.JSON(http.StatusOK, item) +} + +func (s *Server) listTaskAttempts(c *gin.Context) { + if s.tasks == nil { + s.writeError(c, http.StatusNotImplemented, "任务管理接口尚未配置", errors.New("任务仓储未配置")) + return + } + if _, err := s.tasks.GetTask(c.Request.Context(), c.Param("id")); err != nil { + if errors.Is(err, sql.ErrNoRows) { + s.writeError(c, http.StatusNotFound, "任务不存在", err) + return + } + s.writeError(c, http.StatusInternalServerError, "读取任务失败", err) + return + } + items, err := s.tasks.ListAttempts(c.Request.Context(), c.Param("id")) + if err != nil { + s.writeError(c, http.StatusInternalServerError, "查询任务尝试失败", err) + return + } + c.JSON(http.StatusOK, gin.H{"items": items}) +} + +func (s *Server) listAuditLogs(c *gin.Context) { + reader, ok := s.audit.(repository.AuditReader) + if !ok { + s.writeError(c, http.StatusNotImplemented, "审计日志查询接口尚未配置", errors.New("审计日志读取服务未配置")) + return + } + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "50")) + items, err := reader.ListAuditLogs(c.Request.Context(), limit) + if err != nil { + s.writeError(c, http.StatusInternalServerError, "查询审计日志失败", err) + return + } + c.JSON(http.StatusOK, gin.H{"items": items}) +} diff --git a/backend/internal/httpapi/task_api_test.go b/backend/internal/httpapi/task_api_test.go new file mode 100644 index 0000000..e9e083f --- /dev/null +++ b/backend/internal/httpapi/task_api_test.go @@ -0,0 +1,131 @@ +package httpapi + +import ( + "context" + "errors" + "net/http" + "net/http/httptest" + "strings" + "testing" + + "git.pcux.cn/xuans/Scert/backend/internal/certificate" + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/database" + "git.pcux.cn/xuans/Scert/backend/internal/deployment" + "git.pcux.cn/xuans/Scert/backend/internal/domain" + "git.pcux.cn/xuans/Scert/backend/internal/repository" +) + +func newTaskAPITestServer(t *testing.T, issue func(context.Context, string) (certificate.IssueResult, deployment.Report, error)) (*Server, *repository.SQLTaskRepository, *repository.SQLAuditRepository, func()) { + t.Helper() + cfg := config.Default(t.TempDir()) + db, err := database.Open(context.Background(), cfg.Database) + if err != nil { + t.Fatalf("打开测试数据库失败:%v", err) + } + if err := database.Migrate(context.Background(), db.DB, cfg.Database.Driver); err != nil { + db.Close() + t.Fatalf("迁移测试数据库失败:%v", err) + } + domainRepo := repository.NewSQLDomainRepository(db.DB) + taskRepo := repository.NewSQLTaskRepository(db.DB) + auditRepo := repository.NewSQLAuditRepository(db.DB) + item, err := domain.NewDomain("example.com", domain.CertificateSingle, nil) + item.ID = "domain-1" + if err != nil { + db.Close() + t.Fatal(err) + } + if err := domainRepo.Create(context.Background(), item); err != nil { + db.Close() + t.Fatalf("创建测试域名失败:%v", err) + } + server := New(Dependencies{ + Config: cfg, + Repository: domainRepo, + IssueCertificate: issue, + Tasks: taskRepo, + Audit: auditRepo, + }) + return server, taskRepo, auditRepo, func() { _ = db.Close() } +} + +func TestTaskAPIRecordsSuccessfulIssueAndAudit(t *testing.T) { + server, taskRepo, auditRepo, closeDB := newTaskAPITestServer(t, func(_ context.Context, id string) (certificate.IssueResult, deployment.Report, error) { + return certificate.IssueResult{DomainID: id}, deployment.Report{Status: "success"}, nil + }) + defer closeDB() + + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, httptest.NewRequest(http.MethodPost, "/api/v1/domains/domain-1/issue", nil)) + if response.Code != http.StatusOK { + t.Fatalf("成功任务响应错误:%d %s", response.Code, response.Body.String()) + } + items, err := taskRepo.ListTasks(context.Background(), "", 10) + if err != nil || len(items) != 1 || items[0].Status != "success" { + t.Fatalf("任务没有进入成功状态:%+v %v", items, err) + } + attempts, err := taskRepo.ListAttempts(context.Background(), items[0].ID) + if err != nil || len(attempts) != 1 || attempts[0].Status != "success" { + t.Fatalf("任务尝试记录错误:%+v %v", attempts, err) + } + logs, err := auditRepo.ListAuditLogs(context.Background(), 10) + if err != nil || len(logs) != 1 || logs[0].Status != "success" { + t.Fatalf("审计日志记录错误:%+v %v", logs, err) + } + + list := httptest.NewRecorder() + server.Handler().ServeHTTP(list, httptest.NewRequest(http.MethodGet, "/api/v1/tasks?limit=10", nil)) + if list.Code != http.StatusOK || !strings.Contains(list.Body.String(), items[0].ID) { + t.Fatalf("任务列表响应错误:%d %s", list.Code, list.Body.String()) + } + + detail := httptest.NewRecorder() + server.Handler().ServeHTTP(detail, httptest.NewRequest(http.MethodGet, "/api/v1/tasks/"+items[0].ID, nil)) + if detail.Code != http.StatusOK || !strings.Contains(detail.Body.String(), "success") { + t.Fatalf("任务详情响应错误:%d %s", detail.Code, detail.Body.String()) + } + + attemptList := httptest.NewRecorder() + server.Handler().ServeHTTP(attemptList, httptest.NewRequest(http.MethodGet, "/api/v1/tasks/"+items[0].ID+"/attempts", nil)) + if attemptList.Code != http.StatusOK || !strings.Contains(attemptList.Body.String(), "certificate_issue") { + t.Fatalf("任务尝试接口响应错误:%d %s", attemptList.Code, attemptList.Body.String()) + } + + logList := httptest.NewRecorder() + server.Handler().ServeHTTP(logList, httptest.NewRequest(http.MethodGet, "/api/v1/audit-logs?limit=10", nil)) + if logList.Code != http.StatusOK || !strings.Contains(logList.Body.String(), "certificate_issue") { + t.Fatalf("审计日志接口响应错误:%d %s", logList.Code, logList.Body.String()) + } +} + +func TestTaskAPIReturnsFailureAndKeepsTaskTrace(t *testing.T) { + server, taskRepo, auditRepo, closeDB := newTaskAPITestServer(t, func(context.Context, string) (certificate.IssueResult, deployment.Report, error) { + return certificate.IssueResult{}, deployment.Report{Status: "failed"}, errors.New("模拟证书申请失败") + }) + defer closeDB() + + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, httptest.NewRequest(http.MethodPost, "/api/v1/domains/domain-1/issue", nil)) + if response.Code != http.StatusBadGateway || !strings.Contains(response.Body.String(), "模拟证书申请失败") { + t.Fatalf("失败任务响应错误:%d %s", response.Code, response.Body.String()) + } + items, err := taskRepo.ListTasks(context.Background(), "", 10) + if err != nil || len(items) != 1 || items[0].Status != "failed" { + t.Fatalf("失败任务状态错误:%+v %v", items, err) + } + logs, err := auditRepo.ListAuditLogs(context.Background(), 10) + if err != nil || len(logs) != 1 || logs[0].Status != "error" { + t.Fatalf("失败审计状态错误:%+v %v", logs, err) + } +} + +func TestTaskAPIRejectsUnknownTask(t *testing.T) { + server, _, _, closeDB := newTaskAPITestServer(t, nil) + defer closeDB() + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, httptest.NewRequest(http.MethodGet, "/api/v1/tasks/unknown", nil)) + if response.Code != http.StatusNotFound { + t.Fatalf("未知任务应返回 404:%d %s", response.Code, response.Body.String()) + } +} diff --git a/backend/internal/notification/service.go b/backend/internal/notification/service.go new file mode 100644 index 0000000..67c5af6 --- /dev/null +++ b/backend/internal/notification/service.go @@ -0,0 +1,534 @@ +package notification + +import ( + "bytes" + "context" + "crypto/hmac" + "crypto/rand" + "crypto/sha256" + "encoding/hex" + "encoding/json" + "errors" + "fmt" + "html" + "io" + "net/http" + "net/mail" + "net/url" + "strconv" + "strings" + "time" + + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/deployment" +) + +// CredentialReader 读取加密凭据存储中的通知认证信息。 +type CredentialReader interface { + Get(context.Context, string) (map[string]string, error) +} + +// HTTPDoer 抽象 HTTP 客户端,便于测试重试、认证和响应处理。 +type HTTPDoer interface { + Do(*http.Request) (*http.Response, error) +} + +// Notifier 发送证书任务通知。 +type Notifier interface { + Send(context.Context, Event) error +} + +// Event 描述一次证书申请、续期、导入或部署任务。 +type Event struct { + Type string + Status string + DomainID string + Domain string + Domains []string + ExpiresAt *time.Time + CertificateSerial string + Deployment deployment.Report + ManagementURL string + Error string +} + +type address struct { + Name string `json:"name,omitempty"` + Email string `json:"email"` +} + +type mailPayload struct { + From address `json:"from"` + To []address `json:"to"` + Subject string `json:"subject"` + Text string `json:"text"` + HTML string `json:"html"` + CC []address `json:"cc"` + BCC []address `json:"bcc"` + Attrs []any `json:"attrs"` +} + +type sessionAuth struct { + cookie string + csrf string + origin string +} + +type sessionExpiredError struct { + statusCode int + errorCode int +} + +func (e *sessionExpiredError) Error() string { + if e.statusCode != 0 { + return fmt.Sprintf("邮件服务登录会话已失效,HTTP 状态码 %d", e.statusCode) + } + return fmt.Sprintf("邮件服务登录会话已失效,业务错误码 %d", e.errorCode) +} + +// Service 通过 HTTP 邮件 API 发送通知。 +type Service struct { + config config.NotificationConfig + credentials CredentialReader + client HTTPDoer + now func() time.Time + requestID func() string + sleep func(context.Context, time.Duration) error +} + +// New 创建 HTTP 通知服务。SMTP 配置暂保留为兼容字段,当前发送器只执行 HTTP 通知。 +func New(cfg config.NotificationConfig, credentials CredentialReader) *Service { + return &Service{ + config: cfg, + credentials: credentials, + client: &http.Client{}, + now: time.Now, + requestID: newRequestID, + sleep: sleepContext, + } +} + +// Send 按配置发送通知;未启用任何通知通道时直接返回成功。 +func (s *Service) Send(ctx context.Context, event Event) error { + if s == nil { + return errors.New("通知服务未初始化") + } + if !s.config.HTTPEnabled && !s.config.SMTPEnabled { + return nil + } + if !s.config.HTTPEnabled { + return errors.New("当前仅支持 HTTP 邮件通知,SMTP 通知发送器尚未接入") + } + if err := ctx.Err(); err != nil { + return err + } + payload, err := s.buildPayload(event) + if err != nil { + return err + } + body, err := json.Marshal(payload) + if err != nil { + return fmt.Errorf("编码邮件通知失败:%w", err) + } + endpoint, err := notificationURL(s.config.Endpoint, s.config.HTTPPath) + if err != nil { + return err + } + credentials, err := s.loadCredentials(ctx) + if err != nil { + return err + } + var session sessionAuth + if s.config.HTTPAuthMode == "session" { + session, err = s.loginSession(ctx, credentials) + if err != nil { + return err + } + } + requestID := s.requestID() + if requestID == "" { + return errors.New("生成通知请求 ID 失败") + } + var lastErr error + refreshSession := false + for attempt := 0; attempt <= s.config.RetryCount; attempt++ { + if attempt > 0 { + interval := time.Duration(0) + if attempt-1 < len(s.config.RetryIntervalsSecs) { + interval = time.Duration(s.config.RetryIntervalsSecs[attempt-1]) * time.Second + } + if err := s.sleep(ctx, interval); err != nil { + return err + } + } + if attempt > 0 && s.config.HTTPAuthMode == "session" && refreshSession { + session, err = s.loginSession(ctx, credentials) + if err != nil { + lastErr = err + continue + } + refreshSession = false + } + err := s.sendOnce(ctx, endpoint, body, credentials, requestID, session) + if err == nil { + return nil + } + lastErr = err + var expired *sessionExpiredError + refreshSession = errors.As(err, &expired) + } + return fmt.Errorf("发送邮件通知失败,已重试 %d 次:%w", s.config.RetryCount, lastErr) +} + +func (s *Service) sendOnce(ctx context.Context, endpoint string, body []byte, credentials map[string]string, requestID string, session sessionAuth) error { + timeout := time.Duration(s.config.TimeoutSecs) * time.Second + if timeout < time.Second { + timeout = time.Second + } + requestCtx, cancel := context.WithTimeout(ctx, timeout) + defer cancel() + request, err := http.NewRequestWithContext(requestCtx, http.MethodPost, endpoint, bytes.NewReader(body)) + if err != nil { + return fmt.Errorf("创建邮件通知请求失败:%w", err) + } + request.Header.Set("Content-Type", "application/json; charset=utf-8") + request.Header.Set("Accept", "application/json") + request.Header.Set("X-Scert-Request-Id", requestID) + timestamp := strconv.FormatInt(s.now().UTC().Unix(), 10) + request.Header.Set("X-Scert-Timestamp", timestamp) + if s.config.HTTPAuthMode == "session" { + if session.cookie == "" { + return errors.New("HTTP 通知登录会话为空") + } + request.Header.Set("Cookie", session.cookie) + if session.csrf != "" { + request.Header.Set("X-CSRF-Token", session.csrf) + } + request.Header.Set("Origin", session.origin) + request.Header.Set("Referer", session.origin+"/") + } + for key, value := range s.config.HTTPHeaders { + if strings.TrimSpace(key) == "" || strings.ContainsAny(value, "\r\n") { + return fmt.Errorf("HTTP 自定义请求头无效:%s", key) + } + if isProtectedHeader(key) { + return fmt.Errorf("HTTP 自定义请求头不允许覆盖安全头:%s", key) + } + request.Header.Set(key, value) + } + switch s.config.HTTPAuthMode { + case "none", "": + case "bearer": + token := credentialValue(credentials, "token", "access_token") + if token == "" { + return errors.New("HTTP Bearer 凭据中缺少 Token") + } + request.Header.Set("Authorization", "Bearer "+token) + case "hmac_sha256": + secret := credentialValue(credentials, "secret", "hmac_secret", "key", "token") + if secret == "" { + return errors.New("HTTP HMAC 凭据中缺少签名密钥") + } + signature := sign(secret, timestamp, requestID, body) + request.Header.Set("X-Scert-Signature", "sha256="+signature) + case "session": + default: + return fmt.Errorf("HTTP 通知认证方式无效:%s", s.config.HTTPAuthMode) + } + client := s.client + if client == nil { + client = &http.Client{} + } + response, err := client.Do(request) + if err != nil { + return fmt.Errorf("请求邮件服务失败:%w", err) + } + defer response.Body.Close() + responseBody, err := io.ReadAll(io.LimitReader(response.Body, (64<<10)+1)) + if err != nil { + return fmt.Errorf("读取邮件服务响应失败:%w", err) + } + if len(responseBody) > 64<<10 { + return errors.New("邮件服务响应超过允许大小") + } + if response.StatusCode < http.StatusOK || response.StatusCode >= http.StatusMultipleChoices { + if response.StatusCode == http.StatusUnauthorized || response.StatusCode == http.StatusForbidden { + return &sessionExpiredError{statusCode: response.StatusCode} + } + return fmt.Errorf("邮件服务返回 HTTP %d", response.StatusCode) + } + var envelope struct { + ErrorNo *int `json:"errorNo"` + } + if len(responseBody) > 0 && json.Unmarshal(responseBody, &envelope) == nil && envelope.ErrorNo != nil && *envelope.ErrorNo != 0 { + if *envelope.ErrorNo == http.StatusUnauthorized || *envelope.ErrorNo == http.StatusForbidden { + return &sessionExpiredError{errorCode: *envelope.ErrorNo} + } + return fmt.Errorf("邮件服务业务失败,错误码 %d", *envelope.ErrorNo) + } + return nil +} + +func (s *Service) loginSession(ctx context.Context, credentials map[string]string) (sessionAuth, error) { + account := credentialValue(credentials, "account", "username", "identifier") + password := credentials["password"] + if account == "" || strings.TrimSpace(password) == "" { + return sessionAuth{}, errors.New("HTTP 通知会话凭据必须包含账号和密码") + } + loginURL, err := notificationURL(s.config.Endpoint, s.config.HTTPLoginPath) + if err != nil { + return sessionAuth{}, err + } + payload, err := json.Marshal(map[string]string{"account": account, "password": password}) + if err != nil { + return sessionAuth{}, fmt.Errorf("编码 HTTP 通知登录请求失败:%w", err) + } + timeout := time.Duration(s.config.TimeoutSecs) * time.Second + if timeout < time.Second { + timeout = time.Second + } + loginCtx, cancel := context.WithTimeout(ctx, timeout) + defer cancel() + request, err := http.NewRequestWithContext(loginCtx, http.MethodPost, loginURL, bytes.NewReader(payload)) + if err != nil { + return sessionAuth{}, fmt.Errorf("创建 HTTP 通知登录请求失败:%w", err) + } + request.Header.Set("Content-Type", "application/json; charset=utf-8") + request.Header.Set("Accept", "application/json") + request.Header.Set("Origin", notificationOrigin(loginURL)) + request.Header.Set("Referer", notificationOrigin(loginURL)+"/") + client := s.client + if client == nil { + client = &http.Client{} + } + response, err := client.Do(request) + if err != nil { + return sessionAuth{}, fmt.Errorf("请求 HTTP 通知登录接口失败:%w", err) + } + defer response.Body.Close() + responseBody, err := io.ReadAll(io.LimitReader(response.Body, 64<<10)) + if err != nil { + return sessionAuth{}, fmt.Errorf("读取 HTTP 通知登录响应失败:%w", err) + } + if response.StatusCode < http.StatusOK || response.StatusCode >= http.StatusMultipleChoices { + return sessionAuth{}, fmt.Errorf("HTTP 通知登录接口返回 HTTP %d", response.StatusCode) + } + var envelope struct { + ErrorNo *int `json:"errorNo"` + ErrorMsg string `json:"errorMsg"` + } + if len(responseBody) > 0 && json.Unmarshal(responseBody, &envelope) == nil && envelope.ErrorNo != nil && *envelope.ErrorNo != 0 { + if strings.TrimSpace(envelope.ErrorMsg) == "" { + return sessionAuth{}, fmt.Errorf("HTTP 通知登录失败,错误码 %d", *envelope.ErrorNo) + } + return sessionAuth{}, fmt.Errorf("HTTP 通知登录失败,错误码 %d", *envelope.ErrorNo) + } + cookies := make([]string, 0, len(response.Cookies())) + csrf := "" + for _, cookie := range response.Cookies() { + cookies = append(cookies, cookie.Name+"="+cookie.Value) + if cookie.Name == "smail_csrf" { + csrf = cookie.Value + } + } + if len(cookies) == 0 { + return sessionAuth{}, errors.New("HTTP 通知登录成功但未返回会话 Cookie") + } + return sessionAuth{cookie: strings.Join(cookies, "; "), csrf: csrf, origin: notificationOrigin(loginURL)}, nil +} + +func notificationOrigin(value string) string { + parsed, err := url.Parse(value) + if err != nil { + return "" + } + return (&url.URL{Scheme: parsed.Scheme, Host: parsed.Host}).String() +} + +func (s *Service) loadCredentials(ctx context.Context) (map[string]string, error) { + if s.config.HTTPAuthMode == "none" || s.config.HTTPAuthMode == "" { + return nil, nil + } + if s.credentials == nil { + return nil, errors.New("HTTP 通知凭据存储未配置") + } + ref := strings.TrimSpace(s.config.HTTPCredentialRef) + if ref == "" { + return nil, errors.New("HTTP 通知凭据引用不能为空") + } + values, err := s.credentials.Get(ctx, ref) + if err != nil { + return nil, fmt.Errorf("读取 HTTP 通知凭据失败:%w", err) + } + return values, nil +} + +func (s *Service) buildPayload(event Event) (mailPayload, error) { + fromEmail := strings.TrimSpace(s.config.SenderEmail) + if fromEmail == "" { + return mailPayload{}, errors.New("通知发件人地址不能为空") + } + parsedSender, err := mail.ParseAddress(fromEmail) + if err != nil || parsedSender.Address != fromEmail { + return mailPayload{}, errors.New("通知发件人地址格式无效") + } + recipients := make([]address, 0, len(s.config.Recipients)) + for _, value := range s.config.Recipients { + value = strings.TrimSpace(value) + if value == "" { + continue + } + parsed, err := mail.ParseAddress(value) + if err != nil || parsed.Address != value { + return mailPayload{}, fmt.Errorf("通知收件人地址格式无效:%s", value) + } + recipients = append(recipients, address{Name: parsed.Name, Email: parsed.Address}) + } + if len(recipients) == 0 { + return mailPayload{}, errors.New("通知收件人不能为空") + } + status := eventStatus(event.Status) + domainName := strings.TrimSpace(event.Domain) + if domainName == "" { + domainName = strings.TrimSpace(event.DomainID) + } + if domainName == "" { + domainName = "未指定域名" + } + title := "证书任务" + if s.config.EventMode == "unified" { + title = "证书任务通知" + } else if event.Type != "" { + title = eventTypeName(event.Type) + } + text := buildText(event, title, status, domainName) + return mailPayload{ + From: address{Name: s.config.SenderName, Email: fromEmail}, + To: recipients, + Subject: fmt.Sprintf("[Scert] %s:%s(%s)", title, domainName, status), + Text: text, + HTML: "
" + html.EscapeString(text) + "
", + CC: []address{}, + BCC: []address{}, + Attrs: []any{}, + }, nil +} + +func buildText(event Event, title, status, domainName string) string { + lines := []string{ + "Scert 证书管理服务通知", + "任务类型:" + title, + "任务状态:" + status, + "域名:" + domainName, + } + if len(event.Domains) > 0 { + lines = append(lines, "证书域名:"+strings.Join(event.Domains, "、")) + } + if event.ExpiresAt != nil && !event.ExpiresAt.IsZero() { + lines = append(lines, "证书到期时间:"+event.ExpiresAt.Local().Format("2006-01-02 15:04:05")) + } + if event.CertificateSerial != "" { + lines = append(lines, "证书序列号:"+event.CertificateSerial) + } + if event.ManagementURL != "" { + lines = append(lines, "管理后台:"+event.ManagementURL) + } + if event.Deployment.Total > 0 { + lines = append(lines, fmt.Sprintf("部署结果:总计 %d 台,成功 %d 台,失败 %d 台,状态 %s", event.Deployment.Total, event.Deployment.Success, event.Deployment.Failed, event.Deployment.Status)) + for _, result := range event.Deployment.Results { + lines = append(lines, fmt.Sprintf("- %s:%s(%s)", result.Server, result.Status, result.Message)) + } + } + if event.Error != "" { + lines = append(lines, "错误信息:"+event.Error) + } + return strings.Join(lines, "\n") +} + +func eventStatus(value string) string { + switch strings.ToLower(strings.TrimSpace(value)) { + case "success": + return "成功" + case "failed", "failure": + return "失败" + case "error": + return "错误" + default: + return "未知" + } +} + +func eventTypeName(value string) string { + switch strings.ToLower(strings.TrimSpace(value)) { + case "certificate_issue": + return "证书申请" + case "certificate_renewal": + return "证书续期" + case "certificate_import": + return "证书导入" + default: + return "证书任务" + } +} + +func notificationURL(endpoint, path string) (string, error) { + base, err := url.Parse(strings.TrimSpace(endpoint)) + if err != nil || (base.Scheme != "http" && base.Scheme != "https") || base.Host == "" { + return "", errors.New("第三方邮箱 API 地址格式无效") + } + path = strings.TrimSpace(path) + if path == "" || !strings.HasPrefix(path, "/") { + return "", errors.New("HTTP 通知请求路径必须以 / 开头") + } + base.Path = strings.TrimRight(base.Path, "/") + path + base.RawQuery = "" + base.Fragment = "" + return base.String(), nil +} + +func isProtectedHeader(value string) bool { + switch strings.ToLower(strings.TrimSpace(value)) { + case "authorization", "cookie", "origin", "referer", "content-type", "accept", "x-csrf-token", "x-scert-signature", "x-scert-request-id", "x-scert-timestamp": + return true + default: + return false + } +} + +func credentialValue(values map[string]string, keys ...string) string { + for _, key := range keys { + if value := strings.TrimSpace(values[key]); value != "" { + return value + } + } + return "" +} + +func sign(secret, timestamp, requestID string, body []byte) string { + hasher := hmac.New(sha256.New, []byte(secret)) + _, _ = hasher.Write([]byte(timestamp + "." + requestID + ".")) + _, _ = hasher.Write(body) + return hex.EncodeToString(hasher.Sum(nil)) +} + +func newRequestID() string { + var value [16]byte + if _, err := rand.Read(value[:]); err != nil { + return "" + } + return hex.EncodeToString(value[:]) +} + +func sleepContext(ctx context.Context, duration time.Duration) error { + if duration <= 0 { + return nil + } + timer := time.NewTimer(duration) + defer timer.Stop() + select { + case <-ctx.Done(): + return ctx.Err() + case <-timer.C: + return nil + } +} diff --git a/backend/internal/notification/service_test.go b/backend/internal/notification/service_test.go new file mode 100644 index 0000000..0144188 --- /dev/null +++ b/backend/internal/notification/service_test.go @@ -0,0 +1,273 @@ +package notification + +import ( + "context" + "encoding/json" + "io" + "net/http" + "net/http/httptest" + "strconv" + "strings" + "testing" + "time" + + "git.pcux.cn/xuans/Scert/backend/internal/config" +) + +type credentialReaderStub struct { + values map[string]string +} + +func (s credentialReaderStub) Get(context.Context, string) (map[string]string, error) { + return s.values, nil +} + +func newTestConfig(endpoint string) config.NotificationConfig { + return config.NotificationConfig{ + HTTPEnabled: true, + Endpoint: endpoint, + HTTPPath: "/api/email/send", + HTTPLoginPath: "/api/login", + HTTPAuthMode: "none", + EventMode: "detailed", + SenderName: "Scert", + SenderEmail: "admin@example.com", + Recipients: []string{"receiver@example.com"}, + TimeoutSecs: 2, + RetryCount: 0, + RetryIntervalsSecs: []int{}, + } +} + +func TestSendBuildsSmailPayload(t *testing.T) { + var payload map[string]any + server := httptest.NewServer(http.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) { + if request.Method != http.MethodPost || request.URL.Path != "/api/email/send" { + t.Fatalf("请求方法或路径错误:%s %s", request.Method, request.URL.Path) + } + if request.Header.Get("Content-Type") != "application/json; charset=utf-8" { + t.Fatalf("通知请求编码声明错误:%q", request.Header.Get("Content-Type")) + } + if request.Header.Get("X-Scert-Request-Id") == "" || request.Header.Get("X-Scert-Timestamp") == "" { + t.Fatal("缺少通知安全请求头") + } + body, err := io.ReadAll(request.Body) + if err != nil { + t.Fatal(err) + } + if err := json.Unmarshal(body, &payload); err != nil { + t.Fatal(err) + } + if !strings.Contains(string(body), "证书续期") { + t.Fatalf("通知请求未使用 UTF-8 编码:%q", string(body)) + } + writer.WriteHeader(http.StatusNoContent) + })) + defer server.Close() + + service := New(newTestConfig(server.URL), nil) + service.requestID = func() string { return "request-id" } + service.now = func() time.Time { return time.Unix(1700000000, 0).UTC() } + when := time.Date(2026, 8, 30, 12, 0, 0, 0, time.UTC) + err := service.Send(context.Background(), Event{ + Type: "certificate_renewal", + Status: "success", + Domain: "example.com", + Domains: []string{"example.com", "www.example.com"}, + ExpiresAt: &when, + ManagementURL: "https://scert.example.com", + }) + if err != nil { + t.Fatalf("发送通知失败:%v", err) + } + if payload["subject"] == "" || !strings.Contains(payload["text"].(string), "证书续期") { + t.Fatalf("通知正文未正确生成:%v", payload) + } + to := payload["to"].([]any) + if len(to) != 1 || to[0].(map[string]any)["email"] != "receiver@example.com" { + t.Fatalf("收件人未正确生成:%v", payload["to"]) + } +} + +func TestSendSupportsBearerAndRetries(t *testing.T) { + attempts := 0 + var authorization string + server := httptest.NewServer(http.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) { + attempts++ + authorization = request.Header.Get("Authorization") + if attempts < 3 { + writer.WriteHeader(http.StatusBadGateway) + return + } + writer.WriteHeader(http.StatusOK) + })) + defer server.Close() + + cfg := newTestConfig(server.URL) + cfg.HTTPAuthMode = "bearer" + cfg.HTTPCredentialRef = "secret://mail-token" + cfg.RetryCount = 2 + cfg.RetryIntervalsSecs = []int{1, 1} + service := New(cfg, credentialReaderStub{values: map[string]string{"token": "test-token"}}) + service.sleep = func(context.Context, time.Duration) error { return nil } + if err := service.Send(context.Background(), Event{Type: "certificate_issue", Status: "success", Domain: "example.com"}); err != nil { + t.Fatalf("重试后发送通知失败:%v", err) + } + if attempts != 3 || authorization != "Bearer test-token" { + t.Fatalf("Bearer 或重试次数错误:attempts=%d authorization=%q", attempts, authorization) + } +} + +func TestSendSupportsHMACAndProtectsHeaders(t *testing.T) { + var receivedSignature string + var receivedTimestamp string + var receivedRequestID string + var receivedBody []byte + server := httptest.NewServer(http.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) { + receivedSignature = request.Header.Get("X-Scert-Signature") + receivedTimestamp = request.Header.Get("X-Scert-Timestamp") + receivedRequestID = request.Header.Get("X-Scert-Request-Id") + receivedBody, _ = io.ReadAll(request.Body) + writer.WriteHeader(http.StatusCreated) + })) + defer server.Close() + + cfg := newTestConfig(server.URL) + cfg.HTTPAuthMode = "hmac_sha256" + cfg.HTTPCredentialRef = "secret://mail-hmac" + service := New(cfg, credentialReaderStub{values: map[string]string{"secret": "hmac-secret"}}) + service.requestID = func() string { return "fixed-request" } + service.now = func() time.Time { return time.Unix(1700000000, 0).UTC() } + if err := service.Send(context.Background(), Event{Type: "certificate_import", Status: "unknown", Domain: "example.com"}); err != nil { + t.Fatalf("HMAC 通知发送失败:%v", err) + } + expected := "sha256=" + sign("hmac-secret", receivedTimestamp, receivedRequestID, receivedBody) + if receivedSignature != expected { + t.Fatalf("HMAC 签名错误:got=%q want=%q", receivedSignature, expected) + } + + cfg.HTTPAuthMode = "none" + cfg.HTTPHeaders = map[string]string{"Content-Type": "text/plain"} + service = New(cfg, nil) + service.sleep = func(context.Context, time.Duration) error { return nil } + if err := service.Send(context.Background(), Event{Status: "success", Domain: "example.com"}); err == nil { + t.Fatal("覆盖安全请求头时应失败") + } +} + +func TestSendSupportsSessionLogin(t *testing.T) { + var loginPayload map[string]string + var sendCookie string + var csrfToken string + var origin string + server := httptest.NewServer(http.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) { + switch request.URL.Path { + case "/api/login": + if request.Method != http.MethodPost { + t.Fatalf("登录请求方法错误:%s", request.Method) + } + body, err := io.ReadAll(request.Body) + if err != nil { + t.Fatal(err) + } + if err := json.Unmarshal(body, &loginPayload); err != nil { + t.Fatal(err) + } + if request.Header.Get("Content-Type") != "application/json; charset=utf-8" { + t.Fatalf("登录请求编码声明错误:%q", request.Header.Get("Content-Type")) + } + writer.Header().Add("Set-Cookie", "session=test-session; Path=/; HttpOnly") + writer.Header().Add("Set-Cookie", "smail_csrf=test-csrf; Path=/") + writer.Header().Set("Content-Type", "application/json") + _, _ = writer.Write([]byte(`{"errorNo":0,"errorMsg":"","data":{"account":"xuans"}}`)) + case "/api/email/send": + sendCookie = request.Header.Get("Cookie") + csrfToken = request.Header.Get("X-CSRF-Token") + origin = request.Header.Get("Origin") + writer.WriteHeader(http.StatusAccepted) + default: + writer.WriteHeader(http.StatusNotFound) + } + })) + defer server.Close() + + cfg := newTestConfig(server.URL) + cfg.HTTPAuthMode = "session" + cfg.HTTPCredentialRef = "secret://mail-session" + service := New(cfg, credentialReaderStub{values: map[string]string{ + "account": "xuans", + "password": " test-password ", + }}) + if err := service.Send(context.Background(), Event{Type: "certificate_issue", Status: "success", Domain: "example.com"}); err != nil { + t.Fatalf("会话认证通知发送失败:%v", err) + } + if loginPayload["account"] != "xuans" || loginPayload["password"] != " test-password " { + t.Fatalf("登录请求字段错误:%v", loginPayload) + } + if !strings.Contains(sendCookie, "session=test-session") || csrfToken != "test-csrf" { + t.Fatalf("发送请求未携带登录会话:cookie=%q csrf=%q", sendCookie, csrfToken) + } + if origin != server.URL { + t.Fatalf("发送请求来源错误:%q", origin) + } +} + +func TestSendRejectsBusinessFailure(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) { + writer.Header().Set("Content-Type", "application/json; charset=utf-8") + _, _ = writer.Write([]byte(`{"errorNo":100,"errorMsg":"参数错误"}`)) + })) + defer server.Close() + + service := New(newTestConfig(server.URL), nil) + err := service.Send(context.Background(), Event{Status: "success", Domain: "example.com"}) + if err == nil || !strings.Contains(err.Error(), "业务失败") { + t.Fatalf("业务错误响应应被拒绝:%v", err) + } +} + +func TestSendRefreshesExpiredSession(t *testing.T) { + loginCount := 0 + sendCount := 0 + var cookies []string + server := httptest.NewServer(http.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) { + switch request.URL.Path { + case "/api/login": + loginCount++ + writer.Header().Add("Set-Cookie", "session=session-"+strconv.Itoa(loginCount)+"; Path=/; HttpOnly") + writer.Header().Set("Content-Type", "application/json; charset=utf-8") + _, _ = writer.Write([]byte(`{"errorNo":0,"errorMsg":""}`)) + case "/api/email/send": + sendCount++ + cookies = append(cookies, request.Header.Get("Cookie")) + if sendCount == 1 { + writer.WriteHeader(http.StatusForbidden) + return + } + writer.WriteHeader(http.StatusNoContent) + default: + writer.WriteHeader(http.StatusNotFound) + } + })) + defer server.Close() + + cfg := newTestConfig(server.URL) + cfg.HTTPAuthMode = "session" + cfg.HTTPCredentialRef = "secret://mail-session" + cfg.RetryCount = 1 + cfg.RetryIntervalsSecs = []int{1} + service := New(cfg, credentialReaderStub{values: map[string]string{ + "account": "xuans", + "password": "test-password", + }}) + service.sleep = func(context.Context, time.Duration) error { return nil } + if err := service.Send(context.Background(), Event{Status: "success", Domain: "example.com"}); err != nil { + t.Fatalf("会话失效后重新登录仍发送失败:%v", err) + } + if loginCount != 2 || sendCount != 2 || len(cookies) != 2 { + t.Fatalf("会话刷新次数错误:login=%d send=%d cookies=%v", loginCount, sendCount, cookies) + } + if cookies[0] != "session=session-1" || cookies[1] != "session=session-2" { + t.Fatalf("未使用刷新后的会话:%v", cookies) + } +} diff --git a/backend/internal/repository/audit_reader.go b/backend/internal/repository/audit_reader.go new file mode 100644 index 0000000..66ddef2 --- /dev/null +++ b/backend/internal/repository/audit_reader.go @@ -0,0 +1,42 @@ +package repository + +import ( + "context" + "database/sql" + "fmt" +) + +// AuditReader 用于读取操作审计记录,不改变写入接口的兼容性。 +type AuditReader interface { + ListAuditLogs(context.Context, int) ([]AuditLog, error) +} + +func (r *SQLAuditRepository) ListAuditLogs(ctx context.Context, limit int) ([]AuditLog, error) { + if r == nil || r.db == nil { + return nil, fmt.Errorf("数据库连接不能为空") + } + if limit <= 0 || limit > 200 { + limit = 50 + } + rows, err := r.db.QueryContext(ctx, `SELECT action, resource_type, resource_id, status, message, created_at FROM audit_logs ORDER BY created_at DESC, id DESC LIMIT `+fmt.Sprintf("%d", limit)) + if err != nil { + return nil, fmt.Errorf("查询审计日志失败:%w", err) + } + defer rows.Close() + logs := make([]AuditLog, 0) + for rows.Next() { + var item AuditLog + if err := rows.Scan(&item.Action, &item.ResourceType, &item.ResourceID, &item.Status, &item.Message, &item.CreatedAt); err != nil { + return nil, fmt.Errorf("读取审计日志失败:%w", err) + } + item.CreatedAt = item.CreatedAt.UTC() + logs = append(logs, item) + } + if err := rows.Err(); err != nil { + return nil, fmt.Errorf("读取审计日志列表失败:%w", err) + } + return logs, nil +} + +var _ AuditReader = (*SQLAuditRepository)(nil) +var _ = sql.ErrNoRows diff --git a/backend/internal/repository/task_repository.go b/backend/internal/repository/task_repository.go new file mode 100644 index 0000000..50c4e64 --- /dev/null +++ b/backend/internal/repository/task_repository.go @@ -0,0 +1,324 @@ +package repository + +import ( + "context" + "database/sql" + "errors" + "fmt" + "strings" + "time" +) + +// Task 表示一项可持久化的证书或部署任务。 +type Task struct { + ID string `json:"id"` + DomainID string `json:"domain_id"` + TaskType string `json:"task_type"` + Status string `json:"status"` + Stage string `json:"stage"` + Message string `json:"message"` + OperatorID string `json:"operator_id,omitempty"` + CertificateVersionID string `json:"certificate_version_id,omitempty"` + IdempotencyKey string `json:"idempotency_key,omitempty"` + StartedAt *time.Time `json:"started_at,omitempty"` + FinishedAt *time.Time `json:"finished_at,omitempty"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` +} + +// TaskAttempt 表示任务的一次执行尝试。 +type TaskAttempt struct { + ID string `json:"id"` + TaskID string `json:"task_id"` + AttemptNumber int `json:"attempt_number"` + Stage string `json:"stage"` + Status string `json:"status"` + Message string `json:"message"` + StartedAt *time.Time `json:"started_at,omitempty"` + FinishedAt *time.Time `json:"finished_at,omitempty"` + CreatedAt time.Time `json:"created_at"` +} + +type TaskRepository interface { + CreateTask(context.Context, Task) error + GetTask(context.Context, string) (Task, error) + ListTasks(context.Context, string, int) ([]Task, error) + UpdateTask(context.Context, string, string, string, string, *time.Time, *time.Time) error + FindActiveTaskByDomain(context.Context, string, string) (Task, error) + CreateAttempt(context.Context, TaskAttempt) error + FinishAttempt(context.Context, string, string, string, *time.Time) error + ListAttempts(context.Context, string) ([]TaskAttempt, error) +} + +type SQLTaskRepository struct { + db *sql.DB +} + +func NewSQLTaskRepository(db *sql.DB) *SQLTaskRepository { + return &SQLTaskRepository{db: db} +} + +func (r *SQLTaskRepository) CreateTask(ctx context.Context, item Task) error { + if r == nil || r.db == nil { + return errors.New("数据库连接不能为空") + } + item = normalizeTask(item) + if err := validateTask(item); err != nil { + return err + } + now := item.CreatedAt + if now.IsZero() { + now = time.Now().UTC() + } + updated := item.UpdatedAt + if updated.IsZero() { + updated = now + } + _, err := r.db.ExecContext(ctx, `INSERT INTO tasks + (id, domain_id, task_type, status, stage, message, operator_id, certificate_version_id, idempotency_key, started_at, finished_at, created_at, updated_at) + VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, + item.ID, item.DomainID, item.TaskType, item.Status, item.Stage, item.Message, item.OperatorID, + item.CertificateVersionID, item.IdempotencyKey, nullableTime(item.StartedAt), nullableTime(item.FinishedAt), now, updated) + if err != nil { + return fmt.Errorf("创建任务失败:%w", err) + } + return nil +} + +func (r *SQLTaskRepository) GetTask(ctx context.Context, id string) (Task, error) { + if r == nil || r.db == nil { + return Task{}, errors.New("数据库连接不能为空") + } + id = strings.TrimSpace(id) + if id == "" { + return Task{}, errors.New("任务 ID 不能为空") + } + return scanTask(r.db.QueryRowContext(ctx, taskSelect+` WHERE id = ?`, id)) +} + +func (r *SQLTaskRepository) ListTasks(ctx context.Context, domainID string, limit int) ([]Task, error) { + if r == nil || r.db == nil { + return nil, errors.New("数据库连接不能为空") + } + if limit <= 0 || limit > 200 { + limit = 50 + } + query := taskSelect + args := make([]any, 0, 1) + if domainID = strings.TrimSpace(domainID); domainID != "" { + query += " WHERE domain_id = ?" + args = append(args, domainID) + } + query += fmt.Sprintf(" ORDER BY created_at DESC LIMIT %d", limit) + rows, err := r.db.QueryContext(ctx, query, args...) + if err != nil { + return nil, fmt.Errorf("查询任务列表失败:%w", err) + } + defer rows.Close() + result := make([]Task, 0) + for rows.Next() { + item, err := scanTask(rows) + if err != nil { + return nil, err + } + result = append(result, item) + } + if err := rows.Err(); err != nil { + return nil, fmt.Errorf("读取任务列表失败:%w", err) + } + return result, nil +} + +func (r *SQLTaskRepository) UpdateTask(ctx context.Context, id, status, stage, message string, startedAt, finishedAt *time.Time) error { + if r == nil || r.db == nil { + return errors.New("数据库连接不能为空") + } + id = strings.TrimSpace(id) + status = strings.TrimSpace(status) + stage = strings.TrimSpace(stage) + if id == "" { + return errors.New("任务 ID 不能为空") + } + if !validTaskStatus(status) || stage == "" { + return errors.New("任务状态或阶段无效") + } + result, err := r.db.ExecContext(ctx, `UPDATE tasks SET status = ?, stage = ?, message = ?, started_at = ?, finished_at = ?, updated_at = ? WHERE id = ?`, + status, stage, message, nullableTime(startedAt), nullableTime(finishedAt), time.Now().UTC(), id) + if err != nil { + return fmt.Errorf("更新任务失败:%w", err) + } + count, err := result.RowsAffected() + if err != nil { + return fmt.Errorf("读取任务更新结果失败:%w", err) + } + if count == 0 { + return sql.ErrNoRows + } + return nil +} + +func (r *SQLTaskRepository) FindActiveTaskByDomain(ctx context.Context, domainID, taskType string) (Task, error) { + if r == nil || r.db == nil { + return Task{}, errors.New("数据库连接不能为空") + } + domainID = strings.TrimSpace(domainID) + taskType = strings.TrimSpace(taskType) + if domainID == "" || taskType == "" { + return Task{}, errors.New("域名 ID 和任务类型不能为空") + } + return scanTask(r.db.QueryRowContext(ctx, taskSelect+` WHERE domain_id = ? AND task_type = ? AND status IN ('queued', 'running') ORDER BY created_at DESC LIMIT 1`, domainID, taskType)) +} + +func (r *SQLTaskRepository) CreateAttempt(ctx context.Context, item TaskAttempt) error { + if r == nil || r.db == nil { + return errors.New("数据库连接不能为空") + } + item.ID = strings.TrimSpace(item.ID) + item.TaskID = strings.TrimSpace(item.TaskID) + item.Stage = strings.TrimSpace(item.Stage) + item.Status = strings.TrimSpace(item.Status) + if item.ID == "" || item.TaskID == "" || item.AttemptNumber <= 0 { + return errors.New("任务尝试必要字段不能为空") + } + if item.Stage == "" || !validTaskStatus(item.Status) { + return errors.New("任务尝试阶段或状态无效") + } + if item.CreatedAt.IsZero() { + item.CreatedAt = time.Now().UTC() + } + _, err := r.db.ExecContext(ctx, `INSERT INTO task_attempts + (id, task_id, attempt_number, stage, status, message, started_at, finished_at, created_at) + VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, item.ID, item.TaskID, item.AttemptNumber, item.Stage, item.Status, item.Message, + nullableTime(item.StartedAt), nullableTime(item.FinishedAt), item.CreatedAt.UTC()) + if err != nil { + return fmt.Errorf("创建任务尝试失败:%w", err) + } + return nil +} + +func (r *SQLTaskRepository) FinishAttempt(ctx context.Context, id, status, message string, finishedAt *time.Time) error { + if r == nil || r.db == nil { + return errors.New("数据库连接不能为空") + } + id = strings.TrimSpace(id) + status = strings.TrimSpace(status) + if id == "" || !validTaskStatus(status) { + return errors.New("任务尝试 ID 或状态无效") + } + result, err := r.db.ExecContext(ctx, `UPDATE task_attempts SET status = ?, message = ?, finished_at = ? WHERE id = ?`, status, message, nullableTime(finishedAt), id) + if err != nil { + return fmt.Errorf("完成任务尝试失败:%w", err) + } + count, err := result.RowsAffected() + if err != nil { + return fmt.Errorf("读取任务尝试更新结果失败:%w", err) + } + if count == 0 { + return sql.ErrNoRows + } + return nil +} + +func (r *SQLTaskRepository) ListAttempts(ctx context.Context, taskID string) ([]TaskAttempt, error) { + if r == nil || r.db == nil { + return nil, errors.New("数据库连接不能为空") + } + taskID = strings.TrimSpace(taskID) + if taskID == "" { + return nil, errors.New("任务 ID 不能为空") + } + rows, err := r.db.QueryContext(ctx, `SELECT id, task_id, attempt_number, stage, status, message, started_at, finished_at, created_at FROM task_attempts WHERE task_id = ? ORDER BY attempt_number`, taskID) + if err != nil { + return nil, fmt.Errorf("查询任务尝试失败:%w", err) + } + defer rows.Close() + result := make([]TaskAttempt, 0) + for rows.Next() { + item, err := scanAttempt(rows) + if err != nil { + return nil, err + } + result = append(result, item) + } + if err := rows.Err(); err != nil { + return nil, fmt.Errorf("读取任务尝试列表失败:%w", err) + } + return result, nil +} + +const taskSelect = `SELECT id, domain_id, task_type, status, stage, message, operator_id, certificate_version_id, idempotency_key, started_at, finished_at, created_at, updated_at FROM tasks` + +func scanTask(row rowScanner) (Task, error) { + var item Task + var startedAt, finishedAt sql.NullTime + if err := row.Scan(&item.ID, &item.DomainID, &item.TaskType, &item.Status, &item.Stage, &item.Message, &item.OperatorID, &item.CertificateVersionID, &item.IdempotencyKey, &startedAt, &finishedAt, &item.CreatedAt, &item.UpdatedAt); err != nil { + if errors.Is(err, sql.ErrNoRows) { + return Task{}, sql.ErrNoRows + } + return Task{}, fmt.Errorf("读取任务失败:%w", err) + } + item.StartedAt = nullTime(startedAt) + item.FinishedAt = nullTime(finishedAt) + return item, nil +} + +func scanAttempt(row rowScanner) (TaskAttempt, error) { + var item TaskAttempt + var startedAt, finishedAt sql.NullTime + if err := row.Scan(&item.ID, &item.TaskID, &item.AttemptNumber, &item.Stage, &item.Status, &item.Message, &startedAt, &finishedAt, &item.CreatedAt); err != nil { + if errors.Is(err, sql.ErrNoRows) { + return TaskAttempt{}, sql.ErrNoRows + } + return TaskAttempt{}, fmt.Errorf("读取任务尝试失败:%w", err) + } + item.StartedAt = nullTime(startedAt) + item.FinishedAt = nullTime(finishedAt) + return item, nil +} + +func normalizeTask(item Task) Task { + item.ID = strings.TrimSpace(item.ID) + item.DomainID = strings.TrimSpace(item.DomainID) + item.TaskType = strings.TrimSpace(item.TaskType) + item.Status = strings.TrimSpace(item.Status) + item.Stage = strings.TrimSpace(item.Stage) + item.OperatorID = strings.TrimSpace(item.OperatorID) + item.CertificateVersionID = strings.TrimSpace(item.CertificateVersionID) + item.IdempotencyKey = strings.TrimSpace(item.IdempotencyKey) + if item.Status == "" { + item.Status = "queued" + } + if item.Stage == "" { + item.Stage = "queued" + } + return item +} + +func validateTask(item Task) error { + if item.ID == "" || item.DomainID == "" || item.TaskType == "" { + return errors.New("任务 ID、域名 ID 和任务类型不能为空") + } + if !validTaskStatus(item.Status) { + return fmt.Errorf("任务状态无效:%s", item.Status) + } + return nil +} + +func validTaskStatus(status string) bool { + switch status { + case "queued", "running", "success", "failed", "cancelled": + return true + default: + return false + } +} + +func nullTime(value sql.NullTime) *time.Time { + if !value.Valid { + return nil + } + result := value.Time.UTC() + return &result +} + +var _ TaskRepository = (*SQLTaskRepository)(nil) diff --git a/backend/internal/repository/task_repository_test.go b/backend/internal/repository/task_repository_test.go new file mode 100644 index 0000000..d80b80c --- /dev/null +++ b/backend/internal/repository/task_repository_test.go @@ -0,0 +1,93 @@ +package repository + +import ( + "context" + "database/sql" + "path/filepath" + "testing" + "time" + + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/database" +) + +func newTaskRepositoryTest(t *testing.T) (*SQLTaskRepository, *sql.DB) { + t.Helper() + dir := t.TempDir() + cfg := config.Default(dir) + cfg.Database.DSN = filepath.Join(dir, "data", "test.db") + db, err := database.Open(context.Background(), cfg.Database) + if err != nil { + t.Fatalf("打开测试数据库失败:%v", err) + } + if err := database.Migrate(context.Background(), db.DB, "sqlite"); err != nil { + db.Close() + t.Fatalf("迁移测试数据库失败:%v", err) + } + return NewSQLTaskRepository(db.DB), db.DB +} + +func TestSQLTaskRepositoryLifecycle(t *testing.T) { + repository, db := newTaskRepositoryTest(t) + defer db.Close() + ctx := context.Background() + now := time.Date(2026, 8, 27, 12, 0, 0, 0, time.UTC) + task := Task{ + ID: "task-1", DomainID: "domain-1", TaskType: "certificate_issue", + Status: "queued", Stage: "queued", Message: "等待执行", CreatedAt: now, UpdatedAt: now, + } + if err := repository.CreateTask(ctx, task); err != nil { + t.Fatalf("创建任务失败:%v", err) + } + got, err := repository.GetTask(ctx, task.ID) + if err != nil { + t.Fatalf("读取任务失败:%v", err) + } + if got.ID != task.ID || got.Status != "queued" || got.Stage != "queued" { + t.Fatalf("读取任务内容错误:%+v", got) + } + started := now.Add(time.Minute) + if err := repository.UpdateTask(ctx, task.ID, "running", "certificate_issue", "正在申请证书", &started, nil); err != nil { + t.Fatalf("更新任务失败:%v", err) + } + active, err := repository.FindActiveTaskByDomain(ctx, task.DomainID, task.TaskType) + if err != nil || active.Status != "running" { + t.Fatalf("查询活跃任务失败:%+v %v", active, err) + } + finished := started.Add(time.Minute) + if err := repository.UpdateTask(ctx, task.ID, "success", "certificate_issue", "执行成功", &started, &finished); err != nil { + t.Fatalf("完成任务失败:%v", err) + } + if _, err := repository.FindActiveTaskByDomain(ctx, task.DomainID, task.TaskType); err != sql.ErrNoRows { + t.Fatalf("已完成任务不应被视为活跃任务:%v", err) + } + attempt := TaskAttempt{ + ID: "attempt-1", TaskID: task.ID, AttemptNumber: 1, Stage: "certificate_issue", + Status: "success", Message: "执行成功", StartedAt: &started, FinishedAt: &finished, CreatedAt: finished, + } + if err := repository.CreateAttempt(ctx, attempt); err != nil { + t.Fatalf("创建任务尝试失败:%v", err) + } + if err := repository.FinishAttempt(ctx, attempt.ID, "success", "执行成功", &finished); err != nil { + t.Fatalf("完成任务尝试失败:%v", err) + } + attempts, err := repository.ListAttempts(ctx, task.ID) + if err != nil || len(attempts) != 1 || attempts[0].Status != "success" { + t.Fatalf("读取任务尝试失败:%+v %v", attempts, err) + } + items, err := repository.ListTasks(ctx, task.DomainID, 10) + if err != nil || len(items) != 1 { + t.Fatalf("读取任务列表失败:%+v %v", items, err) + } +} + +func TestSQLTaskRepositoryRejectsInvalidStatus(t *testing.T) { + repository, db := newTaskRepositoryTest(t) + defer db.Close() + err := repository.CreateTask(context.Background(), Task{ + ID: "task-invalid", DomainID: "domain-1", TaskType: "certificate_issue", Status: "invalid", Stage: "queued", + }) + if err == nil { + t.Fatal("无效任务状态应被拒绝") + } +} diff --git a/backend/internal/setup/setup.go b/backend/internal/setup/setup.go index 1eb2bb3..d85e348 100644 --- a/backend/internal/setup/setup.go +++ b/backend/internal/setup/setup.go @@ -13,21 +13,36 @@ import ( ) type Input struct { - AdminUsername string - AdminEmail string - AdminPassword string - ServerPort int - EmailProvider string - EmailEndpoint string - EmailRecipients []string - DNSProvider string - DNSCredentialRef string - DNSVerified bool - CertificateRoot string - WebHostname string - WebPublicIP string - WebEnabled bool - HTTPSMode string + AdminUsername string + AdminEmail string + AdminPassword string + ServerPort int + EmailHTTPEnabled bool + EmailProvider string + EmailEndpoint string + EmailHTTPPath string + EmailHTTPLoginPath string + EmailHTTPAuthMode string + EmailHTTPCredentialRef string + EmailHTTPHeaders map[string]string + EmailEventMode string + EmailIncludeDeploymentDetails bool + EmailIncludeCertificateSerial bool + EmailIncludeManagementURL bool + EmailSenderName string + EmailSenderEmail string + EmailRecipients []string + EmailTimeoutSecs int + EmailRetryCount int + EmailRetryIntervalsSecs []int + DNSProvider string + DNSCredentialRef string + DNSVerified bool + CertificateRoot string + WebHostname string + WebPublicIP string + WebEnabled bool + HTTPSMode string } func Apply(cfg *config.Config, input Input) error { @@ -81,6 +96,7 @@ func Apply(cfg *config.Config, input Input) error { cfg.Admin.Username = strings.TrimSpace(input.AdminUsername) cfg.Admin.Email = adminEmail cfg.Admin.PasswordHash = string(hash) + cfg.ACME.AccountEmail = adminEmail cfg.Server.Port = input.ServerPort cfg.Server.HTTPSMode = input.HTTPSMode cfg.Web.Enabled = input.WebEnabled @@ -91,13 +107,66 @@ func Apply(cfg *config.Config, input Input) error { cfg.DNS.Provider = strings.TrimSpace(input.DNSProvider) cfg.DNS.CredentialRef = strings.TrimSpace(input.DNSCredentialRef) cfg.DNS.VerificationState = "verified" + cfg.Notification.HTTPEnabled = input.EmailHTTPEnabled + cfg.Notification.SMTPEnabled = false cfg.Notification.Provider = strings.TrimSpace(input.EmailProvider) cfg.Notification.Endpoint = strings.TrimSpace(input.EmailEndpoint) + if strings.TrimSpace(input.EmailHTTPPath) != "" { + cfg.Notification.HTTPPath = strings.TrimSpace(input.EmailHTTPPath) + } + if strings.TrimSpace(input.EmailHTTPLoginPath) != "" { + cfg.Notification.HTTPLoginPath = strings.TrimSpace(input.EmailHTTPLoginPath) + } + if strings.TrimSpace(input.EmailHTTPAuthMode) != "" { + cfg.Notification.HTTPAuthMode = strings.TrimSpace(input.EmailHTTPAuthMode) + } + cfg.Notification.HTTPCredentialRef = strings.TrimSpace(input.EmailHTTPCredentialRef) + if input.EmailHTTPHeaders != nil { + cfg.Notification.HTTPHeaders = copyHeaders(input.EmailHTTPHeaders) + } + if strings.TrimSpace(input.EmailEventMode) != "" { + cfg.Notification.EventMode = strings.TrimSpace(input.EmailEventMode) + } + cfg.Notification.IncludeDeploymentDetails = input.EmailIncludeDeploymentDetails + cfg.Notification.IncludeCertificateSerial = input.EmailIncludeCertificateSerial + cfg.Notification.IncludeManagementURL = input.EmailIncludeManagementURL + if strings.TrimSpace(input.EmailSenderName) != "" { + cfg.Notification.SenderName = strings.TrimSpace(input.EmailSenderName) + } + if strings.TrimSpace(input.EmailSenderEmail) != "" { + cfg.Notification.SenderEmail = strings.ToLower(strings.TrimSpace(input.EmailSenderEmail)) + } else { + cfg.Notification.SenderEmail = adminEmail + } + if input.EmailTimeoutSecs > 0 { + cfg.Notification.TimeoutSecs = input.EmailTimeoutSecs + } + if input.EmailRetryCount > 0 { + cfg.Notification.RetryCount = input.EmailRetryCount + } + if input.EmailRetryIntervalsSecs != nil { + cfg.Notification.RetryIntervalsSecs = append([]int(nil), input.EmailRetryIntervalsSecs...) + } cfg.Notification.Recipients = cleanRecipients(input.EmailRecipients) + if len(cfg.Notification.Recipients) == 0 { + cfg.Notification.Recipients = []string{adminEmail} + } cfg.SetupReady = true return cfg.Validate() } +func copyHeaders(values map[string]string) map[string]string { + result := make(map[string]string, len(values)) + for key, value := range values { + key = strings.TrimSpace(key) + if key == "" { + continue + } + result[key] = strings.TrimSpace(value) + } + return result +} + func cleanRecipients(values []string) []string { items := make([]string, 0, len(values)) seen := make(map[string]struct{}, len(values)) diff --git a/backend/internal/setup/setup_test.go b/backend/internal/setup/setup_test.go index dfe84a4..3d0086f 100644 --- a/backend/internal/setup/setup_test.go +++ b/backend/internal/setup/setup_test.go @@ -54,3 +54,26 @@ func TestApplyRejectsWebIPAsHostnamePair(t *testing.T) { t.Fatal("域名和公网 IP 同时配置时应被拒绝") } } + +func TestApplyUsesAdminEmailAndStoresNotificationOptions(t *testing.T) { + cfg := config.Default(t.TempDir()) + err := Apply(&cfg, Input{ + AdminUsername: "admin", AdminEmail: "admin@example.com", AdminPassword: "password123", ServerPort: 8080, + EmailHTTPEnabled: true, EmailProvider: "smail", EmailEndpoint: "https://mail.example.test", + EmailHTTPPath: "/api/email/send", EmailHTTPAuthMode: "bearer", EmailHTTPCredentialRef: "secret://mail/token", + EmailHTTPHeaders: map[string]string{" X-Tenant ": " scert "}, EmailEventMode: "detailed", + EmailIncludeDeploymentDetails: true, EmailIncludeCertificateSerial: true, EmailIncludeManagementURL: true, + EmailSenderName: "证书管理", EmailTimeoutSecs: 15, EmailRetryCount: 2, EmailRetryIntervalsSecs: []int{10, 30}, + DNSProvider: "cloudflare", DNSCredentialRef: "credential-1", DNSVerified: true, CertificateRoot: cfg.Paths.Certificate, + WebHostname: "panel.example.com", WebEnabled: true, + }) + if err != nil { + t.Fatalf("保存邮件通知选项失败:%v", err) + } + if len(cfg.Notification.Recipients) != 1 || cfg.Notification.Recipients[0] != "admin@example.com" { + t.Fatalf("未填写收件人时应使用管理员邮箱:%v", cfg.Notification.Recipients) + } + if cfg.Notification.HTTPCredentialRef != "secret://mail/token" || cfg.Notification.HTTPHeaders["X-Tenant"] != "scert" { + t.Fatalf("HTTP 通知配置未正确保存:%+v", cfg.Notification) + } +} diff --git a/deploy/systemd/Scert服务管理说明.md b/deploy/systemd/Scert服务管理说明.md index 276e5cf..e0f773e 100644 --- a/deploy/systemd/Scert服务管理说明.md +++ b/deploy/systemd/Scert服务管理说明.md @@ -18,7 +18,7 @@ systemctl daemon-reload 核心服务的启停应由初始化和运维流程根据配置状态执行。核心服务固定注册 `/reset` 路由,但未检测到有效的 `Scert-admin` 激活租约时统一返回 `404`。`Scert-admin` 不监听独立端口,也不能作为核心服务的自动启动依赖。 -密码重置地址根据初始化时配置的 Web 管理域名或公网 IP 自动生成:主端口为 `443` 时使用 `https://域名或IP/reset`,其他端口使用 `https://域名或IP:主端口/reset`。云安全组和本机防火墙都不需要额外放行密码重置端口。 +密码重置地址根据初始化时配置的 Web 管理域名或公网 IP 自动生成,始终使用 `https://域名或IP/reset`,不在公开地址中暴露主服务监听端口。云安全组和本机防火墙都不需要额外放行密码重置端口。 `/reset` 页面只有在 `Scert-admin` 显式启动且租约有效时开放。提交时必须提供一次性校验码、CSRF 校验值和两次一致的新密码;校验码成功消费后立即失效,密码摘要使用 bcrypt 保存。正式生产部署仍需完成核心服务真实 HTTPS 终止、受保护校验码呈现和目标平台实机验收。 diff --git a/doc/SSL服务程序需求确认文档.md b/doc/SSL服务程序需求确认文档.md index 9700674..07db5ad 100644 --- a/doc/SSL服务程序需求确认文档.md +++ b/doc/SSL服务程序需求确认文档.md @@ -926,7 +926,7 @@ imported 外部导入 - **状态:**`[x]` 已完成基础服务入口,安装器和服务注册尚未完成。 2. **用户补充:**命令行安装启动时,只进行初始化配置:超级管理员用户名、密码、第三方邮箱和 Scert 主服务端口;密码重置功能不再配置独立端口。 - - **实现说明:**`scert init` 使用交互式向导保存上述字段;系统根据 Web 管理域名或公网 IP 与主服务端口自动生成密码重置地址。主端口为 `443` 时地址为 `https://域名或IP/reset`,其他端口为 `https://域名或IP:主端口/reset`。初始化完成后日常管理转由 Web 页面,CLI 保留非交互式状态和自动化能力。 + - **实现说明:**`scert init` 使用交互式向导保存上述字段;系统根据 Web 管理域名或公网 IP 自动生成 `https://域名或IP/reset` 密码重置地址,不在公开地址中暴露主服务监听端口。初始化完成后日常管理转由 Web 页面,CLI 保留非交互式状态和自动化能力。 - **状态:**`[x]` 已完成配置模型和交互式基础流程,第三方邮箱真实适配尚未完成。 3. **用户补充:**配置 DNS API 并进行验证测试。 diff --git a/doc/Scert开发任务清单.md b/doc/Scert开发任务清单.md index 3d4c433..70b29bb 100644 --- a/doc/Scert开发任务清单.md +++ b/doc/Scert开发任务清单.md @@ -50,7 +50,7 @@ ### 2.3 ACME 和证书 - [x] 第一阶段使用 Let’s Encrypt。 -- [x] 使用 `go-acme/lego`,不使用 `acme.sh`。 +- [x] 使用 `go-acme/lego` 作为唯一 ACME 客户端实现。 - [x] 支持 Let’s Encrypt Production 和 Staging。 - [x] 支持 DNS-01 验证。 - [x] 第一阶段支持单域名、泛域名和多域名 SAN 证书。 @@ -200,7 +200,7 @@ Windows: 阶段验收标准: - 需求文档、技术架构文档和任务清单没有互相矛盾的基础决策。 -- 代码开发不再使用已废弃的 `acme.sh` 方案。 +- 代码开发统一使用已确认的 `go-acme/lego` 方案。 - MySQL 5.7 和 MySQL 8.0 的用途明确区分。 --- @@ -1869,14 +1869,14 @@ Linux amd64 可以交叉编译 - [✓] 密码重置服务取消独立监听端口,初始化流程只配置 Scert 主服务端口。 - [✓] 根据 Web 管理域名或公网 IP 自动生成 `/reset` 地址。 -- [✓] 主服务端口为 `443` 时省略端口号,其他端口继续使用主服务端口,不增加新的防火墙或云安全组端口。 +- [✓] `/reset` 公开地址始终使用 `https://域名或IP/reset`,不暴露主服务监听端口,也不增加新的防火墙或云安全组端口。 - [✓] `Scert-admin` 默认不启动,不允许开机自启动,日常控制仍只支持 `systemctl start Scert-admin` 和 `systemctl stop Scert-admin`。 - [✓] `/reset` 只在 `Scert-admin` 显式启动并持有有效租约时临时开放,其他时间隐藏为 `404`。 ### 43.2 开发任务状态 - [✓] 删除配置模型、初始化 API、CLI 和 Web 初始化向导中的独立重置主机与端口字段。 -- [✓] 配置模型新增 `ResetURL()`,支持域名、IPv4、IPv6、`443` 省略端口和非 `443` 主端口。 +- [✓] 配置模型新增 `ResetURL()`,支持域名、IPv4 和 IPv6,并统一生成不带主服务端口的 `https://域名或IP/reset`。 - [✓] 将 `scert-admin` 从独立 HTTP 服务改为无网络监听的短时租约控制器。 - [✓] 启动时生成一次性校验码,状态文件只保存 SHA-256 摘要,不保存明文校验码。 - [✓] 租约有效期设置为 90 秒,每 30 秒刷新;正常停止立即失效,异常退出后自动过期。 @@ -1962,4 +1962,138 @@ Linux amd64 可以交叉编译 ### 45.4 当前状态 - [!] 本轮视觉修改已完成,等待用户确认参考效果。 -- [!] 当前仅完成初始化向导界面优化,不代表 Scert 完整产品的 ACME/lego 签发、自动续期、远程部署和正式 HTTPS 生产验收已完成。 \ No newline at end of file +- [!] 当前仅完成初始化向导界面优化,不代表 Scert 完整产品的 ACME/lego 签发、自动续期、远程部署和正式 HTTPS 生产验收已完成。 +## 四十六、全量开发清单阶段复审记录(2026-08-27) + +### 46.1 本轮需求清单 + +- [x] 执行开发清单中当前可以在本机独立完成的代码、测试、构建和安全复审任务。 +- [x] 修复 CLI 恢复流程中的备份覆盖、源目标相同、目标类型和失败回滚边界。 +- [x] 复审 SQLite 连接可靠性、MySQL DSN 脱敏、证书本地完整性校验和 CLI 备份安全。 +- [x] 复审前端目录拆分、用户可见文字和 HTML 实体问题。 +- [x] 重新执行后端、前端和 Windows/Linux amd64 构建验证。 +- [x] 更新本清单,区分本地复审通过项、已实现但待实机验收项和当前阻塞项。 + +### 46.2 本轮开发任务状态 + +- [x] `backend/internal/cli/operations.go` 的 `restore` 增加恢复输入规范化、当前配置校验、备份数据库普通文件校验、恢复源与目标相同保护、目标类型校验和恢复前备份。 +- [x] 恢复 SQLite 数据库失败时,增加配置和数据库的回滚尝试,并返回明确中文错误。 +- [x] 恢复文件判断改用不跟随符号链接的普通文件检查,避免把符号链接当作安全恢复目标。 +- [x] 补充 CLI 备份、恢复输入、排他复制和路径规范化测试。 +- [x] 保留配置和数据库恢复前备份,不覆盖已有备份文件。 +- [x] 修复 Dashboard 服务器重载命令占位文本中的 HTML 换行实体,改为普通中文界面可读形式。 +- [x] 保留页面公共组件和按页面目录拆分结构:`src/views/components/AccessShell` 与各页面目录分离管理。 + +### 46.3 自动化复审结果 + +- [✓] `go test ./...` 通过。 +- [✓] `go test -race ./...` 通过。 +- [✓] `go vet ./...` 通过。 +- [✓] `go mod verify` 通过。 +- [✓] `npm.cmd run build` 通过。 +- [✓] Windows amd64、`CGO_ENABLED=0` 的 `review-scert-windows-amd64.exe` 和 `review-scert-admin-windows-amd64.exe` 构建通过。 +- [✓] Linux amd64、`CGO_ENABLED=0` 的 `review-scert-linux-amd64` 和 `review-scert-admin-linux-amd64` 构建通过。 +- [✓] `git diff --check` 通过。 +- [✓] 后端 Go 源码和前端源码未发现中文 HTML 实体、Unicode 转义、乱码或旧重置入口类名。 +- [✓] 代码、文档和配置源文件未发现 UTF-8 BOM。 +- [✓] Git 差异未发现删除文件或重命名文件;本轮未执行 Git 提交、推送、重置或清理。 +- [✓] 新构建产物使用 `review-` 前缀,未覆盖 `build` 目录中已有构建文件。 + +### 46.4 已实现但必须继续进行真实环境验收的任务 + +以下任务已有代码或测试基础,但不能仅凭本机自动化测试标记为复审通过: + +- [x] `go-acme/lego`、Let’s Encrypt Production/Staging、DNS-01 Provider 和 CNAME 委派的代码接入边界已保留。 +- [x] 证书本地文件、私钥匹配、完整证书链、有效期、域名覆盖和 SAN 覆盖校验已实现。 +- [x] SSH 私钥加密存储、远程部署工作流、远程证书目录模板和失败回滚的基础能力已实现。 +- [x] HTTP 通知、第三方邮件接口配置、事件模式、认证方式、重试和脱敏配置基础能力已实现。 +- [x] SQLite、MySQL 5.7 和 MySQL 8.0 的数据访问与迁移分支已保留,SQLite 已通过本地专项验证。 +- [x] 需要真实环境继续验证:Let’s Encrypt 申请、各 DNS 服务商 API、CNAME 委派、真实 SSH/SFTP、远程 Windows 10/11、Ubuntu 22.04/24.04、Debian、CentOS/Rocky Linux、Nginx、Caddy、Apache、MySQL 5.7/8.0 实例和云安全组。 +- [x] 需要真实环境继续验证:Linux systemd、Windows Service、本机防火墙真实放行、核心 HTTPS 终止、高级反向代理 HTTPS、Wails 桌面版和浏览器视觉验收。 + +### 46.5 当前阻塞或未完成任务 + +- [!] 真实 Let’s Encrypt 和 DNS Provider 连通性未使用用户生产凭据执行,不能宣称证书申请已经成功。 +- [!] 真实服务器部署和部署后的公网 HTTPS 在线校验尚未完成,不能宣称多服务器部署已经完成。 +- [!] Scert 核心服务生产级 HTTPS 终止、高级反向代理内部 HTTPS 和公开端口独立配置仍需继续开发与实机验证。 +- [!] `Scert-admin` 一次性密码重置仍需受保护的本地校验码呈现机制;不能把标准输出中的校验码方式作为生产方案。 +- [!] Wails 桌面安装器、Windows Service、Linux systemd 安装和跨平台防火墙适配仍需继续开发或实机验收。 +- [!] MySQL 5.7 基础实例连接、MySQL 8.0 兼容迁移和升级回滚尚未完成实机验收。 +- [!] 原清单中仍有大量规划阶段 `[ ]` 条目,不能因为局部代码和自动化测试通过而整体改为 `[✓]`。 + +### 46.6 复审结论 + +本轮已完成当前工作区内可以独立验证的开发、修复和自动化复审,后端测试、竞态检查、静态检查、依赖校验、前端构建和双平台 amd64 构建均通过。恢复流程的安全边界已补强,前端源码中的遗留 HTML 实体已处理。 + +本项目当前结论为:**本地开发复审通过,尚未达到完整产品发布和需求总验收条件**。后续应优先完成真实 ACME/DNS、真实远程部署、正式 HTTPS、认证安全、安装服务、Wails 和 MySQL 双版本实机验收。原有章节中的历史状态和未完成项保留,不进行机械批量改标。 + +## 四十七、Lego DNS Provider 集成与离线复审记录(2026-08-28) + +### 47.1 本轮需求清单 + +- [x] 继续使用 `go-acme/lego` 作为 ACME 和 DNS-01 实现。 +- [x] 接入第一批已确认的 DNS Provider 工厂。 +- [x] 保留 CNAME 委派和其他服务商扩展占位,不虚构尚未完成的适配器。 +- [x] 修正旧测试中将阿里云 DNS 错误标记为未开放的问题。 +- [x] 单元测试不得因伪造凭据访问真实云 API。 + +### 47.2 本轮开发任务状态 + +- [x] 接入 Cloudflare、阿里云 DNS、DNSPod、华为云、腾讯云、AWS Route 53 和 Google Cloud DNS 的 lego Provider 构造工厂。 +- [x] 为新增 lego Provider 补齐 Go 模块依赖和校验和。 +- [x] 为已接入 Provider 增加构造级测试。 +- [x] 保留 CNAME 委派和其他服务商的类型化未开放错误。 +- [x] 华为云测试改为无效区域校验,避免单元测试触发真实鉴权请求。 +- [x] Google Cloud 测试使用格式错误的服务账号 JSON 验证已接入且错误可识别。 + +### 47.3 本轮验证状态 + +- [✓] `go test ./internal/dnsprovider` 通过。 +- [✓] `go test -race ./internal/dnsprovider` 通过。 +- [✓] `go vet ./internal/dnsprovider` 通过。 +- [✓] `go test ./...` 通过。 +- [✓] `go test -race ./...` 通过。 +- [✓] `go vet ./...` 通过。 +- [✓] `go mod verify` 通过。 +- [✓] `npm.cmd run build` 通过。 +- [✓] `git diff --check` 通过;换行格式提示不属于差异错误。 + +### 47.4 当前边界 + +- [x] Provider 工厂和凭据字段映射已完成本地代码级接入,等待真实环境验收。 +- [!] 本轮未使用真实 DNS API 凭据,不能将 DNS 权限测试、记录创建清理和证书申请标记为生产验收通过。 +- [!] 华为云 lego 构造过程可能在有效凭据下请求项目区域信息,真实测试必须放在集成测试或用户明确授权的环境中。 +- [!] CNAME 委派和其他服务商仍属于扩展占位,未接入自动创建、检查和清理流程。 + +### 47.5 复审结论 + +本轮完成了第一批 lego DNS Provider 的工厂接入、依赖锁定和离线测试修正。全量后端测试、竞态检查、静态检查、模块校验和前端构建均通过。真实 DNS 服务商权限、DNS-01 记录生命周期和 Let’s Encrypt 证书签发仍需在受控真实环境中继续验收。 + +## 四十八、HTTP 邮件通知会话认证与中文编码修复记录(2026-08-28) + +### 48.1 本轮需求清单 + +- [✓] 使用 UTF-8 编码发送登录请求和邮件通知请求。 +- [✓] HTTP 通知请求声明 `application/json; charset=utf-8`。 +- [✓] 检查邮件服务统一响应中的 `errorNo`,不能只依据 HTTP 200 判断成功。 +- [✓] 会话认证收到 HTTP 401、403 或对应业务错误码时,重试前重新登录。 +- [✓] 保留会话认证密码原文,不因校验而修改合法密码内容。 +- [✓] 初始化向导支持“账号登录会话”和自定义登录路径。 +- [✓] CLI 支持修改 `notification.http_login_path`。 +- [✓] 增加中文 UTF-8、业务失败和会话刷新回归测试。 + +### 48.2 本轮验证状态 + +- [✓] `go test ./...` 通过。 +- [✓] `go test -race ./...` 通过。 +- [✓] `go vet ./...` 通过。 +- [✓] `go mod verify` 通过。 +- [✓] `npm.cmd run build` 通过。 +- [✓] `git diff --check` 通过。 +- [!] 临时邮件服务此前由 Windows PowerShell 默认编码发送的旧邮件已经乱码,无法在服务端原地修复;该邮件已保留作为问题记录。 +- [✓] 使用明确 UTF-8 请求重新发送唯一测试邮件,并通过邮件列表和详情接口确认标题、纯文本、HTML 正文均为正常中文,状态为成功且错误为空。 +- [!] 本轮验证的是临时邮件服务的服务端列表与详情结果,尚未在最终收件邮箱客户端中完成到达、编码和渲染复核。 + +### 48.3 复审结论 + +本轮已完成 HTTP 邮件通知的 UTF-8 编码、业务响应判断、会话失效刷新和配置入口开发,并通过自动化验证;同时已通过临时邮件服务的接口详情确认修复后的中文内容正常。Scert 代码链路已经避免因客户端默认字符集导致的中文乱码,但最终收件邮箱客户端的到达和渲染仍需在发布环境继续复核。 diff --git a/doc/后端接口说明文档.md b/doc/后端接口说明文档.md new file mode 100644 index 0000000..23c5591 --- /dev/null +++ b/doc/后端接口说明文档.md @@ -0,0 +1,770 @@ +# Smail 后端接口说明文档 + +> 本文档用于说明当前 Smail 后端 HTTP API 的实际调用方式,并对照原版 PMail《后端接口文档》核对接口是否仍然存在。 +> +> 核对基准:当前代码分支 `main`,提交 `6ec4628`,核对日期:2026-08-27。 + +## 1. 文档范围和结论 + +原版 PMail 文档包含 9 个基础接口。当前 Smail 仍然保留其中 8 个接口的功能入口,但有以下路径或调用方式变化: + +| 编号 | 原版接口 | 当前实际接口 | 当前状态 | 主要差异 | +|---|---|---|---|---| +| 1 | `/api/ping` | `/api/ping` | 存在 | 当前返回统一 JSON,不再是纯文本 `pong` | +| 2 | `/api/login` | `/api/login` | 存在 | 只接受 `POST`;使用会话 Cookie 和 CSRF Cookie,不使用原版文档所述的 `token` 请求头 | +| 3 | `/api/group` | `/api/group` | 部分兼容 | 当前只接受 `GET`,原版写的 `POST` 不再可用;另有 `/api/group/list` | +| 4 | `/api/email/list` | `/api/email/list` | 存在 | 只接受 `POST`,分页参数增加范围限制 | +| 5 | `/api/detail` | `/api/email/detail` | 路径已变更 | 原路径不存在,必须使用 `/api/email/detail` | +| 6 | `/api/email/send` | `/api/email/send` | 存在 | 只接受 `POST`,增加发件人校验、附件和收件人数限制 | +| 7 | `/api/settings/modify_password` | `/api/settings/modify_password` | 存在 | 当前需要同时提交 `current_password` 和 `password` | +| 8 | `/attachments/` | `/attachments/{邮件ID}/{内容标识}` | 存在 | 当前只接受 `GET`,用于内联展示附件内容 | +| 9 | `/attachments/download/` | `/attachments/download/{邮件ID}/{附件序号}` | 存在 | 当前只接受 `GET`,最后一段是附件序号,不是附件数据库 ID | + +当前路由注册以 `server/listen/http_server/http_server.go` 为准,接口处理逻辑以 `server/controllers` 和 `server/controllers/email` 为准。 + +## 2. 通用调用约定 + +### 2.1 基础地址 + +以下示例使用: + +```text +https://mail.example.com +``` + +请替换为实际的 Smail Web 地址。开发环境也可以使用: + +```text +http://127.0.0.1:80 +``` + +生产环境应优先使用 HTTPS。 + +### 2.2 通用响应格式 + +除附件内容下载接口外,JSON 接口统一返回以下结构: + +```json +{ + "errorNo": 0, + "errorMsg": "", + "data": {} +} +``` + +字段说明: + +| 字段 | 类型 | 说明 | +|---|---|---| +| `errorNo` | number | `0` 表示成功;非 `0` 表示失败。常见值:`100` 参数错误、`403` 未登录、`405` 无权限、`500` 服务端错误 | +| `errorMsg` | string | 错误说明。生产环境不应依赖错误文本判断业务分支,应优先判断 `errorNo` | +| `data` | any | 成功数据或错误附加数据 | + +请求方法不正确时,路由层返回 HTTP `405 Method Not Allowed`,并通过 `Allow` 响应头提示允许的方法;此时不一定返回上面的 JSON 结构。 + +### 2.3 登录态和 CSRF + +除探活、登录和公开的密码恢复流程外,邮件、分组、密码修改等接口都需要登录态。 + +登录成功后,服务端会设置: + +1. 会话 Cookie,用于识别登录用户; +2. `smail_csrf` Cookie,用于保存 CSRF Token; +3. 后续状态修改请求需要在 `X-CSRF-Token` 请求头中提交与 `smail_csrf` Cookie 相同的值。 + +对于携带登录会话 Cookie 的状态修改请求,还需要使用同源的 `Origin`;跨站请求或 CSRF Token 不匹配时会被拒绝。 + +建议使用浏览器或 HTTP 客户端的 Cookie Jar 保存登录后的 Cookie,不要手工复制会话 Cookie 到代码或日志中。 + +### 2.4 请求头 + +JSON 请求通常应携带: + +```http +Content-Type: application/json +``` + +需要登录的状态修改请求示例: + +```http +Cookie: 会话Cookie; smail_csrf=CSRF_TOKEN +X-CSRF-Token: CSRF_TOKEN +Origin: https://mail.example.com +``` + +`Lang` 请求头可以指定返回语言,例如: + +```http +Lang: zh-CN +``` + +未指定时由服务端使用默认语言处理。 + +### 2.5 通用错误处理 + +调用方建议按以下顺序处理: + +1. 先检查 HTTP 状态码; +2. 对 JSON 响应解析 `errorNo`、`errorMsg` 和 `data`; +3. 收到 `403` 或业务错误码表示登录失效时,重新登录; +4. 收到 `405` 时检查请求方法,不要重试相同方法; +5. 不要把密码、会话 Cookie、CSRF Token、完整邮箱地址写入日志。 + +## 3. 原版基础接口对照和调用说明 + +## 3.1 服务探活 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 原版路径 | `/api/ping` | +| 当前路径 | `/api/ping` | +| 当前方法 | `GET`、`POST` 均可到达处理器;建议使用 `GET` | +| 是否需要登录 | 否 | +| 请求体 | 无 | +| 返回类型 | JSON | + +### 调用示例 + +```bash +curl -X GET "https://mail.example.com/api/ping" +``` + +也可以使用: + +```bash +curl -X POST "https://mail.example.com/api/ping" +``` + +### 返回示例 + +```json +{ + "errorNo": 0, + "errorMsg": "", + "data": "pong" +} +``` + +### 与原版差异 + +原版文档把返回格式写成 `text`,示例为纯文本 `pong`。当前代码通过统一响应封装返回 JSON,实际数据位于 `data` 字段中。 + +## 3.2 用户登录 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 原版路径 | `/api/login` | +| 当前路径 | `/api/login` | +| 方法 | `POST` | +| 是否需要登录 | 否 | +| 请求格式 | `application/json` | +| 返回类型 | JSON | + +### 请求参数 + +| 参数 | 类型 | 必填 | 说明 | +|---|---|---:|---| +| `identifier` | string | 否 | 登录标识。当前优先使用该字段,可填写账号或完整邮箱 | +| `account` | string | 否 | 兼容原版字段。当 `identifier` 为空时使用该字段 | +| `password` | string | 是 | 登录密码 | + +`identifier` 和 `account` 至少提供一个。为了兼容原版客户端,可以继续提交 `account`;新客户端建议使用 `identifier`。 + +### 调用示例 + +兼容原版字段: + +```bash +curl -X POST "https://mail.example.com/api/login" \ + -H "Content-Type: application/json" \ + -c cookies.txt \ + -d '{ + "account": "admin", + "password": "your-password" + }' +``` + +使用新的登录标识字段: + +```bash +curl -X POST "https://mail.example.com/api/login" \ + -H "Content-Type: application/json" \ + -c cookies.txt \ + -d '{ + "identifier": "admin@example.com", + "password": "your-password" + }' +``` + +### 成功返回示例 + +普通登录直接完成时,返回: + +```json +{ + "errorNo": 0, + "errorMsg": "", + "data": { + "account": "admin", + "name": "管理员", + "role": "super_admin", + "is_admin": 1, + "domains": [ + "example.com" + ] + } +} +``` + +登录成功时,服务端同时通过 `Set-Cookie` 设置会话 Cookie 和 CSRF Cookie。客户端必须保存这两个 Cookie,后续接口才能继续调用。 + +### 二次验证情况 + +如果当前账号启用了登录二次验证,密码正确后可能返回一个待完成的验证数据,而不是直接建立完整登录态。客户端应根据返回的 `data` 调用登录验证接口: + +```text +POST /api/security/login/verify +``` + +该流程不属于原版 PMail 基础接口,详细接口以本文第 4 节的当前安全接口表和前端调用为准。 + +### 失败返回示例 + +```json +{ + "errorNo": 100, + "errorMsg": "参数错误", + "data": "" +} +``` + +为了防止账号枚举,登录失败、账号不存在、密码错误和登录限流通常使用相同的业务错误响应,调用方不要根据错误文本判断账号是否存在。 + +### 与原版差异 + +原版文档提到可以通过请求头 `token` 进行验签。当前代码路由和认证逻辑未发现该兼容方式,当前登录态以服务端会话 Cookie 为准,不应使用 `token` 请求头替代登录。 + +## 3.3 获取邮件分组树 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 原版路径 | `/api/group` | +| 当前路径 | `/api/group` | +| 方法 | `GET` | +| 原版方法 | `POST/GET` | +| 是否需要登录 | 是 | +| 请求体 | 无 | +| 返回类型 | JSON | + +当前 `/api/group` 只注册了 `GET`。使用原版文档中的 `POST` 调用会返回 HTTP `405`。 + +### 调用示例 + +```bash +curl -X GET "https://mail.example.com/api/group" \ + -b cookies.txt +``` + +如果是浏览器外的状态修改场景,读取接口不需要提交 CSRF Token;但必须携带有效会话 Cookie。 + +### 返回示例 + +```json +{ + "errorNo": 0, + "errorMsg": "", + "data": [ + { + "label": "收件箱", + "tag": "{\"type\":0,\"status\":-1,\"group_id\":0}" + }, + { + "label": "发件箱", + "tag": "{\"type\":1,\"status\":-1}" + }, + { + "label": "草稿箱", + "tag": "{\"type\":0,\"status\":4}" + } + ] +} +``` + +### 当前相关分组接口 + +| 方法 | 路径 | 说明 | 请求体 | +|---|---|---|---| +| `GET` | `/api/group` | 获取前端使用的分组树 | 无 | +| `GET` | `/api/group/list` | 获取默认分组和用户自定义分组列表 | 无 | +| `POST` | `/api/group/add` | 创建自定义分组 | `{"name":"项目邮件","parent_id":0}` | +| `POST` | `/api/group/del` | 删除自定义分组 | `{"id":1}` | + +`POST /api/group/add` 和 `POST /api/group/del` 属于状态修改接口,需要登录态和 CSRF Token。 + +## 3.4 获取邮件列表 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 路径 | `/api/email/list` | +| 方法 | `POST` | +| 是否需要登录 | 是 | +| 请求格式 | `application/json` | +| 返回类型 | JSON | + +### 请求参数 + +| 参数 | 类型 | 必填 | 默认值 | 说明 | +|---|---|---:|---:|---| +| `keyword` | string | 否 | 空字符串 | 邮件搜索关键词,最多 512 字节 | +| `tag` | string | 否 | 全部邮件 | JSON 字符串形式的筛选条件 | +| `current_page` | integer | 否 | `1` | 当前页,从 `1` 开始,最大 `10000` | +| `page_size` | integer | 否 | `15` | 每页数量,最大 `100` | + +`tag` 是一个字符串字段,内容需要再次编码为 JSON,例如: + +```json +"{\"type\":0,\"status\":-1,\"group_id\":0}" +``` + +### 调用示例 + +```bash +curl -X POST "https://mail.example.com/api/email/list" \ + -H "Content-Type: application/json" \ + -b cookies.txt \ + -H "X-CSRF-Token: CSRF_TOKEN" \ + -H "Origin: https://mail.example.com" \ + -d '{ + "keyword": "验证码", + "tag": "{\"type\":0,\"status\":-1,\"group_id\":0}", + "current_page": 1, + "page_size": 15 + }' +``` + +### 返回示例 + +```json +{ + "errorNo": 0, + "errorMsg": "", + "data": { + "current_page": 1, + "total_page": 1, + "list": [ + { + "id": 1, + "title": "邮件标题", + "desc": "邮件正文摘要", + "datetime": "2026-08-27 08:44:00", + "is_read": false, + "sender": { + "Name": "发件人", + "EmailAddress": "sender@example.com" + }, + "to": [ + { + "Name": "收件人", + "EmailAddress": "admin@example.com" + } + ], + "dangerous": false, + "error": "" + } + ] + } +} +``` + +### 分页说明 + +- 不提交分页参数时使用 `current_page=1`、`page_size=15`; +- `current_page` 小于 `1` 或大于 `10000` 会被拒绝; +- `page_size` 小于 `1` 或大于 `100` 会被拒绝; +- `keyword` 超过 512 字节会被拒绝; +- `total_page` 在没有邮件时为 `0`。 + +## 3.5 获取邮件详情 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 原版路径 | `/api/detail` | +| 当前路径 | `/api/email/detail` | +| 方法 | `POST` | +| 是否需要登录 | 是 | +| 请求格式 | `application/json` | +| 返回类型 | JSON | + +### 请求参数 + +| 参数 | 类型 | 必填 | 说明 | +|---|---|---:|---| +| `id` | integer | 是 | 邮件 ID,必须大于 `0` | + +### 调用示例 + +```bash +curl -X POST "https://mail.example.com/api/email/detail" \ + -H "Content-Type: application/json" \ + -b cookies.txt \ + -H "X-CSRF-Token: CSRF_TOKEN" \ + -H "Origin: https://mail.example.com" \ + -d '{ + "id": 1 + }' +``` + +### 返回示例 + +```json +{ + "errorNo": 0, + "errorMsg": "", + "data": { + "id": 1, + "type": 0, + "subject": "邮件标题", + "reply_to": "", + "from_name": "发件人", + "from_address": "sender@example.com", + "to": "[{\"Name\":\"收件人\",\"EmailAddress\":\"admin@example.com\"}]", + "bcc": "[]", + "cc": "[]", + "sender": "{\"Name\":\"发件人\",\"EmailAddress\":\"sender@example.com\"}", + "spf_check": 1, + "dkim_check": 1, + "status": 1, + "send_time": "2026-08-27 08:44:00", + "send_date": "2026-08-27 08:44:00", + "update_time": "2026-08-27 08:44:00", + "create_time": "2026-08-27 08:44:00", + "text": "纯文本正文", + "html": "
HTML正文
", + "error": "", + "attachments": [ + { + "Filename": "report.pdf", + "ContentType": "application/pdf", + "Index": 0 + } + ] + } +} +``` + +### 与原版差异 + +原版文档使用 `/api/detail`。当前该路径没有注册,必须改为 `/api/email/detail`。邮件详情请求会标记邮件为已读,因此调用该接口不是纯读取操作;使用 `POST` 也符合当前路由约束。 + +## 3.6 发送邮件 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 路径 | `/api/email/send` | +| 方法 | `POST` | +| 是否需要登录 | 是 | +| 请求格式 | `application/json` | +| 返回类型 | JSON | +| 请求体上限 | 40 MiB | + +### 请求参数 + +| 参数 | 类型 | 必填 | 说明 | +|---|---|---:|---| +| `reply_to` | array | 否 | 回复地址列表,每项包含 `name`、`email` | +| `from` | object | 否 | 发件人,包含 `name`、`email`;邮箱为空时使用当前账号地址 | +| `to` | array | 是 | 收件人列表,每项包含 `name`、`email` | +| `bcc` | array | 否 | 密送列表 | +| `cc` | array | 否 | 抄送列表 | +| `subject` | string | 是 | 邮件标题 | +| `text` | string | 否 | 纯文本正文 | +| `html` | string | 否 | HTML 正文 | +| `sender` | object | 否 | SMTP Envelope Sender;为空时使用 `from` | +| `read_receipt` | array | 否 | 已读回执地址列表 | +| `attrs` | array | 否 | 附件列表,每项包含 `name`、`data` | + +`attrs[].data` 必须是 Data URL 格式的 Base64 数据,例如: + +```text +data:application/pdf;base64,BASE64_DATA +``` + +### 调用示例 + +```bash +curl -X POST "https://mail.example.com/api/email/send" \ + -H "Content-Type: application/json" \ + -b cookies.txt \ + -H "X-CSRF-Token: CSRF_TOKEN" \ + -H "Origin: https://mail.example.com" \ + -d '{ + "from": { + "name": "管理员", + "email": "admin@example.com" + }, + "to": [ + { + "name": "收件人", + "email": "user@example.com" + } + ], + "cc": [], + "bcc": [], + "subject": "测试邮件", + "text": "这是纯文本正文。", + "html": "

这是 HTML 正文。

", + "attrs": [] + }' +``` + +### 成功返回 + +```json +{ + "errorNo": 0, + "errorMsg": "", + "data": "操作成功" +} +``` + +接口返回成功表示邮件已经通过参数校验并创建发送任务。实际投递结果可能在异步处理后才确定,失败信息会写入邮件状态,调用方应通过邮件列表或详情接口检查最终状态。 + +### 当前限制 + +- `to` 至少包含一个收件人; +- `to`、`cc`、`bcc`、`reply_to` 合计最多 `100` 个地址; +- 附件最多 `20` 个; +- 单个附件最大 `10 MiB`; +- 附件总大小最大 `25 MiB`; +- 邮件正文最大约 `8 MiB`; +- `subject` 必填; +- 普通用户不能伪造未授权的内部发件人地址; +- 附件文件名会进行路径和控制字符清理。 + +## 3.7 修改当前账号密码 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 原版路径 | `/api/settings/modify_password` | +| 当前路径 | `/api/settings/modify_password` | +| 方法 | `POST` | +| 是否需要登录 | 是 | +| 请求格式 | `application/json` | +| 返回类型 | JSON | + +### 请求参数 + +| 参数 | 类型 | 必填 | 说明 | +|---|---|---:|---| +| `current_password` | string | 是 | 当前密码 | +| `password` | string | 是 | 新密码,长度为 8 到 256 字节 | + +### 调用示例 + +```bash +curl -X POST "https://mail.example.com/api/settings/modify_password" \ + -H "Content-Type: application/json" \ + -b cookies.txt \ + -H "X-CSRF-Token: CSRF_TOKEN" \ + -H "Origin: https://mail.example.com" \ + -d '{ + "current_password": "old-password", + "password": "new-password" + }' +``` + +### 成功返回 + +```json +{ + "errorNo": 0, + "errorMsg": "", + "data": "操作成功" +} +``` + +修改成功后,当前账号的安全凭据和登录会话会按服务端策略刷新或撤销。调用方如果收到会话失效,应重新登录并重新获取 CSRF Token。 + +### 与原版差异 + +原版示例中的 `passowrd` 是拼写错误,当前代码使用正确字段 `password`。当前接口还要求提供 `current_password`,不能只提交新密码。 + +## 3.8 内联获取附件内容 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 原版路径 | `/attachments/` | +| 当前路径 | `/attachments/{邮件ID}/{内容标识}` | +| 方法 | `GET` | +| 原版方法 | 文档写成 `POST`,但请求示例使用 `GET` | +| 是否需要登录 | 是 | +| 返回类型 | 附件原始内容 | + +其中: + +- `{邮件ID}` 是邮件 ID; +- `{内容标识}` 是邮件详情中附件的内容标识,通常对应内联资源的 Content-ID; +- 当前处理器会按路径读取这两个值,并检查当前用户是否有权访问该邮件附件。 + +### 调用示例 + +```bash +curl -X GET "https://mail.example.com/attachments/1/image001.png" \ + -b cookies.txt \ + -o image001.png +``` + +### 返回说明 + +成功时返回附件原始字节,并设置对应的 `Content-Type`,例如: + +```http +Content-Type: image/png +``` + +失败时返回统一 JSON 错误响应。常见原因包括路径格式错误、附件不存在、附件不可用或当前用户无权访问。 + +## 3.9 下载附件 + +### 接口信息 + +| 项目 | 内容 | +|---|---| +| 原版路径 | `/attachments/download/` | +| 当前路径 | `/attachments/download/{邮件ID}/{附件序号}` | +| 方法 | `GET` | +| 是否需要登录 | 是 | +| 返回类型 | 文件流 | + +其中 `{附件序号}` 是邮件详情 `attachments` 数组中的 `Index`,当前从 `0` 开始,不是附件数据库 ID。 + +### 调用示例 + +```bash +curl -X GET "https://mail.example.com/attachments/download/1/0" \ + -b cookies.txt \ + -o report.pdf +``` + +### 返回响应头 + +成功时服务端返回: + +```http +Content-Type: application/octet-stream +X-Content-Type-Options: nosniff +Content-Disposition: attachment; filename="attachment"; filename*=UTF-8''report.pdf +``` + +服务端会清理文件名中的路径分隔符、换行符和控制字符,避免下载文件名被用于路径穿越或响应头注入。 + +## 4. 当前新增安全和账户接口 + +这些接口不在原版 PMail 的 9 个基础接口中,但已经注册在当前 Smail 路由中。它们属于当前前端登录、安全设置和密码恢复流程的一部分。 + +### 4.1 登录和恢复流程 + +| 方法 | 路径 | 是否公开 | 说明 | +|---|---|---:|---| +| `POST` | `/api/security/verification/request` | 否 | 请求验证信息 | +| `POST` | `/api/security/verification/verify` | 否 | 校验验证信息 | +| `POST` | `/api/security/login/verify` | 是 | 完成登录二次验证 | +| `POST` | `/api/security/recovery/begin` | 是 | 开始密码恢复流程 | +| `POST` | `/api/security/recovery/verify` | 是 | 校验密码恢复凭据 | +| `POST` | `/api/security/recovery/complete` | 是 | 完成密码恢复 | +| `POST` | `/api/security/recovery/webauthn/begin` | 是 | 开始 WebAuthn 恢复验证 | +| `POST` | `/api/security/recovery/webauthn/verify` | 是 | 完成 WebAuthn 恢复验证 | +| `POST` | `/api/logout` | 否 | 退出当前会话 | + +### 4.2 WebAuthn 和恢复码 + +| 方法 | 路径 | 说明 | +|---|---|---| +| `POST` | `/api/security/webauthn/registration/begin` | 开始注册安全密钥 | +| `POST` | `/api/security/webauthn/registration/finish` | 完成注册安全密钥 | +| `GET` | `/api/security/webauthn/credentials` | 查询当前账号安全密钥 | +| `POST` | `/api/security/webauthn/credentials/rename` | 重命名安全密钥 | +| `POST` | `/api/security/webauthn/credentials/revoke` | 撤销安全密钥 | +| `POST` | `/api/security/webauthn/login/begin` | 开始登录安全密钥验证 | +| `POST` | `/api/security/webauthn/login/finish` | 完成登录安全密钥验证 | +| `GET` | `/api/security/credentials/recovery-codes` | 查询恢复码状态,不返回历史恢复码原文 | +| `POST` | `/api/security/credentials/recovery-codes/generate` | 生成新的恢复码 | +| `POST` | `/api/security/credentials/recovery-codes/revoke` | 撤销恢复码 | +| 未限制 | `/api/security/credentials/question` | 密保问题相关流程入口,实际方法由处理器判断 | + +### 4.3 外部安全邮箱 + +| 方法 | 路径 | 说明 | +|---|---|---| +| `GET` | `/api/security/external-email/list` | 获取当前账号外部安全邮箱状态 | +| `POST` | `/api/security/external-email/bind` | 绑定外部安全邮箱 | +| `POST` | `/api/security/external-email/verify` | 验证外部安全邮箱 | +| `POST` | `/api/security/external-email/disable` | 禁用外部安全邮箱 | + +以上安全接口的请求参数和恢复状态机依赖当前安全设计,不应按照原版 PMail 的 `token` 模式调用。 + +## 5. 当前邮件和账户管理接口补充 + +| 方法 | 路径 | 说明 | +|---|---|---| +| `POST` | `/api/email/del` | 删除邮件 | +| `POST` | `/api/email/read` | 标记邮件已读 | +| `POST` | `/api/email/move` | 移动邮件到分组 | +| `POST` | `/api/rule/get` | 获取邮件规则 | +| `POST` | `/api/rule/add` | 新增邮件规则 | +| `POST` | `/api/rule/update` | 更新邮件规则 | +| `POST` | `/api/rule/del` | 删除邮件规则 | +| `POST` | `/api/user/create` | 创建用户,权限由当前角色控制 | +| `POST` | `/api/user/edit` | 编辑用户 | +| `POST` | `/api/user/info` | 获取用户信息 | +| `POST` | `/api/user/list` | 获取用户列表 | +| `GET` | `/api/plugin/list` | 获取插件列表 | +| `GET`、`POST` | `/api/plugin/settings/{插件名}/{操作}` | 读取或保存插件设置 | + +配置管理接口使用 `/api/v1/config/` 和 `/api/v1/audits/config` 路径,属于新的配置系统,不属于原版 PMail 基础接口;调用时需要按当前配置授权、审计和 CSRF 规则处理。 + +## 6. 原版接口迁移清单 + +使用原版 PMail 客户端迁移到当前 Smail 时,至少需要修改以下内容: + +| 原版调用 | 当前调用 | +|---|---| +| `POST /api/detail` | `POST /api/email/detail` | +| `POST /api/group` | `GET /api/group` | +| `POST /attachments/{邮件ID}/{附件标识}` | `GET /attachments/{邮件ID}/{附件标识}` | +| 仅提交 `password` 修改密码 | 同时提交 `current_password` 和 `password` | +| 使用 `token` 请求头认证 | 保存登录会话 Cookie,并在状态修改请求中提交 `X-CSRF-Token` | +| 将 `/api/ping` 当作纯文本读取 | 解析 JSON,并读取 `data` 中的 `pong` | + +## 7. 代码核对位置 + +本次对照使用以下当前代码位置作为实现依据: + +- 路由注册:`server/listen/http_server/http_server.go` +- 请求上下文、登录态和 CSRF 校验:`server/listen/http_server/https_server.go` +- 登录:`server/controllers/login.go` +- 分组:`server/controllers/group.go` +- 密码修改:`server/controllers/settings.go` +- 附件:`server/controllers/attachments.go` +- 邮件列表:`server/controllers/email/list.go` +- 邮件详情:`server/controllers/email/detail.go` +- 邮件发送:`server/controllers/email/send.go` +- 统一 JSON 响应:`server/dto/response/response.go` + +原版对照来源为 PMail Wiki 的《后端接口文档》。原版文档仅作为历史兼容性参考,接口是否可调用以当前 Smail 路由和处理器实现为准。 \ No newline at end of file diff --git a/doc/邮件通知配置说明.md b/doc/邮件通知配置说明.md new file mode 100644 index 0000000..04e493a --- /dev/null +++ b/doc/邮件通知配置说明.md @@ -0,0 +1,76 @@ +# 邮件通知配置说明 + +## 1. 配置目的 + +Scert 的证书申请、续期、部署和校验任务完成后,可以通过第三方邮件服务 API 发送通知。SMTP、IMAP、POP3 协议仅作为外部邮件服务兼容性参考,Scert 不实现邮件服务器端;当前已接入 HTTP 邮件 API 通知。 + +## 2. HTTP 邮件服务配置 + +| 配置项 | 说明 | 默认值 | +|---|---|---| +| `email_http_enabled` | 是否启用 HTTP 邮件通知 | `false` | +| `email_provider` | 第三方服务标识 | 空 | +| `email_endpoint` | 第三方服务基础地址,必须使用 HTTP 或 HTTPS | 空 | +| `email_http_path` | 请求路径 | `/api/email/send` | +| `email_http_auth_mode` | `none`、`bearer`、`hmac_sha256` 或 `session` | `none` | +| `email_http_login_path` | 会话认证模式的登录请求路径 | `/api/login` | +| `email_http_credential_ref` | 凭据引用,不填写明文 Token 或密钥 | 空 | +| `email_http_headers` | 自定义请求头 JSON 对象 | `{}` | + +`email_endpoint` 与 `email_http_path` 分开保存。例如 Smail 服务可以配置基础地址为 `https://mail.example.com`,请求路径使用 `/api/email/send`。 + +Bearer Token 或 HMAC-SHA256 的实际密钥必须由凭据存储管理,配置文件只保存 `secret://` 等形式的引用。自定义请求头不能覆盖 `Authorization`、`Cookie`、`Origin`、`Referer`、`Content-Type`、`Accept`、`X-CSRF-Token`、`X-Scert-Signature`、`X-Scert-Request-Id` 和 `X-Scert-Timestamp` 等安全请求头。 + +## 3. Smail 接口适配说明 + +Smail 的发送接口为: + +```text +POST /api/email/send +Content-Type: application/json +``` + +请求体沿用 Smail 的英文字段名,包括 `from`、`to`、`cc`、`bcc`、`subject`、`text`、`html` 和 `attrs`。Scert 的通知发送器应将证书任务事件转换为邮件标题、纯文本正文和 HTML 正文。 + +Smail 当前接口需要登录会话 Cookie、`smail_csrf` Cookie、`X-CSRF-Token` 请求头和同源 `Origin` 请求头。Scert 的 `session` 认证模式会使用凭据存储中的账号和密码调用配置的登录路径,读取登录响应中的会话 Cookie,并在发送邮件时携带会话、CSRF 和同源请求头;密码不会写入请求日志、普通配置文件或错误信息。 + +## 4. 通知内容配置 + +| 配置项 | 说明 | +|---|---| +| `email_event_mode` | `detailed` 表示发送详细事件,`unified` 表示发送统一事件 | +| `email_include_deployment_details` | 是否包含服务器部署明细 | +| `email_include_certificate_serial` | 是否包含证书序列号 | +| `email_include_management_url` | 是否包含管理后台链接 | +| `email_sender_name` | 发件人名称,默认 `Scert` | +| `email_sender_email` | 发件人地址,留空时使用超级管理员绑定邮箱 | +| `recipients` | 收件人列表;未填写时自动使用超级管理员绑定邮箱 | + +## 5. 超时与重试 + +| 配置项 | 说明 | 默认值 | +|---|---|---| +| `email_timeout_secs` | 单次通知请求超时时间 | `10` | +| `email_retry_count` | 失败后的重试次数 | `3` | +| `email_retry_intervals_secs` | 每次重试前等待的秒数 | `30,120,600` | + +重试间隔数量必须与重试次数一致。HTTP 通知发送器应将所有 2xx 响应视为请求成功,其他状态码进入重试或失败流程,并记录请求 ID 和最终错误。 + +## 6. 当前实现边界 + +当前阶段已完成邮件通知配置的保存、校验、初始化接口、CLI/Web 表单接入和 HTTP 通知发送器。SMTP 发送器尚未接入;当前应优先使用 HTTP 邮件 API 方式配置邮件服务。Smail 登录会话可通过 `session` 认证模式自动建立和刷新。 + +## 7. 当前开发状态补充 + +当前版本已经接入 HTTP 邮件通知发送器,支持以下能力: + +- 按证书申请、续期、导入和部署结果生成通知事件。 +- 按 Smail `/api/email/send` 接口格式发送 JSON 请求。 +- 支持 `none`、`bearer`、`hmac_sha256` 和 `session` 四种 HTTP 认证模式。 +- `session` 模式支持配置登录路径;收到 HTTP 401、403 或对应业务错误码时,会在重试前重新登录并使用新会话发送。 +- 使用加密凭据存储读取 Bearer Token 或 HMAC 签名密钥,配置文件只保存凭据引用。 +- 使用 `X-Scert-Request-Id`、`X-Scert-Timestamp` 请求头,并禁止自定义请求头覆盖安全头。 +- 将所有 2xx 响应视为成功,其他响应按重试配置处理。 +- 证书工作流会在任务成功、失败或部署错误后触发通知;通知发送失败会写入 Scert 日志,不覆盖原证书任务结果。 + +SMTP 发送器仍未接入。初始化界面和 CLI 不再暴露 SMTP 开关,旧配置字段仅为兼容已有配置文件保留,并不会在初始化时启用。Smail 登录会话的自动适配已通过 `session` 模式接入,仍需在目标部署环境使用实际凭据进行上线前复核。 diff --git a/frontend/src/views/Dashboard/Dashboard.vue b/frontend/src/views/Dashboard/Dashboard.vue index dbdb683..6010fcf 100644 --- a/frontend/src/views/Dashboard/Dashboard.vue +++ b/frontend/src/views/Dashboard/Dashboard.vue @@ -336,7 +336,7 @@ const { name="sans" v-model="form.sans" rows="4" - placeholder="www.example.com api.example.com" + placeholder="www.example.com\napi.example.com" >
@@ -547,7 +547,7 @@ const { >

{{ serverFormError }}

diff --git a/frontend/src/views/Login/Login.js b/frontend/src/views/Login/Login.js index cbcf39b..bb9ce01 100644 --- a/frontend/src/views/Login/Login.js +++ b/frontend/src/views/Login/Login.js @@ -1,9 +1,9 @@ import { computed, ref } from "vue"; const roleLabels = { - super_admin: "\u8d85\u7ea7\u7ba1\u7406\u5458", - admin: "\u7ba1\u7406\u5458", - user: "\u666e\u901a\u7528\u6237", + super_admin: "超级管理员", + admin: "管理员", + user: "普通用户", }; export function useLogin() { @@ -16,21 +16,21 @@ export function useLogin() { const accountRole = ref(""); const accountName = ref(""); - const identifierLabel = "\u7528\u6237\u540d\u6216\u90ae\u7bb1"; - const identifierPlaceholder = "\u8bf7\u8f93\u5165\u7528\u6237\u540d\u6216\u7ed1\u5b9a\u90ae\u7bb1"; + const identifierLabel = "用户名或邮箱"; + const identifierPlaceholder = "请输入用户名或绑定邮箱"; const stageTitle = computed(() => { - if (stage.value === "totp") return "\u4e24\u6b65\u9a8c\u8bc1"; - if (stage.value === "external_email") return "\u90ae\u7bb1\u9a8c\u8bc1"; + if (stage.value === "totp") return "两步验证"; + if (stage.value === "external_email") return "邮箱验证"; if (stage.value === "complete") { - return `${roleLabels[accountRole.value] || "\u7528\u6237"}\u767b\u5f55\u6210\u529f`; + return `${roleLabels[accountRole.value] || "用户"}登录成功`; } - return "\u7ba1\u7406\u5458\u767b\u5f55"; + return "管理员登录"; }); const stageMessage = computed(() => { - if (stage.value === "totp") return "\u8be5\u8d26\u6237\u8fd8\u9700\u5b8c\u6210\u4e24\u6b65\u9a8c\u8bc1\u3002"; - if (stage.value === "external_email") return "\u8be5\u8d26\u6237\u8fd8\u9700\u5b8c\u6210\u7b2c\u4e09\u65b9\u90ae\u7bb1\u9a8c\u8bc1\u3002"; - if (stage.value === "complete") return "\u6b63\u5728\u8fdb\u5165 Scert \u7ba1\u7406\u540e\u53f0\u3002"; - return "\u8bf7\u8f93\u5165\u7528\u6237\u540d\u6216\u90ae\u7bb1\u3002\u8d26\u6237\u6743\u9650\u7531\u670d\u52a1\u7aef\u81ea\u52a8\u8bc6\u522b\u3002"; + if (stage.value === "totp") return "该账户还需完成两步验证。"; + if (stage.value === "external_email") return "该账户还需完成第三方邮箱验证。"; + if (stage.value === "complete") return "正在进入 Scert 管理后台。"; + return "请输入用户名或邮箱。账户权限由服务端自动识别。"; }); function resetStage() { @@ -44,11 +44,11 @@ export function useLogin() { if (submitting.value || stage.value !== "credentials") return; error.value = ""; if (!identifier.value.trim()) { - error.value = "\u8bf7\u8f93\u5165\u7528\u6237\u540d\u6216\u90ae\u7bb1\u3002"; + error.value = "请输入用户名或邮箱。"; return; } if (!password.value) { - error.value = "\u8bf7\u8f93\u5165\u5bc6\u7801\u3002"; + error.value = "请输入密码。"; return; } @@ -66,7 +66,7 @@ export function useLogin() { }); const result = await response.json().catch(() => ({})); if (!response.ok) { - throw new Error(result.error || "\u767b\u5f55\u5931\u8d25\uff0c\u8bf7\u7a0d\u540e\u91cd\u8bd5"); + throw new Error(result.error || "登录失败,请稍后重试"); } accountRole.value = result.role || ""; @@ -76,7 +76,7 @@ export function useLogin() { window.setTimeout(() => window.location.assign("/"), 600); } } catch (err) { - error.value = err.message || "\u767b\u5f55\u5931\u8d25\uff0c\u8bf7\u7a0d\u540e\u91cd\u8bd5"; + error.value = err.message || "登录失败,请稍后重试"; } finally { submitting.value = false; } diff --git a/frontend/src/views/SetupWizard/SetupWizard.css b/frontend/src/views/SetupWizard/SetupWizard.css index 1995c16..b492217 100644 --- a/frontend/src/views/SetupWizard/SetupWizard.css +++ b/frontend/src/views/SetupWizard/SetupWizard.css @@ -130,6 +130,8 @@ color: #ffe5ad; } .setup-card { + width: 100%; + height: 100%; min-width: 0; min-height: 0; display: flex; @@ -273,6 +275,33 @@ legend span { .two-columns { grid-template-columns: repeat(2, minmax(0, 1fr)); } + +.three-columns { + grid-template-columns: repeat(3, minmax(0, 1fr)); +} + +.compact-options { + gap: 6px; +} + +.compact-row { + min-height: 38px; + padding: 6px 8px; +} + +.compact-row span { + min-width: 0; +} + +.compact-row strong { + white-space: nowrap; +} + +.compact-row small { + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} label { min-width: 0; display: grid; @@ -282,6 +311,20 @@ label { font-size: 10px; font-weight: 800; } +.email-input-group { + min-width: 0; + display: grid; + grid-template-columns: minmax(0, 1fr) minmax(88px, 112px); + gap: 6px; +} +.email-input-group input, +.email-input-group select { + min-width: 0; + width: 100%; + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} input, select, textarea { @@ -1250,6 +1293,15 @@ footer .back-button { select { height: 26px; } + .email-field { + grid-column: 1 / -1; + } + + + .email-input-group { + grid-template-columns: minmax(0, 1fr) minmax(74px, 92px); + gap: 5px; + } footer { min-height: 34px; @@ -1305,3 +1357,241 @@ footer .back-button { font-size: 8px; } } +/* 移动端步骤内容压缩,确保复杂配置步骤完整显示 */ +@media (max-width: 600px) { + .setup-card { + overflow: hidden; + } + + .setup-step-card { + height: auto; + overflow: visible; + } + + .setup-step-card .setup-grid { + gap: 2px 5px; + } + + .setup-step-card label { + gap: 1px; + margin-top: 2px; + } + + .setup-step-card input, + .setup-step-card select { + height: 24px; + } + + .setup-step-card textarea { + min-height: 30px; + height: 30px; + padding-top: 4px; + padding-bottom: 4px; + } + + .setup-step-card .provider-description { + margin-top: 2px; + padding-top: 4px; + padding-bottom: 4px; + } + + .setup-step-card .reset-preview span:first-of-type { + display: block !important; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; + } + + .setup-step-card .reset-preview span:last-of-type { + display: none !important; + } + + .setup-step-card .dns-test-actions { + margin-top: 2px; + } +} + +@media (max-width: 390px) { + .setup-step-card .setup-grid { + gap: 1px 4px; + } + + .setup-step-card label { + gap: 1px; + margin-top: 1px; + } + + .setup-step-card input, + .setup-step-card select { + height: 22px; + } + + .setup-step-card textarea { + min-height: 26px; + height: 26px; + } +} + + +@media (min-width: 901px) { + .setup-notification-step:has(#email-http-enabled:checked) > .email-primary-grid, + .setup-notification-step:has(#email-http-enabled:checked) > .email-delivery-grid { + grid-template-columns: repeat(4, minmax(0, 1fr)); + gap: 4px 7px; + } + + .setup-notification-step:has(#email-http-enabled:checked) { + padding: 12px 14px; + } + + .setup-notification-step:has(#email-http-enabled:checked) legend { + font-size: 11px; + } + + .setup-notification-step:has(#email-http-enabled:checked) label { + gap: 2px; + margin-top: 2px; + font-size: 9px; + } + + .setup-notification-step:has(#email-http-enabled:checked) label > span { + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; + } + + .setup-notification-step:has(#email-http-enabled:checked) input, + .setup-notification-step:has(#email-http-enabled:checked) select { + height: 26px; + padding: 0 8px; + font-size: 10px; + } + + .setup-notification-step:has(#email-http-enabled:checked) textarea { + min-height: 30px; + height: 30px; + padding: 4px 8px; + font-size: 10px; + } + + .setup-notification-step:has(#email-http-enabled:checked) .provider-description { + overflow: hidden; + margin-top: 3px; + padding: 4px 8px; + font-size: 9px; + line-height: 1.25; + white-space: nowrap; + text-overflow: ellipsis; + } + + .setup-notification-step:has(#email-http-enabled:checked) .email-option-grid { + gap: 4px; + margin-top: 3px; + } + + .setup-notification-step:has(#email-http-enabled:checked) .compact-row { + min-height: 26px; + padding: 4px 6px; + } +} + + +@media (min-width: 901px) and (max-height: 800px) { + .setup-notification-step:has(#email-http-enabled:checked) label { + gap: 1px; + margin-top: 1px; + font-size: 8px; + } + + .setup-notification-step:has(#email-http-enabled:checked) input, + .setup-notification-step:has(#email-http-enabled:checked) select { + height: 22px; + padding: 0 6px; + font-size: 9px; + } + + .setup-notification-step:has(#email-http-enabled:checked) textarea { + min-height: 24px; + height: 24px; + padding: 3px 6px; + font-size: 9px; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview { + display: flex; + align-items: center; + height: 28px; + margin-top: 2px; + padding: 3px 6px; + gap: 5px; + font-size: 8px; + line-height: 1.15; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview strong, + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview span { + display: inline !important; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview span { + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview strong { + flex: 0 0 auto; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview span:first-of-type { + flex: 0 1 auto; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview span:last-of-type { + flex: 1 1 auto; + } + + .setup-notification-step:has(#email-http-enabled:checked) .email-option-grid { + gap: 3px; + margin-top: 2px; + } + + .setup-notification-step:has(#email-http-enabled:checked) .compact-row { + min-height: 22px; + padding: 2px 4px; + } +} + + +@media (min-width: 901px) { + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview { + display: flex; + align-items: center; + height: 30px; + gap: 6px; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview strong, + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview span { + display: inline !important; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview strong { + flex: 0 0 auto; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview span:first-of-type { + flex: 0 1 auto; + } + + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview span:last-of-type { + flex: 1 1 auto; + } +} + +@media (min-width: 901px) and (max-height: 800px) { + .setup-notification-step:has(#email-http-enabled:checked) .reset-preview { + height: 28px; + gap: 5px; + } +} diff --git a/frontend/src/views/SetupWizard/SetupWizard.js b/frontend/src/views/SetupWizard/SetupWizard.js index e6f4096..5be8b74 100644 --- a/frontend/src/views/SetupWizard/SetupWizard.js +++ b/frontend/src/views/SetupWizard/SetupWizard.js @@ -1,5 +1,20 @@ import { computed, onMounted, onUnmounted, ref, watch } from "vue"; +const commonEmailDomains = [ + { label: "常用邮箱", value: "" }, + { label: "@163.com", value: "163.com" }, + { label: "@qq.com", value: "qq.com" }, + { label: "@126.com", value: "126.com" }, + { label: "@outlook.com", value: "outlook.com" }, + { label: "@gmail.com", value: "gmail.com" }, + { label: "@foxmail.com", value: "foxmail.com" }, + { label: "@aliyun.com", value: "aliyun.com" }, + { label: "@139.com", value: "139.com" }, + { label: "@189.cn", value: "189.cn" }, + { label: "自定义后缀", value: "custom" }, +]; + + export function useSetupWizard(props, emit) { const scertLogo = "/Scert.png"; @@ -16,6 +31,8 @@ export function useSetupWizard(props, emit) { const dnsVerification = ref(null); const verificationClock = ref(Date.now()); const currentStep = ref(1); + const selectedEmailDomain = ref(""); + const emailLocalPart = ref(""); let verificationTimer; const targetType = ref(props.status.web_public_ip ? "ip" : "hostname"); const form = ref({ @@ -24,8 +41,23 @@ export function useSetupWizard(props, emit) { admin_password: "", confirm_password: "", server_port: props.status.server_port || 8080, + email_http_enabled: false, email_provider: "", email_endpoint: "", + email_http_path: "/api/email/send", + email_http_login_path: "/api/login", + email_http_auth_mode: "none", + email_http_credential_ref: "", + email_http_headers: "", + email_event_mode: "detailed", + email_include_deployment_details: true, + email_include_certificate_serial: true, + email_include_management_url: true, + email_sender_name: "Scert", + email_sender_email: "", + email_timeout_secs: 10, + email_retry_count: 3, + email_retry_intervals_secs: "30,120,600", recipients: "", dns_provider: props.status.dns_provider || "cloudflare", certificate_root: props.status.certificate_root || "", @@ -80,6 +112,52 @@ export function useSetupWizard(props, emit) { }).format(new Date(value)); } + function handleEmailInput(value) { + error.value = ""; + const rawValue = String(value || "").trim(); + + if (!rawValue) { + emailLocalPart.value = ""; + selectedEmailDomain.value = ""; + form.value.admin_email = ""; + return; + } + + const atIndex = rawValue.indexOf("@"); + if (atIndex <= 0) { + emailLocalPart.value = rawValue; + form.value.admin_email = selectedEmailDomain.value && selectedEmailDomain.value !== "custom" + ? `${rawValue}@${selectedEmailDomain.value}` + : rawValue; + return; + } + + const localPart = rawValue.slice(0, atIndex).trim(); + const domain = rawValue.slice(atIndex + 1).trim().toLowerCase(); + emailLocalPart.value = localPart; + selectedEmailDomain.value = commonEmailDomains.some( + (option) => option.value === domain, + ) + ? domain + : "custom"; + form.value.admin_email = `${localPart}@${domain}`; + } + + function applyEmailDomain(domain) { + error.value = ""; + if (!domain || domain === "custom") return; + + const currentEmail = form.value.admin_email.trim(); + const localPart = emailLocalPart.value.trim() || currentEmail.split("@")[0].trim(); + if (!localPart) { + selectedEmailDomain.value = ""; + error.value = "请先输入邮箱名称,再选择常用邮箱。"; + return; + } + + emailLocalPart.value = localPart; + form.value.admin_email = `${localPart}@${domain}`; + } async function loadDNSProviders() { dnsCatalogLoading.value = true; dnsCatalogError.value = ""; @@ -195,6 +273,29 @@ export function useSetupWizard(props, emit) { error.value = "请输入 1 至 65535 之间的主服务端口。"; return false; } + if (form.value.email_http_enabled && !form.value.email_endpoint.trim()) { + error.value = "启用 HTTP 邮件通知后必须填写 API 地址。"; + return false; + } + if ( + form.value.email_http_enabled && + form.value.email_http_auth_mode !== "none" && + !form.value.email_http_credential_ref.trim() + ) { + error.value = "启用 HTTP 通知认证后必须填写凭据引用。"; + return false; + } + if (form.value.email_http_headers.trim()) { + try { + const headers = JSON.parse(form.value.email_http_headers); + if (!headers || Array.isArray(headers) || typeof headers !== "object") { + throw new Error("not-object"); + } + } catch { + error.value = "HTTP 自定义请求头必须是 JSON 对象。"; + return false; + } + } } if (currentStep.value === 3) { @@ -270,6 +371,18 @@ export function useSetupWizard(props, emit) { .filter(Boolean); } + function emailHeaders() { + if (!form.value.email_http_headers.trim()) return {}; + return JSON.parse(form.value.email_http_headers); + } + + function retryIntervals() { + return form.value.email_retry_intervals_secs + .split(/[,,]/) + .map((item) => Number(item.trim())) + .filter((item) => Number.isInteger(item) && item > 0); + } + async function submit() { error.value = ""; resultMessage.value = ""; @@ -304,8 +417,25 @@ export function useSetupWizard(props, emit) { admin_email: form.value.admin_email, admin_password: form.value.admin_password, server_port: Number(form.value.server_port), + email_http_enabled: form.value.email_http_enabled, email_provider: form.value.email_provider, email_endpoint: form.value.email_endpoint, + email_http_path: form.value.email_http_path, + email_http_login_path: form.value.email_http_login_path, + email_http_auth_mode: form.value.email_http_auth_mode, + email_http_credential_ref: form.value.email_http_credential_ref, + email_http_headers: emailHeaders(), + email_event_mode: form.value.email_event_mode, + email_include_deployment_details: + form.value.email_include_deployment_details, + email_include_certificate_serial: + form.value.email_include_certificate_serial, + email_include_management_url: form.value.email_include_management_url, + email_sender_name: form.value.email_sender_name, + email_sender_email: form.value.email_sender_email, + email_timeout_secs: Number(form.value.email_timeout_secs), + email_retry_count: Number(form.value.email_retry_count), + email_retry_intervals_secs: retryIntervals(), recipients: recipients(), dns_provider: form.value.dns_provider, dns_credential_ref: dnsVerification.value.credential_ref, @@ -367,11 +497,16 @@ export function useSetupWizard(props, emit) { currentStep, targetType, form, + commonEmailDomains, + selectedEmailDomain, + emailLocalPart, targetLabel, resetURLPreview, selectedDNSProvider, dnsVerificationValid, formatVerificationExpiry, + applyEmailDomain, + handleEmailInput, testDNS, handleSubmit, previousStep, diff --git a/frontend/src/views/SetupWizard/SetupWizard.vue b/frontend/src/views/SetupWizard/SetupWizard.vue index 5166d4f..bad2f40 100644 --- a/frontend/src/views/SetupWizard/SetupWizard.vue +++ b/frontend/src/views/SetupWizard/SetupWizard.vue @@ -27,11 +27,16 @@ const { currentStep, targetType, form, + commonEmailDomains, + selectedEmailDomain, + emailLocalPart, targetLabel, resetURLPreview, selectedDNSProvider, dnsVerificationValid, formatVerificationExpiry, + applyEmailDomain, + handleEmailInput, testDNS, handleSubmit, previousStep, @@ -109,17 +114,37 @@ const { autocomplete="username" placeholder="例如 scert-admin" /> -