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.
- 100 % auf dem Gerät
- API nur 127.0.0.1
- Kein Upload, keine Cloud
- § 203 StGB: Dokument verlässt die Maschine nie
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
- Datenmaske Secure ist installiert und läuft (die API und der Hotfolder arbeiten nur bei laufender Anwendung; minimiert in den Systembereich reicht).
- Eine aktive Lizenz ist hinterlegt — ohne Benutzerkontext verarbeitet der Hotfolder bewusst nichts.
- Für Skripte gegen die REST-API: Windows mit curl.exe (ab Windows 10 enthalten) oder PowerShell 5.1+.
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.
- Einstellungen → System → „Lokale REST-API“.
- Port eintragen (Standard 47190) und einen API-Schlüssel Ihrer Wahl vergeben. Ohne Schlüssel startet der Server grundsätzlich nicht (fail-closed).
- „Start“ klicken. Der Status wechselt auf „Aktiv“, und die API ist erreichbar.
- 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
- In RA-MICRO den Akten-Export (PDF) in einen Netzwerkordner lenken, z. B. \\kanzlei-server\datenmaske\eingang.
- In Datenmaske: Einstellungen → Ordner → diesen Ordner als Hotfolder anlegen.
- Modus „Prüfung“ (Standard): jede neue Datei landet in der Bibliothek zur Durchsicht; das Original wandert nach der Verarbeitung in den Unterordner verarbeitet.
- 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.
- Deduplizierung nach SHA-256: dieselbe Datei (auch umbenannt) wird pro Benutzer kein zweites Mal verarbeitet.
B · Nächtliche Stapelverarbeitung per Skript
- Auf dem Arbeitsplatz, auf dem Datenmaske läuft, einen geplanten Task einrichten (PowerShell).
- Das Skript unten liest einen Ordner, erkennt, schwärzt und prüft outputUsable — verworfene Ausgaben bleiben sichtbar im Ordner abgelehnt.
- 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
- MSI in einen Netzwerkshare legen; per GPO (Computerkonfiguration → Softwareinstallation) oder Intune als erzwungene Installation zuweisen — silent: msiexec /i Datenmaske-Secure-setup.msi /qn.
- 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.
- 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).
- 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
- Kein Netzwerkzugriff: Die API bindet nur 127.0.0.1. Ein zentrales Ansteuern von anderen Rechnern ist bewusst nicht vorgesehen — pro Arbeitsplatz läuft die Verarbeitung lokal.
- Die API läuft nur, solange die Anwendung läuft. Es gibt (noch) keinen Dienstmodus ohne App.
- In der API gibt es kein „bewusst belassen“: Werte, die in der Oberfläche abgelehnt wurden, blockieren über die API den Export (strenges fail-closed).
- Der Modus „Auto“ des Hotfolders exportiert nur strukturierte, prüfgesicherte Daten (E-Mail, IBAN, Kreditkarte, Steuer-ID, Sozialversicherungs-, Pass- und Versichertennummer). Namen, Adressen und Scans gehen grundsätzlich in die menschliche Prüfung.
- Ein CLI (datenmaske --in … --out …) existiert im Projekt, ist aber nicht Teil des Installers. Der unterstützte Weg zur Automatisierung installierter Arbeitsplätze ist die REST-API.
- Eine Anfrage = ein PDF (Base64). Für große Bestände sequenziell verarbeiten; Parallelität bringt nichts, der Server arbeitet die Anforderungen der Reihe nach ab.
- Hotfolder auf Netzlaufwerken (UNC) werden unterstützt; für verlässliche Erkennung von „Datei fertig“ empfehlen wir bei instabilen Verbindungen einen lokalen Synchronisationsordner.
- outputUsable belegt, dass die ausgewählten Fundstellen entfernt wurden und die Restprüfung leer ist — nicht, dass die Erkennung alles gefunden hat. Ohne stichprobenartige Prüfung bleibt ein Restrisiko.
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