Portée et règles

Mis à jour le 10 novembre 2026

Une machine CLI n'a accès qu'à ce que vous lui avez donné. La portée est choisie à l'approbation et modifiable ensuite dans Réglages › Machines CLI (ou sur app.konsolity.com/cli-machines, coffre ouvert). Elle est appliquée deux fois : par le serveur, qui refuse tout appel hors portée, et par la machine elle-même, qui applique des règles chiffrées que le serveur ne peut ni lire ni modifier. Les deux refusent ce qui n'est pas permis.

Domaines

Domaine Ce qu'il permet
hosts Lister les hôtes choisis ; avec l'accès complet, y exécuter des commandes (konsolity run).
snippets Lister les snippets choisis ; avec l'accès complet et hosts, les lancer (konsolity snippet run).
sessions Voir les sessions CLI en cours sur le compte et y mettre fin (konsolity sessions).
mcp Servir d'outils aux agents Claude (konsolity mcp, konsolity serve).

Par défaut : hosts et snippets.

Lecture seule ou accès complet

  • Lecture seule : listes et état seulement. Aucune commande ne peut être lancée, même par un snippet. C'est l'accès par défaut, et le bon choix pour un tableau de bord ou une surveillance.
  • Accès complet : les commandes sont permises sur les hôtes choisis, dans la limite des règles de commande ci-dessous.

Le coffre de machine

La machine ne reçoit jamais la clé de votre coffre. À l'approbation, votre appareil tire une clé de machine propre à cette machine, la lui transmet scellée, puis recopie, chiffrés par cette clé, seulement les éléments que la portée autorise :

  • les hôtes choisis, avec leurs identités, leurs clés SSH et leurs clés d'hôte épinglées ;
  • les snippets choisis ;
  • les règles de la machine.

Le serveur stocke ces copies comme des blocs opaques. Un hôte hors portée n'a aucune copie : sa clé SSH ne quitte jamais votre coffre. La machine n'a aucun accès au coffre du compte.

  • Ajouter un hôte à la portée : un appareil où le coffre est ouvert écrit sa copie.
  • Retirer un hôte : le serveur efface sa copie aussitôt.
  • Modifier un hôte dans le coffre (adresse, clé) : vos appareils mettent à jour les copies des machines à leur prochaine synchronisation. Supprimer l'hôte supprime aussi ses copies.

Seuls les hôtes dont la clé d'hôte est déjà épinglée dans le coffre sont utilisables : la CLI n'accepte jamais une clé d'hôte inconnue (host_key_unknown). Connectez-vous une première fois à l'hôte depuis l'app pour l'épingler.

Règles de commande

Avec l'accès complet, konsolity run (et l'outil run_command de Claude) n'est permis que si l'hôte est dans la portée et que la commande, sans ses espaces de début et de fin, correspond à une règle. Trois façons de comparer :

Type Règle Exemple de motif Accepte Refuse
exact la commande entière, à l'identique df -h df -h df -h /
prefix la commande commence par le motif uptime uptime -p w
glob * remplace une suite de caractères systemctl status * systemctl status nginx systemctl restart nginx

Ce que * n'autorise jamais

Dans un motif glob, * ne peut pas contenir :

  • ; & | (enchaînement et tube) ;
  • ` et $( (substitution de commande) ;
  • > et < (redirection) ;
  • un saut de ligne.

Ainsi systemctl status * n'accepte ni systemctl status nginx; rm -rf / ni systemctl status x | sh. Un motif prefix accepte ce qui suit le préfixe tel quel : réservez-le aux commandes sans risque.

Toute commande

L'option Toute commande autorise n'importe quel texte sur les hôtes choisis. Elle demande une confirmation explicite à l'écran et elle est déconseillée : la machine devient l'équivalent d'un accès shell complet. Les commandes destructrices restent confirmées (voir plus bas).

À l'activation en accès complet, aucune règle n'est cochée et « Toute commande » est désactivé : il faut écrire des règles ou cocher explicitement « Toute commande », sinon toute commande libre est refusée. Les snippets autorisés, eux, se lancent tels qu'ils sont enregistrés.

Délai maximal

Chaque commande est interrompue au-delà du délai maximal : 60 secondes par défaut, 1 heure au plus. La valeur demandée par --timeout ou par Claude est toujours bornée par ce délai.

Commandes destructrices : toujours confirmées

Certaines commandes ne sont jamais lancées sans votre confirmation explicite dans l'app ou sur la console, quelle que soit la portée, même avec « Toute commande ». Une commande (ou le contenu d'un snippet) est destructrice si elle contient, en mot isolé, par exemple :

  • suppression et effacement : rm -r, rm -f, rmdir, shred, truncate, dd, mkfs, fdisk, parted, wipefs ;
  • arrêt : shutdown, reboot, poweroff, halt, init 0, init 6, systemctl stop, disable, mask, kill, service ... stop, kill -9, killall, pkill ;
  • comptes et droits : userdel, deluser, passwd, chmod -R, chown -R, crontab -r ;
  • pare-feu : iptables -F, ufw disable, ufw reset ;
  • bases de données : DROP, TRUNCATE, DELETE FROM, ALTER TABLE ... DROP, migrate:fresh, migrate:reset, migrate:rollback ;
  • dépôts et infrastructure : git push --force, git reset --hard, git clean -f, docker rm, docker rmi, docker system prune, docker volume rm, docker compose down -v, kubectl delete, terraform destroy ;
  • une redirection > vers un disque (/dev/sd*, /dev/nvme*) ou vers /etc/.

La même liste est appliquée par la CLI et par le serveur : une commande destructrice lancée sans confirmation approuvée est refusée des deux côtés. Le déroulé est décrit dans Confirmations.

Modifier la portée

  • Élargir (ajouter un domaine, passer de la lecture seule à l'accès complet) exige à nouveau le second facteur (TOTP ou clé d'accès).
  • Réduire (retirer un domaine, repasser en lecture seule, retirer un hôte) est immédiat et ne demande rien : les copies hors portée sont effacées aussitôt.

Les règles de commande et le délai sont modifiables à tout moment, coffre ouvert. Pour voir ce que la machine applique réellement :

konsolity policy

Exemples

Surveillance (lecture seule, hosts + sessions) : listes et état, aucune commande.

Exploitation courante (accès complet, quelques hôtes) :

glob     systemctl status *
exact    df -h
exact    free -m
prefix   uptime
glob     journalctl -u * --since *
glob     tail -n * /var/log/nginx/error.log
exact    docker ps

plus les snippets « Redémarrer nginx » et « Vider le cache de l'application ».

Déploiement depuis la CI (jeton longue durée, accès complet, hosts + snippets) : un seul snippet « Déployer » sur l'hôte de production, aucune règle de commande libre.