Installation & Dokumentation

Inhaltsverzeichnis

Installation

1. Erste Schritte
2. Die Privacy Owl (Ihr Helfer auf KI-Seiten)
3. Datei-Upload-Scan
4. Die Auswahl-Blase
5. Kontextmenü (Rechtsklick)
6. Chat-Seite
7. Einstellungsseite
8. Prüfprotokoll-Seite
9. Seite zur Datei-Anonymisierung
10. Tastenkürzel
11. Sprachen
12. FAQ & Fehlerbehebung

1. Erste Schritte

Nach der Installation sehen Sie ein kleines SOWA-Symbol in Ihrer Chrome-Symbolleiste (oben rechts). Klicken Sie darauf, um das Popup-Menü mit drei Schaltflächen zu öffnen:

Schaltfläche	Funktion
Chat	Öffnet die vollständige Chat-Seite, auf der Sie Text eingeben, personenbezogene Daten erkennen und Nachrichten an KI senden können.
Einstellungen	Öffnet die Einstellungsseite, auf der Sie konfigurieren, wie SOWA funktioniert.
Prüfprotokoll	Öffnet die Prüfprotokoll-Seite, auf der Sie ein Protokoll aller SOWA-Aktionen einsehen können.

Diese drei Schaltflächen sind Ihr Einstieg in alle Funktionen.

2. Die Privacy Owl

Wenn Sie eine unterstützte KI-Chat-Seite besuchen (ChatGPT, Claude, Gemini, Copilot, Grok), erscheint eine kleine Eule in der Ecke Ihres Bildschirms. Das ist Ihr Datenschutzwächter.

So funktioniert die Eule

• Normale Augen – alles sieht sicher aus, keine personenbezogenen Daten erkannt.
• Rote Augen – die Eule hat personenbezogene Daten in Ihrer Eingabe gefunden.
• Die Eule überwacht Ihre Eingabe fortlaufend (alle halbe Sekunde) auf personenbezogene Daten.
• Sie können die Eule in jede Ecke des Bildschirms ziehen.

Navigationsmenü der Eule

Klicken Sie auf die Eule, um ihr Menü zu öffnen. Das Menü enthält einen Sperr-Schalter (zwischen Originaltext und Platzhaltertext wechseln), eine Datei-Reanonymisierungs-Auswahl (DOCX ablegen und SOWA stellt Platzhalter wieder auf Originalwerte zurück) sowie Direktlinks zu Chat, Prüfprotokoll und Einstellungen.

Was beim Tippen passiert

1. Sie beginnen, in das KI-Chatfeld zu tippen.
2. Die Eule scannt Ihren Text auf personenbezogene Daten.
3. Werden personenbezogene Daten gefunden, werden die Augen der Eule rot und die erkannten Stellen in Ihrem Textfeld hervorgehoben.
4. Bevor Ihre Nachricht gesendet wird, ersetzt SOWA die personenbezogenen Daten durch sichere Platzhalter (z. B. wird aus Anna Nowak das Kürzel [NAME_1]).
5. Nachdem die KI geantwortet hat, setzt SOWA die echten Daten automatisch in die Antwort zurück.

Schutz beim automatischen Senden

Wenn Sie die Eingabetaste drücken und personenbezogene Daten erkannt wurden, erscheint eine kleine Einblendung mit drei Optionen:

Schaltfläche	Funktion
Zuerst anonymisieren, dann senden	Ersetzt alle personenbezogenen Daten durch Platzhalter und sendet danach automatisch. Sicherste Option.
Trotzdem senden	Sendet unverändert, ohne Anonymisierung.
Abbrechen	Bricht den Sendevorgang ab, sodass Sie bearbeiten können.

3. Datei-Upload-Scan

Wenn Sie eine Datei in einen KI-Chat hochladen (z. B. ein PDF in ChatGPT ziehen), kann SOWA die Datei vor dem Senden auf personenbezogene Daten scannen.

So funktioniert es

1. Sie ziehen eine Datei in den Chat oder klicken auf die Anhang-Schaltfläche.
2. SOWA fängt den Upload ab und scannt die Datei auf personenbezogene Daten.
3. Werden personenbezogene Daten gefunden, öffnet sich ein Dialogfenster mit Dateiname, Größe und Format, der Anzahl der gefundenen Einträge (nach Typ gruppiert) sowie einer Vorschau von Original- und anonymisiertem Text nebeneinander.

Entscheidungsschaltflächen

Schaltfläche	Funktion
Zuerst anonymisieren	Ersetzt alle personenbezogenen Daten in der Datei und lädt dann die anonymisierte Version hoch. Bei PDFs werden Stellen direkt im PDF geschwärzt (weißes Feld + Platzhaltertext).
Trotzdem senden	Lädt die Originaldatei unverändert hoch.
Abbrechen	Bricht den Upload ab.

Unterstützte Dateitypen

• Textdateien: .txt, .md, .csv, .json, .log, .xml, .html, .py, .js, .ts, .yaml, .sql, .sh und viele weitere.
• Dokumente: PDF (Text extrahiert und direkt geschwärzt), DOCX (Text extrahiert), XLSX (Text extrahiert).
• Maximale Dateigröße: 5 MB.

4. Die Auswahl-Blase

Wenn Sie auf einer unterstützten KI-Seite Text markieren, erscheint eine kleine schwebende Schaltflächenleiste neben Ihrer Auswahl.

Schaltfläche	Funktion
SOWA	Anonymisiert den markierten Text direkt an Ort und Stelle.
WL	Fügt den markierten Text zur Whitelist hinzu (SOWA ignoriert ihn künftig).
BL	Fügt den markierten Text zur Blacklist hinzu (SOWA behandelt ihn immer als personenbezogene Daten).

5. Kontextmenü (Rechtsklick)

Klicken Sie mit der rechten Maustaste auf eine beliebige Seite und Sie sehen SOWA-Optionen im Kontextmenü:

• SOWA: Auswahl senden – markierten Text in das SOWA-Popup kopieren.
• SOWA: Anonymisieren (inline) – markierten Text direkt auf der Seite anonymisieren.
• SOWA: Auswahl zur Whitelist – zur Whitelist hinzufügen.
• SOWA: Auswahl zur Blacklist – zur Blacklist hinzufügen.

6. Chat-Seite

Öffnen Sie die Chat-Seite, indem Sie im Popup- oder Eulen-Menü auf Chat klicken. Hier tippen Sie, erkennen personenbezogene Daten und senden Nachrichten an KI in einer kontrollierten Arbeitsumgebung.

Hauptarbeitsbereich

• Textfeld – geben Sie Ihre Nachricht ein oder fügen Sie sie ein.
• Modellprofil-Auswahl – wählen Sie, welches KI-Modell oder welche API verwendet werden soll.
• Vorschau-Schaltfläche – zeigt, wie Ihre Nachricht nach der Anonymisierung aussieht.
• Erkannte personenbezogene Daten – farbcodierte Chips zeigen jeden gefundenen Typ. Erweitern Sie Details für Positionen und Konfidenzwerte.
• Lokales LLM – wenn der Power-Modus aktiviert ist, führen Sie das lokale KI-Modell für eine stärkere Erkennung aus.
• Senden (externes LLM) – sendet Ihre anonymisierte Nachricht an die gewählte API und zeigt die Antwort mit wiederhergestellten Platzhaltern an.

Schnellzugriff-Seitenleiste

Auf breiten Bildschirmen bietet eine rechte Seitenleiste Schnellzugriffe zur Datei-Anonymisierung, zur erweiterten Verlaufsansicht, zur Diagnose und einen Debug-Schalter.

7. Einstellungen

Drei Bereiche, umschaltbar über die linke Seitenleiste.

Erkennung

Steuert, wie SOWA personenbezogene Daten findet.

• Power-Modus-Schalter – aktiviert eine zusätzliche lokale KI (WebLLM) für bessere Erkennung personenbezogener Daten. Benötigt 2–4 GB RAM, erkennt aber mehr Grenzfälle.
• Pipeline-Auswahl – Erkennungsreihenfolge wählen: nur Regex (schnellste), Regex-NER (empfohlen) oder nur NER.
• Regex / Whitelist / Blacklist-Schalter – jede Erkennungsebene aktivieren oder deaktivieren.
• NER-Bereich – Named-Entity-Erkennung aktivieren (65-MB-Lokalmodell, opt-in). Modell auswählen, Konfidenzschwelle und Priorität festlegen.
• Lokales LLM – browserbasierende LLM-Verarbeitung aktivieren (erfordert WebGPU, lädt ca. 200 MB herunter).
• Datenschutz-Voreinstellungen – vorgefertigte Regelwerke: Standard, Leicht, Bank, Med (medizinisch), Versicherung.
• Eigene Regeln & Listen – eigene Regex-Regeln hinzufügen. Format: ART|REGEX|FLAGS|PRIORITÄT. Whitelist- und Blacklist-Felder akzeptieren einen Ausdruck pro Zeile.

KI-Modelle

Welche KI-Dienste SOWA verwendet.

• Basis-URL, Modell, API-Schlüssel, Temperatur, System-Prompt – Standard-OpenAI-kompatible API-Einstellungen. API-Schlüssel werden lokal gespeichert und niemals an SOWA übertragen.
• Modellprofile – JSON-Array von Konfigurationen für schnelles Umschalten.

Seiten & Datenschutz

Wo und wie SOWA auf Webseiten aktiv ist.

• Seitenintegrations-Schalter – Hauptschalter für die Anonymisierung auf externen KI-Seiten.
• Privacy Owl Anzeigemodus – nur die Inline-Schaltfläche, nur die Eule oder beides anzeigen.
• Hervorhebungsfarben – Hervorhebung personenbezogener Daten (Standard: Rot) und Platzhalter-Hervorhebung in gesendeten Nachrichten (Standard: Lila).
• Eulen-Akzentthema – Blaugrün, Lila, Blau, Bernstein oder Benutzerdefiniert.
• Wörterbuchbereich – pro Domain (separates Wörterbuch je Seite) oder global (gemeinsam für alle Seiten).
• Seitenregeln – URL-Muster, auf denen SOWA aktiv ist (Platzhalter unterstützt, z. B. *chatgpt.com*).
• Datei-Upload-Scan-Schalter, Automatisches Speichern-Schalter.

8. Prüfprotokoll-Seite

Eine vollständige Aufzeichnung aller SOWA-Aktionen – jede Erkennung, jede Anonymisierung, jede Sendeentscheidung, jede Konfigurationsänderung. Wird lokal auf Ihrem Gerät gespeichert.

Statistikkarten

Gesamtereignisse, Anonymisierungen, gesendete Nachrichten, Nutzerentscheidungen, gescannte Dateien, genutzter Speicherplatz.

Integritätsprüfung

SOWA verwendet eine SHA-256-Hash-Kette, um sicherzustellen, dass das Prüfprotokoll nicht manipuliert wurde. Der Hash jedes Ereignisses enthält den Hash des vorherigen Ereignisses. Klicken Sie auf Integrität prüfen, um die Kette vollständig zu validieren.

Exportoptionen

• JSON exportieren – vollständiges Prüfprotokoll als JSON-Datei.
• CSV exportieren – Prüfprotokoll als Tabelle.
• Prüfprotokoll leeren – alle Ereignisse löschen (nicht rückgängig zu machen).

Filter

Nach Ereignistyp, Datumsbereich oder URL filtern. Ereignistypen: Erkannte personenbezogene Daten, Anonymisiert, Gesendet, Antwort, Reanonymisiert, Nutzerentscheidung, Konfiguration geändert, Fehler.

Wörterbuch-Tab

Zeigt alle von SOWA erstellten Zuordnungen von personenbezogenen Daten ↔ Platzhalter. Suchen, einzelne Einträge löschen, exportieren oder das gesamte Wörterbuch leeren.

9. Seite zur Datei-Anonymisierung

Eine dedizierte Seite für die Stapelverarbeitung von Textdateien. Eine oder mehrere .txt-Dateien ablegen, eine Anzahl personenbezogener Daten pro Datei erhalten und wählen, ob anonymisiert, das Original gesendet oder heruntergeladen werden soll.

10. Tastenkürzel

Kürzel	Wo	Funktion
Alt + Shift + A	Jede unterstützte KI-Seite	Markierten Text oder aktuelles Textfeld anonymisieren.
Enter	Upload-Dialogfenster	„Zuerst anonymisieren" bestätigen.
Escape	Upload-Dialogfenster	Upload abbrechen.

11. Sprachen

Die Benutzeroberfläche von SOWA unterstützt vier Sprachen:

• Deutsch (DE)
• English (EN)
• Français (FR)
• Polski (PL)

Wechseln Sie die Sprache über die Schaltflächen DE / EN / FR / PL in der Kopfzeile jeder Erweiterungsseite. Die gesamte Benutzeroberfläche aktualisiert sich sofort.

Die Erkennung selbst funktioniert für Text in jeder Sprache. Das mitgelieferte NER-Modell ist mehrsprachig (DistilBERT, PL / EN / DE / FR).

12. FAQ & Fehlerbehebung

Die Eule erscheint nicht auf meiner KI-Chat-Seite

Öffnen Sie Einstellungen → Seiten & Datenschutz und stellen Sie sicher, dass „Anonymisierung auf externen Seiten aktivieren" eingeschaltet ist. Prüfen Sie dann, ob Ihre Seite in der Liste der Seitenregeln steht – dort können Sie eigene URL-Muster hinzufügen.

SOWA erkennt bestimmte Namen oder Organisationen nicht

Aktivieren Sie die NER-Erkennung unter Einstellungen → Erkennung → Lokale KI. NER verwendet ein lokales KI-Modell, das bei Namen, Organisationen und Orten deutlich besser ist als Regex.

Das Wörterbuch enthält alte Einträge

Klicken Sie auf Wörterbuch leeren im Wörterbuch-Tab der Prüfprotokoll-Seite. Dadurch werden Einträge sowohl aus dem lokalen Speicher der Webseite als auch aus dem Speicher der Erweiterung gelöscht.

Ich möchte eine noch genauere Erkennung

Aktivieren Sie den Power-Modus in den Einstellungen. Dadurch wird ein lokales LLM (Phi-3 oder ähnlich) zur Pipeline hinzugefügt. Langsamer, erkennt aber Grenzfälle. Erfordert WebGPU und 2–4 GB RAM.

Wie erkenne ich, ob mein Prüfprotokoll manipuliert wurde?

Öffnen Sie die Prüfprotokoll-Seite und klicken Sie auf Integrität prüfen. SOWA überprüft die SHA-256-Hash-Kette. Ein grünes Banner bedeutet, dass der Hash jedes Ereignisses übereinstimmt.

Kann ich SOWA offline nutzen?

Ja. Sobald das NER-Modell (~65 MB) und/oder das WebLLM-Modell (~200 MB) heruntergeladen wurden, findet die gesamte Erkennung lokal statt. Daten verlassen Ihr Gerät nur, wenn Sie explizit auf „Senden" an eine externe KI-API klicken.

Welche Arten personenbezogener Daten erkennt SOWA?

Namen, E-Mail-Adressen, Telefonnummern (einschließlich deutscher Mobilnummern), Anschriften, PESEL, NIP, IBAN, BIC/SWIFT, Kreditkartennummern, Führerscheinnummern, Reisepassnummern, Geburtsdaten, IP-Adressen, URLs mit persönlichen Informationen, API-Schlüssel, Passwörter, Tokens, Organisationsnamen und mehr.