Files
MyGoNavi/internal/jvm/guard.go
Syngnat ffc4f2c2d9 🐛 fix(jvm): 强化变更确认令牌校验
将 JVM 变更确认从可重算校验值升级为服务端发放的一次性令牌,避免未预览、重放或上下文变更后继续执行高风险变更。
2026-04-28 09:42:21 +08:00

253 lines
7.4 KiB
Go

package jvm
import (
"context"
"crypto/sha256"
"encoding/hex"
"encoding/json"
"fmt"
"strings"
"GoNavi-Wails/internal/connection"
)
// BuildChangePreview builds a guarded preview for JVM mutations.
// It always produces a local before/after baseline and, when writes are still
// allowed, merges provider preview details on top of that baseline.
func BuildChangePreview(
ctx context.Context,
provider Provider,
cfg connection.ConnectionConfig,
req ChangeRequest,
) (ChangePreview, error) {
req, err := NormalizeChangeRequest(req)
if err != nil {
return ChangePreview{}, err
}
normalized, err := NormalizeConnectionConfig(cfg)
if err != nil {
return ChangePreview{}, err
}
resourceID := req.ResourceID
action := req.Action
before := ValueSnapshot{
ResourceID: resourceID,
Kind: "resource",
Format: "json",
}
if provider != nil {
if snapshot, snapshotErr := provider.GetValue(ctx, normalized, resourceID); snapshotErr == nil {
before = snapshot
if strings.TrimSpace(before.ResourceID) == "" {
before.ResourceID = resourceID
}
if strings.TrimSpace(before.Format) == "" {
before.Format = "json"
}
}
}
after := before
after.ResourceID = resourceID
if req.ExpectedVersion != "" {
after.Version = req.ExpectedVersion
}
if req.Payload != nil {
after.Value = req.Payload
}
preview := ChangePreview{
Allowed: true,
Summary: fmt.Sprintf("%s -> %s", resourceID, action),
RiskLevel: "medium",
Before: before,
After: after,
}
if normalized.JVM.ReadOnly != nil && *normalized.JVM.ReadOnly {
preview.Allowed = false
preview.RiskLevel = "high"
preview.BlockingReason = "当前连接为只读,禁止写入"
}
if normalized.JVM.Environment == EnvPROD {
preview.RequiresConfirmation = true
if preview.RiskLevel == "" || preview.RiskLevel == "low" {
preview.RiskLevel = "medium"
}
}
if !preview.Allowed {
return preview, nil
}
if provider == nil {
if preview.RequiresConfirmation {
confirmationToken, tokenErr := buildChangeConfirmationToken(normalized, req, preview)
if tokenErr != nil {
return ChangePreview{}, tokenErr
}
preview.ConfirmationToken = confirmationToken
}
return preview, nil
}
providerPreview, err := provider.PreviewChange(ctx, normalized, req)
if err != nil {
return ChangePreview{}, err
}
if strings.TrimSpace(providerPreview.Summary) != "" {
preview.Summary = providerPreview.Summary
}
if strings.TrimSpace(providerPreview.RiskLevel) != "" {
preview.RiskLevel = providerPreview.RiskLevel
}
if providerPreview.RequiresConfirmation {
preview.RequiresConfirmation = true
}
if !providerPreview.Allowed {
preview.Allowed = false
}
if strings.TrimSpace(providerPreview.BlockingReason) != "" {
preview.BlockingReason = providerPreview.BlockingReason
}
if hasSnapshotOverride(providerPreview.Before) {
preview.Before = mergeValueSnapshot(preview.Before, providerPreview.Before)
}
if hasSnapshotOverride(providerPreview.After) {
preview.After = mergeValueSnapshot(preview.After, providerPreview.After)
}
if strings.EqualFold(strings.TrimSpace(preview.RiskLevel), "high") {
preview.RequiresConfirmation = true
}
if preview.Allowed && preview.RequiresConfirmation {
confirmationToken, tokenErr := buildChangeConfirmationToken(normalized, req, preview)
if tokenErr != nil {
return ChangePreview{}, tokenErr
}
preview.ConfirmationToken = confirmationToken
}
return preview, nil
}
func NormalizeChangeRequest(req ChangeRequest) (ChangeRequest, error) {
normalized := req
normalized.ProviderMode = strings.ToLower(strings.TrimSpace(normalized.ProviderMode))
normalized.ResourceID = strings.TrimSpace(normalized.ResourceID)
normalized.Action = strings.TrimSpace(normalized.Action)
normalized.Reason = strings.TrimSpace(normalized.Reason)
normalized.Source = strings.TrimSpace(normalized.Source)
normalized.ExpectedVersion = strings.TrimSpace(normalized.ExpectedVersion)
normalized.ConfirmationToken = strings.TrimSpace(normalized.ConfirmationToken)
if normalized.ResourceID == "" {
return ChangeRequest{}, fmt.Errorf("resource id is required")
}
if normalized.Action == "" {
return ChangeRequest{}, fmt.Errorf("action is required")
}
if normalized.Reason == "" {
return ChangeRequest{}, fmt.Errorf("reason is required")
}
return normalized, nil
}
func hasSnapshotOverride(snapshot ValueSnapshot) bool {
return strings.TrimSpace(snapshot.ResourceID) != "" ||
strings.TrimSpace(snapshot.Kind) != "" ||
strings.TrimSpace(snapshot.Format) != "" ||
strings.TrimSpace(snapshot.Version) != "" ||
snapshot.Value != nil ||
snapshot.Metadata != nil ||
snapshot.Sensitive
}
func mergeValueSnapshot(base ValueSnapshot, override ValueSnapshot) ValueSnapshot {
merged := base
if strings.TrimSpace(override.ResourceID) != "" {
merged.ResourceID = override.ResourceID
}
if strings.TrimSpace(override.Kind) != "" {
merged.Kind = override.Kind
}
if strings.TrimSpace(override.Format) != "" {
merged.Format = override.Format
}
if strings.TrimSpace(override.Version) != "" {
merged.Version = override.Version
}
if override.Value != nil {
merged.Value = override.Value
}
if override.Metadata != nil {
merged.Metadata = override.Metadata
}
if override.Sensitive {
merged.Sensitive = true
}
return merged
}
func ValidateChangeConfirmation(preview ChangePreview, req ChangeRequest) error {
if !preview.RequiresConfirmation {
return nil
}
previewToken := strings.TrimSpace(preview.ConfirmationToken)
requestToken := strings.TrimSpace(req.ConfirmationToken)
if previewToken == "" {
return fmt.Errorf("预览确认令牌缺失,请重新预览后再提交")
}
if requestToken == "" {
return fmt.Errorf("缺少确认令牌,请先完成预览确认")
}
if previewToken != requestToken {
return fmt.Errorf("确认令牌不匹配,请重新预览并确认")
}
return nil
}
type confirmationTokenInput struct {
ConnectionID string `json:"connectionId"`
ProviderMode string `json:"providerMode"`
ResourceID string `json:"resourceId"`
Action string `json:"action"`
Reason string `json:"reason"`
Source string `json:"source"`
ExpectedVersion string `json:"expectedVersion"`
Payload map[string]any `json:"payload"`
Summary string `json:"summary"`
RiskLevel string `json:"riskLevel"`
BeforeVersion string `json:"beforeVersion"`
AfterVersion string `json:"afterVersion"`
}
func buildChangeConfirmationToken(cfg connection.ConnectionConfig, req ChangeRequest, preview ChangePreview) (string, error) {
input := confirmationTokenInput{
ConnectionID: strings.TrimSpace(cfg.ID),
ProviderMode: strings.TrimSpace(cfg.JVM.PreferredMode),
ResourceID: strings.TrimSpace(req.ResourceID),
Action: strings.TrimSpace(req.Action),
Reason: strings.TrimSpace(req.Reason),
Source: strings.TrimSpace(req.Source),
ExpectedVersion: strings.TrimSpace(req.ExpectedVersion),
Payload: req.Payload,
Summary: strings.TrimSpace(preview.Summary),
RiskLevel: strings.TrimSpace(preview.RiskLevel),
BeforeVersion: strings.TrimSpace(preview.Before.Version),
AfterVersion: strings.TrimSpace(preview.After.Version),
}
encoded, err := json.Marshal(input)
if err != nil {
return "", fmt.Errorf("生成 JVM 变更确认令牌失败: %w", err)
}
sum := sha256.Sum256(encoded)
return hex.EncodeToString(sum[:]), nil
}