"""Clés API par équipe : créer, révoquer, lister. La clé n'est jamais affichée ni gardée par le service. python -m scripts.cles_api nouvelle equipe-hub --space une clé pour l'équipe « equipe-hub » python -m scripts.cles_api revoquer equipe-hub --space l'équipe n'a plus accès python -m scripts.cles_api liste les équipes qui ont une clé nouvelle : la clé est écrite dans cles_api/<équipe>.txt (dossier ignoré par git), à transmettre par privatebin « burn after reading », puis à supprimer. Le service ne garde que son EMPREINTE SHA-256 : cles_api/empreintes.json en local, le secret API_KEYS_HASH sur le Space. --space : met à jour ce secret sur le Space (compte Hugging Face connecté ; le Space redémarre, ~1-2 min). Sans --space : ajouter la ligne API_KEYS_HASH affichée aux variables d'environnement à la main. La clé principale (API_KEY, dans .env) n'est pas touchée. """ from __future__ import annotations import argparse import json import re import secrets from datetime import date from pathlib import Path from app.routes_api import empreinte RACINE = Path(__file__).resolve().parent.parent DOSSIER = RACINE / "cles_api" REGISTRE = DOSSIER / "empreintes.json" SPACE = "Myz0/CV-Matching" NOM = re.compile(r"^[a-z0-9][a-z0-9_-]{1,39}$") def nouvelle_cle() -> str: """256 bits de hasard ; le préfixe cvm_ permet de reconnaître une clé du service.""" return "cvm_" + secrets.token_urlsafe(32) def lire_registre() -> dict: return json.loads(REGISTRE.read_text(encoding="utf-8")) if REGISTRE.exists() else {} def valeur_secret(registre: dict) -> str: """Ce que le service lit dans API_KEYS_HASH : {"équipe": "empreinte"}.""" return json.dumps({nom: x["empreinte"] for nom, x in sorted(registre.items())}, separators=(",", ":")) def publier(registre: dict, space: str) -> None: from huggingface_hub import HfApi HfApi().add_space_secret(space, "API_KEYS_HASH", valeur_secret(registre), description="Empreintes SHA-256 des clés API par équipe (scripts/cles_api.py)") print(f"Secret API_KEYS_HASH mis à jour sur le Space {space} : il redémarre (~1-2 min).") def main() -> None: p = argparse.ArgumentParser(description=__doc__.splitlines()[0]) p.add_argument("action", choices=["nouvelle", "revoquer", "liste"]) p.add_argument("equipe", nargs="?", help="nom de l'équipe : minuscules, chiffres, - ou _ (2 à 40 caractères)") p.add_argument("--space", nargs="?", const=SPACE, help=f"mettre à jour le secret du Space (défaut : {SPACE})") a = p.parse_args() registre = lire_registre() if a.action == "liste": for nom, x in sorted(registre.items()): print(f" {nom:24s} créée le {x['creee_le']}") print(f"{len(registre)} clé(s) d'équipe, en plus de la clé principale (API_KEY).") return if not a.equipe or not NOM.match(a.equipe): raise SystemExit("Nom d'équipe attendu : minuscules, chiffres, - ou _ (ex. equipe-hub).") DOSSIER.mkdir(exist_ok=True) if a.action == "nouvelle": if a.equipe in registre: raise SystemExit(f"« {a.equipe} » a déjà une clé : la révoquer d'abord pour en créer une nouvelle.") cle = nouvelle_cle() fichier = DOSSIER / f"{a.equipe}.txt" fichier.write_text(cle + "\n", encoding="utf-8") registre[a.equipe] = {"empreinte": empreinte(cle), "creee_le": date.today().isoformat()} print(f"Clé créée pour « {a.equipe} » dans {fichier.relative_to(RACINE)} (non affichée).") print(" -> l'envoyer par privatebin « burn after reading », puis supprimer ce fichier.") else: if registre.pop(a.equipe, None) is None: raise SystemExit(f"« {a.equipe} » n'a pas de clé.") (DOSSIER / f"{a.equipe}.txt").unlink(missing_ok=True) print(f"Clé de « {a.equipe} » révoquée.") REGISTRE.write_text(json.dumps(registre, indent=1, ensure_ascii=False), encoding="utf-8") if a.space: publier(registre, a.space) else: print("Sans --space : à mettre dans les variables d'environnement du service :") print(f" API_KEYS_HASH={valeur_secret(registre)}") if __name__ == "__main__": main()