Datenmaske

Pour les intégrateurs et l’IT des cabinets

Automatiser Datenmaske Secure.

Quatre interfaces, un principe : tout tourne sur la même machine que l’application. Le serveur API n’écoute que 127.0.0.1 — aucun octet de document ne traverse une carte réseau.

Le pipeline derrière l’API est identique à celui de l’interface : même détection, même vérification fail-closed, même contrôle des restes après export.

Quatre voies d’intégration

API REST (locale)

Détecter et caviarder via HTTP sur 127.0.0.1 — pour des scripts sur la même machine.

Dossier surveillé

Un dossier sous surveillance : chaque nouveau fichier part en vérification — ou, en mode « Auto », directement vers un export fail-closed.

Menu contextuel de l’Explorateur

Clic droit sur un PDF → « Schwärzen mit Datenmaske » — ouvrir depuis n’importe quel dossier.

MSI + GPO

Déploiement par stratégie de groupe ou Intune ; réglages centraux pour les mises à jour, les modèles et le dossier surveillé.

Prérequis

Activer l’API REST

L’API est désactivée par défaut. Elle s’active dans les paramètres, par poste ; vous choisissez vous-même la clé (elle n’est pas générée) et elle reste locale à l’application.

  1. Paramètres → Système → « API REST locale ».
  2. Saisir un port (47190 par défaut) et une clé API de votre choix. Sans clé, le serveur refuse de démarrer (fail-closed).
  3. Cliquer sur « Démarrer ». Le statut passe à actif et l’API est joignable.
  4. Au prochain lancement de l’application, l’API démarre automatiquement tant que clé et interrupteur sont définis.

Première requête (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)

Détecter : POST /api/v1/detect

La requête contient le PDF encodé en Base64. La réponse liste chaque trouvé avec page, coordonnées de boîte (points PDF, origine en haut à gauche), type, confiance et source (regex/modèle). Ce sont exactement ces boîtes qu’on transmet ensuite au caviardage.

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 Page, à partir de 1
suggestions[].bboxX / bboxY / bboxWidth / bboxHeight Boîte en points PDF
suggestions[].sensitivityType ex. name, iban, birth_date
suggestions[].confidence 0–99
suggestions[].source regex (règles/empreintes) ou ner (modèle)

Caviarder : POST /api/v1/redact

Les boîtes de la détection sont regroupées par page. La réponse renvoie le PDF caviardé (Base64) et un rapport ; report.outputUsable est le signal de confiance : false signifie qu’un reste a été trouvé et que le fichier a été détruit.

! Sans vérification humaine : le script ne caviarde que ce que la détection trouve. outputUsable confirme la suppression, pas l’exhaustivité. Pour les dossiers avec noms, texte libre ou scans : contrôler par échantillonnage ou utiliser le dossier surveillé en mode « Vérification ».

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 Boîtes de la détection, pages à partir de 1
style black (défaut), white, blur ou pixelate
anonymize Marqueurs du type [NAME_1] au lieu de bandes
resiscan PDF image seule (couche texte détruite)
report.outputUsable / remainingPii Vérification réussie / nombre de restes

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

Trois recettes

A · Diriger les exports RA-MICRO / dossier électronique vers un dossier surveillé

  1. Dans RA-MICRO, envoyer l’export (PDF) vers un dossier réseau, p. ex. \\serveur-cabinet\datenmaske\eingang.
  2. Dans Datenmaske : Paramètres → Dossiers → ajouter ce dossier comme dossier surveillé.
  3. Mode « Vérification » (défaut) : chaque nouveau fichier arrive dans la bibliothèque à vérifier ; l’original part ensuite dans le sous-dossier verarbeitet.
  4. Mode « Auto » uniquement pour des données structurées : export automatique fail-closed vers redigiert/<nom>_redigiert.pdf. Noms et texte libre partent TOUJOURS en vérification humaine.
  5. Déduplication SHA-256 : un même fichier (même renommé) n’est jamais retraité deux fois par utilisateur.

B · Traitement par lots nocturne par script

  1. Sur le poste où Datenmaske tourne, créer une tâche planifiée (PowerShell).
  2. Le script ci-dessous lit un dossier, détecte, caviarde et contrôle outputUsable — les sorties rejetées restent visibles dans le dossier rejetes.
  3. À noter : le script tourne dans la session de l’utilisateur connecté ; l’API n’écoute que sur son 127.0.0.1.

C · Déployer trois postes via MSI et GPO

  1. Placer le MSI sur un partage ; affectation par GPO (Configuration ordinateur → Installation logicielle) ou Intune — silencieux : msiexec /i Datenmaske-Secure-setup.msi /qn.
  2. Pour les réseaux isolés, utiliser l’installateur complet (Datenmaske-Secure-full.msi) : modèles d’IA inclus, rien à télécharger au premier lancement.
  3. Déposer les modèles ADMX ; les stratégies sous HKLM\SOFTWARE\Policies\Mokka\Datenmaske sont lues à chaque démarrage : AutoUpdateMode (disable/notify/auto), BlockModelDownload (1 = bloquer les modèles), HotFolderPath (dossier surveillé central).
  4. Saisir la clé de licence sur chaque poste ; le menu contextuel s’active une fois par utilisateur dans Paramètres → Système.

B · Traitement par lots nocturne par script

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
  }
}

! Sans vérification humaine : le script ne caviarde que ce que la détection trouve. outputUsable confirme la suppression, pas l’exhaustivité. Pour les dossiers avec noms, texte libre ou scans : contrôler par échantillonnage ou utiliser le dossier surveillé en mode « Vérification ».

Ce que les interfaces ne font pas

Différence avec l’API web

Cette page décrit l’API locale du poste. L’édition web/cloud (redact_pdf, detect_pii, get_report avec clé) est documentée sur la page API — mêmes idées, autre infrastructure. → /fr/api-dokumentation

Pour aller plus loin