TgWitness / 文件說明

已測試的內容 →

本頁部分內容仍為英文:英文原文在翻譯後已進行修改。

參考資料 / 證據

Telegram · 證據格式

簽名 ZIP 檔案的內容、記錄類型、處理回執、使用者檔案、異地備份及離線驗證。

TgWitness / 文件說明

證據與驗證

TgWitness 將帳戶可見的 Telegram 觀察結果保存於經簽名的日誌中。 接收者可透過可信的 收集器金鑰驗證已儲存的記錄、附件及報告,從第三方查核最後一筆記錄的外部時間,並將 日誌與先前保留的檢查點進行比對。 本頁說明格式、驗證程序以及移交時應保留的資料。

Windows 使用者可透過 VERIFY.cmd 開始操作:該程式會要求提供原始 ZIP 檔案及獨立取得的金鑰指紋,顯示附有說明的結果, 並另行儲存驗證紀錄。有關設定與信任限制,請參閱驗證啟動程式及 可攜式執行環境。

本頁內容

何謂「簽名」#

資料 保護 應保留的內容
每則日誌記錄,包括操作事件 每個事件皆包含 SHA-256 鏈及 Ed25519 簽名 原始 events.jsonl(可信金鑰指紋)及保留的檢查點
證據 ZIP 檔案內容 manifest.sig 對規範性清單進行簽名,該清單列出了內容檔案的雜湊值 完整的 ZIP 檔案,包含其清單檔與簽名檔
保留的附件 簽名過的 media.saved 事件中包含 SHA-256 值與位元組計數;簽名過的 ZIP 清單中包含檔案雜湊值 經驗證 ZIP 檔案內的原始位元組
檢查點 針對日誌長度、開頭雜湊值、公鑰及建立時間進行 Ed25519 簽名 在爭議性變更發生前保留的獨立副本
執行收據 包含收集器版本、原始檔雜湊值及啟動設定的簽名記錄,亦收錄於 process.started 中 所選驗證模式的收據、相關日誌及環境證據
易讀的報告:report.html 及其各部分,report.json、report.pdf、chat.pdf 每個檔案均附有針對其內容的 Ed25519 封印;PDF 亦附帶標準的 PDF 簽名(參見 可讀性報告 ) 收到的檔案及其可信金鑰指紋;該檔案所對應的 ZIP 檔案
獨立版 CSV 不包含獨立的加密簽名;僅憑事件雜湊值並不足夠 請使用經驗證 ZIP 檔案中的原始內容進行完整性檢查
由瀏覽器產生的螢幕截圖、列印文件或 PDF 檔案 衍生作品上不得出現 TgWitness 簽名 請保留原始的已驗證套件,並記錄衍生版本的製作過程

收集器會在生成每種匯出格式之前,先驗證日誌簽名。 易於閱讀的 HTML 和 PDF 報告各自附有專屬印章;獨立的 CSV 檔案則作為 已簽署 ZIP 檔案的一部分進行驗證。請保留 ZIP 檔案以維持附件位元組與清單, 並另設檢查點,用以將日誌與較早的邊界進行比對。

格式與驗證路徑#

擷取模式與輸出格式旨在解答不同的問題。該模式 提供蒐集與環境證據;每種格式皆會依據下列檢查機制,保留或呈現 該記錄的一部分。

輸出 驗證與使用
證據 ZIP 規範事件、簽名清單、覆蓋範圍、保管記錄、附件及可用的外部收據;檢查存檔及其選定的獲取模式。
ASiC-E 容器 證據 ZIP 檔案作為 ETSI ASiC-E 容器(EN 319 162-1),其中包含 MIME 類型(mimetype)條目及 META-INF/ASiCManifest.xml 檔案,並使用工作區自身的憑證以 B-B 級別進行 CAdES 簽署;若啟用時間戳記功能,則以 B-T 級別簽署。 諸如 EU DSS 等驗證工具會檢查格式與完整性,且由於憑證為自行簽發,因此會報告「無信任錨點」。EU DSS 6.3 在預設設定下會拒絕包含超過 1000 個檔案的容器(「偵測到檔案過多」)。 verify.py 會檢查 Ed25519 清單檔及所有列出的檔案、META-INF/ASiCManifest.xml 中的 SHA-256 值,以及新增的 ASiCManifestNNN.xml 或 ASiCEvidenceRecordManifest.xml 中的 SHA-256 值;若遇到上述任何檔案均未涵蓋的 META-INF/ 項目,則會檢查失敗。該工具不會檢查 CAdES 簽名,並會明確標示此點。
HTML 與 JSON 報告 這些視圖均經個別封存並附有來源參考,亦列於 ZIP 清單中。其記錄的計數彙總了日誌事件的各類型。
PDF 報告 Ed25519 數位簽章,加上針對位元組範圍 B-B(或當時間戳功能啟用時為 B-T)的 PAdES 基準 PDF 簽章。TgWitness 驗證器使用受信任的 Ed25519 金鑰;檢視者所顯示的憑證信任狀態則屬另一項獨立檢查。
CSV 電子試算表檢視受 ZIP 清單保護。公式轉義機制保障試算表的使用安全;原始簽名文字仍保留於日誌中。
JSONL 經簽名的事件記錄,包含附件參考。證據 ZIP 檔案另附有已保留的附件位元組。
聊天記錄匯出與相容於桌面版的檢視模式 歷史資料擷取及可用的管理日誌記錄,包含所要求的呈現形式與簽名存檔。即時監控的儲存版本屬於另一條獨立的擷取路徑。
媒體與僅含雜湊值的記錄 儲存的位元組會根據其 SHA-256 值及訊息參考進行比對。僅擷取雜湊值的作法會保留可用的雜湊元資料,以便日後與檔案位元組進行比對。
STIX/MISP 與人員檔案 來源連結的提取觀察結果、帳戶 ID 及分析匹配結果。可將輪廓簽名與記錄雜湊值與原始證據進行比對;頭像快取的來源標籤則另行標示。
交接摘要 經簽名的揭露規則、未變更的記錄,以及保留原始雜湊值/簽名的標記最小化記錄。若需進行涉及隱藏欄位的比對,請使用保留的原始資料。
見證者與時間收據 較早的日誌邊界、連續性以及個別經驗證的時間聲明。這些內容伴隨資料擷取與歸檔檢查一併進行。
密碼保護的傳送 在傳輸過程中保護所包含的封包。.tgwpw 使用 AES-GCM 認證加密,包含一則經認證的最終記錄;所包含的日誌會保留其簽名與取得收據。

列印本或螢幕截圖是經簽署資料的呈現形式。其報告 ID、金鑰指紋及 QR 參考碼有助於定位原始檔案以供驗證。 保管聲明記錄了提供的驗證人員及轉移資訊; 驗證結果與取得收據則作為獨立證據予以保留。

外部簽名#

簽名亦可能來自 TgWitness 從未持有的金鑰,例如調查人員的 合格電子簽名或組織的印章。關於匯出,若在未設定密碼的預備匯出檔案上進行外部 簽名,系統會提供待簽名的位元組:一份新的 META-INF/ASiCManifestNNN.xml 清單,其中列出 ASiC-E 容器內每個檔案及其 SHA-256 值,或是 ZIP 檔案的 manifest.json 。簽署者會回傳一個 CMS (CAdES) .p7s,該簽名可為獨立存在,或將內容嵌入其中。

TgWitness 會檢查簽名是否精確涵蓋這些位元組,並使用 簽署者的憑證進行驗證(RSA PKCS#1 v1.5、RSASSA-PSS、ECDSA、Ed25519、Ed448)。 該鏈 僅會對照操作員提供的根憑證進行檢查;不會檢查撤銷狀態、可信 清單及合格狀態。控制面板會針對每個簽名顯示一種狀態: 等待簽名、已附加但未檢查、已驗證、不支援該演算法、 簽名無效、簽名位元組不符,或憑證未與提供的 根憑證建立鏈結。在位元組已分發後變更匯出 設定,將使所有簽名狀態均設為「簽名位元組不符」。

「連同簽名檔下載」會將簽名檔及其清單存放在 META-INF 。若為 ZIP 檔案,則會將未變更的 ZIP 檔案、 .p7s 檔案以及 SIGNATURES.txt 放入外層 ZIP 檔案中。無效的簽名以及簽名範圍超出其他位元組的 簽名將被排除。若簽名採用 TgWitness 無法驗證的演算法,該簽名仍會被包含; 面板會顯示其狀態,如同 SIGNATURES.txt 針對 ZIP 檔案的情況。

附簽名的聊天圖片#

在圖片預覽中下載已簽名的 ZIP 檔案可儲存 PNG 頁面, pages.sig.json 且 README.txt。每頁末尾皆包含該頁顯示的日誌記錄編號、對話內容、 渲染時間、工作區金鑰指紋以及用於驗證的指令。該面板 僅傳送每頁的 SHA-256 值與記錄編號;伺服器會確認這些記錄 屬於該對話,並使用 工作區金鑰對該聲明進行簽署(tgwitness-image-attestation-v1)並將簽名過程記錄為 export.image_attested.

python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip

驗證器會檢查簽名、將每個 PNG 檔案與已簽名的頁面進行比對,並回報 金鑰指紋。 --fingerprint 將簽署者與從 發送者獨立取得的指紋進行比對。 --evidence 讀取同一工作區的已簽署證據 ZIP 檔案,並 要求所有圖片記錄均須存在且具有相同的雜湊值。若任何一個像素、 陳述內容或密鑰發生變更,檢查即會失敗。這些圖片顯示的是以 TgWitness 專屬佈局儲存的記錄;它們並未顯示 Telegram 向任何人展示的內容。

比較聊天記錄匯出檔#

驗證並比較兩個已簽名的聊天記錄匯出 ZIP 檔案,並使用獨立保存的簽署者 指紋進行比對:

python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256

--require 與 --require-tier 若與 --compare 同時使用將被拒絕;請透過各自的驗證機制, 檢查每個壓縮檔所需的配置檔。

當兩個存檔皆記錄相同的數值帳號與聊天 ID 時,紀錄將依據 訊息 ID 進行配對。「未變更」意指完整的儲存 JSON 紀錄完全相等: 包含全文、發送者、日期、回覆對象、嵌套元資料及未知欄位等 所有內容。JSON 物件的鍵順序無關緊要;但缺失的欄位、null 值、值類型 以及陣列順序則會影響比對結果。300 字元的預覽僅供顯示之用。 已變更的條目 會將差異標示於頂層的 changed_fields 中,包含預覽中無法顯示的變更。 在比對過程中,若出現重複的訊息 ID,系統會拒絕該條目,而非互相覆寫。

差異可能包括顯示名稱變更、瀏覽次數、收集註解或 其他觀察結果元資料。Telegram 的編輯會以獨立的編輯事件呈現,且每個 存檔的驗證結果會顯示該存檔是否完整無損。未解析的記錄仍會 保留在比對中,並根據其儲存的表示形式進行比對。

針對不同或缺失的帳戶/聊天室身分,該工具會根據發送者、完整文字、檔案雜湊值、媒體類型以及五秒的 時間容差,找出候選 對應項,並將其報告為「已匹配」而非「未變更」。 未解析的 記錄將保持未配對狀態。配對記錄中的差異會列於 changed 中, 包含內容模式下的差異。使用 --json 時,matched 會統計候選配對數, 而 unchanged 則統計完整儲存記錄完全相等的配對數。現有的 changed_fields 及整數型 unchanged 輸出仍與 先前的比較結果相容。存檔格式與簽名驗證均維持不變。

調查交接#

  1. 請在案件筆記中記錄案件編號、操作人員、Telegram 帳戶的數字 ID、已選取的 來源、蒐集政策及蒐集期間。TgWitness 會保存觀察記錄,並支援在 「案件看板」中建立與來源連結的筆記及蒐集資料。請將轉移與保管記錄與您的案件 資料一併保存。 透過 即時驗收程序,核對預期的蒐集設定是否正確。
  2. 在依賴 工作區的輸出內容之前,請先獨立保存該工作區的公鑰指紋。請保持「證據模式」開啟(預設設定),以便檢查點能收到符合 RFC 3161 及 OpenTimestamps 規範的收據。在收集過程中,請將已簽名的檢查點儲存於收集器之外。 請記錄中斷情況以及該帳戶的可見性限制。
  3. 匯出經簽名的 ZIP 檔案並保留經簽名的執行收據。請在 匯出日誌邊界處或之前設定檢查點。若檢查點設定在較後位置,系統將能正確地拒絕 較早的匯出檔案,因其長度不足。匯出內容包含完整的工作區日誌, 無論面板篩選條件為何;請在分享前審閱相關資料。
  4. 請收件者使用可信賴的驗證器副本、 獨立提供的指紋,以及另行取得的時間戳記授權機構的根 憑證來驗證 ZIP 檔案。從具有有效 Python 環境的可信賴檢查點開始:

    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence

    最後一筆記錄的指紋與經驗證的時間戳記須符合 證據的最低要求;否則,--require evidence 將以代碼 2 退出。檢查點屬於 輔助驗證,因為它是以收集器金鑰簽署的。當兩項輸入皆 已提供且被接受時,成功輸出 將回報 key_pinned: true 及 checkpoint_checked: true。請保留驗證結果。

    For a handover requiring the final exported record to be witnessed, use
    `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
    This refuses an export with an unwitnessed tail. Add
    `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
    witness posts as external time. See the
    [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
    
    1. 請在您的保管紀錄中記錄存檔的 SHA-256 值、匯出邊界、傳輸日期、寄件者及 收件者。保持原始封包完整,並 僅使用副本進行作業。請分享證據檔案,而非應用程式的私有資料 目錄,該目錄亦包含帳戶會話與簽名密鑰。 傳輸時,請選擇密碼保護的 AES-256 ZIP 檔案,或安全性更高的 .tgwpw 容器。 ZIP 採用 WinZip 的低成本密碼衍生演算法;請使用長且隨機的 密碼短語。.tgwpw 採用 scrypt 及 AES-256-GCM,並透過獨立 驗證器的 unseal-password 指令開啟。密碼不會被儲存,且僅用於保護 機密性;收件者會解密 壓縮檔,並驗證其中的已簽署輸出內容是否未遭變更。
    2. 若要在非證據模式下為檢查點加註時間戳記,請遵循 RFC 3161 的程序,並保留請求、檢查點、可信 CA 資訊以及經驗證的授權機構回應。僅準備請求 並無法取得時間戳記。

對於 .tgwpw,請使用獨立取得的驗證器,並選擇一個 保留原始副檔名的全新輸出檔案:python verify.py unseal-password export.tgwpw --out evidence.zip。 該指令會提示輸入密碼;--password-stdin 會讀取一行內容以實現自動化。 它絕不會覆寫現有檔案,且僅在所有記錄 通過驗證後才會發布明文。之後請對解密後的檔案執行常規簽名驗證。 該容器採用 scrypt(N=131072、r=8、p=1、16 位元組鹽值;約 128 MiB 記憶體) 以及 AES-256-GCM 加密,包含 1 MiB 的記錄及一則經認證的最終記錄。一則加密的 元資料記錄會儲存內部檔案名稱,因此下載後的容器可重新命名。

驗證成功即表示相對於可信收集器 金鑰及保留邊界,資料完整性已獲確立。請參閱驗證範圍,了解 信任假設以及所執行檢查的驗證結果。

交接摘要#

一個已簽名的 ZIP 檔案包含整個工作區日誌。當法院、律師或濫用通報部門僅需 部分聊天記錄、特定時間段或特定人員時,可透過「匯出 → 移交摘錄」功能,依據選定的揭露規則生成精簡版 副本(tgwitness-handover-v1)。 操作員需說明目的,並選擇對話內容、可選的時間範圍(UTC)、 摘錄所涉及的人物,以及其他人員的處理方式(顯示、替換為化名 P01、 P02… 或 省略),哪些訊息內容保留,哪些附件及個人資料照片納入,以及 訊息中的電話號碼和電子郵件地址是否需被遮蔽。 該目的及相關規則將載於 經簽署的清單及報告中;日誌會記錄「handover.exported」,並標註 生成該日誌的存取者以及檔案的 SHA-256 值,而非內容本身。

verify.py 透過兩種方式檢查一個摘錄。對於顯示為未變更的記錄,系統會進行完整驗證:將其 內容與其雜湊值、Ed25519 簽名以及其與所包含前身記錄的連結進行比對。 一則 經簡化處理的記錄會保留原始的雜湊值與簽名,因此簽名仍可通過驗證,但 無法據此重新計算被隱藏的欄位;該記錄會列出被隱藏的內容,而報告 也會標示出來。 全帳戶服務記錄(啟動與停止、覆蓋範圍缺口、連線、網路及儲存通知、 範圍與設定變更)僅保留其類型所列的欄位:其中的聊天室清單會被裁切為選定的 聊天室並重新統計其總數;若選定範圍外的聊天室出現即時探測缺口,則該聊天室、其訊息 編號及見證帳號將被刪除;在選定的探測聊天室中,見證帳號將被其化名取代,除非 顯示所有參與者,或該帳號屬於選定人員之一。 清單文件會標明日誌長度與開頭,並附有收集者對該 開頭的簽名,同時統計被排除的記錄;coverage.json 則描述所選的聊天室。新的萃取檔亦 包含 proofs.jsonl:針對每個包含的記錄以及日誌開頭,皆提供從 記錄原始雜湊值到簽名清單文件中所命名日誌根節點的 Merkle 路徑。 verify.py 會檢查每個 路徑,因此即使沒有完整的日誌,也能驗證每筆記錄確實屬於長度與標題相同的日誌; 無論日誌大小為何,驗證 100 則訊息的摘錄僅需約一秒。 --range=CHAT:FROM-TO 會額外確認某次聊天中從「FROM」到「TO」的訊息是否包含在擷取檔中, 並回報為此檢查了多少筆記錄。檔案名稱中的 名稱不會被偵測到。分享前請審閱最終檔案:自由文字、檔案名稱及選取的 附件仍可能揭露個人身分。請保留完整的簽名 ZIP 檔:擷取檔僅供披露,並非替代品。

易讀的報告#

已簽署的證據、移交檔案及聊天 ZIP 檔均包含可讀取的 HTML 和 JSON 報告,此外 若所需字型可用,還會提供以選定報告語言產生的 PDF 檔案。每份 報告均以工作區的 Ed25519 金鑰加密封存,並可單獨驗證: python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]。

  • report.html / chat.html:封存陳述式(tgwitness-report-seal-v1)會關閉檔案,並 對其前面的每個位元組的 SHA-256 進行簽名。長篇日誌和聊天記錄會分割為 可配置大小的部分(報告設定,500 至 100,000 筆記錄;預設為 5,000 筆): records/records-0001.html 或 messages/messages-0001.html,每個皆以其編號、範圍 及總數進行封存,並連同其 SHA-256 一併列於已簽署的清單中。收集器心跳訊號的連續記錄 將顯示為一行,除非「報告設定」中指定逐一列出。
  • report.json(tgwitness-report-json-v1、金鑰 format、report、seal):該憑證對 report 的規範 JSON 中的 SHA-256 進行簽署,因此案件系統與腳本可讀取相關事實 並能據此進行資料保護的篩選,同時保持簽署檔案的完整性。
  • report.pdf / chat.pdf:一份供列印及歸檔之正式文件,在相同的 位元組上簽署兩次,整個檔案(簽名值除外)(/ByteRange)。標準的 PDF 簽名 採用 PAdES 基準規格(ETSI EN 319 142-1, /SubFilter /ETSI.CAdES.detached:採用 SHA-256 與 ECDSA P-256 的 CMS,簽署憑證 v2,無 CMS 簽署時間;聲稱的時間為 /M) 處於 B-B 級別,或 B-T 級別——當時間戳功能開啟時,CMS 中包含 RFC 3161 簽名時間戳,且對於 Telegram 外部的請求, 時間戳授權機構會透過路由進行回應。它使用一份 存放在工作區金庫中的自簽發文件簽署憑證;其主體序列 號即為 Ed25519 金鑰指紋。 該 Ed25519 印章以 未簽署屬性 2.25.240684792623320047764573196045913242332 在 CMS 內傳遞,並以 「SHA-256」標示該 憑證, "content": "pdf-byte-range",因此由 Ed25519 金鑰為該 憑證背書。此憑證未經認證:PDF 閱讀器會顯示簽名有效,但 簽署者為未知或未受信任,直至該憑證獲得信任為止;請改為比對 Ed25519 指紋。中文、日文及韓文的 PDF 檔案需在伺服器上(或於 TGWITNESS_FONT_DIR);若無此字型,ZIP 檔案僅包含 HTML 和 JSON 報告 。
  • report.en.html、report.en.pdf / chat.en.html、chat.en.pdf:當報告語言不是英文時,同一報告的英文正本,以相同方式封印與簽署,並在已簽署清單的 report.original 下列出。所選語言的報告開頭建議將英文正本連同經認證或宣誓的譯文一併提交;請參閱為法院翻譯報告。

在頻道或超級群組中,Telegram 會依序為訊息編號 1、2、3…。聊天記錄匯出檔會列出 起始與結束編號、現有訊息數量,以及所有缺失編號的區段(如 message-ids.json )、清單檔與 chat.json 標頭,並標記每個缺口在 對話紀錄中的位置。 verify.py 會從 chat.json 開始重新編號。缺失的編號是指 Telegram 未傳回的訊息(在匯出前已被刪除,或該帳號無法看見);在私人聊天室和 基本群組中,編號由該帳號的所有聊天室共用,且不會計入缺口。

讀取歷史紀錄後,匯出程序會根據號碼(channels.getMessages,最多 10,000 個號碼,包含第一則訊息下方 1,000 個號碼,若缺口數量超過 10,000,則均勻分佈於所有缺口處)。結果收錄於 message-ids.json 及報告中。若回覆為空,則表示在重新檢查時該號碼對此帳號不可用;但未說明具體原因。重新檢查時收到的訊息將被加入匯出檔案並標記為 found_on_recheck.

當監測工作區偵測到聊天室中的訊息被刪除、重新檢查時缺失或遭編輯,聊天室匯出檔案會新增 journal-changes.jsonl:這些日誌記錄、每個已儲存的版本以及相關通知,並為每項內容附上其在日誌中收到的雜湊值與 Ed25519 簽名。 verify.py 系統會重新計算每筆記錄的雜湊值,使用匯出金鑰驗證其簽名,並將計數與已簽名的清單進行比對;證據匯出檔包含完整的雜湊鏈。報告會在「刪除項目」及「早期版本」下方列出這些訊息。

每份報告均以簡而言之開頭:先有一段文字,接著說明資料顯示的內容以及記錄包含的內容。 當瀏覽器驗證完印章的 簽名(而非頁面本身)後,該頁面的印章標記會轉為琥珀色:瀏覽器不會為頁面提供其自身的位元組。 只有當 讀者將檔案拖曳至頁面底部的驗證區,且每個位元組均完全吻合,同時 顯示的頁面正是該檔案時,印章才會轉為綠色;否則將轉為紅色。

每份報告均精確標明程式名稱:當收集器從檢出版本執行時對應的 git 提交,或 安裝程式設定的 TGWITNESS_COMMIT,以及其原始檔案的 SHA-256(source_tree_sha256、 路徑的規範 JSON → SHA-256,適用於每個 .py、.js、.css、.html 和 .svg 檔案在 套件中),只要檔案未被修改,檢出該提交即可重現上述內容。 Telegram 客戶端的命名包含其函式庫、API 層及資料中心。當監測開始,以及當聊天 匯出開始與結束時,收集器會向 Telegram 查詢其時間(updates.getState,以 整秒為單位),並記錄 Telegram 的時間減去收集器的時鐘時間,其中包含因 往返傳輸產生的不確定性;報告會在「保管鏈」欄位中顯示這些測量值。 除了訊息的日期外,聊天記錄匯出還會記錄 讀取歷史紀錄的時間點。

離線報告檢視器與歸檔指南#

在開啟 chat.html 或 report.html 之前,請先解壓縮完整的 ZIP 檔案。此檢視器提供搜尋、 篩選、參與者、指標、記錄詳細資訊,以及無需伺服器即可進行的 JSON/CSV 選取功能。請將 viewer/ 和 media/ 置於報告旁。選取項目屬衍生內容:請使用 verify.py SELECTION.json --evidence ARCHIVE.zip 將其與簽名存檔進行比對。 驗證器會檢查報告 ID、簽署金鑰、存檔邊界以及每個選取項目;經編輯、 遺漏或重複的項目將被判定為失敗。選取註記與建立時間仍屬未簽署的元資料。

訊息編號的間隙僅會出現在完整、未經篩選且按升序排列的聊天記錄中。隱藏某個 類別或無法載入某個資料區塊,絕不能將省略的行視為缺少 訊息的證據。搜尋標示功能會針對HTML轉義前的純文字進行操作,並保留字面標記。

瀏覽器會檢查清單簽名、報告 ID 與金鑰,以及所有列出的檔案雜湊值。它 會拒絕模稜兩可或格式錯誤的 ZIP 結構、重複名稱及不安全的路徑,並將檔案 大小限制在 256 MiB 內,且宣告的總內容大小不得超過 4 GiB。若需處理更大的壓縮檔,請使用獨立驗證器。 此瀏覽器檢查功能可補充驗證器對日誌鏈及資料語義的檢查。

README.txt 包含一份入門指南、對齊後的檔案清單、驗證說明及資料 格式說明(均以報告語言撰寫),其後附有完整的英文指南。 SHA256SUMS 涵蓋 其中列出的檔案,但不包括該檔案本身、manifest.json 及 manifest.sig;經簽名的清單 亦涵蓋 SHA256SUMS。請保持原始 ZIP 檔案不變,並將工作檔案儲存於 解壓縮資料夾之外。PDF 報告包含章節書籤,且後續頁面載有案件/報告識別資訊。

匯出時的聊天內容#

聊天室匯出檔案會記錄在匯出開始時,Telegram 針對該聊天室所做的說明:Telegram 自身的 標籤(scam、fake、restricted 及其理由、verified)、使用者名稱、描述、成員 及管理員人數、關聯的討論串、內容保護設定、新成員是否能查看較早的 訊息,以及該帳號從哪則訊息開始能查看歷史紀錄(available_min_id), 若該聊天室為新建立,則為第一則訊息的 日期,以及聊天室照片的 SHA-256(儲存於 media/)。 它會記錄匯出帳號在聊天室中的地位:角色、加入日期、邀請者,以及若為 管理員,其權限。若 Telegram 拒絕某項請求,則會列出該請求的名稱。

當匯出帳戶為管理員時,匯出程序會將聊天室的管理員日誌(Telegram 會保留約 48 小時)讀取至 admin-log.json:其中包含刪除與編輯紀錄,並附有相關內容、 執行帳戶及來源操作日期。這些條目可補充即時日誌的 擷取版本與刪除接收紀錄。

指標#

報告清單及存檔中以 indicators.csv 、indicators.stix.json (STIX 2.1 ) 以及 indicators.misp.json (MISP 事件)標示,濫用處理部門可據此針對記錄訊息中的以下內容採取行動: 連結與網域(包括隱藏於文字後、按鈕內及連結預覽中的內容)、加密貨幣 地址、Telegram 使用者名稱與邀請連結、電話號碼、電子郵件地址及儲存的圖片。 比特幣、萊特幣、狗狗幣和波場(TRON)地址僅在 Base58 校驗和通過時才會列出, SegWit 地址則需其 Bech32 或 Bech32m 校驗和通過,而 TON 地址則需其 CRC 校驗和通過;EVM 和 Solana 地址則標記為「未經檢查」。 圖片包含 SHA-256 以及一個感知 雜湊(dHash,64 位元),即使經過重新壓縮或調整大小的副本,該雜湊值仍幾乎保持不變。報告會寫入 標記,以防止意外開啟(hxxps[://]example[.]com );檔案則保留 原始的數值。 每個指標均標記為「未知」且不適用於自動偵測(STIX 、 indicator_types: unknown 、MISP 、to_ids: false ,分發至自身組織):被 列出僅表示訊息中包含該指標,並不代表其具有惡意。若連結的顯示文字與實際開啟的 地址不符,該連結將在報告中被標記。

PDF 報告末尾包含一份需由審查員親筆簽署的聲明、供公證人或 法院專家使用的核對清單,以及一個 QR 碼(亦位於首頁),其中包含報告 ID、金鑰指紋及 權威資料的 SHA-256,以便列印本能追溯至其存檔。

事件規範化#

雜湊輸入必須精確包含以下這些欄位:

seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash

請使用與 Python 相容的 JSON 格式進行序列化,採用 UTF-8 編碼、物件鍵值排序,不進行 ASCII 轉義,不包含無意義的空白字元,且不包含 NaN 或無窮大:

json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")

這些位元的 SHA-256 值即為事件雜湊。簽名採用 Ed25519 演算法對 32 位元原始雜湊位元進行運算,隨後進行 Base64 編碼。第一個 previous_hash 為 64 個零。 序號從 1 開始,並以 1 為單位遞增。所有事件(包括運作 事件)共用同一條鏈。本系統不進行重複傳送抑制:重複 的觀察結果僅代表不同的收據,而非聲稱存在不同的 Telegram 操作。

Telegram 的原始日期為 ISO 字串;二進位欄位則轉為包含 bytes_base64 的物件。訊息正文、實體、媒體描述碼、回覆元資料、反應, 以及服務動作,若已提供,則會保留在原始訊息元資料中。即時 訊息亦會保留傳送該訊息的 Telegram 更新, transport_update;當 該更新所攜帶的訊息與 raw,其 message 欄位將 {"same_as": "raw"} ,而非建立第二份副本。

observed_at 是收集者寫入該記錄時的 UTC 時間; source_at 是該 Telegram 事件 所提供的日期。在處理即時更新時寫入的記錄會附加 payload.received_at,即更新抵達收集器的 UTC 時間,以及 payload.processing_delay_ms。即時編輯會保留所提供的編輯日期,歷史 快照則保留訊息日期並附上當前的觀察時間,而一般的 刪除通知則記錄接收時間,來源日期設為 null。管理日誌 條目會另行保留其所提供的動作日期。接收順序與來源 事件順序屬於不同的時間軸,可透過時鐘觀察值與外部接收記錄 進行比對。

行為者語義#

來源歸屬遵循事件來源。message.new.actor_id 和 message.edited.payload.sender_id 保留訊息發送者。一般的 message.deleted 通知包含訊息 ID,且其 actor 欄位為 null; 可用的管理日誌條目則包含其提供的動作、執行者及日期。 成員服務訊息保留發送者與動作類型,原始參與者更新 保留提供的 actor_id,而反應快照則保留其提供的 計數與可見身分。請將這些記錄與擷取的 版本及面板互動收據一併閱讀。

私人聊天室與一般群組的刪除通知僅包含訊息 ID。 這些聊天室共用一個帳戶級別的 ID 序列,因此一個 ID 代表該 帳戶中的一則單一訊息。當具有該 ID 的訊息先前已儲存於此日誌中時, 刪除操作會以 `message.deleted` 的形式記錄於該聊天室中,並透過 `payload.chat_resolution` 指定方法名稱。從未被儲存過的 ID 則以 deletion.unscoped 形式保留:這是一種 實際的刪除通知,其對應的聊天室尚未被關聯。 這與 message.missing_on_recheck 不同,後者記錄的是無法取得的查詢結果,也 有別於已儲存訊息 ID 中的缺口。頻道和超級群組是針對每個聊天室對訊息進行編號, 絕不會以此方式進行配對。當被刪除的訊息是由被觀察的帳號發送時, payload.deleted_message_was_outgoing 為 true;但刪除者仍未提供。

未限定範圍的通知會保留其專屬標籤,因為相符的聊天室可能位於 當前觀察範圍之外,或無唯一匹配項。在報告計數、篩選條件及 標籤中,「重新檢查缺失」仍與「刪除通知」屬於 不同的觀察項目。後續的恢復操作會清除當前的缺失狀態,同時在 簽名歷史紀錄中保留先前的檢查失敗紀錄;刪除通知則仍屬 獨立的事件類型。

來自同一則通知且解析為同一則聊天室的多個 ID,無論數量多少,均會歸類為 deletion.batch;其中訊息 ID 完全依照 Telegram 傳送時的原樣呈現,並包含該帳號實際傳送的訊息數量。Telegram 的通知會 列出這些訊息;而聊天室的管理員日誌則會標明執行該操作的管理員,該帳號 可於該處查閱相關資訊。 連結(message.deletion_attributed)的建立取決於何者先抵達: 若在刪除通知記錄之前,已有輪詢查閱過管理員日誌條目,則當通知 被記錄時,該輪詢將被配對。

涵蓋範圍:連續性、缺口及未被偵測的 ID#

每個簽名 ZIP 檔案均包含 coverage.json,HTML 報告開頭會顯示相同的摘要,而 verify.py 會根據 events.jsonl 重新計算該摘要,而非直接信任該檔案:

  • 從 X 到 Y 持續進行觀察。一個週期始於 observation.started,並 結束於暫停、停止、Telegram 連線中斷、登出、未經 有序停止的程序啟動,或在觀察期間超過三分鐘無任何記錄 (每分鐘會寫入一次心跳訊號,因此無訊號表示程序已停止、凍結或 電腦進入睡眠狀態)。 當在「更多工具 → 參數」中變更心跳間隔時,每次心跳 都會記錄此變更,且允許的靜默時間將調整為三個間隔,絕不低於三分鐘。
  • 「缺口」欄位列出各期間之間的時間間隔及其原因。若最後 一筆記錄處仍有未填補的缺口,則標記為 not_resumed_by_last_record。
  • 未偵測到的訊息 ID。對於會針對每個 對話進行訊息編號的頻道和超級群組,偵測到的 ID 之間缺失的 ID 會以範圍形式列出。這些 ID 會被報告為 「未偵測到」—— 可能是已被刪除、從未送達,或超出已儲存的歷史紀錄範圍 —— 絕不會直接標示為 「已刪除」。私人對話和一般群組共用全帳戶範圍的序列號,因此單一 對話內的缺口並無特殊意義,亦不會在該處列出。
  • 聊天層級的資料缺口通知(例如 Telegram 在某個 頻道中要求恢復差異)將被計為備註;此類通知不會中斷整體涵蓋範圍。
  • Session records. Windows in which Telegram's update counter grew while no update reached this session (updates_diverted), this session left Telegram's session list while its connection kept working (session_revoked_externally), or a witness probe's answer arrived only from history (probe_ack_missed_live) are listed separately. The verifier also reports where the Telegram session key came from, other sessions signed in when observation started, sessions added during observation, Telegram security notices (777000), other sessions ended from the workspace, only-session periods, witness probe counts and phone call updates. See accounts. While strict chosen chats is on (scope.strict in observation.started), the session list (except while this is the only session, or when Telegram devices is on), security notices and phone call updates are not collected, so their absence says nothing, and a deletion is matched to a session check only if one ran in the 10 minutes before it.

更新順序 (pts)#

Telegram 會以 pts:每個帳號有一組序列 (包含私人聊天室與基本群組),而每個頻道或超級群組則各有一組。該 收集器會將其接收到的每個完整區段(無缺口)記錄為 coverage.sequence 記錄:首尾 pts、各類型的更新數量,以及這些更新是 即時推送還是由 getDifference 或 getChannelDifference所返回。中斷被視為一則 coverage.gap 記錄,並 coverage.gap_closed 標示出 pts ,從該點起,序列 便恢復完整。

一段連續的記錄顯示,Telegram 在其首次與最後一次 發送之間,依序編號的所有更新 pts 之間,Telegram 依該序列編號的每則更新,皆已送達此收集器的 Telegram 客戶端。這並未提及 Telegram 從未傳送至此帳號的內容,亦未涉及首則記錄之前的時間段 pts之前的時間段,亦未提及收集者未記錄的連續區段。任何 pts 任何 未被記錄的區段或差異所涵蓋的進度,均會顯示為中斷。

GET /api/continuity 針對某個區間(since, until, chat_id) 內,判定每個 序列是否連續,並列出斷點及其原因。 verify.py 根據「序列連續性」下的檔案紀錄, 輸出相同結果。

缺失的訊息編號(gap_summary)#

For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.

預覽。 coverage.json → gap_summary 用於統計 Telegram 所分配但此 收集器從未偵測到的訊息編號。Telegram 會針對每個頻道或超級群組編號一次,並針對每個 帳號在私人聊天、機器人及一般群組中各編號一次。兩個已偵測 訊息之間的編號,要麼已被偵測到,要麼缺失;若為連續範圍,則表示 該範圍內所有編號的訊息均已被偵測到。若出現編號缺口,則不指明任何行為者或原因。

領域 含義
status on,或在「更多工具」→「參數」→「差距分析」中關閉時為 off
parameters 產生該結果的參數,以便能夠重現該結果
chats[] 每個頻道或超級群組各佔一筆記錄,每筆記錄均獨立編號
account 整個帳戶範圍內的私人聊天、機器人及一般群組的序列
status (依序列而定) applicable,或 not_applicable 使用 reason
observed_from, observed_to, span 首次與最後一次觀察到的號碼,以及該範圍的大小
observed, observed_without_content 觀察到的數字;僅能透過刪除或重新檢查記錄得知的數字
missing, density, gap_ranges, largest_gap 從未觀察到的數字、其在範圍中所佔的比例、運行次數、最長運行時間
clusters[] 列出的缺漏: low, high, missing,以及相鄰的觀察號碼 after / before 及其觀察時間
service_estimate 僅在啟用時顯示:根據其觀察到的佔比,有多少個缺失的號碼屬於服務訊息。從未從中扣除 missing

有效性源自日誌,絕不預設:

  • 頻道與超級群組的統計是按每則聊天進行計算,在選定聊天的匯出檔案中亦同。 由發送者選定的記錄將作為統計依據 not_applicable.
  • 全帳戶序列僅從 在「全帳戶收集」功能啟用期間收到的第一則至最後一則訊息開始計算,並包含私人聊天、機器人、一般 群組以及該帳戶自身的訊息,且不排除任何此類聊天(scope.changed)。 以 deletion.unscoped 計數的數字均視為已觀察到的訊息,但不包含內容。若僅對選定的聊天室進行匯出或 移交,則無法測量此數值。若「全帳戶收集」功能曾被 關閉後又重新開啟,系統會註明在此期間使用的數字將顯示為空缺。
  • 服務訊息是具有獨立編號的日誌記錄,因此會自行填補空缺; 可選的預估時間僅供上下文參考。

verify.py 重新計算 gap_summary 根據 events.jsonl 使用簽名 coverage.json 成員中的參數(針對較舊的存檔採用預設值),並 在覆蓋範圍摘要中列印該帳戶範圍內的行。該存檔的 get_capture_status(MCP 與命令列)針對某次存取可能讀取的聊天室,會返回相同的測量結果; 而帳戶層級的序列僅適用於涵蓋整個工作區的存取。

對同一服務訊息的重複觀察僅計為一次,且帳戶服務估算 僅使用測量範圍內的數值。在啟用全帳戶測量之前,所套用的範圍必須明確保留 該帳戶自身的訊息;測量 將從攜帶該資訊的記錄開始。測量範圍涵蓋正在執行的 觀察,且其恢復狀況會被記錄。即時存檔查詢設有時間 預算(包含其資料庫掃描),並將未完成的測量標記為「部分完成」。

Telegram 會記錄各自獨立的訊息 ID 序列。 這些數字描述了觀察結果;刪除通知、重新檢查以及管理員日誌記錄 為何在 Telegram 報告的位置中,某個數字會缺失。

當 Telegram 停止接受該帳戶時,結束監測的 coverage.gap 記錄 會攜帶 cause(account_banned、account_frozen、account_deleted、session_duplicated、 session_revoked、session_expired、session_ended 或 not_authorized)以及 Telegram 錯誤;verify.py 則標示該週期結束的原因。

覆蓋範圍結合了記錄的觀察期間、中斷及訊息結果。 請配合選定的聊天室、期間及附件政策一併評估;重新檢查 結果與記錄的缺口,可顯示該帳戶的更新被觀察到的完整程度。

製作人#

證據 ZIP 檔案、聊天記錄匯出、見證者日誌以及 人員檔案的聲明中所包含的簽名清單皆包含 producer:軟體、版本、專案(PhishDestroy)、 首頁及原始碼儲存庫。HTML 報告與驗證器會顯示此簽名 的 producer 記錄。原始檔雜湊值用於識別所記錄的原始碼樹,以便與 可信的檢出版本進行比對。 執行來源可追溯性會透過 GitHub 取得證明或 Intel TDX 測量(若已啟用)分別進行驗證。在 「產生者」欄位存在之前所建立的存檔仍受支援,並被識別為舊版記錄。

每個 observation.started 記錄亦會標明進行監測的 Telegram 客戶端:其 api_id (絕非雜湊值),無論該客戶端是內建的公開鍵對還是營運商自有的應用程式, Telegram 連線請求中傳送的客戶端描述,以及連線 路徑的類型與 IP 模式(不含代理伺服器地址或密鑰)。 該報告與custody.json列出了每個 不同的客戶端及路由,並標註其記錄時間,以及未列出的代理未回應的時間點, 以及Telegram偵測到伺服器位址的時間。此前記錄的日誌皆有載明。

人物簡介#

系統會應要求,根據日誌中已有的 單一聊天記錄,建立一個個人檔案檔案(tgwitness-dossier-v1,JSON);不會從 Telegram 擷取任何資料,且個人檔案內容絕不會 寫入日誌(啟用或停用個人檔案的動作會以 dossier.changed 形式記錄)。 針對每位擁有已儲存訊息的使用者,系統會列出其姓名與使用者名稱歷史紀錄、Telegram 標記 (機器人、詐騙、假帳號、付費帳號、已驗證、受限、已刪除)——以儲存當下的狀態為準——以及個人資料 照片 ID、來自本地頭像快取中與該頭像相似的頭像之 SHA-256 及感知雜湊(pHash,相容於 imagehash.phash), 活動紀錄(第一則與最後一則訊息、 數量、已編輯及已刪除的分享、按 UTC 小時劃分的訊息)、誰回覆了誰、該人物曾發文的 中該人曾發文的對話,以及被提及的錢包(BTC、EVM、TRON、TON、LTC、 DOGE、XMR、SOL;Base58Check 地址已通過校驗和驗證)、電話號碼、使用者名稱及 連結,包括隱藏於文字後面的連結。

每個事實都會列出其來源的日誌記錄(seq),而 record_hashes 則包含 每個被引用的記錄的雜湊值。該陳述已使用工作區金鑰進行簽署:

python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip

會檢查簽名、驗證證據匯出檔本身(包含簽名、雜湊鏈及檔案), 並確認每個被引用的記錄在同一工作區的該匯出檔中均完整無缺且未經修改。頭像雜湊值會標示為來自本地快取 (而非日誌記錄)。提及內容屬模式匹配,是待查證的線索。 各聊天室皆可個別啟用個人檔案功能,可匯出為帶有密碼的 AES-256 加密 ZIP 檔案,且 當個人檔案功能關閉,或該聊天室從來源中移除時,相關資料即會被刪除。

獨立見證人#

會證日誌(tgwitness-witness-v1)及其頻道貼文會透過 verify.py --witness … --channel … 指令,對照證據匯出檔進行驗證;請參閱獨立會證。 透過公開的 https://t.me/s/… 或 https://telegram.me/s/… 網址,驗證者會從 Telegram 讀取 每則貼文的日期,而匯出檔開頭處最早的貼文日期 即為最後一筆記錄的外部時間。來自任何其他來源的日期均屬補充元資料。

清單與檢查點#

manifest.json 包含格式、匯出時間、公鑰、指紋、日誌 長度、頭部雜湊、範圍、產生者、限制,以及除 manifest.json 和 manifest.sig 本身以外 每個內容成員的 SHA-256 雜湊值。 manifest.sig 是對規範化 manifest JSON 進行 Base64 編碼的 Ed25519 簽名。 驗證器會拒絕處理意外出現或缺失的成員、名稱重複、檔案損毀、 序列/鏈路中斷、無效簽名,以及與提供的檢查點不符的情況。 它絕不會提取存檔路徑。它將聲明之總未壓縮大小限制為 4 GiB; --max-gib N 可透過提高「更多工具 → 參數」中的限制,製作更大的存檔。

大型檔案庫會由多個程序同時進行檢查:成員資料會並行進行雜湊運算, 且在前 5,000 筆記錄處理完畢後,各筆記錄的內容雜湊值與簽名將由 工作程序進行檢查,同時主程序則依序追蹤鏈結、覆蓋範圍及綁定關係。 --jobs N 設定進程數量;預設值 auto 設定為每個 CPU 一個, 最多 16 個,而 --jobs 1 將所有處理集中於單一進程中。無論採用何種方式,結果皆相同, 且若嘗試變更,系統將以相同訊息拒絕。在該單次掃描過程中,會保留由保留的 檢查點和時間戳記錨點所指定位置的雜湊值,因此無需再次讀取日誌即可 對每個錨點進行比對。 在 32 執行緒的電腦上,一個包含 400,000 筆記錄、大小為 10.8 GB 的存檔,在單一執行緒下耗時 58.9 秒,使用 4 個執行緒時為 15.2 秒,使用 16 個執行緒時為 8.4 秒;依序掃描 記錄一次後,即設定好上限。

請從您已安裝的 TgWitness 版本或經審核的代碼檢出版本執行驗證。 壓縮檔中包含的副本支援可攜式使用;在執行該副本之前,請先將其與您的 可信安裝版本進行比對。

檢查點會對一份聲明進行簽名,該聲明包含公鑰、日誌長度、頭部 雜湊值以及建立時間。它同時攜帶工作區所 擷取的最新 drand 輪次(drand_anchor ):收集器會在每次定期檢查點建立前,透過工作區的 外部路由向 drand 中繼器發出請求,因此「隱藏 IP」、代理伺服器以及已關閉的 外部路由均會生效,且建立檢查點本身絕不會連線至外部。 驗證者可檢查 後續的存檔是否包含相同的前綴。透過 --checkpoint 和 --check-drand ,驗證者會與 drand 中繼站確認該輪次,並報告該檢查點的簽署時間 不早於該輪次的時間;該輪次不會改變保證等級。 將 檢查點保留在收集器之外,以便後續驗證時能將存檔與 另行保存的參考資料進行比對。由於檢查點由收集器金鑰簽署,因此 僅當收件者透過 其他管道在取得存檔之前便已獲得該檢查點時,才將記錄與其綁定;若僅憑該檢查點本身,則不符合證據的最低要求。

讀取驗證結果#

驗證器會分別報告檔案完整性、簽署者錨定及可信度檢查 的結果。有效的簽名表示自簽署以來,這些位元組並未 發生變更。操作員會透過獨立的 通道將金鑰指紋提供給收件者。若無 --fingerprint,完整的檔案將通過其簽名與格式 檢查,且 signer_pinned: false,且最後一行以 EVIDENCE: minimum not met · missing: confirmed signer key.

針對需要固定簽署者且證據要求最低門檻的 自動化本機存檔政策:

python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence

請使用透過收件者可信通道保留的指紋。可信 見證者亦可透過一致的經見證日誌將收集器固定;請提供 --witness、--witness-fingerprint 及 --require-witness。若簽署者未被固定,--strict 將以 狀態 2 退出;若 --require-tier 或 --require evidence 未滿足,亦 將以狀態 2 退出。--require evidence 需搭配 --fingerprint 以及來自 第三方、涵蓋最後一筆記錄的外部時間戳。 請參閱 signer_pinned、requirements_met 以及保證結果,而非僅 參考退出代碼。密封獲取則會使用其 證明驗證器及經核准的政策來驗證獲取摘要。

驗證範圍#

驗證程序會檢查檔案及其生成所使用的收集模式。請選擇 其信任邊界與該情況相符的模式,並保留其驗證輸入。

收集模式 驗證者檢查的內容 驗證輸入與信任邊界
本地工作區 記錄簽名、雜湊鏈、清單及附件位元組 由接收方保留的收集器指紋及來自第三方的外部分時標:經驗證的 RFC 3161 或 OpenTimestamps 收據,或從 t.me 讀取的見證者貼文。保留的檢查點與見證者記錄用作輔助驗證依據
具備獨立見證者的本機工作區 檔案校驗,以及與見證者所保留的早期日誌前綴是否一致 見證者指紋與記錄;保管方的金鑰控管記錄顯示見證者金鑰由誰持有。使用 --channel https://t.me/s/… 時,Telegram 為貼文設定的日期提供外部時間
GitHub Actions 擷取 GitHub 對存檔摘要、經核准的工作流程與收集器提交、託管執行器、最新會話/金鑰來源以及內部存檔完整性的驗證 可信驗證者政策、呼叫者儲存庫及 GitHub 證明套件;資料蒐集作業在固定工作流程下執行
雲端部署 服務供應商的生命週期與存取紀錄、防火牆及 Cloudflare 狀態,以及收集器的簽名執行紀錄 對服務供應商及 Cloudflare 進行唯讀查詢;各項檢查的可用性取決於服務供應商
Intel TDX 機密虛擬機器 引用簽名與平台狀態,並與收集器聲明、組件及作業系統測量值進行關聯 Intel 信任鏈及預期部署指標;保留每項必備 TDX 檢查的結果

在「密封擷取」模式下,經核准的擷取者會透過經身份驗證的 Telegram 連線,在已驗證的環境內接收資料。證明機制將檔案與 該次執行綁定,因此驗證範圍涵蓋擷取過程以及後續的檔案完整性。 此機制仰賴上述的核准程式碼與平台信任鏈。 GitHub 擷取驗證要求在執行程序內建立會話,並會拒絕 使用「匯入會話」方式進行的擷取。

執行收據會記錄收集器的版本、檔案雜湊值及啟動設定。GitHub 來源追蹤與 TDX 測量結果提供環境檢查; 驗證記錄則標示已測試的配置。

訊息的來源#

Telegram 透過 MTProto 連線將訊息傳送至每個客戶端(包括官方應用程式)。該連線的授權金鑰是根據 Telegram 的 固定伺服器金鑰進行協商的,而每則更新皆會透過 該金鑰進行加密並驗證完整性。收集器透過該帳戶的經認證 連線接收訊息,並在每則觀察記錄抵達時,將其簽署至日誌中,其中包含聊天室、 訊息及發送者識別碼,以及 Telegram 為每則訊息設定的日期。在 GitHub Actions 擷取及 Intel TDX 部署中,驗證機制亦會將該連線與 簽署金鑰綁定至經核准的收集器執行程序。

日誌會記錄授權金鑰的來源。透過手機或 QR 碼登入, 或從會話檔案進行獨立登入時,會將 account.authorized 寫入,並標註 key_origin: "created";若透過匯入的 .session、TData 或 JSON 金鑰進行收集,則寫入 imported。匯入金鑰無論源自何處,該來源處亦會保留該金鑰。經認證的部署 會拒絕匯入金鑰。

一筆紀錄的 Telegram 來源,取決於該帳號的經認證連線、 日誌中的連線與擷取紀錄、與日誌 條目(tgwitness/forensics/)配對的擷取 MTProto 幀、每則 訊息的 Telegram 日期,以及(針對經認證的擷取)經驗證的執行環境。 存檔簽名 可保存該記錄以供日後核對。保留的檢查點固定了較早的日誌 邊界,覆蓋記錄顯示收集結果,而經過驗證的外部時間戳 則將已提交的位元組定位於特定時間點。

對於本機工作區,接收者需提供可信的收集器或見證者輸入。 對於密封式獲取,可信政策與證明將存檔摘要綁定至 經核准的收集器執行。這些屬於不同的驗證路徑;請回報 針對所選路徑已完成的檢查。

附件#

檔案在 media/ 目錄下以 SHA-256 雜湊值作為位址。media.saved 事件會將雜湊值與 位元組長度連結至特定的訊息事件。原始檔案名稱屬於元資料,絕非 本機路徑。 媒體資料的位元組會以非同步方式下載,因此若訊息被立即刪除,可能會導致 無法擷取。系統會顯示以下結果:收集功能已停用、檔案過大/大小未知、下載失敗, 以及下載中斷。若程序發生當機,可能會留下 未被引用的部分檔案;這些檔案不會包含在匯出檔案中。

ZIP 匯出工具會根據檔案名稱驗證儲存的媒體檔案。JSONL、CSV 和 HTML 匯出格式會驗證事件簽名,但不包含媒體位元組。衍生報告 僅供方便使用;events.jsonl 才是具有權威性的事件表示形式。

完整聊天記錄匯出會將工作區附件設定中的附件儲存至 media/ 目錄,並以 SHA-256 作為檔案名稱。 chat.json 中的每則訊息記錄會標示其檔案名稱(file、 file_sha256)或缺失原因(file_status),並一併記錄讀者所見的 文字周邊內容:文字後方的連結、轉發來源、機器人按鈕、簽名、瀏覽次數以及 自動刪除計時器。verify.py 會檢查每個被標示的檔案是否存在於該雜湊值對應的 簽名清單中。

持久的蒐集與處理收據 (0.2)#

媒體任務及其訊息事件提交將整合於單一交易中。 該任務儲存 原始 TL 訊息描述符;經簽名的觀察記錄會綁定其 SHA-256 值、帳號 及大小政策。還原功能會在下載前驗證該綁定關係。系統絕不會擷取 當前訊息,也不會默默替換為較新的附件。中斷的任務 會重新嘗試執行,而永久失敗則仍為明確的結果。

每個工作區皆擁有專屬的日誌與簽署身分。process.started 事件包含 執行 ID、本地時鐘、依賴項版本、原始碼檔案雜湊值、初始帳戶/範圍, 以及擷取設定。心跳訊息包含執行 ID、單調時間及佇列狀態。 執行收據亦可下載為一份獨立簽署的聲明。若要驗證 執行環境,請將其與「驗證範圍」中所述的 GitHub 證明或 TDX 檢查 搭配使用。

自動檢查點會在啟動時、觀察期間每五分鐘 (更多工具 → 參數 → 每隔一次建立簽名檢查點),以及正常停止時,保留在本地端。啟動驗證與匯出會將日誌 與最新保留的本地檢查點進行比對。當檢查點仍存在時,此機制可偵測到資料庫回滾 的情況。獨立保留機制確保該參考資料可在工作區 之外取得;經驗證的外部時間戳記則進一步將其錨定於特定時間點。

重新啟動後,將恢復已儲存的 Telegram 更新位置(catch_up_from 在 observation.started),並會重新請求遺漏的更新。已儲存的位置僅涵蓋處理已完成的更新,因此當連線中斷或程序停止時仍處於待處理狀態的更新,將會被重新請求。定期重新檢查會記錄 message.recovered 遺漏的訊息,並 message.missing_on_recheck 當 Telegram 不再返回已儲存訊息時;後者並非刪除通知,亦未指明刪除者或時間。

站外備份與還原 (S3)#

異地副本(設定 → 通知與異地副本 → 異地副本,或 更多工具 → 進階功能 → 證據與備份;預設為關閉)會將日誌區段、保留檔案、檢查點 連同其時間戳記,以及已完成的聊天記錄匯出上傳至 S3 相容儲存空間,並在 上傳前使用儲存於工作區金庫中的金鑰,透過 AES-256-GCM 進行加密;若儲存桶支援,則會套用 Object Lock 保留機制。 若未下載金鑰,則無法讀取該副本。請使用 python -m tgwitness.replica restore --key-file KEY.json --out DIR 進行還原與驗證。

還原功能需要一個空的普通資料夾。下載的檔案及解密後的物件會暫存於私有 臨時儲存空間中,直至整個日誌及每個保留的檢查點均通過驗證為止。不安全的物件 路徑、不一致的區段範圍,以及長度短於檢查點的日誌均會被拒絕;驗證失敗時 將不會發布任何還原檔案。 保留檢查會將回傳的「物件鎖定」 模式與日期,與上傳時傳送的截止時間進行比對(容許一秒的四捨五入誤差)。已過期、 無效或縮短的截止時間均不視為已驗證。狀態會回報該次上傳過程中 讀取到保留狀態的抽樣物件。

若本地媒體檔案遺失或損毀,系統會將其標記為當次處理的錯誤,並將媒體游標停留在 該處之前,以便在下一次處理時重新嘗試讀取該檔案;其後面的檔案、檢查點及匯出內容仍會 照常複製。還原過程會 將所有已保存媒體的參照與解密後的雜湊值及記錄的大小進行比對。 來自中斷上傳的 相同重疊日誌區段將被去重;衝突的重疊區段則會被拒絕。 上傳過程中建立的檢查點會被延遲,直到其所涵蓋的日誌記錄已被 複製為止,因此完成的處理階段不會在日誌之前發布檢查點。

串流匯出快照#

串流匯出採用穩定的 SQLite 讀取快照。當下載完成時,其起始點可能比 當前的即時日誌更早。在此快照之後建立的檢查點 可能會正確地顯示該存檔較短;請與位於匯出前綴處或之前的檢查點 進行比較,而非任意的較晚檢查點。

RFC 3161 準備與回應驗證 (0.2)#

「證據模式」僅會透過工作區路徑(絕不經由 MTProxy),將每個已簽署檢查點的 SHA-256 雜湊值傳送至列出的 RFC 3161 授權機構及 OpenTimestamps 日曆。 在每個設定目標中,時間戳記預設為啟用狀態;案件的證據也會記錄 drand。 回覆會儲存於 checkpoints/anchors/中,並匯出為 .tsr 以及 .ots 檔案,位於 anchors/, 並由 verify.py (--tsa-ca 檢查 TSA 簽名;使用 確認 OpenTimestamps 證明 並 ots upgrade 及 ots verify).

若 RFC 3161 授權實體連續兩次失敗,將在下次嘗試前進行等待:先等待一個間隔,接著 兩個、四個,以此類推,最長可達六小時,或依其 Retry-After 設定的時間,最長可達一天。若一次檢查 僅發現處於等待狀態的授權實體,則不寫入任何記錄;否則,anchor.completed 會將其列於 deferred 之下,並附上 retry_at。在它們再次回應之前,面板將顯示時間戳記為「效能下降」。

該面板會準備一個請求存檔,其中包含標準化的 checkpoint.json 位元組、 SHA-256 訊息印記以及隨機非ce(nonce),並收錄於 timestamp.tsq 檔案中,同時包含校驗和與操作說明。 此過程不會發出任何網路請求;權威機構針對此請求所返回的標記即為時間戳記。

python -m tgwitness.anchor verify 不需要 OpenSSL,就能依據檢查點位元組和原始請求核對回應。必須明確指定受信任的 CA 檔案;隨附的憑證不會自動受信任。在 CLI 中請求檢查是選用的,因此請保留請求,並傳入 --request 以檢查 nonce。結果會說明是否已檢查。收集器的檢查點簽章和日誌仍需使用受信任的收集器指紋另行驗證。

驗證程序會根據指定的 CA 信任關係,檢查回應簽名、檢查點位元組,以及(若已提供) 原始請求。對於在證據模式下取得的時間戳記, verify.py 還會檢查儲存的 OCSP 或 CRL 證據(簽署憑證撤銷)。 請參閱 程序 以及 驗證結果.

證據模式下的可選記錄:drand 及 Telegram 裝置#

還有兩項記錄可以與時間戳記在相同的處理階段中執行。這兩項記錄僅在 證據模式開啟時才會生效。 案件的證據 啟用 drand;否則兩者都會啟動。請在 「更多工具」→「附加功能」→「證據與備份」→ 中切換設定 更多證人 · 可選, 或 "drand": true 以及 "devices": true 在 POST /api/evidence. 其中一項失敗並不會阻礙 另一項或時間戳記的運作;面板會在表單下方顯示各項的最新結果。

drand (beacon.drand )。每次處理都會將最新一輪的 drand quicknet(即「熵聯盟」的公開 隨機數,每 3 秒一輪)寫入日誌:chain 、 round 、randomness 、signature 、round_time 以及回應的 relay 。一個經過驗證的 不可預測的輪次,為後續透過雜湊連結的材料提供較早的時間參考點。 後續檢查點上的經驗證時間戳記則提供時間上限參考。這些檢查 界定了鏈結資料的範圍。收集器會先查詢 drand.cloudflare.com ,接著透過工作區路徑查詢 Protocol Labs 的中繼站,每輪執行一次請求。

verify.py 會檢查每個隨機數是否為其簽名的 SHA-256 ,並確認 輪次時間是否正確,同時回報輪次數、最長未產生隨機數的區間,以及 收集器時鐘相對於 drand 的滯後程度。 --check-drand 會將輪次與 Cloudflare 中繼站、Protocol Labs 中繼站,或是長日誌中所有中繼站, 或隨機抽取的 100 個樣本進行比對;若有任何一輪次不符,驗證即告失敗。

、Telegram 裝置、(account.devices)。每次掃描都會讀取該帳戶與 account.getAuthorizations 的會話,以及「設定」→「裝置」中顯示的 Telegram 清單,並完整記錄: 若自上次處理後有所變更,則完整記錄該清單,並包含added與removed的 會話雜湊值;否則僅記錄其數量及SHA-256。裝置型號、平台、應用程式及版本、 建立時間與最後活動時間、國家及地區均予以保留;IP 位址則不予保留,因為 證據匯出後便不再由您掌控。 收集器自身的會話始終處於活躍狀態,因此 僅有其他會話的活動才被視為變更。verify.py 會回報清單 被記錄的頻率,以及每個新建立與結束的會話。它僅在觀察程序執行期間讀取該清單。

這些內容顯示:drand 會根據公開時間將記錄排序,而裝置 清單則是 Telegram 透過收集器發布的聲明,如同其他 所有記錄一樣,由收集器簽署。

Cloudflare Gateway 日誌 (cloudflare.gateway_dns)。 對於透過 Cloudflare Gateway( Gateway DNS )進行解析的伺服器,每次 複製都會擷取自上次複製以來 Gateway 所記錄的內容:每個時間窗(最長三 小時)對應一筆記錄,包含 from、until、location_id、伺服器的 address(若已設定),以及 queries(當其值為 [at, name, type, rcode, decision, colo] 時,即使該欄位為空亦然)。 請在 下設定 Cloudflare Gateway 日誌 :帳戶、位置、可選地址以及一個唯讀代幣(帳戶 分析讀取權限;零信任 PII 讀取權限,用於保留共享位置中的一個地址)。控制面板會在儲存前透過單一請求驗證 這些資訊;憑證始終保持加密狀態,且絕不會進入日誌。 verify.py 列出時間窗、查詢最頻繁的名稱,以及任何未被副本涵蓋的時間點;若某筆記錄 的計數與其查詢不符,則會失敗。 若某個時間窗在單一秒內包含超過一頁的 查詢,則保留該頁並標示其餘部分遺失。該副本是 Cloudflare 透過收集器傳回的回應,並由收集器簽署;在 24 小時內,任何持有 唯讀憑證者皆可將其與 Cloudflare 進行比對。