security

type APIKeyAuth struct {
	Keys       []string `mapstructure:"keys" yaml:"keys" json:"keys"`                     // 有效API Key列表
	HeaderName string   `mapstructure:"header-name" yaml:"header-name" json:"headerName"` // API Key头名称
	QueryParam string   `mapstructure:"query-param" yaml:"query-param" json:"queryParam"` // API Key查询参数名
}

type Auth struct {
	Enabled     bool        `mapstructure:"enabled" yaml:"enabled" json:"enabled"`               // 是否启用认证
	Type        string      `mapstructure:"type" yaml:"type" json:"type"`                        // 认证类型 (basic, bearer, custom, apikey)
	HeaderName  string      `mapstructure:"header-name" yaml:"header-name" json:"headerName"`    // 认证头名称
	TokenPrefix string      `mapstructure:"token-prefix" yaml:"token-prefix" json:"tokenPrefix"` // 令牌前缀
	Basic       *BasicAuth  `mapstructure:"basic" yaml:"basic" json:"basic"`                     // Basic认证
	Bearer      *BearerAuth `mapstructure:"bearer" yaml:"bearer" json:"bearer"`                  // Bearer认证
	APIKey      *APIKeyAuth `mapstructure:"apikey" yaml:"apikey" json:"apikey"`                  // APIKey认证
	Custom      *CustomAuth `mapstructure:"custom" yaml:"custom" json:"custom"`                  // 自定义认证
}

type BasicAuth struct {
	Users []User `mapstructure:"users" yaml:"users" json:"users"` // 用户列表
}

type BearerAuth struct {
	Tokens []string `mapstructure:"tokens" yaml:"tokens" json:"tokens"` // 有效令牌列表
}

type CSP struct {
	Enabled bool   `mapstructure:"enabled" yaml:"enabled" json:"enabled"` // 是否启用CSP
	Mode    string `mapstructure:"mode" yaml:"mode" json:"mode"`          // CSP模式: strict, development, balanced, relaxed, api, custom
	Custom  string `mapstructure:"custom" yaml:"custom" json:"custom"`    // 自定义CSP策略（当mode=custom时使用）
}

type CSRF struct {
	Enabled         bool     `mapstructure:"enabled" yaml:"enabled" json:"enabled"`                             // 是否启用 CSRF 防护
	ExemptMethods   []string `mapstructure:"exempt-methods" yaml:"exempt-methods" json:"exemptMethods"`         // 豁免校验的 HTTP 方法
	TokenFormField  string   `mapstructure:"token-form-field" yaml:"token-form-field" json:"tokenFormField"`    // 表单字段名
	TokenCookieName string   `mapstructure:"token-cookie-name" yaml:"token-cookie-name" json:"tokenCookieName"` // Cookie 名称
	TokenLength     int      `mapstructure:"token-length" yaml:"token-length" json:"tokenLength"`               // Token 长度
	Secret          string   `mapstructure:"secret" yaml:"secret" json:"secret"`                                // Token 生成密钥
}

type CustomAuth struct {
	HeaderName    string            `mapstructure:"header-name" yaml:"header-name" json:"headerName"`          // 自定义头名称
	ExpectedValue string            `mapstructure:"expected-value" yaml:"expected-value" json:"expectedValue"` // 期望值
	Headers       map[string]string `mapstructure:"headers" yaml:"headers" json:"headers"`                     // 自定义头部验证
}

type JWT struct {
	Enabled   bool   `mapstructure:"enabled" yaml:"enabled" json:"enabled"`       // 是否启用JWT
	Secret    string `mapstructure:"secret" yaml:"secret" json:"secret"`          // JWT密钥
	Expiry    int    `mapstructure:"expiry" yaml:"expiry" json:"expiry"`          // 过期时间(小时)
	Issuer    string `mapstructure:"issuer" yaml:"issuer" json:"issuer"`          // 签发者
	Algorithm string `mapstructure:"algorithm" yaml:"algorithm" json:"algorithm"` // 加密算法
}

type Pprof struct {
	Enabled      bool     `mapstructure:"enabled" yaml:"enabled" json:"enabled"`                  // 是否启用安全认证
	Username     string   `mapstructure:"username" yaml:"username" json:"username"`               // 用户名
	Password     string   `mapstructure:"password" yaml:"password" json:"password"`               // 密码
	AllowedIPs   []string `mapstructure:"allowed-ips" yaml:"allowed-ips" json:"allowedIps"`       // 允许的IP地址
	RequireHTTPS bool     `mapstructure:"require-https" yaml:"require-https" json:"requireHttps"` // 是否要求HTTPS
}

type Protection struct {
	Swagger *ServiceProtection `mapstructure:"swagger" yaml:"swagger" json:"swagger"` // Swagger保护
	PProf   *ServiceProtection `mapstructure:"pprof" yaml:"pprof" json:"pprof"`       // PProf保护
	Metrics *ServiceProtection `mapstructure:"metrics" yaml:"metrics" json:"metrics"` // Metrics保护
	Health  *ServiceProtection `mapstructure:"health" yaml:"health" json:"health"`    // Health保护
	API     *ServiceProtection `mapstructure:"api" yaml:"api" json:"api"`             // API保护
}

type Security struct {
	ModuleName string      `mapstructure:"module-name" yaml:"module-name" json:"moduleName"` // 模块名称
	JWT        *JWT        `mapstructure:"jwt" yaml:"jwt" json:"jwt"`                        // JWT配置
	Auth       *Auth       `mapstructure:"auth" yaml:"auth" json:"auth"`                     // 通用认证配置
	Protection *Protection `mapstructure:"protection" yaml:"protection" json:"protection"`   // 服务保护配置
	CSP        *CSP        `mapstructure:"csp" yaml:"csp" json:"csp"`                        // CSP内容安全策略配置
	CSRF       *CSRF       `mapstructure:"csrf" yaml:"csrf" json:"csrf"`                     // CSRF 防护配置
	Validation *Validation `mapstructure:"validation" yaml:"validation" json:"validation"`   // 安全校验规则
}

type ServiceProtection struct {
	Enabled      bool     `mapstructure:"enabled" yaml:"enabled" json:"enabled"`                  // 是否启用保护
	AuthRequired bool     `mapstructure:"auth-required" yaml:"auth-required" json:"authRequired"` // 是否需要认证
	AuthType     string   `mapstructure:"auth-type" yaml:"auth-type" json:"authType"`             // 认证类型
	IPWhitelist  []string `mapstructure:"ip-whitelist" yaml:"ip-whitelist" json:"ipWhitelist"`    // IP白名单
	RequireHTTPS bool     `mapstructure:"require-https" yaml:"require-https" json:"requireHttps"` // 是否要求HTTPS
	Username     string   `mapstructure:"username" yaml:"username" json:"username"`               // 用户名
	Password     string   `mapstructure:"password" yaml:"password" json:"password"`               // 密码
}

type User struct {
	Username    string   `mapstructure:"username" yaml:"username" json:"username"`          // 用户名
	Password    string   `mapstructure:"password" yaml:"password" json:"password"`          // 密码(建议加密存储)
	Role        string   `mapstructure:"role" yaml:"role" json:"role"`                      // 角色
	Permissions []string `mapstructure:"permissions" yaml:"permissions" json:"permissions"` // 权限列表
}

type Validation struct {
	HTTPMethods         []string `mapstructure:"http-methods" yaml:"http-methods" json:"httpMethods"`                         // 有效 HTTP 方法集合
	DangerousExtensions []string `mapstructure:"dangerous-extensions" yaml:"dangerous-extensions" json:"dangerousExtensions"` // 危险文件扩展名
	XSSPatterns         []string `mapstructure:"xss-patterns" yaml:"xss-patterns" json:"xssPatterns"`                         // XSS 检测模式
}