Bereik en regels

Bijgewerkt op 10 november 2026

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.