Perlindungan Data CodeVeil

Panduan ini menunjukkan cara melindungi data sensitif dengan CodeVeil: menyamarkan PII, menggunakan obfuskasi yang mempertahankan format agar data uji Anda tetap realistis, menjalankan pekerjaan batch besar hingga 10.000 rekaman, dan mendapatkan notifikasi melalui webhook saat pekerjaan itu selesai.

Menyamarkan bidang sensitif

CodeVeil menyamarkan PII, data finansial, dan rekaman kesehatan sambil mempertahankan format dan integritas referensial — pelanggan yang sama dipetakan ke nilai tersamar yang sama di mana pun ia muncul. Kirim rekaman ke endpoint penyamaran dan tentukan bidang mana yang akan dilindungi:

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

Obfuskasi yang mempertahankan format

Kunci dari data uji yang berguna adalah bahwa data itu harus terlihat dan berperilaku seperti yang sebenarnya. Keluaran tersamar dari CodeVeil mempertahankan struktur, tipe, dan hubungan yang sama seperti aslinya: sebuah email tetap tampak seperti email yang valid, sebuah IBAN mempertahankan kode negara dan bentuk checksum-nya, sebuah nomor telepon mempertahankan polanya.

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

Karena formatnya dipertahankan, Anda dapat memasukkan langsung set data tersamar ke lingkungan staging atau uji, dan setiap validasi, join, serta hubungan foreign-key tetap berfungsi.

Pemrosesan batch

Untuk set data besar, kirimkan hingga 10.000 rekaman dalam satu permintaan ke endpoint batch. Pekerjaan berjalan secara asinkron sehingga Anda tidak perlu menahan koneksi tetap terbuka:

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

Respons mengembalikan sebuah ID pekerjaan yang dapat Anda gunakan untuk menjajak status, atau Anda dapat menunggu webhook.

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

Webhook penyelesaian

Alih-alih menjajak, daftarkan sebuah callback_url dan CodeVeil akan mengirim POST ke sana ketika pekerjaan selesai. Payload menggunakan peristiwa 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"
  }
}

Verifikasi header X-KeepFlow-Signature dengan secret webhook Anda sebelum memercayai payload, lalu ambil set data tersamar dari download_url. Hasil tersedia selama 24 jam setelah penyelesaian.