Zum Inhalt springen
kaiport

Freigaben und Sicherheit

Wie AI Pilot fragt, bevor er handelt: Freigaben, Autopilot, Befehle, die immer fragen, erlaubte und verbotene Befehle, Schrittlimit und KI-Protokoll.

AI Pilot kann echte Systeme verändern, deshalb überlässt kaiport die Entscheidungen dir. Diese Seite erklärt, welche Schritte auf deine Freigabe warten, was der Autopilot ändert, welche Befehle immer fragen, wie du AI Pilot pro Verbindung einschränkst und wo du nachsehen kannst, was er getan hat.

Schritt freigeben oder ablehnen

Braucht ein Schritt deine Freigabe, zeigt seine Karte Wartet auf Freigabe (Awaiting approval), eine Frage und zwei Knöpfe:

  • Ausführen (Run) führt den Schritt aus.
  • Ablehnen (Deny) überspringt ihn. AI Pilot erfährt, dass du abgelehnt hast und dass er den Schritt nicht unverändert wiederholen, sondern nachfragen oder eine Alternative vorschlagen soll.

Die Frage verrät, um welche Art Schritt es geht: Soll dieser Befehl im Terminal ausgeführt werden?, Soll diese Änderung ausgeführt werden? bei Dateiaktionen oder Sollen alle Schritte dieses Plans ausgeführt werden? bei einem Plan im Speicher-Tab. Gefährliche Schritte zeigen stattdessen eine Warnung, und ihr Knopf Ausführen ist rot: Potenziell gefährlicher Befehl – bitte genau prüfen. bei Befehlen, Diese Aktion löscht oder überschreibt Daten – bitte genau prüfen. bei Dateiaktionen.

Nichts läuft, bevor du auf Ausführen klickst
Eine Befehlskarte im AI-Pilot-Panel, die mit Ausführen und Ablehnen auf Freigabe wartetEine Befehlskarte im AI-Pilot-Panel, die mit Ausführen und Ablehnen auf Freigabe wartet

Nichts läuft, bevor du auf Ausführen klickst

Was eine Freigabe braucht

In Terminal-Tabs

Das gilt für SSH-Verbindungen.

SchrittOhne AutopilotMit Autopilot
Befehl ausführenfragtläuft; gefährliche Befehle fragen
Tasten an ein interaktives Programm sendenfragtläuft
Datei schreiben oder ändern (den Diff prüfst du vorher)fragtläuft; Dateien, die dich aussperren können, fragen
Bildschirm lesen; Dateien lesen, auflisten, finden oder durchsuchen; Ordnerbericht; Server-Ansicht sammelnläuftläuft
Knopf in einer Server-Ansicht klickenfragt mit dem genauen Befehlfragt mit dem genauen Befehl
Schritt zu einem laufenden Plan hinzufügenfragtfragt
Rückfrage an dichwartet auf deine Antwortwartet auf deine Antwort

In Speicher-Tabs

Das gilt für FTP-, S3-, WebDAV- und Azure-Verbindungen in der Übertragungsansicht.

SchrittOhne AutopilotMit Autopilot
Dateien lesen, auflisten, finden oder durchsuchen; Ordnerberichtläuftläuft
Ordner anlegenfragtläuft
Neue Datei schreiben, unter einem freien Namen umbenennen oder verschieben, hochladen, herunterladenfragtläuft
Datei oder Ordner löschenfragtfragt
Vorhandene Datei schreiben, auf einen vorhandenen Namen umbenennen oder verschieben, auf eine vorhandene Datei hoch- oder herunterladenfragtfragt
Plan ausführenfragtfragt
Rückfrage an dichwartet auf deine Antwortwartet auf deine Antwort

Ein Plan gilt als gefährlich – mit Warnung und rotem Knopf –, wenn er etwas löscht oder eine vorhandene Datei überschreiben würde.

Autopilot

Mit dem Autopilot arbeitet AI Pilot, ohne für jeden Schritt anzuhalten. Du stellst ihn an zwei Stellen ein:

  • Einstellungen → AI Pilot → Autopilot ist der Standard für neue Chats.
  • Der Schalter Autopilot in der Werkzeugleiste des Panels gilt für den Chat in diesem Tab. Du kannst ihn jederzeit umlegen, auch während AI Pilot arbeitet.

Schaltest du den Autopilot ein, während Schritte auf Freigabe warten, laufen die ungefährlichen sofort los; gefährliche warten weiter auf deinen Klick. Der leere Chat zeigt, welcher Modus gilt, zum Beispiel Jeden Befehl bestätigst du vor der Ausführung. oder Autopilot ist aktiv – ich führe Befehle ohne Rückfrage aus.

Das prüft der Autopilot nicht:

  • Text und Tasten, die AI Pilot an ein interaktives Programm schickt, fragen nur, wenn sie einen gefährlichen Befehl absenden. Alles andere – ein y auf eine Rückfrage, eine Taste in einem Vollbildprogramm – läuft im Autopilot ohne Rückfrage.
  • In Terminal-Tabs läuft das Schreiben einer Datei im Autopilot ohne Rückfrage, auch wenn es eine vorhandene Datei ersetzt – außer bei den Dateien, die dich aussperren können.

Nutze den Autopilot dort, wo diese Risiken vertretbar sind, und kombiniere ihn mit den Listen pro Verbindung weiter unten.

Befehle, die immer fragen

kaiport erkennt Befehle, die Daten zerstören oder dich aussperren können. Sie warten auch im Autopilot auf deine Freigabe. Die Prüfung betrachtet die ganze Befehlszeile und erkennt diese Befehle deshalb auch nach sudo oder in einer Kette wie cd /tmp && ….

  • Rekursives Löschen: rm -r, rm -R, rm --recursive sowie rm -f /
  • Formatieren und Partitionieren: mkfs, fdisk, parted, wipefs
  • Direktes Schreiben auf Datenträger: dd mit of=/dev/… sowie Ausgabeumleitungen nach /dev/sd…, /dev/nvme…, /dev/hd… oder /dev/disk…
  • Herunterfahren und Neustarten: shutdown, reboot, poweroff, halt, init 0, init 6
  • Rechte oder Besitzer pauschal ändern: chmod 777 (auch mit -R), chown -R auf /
  • Datenbankinhalte löschen: DROP TABLE, DROP DATABASE, DROP SCHEMA, TRUNCATE TABLE
  • Git-Verlauf umschreiben oder Arbeit verwerfen: git push --force oder -f, git reset --hard, git clean -f
  • Viele Prozesse beenden: kill -9 -1, killall, pkill -9
  • Firewall oder Netzwerkzugang abschalten: Regeln von iptables oder nft leeren, ufw disable, ufw reset sowie systemctl stop, disable oder mask für SSH-, Netzwerk- oder Firewall-Dienste
  • Benutzer und Passwörter ändern: passwd, userdel, usermod, deluser, groupdel
  • Pakete entfernen: apt, apt-get, yum, dnf, zypper oder pacman mit remove, purge, autoremove oder -R
  • Alle Cronjobs löschen: crontab -r
  • Heruntergeladene Skripte ausführen: curl oder wget mit Pipe in sh oder bash, auch mit sudo
  • Spuren oder Daten tilgen: history -c, shred
  • Die Shell-Forkbombe :(){ :|:& };:

Dateien, die dich aussperren können

Änderungen an diesen Dateien warten immer auf deinen Klick, auch im Autopilot, und zeigen die Warnung Ein Fehler in dieser Datei kann dich vom Server aussperren:

  • /etc/sudoers und /etc/sudoers.d/, /etc/ssh/sshd_config und /etc/ssh/sshd_config.d/
  • /etc/passwd, /etc/shadow, /etc/group, /etc/gshadow, /etc/fstab, /etc/crypttab
  • /etc/pam.d/ und /etc/security/
  • Netzwerkkonfiguration in /etc/netplan/, /etc/network/, /etc/NetworkManager/ und /etc/systemd/network/
  • Firewall-Regeln von iptables, nftables und ufw unter /etc
  • alles unter /boot/
  • ~/.ssh/authorized_keys

Verbotene und erlaubte Befehle pro Verbindung

Für jede SSH-Verbindung kannst du einschränken, welche Befehle AI Pilot ausführen darf:

  1. Öffne im Startfenster das Menü der Verbindung (…) und wähle Bearbeiten.
  2. Wechsle zum Tab KI (AI).
  3. Fülle Verbotene Befehle (KI) (Denied commands (AI)), Erlaubte Befehle (KI) (Allowed commands (AI)) oder beides aus.
  4. Klicke auf Speichern.

Verbotene Befehle (KI) werden abgelehnt, auch im Autopilot. Enthält Erlaubte Befehle (KI) Muster, darf AI Pilot nur Befehle ausführen, die auf eines davon passen; alles andere wird abgelehnt.

Regeln für eine Verbindung
Der Tab KI im Verbindungsdialog mit KI-Anweisungen, verbotenen und erlaubten BefehlenDer Tab KI im Verbindungsdialog mit KI-Anweisungen, verbotenen und erlaubten Befehlen

Regeln für eine Verbindung

So funktionieren die Muster:

  • Schreibe ein Muster pro Zeile. Jede Zeile ist ein regulärer Ausdruck; Groß- und Kleinschreibung spielen keine Rolle.
  • Ein Muster passt, wenn es irgendwo in der Befehlszeile vorkommt: systemctl restart sperrt auch sudo systemctl restart nginx. Mit ^ passt ein Muster nur am Anfang, zum Beispiel ^ls.
  • Verbotene Muster werden zuerst geprüft. Ein Befehl, der auf ein verbotenes Muster passt, wird abgelehnt, auch wenn er zusätzlich auf ein erlaubtes passt.
  • Eine Zeile, die kein gültiger regulärer Ausdruck ist, wird ignoriert.
  • Ein abgelehnter Befehl läuft nicht. Seine Karte zeigt abgelehnt, AI Pilot erfährt, dass er es nicht erneut versuchen, sondern dir Bescheid geben soll, und das KI-Protokoll vermerkt Blockiert.
  • Die Listen gelten nur für Befehle. Tasten an interaktive Programme und Dateiaktionen werden nicht dagegen geprüft.

Beispiele für verbotene Befehle:

text
systemctl (restart|stop)
\bdocker\s+rm\b
rm -rf /var

Beispiele für eine Liste, die nur Lesendes erlaubt:

text
^ls\b
^cat\b
^systemctl status\b
^journalctl\b

Zahl der Schritte begrenzen

Einstellungen → AI Pilot → Max. Schritte pro Anfrage (Standard 30, von 1 bis 100) legt fest, wie viele Runden von Werkzeugaufrufen AI Pilot für eine Nachricht machen darf. Ist das Limit erreicht, hört er mit der Anfrage auf. Schick eine weitere Nachricht wie „weiter“, damit er fortfährt. Ein niedriges Limit hält ausufernde Aufgaben kurz, ein höheres passt zu langen Wartungsarbeiten.

Das KI-Protokoll

kaiport protokolliert jeden Befehl und jede Dateiaktion von AI Pilot lokal. Du öffnest das Protokoll über Einstellungen → AI Pilot → KI-Protokoll → Protokoll ansehen (AI audit log → View log). Der Dialog zeigt die letzten 300 Einträge, die neuesten zuerst. Jeder Eintrag enthält:

  • die Entscheidung,
  • den Befehl oder die Argumente einer Dateiaktion,
  • die Pfade, die der Schritt gelesen oder geändert hat,
  • den Host, Datum und Uhrzeit und bei Befehlen den Exit-Code.
EntscheidungBedeutung
FreigegebenDu hast auf Ausführen geklickt oder eine Rückfrage beantwortet. Anfragen des Editor-Assistenten werden ebenfalls als freigegeben protokolliert.
AutopilotDer Schritt lief ohne Rückfrage: im Autopilot oder als lesender Schritt, der nie fragt.
AbgelehntDu hast auf Ablehnen oder Stoppen geklickt oder eine Rückfrage offen gelassen.
BlockiertDie verbotenen oder erlaubten Befehle der Verbindung haben den Befehl abgelehnt.
FehlerDer Schritt ist fehlgeschlagen.

Ein Befehl steht meist zweimal im Protokoll: einmal bei der Freigabe und einmal mit seinem Exit-Code, wenn er fertig ist.

Einstellungen → AI Pilot → KI-Protokoll
Der Dialog KI-Protokoll mit einer Liste von EinträgenDer Dialog KI-Protokoll mit einer Liste von Einträgen

Einstellungen → AI Pilot → KI-Protokoll

Datei im Finder zeigen (Show file) zeigt die Datei ai-audit.jsonl im Finder. Sie enthält pro Zeile ein JSON-Objekt mit den Feldern at (Zeitpunkt in Millisekunden), connection, host, tool, command, decision, exitCode, note und paths – so kannst du sie mit anderen Werkzeugen durchsuchen oder auswerten. kaiport hängt neue Einträge immer nur an.

Aufrufe anderer KI-Werkzeuge über den MCP-Server von kaiport folgen diesen Regeln ebenfalls, mit strengeren Vorgaben: Ohne Autopilot in ihrem Tab läuft nur Lesendes ohne Klick; siehe MCP-Server.

Bewährte Vorgehensweisen

  • Starte auf einem neuen Server ohne Autopilot. Sieh zu, was AI Pilot tut, bevor du ihn allein arbeiten lässt.
  • Lies jeden Befehl, bevor du auf Ausführen klickst – vor allem bei Karten mit Warnung.
  • Schreib die Regeln eines Servers in KI-Anweisungen für diese Verbindung, zum Beispiel „Produktionssystem – Dienste nie ohne Rückfrage neu starten.“
  • Sperre mit Verbotene Befehle (KI), was nie passieren darf.
  • Verbinde dich mit einem Benutzerkonto, das nur die Rechte hat, die die Aufgabe braucht.
  • Tippe Passwörter ins Terminal, nie in den Chat.
  • Sieh nach längeren Autopilot-Sitzungen ins KI-Protokoll.