Files
opsx-licence/backend/internal/model/order.go
T
Logan.Li 1c50d565eb
CI / backend (push) Canceled after 0s
fix(security): webhook fail-closed、机密字段信封加密、限流信任代理修正
三项 P0 安全修复:

1. Webhook 验签 fail-closed
   - WaffoWebhook 未配置验签材料时从「告警放行」改为 503 拒绝,
     封死伪造 order.completed 结算订单的路径
   - 通用 PaymentWebhook 从「仅 release 拒绝」收紧为默认拒绝,
     仅显式 ALLOW_UNVERIFIED_WEBHOOK=1(本地调试)放行

2. 机密字段信封加密(新增 internal/secretbox)
   - AES-256-GCM,主密钥 OPSLIC_MASTER_KEY(64 位 hex),密文带
     enc:v1: 前缀;Encrypt 幂等、历史明文原样放行
   - PaymentGatewayConfig.SecretKey/WebhookSecret 与 PeerNode.
     SharedKey 挂 GORM 钩子透明加解密,业务代码零改动;SharedKey
     列宽 128→512(密文更长)
   - 启动 fail-fast 校验主密钥;MigratePlaintext 幂等迁移存量明文;
     节点同步只含业务表,机密表为节点本地,互不影响
   - docker-compose/.env.example 补 OPSLIC_MASTER_KEY 与说明

3. 限流信任代理修正
   - 默认 SetTrustedProxies(nil) 不信任任何 X-Forwarded-For,
     封死伪造 XFF 轮换 IP 绕过按 IP 限流;反代节点用
     TRUSTED_PROXIES 指定内网 CIDR,非法配置拒绝启动

验证:go build/vet/test 全绿(含 secretbox 6 条单测);
读取路径(Waffo 私钥/webhook 密钥/互联密钥)确认全走 GORM 钩子。

部署注意:上线须配置 OPSLIC_MASTER_KEY(双节点一致)与
WAFFO_WEBHOOK_PUBLIC_KEY(未配则回调 503,属预期);香港反代
节点配 TRUSTED_PROXIES。
2026-11-01 02:03:26 +08:00

92 lines
3.6 KiB
Go

package model
import (
"fmt"
"time"
"backend/internal/secretbox"
"gorm.io/gorm"
)
// Order 订单模型 // Logan.Li
type Order struct {
ID uint `json:"id" gorm:"primaryKey"`
OrderNo string `json:"order_no" gorm:"size:100;uniqueIndex;not null"` // 系统唯一订单号(幂等键)
CustomerID uint `json:"customer_id"`
Customer Customer `json:"customer,omitempty" gorm:"foreignKey:CustomerID"`
ProductID uint `json:"product_id"`
Product Product `json:"product,omitempty" gorm:"foreignKey:ProductID"`
PlanID uint `json:"plan_id"`
Plan Plan `json:"plan,omitempty" gorm:"foreignKey:PlanID"`
LicenseID uint `json:"license_id"` // 关联的 License ID
Amount float64 `json:"amount" gorm:"type:decimal(10,2);not null"`
Currency string `json:"currency" gorm:"size:3;default:'USD'"`
Status string `json:"status" gorm:"size:20;default:'pending'"` // pending / paid / failed / refunded / cancelled
PaymentMethod string `json:"payment_method" gorm:"size:50"` // paddle / stripe / creem / waffo / alipay / wechat
PaymentGateway string `json:"payment_gateway" gorm:"size:50"`
GatewayOrderNo string `json:"gateway_order_no" gorm:"size:200;index"`
PaidAt *time.Time `json:"paid_at,omitempty"`
RefundAt *time.Time `json:"refund_at,omitempty"`
ClientIP string `json:"client_ip" gorm:"size:50"`
UserAgent string `json:"user_agent" gorm:"size:500"`
Notes string `json:"notes" gorm:"type:text"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
// TableName 指定表名 // Logan.Li
func (Order) TableName() string {
return "orders"
}
// PaymentGatewayConfig 支付网关配置 // Logan.Li
type PaymentGatewayConfig struct {
Gateway string `json:"gateway" gorm:"size:50;primaryKey"` // paddle / stripe / creem / waffo
Enabled bool `json:"enabled" gorm:"default:false"`
PublicKey string `json:"public_key" gorm:"type:text"`
SecretKey string `json:"secret_key" gorm:"type:text"` // 加密存储
WebhookSecret string `json:"webhook_secret" gorm:"type:text"` // Webhook 验签密钥
SandboxMode bool `json:"sandbox_mode" gorm:"default:true"`
Currency string `json:"currency" gorm:"size:3;default:'USD'"`
Region string `json:"region" gorm:"size:50"`
Priority int `json:"priority" gorm:"default:0"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
// TableName 指定表名 // Logan.Li
func (PaymentGatewayConfig) TableName() string {
return "payment_gateway_configs"
}
// BeforeSave 机密字段信封加密后落库(幂等:已是密文不再重复加密) // Logan.Li
func (g *PaymentGatewayConfig) BeforeSave(tx *gorm.DB) error {
enc, err := secretbox.Encrypt(g.SecretKey)
if err != nil {
return fmt.Errorf("加密 secret_key: %w", err)
}
g.SecretKey = enc
enc, err = secretbox.Encrypt(g.WebhookSecret)
if err != nil {
return fmt.Errorf("加密 webhook_secret: %w", err)
}
g.WebhookSecret = enc
return nil
}
// AfterFind 读取时解密;历史明文(无前缀)原样返回,迁移完成前不阻断 // Logan.Li
func (g *PaymentGatewayConfig) AfterFind(tx *gorm.DB) error {
dec, err := secretbox.Decrypt(g.SecretKey)
if err != nil {
return fmt.Errorf("解密 secret_key: %w", err)
}
g.SecretKey = dec
dec, err = secretbox.Decrypt(g.WebhookSecret)
if err != nil {
return fmt.Errorf("解密 webhook_secret: %w", err)
}
g.WebhookSecret = dec
return nil
}