TgWitness / Dokumentasi

Apa yang telah diuji →

Referensi / Bukti

Telegram · Cap waktu

Stempel waktu RFC 3161 untuk titik pemeriksaan yang ditandatangani: apa yang dikirimkan ke otoritas dan bagaimana responsnya diverifikasi.

TgWitness / Dokumentasi · Bukti dan verifikasi

Bukti & verifikasi

TgWitness menyiapkan permintaan RFC 3161 dan memverifikasi respons otoritas cap waktu (TSA). Prosedur manual ini tidak memilih TSA maupun mengirimkan data; mode bukti melakukan keduanya sesuai jadwal (format bukti). Permintaan yang telah disiapkan belum merupakan bukti cap waktu.

Apa yang diikat oleh bukti tersebut#

Diagram alurPengamatan akun → Rantai SHA-256 dan tanda tangan Ed25519; Rantai SHA-256 dan tanda tangan Ed25519 → Titik pemeriksaan yang ditandatangani; Titik pemeriksaan yang ditandatangani → Hash byte-per-byte dan nonce acak; Hash byte-per-byte dan nonce acak → Permintaan RFC 3161; Permintaan RFC 3161 → TSA Independen; TSA Independen → Tanggapan TSA yang ditandatangani; Titik pemeriksaan yang ditandatangani → Verifikasi data, nonce, dan kepercayaan CA yang eksplisit; Tanggapan TSA yang ditandatangani → Verifikasi data, nonce, dan kepercayaan CA yang eksplisitPengamatan akunRantai SHA-256 dantanda tangan Ed25519Titik pemeriksaan yangditandatanganiHash byte-per-byte dannonce acakPermintaan RFC 3161TSA IndependenTanggapan TSA yangditandatanganiVerifikasi data,nonce, dan kepercayaanCA yang eksplisit
Diagram dalam bentuk teks
  1. Pengamatan akun → Rantai SHA-256 dan tanda tangan Ed25519
  2. Rantai SHA-256 dan tanda tangan Ed25519 → Titik pemeriksaan yang ditandatangani
  3. Titik pemeriksaan yang ditandatangani → Hash byte-per-byte dan nonce acak
  4. Hash byte-per-byte dan nonce acak → Permintaan RFC 3161
  5. Permintaan RFC 3161 → TSA Independen
  6. TSA Independen → Tanggapan TSA yang ditandatangani
  7. Titik pemeriksaan yang ditandatangani → Verifikasi data, nonce, dan kepercayaan CA yang eksplisit
  8. Tanggapan TSA yang ditandatangani → Verifikasi data, nonce, dan kepercayaan CA yang eksplisit

Tanda tangan pengumpul mengikat catatan ke kuncinya. Respons TSA yang tepercaya dapat membuktikan bahwa titik pemeriksaan tertentu telah ada pada waktu yang dinyatakan oleh TSA. Titik pemeriksaan tersebut kemudian dapat mengikat awalan jurnal. Batas waktu atas ini berlaku untuk awalan yang telah dikonfirmasi tersebut; tindakan Telegram individu tetap mempertahankan waktu peristiwa yang tercatat.

Prosedur#

Verifikator jurnal melaporkan langkah mundur dan nilai observed_at yang tidak dapat diurai dalam chronology jika ada, serta menyertakan peringatan dalam keluaran perintahnya. Verifikator ini mempertahankan cap waktu yang ditandatangani dan tetap memeriksa tanda tangannya. Langkah mundur dapat berasal dari koreksi jam, jadi tinjau hal ini dengan catatan jam tuan rumah. Waktu independen berasal dari cap waktu eksternal yang terverifikasi, posting saksi yang dibaca dari halaman t.me publik mereka, dan putaran drand; --strict mengatur penentuan penandatangan dan format yang didukung.

Nilai drand yang direkam menjalani pemeriksaan konsistensi struktural dan hash secara offline. --check-drand membandingkan putaran yang direkam yang dipilih dengan respons relai HTTPS; hasilnya menyatakan berapa banyak putaran yang dibandingkan dan relai mana yang merespons, serta putaran yang dibandingkan memberikan batas waktu bawah yang terotentikasi.

  1. Simpan sidik jari kunci pengumpul melalui saluran tepercaya terpisah; sidik jari ini mengidentifikasi pengumpul secara independen dari berkas ZIP yang diperiksa.
  2. Di Ekspor → Siapkan permintaan cap waktu, unduh berkas ZIP permintaan dari ruang kerja yang dipilih. Ekstrak checkpoint.json, timestamp.tsq, SHA256SUMS, dan README.txt. Jangan ubah byte titik pemeriksaan.
  3. Pilih TSA yang sesuai dengan penyelidikan. Kirimkan timestamp.tsq menggunakan metode yang terdokumentasi, dengan application/timestamp-query untuk layanan HTTP. Simpan balasan biner asli sebagai timestamp.tsr, beserta titik akhir, waktu pengambilan, dan hasil permintaan. Permintaan tersebut berisi hash dan nonce, bukan pesan; metadata jaringan tetap mengungkapkan permintaan tersebut.
  4. Peroleh sertifikat akar tepercaya secara terpisah dari balasan, beserta sertifikat perantara yang diperlukan. Sertifikat yang terdapat dalam balasan tidak otomatis menjadi tepercaya hanya karena disertakan di sana.
  5. Dari instalasi TgWitness yang tepercaya, verifikasi:
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem

Tambahkan --intermediates tsa-intermediates.pem bila perlu. OpenSSL tidak diperlukan: tanda tangan, referensi sertifikat penanda tangan, dan rantainya diperiksa di Python dengan pustaka cryptography, kode yang sama dengan yang dipakai verify.py --tsa-ca. openssl ts -verify tetap menjadi pemeriksaan kedua yang independen bagi ahli yang menginginkannya.

  1. Ekspor ZIP jurnal yang telah ditandatangani setelah titik pemeriksaan sehingga mencakup awalan tersebut. Verifikasi menggunakan sidik jari yang diketahui secara independen:
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json

Hal ini menunjukkan bahwa ekspor tersebut berisi awalan bertanda waktu. verify.py hanya membaca tanda terima bertanda waktu dari ZIP, tempat mode bukti menyimpannya; balasan manual diperiksa pada langkah ke-5 dan mencakup catatan hingga titik pemeriksaan ini.

  1. Simpan ZIP, titik pemeriksaan, permintaan, balasan, rantai sertifikat, hasil verifikasi, dan catatan serah terima di luar pengumpul. Lakukan verifikasi ulang saat penerimaan.

Untuk menyiapkan permintaan dari titik pemeriksaan yang disimpan:

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

Proses persiapan ini menstandarkan JSON dan menyertakan titik pemeriksaan yang sesuai ke dalam arsip. Gunakan byte titik pemeriksaan dari arsip tersebut untuk verifikasi TSA, meskipun berkas masukan memiliki spasi kosong yang berbeda.

Batasan verifikasi#

Periksa Perilaku saat ini
Data Nilai SHA-256 dari byte titik pemeriksaan yang tepat harus sesuai dengan respons
Permintaan Dengan --request, kueri asli dan nonce diverifikasi
Tanda tangan TSA Tanda tangan, sertifikat penanda tangan, dan rantainya hingga CA yang ditentukan diperiksa pada waktu stempel
Tanda tangan pengumpul Diverifikasi secara terpisah oleh verifikator jurnal dengan kunci yang disematkan
Pencabutan Mode bukti menyimpan bukti OCSP/CRL yang diperiksa oleh verify.py
Pengiriman terjadwal Mode Bukti, diaktifkan oleh setiap tujuan pengaturan

--request secara teknis opsional, tetapi tanpanya nonce asli tidak dapat diverifikasi. Untuk prosedur lengkap ini, request_checked pada hasil harus true. Setiap sertifikat dalam rantai harus berlaku pada waktu stempel, dan sertifikat penanda tangan hanya boleh untuk stempel waktu.

Respons TSA mengaitkan byte checkpoint yang dikirimkan dengan waktu yang dinyatakan. Tinjau hasil tersebut dengan catatan akuisisi dan verifikasi lingkungan untuk mode yang dipilih. Mode bukti mencakup TSA terakreditasi pemerintah Belgia http://tsa.belgium.be/connect; balasan RFC 3161 ditandatangani, sehingga HTTP biasa tidak melemahkan keamanannya). Dengan akar penyedia tersebut diteruskan ke --tsa-ca, verify.py melaporkan cap waktu eIDAS yang memenuhi syarat beserta unit pencapannya; Peraturan (UE) No. 910/2014, pasal 41(2), mengasumsikan keakuratan waktunya dan integritas data yang terikat.

Pencabutan sertifikat penandatanganan#

Segera setelah setiap balasan, mode bukti mengambil bukti pencabutan untuk sertifikat penandatanganan TSA: respons OCSP dari alamat OCSP AIA sertifikat tersebut, atau CRL dari titik distribusinya (paling banyak 4 MiB). Bukti ini disimpan bersama balasan sebagai checkpoint-N.<service>.ocsp atau .crl dan diekspor bersamanya. Pengambilan yang gagal tidak pernah menunda cap waktu; catatan anchor.completed mencantumkannya sebagai unavailable beserta alasannya.

verify.py memeriksa tanda tangan respons OCSP (oleh penerbit, atau oleh sertifikat penanggap yang diberikan penerbit untuk tujuan penandatanganan OCSP), ID sertifikat, dan statusnya, serta memastikan bahwa jawaban tersebut diterbitkan pada atau setelah genTime atau masih berlaku saat itu (nextUpdate). Untuk CRL, program ini memeriksa tanda tangan penerbit, jendela waktu yang sama, dan memastikan nomor seri tidak terdaftar. Kemudian, skrip ini melaporkan signing certificate not revoked as of <time> (OCSP|CRL), pemeriksaan yang gagal, atau revocation not checked (no OCSP/CRL in the archive). Sertifikat penandatanganan yang dicabut pada atau sebelum genTime gagal verifikasi; pencabutan yang terjadi setelahnya ditampilkan sebagai peringatan.

Catatan bukti dan perpanjangan (RFC 4998)#

Cap waktu RFC 3161 hanya berlaku selama algoritma hash-nya serta kunci penandatanganan dan sertifikat TSA masih berlaku, dan suatu kasus dapat berlangsung lebih lama dari masa berlaku elemen-elemen tersebut. Mode bukti juga menyimpan Catatan Bukti RFC 4998 (ERS) untuk setiap titik pemeriksaan yang disimpan dan memperbaruinya.

Pada setiap putaran verifikasi, titik pemeriksaan yang belum memiliki catatan dimasukkan ke dalam pohon hash, dan TSA yang telah dikonfigurasi diminta secara berurutan untuk memberikan satu cap waktu pada akar pohon tersebut. Setiap titik pemeriksaan mendapatkan checkpoints/anchors/checkpoint-N.ers: sebuah EvidenceRecord yang ArchiveTimeStampSequence berisi satu ArchiveTimeStampChain dengan ArchiveTimeStamp yang membawa pohon hash yang telah dipersingkat untuk titik pemeriksaan tersebut serta token TSA. Sebuah catatan dapat mencantumkan hash dari titik pemeriksaan yang berdekatan; validator seperti EU DSS memberikan peringatan mengenai hal ini. Ekspor ASiC-E juga membawa META-INF/evidencerecord.ers bersama META-INF/ASiCEvidenceRecordManifest.xml, catatan bukti untuk objek data wadah (ETSI EN 319 162-1). Ekspor ZIP membawa catatan titik pemeriksaan di bawah anchors/.

Perpanjangan ini mengikuti RFC 4998 bagian 5 dan hanya menambahkan:

Perpanjangan Ketika Apa yang dicap
Perpanjangan cap waktu Sertifikat penandatanganan token terbaru akan kedaluwarsa dalam N bulan (secara default 6), hash tanda tangannya ditandai sebagai lemah, atau atas permintaan Hash dari token sebelumnya, menggunakan algoritma yang sama; cap tersebut ditambahkan ke rantai terakhir
Pembaruan pohon hash Algoritma hash rantai tersebut dinilai lemah, atau berdasarkan permintaan H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) dengan algoritma yang lebih kuat (SHA-512 sebagai default); rantai baru ditambahkan

Setiap pembaruan disimpan ke berkas baru, checkpoint-N.renewal-K.ers; file dan rantai sebelumnya tetap sama byte demi byte. Bukti tersebut dapat ditelusuri hingga cap waktu pertama hanya jika setiap tautan terverifikasi secara berurutan, jadi lakukan pembaruan selagi token terbaru masih valid: sebelum sertifikat penandatanganannya kedaluwarsa, informasi pencabutannya hilang, atau algoritma hash atau tanda tangannya rusak. Pembaruan selanjutnya menambahkan cap waktu tetapi tidak memperpanjang bukti sebelumnya.

Loop latar belakang mode bukti memeriksa kebijakan tersebut setiap hari dan atas permintaan (evidence_record.demand_renewal). Setiap upaya dicatat dalam jurnal sebagai evidence_record.created atau evidence_record.renewed bersama dengan layanan, waktu, algoritma hash, akar pohon, rentang titik pemeriksaan, ok dan kesalahan; catatan yang tidak dapat dibaca dialihkan ke evidence_record.check_failed. TSA yang gagal akan dicoba kembali dengan penundaan penandaan titik pemeriksaan, yang dihitung secara terpisah, sementara TSA berikutnya dalam daftar akan dicoba. Kebijakan (months_before_expiry, weak_algorithms, algorithm, stronger_algorithm) adalah pengaturan profil evidence_record_policy; panel belum memiliki kontrol untuk hal tersebut.

Pengumpul memeriksa setiap catatan baru dengan membandingkannya terhadap titik pemeriksaan dan tanda tangan TSA sebelum menuliskannya. verify.py memverifikasi setiap catatan dalam ekspor: pohon hash, token, urutan rantai dan perpanjangan, serta melaporkan waktu terawal yang terverifikasi dan status cap terbaru. EU DSS membaca catatan yang sama bersama titik pemeriksaan sebagai data terpisah.

Peraturan (UE) 2024/1183 (eIDAS 2.0) menambahkan pengarsipan elektronik yang memenuhi syarat dan buku besar elektronik yang memenuhi syarat ke dalam Peraturan (UE) No. 910/2014. TgWitness menyimpan catatan dalam format standar, namun bukan merupakan layanan kepercayaan; arsip dan buku besarnya tidak memiliki status yang memenuhi syarat. Penyedia yang memenuhi syarat harus, antara lain:

  • Pengarsipan (Pasal 45i dan 45j): penyedia layanan kepercayaan yang memenuhi syarat menyimpan data selama masa penyimpanan yang ditetapkan secara hukum atau kontrak, dalam bentuk yang tahan lama dan dapat dibaca bahkan setelah masa berlaku teknologisnya berakhir, serta terlindungi dari kehilangan dan perubahan, disertai laporan integritas otomatis bagi pihak yang mengandalkan layanan tersebut yang berwenang, mulai dari awal penyimpanan hingga pengambilan data. Pasal 45i(2) mengasumsikan integritas dan asal-usul data untuk layanan semacam itu.
  • Buku Besar (Pasal 45k dan 45l): sebuah buku besar yang dibuat dan dikelola oleh satu atau lebih penyedia layanan perwalian yang memenuhi syarat, yang menetapkan asal-usul catatan, mengurutkannya secara unik dan secara kronologis, serta membuat perubahan yang dilakukan kemudian dapat segera terdeteksi. Jurnal TgWitness dihubungkan melalui rantai hash dan ditandatangani dengan kunci milik pengumpul itu sendiri, yang dengan sendirinya bukanlah sebuah buku besar yang memenuhi syarat.
  • Keduanya: status terakreditasi yang diberikan oleh badan pengawas dan pencantuman dalam daftar tepercaya (Pasal 21 dan 22), kewajiban sebagaimana dimaksud dalam Pasal 24, penilaian kesesuaian setidaknya setiap 24 bulan (Pasal 20) serta standar rujukan dari peraturan pelaksana berdasarkan Pasal 45j ayat (2) dan Pasal 45l ayat (2).

Cap waktu yang memenuhi syarat dari TSA yang memenuhi syarat (Pasal 41 dan 42) mempertahankan anggapan hukumnya masing-masing per token; perpanjangan tidak menciptakan anggapan hukum baru untuk catatan secara keseluruhan.

Catatan serah terima#

Catat pengenal kasus, pengirim dan penerima, waktu pengiriman UTC beserta sumbernya, tujuan, nama file/nilai SHA-256, sidik jari pengumpul, rentang urutan, celah yang diketahui, versi verifikator, dan hasil verifikasi. Tandatangani dan simpan catatan ini secara independen melalui proses organisasi Anda. Sistem catatan penyimpanan multi-pengguna tidak diimplementasikan dalam TgWitness.

Pemeriksaan layanan langsung, 9 November 2026#

Satu permintaan RFC 3161 dikirimkan ke setiap layanan default. Keduanya menyetujuinya.

Layanan Balas Unit penandatanganan Hasil verifikasi
http://tsa.belgium.be/connect Disetujui, kebijakan 2.16.56.13.6.3.1.1000 Unit Cap Waktu 202301 Cap waktu eIDAS yang memenuhi syarat
https://freetsa.org/tsr Disetujui FreeTSA Cap waktu RFC3161

Sertifikat penandatanganan Belgia memuat pernyataan kepatuhan qcStatements dan sesuai dengan unit yang tercatat di verifikator. Pengujian lokal juga menggunakan CA/TSA sintetis untuk memverifikasi penolakan terhadap data yang diubah, nonce yang diubah, dan CA yang salah.

Pada tanggal 10 November 2026, responder OCSP Belgia, yaitu sertifikat responder yang didelegasikan, menjawab "good" untuk Unit Timestamp 202301. Alamat OCSP FreeTSA (port 2560) tidak merespons dalam waktu 40 detik dari host pengujian; sebagai gantinya, CRL-nya (PEM, 1 KB) digunakan.