CodeVeil-Datenschutz

Dieser Leitfaden zeigt, wie Sie sensible Daten mit CodeVeil schützen: PII maskieren, formaterhaltende Verschleierung nutzen, damit Ihre Testdaten realistisch bleiben, große Batch-Jobs mit bis zu 10.000 Datensätzen ausführen und sich per Webhooks benachrichtigen lassen, wenn diese fertig sind.

Sensible Felder maskieren

CodeVeil maskiert PII, Finanzdaten und Gesundheitsdaten und bewahrt dabei Format und referenzielle Integrität – derselbe Kunde wird überall, wo er auftaucht, auf denselben maskierten Wert abgebildet. Senden Sie Datensätze an den Masking-Endpunkt und geben Sie an, welche Felder geschützt werden sollen:

curl -X POST https://api.keepflow.ai/v1/codeveil/mask \
  -H "Authorization: Bearer kf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      { "name": "Jane Doe", "email": "[email protected]", "iban": "DE89370400440532013000" }
    ],
    "fields": {
      "name": "name",
      "email": "email",
      "iban": "iban"
    }
  }'

Formaterhaltende Verschleierung

Der Schlüssel zu nützlichen Testdaten ist, dass sie sich wie die echten Daten aussehen und verhalten müssen. Die verschleierte Ausgabe von CodeVeil behält dieselbe Struktur, dieselben Typen und dieselben Beziehungen wie das Original: Eine E-Mail bleibt eine gültig aussehende E-Mail, eine IBAN behält Ländercode und Prüfsummenformat, eine Telefonnummer behält ihr Muster.

{
  "name": "Marta Lindqvist",
  "email": "[email protected]",
  "iban": "DE21500105174829471138"
}

Da das Format erhalten bleibt, können Sie den maskierten Datensatz direkt in eine Staging- oder Testumgebung übernehmen, und jede Validierung, jeder Join und jede Fremdschlüsselbeziehung funktioniert weiterhin.

Batch-Verarbeitung

Für große Datensätze übermitteln Sie bis zu 10.000 Datensätze in einer einzigen Anfrage an den Batch-Endpunkt. Der Job läuft asynchron, sodass Sie keine Verbindung offen halten müssen:

curl -X POST https://api.keepflow.ai/v1/codeveil/batch \
  -H "Authorization: Bearer kf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-app.com/hooks/codeveil",
    "records": [ /* up to 10,000 records */ ],
    "fields": { "email": "email", "ssn": "national_id" }
  }'

Die Antwort liefert eine Job-ID zurück, mit der Sie den Status abfragen können, oder Sie warten auf den Webhook.

{
  "data": { "job_id": "job_9f2a", "status": "processing", "record_count": 10000 }
}

Abschluss-Webhooks

Statt den Status abzufragen, registrieren Sie eine callback_url, und CodeVeil sendet nach Abschluss des Jobs einen POST-Request daran. Die Nutzlast verwendet das Ereignis data.processed:

{
  "event": "data.processed",
  "timestamp": "2026-07-17T09:12:00Z",
  "data": {
    "job_id": "job_9f2a",
    "status": "completed",
    "record_count": 10000,
    "download_url": "https://api.keepflow.ai/v1/codeveil/results/job_9f2a"
  }
}

Verifizieren Sie den X-KeepFlow-Signature-Header mit Ihrem Webhook-Secret, bevor Sie der Nutzlast vertrauen, und rufen Sie dann den maskierten Datensatz von der download_url ab. Die Ergebnisse sind nach Abschluss 24 Stunden lang verfügbar.