Sub2API v1.0 - AI API 网关（二开初始版本，基于上游 Wei-Shaw/sub2api）

backend/internal/service/session_binding.go

@@ -0,0 +1,58 @@
+package service
+
+import (
+	"context"
+	"crypto/sha256"
+	"encoding/hex"
+	"strings"
+
+	infraerrors "github.com/Wei-Shaw/sub2api/internal/pkg/errors"
+)
+
+// ErrSessionBindingMismatch 会话绑定的 IP/UA 发生变化，会话已失效。
+var ErrSessionBindingMismatch = infraerrors.Unauthorized("SESSION_BINDING_MISMATCH", "session network fingerprint changed, please login again")
+
+// SessionBinding 会话指纹：登录时的客户端 IP 与 User-Agent。
+// 会话绑定开启时，两者任一变化即导致会话失效（防止凭证被盗后异地重放）。
+type SessionBinding struct {
+	IP        string
+	UserAgent string
+}
+
+// Hash 计算绑定指纹哈希（IP 与 UA 合并，任一变化哈希即变化）。
+func (b *SessionBinding) Hash() string {
+	if b == nil {
+		return ""
+	}
+	ip := strings.TrimSpace(b.IP)
+	ua := strings.TrimSpace(b.UserAgent)
+	if ip == "" && ua == "" {
+		return ""
+	}
+	sum := sha256.Sum256([]byte(ip + "\n" + ua))
+	return hex.EncodeToString(sum[:16])
+}
+
+type sessionBindingCtxKey struct{}
+
+// WithSessionBinding 将会话指纹注入 context（由 HTTP 入口中间件调用）。
+func WithSessionBinding(ctx context.Context, binding *SessionBinding) context.Context {
+	if binding == nil {
+		return ctx
+	}
+	return context.WithValue(ctx, sessionBindingCtxKey{}, binding)
+}
+
+// SessionBindingFromContext 从 context 提取会话指纹；不存在时返回 nil。
+func SessionBindingFromContext(ctx context.Context) *SessionBinding {
+	if ctx == nil {
+		return nil
+	}
+	binding, _ := ctx.Value(sessionBindingCtxKey{}).(*SessionBinding)
+	return binding
+}
+
+// sessionBindingHashFromContext 提取指纹哈希，缺失时返回空串。
+func sessionBindingHashFromContext(ctx context.Context) string {
+	return SessionBindingFromContext(ctx).Hash()
+}