Agent kurulumu — şirket bilgisayarlarına ajan

Ön koşullar

• Hesap kurulumu (Bölüm 2) tamamlanmış olmalı
• Aydınlatma metni çalışanlara dağıtılmış, kayıt altında imzalanmış
• Hedef bilgisayarlar Windows 10 (1909+) veya Windows 11
• Bilgisayarlar internete çıkabilmeli (yalnızca *.veritadlp.com HTTPS yeter)
• Kurulum yapan kullanıcı local administrator olmalı

Senaryo A — Tek bilgisayara manuel kurulum

Önce bir bilgisayarda deneyin, çalıştığını gördükten sonra toplu kuruluma geçin.

sc query veritadlp-agent

Sorun giderme: tek PC kurulumu çalışmazsa

C:\ProgramData\VeritaDLP\logs\agent.log

Test-NetConnection agents.veritadlp.com -Port 8443

Senaryo B — GPO ile toplu kurulum (AD Domain)

Active Directory'niz varsa, ajanı 200 PC'ye 1 saatte kurabilirsiniz. Group Policy Object (GPO) ile boot sırasında otomatik kurulur.

\\domain.local\SYSVOL\domain.local\veritadlp\veritadlp-agent.msi

# veritadlp-install.ps1 (Dashboard'tan indirilir)
$installed = Get-Service -Name "veritadlp-agent" -ErrorAction SilentlyContinue
if (-not $installed) {
  msiexec /i "\\domain\share\veritadlp-agent.msi" /quiet /norestart /l*v "$env:TEMP\veritadlp-install.log"
}

Senaryo B (alternatif) — AD yok, manuel UNC paylaşımı

Active Directory yoksa, ortak ağ paylaşımı + email rehberli kurulum:

1. MSI'ı şirket ortak paylaşımına koyun (\\fileserver\paylasım\veritadlp\)
2. Tüm çalışanlara şu adımları içeren mail gönderin:
   • "Bilgisayar başlangıcı → Çalıştır → \\fileserver\paylasım\veritadlp\install.bat"
   • İçerik: msiexec /i %~dp0veritadlp-agent.msi /quiet /norestart
3. Dashboard → Agent'lar listesinde gelmedikleri takip edin, hatırlatma gönderin

Senaryo C — Active Directory Connector kurulumu

Çalışan listenizi otomatik senkronize etmek için kullanılır. AD'niz internete açılmaz — bizim küçük servisimiz sizden bize push eder.

msiexec /i veritadlp-connector.msi /quiet TENANT=abc-sigorta TOKEN=YourTokenHere

Agent envanteri ve sağlığı

Dashboard → Agent'lar menüsü size her bilgisayar için:

• Hostname + son login kullanıcı
• OS versiyonu
• Agent versiyonu + sertifika geçerlilik tarihi
• Son heartbeat zamanı (5 dakikada bir gelir)
• Durum: Aktif (yeşil), Offline (gri, son 1 saat heartbeat yok), Sorunlu (kırmızı)

Agent silme / yeniden kurma

Çalışan ayrıldı, bilgisayarı yeniden imaj alındı, vb. durumlarda:

1. Dashboard → Agent'lar → ilgili bilgisayar → "Revoke" — sertifikası iptal edilir
2. Cloud bu PC'yi artık tanımaz, ajan gelse bile reddedilir
3. Yerel olarak silmek için msiexec /x {PRODUCT-CODE} /quiet
4. Yeniden kurulum: yeni MSI indir + kur — yeni sertifika ile cloud'a girer

Sık sorulan sorular

Anti-virus istisnaları (önemli!)

VeritaDLP agent dosya transferi izlerken anti-virus de aynı dosyaya bakıyor — çakışma olur, CPU yükselir, kurulum bile başarısız olabilir. Aşağıdaki istisnaları her zaman ekleyin:

Windows Defender

PowerShell (yönetici):

Add-MpPreference -ExclusionPath "C:\Program Files\VeritaDLP"
Add-MpPreference -ExclusionPath "C:\ProgramData\VeritaDLP"
Add-MpPreference -ExclusionPath "C:\Windows\System32\drivers\veritadlp-mf.sys"
Add-MpPreference -ExclusionProcess "veritadlp-agent.exe"
Add-MpPreference -ExclusionProcess "veritadlp-connector.exe"

Symantec Endpoint Protection

SEP Manager → Policies → Exception Policy → Add → File/Folder Exception. Path'leri yukarıdaki gibi. Process exception için: SONAR + Application Exception → veritadlp-agent.exe.

Kaspersky Endpoint Security

KES Console → Settings → Exclusions and Trusted Apps. Aynı path + process listesi. "Do not monitor application activity" + "Do not scan files" işaretlenmeli.

Bitdefender GravityZone

GravityZone Control Center → Policies → Antimalware → Exclusions. Path-based VE process-based exception ekle.

Yeni özellik geliştirildiğinde — agent'lar nasıl güncellenir?

Değişiklik tipine göre güncelleme yolu

MSI güncelleme süreci (otomatik)

Yeni agent versiyonu yayınlandığında IT yöneticisinin manuel iş yapması gerekmez:

1. Cloud yeni MSI versiyonunu yayınlar (admin panelinden)
2. Agent'lar her saatte cloud'a sorar: "yeni version var mı?"
3. Var ise → MSI indirir + EV cert imzasını doğrular
4. Off-hours (gece 02:00-05:00 random) install schedule eder
5. Eski version backup'lanır, yeni version yüklenir, servis restart
6. 5 dakika içinde heartbeat sağlıklı mı? OK ise tamam
7. Sağlıksız ise → otomatik rollback eski version'a

Tüm filo güncelleme süresi: 24-48 saat (PC'ler boot edip kontrol ettikçe yayılır).

Kademeli rollout — riski yönet

Büyük çapta agent güncellemesi yapılırken, hatalı versiyon tüm filoyu birden bozmasın diye cloud kademeli yayma yapar:

• Saat 0-24: Pilot grup %10 (IT departmanı + gönüllü) — sağlıksızlık tespit edilirse durdurulur
• Saat 24-72: Genişletilmiş pilot %50 — %30+ agent offline ise otomatik rollback
• Hafta 1 sonu: Genel rollout %100 — 5 gün gözlem dönemi

Kritik güvenlik güncellemesi (zero-day) durumunda kademe atlanır → "Force Critical Update" modu, saatler içinde tüm filo güncellenir.

Yeni veri toplamak istediğinizde — 3 senaryo

Senaryo A: Yeni PII tipi (örn. plaka)

Eğer regex bazlı tespit yeterliyse: Custom dictionary'ye plaka regex'i ekle → Cloud push → tüm agent'lara anlık ulaşır. MSI güncellemesi gerekmez.

Senaryo B: Yeni kanal (örn. Telegram desktop)

Yeni Windows API hook gerekir, agent kodu değişir. MSI lazım — kademeli rollout sürecinden geçer.

Senaryo C: Var olan event'e yeni alan eklemek (örn. dosya MIME tipi)

Schema versioning ile: eski agent eski event formatı, yeni agent yeni format. Cloud her ikisini de parse eder. 30 gün geçiş sonrası eski schema desteği düşürülür.

Agent versiyon yönetimi + otomatik güncelleme

Agent'lar otomatik güncellenir (cloud üzerinden push). Yapılandırma:

Çoklu site (multi-location) deployment

Şirketinizin birden fazla ofisi var (İstanbul + Ankara + İzmir). Her ofisin internet bağlantısı, proxy, network konfigürasyonu farklı. Stratejiler:

Senaryo A: Ortak GPO, ofis-bağımsız

Domain controller tüm ofislere replikasyon yapıyorsa: tek GPO + Software Installation paketi. Her ofisin PC'leri kendi en yakın DC'sinden GPO çeker. UNC path tüm ofislerden erişilebilir olmalı.

Senaryo B: Ofis-spesifik GPO

Her ofis için ayrı OU + GPO (örn. "Istanbul-Ofis", "Ankara-Ofis"). Software Installation paketi yerel UNC kullanır (her ofiste lokal file server). Yayma daha hızlı + bandwidth tasarrufu.

Senaryo C: Branch office cache

Küçük şubeler için: ana ofisten MSI dosyası bir branch cache sunucusuna (DFS-R replikasyon veya BranchCache). Şube PC'leri internet üzerinden değil, kendi LAN'larından MSI çeker.

Agent log analizi (ileri seviye)

Log dosya konumu ve format

C:\ProgramData\VeritaDLP\logs\
  agent.log              # Ana log (rotate edilir, 100 MB)
  policy-engine.log      # Politika değerlendirme detayı
  network.log            # Cloud iletişimi
  enrollment.log         # İlk enrollment (kalıcı, silinmez)
  upgrade.log            # Versiyon güncelleme geçmişi

Log seviyesini değiştirme

Tipik problem teşhisi için debug log gerekebilir. Geçici aktive etme:

# Dashboard üzerinden tek agent için:
# Dashboard → Agents → ilgili PC → "Debug Mode On" (24 saat aktif kalır)

# Veya local registry ile:
reg add "HKLM\SOFTWARE\VeritaDLP\Agent" /v LogLevel /t REG_SZ /d "Debug" /f
sc stop veritadlp-agent
sc start veritadlp-agent

Önemli log mesajları ve anlamları

Log toplama (forensic için)

Bir bilgisayardan tüm log'ları toplayıp incelemek için PowerShell script:

# collect-veritadlp-logs.ps1
$outDir = "$env:USERPROFILE\Desktop\veritadlp-logs-$(Get-Date -Format yyyyMMdd-HHmmss)"
New-Item -Path $outDir -ItemType Directory -Force | Out-Null

Copy-Item "C:\ProgramData\VeritaDLP\logs\*" $outDir -Recurse
Get-EventLog -LogName Application -Source "VeritaDLP*" -Newest 1000 |
  Export-Csv "$outDir\eventlog.csv"
sc query veritadlp-agent | Out-File "$outDir\service-status.txt"
Get-NetTCPConnection | Where-Object {$_.RemotePort -in 443,8443} |
  Out-File "$outDir\network.txt"
gpresult /R /SCOPE Computer | Out-File "$outDir\gpo.txt"

Compress-Archive -Path $outDir -DestinationPath "$outDir.zip"
Write-Host "Logs ZIP: $outDir.zip"

Agent unenrollment + temiz kaldırma

Bilgisayar geri verilecek, satılacak veya bağışlanacak. Agent'ı temiz kaldırma:

# Düzgün kaldırma (önerilir):
msiexec /x {PRODUCT-GUID} /quiet /norestart

# GUID öğrenmek için:
Get-WmiObject Win32_Product | Where-Object {$_.Name -like "*VeritaDLP*"} |
  Select-Object Name, IdentifyingNumber

# Veya direkt isim ile:
Get-WmiObject Win32_Product | Where-Object {$_.Name -like "*VeritaDLP*"} |
  Invoke-WmiMethod -Name Uninstall

# Yönetici PowerShell:
Stop-Service veritadlp-agent -ErrorAction SilentlyContinue
sc delete veritadlp-agent

Remove-Item "C:\Program Files\VeritaDLP" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "C:\ProgramData\VeritaDLP" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "HKLM:\SOFTWARE\VeritaDLP" -Recurse -Force -ErrorAction SilentlyContinue

# Sertifika store'dan temizlik:
Get-ChildItem -Path Cert:\LocalMachine\My |
  Where-Object {$_.Subject -like "*VeritaDLP*"} |
  Remove-Item

AD Connector ileri konuları

Multi-domain ortamlar

Şirketinizin birden fazla AD domain'i var (örn. forest trust, child domain). Connector tek bir base DN'den sync eder — tüm domain'leri kapsamasını isterseniz:

1. Her domain için ayrı Connector kurun
2. Her connector ayrı tenant'ta YA da aynı tenant'ta (farklı sync namespace ile)
3. Veya Universal Group ile tüm forest'taki kullanıcıları tek base DN altında topla, tek connector kullan

Selective sync (sadece belirli OU'lar)

50.000 kullanıcılı büyük AD'niz var ama VeritaDLP'de sadece 200 ofis çalışanı izlenecek. OU filtresi:

# Connector config:
SyncBaseDN = "OU=Ofis Calisanlari,DC=firma,DC=local"
ExcludeOUs = "OU=Test Kullanicilari;OU=Eski Calisanlar"
IncludeFilter = "(memberOf=CN=DLP-Izleme,OU=Groups,DC=firma,DC=local)"

Connector debug

Connector log: C:\ProgramData\VeritaDLP\connector\logs\connector.log

Sync detayı görmek için debug seviyesi:

reg add "HKLM\SOFTWARE\VeritaDLP\Connector" /v LogLevel /t REG_SZ /d "Debug" /f
Restart-Service veritadlp-connector

Connector yedek + DR

Connector kritik — durursa AD sync durur. Yüksek availability için:

• İki connector farklı sunucularda kurulu (Active-Passive)
• Cloud her ikisinden de heartbeat alır, biri 5 dk offline olursa diğeri devralır
• Connector sertifikası 1 yıllık (agent'tan farklı, 90 gün değil)

Performans tuning

Yüksek dosya transferi yapan kullanıcılar

Bazı kullanıcılar (örn. video editör, fotoğrafçı) GB seviyesinde dosya işler. Agent her dosyayı hash + tarar — yavaşlık olabilir.

Çözüm: Bypass kuralları (Ayarlar → Agent → Bypass):

• Dosya boyutu > 100 MB → derin tarama atla, sadece hash al
• Belirli uzantılar (.mp4, .psd, .iso) → tarama atla
• Belirli klasörler (D:\Projeler) → izleme atla

Düşük CPU/RAM PC'ler (kıdemli donanım)

4 GB RAM, eski işlemci. Agent'ın "Hafif Mod"unu açın:

• Async tarama (transfer sonrası tara, transfer sırasında değil) — bazı politika tetiklemeleri 1-2 sn geç gelir
• Düşük thread sayısı (1 worker, 4 yerine)
• Memory cap 50 MB
• İçerik özeti üretme atla — sadece sayım