Richtlinienkonfiguration¶

In verwalteten Umgebungen kann ein Administrator korTTY über eine einzige TOML-Datei, kortty-policy.toml, die im Installationsverzeichnis abgelegt wird, einschränken oder vorkonfigurieren. Benutzer können es nicht ändern oder umgehen: Die Datei wird nur aus dem vom Administrator beschreibbaren Installationsordner gelesen, gesperrte Einstellungen werden ausgegraut mit dem Hinweis „Von Ihrer Organisation verwaltet“ angezeigt und die manuelle Bearbeitung von global-settings.xml wird beim nächsten Laden rückgängig gemacht. In diesem Kapitel wird erläutert, wo sich die Datei befindet, wie Regeln auf Benutzer, Gruppen und Server abzielen und alle verfügbaren Parameter anhand von Beispielen dokumentiert werden.

Dateispeicherort und Sicherheitsmodell¶

korTTY lädt die Richtlinie ausschließlich aus dem Ordner policy/ seines Installationsverzeichnisses – dem Ordner, der auch die Anwendungs-JAR-Datei enthält – und niemals aus ~/.kortty/ oder einem anderen vom Benutzer beschreibbaren Speicherort. Eine kopierfertige Vorlage wird als policy/kortty-policy.toml.example geliefert; Kopieren Sie es nach kortty-policy.toml im selben Ordner und starten Sie korTTY neu (es gibt kein Hot-Reload).

Das Durchsetzungsmodell basiert auf den Dateiberechtigungen des Betriebssystems: Das Installationsverzeichnis darf nur von Administratoren beschreibbar sein, was für die oben genannten Speicherorte die Standardeinstellung ist. korTTY protokolliert zusätzlich eine Warnung, wenn die aktive Richtliniendatei vom aktuellen Benutzer beschreibbar ist. Während der Entwicklung (niemals in einer Paketinstallation) kann eine Richtlinie mit -Dkortty.policy.file=/path/to/policy.toml getestet werden.

Wenn die Datei existiert, aber nicht geparst werden kann oder einen ungültigen Wert enthält, startet korTTY im Fail-Safe-Sperrenmodus: Jede durch die Richtlinie steuerbare Funktion wird verweigert, keine Serververbindung ist erlaubt, jedes Einfügen in ein Terminal mit Zeilenumbruch verlangt eine Bestätigung, Programme können mit OSC 52 keinen Text in die Zwischenablage legen, die vorherige Sitzung wird beim Start nicht wiederhergestellt, die Ausgabe von Terminalfenstern wird dafür nicht gespeichert, und ein Startdialog benennt die Datei und die genaue Fehlerposition. Ein Tippfehler kann die Durchsetzung daher niemals stillschweigend deaktivieren. Eine einzige ungültige Regel verwirft die gesamte Datei; unbekannte Schlüssel erzeugen lediglich Warnungen im Protokoll, sodass eine für eine neuere korTTY-Version erstellte Richtlinie Benutzer einer älteren Version nicht sperrt. Dies gilt auch für [rule.ai-memory]: Ein unbekannter Schlüssel dort wird protokolliert und ignoriert, prüfen Sie daher das Protokoll, nachdem Sie diese Tabelle geändert haben.

Benutzer, Gruppen und Regelpriorität¶

Regeln zielen auf den aktuellen Anmeldenamen des Betriebssystems ab (entspricht Kleinbuchstaben). Die Gruppenmitgliedschaft stammt aus zwei Quellen gleichzeitig: Gruppen, die in der Tabelle [groups] der Richtlinie definiert sind, und den Gruppenmitgliedschaften des Benutzers auf Betriebssystemebene. Auf in die Domäne eingebundenen Windows-Computern umfassen die Betriebssystemgruppen Active Directory-Gruppen, sodass Regeln direkt auf AD-Gruppen abzielen können – sowohl vollständig qualifiziert (ACME\Operations) als auch als bloßer Name (operations) – ohne dass eine Verzeichnisserverkonfiguration erforderlich ist.

Jeder [[rule]]-Block benennt optional users und/oder groups; Eine Regel, die keine Benennung vornimmt, gilt für jeden Benutzer. Pro Einstellung gewinnt die spezifischste Stufe, die sie festlegt: Benutzer schlägt Gruppe schlägt alle. Das ist das bekannte Gruppenrichtlinienmuster: Sperren Sie alles in einer Grundregel für alle und lockern Sie dann die individuellen Einstellungen für eine vertrauenswürdige Gruppe. Wenn mehrere Regeln derselben Ebene denselben Schlüssel festlegen, gilt der restriktivste Wert (deny über read-only über confirm über allow); Gemäß den Serverregeln muss eine Verbindung alle geltenden Einschränkungen der Gewinnerstufe erfüllen. Die Reihenfolge der Regeln in der Datei hat keine Bedeutung.

[meta]
schema-version = 1
organization = "ACME Corp"

[groups]
devs = ["alice", "bob"]

[[rule]]                              # applies to ALL users
name = "company-baseline"
  [rule.features]
  ai-agent = "deny"

[[rule]]                              # group tier: relaxes the baseline for ops
name = "ops-exception"
groups = ["ops", "ACME\\Operations"]  # policy group OR OS/AD group
  [rule.features]
  ai-agent = "allow"
  ai-agent-execution = "confirm"

[[rule]]                              # user tier: beats eve's group
users = ["eve"]
  [rule.features]
  ai-agent = "deny"

Server-Zugriffskontrolle¶

Die [rule.servers]-Tabelle schränkt ein, zu welchen Servern ein Benutzer eine Verbindung herstellen darf – als Zulassungsliste (mode = "allow": nur aufgelistete Server sind erreichbar) oder als Sperrliste (mode = "deny": aufgelistete Server sind blockiert). Die Einschränkung wird zentral für jeden Verbindungspfad durchgesetzt: gespeicherte Verbindungen, QuickConnect, geteilte Panes (mit neuer Verbindung oder zum selben Server), Sitzungswiederherstellung, SFTP, von Teamwork freigegebene Verbindungen, KI-Schwarmziele und geplante Jobs, einschließlich des Jump-Hosts einer Verbindung. Blockierte Verbindungen bleiben im Connection-Manager sichtbar, werden jedoch mit einer Sperrmarkierung ausgegraut und bei jedem Verbindungsversuch wird eine eindeutige Richtlinienmeldung angezeigt.

Gruppe öffnen in der Schnellverbindung überspringt jede Verbindung der Gruppe, deren Server oder Jump-Server gesperrt ist, und nennt sie alle in einer Richtlinienmeldung; die übrigen Verbindungen der Gruppe öffnen sich weiterhin. Verbinden im Connection-Manager, Duplizieren an einem Tab und Geschlossenen Tab wieder öffnen prüfen die Richtlinie, bevor sie nach einem Passwort, einem temporären SSH-Schlüssel oder dem Master-Passwort fragen, und ein offener Tab prüft sie bei jedem Verbindungs- und Neuverbindungsversuch erneut, weil das Bearbeiten einer gespeicherten Verbindung auch die bereits daraus geöffneten Tabs ändert. Zeigt ein Tab nach einer solchen Änderung auf einen gesperrten Server oder Jump-Server, zeigt sein Terminal die Richtlinienmeldung, und korTTY versucht es nicht weiter, auch nicht per automatischer Neuverbindung.

Lokale Shells und serielle Verbindungen haben keinen Server und werden nicht gegen [rule.servers] geprüft; serielle Ports werden stattdessen durch serial-connections unter [rule.features] geregelt.

Muster stimmen genau mit der Hostzeichenfolge überein, wie sie in der Verbindung konfiguriert ist – korTTY löst DNS nie für Richtlinienprüfungen auf, daher sind Hostnamen und IP-Adressen separate Namespaces: Wenn ein Server in beide Richtungen erreichbar ist, listen Sie beide auf.

[[rule]]
  [rule.servers]
  mode  = "deny"
  hosts = ["*.prod.acme.com", "vault.acme.com:22", "192.168.10.42", "10.99.0.0/16", "10.20.0.100-10.20.0.199"]

Parameterreferenz¶

[meta]¶

[groups]¶

[[rule]] Bereich¶

[rule.servers]¶

[rule.features]¶

[rule.security]¶

[rule.teamwork], [rule.snippets], [rule.ai-profiles]¶

Gespeicherter Skripttext der Analysen¶

A Vollständige Code-Analyse speichert den Skripttext, an dem gearbeitet wurde — das analysierte Skript, den Text, von dem aus apply gestartet wurde, das vorgeschlagene Ergebnis und den akzeptierten Text — sodass die Codevorschau, Änderungen ansehen, der Skriptexport, der Berichtsanhang, Zwischenstand wiederherstellen und das Fortsetzen nach einem Neustart weiterhin funktionieren. Benutzer wählen die Größe selbst unter Einstellungen → Snippet-Editor → Gespeicherte Skriptgröße pro Analyse (Standard 1 MB, maximal 5 MB oder Aus) ; analysis-max-stored-content-bytes in [rule.snippets] ist eine Obergrenze auf dieser Wahl:

[[rule]]
name = "Keep script text small"
  [rule.snippets]
  analysis-max-stored-content-bytes = 524_288      # at most 512 KB per stored text

[[rule]]
name = "Compliance team: no script text in analyses"
groups = ["compliance"]
  [rule.snippets]
  analysis-max-stored-content-bytes = 0            # findings and reports only

• Effektiver Grenzwert — Der kleinere Wert aus dem eigenen Wert des Benutzers (Standardwert 1 MB), dem festgelegten maximalen Wert von 5 MB und diesem Schlüssel. Ein Wert über 5 MB hat daher keine Wirkung, und ein niedrigerer Benutzerwert bleibt gültig. Jeder positive Wert wird akzeptiert, auch ein Wert unter dem Mindestwert von 256 KB, den Benutzer wählen kann.
• 0 — Kein Skripttext wird gespeichert: Die Analyse behält ihre Ergebnisse, Zusammenfassung, Diagramm und Berichte, aber nicht das Skript, sodass Änderungen ansehen, die vorherigen Einträge mit dem Code-Vorschau, der Skriptexport, der Berichtsanhang, Zwischenstand wiederherstellen und das Fortsetzen nach einem Neustart nicht verfügbar sind. Das Panel zeigt, dass die Organisation den Speicherung des Skripttexts nicht erlaubt. Die Analyse selbst, einschließlich der Anwendung der Ergebnisse und der sofortigen Änderungsprüfung im Editor, funktioniert wie zuvor. Text, der zuvor gespeichert wurde, wird beim nächsten Schreiben der gespeicherten Analysen gelöscht.
• Einstellungen-Dialog — Das Dropdown-Menü bietet nur Größen bis zur Grenze an, zeigt die Grenze darunter und ist gesperrt (mit dem Hinweis "Verwaltet von Ihrer Organisation"), wenn der Wert 0 ist. Die Benutzerwahl wird nicht durch die Grenze überschrieben: Sie wird erneut aktiv, sobald die Richtlinie aufgehoben wird.
• Ebenen — Wie jede Einstellung gewinnt die spezifischste Ebene, die den Schlüssel festlegt (Benutzer, dann Gruppe, dann alle); Regeln derselben Ebene nehmen den kleineren Wert, sodass 0 jeder positiven Grenze vorauseilt. Der Schlüssel ist kein 0-bedeutet-ungelimitierter Wert.
• Ungültige Werte — Eine negative Zahl oder eine nicht-ganze Zahl (z. B. "5 MB") stellt eine Richtlinienfehler dar, wie jeder andere falsch formatierte Wert, weshalb die gesamte Datei abgelehnt wird und der Lockdown-Fallback aktiviert wird; der Fallback verbietet außerdem das Speichern von Skripttexten. Schreiben Sie Bytes, optional mit TOML-Zifferntrennern (5_242_880).

[rule.ai-memory]¶

Die [rule.ai-memory]-Tabelle legt fest, wie das korTTY-Memory verwendet werden darf. Jeder Schlüssel ist optional; ein Schlüssel, den die Richtlinie nicht festlegt, behält die eigene Wahl des Users bei. Ein Wert außerhalb der aufgeführten Werte verwirft die gesamte Datei. Ein unbekannter Schlüssel ist eine Warnung im Protokoll und wird ignoriert, wie in jeder anderen Tabelle. Wie bei den anderen Schlüsseln gilt: Die spezifischste Ebene, die einen Schlüssel festlegt, hat Vorrang (User, dann Gruppe, dann alle); innerhalb einer Ebene gilt der strengste Wert: disabled vor read-only vor editable, propose unter off, never vor always vor auto, die kleinere Token-Grenze, und false vor true für die Schalter.

Organisations-Speicher¶

[[organization-memory]]-Blöcke enthalten Regeln für die KI, die Benutzer nicht ändern können. Jeder Block hat einen title und einen content-Text. korTTY sendet die Blöcke vollständig, vor dem eigenen Speicher des Benutzers, mit jeder KI-Anfrage jedes Benutzers und kürzt sie nicht auf das Token-Budget. Ein Block, dessen Titel oder Inhalt länger als 8000 Zeichen ist oder den der Geheimnis-Schutz ablehnt, wird mit einer Warnung verworfen, die das Feld und die Zeile benennt, niemals aber den Wert. Die Datei enthält höchstens 20 Blöcke und insgesamt 16000 Zeichen; ein Block, der eines dieser Limits überschreiten würde, wird mit einer Warnung verworfen, und die Blöcke danach werden weiterhin geprüft.

Organisations-Memory wird nur gesendet, solange die Richtlinie die KI-Funktionen zulässt und ai-memory nicht verweigert. Der eigene Memory verwenden-Schalter des Benutzers und der user-memory-Schlüssel verhindern dies nicht.

[rule.ai-runtime]¶

[rule.updates]¶

[rule.backup]¶

Setzt und sperrt das Automatisches Backup Einstellungen → Sicherung. Jeder Schlüssel erzwingt die entsprechende Einstellung; der Benutzer sieht sie mit dem Hinweis „von Ihrer Organisation verwaltet“. Die Sicherung selbst behält den Verschlüsselungsmodus und die Anmeldeinformationen oder GPG-Schlüssel des Benutzers bei und wird niemals unverschlüsselt geschrieben.

[[rule]]
  [rule.backup]
  auto-interval = "daily"
  auto-directory = "~/Backups/korTTY"

[rule.terminal]¶

[[rule]]
  [rule.features]
  multi-exec = "deny"

  [rule.security]
  allow-osc52-clipboard-write = false
  allow-osc5522-clipboard-read = false

  [rule.terminal]
  paste-warning = "always"
  session-restore = "ask"
  session-restore-output = false

[rule.sftp]¶

[[rule]]
  [rule.features]
  file-transfer = "allow"
  sftp-sudo-edit = "deny"

  [rule.sftp]
  max-parallel-transfers = 2
  conflict-default = "ask"

Eine fehlerhafte Richtliniendatei fällt auf den Lockdown zurück, der file-transfer und sftp-sudo-edit wie jede andere Funktion verweigert.

Archive, die der SFTP-Manager auf dem Server erstellt, haben nie ein Passwort, unabhängig von der Richtlinie: zip und 7z nehmen ein Passwort nur auf ihrer Befehlszeile oder über ein Terminal entgegen, und auf der Befehlszeile kann jeder andere Benutzer des Servers es in der Prozessliste lesen. Passwortgeschützte Archive auf dem Server lehnt Hier entpacken... ebenfalls ab. Archive, die auf dem eigenen Computer des Benutzers erstellt werden, können weiterhin ein Passwort haben, daher ist kein Richtlinienschlüssel nötig, um Serverpasswörter aus Prozesslisten herauszuhalten.

[rule.isolation]¶

[[rule]]
  [rule.features]
  incognito-sessions = "deny"

  [rule.isolation]
  minimum = "sandbox"

[rule.job-scheduler]¶

Die Prüfung läuft unmittelbar vor jedem Versand, auch bei der Schaltfläche Test senden. Ein Webhook an einen Host außerhalb der Liste wird nicht gesendet, und das Job-Journal vermerkt notification blocked by policy mit dem Job, dem Namen des Ziels und dem Host, niemals der URL. Solange job-webhooks verweigert ist, weist der Abschnitt Benachrichtigungen eines Jobs mit angekreuzten Webhook-Zielen darauf hin, dass diese nichts erhalten.

[[rule]]
  [rule.features]
  job-webhooks = "allow"

  [rule.job-scheduler]
  webhook-host-allowlist = ["hooks.slack.com", "logic.azure.com", "api.powerplatform.com"]

Eine fehlerhafte Richtliniendatei führt zum Lockdown, der job-webhooks wie jede andere Funktion verweigert.

[rule.logging]¶

Die unten angegebenen terminal-*-Tastenkombinationen gelten für Protokolldaten des Terminalausganges. Ungeführte Werte bleiben der Verbindungseinstellung unterliegen. Sie werden pro Feld gemäß den bestehenden Regeln aufgelöst; bei gleicher Ebene gewinnt false bei Benutzernamen, während die Verzeichnisauswahlen in der Reihenfolge none, relative, full erfolgen. Der Logger wendet sie beim Start an und schaltet die Steuerung des Verbindungseingabefensters ab. Unbekannte Arbeitsverzeichnisse bleiben leer. Diese Einstellungen aktivieren das Protokollieren nicht allein.

korTTY rotiert sein Protokoll täglich (kortty.YYYY-MM-DD.log); Diese Tabelle steuert, wohin die Dateien gehen, wie lange sie leben, wie sie formatiert sind und wie die Rotation begrenzt wird. Verzeichnis und Aufbewahrung werden in die entsprechenden (dann gesperrten) Benutzereinstellungen gezwungen; Format, Komprimierung und die Rotationsbeschränkungen haben keine Benutzereinstellung und wirken direkt. Die Konfiguration wird vor der allerersten Protokollzeile eines Starts angewendet, sodass auch die Startprotokollierung dem Schema des Administrators folgt.

[[rule]]
  [rule.logging]
  directory = "/var/log/kortty"
  retention-days = 30
  compress = true
  format = "json"
  rotation-max-files = 14
  rotation-total-size-mb = 512

[rule.session-journal]¶

Mandate für das Sitzungsjournal. Erzwungene Werte sperren die entsprechenden Steuerelemente in den Journaloptionen, im Einstellungsdialog und im Verbindungseditor mit dem Hinweis „Von Ihrer Organisation verwaltet“.

[[rule]]
  [rule.features]
  session-journal = "allow"
  [rule.session-journal]
  enforced = true
  log-format = "json"
  storage-path = "/srv/audit/kortty-journals"
  allow-delete = false
  name-template = "{connection} {date} {time} ({user})"

[[rule.session-journal.replace]]¶

Automatisches Suchen und Ersetzen in jedem Journal – die Möglichkeit, eine ganze Kategorie von Geheimnissen aus dem Transkript herauszuhalten, anstatt sich darauf zu verlassen, dass der Benutzer es bemerkt. Jeder Eintrag stellt eine Regel dar, und eine Regel kann einen regulären Ausdruck verwenden.

korTTY wendet dieselben Regeln auf eine Terminalauswahl und auf eine daran angehängte Datei an, bevor sie an ein KI-Profil gesendet werden, das weder ein integriertes Modell noch ein vertrauenswürdiger lokaler Endpunkt ist; siehe Maskierung von Geheimnissen vor dem Senden.

[[rule]]
  [rule.session-journal]
  enforced = true

    [[rule.session-journal.replace]]
    pattern = "AKIA[0-9A-Z]{16}"
    replacement = "***AWS-ACCESS-KEY***"
    regex = true
    label = "AWS access keys"

    [[rule.session-journal.replace]]
    pattern = "(?i)bearer\\s+[A-Za-z0-9._-]{20,}"
    replacement = "Bearer ***"
    regex = true
    label = "Bearer tokens"

    [[rule.session-journal.replace]]
    pattern = "vpn.internal.acme.corp"
    replacement = "<internal-host>"
    ignore-case = true

Die Regeln werden im Erfassungsthread ausgeführt, bevor eine Zeile geschrieben wird, sodass ein übereinstimmender Text überhaupt nicht in die Protokolldatei gelangt, und sie werden auch auf KI-Zusammenfassungen und Benutzernotizen angewendet. Im Gegensatz zu den anderen Schlüsseln werden Ersetzungsregeln über alle übereinstimmenden Regeln und alle Ebenen hinweg zusammengeführt und nicht, dass die höchste Ebene gewinnt: Mehr Schwärzung ist das restriktivere Ergebnis, sodass eine benutzer- oder gruppenspezifische Regel nur Muster hinzufügen und niemals die organisationsweiten ausschalten kann. Doppelte Einträge werden ausgeblendet.

Von Admin bereitgestellte Objekte¶

Diese Tabellen der obersten Ebene definieren Objekte, die für jeden Benutzer schreibgeschützt und mit der Kennzeichnung „Von Ihrer Organisation bereitgestellt“ gekennzeichnet sind. Sie werden bei jedem Start aus der Richtlinie neu erstellt und nie in die Konfigurationsdateien des Benutzers geschrieben. Wenn Sie sie aus der Richtlinie entfernen, werden sie auch aus korTTY entfernt.

Interner Zwischenablagemodus¶

Mit clipboard-mode = "internal" trennt sich korTTY vollständig von der Zwischenablage des Betriebssystems und verwendet stattdessen seine eigene Zwischenablage im Arbeitsspeicher: In einer anderen Anwendung kopierter Text kann nirgendwo in korTTY eingefügt werden, und in korTTY kopierter Text gelangt nie in die Zwischenablage des Betriebssystems – während das Kopieren, Ausschneiden und Einfügen innerhalb von korTTY weiterhin überall funktioniert, da Terminals, SFTP-Ansichten, der Snippet-Editor und alle Dialoge denselben internen Puffer verwenden. Da es sich hierbei um reine Anwendungslogik handelt und keine Betriebssystem-Zwischenablage-Isolations-API beteiligt ist, verhält es sich unter macOS, Windows und Linux identisch, einschließlich der X11-Primärauswahl (Einfügen mit mittlerem Klick): Das Einfügen von Inhalten mit mittlerem Klick aus anderen Anwendungen ist blockiert, das Einfügen mit mittlerem Klick von korTTY-internen Kopien funktioniert weiterhin.

Der Modus umfasst das Terminal (Kurzbefehle, Kontextmenü, Mitteltaste, Text, der aus einer anderen Anwendung darauf abgelegt wird und abgelehnt wird, sowie Text, den ein Programm im Terminal mit OSC 52 oder OSC 5522 kopiert, sofern Einstellungen → Terminal dies zulässt, der nur in die interne Zwischenablage gelangt; ein Programm, das mit OSC 5522 liest, erhält die interne Zwischenablage), den Code-Editor, alle Kopier-Buttons, die ${clipboard}-Snippet-Variable und die Kopieren/Ausschneiden/Einfügen-Kurzbefehle von einfachen Eingabefeldern. Das Kopieren von Bildern (KI-generierte Bilder, Diagramm-Exporte) ist im internen Modus nicht verfügbar, da ein Bild nur über die System-Zwischenablage geteilt werden kann.

Verschlüsselte API-Schlüssel¶

Der API-Schlüssel eines KI-Profils erscheint niemals im Klartext in der Richtlinie. Der Administrator verschlüsselt es einmal von einem Terminal aus – der Befehl gibt einen kortty-enc:v1:-Wert für den api-key-encrypted-Schlüssel aus:

korTTY --encrypt-policy-value

Benutzern wird im Profil nur „Von Ihrer Organisation bereitgestellter API-Schlüssel“ angezeigt. Der Schlüssel wird im Speicher entschlüsselt, sobald eine Anfrage gestellt wird.

Fehlerbehebung¶