Bereich und Regeln

Aktualisiert am 10. November 2026

Eine CLI-Maschine hat nur Zugriff auf das, was Sie ihr gegeben haben. Der Bereich wird bei der Freigabe gewählt und lässt sich später unter Einstellungen › CLI-Maschinen ändern (oder auf app.konsolity.com/cli-machines, bei geöffnetem Tresor). Er wird doppelt durchgesetzt: vom Server, der jeden Aufruf außerhalb des Bereichs ablehnt, und von der Maschine selbst, die verschlüsselte Regeln anwendet, die der Server weder lesen noch ändern kann. Beide lehnen ab, was nicht erlaubt ist.

Domänen

Domäne Was sie erlaubt
hosts Die gewählten Hosts auflisten; bei vollem Zugriff Befehle darauf ausführen (konsolity run).
snippets Die gewählten Snippets auflisten; bei vollem Zugriff und mit hosts sie ausführen (konsolity snippet run).
sessions Die laufenden CLI-Sitzungen des Kontos sehen und beenden (konsolity sessions).
mcp Claude-Agenten als Tools dienen (konsolity mcp, konsolity serve).

Standard: hosts und snippets.

Nur lesend oder voller Zugriff

  • Nur lesend: nur Listen und Status. Es kann kein Befehl ausgeführt werden, auch nicht über ein Snippet. Das ist der Standardzugriff und die richtige Wahl für ein Dashboard oder die Überwachung.
  • Voller Zugriff: Befehle sind auf den gewählten Hosts erlaubt, im Rahmen der folgenden Befehlsregeln.

Der Maschinentresor

Die Maschine erhält nie den Schlüssel Ihres Tresors. Bei der Freigabe erzeugt Ihr Gerät einen Maschinenschlüssel nur für diese Maschine, übergibt ihn versiegelt und kopiert dann, mit diesem Schlüssel verschlüsselt, nur die Einträge, die der Bereich erlaubt:

  • die gewählten Hosts, mit ihren Identitäten, ihren SSH-Schlüsseln und ihren fixierten Host-Schlüsseln;
  • die gewählten Snippets;
  • die Regeln der Maschine.

Der Server speichert diese Kopien als undurchsichtige Blöcke. Ein Host außerhalb des Bereichs hat keine Kopie: Sein SSH-Schlüssel verlässt Ihren Tresor nie. Die Maschine hat keinen Zugriff auf den Tresor des Kontos.

  • Einen Host hinzufügen zum Bereich: Ein Gerät mit geöffnetem Tresor schreibt seine Kopie.
  • Einen Host entfernen: Der Server löscht seine Kopie sofort.
  • Einen Host bearbeiten im Tresor (Adresse, Schlüssel): Ihre Geräte aktualisieren die Kopien der Maschinen bei der nächsten Synchronisierung. Wird der Host gelöscht, werden auch seine Kopien gelöscht.

Nur Hosts, deren Host-Schlüssel bereits im Tresor fixiert ist, können verwendet werden: Die CLI akzeptiert nie einen unbekannten Host-Schlüssel (host_key_unknown). Verbinden Sie sich einmal aus der App mit dem Host, um ihn zu fixieren.

Befehlsregeln

Bei vollem Zugriff ist konsolity run (und das Claude-Tool run_command) nur erlaubt, wenn der Host im Bereich liegt und der Befehl, ohne führende und abschließende Leerzeichen, einer Regel entspricht. Drei Vergleichsarten:

Typ Regel Beispielmuster Akzeptiert Lehnt ab
exact der gesamte Befehl, identisch df -h df -h df -h /
prefix der Befehl beginnt mit dem Muster uptime uptime -p w
glob * steht für eine Folge von Zeichen systemctl status * systemctl status nginx systemctl restart nginx

Was * nie erlaubt

In einem glob-Muster darf * Folgendes nicht enthalten:

  • ; & | (Verkettung und Pipe);
  • ` und $( (Befehlsersetzung);
  • > und < (Umleitung);
  • einen Zeilenumbruch.

systemctl status * akzeptiert also weder systemctl status nginx; rm -rf / noch systemctl status x | sh. Ein prefix-Muster akzeptiert alles, was auf das Präfix folgt, unverändert: Verwenden Sie es nur für harmlose Befehle.

Beliebiger Befehl

Die Option Beliebiger Befehl erlaubt jeden Text auf den gewählten Hosts. Sie verlangt eine ausdrückliche Bestätigung auf dem Bildschirm und wird nicht empfohlen: Die Maschine wird zum Gegenstück eines vollständigen Shell-Zugriffs. Destruktive Befehle werden weiterhin bestätigt (siehe unten).

Bei einer Aktivierung mit vollem Zugriff ist keine Regel angekreuzt und „Beliebiger Befehl“ ist deaktiviert: Sie müssen Regeln schreiben oder „Beliebiger Befehl“ ausdrücklich ankreuzen, sonst wird jeder freie Befehl abgelehnt. Erlaubte Snippets laufen so, wie sie gespeichert sind.

Maximales Zeitlimit

Jeder Befehl wird nach dem maximalen Zeitlimit gestoppt: standardmäßig 60 Sekunden, höchstens 1 Stunde. Der über --timeout oder von Claude angefragte Wert wird immer durch dieses Zeitlimit begrenzt.

Destruktive Befehle: immer bestätigt

Manche Befehle werden nie ohne Ihre ausdrückliche Bestätigung in der App oder in der Konsole ausgeführt, unabhängig vom Bereich, selbst mit „Beliebiger Befehl“. Ein Befehl (oder der Inhalt eines Snippets) ist destruktiv, wenn er als eigenes Wort zum Beispiel Folgendes enthält:

  • Löschen und Überschreiben: rm -r, rm -f, rmdir, shred, truncate, dd, mkfs, fdisk, parted, wipefs;
  • Herunterfahren: shutdown, reboot, poweroff, halt, init 0, init 6, systemctl stop, disable, mask, kill, service ... stop, kill -9, killall, pkill;
  • Konten und Berechtigungen: userdel, deluser, passwd, chmod -R, chown -R, crontab -r;
  • Firewall: iptables -F, ufw disable, ufw reset;
  • Datenbanken: DROP, TRUNCATE, DELETE FROM, ALTER TABLE ... DROP, migrate:fresh, migrate:reset, migrate:rollback;
  • Repositorys und 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;
  • eine Umleitung > auf ein Laufwerk (/dev/sd*, /dev/nvme*) oder nach /etc/.

Dieselbe Liste wird von der CLI und vom Server angewendet: Ein destruktiver Befehl, der ohne freigegebene Bestätigung gestartet wird, wird auf beiden Seiten abgelehnt. Der Ablauf ist unter Bestätigungen beschrieben.

Den Bereich ändern

  • Erweitern (eine Domäne hinzufügen, von nur lesend zu vollem Zugriff wechseln) verlangt erneut den zweiten Faktor (TOTP oder Passkey).
  • Einschränken (eine Domäne entfernen, zurück zu nur lesend, einen Host entfernen) wirkt sofort und verlangt nichts: Kopien außerhalb des Bereichs werden sofort gelöscht.

Befehlsregeln und Zeitlimit lassen sich jederzeit bei geöffnetem Tresor ändern. Um zu sehen, was die Maschine tatsächlich anwendet:

konsolity policy

Beispiele

Überwachung (nur lesend, hosts + sessions): Listen und Status, kein Befehl.

Täglicher Betrieb (voller Zugriff, einige 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

dazu die Snippets „nginx neu starten“ und „Anwendungscache leeren“.

Deployment aus der CI (langlebiges Token, voller Zugriff, hosts + snippets): ein einziges Snippet „Deployen“ auf dem Produktionshost, keine Regel für freie Befehle.