Bereik en regels
Een CLI-machine heeft alleen toegang tot wat je haar hebt gegeven. Het bereik wordt gekozen bij de goedkeuring en kan later worden gewijzigd onder Instellingen › CLI-machines (of op app.konsolity.com/cli-machines, met de kluis open). Het wordt twee keer afgedwongen: door de server, die elke aanroep buiten het bereik weigert, en door de machine zelf, die versleutelde regels toepast die de server niet kan lezen of wijzigen. Beide weigeren wat niet is toegestaan.
Domeinen
| Domein | Wat het toestaat |
|---|---|
hosts |
De gekozen hosts tonen; met volledige toegang er opdrachten op uitvoeren (konsolity run). |
snippets |
De gekozen snippets tonen; met volledige toegang en hosts ze uitvoeren (konsolity snippet run). |
sessions |
De CLI-sessies die op het account lopen bekijken en beëindigen (konsolity sessions). |
mcp |
Dienen als tools voor Claude-agents (konsolity mcp, konsolity serve). |
Standaard: hosts en snippets.
Alleen lezen of volledige toegang
- Alleen lezen: alleen lijsten en status. Er kan geen enkele opdracht worden uitgevoerd, ook niet via een snippet. Dit is de standaardtoegang, en de juiste keuze voor een dashboard of monitoring.
- Volledige toegang: opdrachten zijn toegestaan op de gekozen hosts, binnen de regels voor opdrachten hieronder.
De machinekluis
De machine ontvangt nooit de sleutel van je kluis. Bij de goedkeuring genereert je apparaat een machinesleutel die eigen is aan deze machine, geeft die verzegeld door en kopieert daarna, versleuteld met deze sleutel, alleen de items die het bereik toestaat:
- de gekozen hosts, met hun identiteiten, hun SSH-sleutels en hun vastgelegde hostsleutels;
- de gekozen snippets;
- de regels van de machine.
De server bewaart deze kopieën als ondoorzichtige blokken. Een host buiten het bereik heeft geen kopie: zijn SSH-sleutel verlaat je kluis nooit. De machine heeft geen toegang tot de kluis van het account.
- Een host toevoegen aan het bereik: een apparaat waarop de kluis open is, schrijft de kopie ervan.
- Een host verwijderen: de server verwijdert de kopie direct.
- Een host bewerken in de kluis (adres, sleutel): je apparaten werken de kopieën van de machines bij bij hun volgende synchronisatie. Het verwijderen van de host verwijdert ook de kopieën ervan.
Alleen hosts waarvan de hostsleutel al is vastgelegd in de kluis kunnen worden gebruikt: de CLI accepteert nooit een onbekende hostsleutel (host_key_unknown). Maak één keer vanuit de app verbinding met de host om hem vast te leggen.
Regels voor opdrachten
Met volledige toegang is konsolity run (en de tool run_command van Claude) alleen toegestaan als de host binnen het bereik valt en de opdracht, zonder spaties aan het begin en het eind, overeenkomt met een regel. Er zijn drie manieren van vergelijken:
| Type | Regel | Voorbeeldpatroon | Accepteert | Weigert |
|---|---|---|---|---|
exact |
de hele opdracht, identiek | df -h |
df -h |
df -h / |
prefix |
de opdracht begint met het patroon | uptime |
uptime -p |
w |
glob |
* staat voor een reeks tekens |
systemctl status * |
systemctl status nginx |
systemctl restart nginx |
Wat * nooit toestaat
In een glob-patroon kan * het volgende niet bevatten:
;&|(koppeling en pipe);`en$((opdrachtsubstitutie);>en<(omleiding);- een regeleinde.
systemctl status * accepteert dus noch systemctl status nginx; rm -rf / noch systemctl status x | sh. Een prefix-patroon accepteert alles wat na het voorvoegsel komt zoals het is: gebruik het alleen voor onschuldige opdrachten.
Elke opdracht
De optie Elke opdracht staat elke tekst toe op de gekozen hosts. Ze vraagt om een uitdrukkelijke bevestiging op het scherm en wordt afgeraden: de machine wordt het equivalent van volledige shelltoegang. Destructieve opdrachten blijven bevestigd (zie hieronder).
Bij activering met volledige toegang is geen enkele regel aangevinkt en staat "Elke opdracht" uit: je moet regels schrijven of uitdrukkelijk "Elke opdracht" aanvinken, anders wordt elke vrije opdracht geweigerd. Toegestane snippets worden uitgevoerd zoals ze zijn opgeslagen.
Maximale time-out
Elke opdracht wordt gestopt zodra de maximale time-out is overschreden: standaard 60 seconden, maximaal 1 uur. De waarde die via --timeout of door Claude wordt gevraagd, wordt altijd door deze time-out begrensd.
Destructieve opdrachten: altijd bevestigd
Sommige opdrachten worden nooit uitgevoerd zonder je uitdrukkelijke bevestiging in de app of in de console, ongeacht het bereik, zelfs met "Elke opdracht". Een opdracht (of de inhoud van een snippet) is destructief als ze als afzonderlijk woord bijvoorbeeld het volgende bevat:
- verwijderen en wissen:
rm -r,rm -f,rmdir,shred,truncate,dd,mkfs,fdisk,parted,wipefs; - uitschakelen:
shutdown,reboot,poweroff,halt,init 0,init 6,systemctl stop,disable,mask,kill,service ... stop,kill -9,killall,pkill; - accounts en rechten:
userdel,deluser,passwd,chmod -R,chown -R,crontab -r; - firewall:
iptables -F,ufw disable,ufw reset; - databases:
DROP,TRUNCATE,DELETE FROM,ALTER TABLE ... DROP,migrate:fresh,migrate:reset,migrate:rollback; - repository's en infrastructuur:
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; - een omleiding
>naar een schijf (/dev/sd*,/dev/nvme*) of naar/etc/.
Dezelfde lijst wordt toegepast door de CLI en door de server: een destructieve opdracht die zonder goedgekeurde bevestiging wordt gestart, wordt aan beide kanten geweigerd. Het verloop wordt beschreven in Bevestigingen.
Het bereik wijzigen
- Uitbreiden (een domein toevoegen, van alleen lezen naar volledige toegang gaan) vereist opnieuw de tweede factor (TOTP of passkey).
- Inperken (een domein verwijderen, terug naar alleen lezen, een host verwijderen) gaat direct en vraagt niets: kopieën buiten het bereik worden meteen verwijderd.
Regels voor opdrachten en de time-out kunnen op elk moment worden gewijzigd, met de kluis open. Om te zien wat de machine werkelijk toepast:
konsolity policy
Voorbeelden
Monitoring (alleen lezen, hosts + sessions): lijsten en status, geen opdrachten.
Dagelijks beheer (volledige toegang, enkele hosts):
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 de snippets "Nginx herstarten" en "De applicatiecache legen".
Uitrol vanuit CI (langlevend token, volledige toegang, hosts + snippets): één snippet "Uitrollen" op de productiehost, geen regel voor vrije opdrachten.