Maskierung vor Modellaufrufen | kanman Dokumentation

kanman liest Tickets, Wiki-Seiten, CI-Logs und Chat-Nachrichten, um seine Arbeit zu tun, und darin steht oft mehr, als die Arbeit braucht: die E-Mail-Adresse eines Kunden, die Telefonnummer eines Anrufers, ein Passwort, das jemand in ein Ticket kopiert hat. Die Maskierung sorgt dafür, dass nichts davon ein Sprachmodell erreicht. Vor jedem Modellaufruf ersetzt kanman solche Werte durch Platzhalter wie [EMAIL_1] oder [PHONE_2]. Das Modell arbeitet mit den Platzhaltern; die echten Werte bleiben bei kanman.

Die Maskierung ist immer aktiv, für jeden Workspace, in kanman Cloud und auf deinen eigenen Runnern. Du musst nichts einschalten.

Was immer maskiert wird

Was	Beispiele
Geheimnisse und Tokens	API-Schlüssel, Zugriffstokens, private Schlüssel, Passwörter in URLs
E-Mail-Adressen	`[email protected]`
Telefonnummern und Verbindungsdaten	`+49 30 1234567`, `030/12345678`, Nummern in Verbindungsdatensätzen (CDR)
IBANs	geprüft mit der IBAN-Prüfsumme
Kartennummern	geprüft mit der Prüfsumme für Kartennummern
IP-Adressen	IPv4 und IPv6
Postanschriften	Straße und Hausnummer, Postleitzahl und Ort
Kunden- und Vertragsnummern	beschriftete Nummern wie „Kundennummer: K-482913“
Namen von Personen außerhalb deines Workspaces	zum Beispiel die meldende Person eines Tickets, die kein Mitglied ist; die Namen deiner Mitglieder bleiben

kanman achtet darauf, nur zu maskieren, was maskiert gehört: Versionsnummern, Commit-Hashes, Datumsangaben, Uhrzeiten, Zeilennummern und Zeitstempel bleiben unverändert, damit das Modell Logs und Änderungen weiter versteht.

Eigene Muster

Jede Firma hat Nummern, die nur sie kennt, etwa Vertrags-, Vorgangs- oder Ticketnummern. Ergänze diese als Muster:

Öffne Workspace-Einstellungen > Modellzugang (/<workspace>/settings/models).
Such die Karte Maskierung vor Modellaufrufen.
Wähle unter Eigene Muster die Option Muster hinzufügen, gib eine Bezeichnung ein (zum Beispiel „Vertragsnummer“) und einen regulären Ausdruck (zum Beispiel VT-\d{4}-\d{5}).

Ein Muster wird geprüft, sobald du das Feld verlässt. kanman sagt dir, wenn es kein gültiger regulärer Ausdruck ist oder die Prüfung verlangsamen könnte, und speichert es erst, wenn es in Ordnung ist. Du kannst bis zu 20 Muster anlegen. Ändern können sie nur Owner und Admins; jede Änderung steht im Audit-Log.

Werte, die auf deine Muster passen, bekommen Platzhalter mit dem Namen der Bezeichnung, zum Beispiel [VERTRAGSNUMMER_1].

Wo die echten Werte zurückkommen

Das Modell sieht die echten Werte nie. Wo kanman mit einem Wert handeln muss, etwa um einer E-Mail-Adresse zu antworten oder eine Kundennummer in einem Ticketkommentar zu nennen, setzt kanman den Wert selbst wieder ein, in dem Moment, in dem es handelt. Geheimnisse, IBANs, Kartennummern und Postanschriften werden nie wieder eingesetzt.

Was nicht maskiert wird

Der Code in deinen Repositories wird nicht maskiert. Die Helfer von kanman lesen und ändern deinen Code so, wie er ist, damit nie ein Platzhalter in deinem Code landet. Damit keine Geheimnisse in deine Repositories gelangen, prüft kanman jede Änderung auf Zugangsdaten, bevor es sie pusht.

Seiten mit Passwörtern

Manche Wiki-Seiten sind dazu da, Zugangsdaten weiterzugeben, zum Beispiel eine Seite mit Testkonten und ihren Passwörtern. Nur die Passwörter zu maskieren, würde den Rest der Seite trotzdem einem Modell zeigen. kanman lässt solche Seiten deshalb ganz weg: Es teilt dem Modell mit, dass die Seite ausgelassen wurde und warum, ohne etwas von ihrem Inhalt.

Wenn kanman zum ersten Mal auf eine solche Seite stößt, bekommen die Owner und Admins des Workspaces eine Benachrichtigung mit der Seite und dem System, in dem sie liegt, damit jemand die Zugangsdaten an einen sicheren Ort verschieben kann. kanman benachrichtigt einmal pro Seite.

Wie viel maskiert wird

Jeder Modellaufruf hält fest, wie viele Werte welcher Art maskiert wurden, damit du zeigen kannst, was die Maskierung für deinen Workspace getan hat.