Protección de datos con CodeVeil

Esta guía muestra cómo proteger datos sensibles con CodeVeil: enmascarar PII, usar ofuscación que preserva el formato para que sus datos de prueba sigan siendo realistas, ejecutar grandes trabajos por lotes de hasta 10.000 registros y recibir notificaciones por webhook cuando finalicen.

Enmascaramiento de campos sensibles

CodeVeil enmascara PII, datos financieros y registros de salud conservando el formato y la integridad referencial: el mismo cliente se asigna al mismo valor enmascarado en todos los lugares donde aparece. Envíe los registros al endpoint de enmascaramiento e indique qué campos proteger:

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

Ofuscación que preserva el formato

La clave para que los datos de prueba sean útiles es que deben verse y comportarse como los reales. La salida ofuscada de CodeVeil mantiene la misma estructura, tipos y relaciones que el original: un correo electrónico sigue pareciendo un correo válido, un IBAN conserva su código de país y la forma de su dígito de control, y un número de teléfono conserva su patrón.

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

Como el formato se preserva, puede volcar el conjunto de datos enmascarado directamente en un entorno de staging o de pruebas y todas las validaciones, uniones y relaciones de clave foránea siguen funcionando.

Procesamiento por lotes

Para conjuntos de datos grandes, envíe hasta 10.000 registros en una sola solicitud al endpoint de lotes. El trabajo se ejecuta de forma asíncrona, así que no mantiene una conexión abierta:

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

La respuesta devuelve un ID de trabajo que puede usar para consultar el estado, o bien puede esperar al webhook.

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

Webhooks de finalización

En lugar de consultar el estado de forma periódica, registre un callback_url y CodeVeil enviará una solicitud POST cuando el trabajo esté terminado. El payload usa el evento 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"
  }
}

Verifique la cabecera X-KeepFlow-Signature con su secreto de webhook antes de confiar en el payload y, a continuación, descargue el conjunto de datos enmascarado desde el download_url. Los resultados están disponibles durante 24 horas tras la finalización.