Domeniu și reguli

Actualizat pe 10 noiembrie 2026

O mașină CLI are acces doar la ce i-ați acordat. Domeniul se alege la aprobare și poate fi modificat ulterior în Setări › Mașini CLI (sau pe app.konsolity.com/cli-machines, cu seiful deschis). Este aplicat de două ori: de server, care refuză orice apel din afara domeniului, și de mașina însăși, care aplică reguli criptate pe care serverul nu le poate nici citi, nici modifica. Amândouă refuză ce nu este permis.

Domenii

Domeniu Ce permite
hosts Listarea gazdelor alese; cu acces complet, rularea de comenzi pe ele (konsolity run).
snippets Listarea fragmentelor alese; cu acces complet și hosts, rularea lor (konsolity snippet run).
sessions Vizualizarea sesiunilor CLI în curs pe cont și încheierea lor (konsolity sessions).
mcp Servirea ca instrumente pentru agenții Claude (konsolity mcp, konsolity serve).

Implicit: hosts și snippets.

Doar în citire sau acces complet

  • Doar în citire: numai liste și stare. Nicio comandă nu poate fi rulată, nici măcar printr-un fragment. Este accesul implicit și alegerea potrivită pentru un panou de bord sau pentru monitorizare.
  • Acces complet: comenzile sunt permise pe gazdele alese, în limitele regulilor de comenzi de mai jos.

Seiful de mașină

Mașina nu primește niciodată cheia seifului dumneavoastră. La aprobare, dispozitivul dumneavoastră generează o cheie de mașină proprie acestei mașini, i-o transmite sigilată, apoi copiază, criptate cu această cheie, doar elementele permise de domeniu:

  • gazdele alese, cu identitățile, cheile SSH și cheile de gazdă fixate;
  • fragmentele alese;
  • regulile mașinii.

Serverul stochează aceste copii ca blocuri opace. O gazdă din afara domeniului nu are nicio copie: cheia sa SSH nu părăsește niciodată seiful. Mașina nu are acces la seiful contului.

  • Adăugarea unei gazde în domeniu: un dispozitiv cu seiful deschis îi scrie copia.
  • Eliminarea unei gazde: serverul îi șterge imediat copia.
  • Modificarea unei gazde în seif (adresă, cheie): dispozitivele dumneavoastră actualizează copiile mașinilor la următoarea sincronizare. Ștergerea gazdei îi șterge și copiile.

Pot fi folosite doar gazdele a căror cheie de gazdă este deja fixată în seif: CLI nu acceptă niciodată o cheie de gazdă necunoscută (host_key_unknown). Conectați-vă o dată la gazdă din aplicație pentru a o fixa.

Reguli de comenzi

Cu acces complet, konsolity run (și instrumentul run_command al lui Claude) este permis doar dacă gazda este în domeniu și comanda, fără spațiile de la început și de la sfârșit, corespunde unei reguli. Trei moduri de comparare:

Tip Regulă Model exemplu Acceptă Refuză
exact comanda întreagă, identică df -h df -h df -h /
prefix comanda începe cu modelul uptime uptime -p w
glob * înlocuiește un șir de caractere systemctl status * systemctl status nginx systemctl restart nginx

Ce nu permite niciodată *

Într-un model glob, * nu poate conține:

  • ; & | (înlănțuire și pipe);
  • ` și $( (substituție de comandă);
  • > și < (redirecționare);
  • un salt de linie.

Astfel, systemctl status * nu acceptă nici systemctl status nginx; rm -rf /, nici systemctl status x | sh. Un model prefix acceptă tot ce urmează după prefix așa cum este: rezervați-l pentru comenzi inofensive.

Orice comandă

Opțiunea Orice comandă permite orice text pe gazdele alese. Cere o confirmare explicită pe ecran și este nerecomandată: mașina devine echivalentul unui acces shell complet. Comenzile distructive rămân supuse confirmării (vezi mai jos).

La activarea cu acces complet, nicio regulă nu este bifată și „Orice comandă” este dezactivată: trebuie să scrieți reguli sau să bifați explicit „Orice comandă”, altfel orice comandă liberă este refuzată. Fragmentele permise rulează așa cum sunt salvate.

Timp maxim de execuție

Orice comandă este oprită dacă depășește timpul maxim de execuție: 60 de secunde implicit, 1 oră cel mult. Valoarea cerută prin --timeout sau de Claude este întotdeauna limitată de acest timp.

Comenzi distructive: confirmate întotdeauna

Unele comenzi nu sunt rulate niciodată fără confirmarea dumneavoastră explicită în aplicație sau în consolă, indiferent de domeniu, chiar și cu „Orice comandă”. O comandă (sau conținutul unui fragment) este distructivă dacă conține, ca cuvânt separat, de exemplu:

  • ștergere și distrugere de date: rm -r, rm -f, rmdir, shred, truncate, dd, mkfs, fdisk, parted, wipefs;
  • oprire: shutdown, reboot, poweroff, halt, init 0, init 6, systemctl stop, disable, mask, kill, service ... stop, kill -9, killall, pkill;
  • conturi și permisiuni: userdel, deluser, passwd, chmod -R, chown -R, crontab -r;
  • firewall: iptables -F, ufw disable, ufw reset;
  • baze de date: DROP, TRUNCATE, DELETE FROM, ALTER TABLE ... DROP, migrate:fresh, migrate:reset, migrate:rollback;
  • depozite și infrastructură: 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;
  • o redirecționare > către un disc (/dev/sd*, /dev/nvme*) sau către /etc/.

Aceeași listă este aplicată de CLI și de server: o comandă distructivă pornită fără o confirmare aprobată este refuzată de ambele părți. Fluxul este descris în Confirmări.

Modificarea domeniului

  • Extinderea (adăugarea unui domeniu, trecerea de la doar în citire la acces complet) cere din nou al doilea factor (TOTP sau cheie de acces).
  • Restrângerea (eliminarea unui domeniu, revenirea la doar în citire, eliminarea unei gazde) este imediată și nu cere nimic: copiile din afara domeniului sunt șterse imediat.

Regulile de comenzi și timpul de execuție pot fi modificate oricând, cu seiful deschis. Pentru a vedea ce aplică efectiv mașina:

konsolity policy

Exemple

Monitorizare (doar în citire, hosts + sessions): liste și stare, nicio comandă.

Operațiuni zilnice (acces complet, câteva gazde):

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 fragmentele „Repornește nginx” și „Golește memoria cache a aplicației”.

Implementare din CI (token de lungă durată, acces complet, hosts + snippets): un singur fragment „Implementare” pe gazda de producție, nicio regulă de comandă liberă.