Omfang og regler

Oppdatert 10. november 2026

En CLI-maskin har bare tilgang til det du har gitt den. Omfanget velges ved godkjenning og kan endres senere under Innstillinger › CLI-maskiner (eller på app.konsolity.com/cli-machines, med hvelvet åpent). Det håndheves to ganger: av serveren, som avviser alle kall utenfor omfanget, og av maskinen selv, som bruker krypterte regler serveren verken kan lese eller endre. Begge avviser det som ikke er tillatt.

Domener

Domene Hva det tillater
hosts Vise de valgte vertene; med full tilgang, kjøre kommandoer på dem (konsolity run).
snippets Vise de valgte snuttene; med full tilgang og hosts, kjøre dem (konsolity snippet run).
sessions Se CLI-øktene som kjører på kontoen, og avslutte dem (konsolity sessions).
mcp Fungere som verktøy for Claude-agenter (konsolity mcp, konsolity serve).

Standard: hosts og snippets.

Skrivebeskyttet eller full tilgang

  • Skrivebeskyttet: bare lister og status. Ingen kommandoer kan kjøres, heller ikke via en snutt. Dette er standardtilgangen, og det riktige valget for et dashbord eller overvåking.
  • Full tilgang: kommandoer er tillatt på de valgte vertene, innenfor kommandoreglene nedenfor.

Maskinhvelvet

Maskinen mottar aldri nøkkelen til hvelvet ditt. Ved godkjenning trekker enheten din en maskinnøkkel som er unik for denne maskinen, overleverer den forseglet, og kopierer deretter, kryptert med denne nøkkelen, bare elementene omfanget tillater:

  • de valgte vertene, med identitetene, SSH-nøklene og de festede vertsnøklene deres;
  • de valgte snuttene;
  • maskinens regler.

Serveren lagrer disse kopiene som ugjennomsiktige blober. En vert utenfor omfanget har ingen kopi: SSH-nøkkelen dens forlater aldri hvelvet ditt. Maskinen har ingen tilgang til kontoens hvelv.

  • Legge til en vert i omfanget: en enhet der hvelvet er åpent, skriver kopien.
  • Fjerne en vert: serveren sletter kopien umiddelbart.
  • Endre en vert i hvelvet (adresse, nøkkel): enhetene dine oppdaterer maskinenes kopier ved neste synkronisering. Sletter du verten, slettes også kopiene.

Bare verter med en vertsnøkkel som allerede er festet i hvelvet, kan brukes: CLI-en godtar aldri en ukjent vertsnøkkel (host_key_unknown). Koble til verten én gang fra appen for å feste den.

Kommandoregler

Med full tilgang er konsolity run (og Claudes verktøy run_command) bare tillatt hvis verten er i omfanget og kommandoen, uten mellomrom foran og bak, samsvarer med en regel. Tre måter å sammenligne på:

Type Regel Eksempelmønster Godtar Avviser
exact hele kommandoen, identisk df -h df -h df -h /
prefix kommandoen begynner med mønsteret uptime uptime -p w
glob * står for en rekke tegn systemctl status * systemctl status nginx systemctl restart nginx

Hva * aldri tillater

I et glob-mønster kan * ikke inneholde:

  • ; & | (kjeding og rør);
  • ` og $( (kommandosubstitusjon);
  • > og < (omdirigering);
  • et linjeskift.

systemctl status * godtar derfor verken systemctl status nginx; rm -rf / eller systemctl status x | sh. Et prefix-mønster godtar det som følger prefikset, slik det er: bruk det bare for harmløse kommandoer.

Hvilken som helst kommando

Alternativet Hvilken som helst kommando tillater all tekst på de valgte vertene. Det krever en uttrykkelig bekreftelse på skjermen og frarådes: maskinen blir det samme som full skalltilgang. Destruktive kommandoer må fortsatt bekreftes (se nedenfor).

Ved aktivering med full tilgang er ingen regel krysset av, og «Hvilken som helst kommando» er av: du må skrive regler eller uttrykkelig krysse av for «Hvilken som helst kommando», ellers avvises alle frie kommandoer. Tillatte snutter kjøres slik de er lagret.

Maksimal tidsgrense

Alle kommandoer stoppes når den maksimale tidsgrensen er nådd: 60 sekunder som standard, 1 time på det meste. Verdien som bes om med --timeout eller av Claude, begrenses alltid av denne tidsgrensen.

Destruktive kommandoer: alltid bekreftet

Noen kommandoer kjøres aldri uten din uttrykkelige bekreftelse i appen eller i konsollen, uansett omfang, også med «Hvilken som helst kommando». En kommando (eller innholdet i en snutt) er destruktiv hvis den inneholder, som et eget ord, for eksempel:

  • sletting og overskriving: rm -r, rm -f, rmdir, shred, truncate, dd, mkfs, fdisk, parted, wipefs;
  • avslutning: shutdown, reboot, poweroff, halt, init 0, init 6, systemctl stop, disable, mask, kill, service ... stop, kill -9, killall, pkill;
  • kontoer og rettigheter: userdel, deluser, passwd, chmod -R, chown -R, crontab -r;
  • brannmur: iptables -F, ufw disable, ufw reset;
  • databaser: DROP, TRUNCATE, DELETE FROM, ALTER TABLE ... DROP, migrate:fresh, migrate:reset, migrate:rollback;
  • kodelagre og infrastruktur: 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;
  • en >-omdirigering til en disk (/dev/sd*, /dev/nvme*) eller til /etc/.

Den samme listen brukes av CLI-en og av serveren: en destruktiv kommando som startes uten godkjent bekreftelse, avvises på begge sider. Flyten er beskrevet i Bekreftelser.

Endre omfanget

  • Utvide (legge til et domene, gå fra skrivebeskyttet til full tilgang) krever den andre faktoren på nytt (TOTP eller passnøkkel).
  • Innskrenke (fjerne et domene, gå tilbake til skrivebeskyttet, fjerne en vert) skjer umiddelbart og krever ingenting: kopier utenfor omfanget slettes med en gang.

Kommandoregler og tidsgrensen kan endres når som helst, med hvelvet åpent. Slik ser du hva maskinen faktisk bruker:

konsolity policy

Eksempler

Overvåking (skrivebeskyttet, hosts + sessions): lister og status, ingen kommandoer.

Daglig drift (full tilgang, noen få verter):

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

pluss snuttene «Start nginx på nytt» og «Tøm applikasjonsbufferen».

Utrulling fra CI (langvarig token, full tilgang, hosts + snippets): én enkelt snutt «Rull ut» på produksjonsverten, ingen regel for frie kommandoer.