snoopy
49870dcd56
Rend une instance exposee sur Internet exploitable sans la transformer en infrastructure : le produit reste local-first, sans compte et sans telemetrie. Protection du service : limitation de debit en memoire par client et par famille d'endpoint (health et ready jamais limites), interrupteur SHARING_ENABLED, capacite maximale de partages, taille propre aux partages. X-Forwarded-For n'est cru que si TRUST_PROXY_HEADERS l'autorise, et on lit alors la derniere valeur, celle ajoutee par le proxy. Expiration facultative des partages (24 h a 90 jours, ou jamais) : un lien expire repond 410 et la page publique le dit, sans autre detail. Le proprietaire peut prolonger ; aucune purge automatique. Protection des liens non repertories : robots.txt, X-Robots-Tag et meta robots sur /s/ et /api/, Referrer-Policy no-referrer sur tout le site, redaction des jetons dans les journaux d'acces, share_token porte a 128 bits (les anciens restent valides). Schema gere par Alembic, applique au demarrage. Une base creee avant Alembic est estampillee puis migree : verifie sur la base reelle de developpement, 4 partages inchanges et expires_at NULL. Administration par CLI locale au conteneur (stats, liste, suppression, purge, sauvegarde a chaud via l'API SQLite, restauration prudente) : aucune interface /admin exposee. Le jeton de gestion peut enfin etre exporte dans un fichier .openmind-share puis reimporte depuis un autre navigateur, apres verification aupres du serveur. Il n'est toujours jamais ajoute a un export .mmap. Ajoute une page /privacy dont le texte est centralise, et corrige un bug trouve en observant les logs : Alembic, lance dans le processus applicatif, reappliquait la configuration de logs d'alembic.ini et desactivait les loggers existants, ce qui faisait disparaitre les journaux d'acces. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
66 lines
2.3 KiB
Python
66 lines
2.3 KiB
Python
"""Configuration des logs backend : lisible, structure, sans donnee sensible."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
import re
|
|
import sys
|
|
|
|
_LOG_FORMAT = "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s"
|
|
_DATE_FORMAT = "%Y-%m-%dT%H:%M:%S"
|
|
|
|
# Champs qui ne doivent jamais apparaitre dans les logs.
|
|
REDACTED_KEYS = frozenset({"management_token", "managementToken", "authorization"})
|
|
|
|
# Un share token est une capacite de lecture : le laisser dans les logs d'acces
|
|
# revient a y ecrire le lien complet. On le remplace, sans toucher au reste du
|
|
# chemin pour que les autres routes restent diagnosticables.
|
|
_TOKEN_PATHS = re.compile(r"(?P<prefix>/(?:s|api/shares)/)(?P<token>[A-Za-z0-9_-]{6,})")
|
|
REDACTED_TOKEN = "[REDACTED]"
|
|
|
|
|
|
def redact_tokens(text: str) -> str:
|
|
return _TOKEN_PATHS.sub(lambda m: f"{m.group('prefix')}{REDACTED_TOKEN}", text)
|
|
|
|
|
|
class TokenRedactingFilter(logging.Filter):
|
|
"""Retire les jetons de partage des messages avant ecriture.
|
|
|
|
Applique aux logs d'acces uvicorn, ou le chemin complet est journalise.
|
|
"""
|
|
|
|
def filter(self, record: logging.LogRecord) -> bool:
|
|
if isinstance(record.args, tuple):
|
|
record.args = tuple(
|
|
redact_tokens(arg) if isinstance(arg, str) else arg for arg in record.args
|
|
)
|
|
if isinstance(record.msg, str):
|
|
record.msg = redact_tokens(record.msg)
|
|
return True
|
|
|
|
|
|
def configure_logging(level: str = "INFO") -> None:
|
|
handler = logging.StreamHandler(sys.stdout)
|
|
handler.setFormatter(logging.Formatter(_LOG_FORMAT, datefmt=_DATE_FORMAT))
|
|
|
|
root = logging.getLogger()
|
|
root.handlers.clear()
|
|
root.addHandler(handler)
|
|
root.setLevel(level.upper())
|
|
|
|
redactor = TokenRedactingFilter()
|
|
handler.addFilter(redactor)
|
|
|
|
# Uvicorn possede ses propres handlers : on les aligne sur les notres.
|
|
for name in ("uvicorn", "uvicorn.error", "uvicorn.access"):
|
|
logger = logging.getLogger(name)
|
|
logger.handlers.clear()
|
|
logger.propagate = True
|
|
logger.filters.clear()
|
|
logger.addFilter(redactor)
|
|
|
|
|
|
def safe_extra(data: dict[str, object]) -> dict[str, object]:
|
|
"""Retire les valeurs sensibles avant de les envoyer dans un log."""
|
|
return {k: ("***" if k in REDACTED_KEYS else v) for k, v in data.items()}
|