TgWitness / Tài liệu hướng dẫn

Những nội dung đã được kiểm thử →

Tham khảo / Thu thập

Telegram · Tải lịch sử nguồn

Tải các tin nhắn trước đây từ các nguồn đã được kích hoạt, tạm dừng và tiếp tục, đồng thời xác minh báo cáo tiến độ có chữ ký.

TgWitness / Tài liệu · Bộ sưu tập

Bộ sưu tập

Trong phần Công cụ khác → Nguồn → Các cuộc trò chuyện trong phạm vi, hãy xem lại các cuộc trò chuyện đã được kích hoạt, chọn “API tiêu chuẩn” hoặc “Xuất Takeout”, sau đó chọn Tải toàn bộ lịch sử. Quá trình này sẽ sửa danh sách các nguồn đó và đọc các tin nhắn trong quá khứ có sẵn vào phần “Cuộc trò chuyện” và nhật ký quan sát đã ký. Phần “Tệp đính kèm” sử dụng các cài đặt tệp đính kèm hiện có và hàng đợi tải xuống lâu dài. Tính năng này độc lập với tính năng xuất JSON/HTML đã ký cho từng cuộc trò chuyện.

Để thu thập dữ liệu trên toàn tài khoản, hãy chọn “Toàn bộ tài khoản ” và lưu phạm vi. Lịch sử sẽ làm mới tất cả các cửa sổ trò chuyện có thể truy cập, bao gồm cả các cuộc trò chuyện đã lưu trữ, trước khi ký danh sách nguồn của chúng. Quá trình phát hiện này không tuân theo giới hạn danh sách của công cụ chọn cuộc trò chuyện đã chọn. Các cuộc trò chuyện được phát hiện sau đó sẽ được theo dõi và nhận bản chụp nhanh ban đầu đã được cấu hình; một lần chạy đầy đủ khác có thể tải lịch sử trước đó của chúng. Hãy giữ tùy chọn Tiếp tục theo dõi trong và sau khi tải lịch sử được bật để ghi lại các tin nhắn mới, các chỉnh sửa và thông báo xóa trong khi lịch sử đang được tải. Một lần chạy hoặc xuất lịch sử sẽ sử dụng khe thu thập; quá trình quan sát trực tiếp diễn ra song song với quá trình này.

Chọn từ một đến ba cuộc trò chuyện diễn ra đồng thời, từ một đến năm nhân viên xử lý tệp đính kèm và quyết định xem có giữ lại các “Hành động gần đây” hiện có hay không, cũng như so sánh các phiên bản đã lưu trước đó. Việc “Takeout” có thể cần được phê duyệt trong Telegram và thời gian chờ do máy chủ quy định. Các tùy chọn này vẫn được giữ nguyên khi tiếp tục. Xem hành vi Backfill và hợp đồng bằng chứng để biết chi tiết về truyền tải, thử lại và độ tin cậy.

Tạm dừng, khởi động lại và kết quả một phần#

  • Lịch sử tạm dừng ngừng đọc. Lịch sử tiếp tục tiếp tục từ tin nhắn cuối cùng đã được lưu trong mỗi nguồn; việc khởi động lại ứng dụng cũng khiến quá trình chạy bị tạm dừng cho đến khi được tiếp tục. Việc tiếp tục yêu cầu cùng một tài khoản Telegram không hoạt động.
  • Việc quan sát tin nhắn, xử lý tệp đính kèm và ghi lại vị trí con trỏ được thực hiện trong một giao dịch duy nhất. Một phiên chạy được tiếp tục sẽ không lặp lại các quan sát đã được ghi lại trước đó. Việc ghi lại trực tiếp hoặc một phiên chạy riêng biệt, được khởi động rõ ràng, có thể quan sát độc lập cùng một tin nhắn.
  • Mỗi nguồn (mỗi phạm vi phân chia Telegram trong Takeout) sẽ cố định một ID tin nhắn tối đa ngay từ lần đọc đầu tiên. Các tin nhắn mới hơn thuộc về quan sát trực tiếp, chứ không thuộc về các trang lịch sử còn lại của nguồn đó.
  • Các nguồn không thể truy cập và các nguồn bị vô hiệu hóa trong quá trình thu thập vẫn hiển thị dưới dạng thất bại hoặc bị bỏ qua. Các nguồn khác tiếp tục hoạt động; kết quả tổng thể là không đầy đủ.
  • Telegram chỉ hiển thị nhật ký quản trị của một cuộc trò chuyện cho các quản trị viên. Đối với một thành viên thông thường, việc truy cập nhật ký quản trị sẽ được ghi lại dưới dạng `history.admin_log.unavailable` với reason: not_admin và không làm cho lịch sử cuộc trò chuyện trở nên không đầy đủ; ngược lại, việc truy cập nhật ký quản trị không thành công đối với một quản trị viên thì sẽ làm cho lịch sử cuộc trò chuyện trở nên không đầy đủ.
  • Thời gian chờ FloodWait tuân thủ khoảng thời gian chờ đã lưu của tài khoản. Các lỗi tạm thời sẽ được thử lại tối đa năm lần; khi hết lượt thử hoặc dung lượng đĩa thấp, quá trình sẽ tạm dừng nhưng con trỏ vẫn được giữ nguyên.
  • Kết thúc phiên chạy lịch sử này giữ lại các quan sát đã lưu. Tính năng này không xóa chúng hoặc hủy các tác vụ đính kèm theo API tiêu chuẩn. Việc kết thúc Takeout sẽ đánh dấu các tệp Takeout còn lại là đã bỏ qua; việc tạm dừng cho phép tiếp tục các tác vụ này sau này. Một phiên chạy mới sẽ đọc lại các nguồn đã bật.

Việc hoàn tất lịch sử chỉ mô tả các lần đọc lịch sử. Các tệp đính kèm có thể vẫn đang chờ xử lý, thất bại hoặc bị loại trừ theo chính sách đã cấu hình. Kiểm tra biên nhận phương tiện trong sổ ghi chép và hàng đợi tệp đính kèm; chỉ biên nhận đã hoàn tất với các byte được bảo toàn mới được coi là tệp đính kèm đã được lưu. Hoạt động lịch sử là một yêu cầu chụp nhanh rõ ràng và khác biệt với các tùy chọn chọn các danh mục sự kiện trực tiếp trong tương lai.

Chuyển giao và xác minh#

Lưu báo cáo tiến độ đã được ký, sau đó sử dụng tính năng “Xuất bằng chứng” để tải xuống sổ nhật ký và các tệp đính kèm đã lưu. Việc xuất bằng chứng sau này có thể bao gồm các bản ghi bổ sung; báo cáo này liên kết các bộ đếm của nó với tiền tố của sổ nhật ký tại thời điểm nó được tạo ra. Chạy trình xác minh từ một bản sao đáng tin cậy của phiên bản này:

python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT

Giữ riêng biệt dấu vân tay khóa ký dự kiến. Trình xác minh kiểm tra chữ ký báo cáo, kho lưu trữ bằng chứng, điểm kiểm tra báo cáo, kế hoạch nguồn, tài khoản và số lượng tin nhắn đã lưu/không khả dụng. Các lần chạy mới cũng liên kết tiến trình nguồn và các tùy chọn với các sự kiện con trỏ đã ký. Nếu không có --evidence, công cụ chỉ kiểm tra báo cáo đã ký và tính nhất quán nội bộ của nó. Các trường tiến trình cũ và tóm tắt tệp đính kèm vẫn là các tuyên bố đã ký của người thu thập. Công cụ xác minh bằng chứng kiểm tra các byte phương tiện đã lưu trữ.

Đọc lịch sử đã được xác minh cùng với các khoảng thời gian thu thập, phạm vi bao phủ và các Hành động Gần đây có sẵn. Quy trình làm việc này đọc lịch sử hiện có thể truy cập; giám sát trực tiếp lưu giữ các phiên bản và thông báo ngay khi chúng đến, trong khi các Cuộc trò chuyện Bí mật sử dụng tích hợp điểm cuối đã được kích hoạt. Để xác minh, hãy sử dụng các điểm kiểm tra được lưu giữ, bản ghi của người chứng kiến và các chứng nhận thu thập áp dụng được mô tả trong các chế độ xác minh.

Con trỏ thu thập dữ liệu phản ánh trạng thái hiện tại của không gian làm việc cục bộ. Việc khôi phục tệp ZIP chứa bằng chứng sẽ không khôi phục công việc thu thập dữ liệu đang chờ xử lý hoặc phiên Telegram. Hãy giữ bản sao lưu không gian làm việc nếu cần tiếp tục công việc ban đầu.