Files
xiaoyin-gateway/app/sessions.py
T

100 lines
3.7 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 也不需要交给浏览器。会话存内存,单实例必需;
多实例如需共享会话再换 Redis(当前网关单实例,足够)。
吊销语义(第八轮审计补):账号被删除、改密或被管理员重置密码时,其名下**全部会话**
立即失效 —— 否则「删号 / 重置密码」无法止损(旧 token 仍能调用到 TTL 结束)。
"""
from __future__ import annotations
import secrets
import threading
import time
class SessionStore:
def __init__(self, ttl_seconds: int = 86400, max_tokens: int = 5000):
self._ttl = ttl_seconds
self._max = max_tokens
self._s: dict[str, dict] = {}
self._lock = threading.Lock()
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:
self._purge()
return len(self._s)
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[tok] = {"created": time.time(), "ip": ip or "", "account": account or ""}
return tok
def validate(self, token: str, ip: str | None = None) -> bool:
if not token:
return False
with self._lock:
ent = self._s.get(token)
if not ent:
return False
if time.time() - ent["created"] > self._ttl:
del self._s[token]
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(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:
self._s.pop(token, None)
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]
return len(dead)
def clear(self) -> None:
with self._lock:
self._s.clear()
def _purge(self) -> None:
now = time.time()
for k in list(self._s):
if now - self._s[k]["created"] > self._ttl:
del self._s[k]