Files
xiaoyin-gateway/app/sessions.py
T
Jidekin c7e0fa3af8 refactor!: 技术标识也全部换掉(logger / UA / 脚本 / 前端 / 文档)
老板要求:技术标识也要换,脚本啥的都换。

运行时
  · 所有 logging.getLogger("api-gateway…") → "xiaoyin-gateway…"(main/metrics/circuit/settings/sessions/users/gomodels/video_owners/adapters)
  · app/main.py 的上游 User-Agent 默认值 → xiaoyin-gateway/{VERSION}
  · data/gateway.yaml 里 opencode 的 UA 覆盖 → xiaoyin-gateway/2.4.0
  · run.py 启动横幅 → [xiaoyin-gateway]

脚本
  · scripts/sync_models.py、sync_onemin.py 的探测 UA
  · scripts/ci_check.sh 的横幅

前端
  · 配置备份文件的 kind: api-gateway-backup → xiaoyin-gateway-backup
    (导入逻辑本来就不校验 kind,旧备份照样能恢复)
  · dist 产物同步打补丁,不用重新 build

文档
  · README / CHANGELOG 里的服务名、`supervisorctl restart api-gateway:api-gateway_00` 等
  · 另一个技能 dsh-plugin-publish 的敏感词规则里也提到了旧名,一并更新

唯一没动的
  · .gitignore 里那行指向 /root/.trash/2026-09-13-api-gateway-cleanup 的注释 ——
    那是磁盘上真实存在的历史目录名,改了反而指错地方
2026-11-20 16:30:42 +08:00

187 lines
7.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""前端登录会话(短时;可落盘,默认内存)。
设计:前端用**账号 + 密码**调 POST /auth/login 换一个 short-lived 的 `sess-` token,
后续请求带这个会话 token —— 密码只在登录那一刻提交一次,前端不长期持有;
API Key 也不需要交给浏览器。
吊销语义(第八轮审计补):账号被删除、改密或被管理员重置密码时,其名下**全部会话**
立即失效 —— 否则「删号 / 重置密码」无法止损(旧 token 仍能调用到 TTL 结束)。
落盘(第三十轮补):此前是纯内存,进程一重启**所有人被踢下线**(每次上线/改配置都掉线,
运维体感很差,也逼着"为了不掉线而不重启")。现在可选落盘 `data/sessions.json`:
· **盘上只存 token 的 sha256**(`_fp()`),不存 token 本身 —— 备份/误传该文件也无法
直接拿来冒充登录;代价是吊销/校验都要现算一次哈希(可忽略)。
· 原子写(临时文件 + os.replace)+ 权限 600;写失败只告警、不抛 —— 落盘是"少掉线一次"
的体验优化,不能让它把登录本身弄挂(真失败就退化成原来的纯内存行为)。
· 载入时直接丢掉已过期的会话(TTL 判定与运行期一致)。
· 仍不解决**多实例共享**(要共享还是得换 Redis);当前网关单实例,够用。
path=None(默认)→ 纯内存,测试与库内直连构造维持原语义。
"""
from __future__ import annotations
import hashlib
import json
import logging
import os
import secrets
import threading
import time
from pathlib import Path
log = logging.getLogger("xiaoyin-gateway.sessions")
# 落盘文件名固定为 sessions.json;结构带 version,便于以后改格式时兼容读取。
_FILE_VERSION = 1
def _fp(token: str) -> str:
"""token → 落盘用的指纹(sha256)。盘上永远不出现可直接使用的凭证。"""
return hashlib.sha256(("sess:" + token).encode("utf-8")).hexdigest()
class SessionStore:
def __init__(self, ttl_seconds: int = 86400, max_tokens: int = 5000,
path: str | os.PathLike | None = None):
self._ttl = ttl_seconds
self._max = max_tokens
self._path = Path(path) if path else None
self._s: dict[str, dict] = {}
self._lock = threading.Lock()
self._load()
# ── 落盘 ─────────────────────────────────────────
def _load(self) -> None:
"""启动时载入;已过期的直接丢弃(不留到运行期再清)。"""
if self._path is None or not self._path.exists():
return
try:
raw = json.loads(self._path.read_text(encoding="utf-8"))
entries = raw.get("sessions") if isinstance(raw, dict) else None
except Exception as e: # 文件损坏/被手工改坏 → 当没有,别拦启动
log.warning("会话文件读取失败(按空会话启动):%s", e)
return
now = time.time()
kept = dropped = 0
for k, v in (entries or {}).items():
if not isinstance(v, dict):
continue
created = v.get("created")
if not isinstance(created, (int, float)) or now - created > self._ttl:
dropped += 1
continue
self._s[str(k)] = {"created": float(created), "ip": str(v.get("ip") or ""),
"account": str(v.get("account") or "")}
kept += 1
if kept or dropped:
log.info("已载入 %d 个会话(丢弃过期 %d 个)", kept, dropped)
def _save(self) -> None:
"""整体重写(会话量小:上限 max_tokens 条)。写失败只告警。"""
if self._path is None:
return
try:
self._path.parent.mkdir(parents=True, exist_ok=True)
text = json.dumps({"version": _FILE_VERSION, "sessions": self._s},
ensure_ascii=False, separators=(",", ":"))
tmp = self._path.with_name(self._path.name + ".tmp")
tmp.write_text(text, encoding="utf-8")
os.chmod(tmp, 0o600)
os.replace(tmp, self._path)
except Exception as e:
log.warning("会话落盘失败(本次改动只在内存生效):%s", e)
# ── 基本属性 ─────────────────────────────────────
def ttl(self) -> int:
return self._ttl
def set_ttl(self, seconds: int) -> None:
"""按当前配置动态调整会话时长(下限 60s,防误配成 0 让会话瞬间过期)。"""
self._ttl = max(60, int(seconds))
def count(self) -> int:
with self._lock:
changed = self._purge()
n = len(self._s)
if changed:
self._save()
return n
# ── 增删查改 ─────────────────────────────────────
def create(self, ip: str, account: str = "") -> str:
with self._lock:
self._purge()
if len(self._s) >= self._max: # 超上限:踢最老的
oldest = min(self._s, key=lambda k: self._s[k]["created"])
del self._s[oldest]
tok = "sess-" + secrets.token_hex(24)
# ip 只做记录、不做绑定:移动网络/NAT 下换出口 IP 是常态,绑定会把人踢下线。
self._s[_fp(tok)] = {"created": time.time(), "ip": ip or "", "account": account or ""}
self._save()
return tok
def validate(self, token: str, ip: str | None = None) -> bool:
if not token:
return False
with self._lock:
ent = self._s.get(_fp(token))
if not ent:
return False
if time.time() - ent["created"] > self._ttl:
del self._s[_fp(token)]
self._save()
return False
return True
def account_for(self, token: str) -> str | None:
"""返回会话所属账号(用于指标/日志归属与鉴权 identity)。"""
if not token or not self.validate(token):
return None
with self._lock:
ent = self._s.get(_fp(token))
return (ent or {}).get("account")
def is_session(self, token: str) -> bool:
"""该凭证是否为**密码登录换来的会话**(区别于长期 API Key)。
账号管理/改密/铸 Key 这类「改凭证」操作只认会话凭证 —— 泄漏的 API Key
就不可能再给自己铸一把新 Key 或改密码,堵住持久化后门。
"""
return bool(token and token.startswith("sess-") and self.validate(token))
def revoke(self, token: str) -> None:
with self._lock:
if self._s.pop(_fp(token), None) is not None:
self._save()
def revoke_account(self, account: str) -> int:
"""吊销某账号的全部会话,返回被踢掉的会话数(改密/重置密码/删号时调用)。"""
if not account:
return 0
with self._lock:
dead = [k for k, v in self._s.items() if v.get("account") == account]
for k in dead:
del self._s[k]
if dead:
self._save()
return len(dead)
def clear(self) -> None:
with self._lock:
had = bool(self._s)
self._s.clear()
if had:
self._save()
def _purge(self) -> bool:
"""清过期会话;返回是否有改动(有才值得落盘)。"""
now = time.time()
changed = False
for k in list(self._s):
if now - self._s[k]["created"] > self._ttl:
del self._s[k]
changed = True
return changed