Task: Endpoint Tester + Terminal SSH avec tmux

Date: 27/01/2026 Status: TERMINE Duree: ~4h

Objectif

Ajouter la possibilite de tester les endpoints API directement depuis l'interface, et ameliorer le terminal SSH avec persistance de session via tmux.

Travail realise

1. Page "Try it" pour tester les endpoints

Nouveau fichier: /connectors/[id]/test/[endpoint]/index.tsx

• Formulaire dynamique base sur les parametres de l'endpoint
• Sections separees: Path params, Query params, Headers, Body (JSON)
• Execution via api.fetch() avec support query/headers
• Affichage resultat: status, temps de reponse, JSON formate
• Bouton copier le resultat

Modifications:

• api.ts: Ajout support query et headers dans la methode fetch()
• /connectors/[id]/index.tsx: Ajout bouton "Tester" + menu contextuel (clic droit)
• /connectors/public/[type]/index.tsx: Idem
• /connectors/instance/[id]/index.tsx: Idem + details endpoint (requestBody, response)

2. Terminal SSH dedie avec tmux

Nouveau fichier: /connectors/instance/[id]/terminal/index.tsx

• Page plein ecran pour le terminal SSH
• Support tmux pour persistance de session (survit a la fermeture du navigateur)
• Toggle pour activer/desactiver tmux
• Detection si tmux n'est pas installe (avec instructions d'installation)
• Header avec status de connexion, nom instance, boutons reconnect/disconnect

Backend (ssh.ts):

• createShell() supporte maintenant l'option useTmux
• Genere un nom de session tmux unique par instance/user
• Verifie si tmux est installe avant utilisation
• Retourne tmuxNotInstalled: true si absent

3. Logging des commandes terminal

Modifications:

• index.ts (WebSocket handler): Log des commandes saisies dans le terminal
• Nouvelle action ssh.shell_input dans l'audit
• Buffer pour capturer les commandes completes (jusqu'a Enter)
• Limite a 500 caracteres par commande loggee

Frontend (ActivityLogs.tsx):

• Affichage des logs ssh.shell_input avec la commande

Fichiers modifies

connectors-front

• src/lib/api.ts
• src/routes/connectors/[id]/index.tsx
• src/routes/connectors/[id]/test/[endpoint]/index.tsx (NEW)
• src/routes/connectors/public/[type]/index.tsx
• src/routes/connectors/instance/[id]/index.tsx
• src/routes/connectors/instance/[id]/terminal/index.tsx (NEW)
• src/components/ActivityLogs.tsx

connectors-api

• src/services/ssh.ts
• src/index.ts (WebSocket handler)
• src/services/audit.ts (types)

Incidents resolus

1. Disque plein sur prod-portainer (100% -> 57%)

   • Cause: accumulation d'images Docker
   • Solution: docker system prune -af --volumes && docker builder prune -af
   • Espace libere: ~45 Go

2. Pipeline echouee (ENOSPC)

   • Relancee apres nettoyage disque
   • Succes

Tests effectues

• [x] Test endpoint GitHub GET /user -> OK
• [x] Logs fetch.execute generes -> OK
• [x] Terminal SSH avec tmux -> OK
• [x] Logging commandes shell -> OK

Prochaines etapes

• WireGuard VPN par instance SSH (voir backlog)