Datenmaske

Für Systemhäuser und Kanzlei-IT

Datenmaske Secure automatisieren.

Vier Schnittstellen, ein Prinzip: Alles läuft auf demselben Rechner wie die Anwendung. Der API-Server bindet ausschließlich 127.0.0.1 — kein Dokumentbyte durchquert je eine Netzwerkkarte.

Die Pipeline hinter der API ist identisch mit der der Oberfläche: dieselbe Erkennung, dieselbe fail-closed-Verifikation, dieselbe Restprüfung nach dem Export.

Vier Wege, Datenmaske einzubinden

REST-API (lokal)

Erkennen und Schwärzen per HTTP auf 127.0.0.1 — für Scripts und Integrationen auf demselben Rechner.

Hotfolder

Ordner überwachen: Neue Dateien wandern automatisch in die Prüfung — oder, im Modus „Auto“, direkt fail-closed in den Export.

Explorer-Kontextmenü

Rechtsklick auf ein PDF → „Schwärzen mit Datenmaske“ — Öffnen mit einem Klick aus jedem Ordner.

MSI + GPO

Verteilung per Gruppenrichtlinie oder Intune; zentrale Vorgaben für Updates, Modell-Download und Hotfolder.

Voraussetzungen

REST-API aktivieren

Die API ist standardmäßig aus. Sie wird in den Einstellungen pro Arbeitsplatz aktiviert; der Schlüssel wird selbst vergeben (er wird nicht generiert) und bleibt lokal in den Einstellungen der Anwendung.

  1. Einstellungen → System → „Lokale REST-API“.
  2. Port eintragen (Standard 47190) und einen API-Schlüssel Ihrer Wahl vergeben. Ohne Schlüssel startet der Server grundsätzlich nicht (fail-closed).
  3. „Start“ klicken. Der Status wechselt auf „Aktiv“, und die API ist erreichbar.
  4. Ab dem nächsten Start der Anwendung läuft die API automatisch mit, solange Schlüssel und Schalter gesetzt sind.

Erste Anfrage (Health)

curl.exe

curl.exe http://127.0.0.1:47190/api/v1/health

PowerShell

Invoke-RestMethod http://127.0.0.1:47190/api/v1/health

→ {"status":"ok"} (no key required — liveness only, no document data)

Erkennen: POST /api/v1/detect

Der Request enthält das PDF Base64-kodiert. Die Antwort listet jeden Fund mit Seitenzahl, Box-Koordinaten (PDF-Punkte, Ursprung oben links), Typ, Konfidenz und Quelle (regex/KI). Genau diese Boxen werden anschließend zum Schwärzen übergeben.

PowerShell

$key  = "MEIN-SCHLUESSEL"
$pdf  = [Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\Akten\gutachten.pdf"))

$det = Invoke-RestMethod -Method Post -Uri http://127.0.0.1:47190/api/v1/detect  -Headers @{ Authorization = "Bearer $key" } -ContentType "application/json"  -Body (@{ pdfB64 = $pdf } | ConvertTo-Json)

$det.suggestions | Select-Object pageNumber, sensitivityType, confidence, source
suggestions[].pageNumber Seite, 1-basiert
suggestions[].bboxX / bboxY / bboxWidth / bboxHeight Box in PDF-Punkten
suggestions[].sensitivityType z. B. name, iban, birth_date
suggestions[].confidence 0–99
suggestions[].source regex (Regeln/Prüfsummen) oder ner (Sprachmodell)

Schwärzen: POST /api/v1/redact

Die Boxen aus detect werden zu pages zusammengefasst. Zurück kommt das geschwärzte PDF (Base64) und ein report; report.outputUsable ist das Vertrauenssignal: false heißt, die Verifikation hat einen Rest gefunden und die Datei wurde verworfen.

! Ohne menschliche Prüfung: Das Skript schwärzt nur, was die Erkennung findet. outputUsable bestätigt die Entfernung, nicht die Vollständigkeit. Bei Akten mit Namen, Freitext oder Scans: Ergebnisse stichprobenartig prüfen oder den Hotfolder im Modus „Prüfung“ verwenden.

PowerShell

# Boxen aus $det nach Seite gruppieren und schwärzen
$pages = $det.suggestions | Group-Object pageNumber | ForEach-Object {
  @{
    pageNumber = [int]$_.Name
    rects      = $_.Group | ForEach-Object {
      @{ x = $_.bboxX; y = $_.bboxY; width = $_.bboxWidth; height = $_.bboxHeight }
    }
  }
}

$resp = Invoke-RestMethod -Method Post  -Uri     http://127.0.0.1:47190/api/v1/redact  -Headers @{ Authorization = "Bearer $key" } -ContentType "application/json"  -Body    (@{ pdfB64 = $pdf; pages = $pages; style = "black" } | ConvertTo-Json -Depth 6)

if ($resp.report.outputUsable) {
  [IO.File]::WriteAllBytes("C:\Akten\gutachten_geschwaerzt.pdf",
    [Convert]::FromBase64String($resp.pdfB64))
} else {
  # Fail-closed: Ausgabe wurde verworfen — Funde prüfen (remainingPii)
  $resp.report.remainingPii
}
pages[].pageNumber / rects[].x,y,width,height Boxen aus detect, 1-basierte Seiten
style black (Standard), white, blur oder pixelate
anonymize Platzhalter wie [NAME_1] statt Balken
resiscan Reines Bild-PDF (Textebene wird zerstört)
report.outputUsable / remainingPii Verifikation bestanden / Anzahl Restfunde

401 unauthorized · 400 bad body/base64 · 404 not found · 500 {error}

Drei Rezepte

A · RA-MICRO-/E-Akte-Export in einen Hotfolder legen

  1. In RA-MICRO den Akten-Export (PDF) in einen Netzwerkordner lenken, z. B. \\kanzlei-server\datenmaske\eingang.
  2. In Datenmaske: Einstellungen → Ordner → diesen Ordner als Hotfolder anlegen.
  3. Modus „Prüfung“ (Standard): jede neue Datei landet in der Bibliothek zur Durchsicht; das Original wandert nach der Verarbeitung in den Unterordner verarbeitet.
  4. Modus „Auto“ nur für Bestände mit strukturierten Daten: exportiert automatisch fail-closed in redigiert/<name>_redigiert.pdf. Namen und Freitext gehen IMMER in die Prüfung — der Automatismus ist bewusst schmaler als die Erkennung.
  5. Deduplizierung nach SHA-256: dieselbe Datei (auch umbenannt) wird pro Benutzer kein zweites Mal verarbeitet.

B · Nächtliche Stapelverarbeitung per Skript

  1. Auf dem Arbeitsplatz, auf dem Datenmaske läuft, einen geplanten Task einrichten (PowerShell).
  2. Das Skript unten liest einen Ordner, erkennt, schwärzt und prüft outputUsable — verworfene Ausgaben bleiben sichtbar im Ordner abgelehnt.
  3. Wichtig: Das Skript läuft im Kontext des angemeldeten Benutzers; die API hört nur auf 127.0.0.1 desselben Benutzers.

C · Drei Arbeitsplätze per MSI und GPO ausrollen

  1. MSI in einen Netzwerkshare legen; per GPO (Computerkonfiguration → Softwareinstallation) oder Intune als erzwungene Installation zuweisen — silent: msiexec /i Datenmaske-Secure-setup.msi /qn.
  2. Für getrennte Netze den Voll-Installer (Datenmaske-Secure-full.msi) verwenden: Er enthält die KI-Modelle, der erste Start lädt nichts herunter.
  3. ADMX-Vorlagen (datenmaske.admx/.adml) zentral ablegen; Richtlinien unter HKLM\SOFTWARE\Policies\Mokka\Datenmaske werden bei jedem Start gelesen: AutoUpdateMode (disable/notify/auto), BlockModelDownload (1 = Modell-Download sperren, für Air-Gap), HotFolderPath (zentraler Überwachungsordner).
  4. Lizenzschlüssel je Arbeitsplatz hinterlegen (Start der Anwendung oder per Vorlage/Key-Datei); das Explorer-Kontextmenü aktiviert jeder Benutzer einmalig in Einstellungen → System.

B · Nächtliche Stapelverarbeitung per Skript

PowerShell · batch.ps1

$key  = "MEIN-SCHLUESSEL"
$eingang = "C:\Akten\eingang"
$ok      = "C:\Akten\geschwaerzt"
$nein    = "C:\Akten\abgelehnt"
$archiv = Join-Path $eingang "verarbeitet"
New-Item -ItemType Directory -Force $ok, $nein, $archiv | Out-Null

Get-ChildItem $eingang -Filter *.pdf | ForEach-Object {
  $pdf = [Convert]::ToBase64String([IO.File]::ReadAllBytes($_.FullName))
  $det = Invoke-RestMethod -Method Post -Uri http://127.0.0.1:47190/api/v1/detect  -Headers @{ Authorization = "Bearer $key" } -ContentType "application/json" -Body (@{ pdfB64 = $pdf } | ConvertTo-Json)

  $pages = @($det.suggestions | Group-Object pageNumber | ForEach-Object {
    @{ pageNumber = [int]$_.Name; rects = @($_.Group | ForEach-Object {
      @{ x = $_.bboxX; y = $_.bboxY; width = $_.bboxWidth; height = $_.bboxHeight } }) } })

  $resp = Invoke-RestMethod -Method Post -Uri http://127.0.0.1:47190/api/v1/redact  -Headers @{ Authorization = "Bearer $key" } -ContentType "application/json" -Body (@{ pdfB64 = $pdf; pages = $pages } | ConvertTo-Json -Depth 6)

  if ($resp.report.outputUsable) {
    [IO.File]::WriteAllBytes((Join-Path $ok $_.Name),
      [Convert]::FromBase64String($resp.pdfB64))
    Move-Item $_.FullName (Join-Path $archiv $_.Name) -Force
  } else {
    Move-Item $_.FullName $nein -Force   # fail-closed: bleibt sichtbar
  }
}

! Ohne menschliche Prüfung: Das Skript schwärzt nur, was die Erkennung findet. outputUsable bestätigt die Entfernung, nicht die Vollständigkeit. Bei Akten mit Namen, Freitext oder Scans: Ergebnisse stichprobenartig prüfen oder den Hotfolder im Modus „Prüfung“ verwenden.

Was die Schnittstellen nicht tun

Abgrenzung zur Web-API

Diese Seite beschreibt die lokale Desktop-API. Die Web-/Cloud-Ausgabe von Datenmaske (redact_pdf, detect_pii, get_report mit API-Key) ist auf der API-Dokumentation beschrieben — gleiche Ideen, andere Infrastruktur. → /de/api-dokumentation

Weiterführend