Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

Denetim Kaydı

Denetim kaydı, ürün içi işlem incelemesi ve hesap verebilirlik için teknik kanıt sunar. Olay türü, varlık, aktör ve kurum bağlamı birlikte değerlendirilir. Bir kaydın bulunması hukuki delil kabulü, harici WORM depolama veya bütün kullanıcı etkileşimlerinin kaydedildiği garantisi değildir.

Yüzeyler ve Yetkiler

SayfaRollerAPI yolu
https://app.mevzuatradar.com/compliance/auditADMIN, LEGAL_REVIEWER/api/v1/audit-logs/compliance
https://mevzuatradar.com/admin/auditADMIN/api/v1/audit-logs

API temel adresi https://api.mevzuatradar.com olur. Uçlar JWT ve rol kontrolüyle korunur. EDITOR ve VIEWER okuma/dışa aktarma yetkisine sahip değildir; izin verilen istemci olaylarını yazma uçları ayrı yetkilendirilir.

Liste ve tekil sorgu oturumun kurum kimliğiyle sınırlıdır. targetOrganizationId, kayıt metadata’sındaki hedef kurum filtresidir; başka kurumun tablosuna geçiş yetkisi vermez. Platform işlemi kendi kurum kaydı içinde müşteri hedefini metadata olarak taşıyabilir.

Okuma ve Dışa Aktarma

Aşağıdaki tabloda müşteri uyum yüzeyinin yolları gösterilir. Yönetici karşılıklarında /compliance parçası çıkarılır; rol ADMIN olur.

Yöntem ve yolSonuç
GET /api/v1/audit-logs/complianceListe ve sayfalama bilgisi
GET /api/v1/audit-logs/compliance/:idTek kayıt
POST /api/v1/audit-logs/compliance/exportGövdedeki format ile CSV veya PDF liste çıktısı
POST /api/v1/audit-logs/compliance/:id/exportTek kaydın PDF çıktısı

Liste page için en az 1, limit için 1–100 kabul eder; varsayılanlar 1 ve 50’dir. Yanıt { success: true, data: { items, meta } } biçimindedir. meta, total, page, limit, totalPages içerir.

Filtreler

Liste sorgusunda şu alanlar bulunur:

  • dateFrom, dateTo: ISO tarihleri. Yalnız tarih verilen aralıklar UTC gün başlangıcı ve sonuyla genişletilir.
  • userId, action, entityType, entityId, departmentId.
  • actorRole, eventCategory, eventOutcome, surface, route.
  • requestId, correlationId, aiRequestId.
  • targetOrganizationId, adminActorId, accessReason, supportCaseId.
  • hashStatus: VERIFIED, MISSING, UNVERIFIED.
  • includeArchived: true/false; varsayılan olarak archivedAt dolu kayıtlar listeye alınmaz.

Metadata filtreleri ilgili alanın eşitliğini arar. entityType büyük/küçük harf ve alt çizgi varyantlarıyla kısmi eşleşme uygular. hashStatus=MISSING özeti olmayan satırları seçer; diğer iki değer sorguda özeti bulunan satırları seçer. Gerçek doğrulama durumu dönen her kayıtta ayrıca hesaplanır; bu iki filtrenin tek başına geçerli/geçersiz zinciri ayırdığı varsayılmaz.

Dışa aktarma gövdesi filtreleri ve format: "csv" | "pdf" alanını kabul eder; varsayılan CSV’dir. Liste çıktısı en fazla 100 kayıt içerir. Daha fazla kayıt bulunduğunda başarılı yanıt truncated: true, limitApplied: 100 ile sınırlamayı bildirir; tarih veya diğer filtreler daraltılarak yeniden alınır. Limit aşımı hata yanıtı değildir.

Çıktı dosyası doğrudan HTTP dosyası olarak dönmez. data içinde fileName, mimeType, base64, totalRecords, generatedAt ve duruma göre truncated/limitApplied alanları bulunur. Yönetici yüzeyinde targetOrganizationId ile liste çıktısı alınırken accessReason, dateFrom ve dateTo zorunludur; eksikse 400 döner. Rol kontrolü 403, kapsamda bulunamayan tek kayıt 404 ile sonuçlanır.

Kayıt Alanları ve Gerçek Olaylar

Kayıt; id, userId, userName, userEmail, action, entityType, entityId, metadata, previousHash, hashChain, hashStatus, archivedAt, createdAt alanlarını taşır. Rol, route veya AI bağlamı gibi alanlar olaya göre metadata’da bulunabilir; her olay için dolu olmaları zorunlu değildir.

OlayÜretildiği işlem
DSR_REQUEST_CREATEDVeri sahibi talebi oluşturma
DSR_REQUEST_UPDATEDYönetici DSR kararı ve kullanıcı silme kaydı
AUDIT_LOG_VIEWEDFiltresiz denetim listesi okuma
AUDIT_LOG_FILTEREDFiltreli denetim listesi okuma
AUDIT_LOG_DETAIL_VIEWEDTek denetim kaydı okuma
AUDIT_LOG_EXPORTEDCSV liste çıktısı
AUDIT_LOG_PDF_GENERATEDPDF çıktısı
VERIFICATION_RERUN_REQUESTEDDoğrulama çalışmasını yeniden isteme
VERIFICATION_EXPORT_GENERATEDDoğrulama raporu dışa aktarma

İstemci etkileşimleri ayrı semantik olay kataloğuna göre kaydedilir. AI alanları model rotası, istek/atıf kimlikleri ve maskeleme sürümü gibi bağlamı taşıyabilir. İç araç adı veya her tıklama için ayrı olay garantisi verilmez.

Maskeleme ve Kişisel Veri Sınırı

Ortak yazım ve okuma yardımcıları; token, secret, oturum, cookie, API anahtarı, ham prompt/yanıt/gövde gibi adlandırılmış metadata alanlarını maskeler. IP metadata anahtarlarında SHA-256 özet kullanılır. Derinlik, dizi ve metin boyutları sınırlandırılır. Bu anahtar tabanlı maskeleme serbest metnin tamamının kişisel veriden arındırıldığı anlamına gelmez. Aktör adı ve e-posta gibi alanlar yetkili okuma çıktısında bulunur; “denetim kaydı kişisel veri içermez” beyanı kurulamaz.

Bütünlük ve Saklama

Ortak değişmez kayıt servisi, kurum kilidi altında önceki özet ve sıra bilgisiyle SHA-256 zincirli kayıt üretir. Diğer doğrudan yazım yollarının da aynı zincire katıldığı varsayılmaz. Liste/ayrıntı eşleyicisi kaydın kendi özetiyle doğrulama yaparak VERIFIED, MISSING veya UNVERIFIED döndürür. VERIFIED, satırın özet hesabına ilişkindir; önceki satırların varlığı, sırası veya tüm zincirin eksiksizliğinin bağımsız doğrulaması değildir.

Politika tabanlı şifreli arşiv, kaynak satırları değiştirmeden doğrulanmış nesne ve arşiv konum kaydı oluşturur. Saklama alt sınırı ürün politikasında 5 yıldır; otomatik etkinlik ve gerçek depolama için yapılandırma kanıtı gerekir. Saklama ayrıntıları ayrı açıklanır. Harici Object Lock, on yıllık saklama veya dış denetçi kabulü ayrı kanıt gerektirir.