TgWitness / Belgeler

Neler test edildi →

Referans / Kanıt

Telegram · Zaman damgaları

İmzalı kontrol noktaları için RFC 3161 zaman damgaları: yetkili kuruma ne gönderilir ve yanıt nasıl doğrulanır?

TgWitness / Belgeler · Kanıt ve doğrulama

Kanıt ve doğrulama

TgWitness, RFC 3161 isteklerini hazırlar ve zaman damgası otoritesi (TSA) yanıtlarını doğrular. Bu manuel prosedür ne bir TSA seçer ne de veri gönderir; kanıt modu ise her ikisini de bir zaman çizelgesine göre gerçekleştirir (kanıt formatı). Hazırlanan bir istek, henüz bir zaman damgası kanıtı değildir.

Kanıtın bağlayıcılığı#

Akış şemasıHesap gözlemleri → SHA-256 zinciri ve Ed25519 imzaları; SHA-256 zinciri ve Ed25519 imzaları → İmzalı kontrol noktası; İmzalı kontrol noktası → Tam bayt hash ve rastgele nonce; Tam bayt hash ve rastgele nonce → RFC 3161 isteği; RFC 3161 isteği → Bağımsız TSA; Bağımsız TSA → İmzalı TSA yanıtı; İmzalı kontrol noktası → Verileri, geçici anahtarı ve açık CA güvenini doğrulayın; İmzalı TSA yanıtı → Verileri, geçici anahtarı ve açık CA güvenini doğrulayınHesap gözlemleriSHA-256 zinciri veEd25519 imzalarıİmzalı kontrol noktasıTam bayt hash verastgele nonceRFC 3161 isteğiBağımsız TSAİmzalı TSA yanıtıVerileri, geçicianahtarı ve açık CAgüvenini doğrulayın
Diyagramın metin olarak gösterimi
  1. Hesap gözlemleri → SHA-256 zinciri ve Ed25519 imzaları
  2. SHA-256 zinciri ve Ed25519 imzaları → İmzalı kontrol noktası
  3. İmzalı kontrol noktası → Tam bayt hash ve rastgele nonce
  4. Tam bayt hash ve rastgele nonce → RFC 3161 isteği
  5. RFC 3161 isteği → Bağımsız TSA
  6. Bağımsız TSA → İmzalı TSA yanıtı
  7. İmzalı kontrol noktası → Verileri, geçici anahtarı ve açık CA güvenini doğrulayın
  8. İmzalı TSA yanıtı → Verileri, geçici anahtarı ve açık CA güvenini doğrulayın

Toplayıcı imzası, kayıtları kendi anahtarına bağlar. Güvenilir bir TSA yanıtı, belirli bir kontrol noktasının TSA tarafından belirtilen zamanda var olduğunu doğrulayabilir. Kontrol noktası daha sonra günlük önekini bağlayabilir. Bu üst zaman sınırı, onaylanmış önek için geçerlidir; tek tek Telegram eylemleri, kaydedilmiş olay zamanlarını korur.

Prosedür#

Günlük doğrulayıcısı, varsa observed_at değerlerinde geriye doğru adımları ve ayrıştırılamayan değerleri chronology içinde raporlar ve komut çıktısına bir uyarı ekler. İmzalı zaman damgalarını korur ve imzalarını yine de kontrol eder. Geriye doğru bir adım saat düzeltmesinden kaynaklanabilir, bu nedenle bunu ana bilgisayarın saat kayıtlarıyla karşılaştırın. Bağımsız zaman, doğrulanmış harici zaman damgalarından, kamu t.me sayfasından okunan tanık gönderilerinden ve drand turlarından elde edilir; --strict, imzalayan sabitlemeyi ve desteklenen biçimleri yönetir.

Kaydedilen drand değerleri, çevrimdışı olarak yapısal ve hash öz-tutarlılık kontrollerinden geçer. --check-drand, seçilen kaydedilmiş turları HTTPS aktarma yanıtlarıyla karşılaştırır; sonuç, kaç turun karşılaştırıldığını ve hangi aktarıcıların yanıt verdiğini belirtir; karşılaştırılan turlar ise doğrulanmış alt zaman sınırını sağlar.

  1. Toplayıcı anahtarının parmak izini ayrı bir güvenilir kanal aracılığıyla saklayın; bu parmak izi, incelenen ZIP dosyasından bağımsız olarak toplayıcıyı tanımlar.
  2. Dışa Aktar → Zaman damgası isteği hazırla bölümünden, seçilen çalışma alanının istek ZIP dosyasını indirin. checkpoint.json, timestamp.tsq, SHA256SUMS ve README.txt dosyalarını açın. Kontrol noktası baytlarını değiştirmeyin.
  3. Soruşturmaya uygun bir TSA seçin. timestamp.tsq'yi, belgelenmiş yöntemi kullanılarak, HTTP hizmeti için application/timestamp-query ile birlikte gönderin. Orijinal ikili yanıtı timestamp.tsr olarak kaydedin; uç noktayı, erişim zamanını ve istek sonucunu da kaydedin. İstek, mesajlar yerine bir hash ve nonce içerir; ağ meta verileri yine de isteği ortaya çıkarır.
  4. Yanıtın içeriğinden bağımsız olarak güvenilir kök sertifikayı ve ayrıca gerekli tüm ara sertifikaları edinin. Yanıtta yer alan bir sertifika, sırf orada yer aldığı için güvenilir hale gelmez.
  5. Güvenilir bir TgWitness kurulumundan şunları doğrulayın:
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem

Gerekirse --intermediates tsa-intermediates.pem ekleyin. OpenSSL gerekmez: imza, imzalama sertifikası başvurusu ve zincir, verify.py --tsa-ca ile aynı kod olan cryptography kitaplığıyla Python'da denetlenir. openssl ts -verify, isteyen bir uzman için bağımsız ikinci bir denetim olarak kalır.

  1. Kontrol noktasından sonra, söz konusu önekini içerecek şekilde imzalı bir günlük ZIP dosyasını dışa aktarın. Bağımsız olarak bilinen parmak izini kullanarak doğrulayın:
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json

Bu, dışa aktarımın zaman damgalı önek içerdiğini gösterir. verify.py, kanıt modunun bunları depoladığı ZIP dosyasından yalnızca zaman damgası makbuzlarını okur; manuel yanıt 5. adımda kontrol edilir ve bu kontrol noktasına kadar olan kayıtları kapsar.

  1. ZIP dosyasını, kontrol noktasını, isteği, yanıtı, sertifika zincirini, doğrulama sonuçlarını ve aktarım kaydını toplayıcı dışında saklayın. Alındığında doğrulamayı tekrarlayın.

Kaydedilmiş bir kontrol noktasından bir istek hazırlamak için:

python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip

Hazırlık aşaması, JSON'u kanonikleştirir ve eşleşen kontrol noktasını arşive dahil eder. Giriş dosyasında farklı boşluk karakterleri olsa bile, TSA doğrulaması için o arşivdeki kontrol noktası baytlarını kullanın.

Doğrulama sınırları#

Kontrol et Mevcut davranış
Veriler Kontrol noktası baytlarının tam SHA-256 değeri, yanıtla eşleşmelidir.
Talep --request ile orijinal sorgu ve nonce doğrulanır
TSA imzası İmza, imzalama sertifikası ve açıkça belirtilen CA'ya kadar zinciri, damgalanan zamana göre denetlenir
Toplayıcı imzası Dergi doğrulayıcısı tarafından sabitlenmiş bir anahtarla ayrı olarak doğrulanmıştır
İptal Kanıt modu, verify.py'nin kontrol ettiği OCSP/CRL kanıtlarını depolar
Planlanmış gönderim Kanıt modu, her kurulum hedefinde etkinleştirilir

--request teknik olarak isteğe bağlıdır, ancak verilmezse özgün nonce doğrulanamaz. Bu tam yordamda sonuçtaki request_checked true olmalıdır. Zincirdeki her sertifika damgalanan zamanda geçerli olmalı ve imzalama sertifikası yalnızca zaman damgası için olmalıdır.

TSA yanıtı, gönderilen kontrol noktası baytlarını belirtilen zamana sabitler. Bu sonucu, seçilen mod için toplama kayıtları ve ortam doğrulaması ile karşılaştırın. Kanıt modu, Belçika hükümetinin onaylı TSA'sını içerir (http://tsa.belgium.be/connect; RFC 3161 yanıtları imzalanmıştır, bu nedenle düz HTTP bunların geçerliliğini zayıflatmaz). Bu sağlayıcının kök sertifikası --tsa-ca'ye aktarıldığında, verify.py, onaylı bir eIDAS zaman damgası ve zaman damgalama birimini bildirir; (AB) 910/2014 sayılı Tüzük, 41. maddenin 2. fıkrası, zamanın doğruluğunu ve bağlı verilerin bütünlüğünü varsayar.

İmza sertifikasının iptali#

Her yanıtın hemen ardından, kanıt modu TSA imzalama sertifikası için iptal kanıtını alır: sertifikanın AIA OCSP adresinden bir OCSP yanıtı, aksi takdirde dağıtım noktasından CRL (en fazla 4 MiB). Bu, yanıtın yanında checkpoint-N.<service>.ocsp veya .crl olarak depolanır ve yanıtla birlikte dışa aktarılır. Başarısız bir alma işlemi zaman damgasını asla geciktirmez; anchor.completed kaydı bunu nedeni ile birlikte unavailable olarak listeler.

verify.py, OCSP yanıtının imzasını (düzenleyici tarafından veya düzenleyicinin OCSP imzalama amacıyla verdiği bir yanıtlayıcı sertifikası tarafından), sertifika kimliğini ve durumunu kontrol eder; ayrıca yanıtın genTime tarihinde veya sonrasında verilmiş ya da o tarihte hâlâ geçerli (nextUpdate) olup olmadığını doğrular. Bir CRL için ise düzenleyicinin imzasını, aynı zaman aralığını ve seri numarasının listede yer almadığını kontrol eder. Ardından signing certificate not revoked as of <time> (OCSP|CRL) mesajını, başarısız kontrolü veya revocation not checked (no OCSP/CRL in the archive) mesajını bildirir. genTime tarihinde veya öncesinde iptal edilen bir imzalama sertifikası doğrulamayı geçemez; daha sonraki bir iptal ise uyarı olarak gösterilir.

Kanıt kayıtları ve yenileme (RFC 4998)#

Bir RFC 3161 zaman damgası, yalnızca kendi hash algoritması ile TSA’nın imzalama anahtarı ve sertifikası geçerli olduğu sürece geçerlidir; ancak bir vaka, bunların geçerlilik süresinden daha uzun sürebilir. Kanıt modu ayrıca, saklanan her kontrol noktası için bir RFC 4998 Kanıt Kaydı (ERS) tutar ve bunu yeniler.

Her kanıtlama aşamasında, kaydı bulunmayan kontrol noktaları bir karma ağacına eklenir ve yapılandırılmış TSA’lara kökü üzerinde bir zaman damgası bulunması için sırayla sorgulanır. Her kontrol noktasına checkpoints/anchors/checkpoint-N.ers: EvidenceRecord içinde ArchiveTimeStampSequence içinde bir ArchiveTimeStampChain içerir ArchiveTimeStamp o kontrol noktası için indirgenmiş hash ağacını ve TSA belirtecini taşır. Bir kayıt, komşu kontrol noktalarının hash değerlerini listeleyebilir; EU DSS gibi doğrulayıcılar bu konuda uyarıda bulunur. Bir ASiC-E dışa aktarımı ayrıca META-INF/evidencerecord.ers ile META-INF/ASiCEvidenceRecordManifest.xmlkonteynerin veri nesneleri için kanıt kaydını (ETSI EN 319 162-1) içerir. Bir ZIP dışa aktarma işlemi, kontrol noktası kayıtlarını anchors/.

Yenileme işlemi RFC 4998'in 5. bölümüne uygun olarak gerçekleştirilir ve yalnızca aşağıdakileri ekler:

Yenileme Ne zaman Üzerinde ne yazılıdır?
Zaman damgası yenileme En yeni token’ın imza sertifikasının geçerlilik süresi N ay içinde sona eriyorsa (varsayılan 6), imza hash’i zayıf olarak işaretlenmişse veya talep üzerine Bir önceki tokenin hash değeri, aynı algoritma; damga, zincirin sonuna eklenir
Hash ağacının yenilenmesi Zincirin karma algoritması “zayıf” olarak işaretlenmiştir veya talep üzerine H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) daha güçlü bir algoritma ile (varsayılan SHA-512); yeni bir zincir eklenir

Her yenileme yeni bir dosyaya kaydedilir, checkpoint-N.renewal-K.ers; önceki dosyalar ve zincirler bayt bayt aynı kalır. Kanıt, yalnızca her bağlantı sırayla doğrulanırsa ilk zaman damgasına kadar geriye uzanır; bu nedenle, en yeni belirteç hala geçerliyken yenileme yapın: imza sertifikasının süresi dolmadan, iptal bilgisi ortadan kalkmadan veya hash ya da imza algoritması bozulmadan önce. Daha sonraki bir yenileme bir damga ekler ancak önceki kanıtı uzatmaz.

Kanıt modundaki arka plan döngüsü, politikayı her gün ve talep üzerine kontrol eder (evidence_record.demand_renewal). Her deneme, evidence_record.created veya evidence_record.renewed şeklinde günlüğe kaydedilir; hizmet, zaman, karma algoritması, ağaç kökü, kontrol noktası aralığı, ok ve hatalar; okunamayan kayıtlar evidence_record.check_failed. Başarısız bir TSA, kontrol noktası damgalama geri çekilme süresiyle yeniden denenir ve ayrı olarak sayılır; bu sırada listede bir sonraki TSA denenir. Politika (months_before_expiry, weak_algorithms, algorithm, stronger_algorithm) profil ayarıdır evidence_record_policy; panelin henüz bunun üzerinde herhangi bir kontrolü yoktur.

Toplayıcı, her yeni kaydı yazmadan önce onu kontrol noktası ve TSA’nın imzasıyla karşılaştırır. verify.py Dışa aktarımdaki her kaydı kontrol eder: hash ağaçları, belirteçler, zincirlerin ve yenilemelerin sırası, ve kanıtlanmış en erken zamanı ile en yeni damganın durumunu bildirir. EU DSS, kontrol noktası ile aynı kayıtları ayrı veriler olarak okur.

(AB) 2024/1183 sayılı Tüzük (eIDAS 2.0), (AB) 910/2014 sayılı Tüzüğe nitelikli elektronik arşivleme ve nitelikli elektronik defterleri eklemiştir. TgWitness, kayıtları standart formatlarda yazar ancak bir güven hizmetidir; arşivi ve defterinin nitelikli statüsü bulunmamaktadır. Nitelikli bir sağlayıcının, diğer şartların yanı sıra şunlara sahip olması gerekir:

  • Arşivleme (45i ve 45j. maddeler): Yetkili bir güven hizmeti sağlayıcısı, verileri yasal veya sözleşmeye dayalı saklama süresi boyunca, teknolojik geçerlilik süresinin ötesinde kalıcı ve okunabilir bir şekilde ve kayıp ile tahrifata karşı korunmuş olarak saklar; ayrıca, yetkili güvenen taraflar için, verilerin saklanmaya başlandığı andan geri getirilmesine kadar uzanan otomatik bir bütünlük raporu sunar. 45i(2). madde, bu tür bir hizmet için bütünlük ve menşe varsayımını içerir.
  • Defterler (45k ve 45l. maddeler): Bir veya daha fazla nitelikli güven hizmeti sağlayıcısı tarafından oluşturulan ve yönetilen, kayıtların kaynağını belirleyen, bunları benzersiz ve kronolojik sırayla düzenleyen ve sonradan yapılan değişikliklerin derhal tespit edilebilir olmasını sağlayan bir defter. TgWitness günlüğü, hash zinciriyle birbirine bağlanmış ve toplayıcının kendi anahtarıyla imzalanmıştır; ancak bu, tek başına nitelikli bir defter değildir.
  • Her ikisi de: bir denetim kurumu tarafından verilen yetkili statü ve güvenilir listeye kayıt (21. ve 22. maddeler), 24. maddedeki yükümlülükler, en az 24 ayda bir yapılan uygunluk değerlendirmesi (20. madde) ve 45j(2) ile 45l(2) maddeleri kapsamındaki uygulama düzenlemelerinin referans standartları.

Onaylanmış bir TSA’dan alınan onaylanmış zaman damgaları (41. ve 42. maddeler), her bir token için kendi varsayımlarını korur; yenileme işlemi, kaydın tamamı için yeni bir varsayım oluşturmaz.

Devir teslimi kaydı#

Vaka tanımlayıcısını, göndereni ve alıcıyı, UTC aktarım zamanını ve kaynağını, amacını, dosya adlarını/SHA-256 değerlerini, toplayıcı parmak izini, sıra aralığını, bilinen boşlukları, doğrulayıcı sürümünü ve doğrulama sonucunu kaydedin. Bu kaydı, kuruluşunuzun süreçleri doğrultusunda imzalayın ve bağımsız olarak saklayın. TgWitness’te çok kullanıcılı bir koruma-kayıt sistemi uygulanmamaktadır.

Canlı hizmet kontrolü, 9 Kasım 2026#

Her bir varsayılan hizmete bir adet RFC 3161 isteği gönderildi. Her ikisi de isteği kabul etti.

Hizmet Yanıtla İmzalama birimi Doğrulayıcı sonucu
http://tsa.belgium.be/connect Onaylandı, politika 2.16.56.13.6.3.1.1000 Zaman Damgası Birimi 202301 eIDAS onaylı zaman damgası
https://freetsa.org/tsr Onaylandı FreeTSA RFC 3161 zaman damgası

Belçika imzalı sertifikası, qcStatements uyumluluk beyanını taşır ve doğrulayıcıda kaydedilen birimle eşleşir. Yerel testler ayrıca, değiştirilmiş verilerin, değiştirilmiş nonce'ın ve hatalı CA'nın reddedilmesini kontrol etmek için sentetik bir CA/TSA kullanır.

10 Kasım 2026 tarihinde, yetki devri yapılmış bir yanıtlayıcı sertifikası olan Belçika OCSP yanıtlayıcısı, Zaman Damgası Birimi 202301 için "iyi" yanıtını verdi. FreeTSA'nın OCSP adresi (2560 numaralı bağlantı noktası), test ana bilgisayarından gelen isteğe 40 saniye içinde yanıt vermedi; bunun yerine CRL'si (PEM, 1 KB) kullanıldı.