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.
- 100 % sur l’appareil
- API sur 127.0.0.1 uniquement
- Aucun envoi, aucun cloud
- § 203 StGB : le document ne quitte jamais la machine
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
- Datenmaske Secure est installé et lancé (l’API et le dossier surveillés ne fonctionnent que si l’application tourne ; réduite dans la barre système, cela suffit).
- Une licence active est en place — sans contexte utilisateur, le dossier surveillé ne traite volontairement rien.
- Pour les scripts : Windows avec curl.exe (inclus depuis Windows 10) ou PowerShell 5.1+.
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.
- Paramètres → Système → « API REST locale ».
- Saisir un port (47190 par défaut) et une clé API de votre choix. Sans clé, le serveur refuse de démarrer (fail-closed).
- Cliquer sur « Démarrer ». Le statut passe à actif et l’API est joignable.
- 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é
- Dans RA-MICRO, envoyer l’export (PDF) vers un dossier réseau, p. ex. \\serveur-cabinet\datenmaske\eingang.
- Dans Datenmaske : Paramètres → Dossiers → ajouter ce dossier comme dossier surveillé.
- Mode « Vérification » (défaut) : chaque nouveau fichier arrive dans la bibliothèque à vérifier ; l’original part ensuite dans le sous-dossier verarbeitet.
- 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.
- 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
- Sur le poste où Datenmaske tourne, créer une tâche planifiée (PowerShell).
- Le script ci-dessous lit un dossier, détecte, caviarde et contrôle outputUsable — les sorties rejetées restent visibles dans le dossier rejetes.
- À 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
- Placer le MSI sur un partage ; affectation par GPO (Configuration ordinateur → Installation logicielle) ou Intune — silencieux : msiexec /i Datenmaske-Secure-setup.msi /qn.
- 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.
- 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).
- 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
- Aucun accès réseau : l’API n’écoute que 127.0.0.1 ; pilotage centralisé depuis d’autres machines volontairement impossible.
- L’API ne tourne que si l’application tourne ; pas (encore) de mode service.
- Pas de « laisser volontairement » via l’API : une valeur rejetée dans l’interface bloque l’export via l’API (fail-closed strict).
- Le mode « Auto » n’exporte que des données structurées vérifiées (e-mail, IBAN, carte, identifiant fiscal, sécurité sociale, passeport, assurance). Noms, adresses et scans passent toujours par la vérification humaine.
- Un CLI existe dans le projet mais n’est pas livré avec l’installateur ; l’automatisation prise en charge est l’API REST.
- Une requête = un PDF (Base64) ; traiter en séquence, le serveur traite dans l’ordre.
- Dossiers réseau (UNC) pris en charge ; en cas de liaison instable, préférer un dossier de synchronisation local.
- outputUsable prouve que les trouvailles sélectionnées ont été supprimées et que le contrôle des restes est vide — pas que la détection a tout trouvé. Sans contrôle par échantillonnage, un risque résiduel demeure.
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