Portée et règles
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.