TgWitness / 文件說明

已測試的內容 →

參考資料 / 證據

Telegram · 時間戳記

簽名檢查點的 RFC 3161 時間戳記:傳送至授權機構的內容,以及如何驗證回應。

TgWitness / 文件說明 · 證據與驗證

證據與驗證

TgWitness 會準備 RFC 3161 請求,並驗證時間戳記授權機構(TSA)的回應。 此手動程序既不會選擇 TSA,也不會提交資料;而「證據模式」則會依照 預定時程(證據格式)同時執行這兩項操作。已準備好的請求 尚不構成 時間戳記證明。

證據的約束力#

流程圖帳戶觀察 → SHA-256 鏈與 Ed25519 簽名; SHA-256 鏈與 Ed25519 簽名 → 簽名檢查點; 簽名檢查點 → 精確至位元的雜湊值與隨機非ce值; 精確至位元的雜湊值與隨機非ce值 → RFC 3161 請求; RFC 3161 請求 → 獨立 TSA; 獨立 TSA → 經簽署的 TSA 回應; 簽名檢查點 → 驗證資料、隨機數及明確的憑證授權機構(CA)信任關係; 經簽署的 TSA 回應 → 驗證資料、隨機數及明確的憑證授權機構(CA)信任關係帳戶觀察SHA-256 鏈與 Ed25519簽名簽名檢查點精確至位元的雜湊值與隨機非ce值RFC 3161 請求獨立 TSA經簽署的 TSA 回應驗證資料、隨機數及明確的憑證授權機構(CA)信任關係
圖表轉為文字
  1. 帳戶觀察 → SHA-256 鏈與 Ed25519 簽名
  2. SHA-256 鏈與 Ed25519 簽名 → 簽名檢查點
  3. 簽名檢查點 → 精確至位元的雜湊值與隨機非ce值
  4. 精確至位元的雜湊值與隨機非ce值 → RFC 3161 請求
  5. RFC 3161 請求 → 獨立 TSA
  6. 獨立 TSA → 經簽署的 TSA 回應
  7. 簽名檢查點 → 驗證資料、隨機數及明確的憑證授權機構(CA)信任關係
  8. 經簽署的 TSA 回應 → 驗證資料、隨機數及明確的憑證授權機構(CA)信任關係

收集器的簽名將記錄與其金鑰綁定。可信的 TSA 回應可 證明特定檢查點在 TSA 所聲明的時間點確實存在。該 檢查點隨後可綁定日誌前綴。此上界時間限制適用於 該已提交的前綴;個別 Telegram 動作則保留其記錄的事件時間。

操作流程#

日誌驗證器會回報observed_at中的倒退步驟及無法解析的值 (若存在於chronology中),並在其命令輸出中包含警告訊息。它 會保留簽名時間戳記,並仍會檢查其簽名。倒退步驟 可能源自時鐘校正,因此請參照主機的時鐘記錄進行審查。 獨立時間來源於經過驗證的外部時間戳記、從 其公開 t.me 頁面讀取的見證貼文,以及 drand 運算輪次;--strict 控制簽署者釘選與 支援的格式。

記錄的 drand 值會離線進行結構與雜湊自一致性檢查。 --check-drand 會將選定的記錄輪次與 HTTPS 中繼回應進行比對; 結果會顯示已比對的輪次數量及回應的中繼站,而 比對過的輪次則提供經認證的下限時間。

  1. 透過獨立的可信通道保留收集器的金鑰指紋;該指紋 可獨立於受檢 ZIP 檔案之外,識別出該收集器。
  2. 在「匯出」→「準備時間戳記請求」中,下載所選工作區的 請求 ZIP 檔案。解壓縮 checkpoint.json、timestamp.tsq、SHA256SUMS 及 README.txt。請勿變更檢查點位元組。
  3. 選擇適合該調查的 TSA。透過其 文件中記載的方法提交 timestamp.tsq,並使用 application/timestamp-query 進行 HTTP 服務。 將原始二進位回應儲存為 timestamp.tsr,並記錄端點、擷取時間 及請求結果。該請求包含雜湊值與隨機數,而非訊息內容; 網路元資料仍會揭露該請求。
  4. 請獨立於回覆之外取得受信任的根憑證,以及任何 所需的中間憑證。回覆中的憑證不會僅因 被包含在其中而自動成為受信任憑證。
  5. 透過可信賴的 TgWitness 安裝環境,驗證:
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem

如有需要,請加入 --intermediates tsa-intermediates.pem。不需要 OpenSSL:簽章、簽章憑證參照和憑證鏈都在 Python 中由 cryptography 函式庫檢查,與 verify.py --tsa-ca 使用的程式碼相同。openssl ts -verify 仍可作為專家需要時的獨立第二次檢查。

  1. 在檢查點之後匯出經簽署的日誌 ZIP 檔案,使其包含該前綴。 請使用獨立已知的指紋進行驗證:
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json

這顯示匯出檔案包含帶有時間戳記的前綴。verify.py 僅從 ZIP 檔案中讀取 時間戳記收據,因為證據模式會將其儲存於該處;手動 回覆會在步驟 5 進行檢查,並涵蓋至此檢查點為止的記錄。

  1. 將 ZIP 檔案、檢查點、請求、回覆、憑證鏈、驗證 結果以及交接記錄保留於收集器之外。於接收時重複進行驗證。

若要從已儲存的檢查點準備請求:

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

此準備程序會將 JSON 標準化,並將對應的檢查點納入存檔中。 請使用該存檔中的檢查點位元組進行 TSA 驗證,即使 輸入檔案的空白字元格式有所不同。

驗證範圍#

檢查 當前運作方式
資料 檢查點字節的精確 SHA-256 值必須與回應結果相符
請求 透過 --request,原始查詢與隨機數皆會經過驗證
TSA 簽名 簽章、簽章憑證及其到明確指定 CA 的憑證鏈依蓋戳時間進行檢查
收集器簽名 由日誌驗證器透過固定金鑰進行獨立驗證
撤銷 證據模式儲存由 verify.py 進行驗證的 OCSP/CRL 證據
排程提交 證據模式,由每個設定目標啟用

--request 在技術上是選用的,但省略它就無法驗證原始 nonce。在這個完整程序中,結果中的 request_checked 必須為 true。鏈中的每張憑證在蓋戳時間都必須有效,且簽章憑證只能用於時間戳。

TSA 回應將提交的檢查點位元組錨定至其聲明的時間點。 請根據所選模式的獲取記錄與環境驗證結果, 審查該結果。證據模式包含比利時政府合格的 TSA (http://tsa.belgium.be/connect;RFC 3161 回應均經簽署,因此純 HTTP 並不會 削弱其安全性)。將該供應商的根憑證傳遞至 --tsa-ca 參數後,verify.py 會回報一個 符合 eIDAS 資格的時間戳記及其時間戳記單位;根據 (EU) 第 910/2014 號法規 第 41(2) 條,其時間的準確性及綁定資料的完整性均被推定為成立。

簽名憑證撤銷#

在每次回覆後,證據模式會立即擷取 TSA 簽名 憑證的撤銷證據:若來自憑證的 AIA OCSP 位址,則為 OCSP 回應;否則則為來自其分發點的 CRL (最大 4 MiB)。該證據將以 checkpoint-N.<service>.ocsp 或 .crl 的形式儲存於回覆旁,並隨回覆一併匯出。擷取失敗絕不會 延遲時間戳記;anchor.completed 記錄會將其標示為 unavailable 並附上原因。

verify.py會檢查 OCSP 回應的簽名(由簽發者簽署,或由簽發者為 OCSP 簽署目的所提供的回應者憑證 簽署)、憑證 ID 及狀態,並確認 該回應是在 genTime 當下或之後簽發的,或當時仍有效(nextUpdate)。對於 CRL,它 會檢查簽發者的簽名、相同的時間範圍,以及確認序號未被列出。 接著,它會回報 signing certificate not revoked as of <time> (OCSP|CRL)、檢查失敗, 或 revocation not checked (no OCSP/CRL in the archive)。若簽署憑證在 genTime 當下或 之前已被撤銷,則驗證失敗;若撤銷時間在 genTime 之後,則會顯示為警告。

憑證記錄與更新 (RFC 4998)#

RFC 3161 時間戳記的有效性僅取決於其雜湊演算法以及 TSA 的簽署金鑰和 憑證;而個案的處理時間可能超過這些項目的有效期限。證據模式還會針對每個保留的檢查點保存一份 RFC 4998 證據記錄 (ERS),並定期更新該記錄。

在每次證據處理階段中,未記錄的檢查點會被放入哈希樹中,並依序向已設定的 TSA 查詢其根節點上的時間戳記。每個檢查點會取得 checkpoints/anchors/checkpoint-N.ers:一個 EvidenceRecord 其 ArchiveTimeStampSequence 其中 包含 一個 ArchiveTimeStampChain ,其中包含 ArchiveTimeStamp 攜帶該 檢查點的簡化哈希樹及 TSA 標記。一個記錄可能列出相鄰檢查點的哈希值;諸如 EU DSS 之類的驗證器會針對此情況發出警告。ASiC-E 匯出資料亦攜帶 META-INF/evidencerecord.ers 包含 META-INF/ASiCEvidenceRecordManifest.xml,即該容器資料物件的證據記錄 (ETSI EN 319 162-1)。ZIP 匯出檔則將檢查點記錄存放於 anchors/.

續約遵循 RFC 4998 第 5 節的規定,僅追加以下內容:

續約 當 什麼是「蓋章」
時間戳記更新 若最新代幣的簽名憑證將於 N 個月內(預設為 6 個月)到期、其簽名雜湊被標記為「弱」,或應要求時 前一個區塊的雜湊值,採用相同的演算法;該時間戳記會被加入到最後一條鏈中
哈希樹的更新 該區塊鏈的雜湊演算法被標記為「弱」,或依要求提供 H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) 採用更強大的演算法(預設為 SHA-512);新增一條區塊鏈

每次更新都會存入一個新檔案, checkpoint-N.renewal-K.ers;較早的檔案與鏈條將保持 逐位元組完全一致。證明僅在每個連結皆能依序驗證時, 才會追溯至第一個時間戳記;因此應在最新代幣仍可驗證時進行更新:即在其簽名憑證過期前、 其撤銷資訊消失前,或其雜湊或簽名演算法遭破解前。後續的更新 僅會新增一個時間戳記,但不會延伸先前證明的效力。

「憑證模式」的背景迴圈會每日及應要求檢查政策 (evidence_record.demand_renewal)。每次嘗試都會以 evidence_record.created 或 evidence_record.renewed ,並記錄服務、時間、雜湊演算法、樹根節點、檢查點範圍、 ok 及錯誤;無法讀取的記錄將送至 evidence_record.check_failed。若 TSA 驗證失敗,將 採用檢查點戳記的退避機制進行重試(並單獨計數),同時嘗試清單中的下一個 TSA。該 政策(months_before_expiry, weak_algorithms, algorithm, stronger_algorithm)即為 配置檔設定 evidence_record_policy;控制面板目前尚無法對此進行控制。

收集器在寫入每筆新記錄之前,會將其與對應的檢查點及 TSA 的簽名進行比對。 verify.py 會檢查匯出中的每筆記錄:雜湊樹、標記、鏈與續期的順序, 並回報最早的已驗證時間以及最新戳記的狀態。EU DSS 會將與檢查點相同的 記錄讀取為獨立資料。

《歐盟規例》第 2024/1183 號(eIDAS 2.0)在《歐盟規例》第 910/2014 號中新增了「合格電子歸檔」及「合格電子 帳簿」的規定。TgWitness 雖以標準格式寫入記錄,但並非 信任服務;其歸檔與日誌均不具備合格地位。合格服務提供者除其他要求外, 還需具備以下條件:

  • 歸檔(第 45i 條及第 45j 條):合格的信託服務提供者應將資料保存至 法定或合約規定的保存期限為止,且該資料須具備超越技術有效期限的 持久性與可讀性,並受到保護以防遺失或變更,同時須為 授權的依賴方提供自保存開始至檢索期間的自動化完整性報告。第 45i(2) 條 推定此類服務具備完整性與來源真實性。
  • 總帳(第 45k 條及第 45l 條):由一名或多名合格信託 服務提供者建立及管理的總帳,該總帳能確立紀錄的來源、以唯一且 按時間順序的方式對其進行排序,並使日後的變更能立即被偵測到。TgWitness 日誌採用 雜湊鏈技術,並由收集者使用其自有金鑰進行簽署;但僅憑此並不能構成合格總帳。
  • 兩者皆包含:由監管機構授予的合格資格及可信名單條目(第 21 條及 第 22 條)、第 24 條所規定的義務、至少每 24 個月進行一次的符合性評估(第 20 條) 以及根據第 45j(2) 條及第 45l(2) 條所訂定的實施法案所援引的參考標準。

來自合格 TSA 的合格時間戳記(第 41 條及第 42 條)針對每個 憑證皆保有其自身的推定;續期並不會為整個紀錄建立新的推定。

交接紀錄#

記錄案件識別碼、發送者與收件者、UTC 傳輸時間及其來源、 目的、檔案名稱/SHA-256 值、收集器指紋、序列範圍、已知 缺口、驗證器版本及驗證結果。 請透過貴組織的流程對此 記錄進行簽署並獨立保存。TgWitness 並未 實作多使用者保管記錄系統。

即時服務檢查,2026年11月9日#

已向每個預設服務發送一則 RFC 3161 請求。兩者均已批准該請求。

服務 回覆 簽署單元 驗證器結果
http://tsa.belgium.be/connect 已核准,政策編號 2.16.56.13.6.3.1.1000 時間戳記單元202301 符合 eIDAS 標準的時間戳記
https://freetsa.org/tsr 已核准 FreeTSA RFC 3161 時間戳記

比利時簽名憑證載有 qcStatements 合規聲明,且 與驗證器中記錄的單位相符。本地測試亦使用合成 CA/TSA 來 檢查對變更資料、變更的非ce值及錯誤 CA 的拒絕機制。

2026年11月10日,比利時 OCSP 回應器(一項受授權的回應器憑證)針對時間戳記單位 202301 回覆 「良好」。FreeTSA 的 OCSP 位址(2560 埠)在測試主機發送請求後 40 秒內未予回應;因此改為使用其 CRL(PEM 格式,1 KB)。