# Telegram · Cap masa

Canonical page: https://phishdestroy.io/tgwitness/ms/docs/reference/timestamp/

Cap masa RFC 3161 untuk checkpoint berasingan: apa yang dihantar kepada pihak berkuasa dan bagaimana respons disahkan.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/ms/llms.txt)

Cap masa RFC 3161 untuk checkpoint berasingan: apa yang dihantar kepada pihak berkuasa dan bagaimana respons disahkan.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bukti dan pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/)

![Bukti & pengesahan](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

TgWitness menyediakan permintaan RFC 3161 dan mengesahkan respons pihak berkuasa cap masa (TSA). Prosedur manual ini tidak memilih TSA mahupun menghantar data; mod bukti melakukan kedua-duanya mengikut jadual ([format bukti](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)). Permintaan yang telah disediakan **belum lagi** merupakan **bukti cap masa**.

## Apa yang bukti ikat

Diyagram aliran · Perhatian akaun → Rantaian SHA-256 dan tandatangan Ed25519; Rantaian SHA-256 dan tandatangan Ed25519 → Pemeriksaan berasingan yang ditandatangani; Pemeriksaan berasingan yang ditandatangani → Hash bait tepat dan nonse rawak; Hash bait tepat dan nonse rawak → Permintaan RFC 3161; Permintaan RFC 3161 → TSA Bebas; TSA Bebas → Tindak balas TSA yang disahkan; Pemeriksaan berasingan yang ditandatangani → Verifikasi data, nonce dan kepercayaan CA yang eksplisit; Tindak balas TSA yang disahkan → Verifikasi data, nonce dan kepercayaan CA yang eksplisit · Perhatian akaun · Rantaian SHA-256 dantandatangan Ed25519 · Pemeriksaan berasinganyang ditandatangani · Hash bait tepat dannonse rawak · Permintaan RFC 3161 · TSA Bebas · Tindak balas TSA yangdisahkan · Verifikasi data, noncedan kepercayaan CAyang eksplisit

**Diagram sebagai teks**

1. Perhatian akaun → Rantaian SHA-256 dan tandatangan Ed25519
2. Rantaian SHA-256 dan tandatangan Ed25519 → Pemeriksaan berasingan yang ditandatangani
3. Pemeriksaan berasingan yang ditandatangani → Hash bait tepat dan nonse rawak
4. Hash bait tepat dan nonse rawak → Permintaan RFC 3161
5. Permintaan RFC 3161 → TSA Bebas
6. TSA Bebas → Tindak balas TSA yang disahkan
7. Pemeriksaan berasingan yang ditandatangani → Verifikasi data, nonce dan kepercayaan CA yang eksplisit
8. Tindak balas TSA yang disahkan → Verifikasi data, nonce dan kepercayaan CA yang eksplisit

Tandatangan pengumpul mengikat rekod kepada kuncinya. Respons TSA yang dipercayai boleh membuktikan bahawa satu titik pemeriksaan tertentu wujud pada masa yang dinyatakan oleh TSA. Titik pemeriksaan itu kemudiannya boleh mengikat awalan jurnal. Had masa atas ini terpakai kepada awalan yang telah dikomit itu; tindakan Telegram individu mengekalkan masa peristiwa yang direkodkan mereka.

## Prosedur

Pemverifikasi jurnal melaporkan langkah mundur dan nilai `observed_at` yang tidak dapat diparsing dalam `chronology` apabila wujud, dan menyertakan amaran dalam keluaran perintahnya. Ia mengekalkan cap masa yang disahkan dan masih memeriksa tandatangan mereka. Langkah mundur boleh berpunca daripada pembetulan jam, jadi semak ia dengan rekod jam hos. Masa bebas datang daripada cap masa luaran yang disahkan, kiriman saksi yang dibaca daripada halaman t.me awam mereka dan pusingan drand; `--strict` mengawal pin penandatangan dan format yang disokong.

Nilai drand yang direkodkan menjalani pemeriksaan konsistensi struktur dan hash secara luar talian. `--check-drand` membandingkan pusingan yang direkodkan terpilih dengan respons relai HTTPS; hasilnya menyatakan berapa banyak pusingan telah dibandingkan dan relai mana yang menjawab, dan pusingan yang dibandingkan menyediakan had masa minimum yang disahkan.

1. Pelihara cap jari kunci pengumpul melalui saluran dipercayai berasingan; ia mengenal pasti pengumpul secara bebas daripada ZIP yang diperiksa.
2. Di **Eksport → Sediakan permintaan cap masa**, muat turun ZIP permintaan ruang kerja yang dipilih. Ekstrak `checkpoint.json`, `timestamp.tsq`, `SHA256SUMS` dan `README.txt`. Jangan ubah bait checkpoint.
3. Pilih TSA yang sesuai untuk siasatan. Hantar `timestamp.tsq` menggunakan kaedah yang didokumenkan, dengan `application/timestamp-query` untuk perkhidmatan HTTP. Simpan balasan binari asal sebagai `timestamp.tsr`, titik akhir, masa pemulihan dan keputusan permintaan. Permintaan mengandungi hash dan nonce bukannya mesej; metadata rangkaian masih mendedahkan permintaan tersebut.
4. Dapatkan sijil akar yang dipercayai secara bebas daripada balasan, serta mana-mana sijil perantara yang diperlukan. Sijil dalam balasan tidak menjadi dipercayai semata-mata kerana ia disertakan di sana.
5. Daripada pemasangan TgWitness yang dipercayai, sahkan:

```
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem
```

Tambah `--intermediates tsa-intermediates.pem` jika perlu. OpenSSL tidak diperlukan: tandatangan, rujukan sijil penandatanganan dan rantaian disemak dalam Python dengan pustaka `cryptography`, kod yang sama digunakan oleh `verify.py --tsa-ca`. `openssl ts -verify` kekal sebagai semakan kedua yang bebas bagi pakar yang mahukannya.

1. Eksport fail ZIP jurnal yang ditandatangani selepas penanda aras supaya ia termasuk awalan tersebut. Sahkan menggunakan cap jari yang diketahui secara bebas:

```
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json
```

Ini menunjukkan bahawa eksport mengandungi awalan yang mempunyai cop masa. `verify.py` membaca resit cop masa hanya daripada ZIP, di mana mod bukti menyimpannya; balasan manual diperiksa pada langkah 5 dan merangkumi rekod sehingga ke titik pemeriksaan ini.

1. Pelihara fail ZIP, titik pemeriksaan, permintaan, balasan, rantaian sijil, keputusan pengesahan dan rekod penyerahan di luar pengumpul. Ulang pengesahan apabila diterima.

Untuk menyediakan permintaan daripada titik pemeriksaan yang disimpan:

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

Persiapan mengkanonikan JSON dan memasukkan checkpoint yang sepadan dalam arkib. Gunakan **bait checkpoint daripada arkib tersebut** untuk pengesahan TSA, walaupun fail input mempunyai ruang kosong yang berbeza.

## Batas pengesahan

| Semak | Tingkah laku semasa |
| --- | --- |
| Data | SHA-256 bagi bait checkpoint tepat mesti sepadan dengan respons |
| Permintaan | Dengan `--request`, pertanyaan asal dan nonce disahkan |
| Tandatangan TSA | Tandatangan, sijil penandatanganan dan rantaiannya hingga CA yang dinyatakan disemak pada masa cap |
| Tandatangan pengumpul | Disahkan secara berasingan oleh pengesah jurnal dengan kunci yang dipasang |
| Pencabutan | Mod bukti menyimpan bukti OCSP/CRL yang diperiksa oleh `verify.py` |
| Penghantaran dijadualkan | Mod bukti, diaktifkan oleh setiap matlamat penyediaan |

`--request` secara teknikal adalah pilihan, tetapi tanpanya nonce asal tidak dapat disahkan. Untuk prosedur penuh ini, `request_checked` dalam keputusan mesti true. Setiap sijil dalam rantaian mesti sah pada masa cap, dan sijil penandatanganan mesti untuk cap masa sahaja.

Tindak balas TSA mengikat bait checkpoint yang dihantar kepada masanya yang dinyatakan. Semak keputusan itu dengan rekod pemerolehan dan pengesahan persekitaran untuk mod yang dipilih. Mod bukti termasuk TSA bertauliah kerajaan Belgium (`http://tsa.belgium.be/connect`; respons RFC 3161 ditandatangani, jadi HTTP biasa tidak melemahkannya). Dengan root penyedia itu dihantar kepada `--tsa-ca`, `verify.py` melaporkan cop masa eIDAS yang berkelayakan dan unit pencop masaannya; Peraturan (EU) No 910/2014, artikel 41(2), menganggap ketepatan masanya dan integriti data yang diikat.

### Pencabutan sijil tandatangan

Segera selepas setiap balasan, mod bukti mengambil bukti pembatalan untuk sijil tandatangan TSA: respons OCSP daripada alamat OCSP AIA sijil tersebut, jika tidak CRL daripada titik pengedaran (maksimum 4 MiB). Ia disimpan di sebelah balasan sebagai `checkpoint-N.<service>.ocsp` atau `.crl` dan dieksport bersamanya. Pengambilan yang gagal tidak pernah menangguhkan cop masa; rekod `anchor.completed` menyenaraikannya sebagai `unavailable` dengan sebab.

`verify.py` memeriksa tandatangan respons OCSP (oleh penerbit, atau oleh sijil penanggapi yang diberikan penerbit untuk tujuan menandatangani OCSP), ID sijil dan status, dan bahawa jawapan itu dikeluarkan pada atau selepas genTime atau masih sah pada masa itu (nextUpdate). Untuk CRL ia memeriksa tandatangan penerbit, tetingkap masa yang sama dan bahawa nombor siri tidak disenaraikan. Ia kemudian melaporkan `signing certificate not revoked as of <time> (OCSP|CRL)`, pemeriksaan yang gagal, atau `revocation not checked (no OCSP/CRL in the archive)`. Sijil tandatangan yang dibatalkan pada atau sebelum genTime gagal pengesahan; pembatalan kemudian dipaparkan sebagai amaran.

## Rekod bukti dan pembaharuan (RFC 4998)

Cap masa RFC 3161 hanya sah selagi algoritma hashnya, kunci tandatangan dan sijil TSA, dan satu kes boleh bertahan lebih lama daripada mereka. Mod bukti juga menyimpan Rekod Bukti RFC 4998 (ERS) untuk setiap titik pemeriksaan yang disimpan dan memperbaharui ia.

Pada setiap pusingan bukti, checkpoint yang tiada rekod dimasukkan ke dalam pokok hash, dan TSA yang dikonfigurasikan diminta secara berurutan untuk satu cop masa pada akarnya. Setiap checkpoint mendapat `checkpoints/anchors/checkpoint-N.ers`: an `EvidenceRecord` yang `ArchiveTimeStampSequence` mengandungi satu `ArchiveTimeStampChain` dengan `ArchiveTimeStamp` membawa pokok hash yang dikurangkan untuk checkpoint tersebut dan token TSA. Satu rekod boleh menyenaraikan hash checkpoint bersebelahan; pengesah seperti EU DSS memberi amaran tentang perkara ini. Eksport ASiC-E juga membawa `META-INF/evidencerecord.ers` dengan `META-INF/ASiCEvidenceRecordManifest.xml`, rekod bukti untuk objek data kontena (ETSI EN 319 162-1). Eksport ZIP membawa rekod checkpoint di bawah `anchors/`.

Pembaharuan mengikut RFC 4998 seksyen 5 dan hanya menambah:

| Pembaharuan | Apabila | Apa yang dicop |
| --- | --- | --- |
| Pembaharuan cap masa | Sijil tandatangan token terbaru akan tamat dalam N bulan (laluan lalai 6), has tanda tangannya ditandakan lemah, atau atas permintaan | Skrip token sebelumnya, algoritma yang sama; cap ditambah pada rantaian terakhir |
| Pembaharuan hash-tree | Algoritma hash rantaian itu ditandakan lemah, atau atas permintaan | `H(H(checkpoint) + H(previous ArchiveTimeStampSequence))` dengan algoritma yang lebih kuat (SHA-512 lalai); satu rantaian baharu ditambah |

Setiap pembaharuan dibuat dalam fail baru, `checkpoint-N.renewal-K.ers`; fail-fail dan rantaian terdahulu kekal sama bait demi bait. Bukti hanya sah sehingga cop masa pertama jika setiap pautan diperiksa mengikut urutan, jadi perbaharui selagi token terkini masih sah: sebelum sijil tandatanganannya tamat tempoh, maklumat pembatalannya hilang atau algoritma suai ukur atau tandatanganannya rosak. Pembaharuan kemudian menambah satu cop tetapi tidak memanjangkan bukti terdahulu.

Gelung latar belakang mod bukti memeriksa dasar setiap hari dan atas permintaan (`evidence_record.demand_renewal`). Setiap percubaan direkodkan sebagai `evidence_record.created` atau `evidence_record.renewed` dengan perkhidmatan, masa, algoritma hash, akar pokok, julat checkpoint, `ok` dan ralat; rekod yang tidak dapat dibaca dihantar ke `evidence_record.check_failed`. TSA yang gagal dicuba semula dengan selang penapisan cop checkpoint, dikira secara berasingan, sementara TSA seterusnya yang tersenarai dicuba. Dasar (`months_before_expiry`, `weak_algorithms`, `algorithm`, `stronger_algorithm`) adalah tetapan profil `evidence_record_policy`; panel belum mempunyai kawalan untuknya.

Pengumpul menyemak setiap rekod baru dengan titik pemeriksaan dan tandatangan TSA sebelum menulisnya. `verify.py` memeriksa setiap rekod dalam eksport: pokok hash, token, susunan rantaian dan pembaharuan, dan melaporkan masa terawal yang terbukti dan keadaan setem terbaru. EU DSS membaca rekod yang sama dengan titik pemeriksaan sebagai data terpisah.

Peraturan (EU) 2024/1183 (eIDAS 2.0) menambah arkib elektronik bertauliah dan ledger elektronik bertauliah kepada Peraturan (EU) No 910/2014. TgWitness merekodkan rekod dalam format piawai tetapi bukan perkhidmatan dipercayai; arkib dan jurnalnya tidak mempunyai status bertauliah. Penyedia bertauliah perlu, antara lain:

- Pengarkiban (Artikel 45i dan 45j): penyedia perkhidmatan amanah bertauliah yang menyimpan data untuk tempoh pemeliharaan undang-undang atau kontrak, tahan lama dan boleh dibaca melebihi tempoh kesahihan teknologi serta dilindungi daripada kehilangan dan pengubahsuaian, dengan laporan integriti automatik untuk pihak bergantung yang dibenarkan dari permulaan pemeliharaan hingga pemulihan. Artikel 45i(2) menganggap integriti dan asal usul bagi perkhidmatan sedemikian.
- Buku besar (Artikel 45k dan 45l): sebuah buku besar yang dicipta dan diuruskan oleh satu atau lebih penyedia perkhidmatan amanah yang berkelayakan yang menetapkan asal rekod, menyusunnya secara unik dan kronologi, serta membolehkan perubahan kemudian dikesan dengan segera. Jurnal TgWitness diikat secara hash dan ditandatangani dengan kunci pengumpul sendiri, yang sendirian tidak merupakan buku besar yang berkelayakan.
- Kedua-duanya: status berkelayakan yang diberikan oleh badan pengawasan dan kemasukan dalam senarai dipercayai (Artikel 21 dan 22), kewajipan di bawah Artikel 24, penilaian kesesuaian sekurang-kurangnya setiap 24 bulan (Artikel 20) dan piawaian rujukan bagi akta pelaksanaan di bawah Artikel 45j(2) dan 45l(2).

Cop masa yang layak daripada TSA yang layak (Artikel 41 dan 42) mengekalkan andaian tersendiri bagi setiap token; pembaharuan tidak mewujudkan satu andaian bagi keseluruhan rekod.

## Rekod penyerahan

Rakam pengecam kes, penghantar dan penerima, masa pemindahan UTC dan sumbernya, tujuan, nama fail/nilai SHA-256, cap jari pengumpul, julat urutan, jurang yang diketahui, versi pengesah dan keputusan pengesahan. Tandatangani dan simpan rekod ini secara berasingan melalui proses organisasi anda. Sistem rekod pemilikan pelbagai pengguna tidak dilaksanakan dalam TgWitness.

## Semakan perkhidmatan langsung, 9 November 2026

Satu permintaan RFC 3161 telah dihantar ke setiap perkhidmatan lalai. Kedua-duanya meluluskannya.

| Perkhidmatan | Balas | Unit tandatangan | Hasil pengesah |
| --- | --- | --- | --- |
| `http://tsa.belgium.be/connect` | Diberi, dasar 2.16.56.13.6.3.1.1000 | Unit Cap Masa 202301 | Cop masa eIDAS yang berkelayakan |
| `https://freetsa.org/tsr` | Diberi | FreeTSA | Cap masa RFC 3161 |

Sijil tandatangan Belgium memaparkan kenyataan pematuhan qcStatements dan sepadan dengan unit yang direkodkan dalam pengesah. Ujian tempatan juga menggunakan CA/TSA sintetik untuk memeriksa penolakan data yang diubah, nonce yang diubah dan CA yang salah.

Pada 10 November 2026 penjawab OCSP Belgium, sijil penjawab yang diwakilkan, menjawab "baik" untuk Unit Cap Masa 202301. Alamat OCSP FreeTSA (port 2560) tidak memberi maklum balas dalam 40 saat dari hos ujian; CRL-nya (PEM, 1 KB) telah digunakan sebaliknya.
