Ana içeriğe geç

Geliştirici

API ve Webhooks

VeritaDLP'yi kendi sistemlerinizle programmatic olarak entegre edin. REST API + webhook + scope-based güvenlik.

API Key — Stripe Pattern

Dashboard'dan tek tıkla API key üretirsiniz. Format vt_live_... — Stripe ile aynı pattern. Bearer token olarak header'da gönderilir.

  • ✓ Scope-based — events:read, policies:write
  • ✓ Expire tarihi (opsiyonel)
  • ✓ Rate limit per-key (Redis token bucket)
  • ✓ Last-used tracking (anomaly tespit)
  • ✓ Plain key sadece oluşturma anında görünür (sonra bcrypt hash)
# Bearer token authentication
curl -X GET \
https://api.veritadlp.com/v1/events \
-H "Authorization: \
Bearer vt_live_4eC39Hq..."
# Response
{
"events": [...],
"total": 247,
"page": 1
}

Scope (Yetki) Listesi

Scope Kapsam Tipik Kullanım
events:readOlay log okumaSIEM forwarding, BI rapor
events:exportCSV/JSONL bulk exportVeri ambar, denetim
policies:readPolitika listeleYapılandırma yedekleme
policies:writePolitika oluştur/güncelleCI/CD policy-as-code
agents:readAgent envanteriCMDB sync, monitoring
audit:readAudit log okumaKVKK denetim, SIEM
bi:readOData v4 BI connectorPowerBI, Tableau, Excel

Webhooks — Real-time Event Push

VeritaDLP olayları size real-time push eder. Slack, SIEM, custom backend — istediğiniz endpoint'e.

Konfigürasyon

  • · Endpoint URL (POST)
  • · HMAC-SHA256 secret (imza doğrulama)
  • · Event filtresi (örn. sadece "block" kararları)
  • · Format: JSON · CEF · LEEF (SIEM uyumu)
  • · Retry policy: 1m → 5m → 30m → 2h → 12h (5 deneme)
  • · Failure dashboard — debug için
# Webhook payload
POST https://your-app.com/dlp-hook
X-VeritaDLP-Signature: sha256=...
X-VeritaDLP-Timestamp: 1716...
{
"event_id": "evt_4719",
"occurred_at": "2026-05-18T14:23Z",
"channel": "usb",
"user": "ahmet.yilmaz",
"decision": "block",
"risk_score": 92,
"pii_counts": {
"tc_kimlik": 47, "iban": 12
}
}

Endpoint Kategorileri

Events

  • GET /v1/events
  • GET /v1/events/{id}
  • GET /v1/events/export.jsonl
  • GET /v1/events/export.csv

Policies

  • GET /v1/policies
  • POST /v1/policies
  • PATCH /v1/policies/{id}
  • DELETE /v1/policies/{id}

Agents

  • GET /v1/agents
  • GET /v1/agents/{id}
  • POST /v1/agents/{id}/revoke

Webhooks

  • GET /v1/webhooks
  • POST /v1/webhooks
  • PATCH /v1/webhooks/{id}
  • POST /v1/webhooks/{id}/test

BI Connector (OData v4)

  • GET /v1/tenant/bi/$metadata
  • GET /v1/tenant/bi/Events
  • GET /v1/tenant/bi/AuditLog
  • GET /v1/tenant/bi/events.csv

Audit + Compliance

  • GET /v1/tenant/audit-log
  • GET /v1/tenant/audit-log/export.csv
  • POST /v1/tenant/data-export (KVKK Md.11)

Tam OpenAPI 3.0 specification: api.veritadlp.com/v1/openapi.json

Tipik Entegrasyonlar

Slack

Kritik PII tespitinde kanal bildirimi

Splunk

SIEM forward via CEF format webhook

ArcSight

CEF v0 + audit log

QRadar

LEEF 2.0 forward

Microsoft Teams

Adaptive Card webhook

PagerDuty

Yüksek risk alarm

Jira / Linear

Auto-ticket oluşturma

PowerBI

OData v4 connector

Tableau

OData feed

Tam Dokümantasyon

Tüm endpoint'lerin parametre + örnek + response detayı için:

docs.veritadlp.com

Bugün başlayın, 5 dakikada kurun

Kredi kartı gerekmez. 15 gün ücretsiz deneme — istemediğin sürece ücret alınmaz.