mfa

type BackupCode struct {
	// Code 备份码
	Code string
	// Used 是否已使用
	Used bool
}

type MemoryStore struct {
	// contains filtered or unexported fields
}

type MiddlewareConfig struct {
	// Store MFA验证状态存储
	Store ValidationStore

	// GetUserID 从请求上下文中获取用户ID的函数
	GetUserID func(*mist.Context) (string, error)

	// ValidationDuration MFA验证有效期
	ValidationDuration time.Duration

	// RedirectURL 未验证时重定向的URL
	RedirectURL string

	// OnUnauthorized 未验证时的处理函数
	OnUnauthorized func(*mist.Context)
}

type TOTP struct {
	Secret      string
	Config      TOTPConfig
	BackupCodes []BackupCode
	UsedTokens  *UsedTokenTracker
}

type TOTPConfig struct {
	// Digits 代码位数，通常为6
	Digits int
	// Period 刷新周期，通常为30秒
	Period int
	// Algorithm 使用的哈希算法，通常为SHA1
	Algorithm string
	// Issuer 发行者名称，通常为应用名
	Issuer string
	// SecretSize 密钥大小（字节）
	SecretSize int
	// WindowSize 验证窗口大小，即允许前后多少个时间单位
	WindowSize int
	// SkipValidUsedTokens 是否跳过验证已使用过的令牌（防止重放攻击）
	SkipValidUsedTokens bool
}

type UsedTokenTracker struct {
	// contains filtered or unexported fields
}

type ValidationStore interface {
	// Validate 验证指定用户ID是否已完成MFA验证
	Validate(userID string) (bool, error)

	// Set 设置用户MFA验证状态
	Set(userID string, expiry time.Duration) error

	// Clear 清除用户MFA验证状态
	Clear(userID string) error
}