Delil paketi nasıl doğrulanır? (dogrula.py, zaman damgası, passkey) Görüş / yorum

Delil paketi nedir?

RahatİK, bir çalışanın onay kayıtlarını (izin, ücret pusulası, aylık puantaj, zimmet, fazla çalışma muvafakati, passkey kaydı) ve disiplin /
fesih dosyası olaylarını delil paketi olarak indirmenize izin verir (Çıkış ve disiplin → çalışan → Delil paketini indir). Paketteki
dogrula.py, kayıtları RahatİK'e ya da veritabanına bağlanmadan, yalnız Python 3 ile doğrular. Betiği bu sayfadan ya da güvendiğiniz bir
kopyadan alın; paketin getirdiği kopya tek güven kaynağı olmamalıdır.

Zaman damgası durumu

TSA kapalı, damga yok. Nitelikli zaman damgası sağlayıcısı henüz seçilmedi; günlük kökler "DAMGASIZ" olarak işaretlenir. Kayıtların
bütünlüğü ve günlük köke dahil oldukları yine doğrulanır, ama hangi tarihte var oldukları üçüncü taraf damgasıyla kanıtlanmaz.

Sağlayıcı seçildiğinde bu bölümde TSA kök sertifikasının SHA-256 parmak izi yayımlanır. Doğrulamada bu parmak izini --pin ile ya da
sağlayıcının resmî sayfasından aldığınız kök sertifikayı --ca ile verin. Hiçbiri verilmezse betik damgayı yalnız "paket içi tutarlılık"
olarak raporlar: paketteki sertifika zinciri kendi başına güvenilir kaynak sayılmaz.

Nasıl çalıştırılır?

python3 dogrula.py delil-paketi.zip
python3 dogrula.py delil-paketi.zip --pin <SHA-256 parmak izi>
python3 dogrula.py delil-paketi.zip --ca tsa-kok.pem
python3 dogrula.py delil-paketi.zip --ca tsa-kok.pem --strict

--strict (katı mod) uyarıyı da başarısızlık sayar; otomasyonda kullanın. Çıkış kodu 0 "hata yok" demektir, güvenin doğrulandığı demek
değildir: güven durumu çıktının sonundaki GÜVEN: satırındadır.

Örnek çıktı (zaman damgası kapalıyken, demo veri):

[OK    ] manifest.json özeti OK
Çalışan: Ayşe Yılmaz · kayıt: 3 · üretim: 2026-10-24 20:56:04.493980+00:00 · betik sürümü 3
[OK    ] onay #4 (WEB_ONAY, 2026-10-24 20:56:04): satır özeti OK · 2026-10-24 köküne kanıt OK
[OK    ] onay #5 (WEB_ONAY, 2026-10-24 20:56:04): satır özeti OK · 2026-10-24 köküne kanıt OK
[OK    ] onay #6 (WEB_ONAY, 2026-10-24 20:56:04): satır özeti OK · 2026-10-24 köküne kanıt OK
[UYARI ] kök 2026-10-24 (efe47a41dc8773c5…): zaman damgası yok — DAMGASIZ (TSA kapalı)

Not: Merkle kanıtı kaydın günlük köke dahil olduğunu gösterir; paketin çalışanın tüm kayıtlarını içerdiğini kanıtlamaz.
GÜVEN: zaman damgası yok — yalnız iç tutarlılık (satır özetleri, Merkle kanıtları) doğrulandı
SONUÇ: 4 OK · 1 uyarı · 0 hata

Passkey ve zincir doğrulaması

• Zincir: her kaydın özeti, bir önceki kaydın özeti ve kaydın içeriğinden hesaplanır; içerik değişmişse "satır özeti uyuşmuyor" hatası
  çıkar.
• Passkey onayı: imza, satır özetine bağlı onay verisinden (assertion) okunur ve satır özetine bağlı anahtardan türetilen public key ile doğrulanır; anahtar ayrıca passkey kayıt deliliyle karşılaştırılır.
  Betik ayrıca isteğin türünü, challenge'ı, adresi (origin), RahatİK alan adını (RP) ve kullanıcının parmak izi / yüz doğrulamasını (UV)
  denetler. Eski kayıtlarda anahtar satır özetine bağlı değildir; betik bunu uyarı olarak yazar.
• Kapsam sınırı: paket, içerdiği kayıtları doğrular; çalışanın bütün kayıtlarının pakette olduğunu (eksiksiz olduğunu) tek başına
  kanıtlamaz.

Bu bir elektronik imza mıdır?

Hayır. Onay kaydı 5070 sayılı Kanun anlamında güvenli elektronik imza değildir; kimin, neyi, ne zaman onayladığını değiştirilemez bir bütünlük
kaydıyla gösterir. Bkz. izin-onayi-ve-butunluk-kaydi.