文件說明 / 07

匯出與驗證

分享一份經簽署的紀錄，供他人核實。

保留參考資料匯出已簽署的 ZIP 檔案收件者驗證

初次接觸簽名與檢查點？試著修改一個範例記錄，看看哪些檢查機制會偵測到此變更。

想將副本存放在收集者之外的地方嗎？請前往 S3 設定、Object Lock 或驗證式還原。

保留可信的參考資料

請將工作區的公鑰指紋儲存於收集器之外。在收集過程中，請將簽署過的檢查點存放在其他位置，或使用獨立見證者。這些參考資料可讓接收者驗證金鑰及較早的日誌邊界。

下載已簽署的 ZIP 檔案

點選「匯出」並建立一個經簽署的證據 ZIP 檔案。該檔案包含工作區日誌及經簽署的檔案清單。面板篩選器不會限制此完整日誌的匯出：請在分享前審閱相關內容。

獨立的 HTML 和 CSV 檔案可供下載，方便閱讀與分析。請將簽名過的 ZIP 檔案保留為可驗證的原始檔；獨立的 HTML 或 CSV 檔案並未附帶獨立的簽名。

請使用可信賴的 TgWitness 副本進行驗證

在已安裝的專案環境中，請替換範例中的指紋與檔案路徑：

python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --checkpoint retained-checkpoint.json

當兩項參考值均通過驗證時，結果將顯示 key_pinned: true 和 checkpoint_checked: true。請將驗證結果與原始存檔一併保存。保留的檢查點必須位於匯出檔案的邊界處或之前。

理解結果

完整性：記錄的歷史紀錄與匯出的檔案均與其數位簽章相符。
先前觀察：透過外部檢查點，您可以將匯出檔案與先前保留的日誌前綴進行比對。
實作方式：透過「發送 → 編輯 → 刪除」的受控測試，將特定事件與擷取的記錄進行比對驗證。

有效的簽名並不能證明每則 Telegram 事件均已送達、來源所言屬實，或資料收集者的時間記錄正確無誤。

設定 S3 異地備份

在您的運作中工作區中，開啟「匯出」→「異地備份」。此選用功能支援 AWS S3 及其他相容於 S3 的服務。它會複製日誌區段、已保存的照片與檔案、附帶時間戳記回應的檢查點，以及已完成的聊天記錄匯出檔。每個物件在上傳前，都會在收集器上透過 AES-256-GCM 進行加密。

線上示範版本展示相同的操作介面，但已停用上傳功能。請僅在您自己正在運行的工作區中輸入儲存憑證。

完整的異地複製設定面板：終端點、區域、儲存桶、存取金鑰、排程、物件鎖定及復原金鑰控制 — 已展開包含進階選項的完整控制面板。畫面中未顯示任何儲存憑證。

儲存設定位於「匯出」→「異地副本」
領域	輸入內容
Endpoint	儲存服務的 URL，不含儲存桶路徑或憑證。虛構範例：`https://s3.example.invalid`。
地區	您的服務供應商所要求的區域代碼。應用程式的預設值為 `us-east-1`。
Bucket	一個您可存取的現有儲存桶。虛構範例：`example-case-backup`。
儲存桶中的資料夾	物件前綴；預設值為 `tgwitness`。應用程式會附加一個由此工作區簽名金鑰指紋衍生的前綴。
存取金鑰 ID / 秘密存取金鑰	請同時輸入兩組儲存憑證。這些憑證將儲存於工作區金庫中。後續儲存時，若要保留已儲存的憑證對，請將兩欄皆留空。
Path 風格的網址	請根據服務供應商的設定，在啟用時使用 `endpoint/bucket`，或在停用時使用 `bucket.endpoint`。
複製間隔	範圍為 1 至 1,440 分鐘；預設為 5 分鐘。若要執行排程備份，應用程式必須處於運行狀態。
Object Lock 資料保留	支援 Object Lock 的儲存桶之保留天數與模式。若設定為「零天」，則該儲存桶將維持預設的保留設定。

輸入目標位置及憑證。準備期間請保持「保留異地副本」選項未勾選，隨後選取「儲存異地副本」。
選擇「測試連線」。此操作會上傳一個加密的測試物件，並檢查儲存端的回應。
請選擇「下載加密金鑰」。請將該檔案與資料收集器分開存放；此檔案是進行資料復原的必要條件。
勾選「保留異地副本」核取方塊，然後再次儲存。選擇「立即複製」以執行手動備份，或讓排程繼續運行。

不執行 不會建立儲存桶。當應用程式停止運作時，排程上傳也會停止。

檢查資料保留狀況與複製進度

在「更多選項」中，請選擇保留天數，並在您的儲存桶支援 Object Lock 時選擇 GOVERNANCE 或 COMPLIANCE。TgWitness 會讀取已上傳物件的保留模式與截止日期。狀態報告會顯示確認、保留缺失或驗證失敗；僅成功上傳並不代表保留已確認。

控制面板會顯示上一次處理的結果、物件數量、傳輸的位元組數、已複製的日誌邊界以及任何錯誤。若發現本地儲存媒體遺失或遭變更，系統會進行通報，並於下一次處理時重新嘗試。該儲存媒體之後的檔案、檢查點及排程中的匯出項目仍可照常複製。

上傳資料時，系統會使用工作區的 Direct、SOCKS5 或 HTTP 路徑。透過 MTProxy 無法進行 S3 複製；該應用程式不會回退至直接連線。

不強制 僅因上傳請求被接受，並不代表服務提供者會強制執行「物件鎖定」（Object Lock）。

請將恢復金鑰另行存放

下載的 JSON 檔案包含解密金鑰、目標設定、工作區物件前綴以及簽名金鑰指紋。該檔案不包含 S3 存取憑證：還原時需另行提供具備桶（bucket）讀取權限的憑證。

若您變更了端點、儲存桶或資料夾前綴，請重新下載金鑰檔案，以確保其目標設定相符。應用程式會將本機保留的日誌、檔案及檢查點的全新副本，移至新目標位置。已完成且已從本機上傳佇列中移除的聊天記錄匯出檔，仍會保留在原有的目標位置。

無法執行 若未持有匯出的金鑰，則無法解密該副本。儲存空間存取憑證無法取代該金鑰。

在另一台機器上還原並驗證

請使用可信賴的 TgWitness 安裝版本、已下載的 JSON 金鑰、具備讀取權限的儲存空間憑證，以及一個空的輸出目錄。請替換下方虛構的憑證佔位符。

Windows PowerShell

$env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY'
$env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY'
python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence

Linux / macOS

export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY'
export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY'
python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence

在驗證整個日誌、保留的檢查點以及媒體檔案的雜湊值與大小期間，下載的檔案與解密後的物件將暫存於私有臨時儲存空間中。若發現不安全的路徑、日誌段落衝突，或日誌長度短於其檢查點，系統將予以拒絕。驗證失敗時，系統不會發布任何還原的檔案。

若復原成功，系統將針對副本中的可用內容產生 events.jsonl、media/、checkpoints/ 及 exports/。請將該指令的 JSON 結果與復原的內容一併保存。

不具備以下功能：本工具不會重建未曾記錄於日誌中的觀察結果，亦不會取代獨立保留的檢查點或證人。