winzik/docs/admin.md

18 lines
3.7 KiB
Markdown

# Administration du site (jumphp.net)
Réservée au compte Git de l'administrateur (`User::ADMIN_GITHUB_ID`, l'identifiant Git, pas le login). Page `/studio/admin` (bouton « Administration » de « Mes jeux »).
L'administrateur voit **tous** les projets (même non listés ou hors ligne) et peut :
- **Demandes TCP / SSH** : autoriser ou refuser (une autorisation vaut pour un commit précis), voir et révoquer ce qui est autorisé (docs/tcp.md).
- **Pont TCP, en direct** (rafraîchi toutes les 2 secondes) : connexions ouvertes, débit, qui demande quoi (application, cible, réponse), journal (le plus récent en haut),
alertes (quota de bande passante dépassé) ; couper une connexion, bloquer une application ou une adresse (une heure), débloquer.
- **Ports** (bloc « Ports », `#ports`) : la politique de ports des droits TCP, UDP et SSH. Rappels et ports de référence avec leur nom : courrier sortant refusé par défaut (25 SMTP, 465 SMTPS, 587 soumission), 22 (SSH, seulement par le droit `ssh`), et l'ancienne liste réservée aux bases de données, maintenant permise comme tout port (3306 MySQL / MariaDB, 3307, 33060 MySQL X, 5432 PostgreSQL, 1433 SQL Server, 1521 Oracle, 6379 Redis, 27017 MongoDB, 11211 Memcached, 8086 InfluxDB, 9042 Cassandra).
Vous y réglez : la **liste d'interdits globale** (pastilles à ajouter / retirer, remplacement de toute la liste, retour à la valeur par défaut `TCP_DENY_PORTS` = `25,465,587` ; enregistrée en base, la variable d'environnement ne sert que tant que rien n'est enregistré) et, **par application** (celles qui ont un droit TCP / UDP / SSH), une **liste blanche** (si elle n'est pas vide, SEULS ces ports sont permis, en TCP et en UDP) et une **liste d'interdits** propre ; « tous les ports » = ni l'une ni l'autre.
**Priorité** : 1. la liste globale gagne toujours ; 2. le port 22 est réservé au droit `ssh` (un ticket `tcp` ne peut pas le viser) ; 3. la liste blanche de l'application, si elle n'est pas vide, doit contenir le port (TCP et UDP ; SSH garde son propre droit, la liste blanche ne vaut pas pour ses ports cibles) ; 4. la liste d'interdits de l'application (elle vaut aussi pour les ports cibles d'SSH). Entrées valides : des ports de 1 à 65535, 64 par liste au plus (`0`, `70000`, `abc` sont refusés, les doublons fusionnés).
Appliqué dans le **ticket** (signé par la plateforme : la décision est dedans) ; le **pont** reste l'autorité pour la liste globale : elle lui est envoyée à chaque changement (`/admin/ports`, gardée dans son `TCP_STATE_FILE`) et renvoyée s'il l'a perdue quand vous ouvrez la page. Ajouter un port (global ou à une application) **coupe tout de suite** les connexions ouvertes qui l'utilisent (le journal du pont le dit). Un refus nomme le port et la règle : « port 3306 is denied by the platform (global deny list) », « … denied for this application (its deny list) », « … not in the whitelist of this application (allowed: …) ». Chaque changement est journalisé côté serveur (qui, avant, après).
- **Projets** (recherche par titre, identifiant ou auteur) : dépublier / publier, retirer de l'annuaire / lister, changer l'étape (dev, beta, done), **supprimer**
(fichiers du dépôt local, du publié et privés compris ; le dépôt Git de l'auteur n'est pas touché).
- **Utilisateurs** : **bannir** (avec une raison : plus de connexion Git, les sessions et les jetons IDE / MCP s'arrêtent à la requête suivante), débloquer,
**supprimer** le compte et ses projets (un compte lié à d'autres données — commentaires, notes... — est banni à la place). Le compte administrateur ne peut être ni banni ni supprimé.
Sauvegardes à garder (docs/tcp.md) : le compte Git de l'administrateur, `TOKEN_KEY` et le reste de `deploy/.env`, la base de données.