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>
48 lines
1.5 KiB
Python
48 lines
1.5 KiB
Python
"""Generation et verification des jetons de partage.
|
|
|
|
Deux secrets distincts sont produits a la creation d'un partage :
|
|
|
|
* ``share_token`` : identifiant public, present dans /s/<token>, lecture seule.
|
|
* ``management_token`` : secret de gestion (PUT/DELETE), jamais dans une URL,
|
|
stocke uniquement dans l'IndexedDB du proprietaire.
|
|
|
|
Seul le hash SHA-256 du management token est conserve en base.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import hashlib
|
|
import secrets
|
|
|
|
# 16 octets -> 22 caracteres url-safe, 128 bits d'entropie.
|
|
# Les jetons plus courts emis avant ce reglage restent valides : la colonne
|
|
# accepte n'importe quelle longueur et la recherche se fait par valeur exacte.
|
|
SHARE_TOKEN_BYTES = 16
|
|
# 32 octets -> ~256 bits d'entropie pour le secret de gestion.
|
|
MANAGEMENT_TOKEN_BYTES = 32
|
|
|
|
|
|
def generate_share_token() -> str:
|
|
return secrets.token_urlsafe(SHARE_TOKEN_BYTES)
|
|
|
|
|
|
def generate_management_token() -> str:
|
|
return secrets.token_urlsafe(MANAGEMENT_TOKEN_BYTES)
|
|
|
|
|
|
def hash_token(token: str) -> str:
|
|
"""Hash du secret de gestion.
|
|
|
|
Le token est deja un secret aleatoire de haute entropie : un SHA-256 simple
|
|
suffit (pas de risque de force brute par dictionnaire, contrairement a un
|
|
mot de passe choisi par un humain).
|
|
"""
|
|
return hashlib.sha256(token.encode("utf-8")).hexdigest()
|
|
|
|
|
|
def verify_token(token: str, expected_hash: str) -> bool:
|
|
"""Comparaison a temps constant."""
|
|
if not token or not expected_hash:
|
|
return False
|
|
return secrets.compare_digest(hash_token(token), expected_hash)
|