# TgWitness · Tiếng Việt > Documentation edition: Tiếng Việt. Project version: `0.9.3`. Source branch: `main`. This index links the Markdown editions of the public pages. The complete handbook is built from the same page content, including source URLs. Sections without a translation appear in English. - [Project context, installation, measured scale and verification](https://phishdestroy.io/tgwitness/docs/reference/overview/index.md) - [English project summary](https://phishdestroy.io/tgwitness/llms.txt) - [Complete handbook · Tiếng Việt](https://phishdestroy.io/tgwitness/vi/llms-full.txt) - [Complete handbook as Markdown · Tiếng Việt](https://phishdestroy.github.io/TgWitness/vi/llms-full.md) - [Source code and release history](https://github.com/phishdestroy/TgWitness) - [Collection modes and evidence levels](https://phishdestroy.io/tgwitness/vi/guides/modes.md) - [Published checks and measurements](https://phishdestroy.io/tgwitness/docs/validation/index.md) ## Complete documentation map ### Guides - [Quản lý kho lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/archive/index.md): Xem lịch sử tải xuống, tìm kiếm các bản ghi đã lưu, xem xét các nguồn AI và kết nối các công cụ của bạn. - [Ghi lại các hành động trên GitHub Actions](https://phishdestroy.io/tgwitness/vi/docs/capture/index.md): Chọn Takeout, xuất qua API thông thường hoặc nhật ký trò chuyện trên runner GitHub tạm thời. - [Tài khoản chuyên dụng](https://phishdestroy.io/tgwitness/vi/docs/dedicated-account/index.md): Vui lòng chuẩn bị một tài khoản Telegram riêng để thu thập dữ liệu. - [Bắt đầu chỉ trong vài phút](https://phishdestroy.io/tgwitness/vi/docs/start/index.md): Cài đặt bằng một lệnh, kết nối tài khoản Telegram và xuất kho lưu trữ có thể xác minh trên Windows, Linux hoặc macOS. - [Kết nối tài khoản](https://phishdestroy.io/tgwitness/vi/docs/accounts/index.md): Kết nối Telegram qua mã QR, số điện thoại hoặc nhập phiên làm việc. Chọn các nguồn và kiểm tra xem các tin nhắn mới có được ghi vào sổ nhật ký của quý vị hay không. - [Chọn một máy chủ proxy](https://phishdestroy.io/tgwitness/vi/docs/proxies/index.md): Quản lý các tuyến đường MTProxy tự động hoặc sử dụng máy chủ proxy của riêng quý vị. Chọn chế độ IP, quy tắc dự phòng và tuyến đường cho các yêu cầu bên ngoài. - [Xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/exports/index.md): Xuất lịch sử Telegram đã ghi lại, xác minh chữ ký và so sánh sổ nhật ký với bản sao lưu được lưu giữ bởi một nhân chứng độc lập. - [Tìm hiểu cách thức hoạt động của bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/concepts/index.md): Theo dõi một tin nhắn từ khi được ghi lại cho đến điểm kiểm tra. Thay đổi một bản ghi mẫu, tính toán lại chuỗi SHA-256 của nó và xem điểm kiểm tra được lưu giữ sẽ phát hiện điều gì. - [Điều tra trên tất cả các cuộc trò chuyện](https://phishdestroy.io/tgwitness/vi/docs/cases/index.md): Tiến hành điều tra Telegram từ đầu đến cuối trên các kênh, nhóm, cuộc trò chuyện riêng tư và bot: thu thập toàn bộ tài khoản, lịch sử, danh sách người dùng, liên kết, tệp tin, dòng thời gian và bằng chứng đã được xác minh. - [Tạo Case Board](https://phishdestroy.io/tgwitness/vi/docs/case-board/index.md): Thu thập các quan sát đã lưu, các điểm nổi bật chính xác và các đoạn hành động trên một bảng riêng tư, thảo luận với nhóm của bạn và trình bày bộ sưu tập. - [Thiết kế báo cáo](https://phishdestroy.io/tgwitness/vi/docs/reports/index.md): Chọn dữ liệu báo cáo, một trong tám mẫu thiết kế và nội dung, sau đó xem trước và xuất dưới dạng HTML, PDF có chữ ký hoặc gói bằng chứng hoàn chỉnh. - [Chuẩn bị bản sao để chia sẻ](https://phishdestroy.io/tgwitness/vi/docs/handover/index.md): Chọn các bản ghi và trường dữ liệu mà người nhận có thể truy cập, kiểm tra bản sao hoàn chỉnh và xác minh bản kê khai đã ký cùng ranh giới nhật ký nguồn. - [Quản lý một nhóm tài khoản](https://phishdestroy.io/tgwitness/vi/docs/groups/index.md): So sánh các không gian làm việc nhóm, tìm nguồn, xem xét các khoảng thời gian quan sát và áp dụng các cài đặt chung với các ngoại lệ cho từng tài khoản. - [Hãy đảm bảo tính bảo mật](https://phishdestroy.io/tgwitness/vi/docs/security/index.md): Tìm hiểu vị trí lưu trữ các phiên làm việc, khóa và bằng chứng; những dữ liệu nào được truyền ra khỏi máy tính của quý vị; phạm vi bảo vệ bao gồm những gì; cũng như cách tăng cường bảo mật cho hệ thống cài đặt. - [Chia sẻ một trường hợp](https://phishdestroy.io/tgwitness/vi/docs/access/index.md): Cung cấp cho các nhà đánh giá và nhà phân tích quyền truy cập vào các tài khoản và cuộc trò chuyện được chọn lọc, kèm theo các quyền truy cập riêng biệt, giới hạn phiên làm việc và mã thông báo có thể thu hồi. - [Thiết lập bot chứng cứ](https://phishdestroy.io/tgwitness/vi/docs/witness/index.md): Xuất bản các mốc kiểm tra của sổ nhật ký đã được ký số lên kênh Telegram của quý vị thông qua một nhân chứng độc lập, có khóa riêng và quyền truy cập chỉ đọc vào bộ thu thập dữ liệu. - [Tại sao lại là mô hình Zero Trust: Taylor Wessing, Tiến sĩ Zurheide, Tiến sĩ Schelinski](https://phishdestroy.io/tgwitness/vi/docs/signed-export/index.md): Một nghiên cứu điển hình về mô hình “không tin tưởng”: một giải pháp tuân thủ GDPR do Tiến sĩ Patrick Zurheide và Tiến sĩ Tobias Schelinski thuộc công ty luật Taylor Wessing ký tên, đã được đối chiếu với chính tài liệu của nó, cùng với mô hình có thể kiểm chứng được, vốn không để lại bất kỳ khoảng trống nào cho sự gian dối hay nghi ngờ. - [Hãy duy trì hoạt động của nó](https://phishdestroy.io/tgwitness/vi/docs/server/index.md): Vui lòng chạy TgWitness trên một máy chủ có bộ nhớ lưu trữ lâu dài, quyền truy cập bảng điều khiển riêng tư, tính năng sao lưu và các quy trình kiểm tra sau khi khởi động lại. - [Tìm hiểu nguyên nhân sự cố](https://phishdestroy.io/tgwitness/vi/docs/troubleshooting/index.md): Vui lòng kiểm tra quyền truy cập bảng điều khiển, kết nối Telegram, các tin nhắn bị thiếu, FloodWait và trạng thái chứng nhân bằng cách sử dụng các tín hiệu phù hợp cho từng vấn đề. ### Reference - [Trò chuyện bí mật: thiết lập và ghi lại](https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/index.md): Cài đặt tiện ích giao thức Trò chuyện bí mật, bật cho từng tài khoản và ghi lại các cuộc trò chuyện mà TgWitness tạo hoặc chấp nhận. - [TgWitness: khởi đầu, quy mô và bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/overview/index.md): Cài đặt bằng một lệnh hoặc thực hiện trên GitHub Actions. Nắm rõ các tùy chọn điều tra, phạm vi đã công bố và những gì mà kho lưu trữ xác minh. - [Tải lịch sử nguồn](https://phishdestroy.io/tgwitness/vi/docs/reference/history/index.md): 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ý. - [Phân tích kho lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/analysis/index.md): Tìm kiếm các tin nhắn đã lưu, xem lại các đầu vào từ AI và lưu giữ các báo cáo phân tích kèm theo nguồn tham khảo. - [Dòng lệnh](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/index.md): Tìm kiếm, đọc bối cảnh, đếm hoạt động và xuất các tin nhắn đã lưu từ các skript và tác nhân, với đầu ra --json, mã thoát ổn định và các token chỉ đọc có phạm vi giới hạn. - [Tìm kiếm toàn văn](https://phishdestroy.io/tgwitness/vi/docs/reference/search/index.md): Tìm các tin nhắn đã lưu theo dạng từ, cụm từ chính xác, tên miền và @tên người dùng, hiển thị kết quả phù hợp nhất trước tiên, với chỉ mục được liên kết với nhật ký có chữ ký. - [MCP chỉ đọc](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/index.md): Kết nối một máy khách MCP với các không gian làm việc và cuộc trò chuyện đã chọn bằng quyền truy cập có thời hạn và có thể thu hồi. - [Nhận dạng ký tự quang học (OCR) và chuyển đổi văn bản tại địa phương](https://phishdestroy.io/tgwitness/vi/docs/reference/media-analysis/index.md): Nhận diện hình ảnh và âm thanh đã thu thập bằng một worker cục bộ; duy trì liên kết giữa văn bản được trích xuất và tệp nguồn tương ứng. - [Webhook đi](https://phishdestroy.io/tgwitness/vi/docs/reference/webhooks/index.md): Gửi các sự kiện trong phạm vi đến các máy chủ nhận HTTPS kèm theo chữ ký HMAC, tính năng thử lại và trạng thái giao nhận. - [Thông báo về sự không tương thích giữa các nhà cung cấp dịch vụ](https://phishdestroy.io/tgwitness/vi/docs/reference/notice/index.md): Thông báo của chúng tôi về Taylor Wessing và bản ghi nguồn liên quan. - [Thông báo về sự không tương thích giữa giấy phép và kiến trúc](https://phishdestroy.io/tgwitness/vi/docs/reference/license/index.md): TgWitness được cấp phép theo Giấy phép MIT dành cho tất cả mọi người, và lý do tại sao công cụ này không tương thích về mặt kiến trúc với quy trình làm việc của Taylor Wessing. - [Hướng dẫn bắt đầu nhanh](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/index.md): Tất cả các phương thức cài đặt và khởi chạy TgWitness: gói phần mềm dành cho Windows, Python, Docker và bản demo tổng hợp, kèm theo các bước kiểm tra ban đầu. - [Các định dạng tài khoản và phiên làm việc](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/index.md): Đăng nhập bằng số điện thoại, mã QR hoặc khóa xác thực, nhập các phiên làm việc từ Telethon, Pyrogram hoặc Telegram Desktop, và quản lý nhiều tài khoản cùng lúc. - [Quyền truy cập và quyền hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/access/index.md): Quản lý quyền truy cập vào các tài khoản và cuộc trò chuyện, chọn quyền hạn, giới hạn phiên truy cập và địa chỉ IP, cũng như thu hồi quyền truy cập. - [Kết nối, máy chủ trung gian và bảo vệ dữ liệu](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/index.md): Xác thực, nhóm proxy tự động, chế độ IP, chính sách dự phòng, yêu cầu bên ngoài và lưu trữ khóa bí mật. - [Triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/index.md): Vui lòng chạy TgWitness dưới dạng dịch vụ trên Windows, Linux, macOS hoặc Docker, thông qua kết nối HTTPS, kèm theo tính năng sao lưu và cập nhật. - [Cách thức thu thập dữ liệu](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/index.md): Phạm vi quan sát, cập nhật trực tiếp, kiểm tra lại, tệp đính kèm, các hành động của người dùng và ý nghĩa của “khoảng trống”, được ghi lại theo từng bản ghi. - [Quy trình làm việc và hoạt động](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/index.md): Hoạt động hàng ngày của bảng điều khiển: các chế độ, danh mục giám sát, thông số, thông báo, xuất dữ liệu, sao lưu và dung lượng. - [Chế độ điều tra](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/index.md): Các cuộc điều tra toàn diện về tài khoản trên các kênh, nhóm, cuộc trò chuyện riêng tư và bot, từ phạm vi điều tra cho đến bộ hồ sơ vụ việc đã được xác minh. - [Tham chiếu Case Board](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/index.md): Dấu trang, phần đánh dấu chính xác, các đoạn hành động, cuộc thảo luận, quyền truy cập có phạm vi và lịch sử chú thích đã ký được sử dụng bởi Case Board. - [Cấu hình và xác minh báo cáo](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/index.md): Các bộ lọc báo cáo, tám mẫu thiết kế, cài đặt sẵn nội dung, lịch sử thay đổi đã lưu và phần đánh giá được bao gồm trong các tệp xuất có chữ ký. - [Tính năng và phạm vi](https://phishdestroy.io/tgwitness/vi/docs/reference/features/index.md): Mô hình thu thập hiện tại, quy trình làm việc với nhiều tài khoản, tính năng xuất dữ liệu và các giới hạn vận hành của TgWitness. - [Cách thức hoạt động của bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/how-it-works/index.md): Các khái niệm về chuỗi băm, chữ ký, điểm kiểm tra và nhân chứng được giải thích kèm theo các công thức chính xác mà bên xác minh sử dụng. - [Định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/index.md): Nội dung của tệp ZIP đã được ký, các loại bản ghi, biên nhận giao dịch, hồ sơ người dùng, bản sao lưu ngoài trang web và xác minh ngoại tuyến. - [Nhân chứng độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/index.md): Vui lòng chạy một bản sao TgWitness với khóa và bot riêng, đăng các điểm kiểm tra đã được ký lên một kênh và đối chiếu các tệp xuất với các điểm kiểm tra đó. - [Dấu thời gian](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/index.md): Dấu thời gian theo tiêu chuẩn RFC 3161 cho các điểm kiểm tra có chữ ký: những thông tin nào được gửi đến cơ quan có thẩm quyền và cách thức xác minh phản hồi. - [Dịch báo cáo để nộp tòa án](https://phishdestroy.io/tgwitness/vi/docs/reference/translation/index.md): Tệp nào là bản gốc, cần nộp gì kèm bản dịch có chứng thực và những thuật ngữ người dịch giữ nguyên. - [An ninh và xử lý dữ liệu](https://phishdestroy.io/tgwitness/vi/docs/reference/security/index.md): Mô hình mối đe dọa, mô hình truy cập, thông tin bí mật khi không được sử dụng, mức độ phơi bày mạng, nhập dữ liệu phiên làm việc và cách báo cáo lỗ hổng bảo mật. - [Kiến trúc](https://phishdestroy.io/tgwitness/vi/docs/reference/architecture/index.md): Các thành phần của bộ thu thập, bảng điều khiển, sổ nhật ký, các công cụ xử lý và công cụ chứng thực, cùng cách thức dữ liệu được truyền tải giữa các thành phần này. - [Những nội dung đã được kiểm thử](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/index.md): Thử nghiệm Telegram trực tiếp, các kiểm tra tự động, kiểm tra trên trình duyệt và các đợt đánh giá tiếp theo. - [Bản ghi thay đổi](https://phishdestroy.io/tgwitness/vi/docs/reference/changelog/index.md): Mọi thay đổi theo từng phiên bản, bao gồm cả những thay đổi chưa được phát hành. - [Hướng dẫn sử dụng bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/index.md): Mọi màn hình của bảng điều khiển: cuộc trò chuyện, nhật ký, nguồn, xuất dữ liệu, Tính năng bổ sung, chế độ bảo vệ và kiểm tra mã nguồn. - [Cài đặt ban đầu và cấu hình](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/index.md): Trình hướng dẫn thiết lập, mục tiêu, cấp độ giao diện, đường dẫn kết nối và các cài đặt được chia sẻ bởi một nhóm tài khoản. - [Cài đặt, xác minh và cập nhật](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/index.md): Cài đặt chỉ với một lệnh, kiểm tra chữ ký và mã băm, cập nhật và gỡ bỏ cài đặt. - [Lưu trữ và khôi phục](https://phishdestroy.io/tgwitness/vi/docs/reference/storage/index.md): Sao lưu, di chuyển các tệp cũ lên đám mây của bạn, các bản sao được bảo vệ bởi Object Lock và khôi phục trên máy mới. - [Xuất tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/account-export/index.md): Xuất những nội dung mà tài khoản có thể truy cập hiện tại: phạm vi, các tác vụ có thể tiếp tục, tệp lưu trữ đã được ký và các bản sao chia sẻ đã được thu gọn. - [Trưng bày công khai](https://phishdestroy.io/tgwitness/vi/docs/reference/showcase/index.md): Xuất bản các tin nhắn đã lưu từ các kênh công khai được chọn và các bản chụp màn hình đã được ký thông qua các liên kết có thời hạn và có thể thu hồi. - [Triển khai có độ tin cậy cao](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/index.md): Một máy chủ được bảo mật 24/7 trên Hetzner hoặc Phala Cloud, Gateway DNS và các kiểm tra mà bên thứ ba có thể lặp lại. --- # Telegram · Bắt đầu chỉ trong vài phút Canonical page: https://phishdestroy.io/tgwitness/vi/docs/start/ Cài đặt bằng một lệnh, kết nối tài khoản Telegram và xuất kho lưu trữ có thể xác minh trên Windows, Linux hoặc macOS. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Cài đặt chỉ với một lệnh, kết nối tài khoản Telegram và chọn những gì cần lưu lại. ## Cài đặt trên máy tính của bạn Trình cài đặt bao gồm Python và các thành phần phụ thuộc. Bắt đầu bằng việc xuất dữ liệu trò chuyện; thêm các công cụ quan sát và điều tra khi cần thiết. ### Linux / macOS ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` ### Windows · PowerShell / CMD ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Máy chủ Ubuntu: chạy với quyền root. Máy tính để bàn: chạy với tài khoản người dùng thông thường của bạn. Mở địa chỉ bảng điều khiển được hiển thị bởi trình cài đặt và sử dụng khóa truy cập của nó. Sau đó, kết nối tài khoản Telegram của bạn. Khóa bảng điều khiển và quyền truy cập Telegram của bạn là hai thứ riêng biệt. [Cài đặt, chữ ký và cập nhật](https://phishdestroy.io/tgwitness/docs/reference/installation/) giải thích về bản dựng đã tải xuống, quyền truy cập cục bộ và các tùy chọn máy chủ. [Hướng dẫn về mã nguồn và Docker](https://phishdestroy.io/tgwitness/docs/reference/quickstart/) vẫn có sẵn. ## Chọn nhiệm vụ đầu tiên của bạn 1. [Kết nối tài khoản](https://phishdestroy.io/tgwitness/vi/docs/accounts/) qua số điện thoại, mã QR hoặc nhập phiên làm việc được hỗ trợ. 2. Chọn phạm vi là các cuộc trò chuyện, thư mục hoặc tài khoản. 3. [Xuất lịch sử đã chọn](https://phishdestroy.io/tgwitness/docs/reference/account-export/) hoặc bắt đầu quan sát để lưu lại các thay đổi trong tương lai. 4. [Xác minh tệp lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/exports/) so với dấu vân tay khóa đáng tin cậy được lưu trữ riêng biệt. ## Sử dụng một GitHub Runner tạm thời [Hướng dẫn GitHub Actions](https://phishdestroy.io/tgwitness/docs/capture/) sẽ hướng dẫn bạn qua các bước tạo nhánh (fork), ủy quyền, phạm vi và mật khẩu lưu trữ. Tải xuống kết quả được mã hóa cùng với nguồn gốc quy trình làm việc sau khi chạy. Quy trình làm việc này không cần máy chủ thu thập dữ liệu cố định. ## Quý vị có thể tham quan trang web mà không cần tài khoản [Mở bản demo trên trình duyệt](https://phishdestroy.github.io/TgWitness/demo/?lang=vi) để khám phá các tin nhắn giả định, so sánh các chỉnh sửa và kiểm tra tệp xuất trước khi cài đặt bất kỳ thứ gì. ![Giao diện cuộc trò chuyện của TgWitness kèm các tin nhắn mẫu](https://phishdestroy.io/tgwitness/assets/chats-dark.png?v=684f81f890cc) Một không gian làm việc mẫu. Nhật ký của riêng quý vị sẽ được bắt đầu riêng biệt. ## Tiếp tục cuộc điều tra Đối với công việc đang tiến hành, hãy thêm các nguồn, chính sách tệp, tính năng tìm kiếm, báo cáo và quyền chia sẻ mà trường hợp của bạn cần. [Bắt đầu, mở rộng quy mô và bằng chứng](https://phishdestroy.io/tgwitness/docs/reference/overview/) giải thích các lựa chọn và các số liệu đã công bố. Để cài đặt trên máy chủ, vui lòng làm theo hướng dẫn tại [Keep it running](https://phishdestroy.io/tgwitness/vi/docs/server/). --- # Vui lòng sử dụng một tài khoản riêng biệt. Tuyệt đối không sử dụng tài khoản chính của quý vị. Canonical page: https://phishdestroy.io/tgwitness/vi/docs/dedicated-account/ Vui lòng chuẩn bị một tài khoản Telegram riêng để thu thập dữ liệu. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Vui lòng đọc kỹ trước khi kết nối tài khoản Lời khuyên của chúng tôi về việc không nên sử dụng tài khoản chính của quý vị không phải là chuyện đùa. Đó là thực tế. Tài khoản chính - Với mã băm ứng dụng (app hash) của riêng quý vị, 99% tài khoản sẽ bị đăng xuất - Việc khóa tài khoản chỉ vì mức độ tin cậy thấp là điều thường xuyên xảy ra - Việc sử dụng tài khoản chính của quý vị thực sự là một ý tưởng ngu ngốc Một tài khoản phụ trên các cặp ID API/băm API công khai - Hơn một triệu tài khoản đã được đăng ký thông qua các cặp ID API/băm API này - Các cặp API ID/API hash này đã tồn tại hơn 5 năm - Không ai có thể xem bất kỳ dữ liệu nào của quý vị thông qua các cặp API này 01 ## Tại sao quý vị không được sử dụng tài khoản chính của mình Đây là thông tin chính xác. Chúng tôi nắm rõ những điểm cần lưu ý trong các vấn đề này. 1. ### Với mã băm ứng dụng (app hash) của riêng quý vị, 99% tài khoản sẽ bị đăng xuất Việc đăng nhập vào my.telegram.org từ một tài khoản mà quý vị không có quyền truy cập để lấy mã băm ứng dụng, và sau đó bất kỳ yêu cầu nào được thực hiện thông qua mã băm ứng dụng đó đều đồng nghĩa với khả năng 99% rằng tài khoản đó đã bị đăng xuất. Quý vị có thể kiểm tra điều này. 2. ### Việc khóa tài khoản chỉ vì mức độ tin cậy thấp là điều thường xuyên xảy ra Các tài khoản bị khóa đơn giản là do Telegram không tin tưởng chúng, và những trường hợp khóa tài khoản như vậy diễn ra khá thường xuyên. Quý vị cũng có thể kiểm tra điều này. Việc sử dụng tài khoản cá nhân của chính mình thực sự là một ý tưởng ngu ngốc. 3. ### Các khóa phiên đã sao chép có thể bị thu hồi Việc chạy đồng thời khóa TData/phiên làm việc đã nhập vào Telegram Desktop và TgWitness có thể gây ra lỗi `AUTH_KEY_DUPLICATED`. Telegram sẽ vô hiệu hóa quyền xác thực đó, do đó cả hai bản sao đều cần thực hiện đăng nhập lại. Việc sử dụng tài khoản riêng biệt không ngăn chặn được tình huống này. Hãy thoát hoàn toàn khỏi ứng dụng gốc và giữ cho ứng dụng đó ở trạng thái đóng trong khi sử dụng phiên đã nhập từ ứng dụng đó. Để sử dụng song song, hãy đăng nhập vào TgWitness bằng số điện thoại hoặc mã QR để tạo một ủy quyền riêng biệt; các ứng dụng khác đã được ủy quyền riêng biệt vẫn có thể duy trì trạng thái đã đăng nhập. [Vui lòng đọc cảnh báo về việc nhập phiên làm việc](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=vi#session-warning) Tài liệu hướng dẫn của Telegram - [Các lỗi khi đăng xuất: AUTH_KEY_UNREGISTERED, SESSION_REVOKED](https://core.telegram.org/api/errors) - [Tạo mã băm ứng dụng của riêng quý vị: lấy api_id](https://core.telegram.org/api/obtaining_api_id) 02 ## Tại sao TgWitness hoạt động thông qua các cặp app hash và app ID công khai Đó chính là lý do chúng tôi xây dựng TgWitness dựa trên các cặp băm ứng dụng/ID ứng dụng công khai. Theo logic của chúng tôi, việc bị cấm sẽ ít xảy ra hơn khi sử dụng các cặp này: đã có hơn một triệu tài khoản Telegram được đăng ký thông qua các cặp này, và nhiều chương trình khác nhau cũng hoạt động dựa trên chúng. Theo quan điểm của chúng tôi, phương án này tốt hơn so với việc làm việc trực tiếp với mã băm ứng dụng cá nhân: chắc chắn rằng các cặp này đã tồn tại được hơn 5 năm. ### Cặp API ID/API hash mới của riêng quý vị Được tạo tại my.telegram.org từ tài khoản này. - Khoảng 99% số tài khoản này bị đăng xuất - Một ứng dụng mới, một tài khoản ### Các cặp ID API công khai/băm API từ kho Đây chính là các cặp API ID/API hash mà nhiều chương trình khác đang sử dụng. - Hơn một triệu tài khoản đã đăng ký - Nhiều chương trình khác nhau - Các cặp API này đã hoạt động ổn định trong hơn 5 năm qua ### Tại sao không ai có thể xem bất kỳ dữ liệu nào của quý vị thông qua các cặp API này - #### Cặp API là một tên, không phải là khóa Telegram yêu cầu ID API và mã băm API khi một chương trình kết nối và khi chương trình đó yêu cầu mã đăng nhập. Các thông tin này giúp xác định ứng dụng và không cấp quyền truy cập vào bất kỳ tài khoản nào; tài liệu hướng dẫn của Telethon lưu ý rằng một cặp thông tin này có thể sử dụng với bất kỳ số điện thoại nào. - #### Khóa phiên của quý vị sẽ không bao giờ rời khỏi máy chủ của quý vị Quá trình đăng nhập sẽ tạo ra một khóa ủy quyền thông qua giao thức trao đổi Diffie–Hellman giữa TgWitness của quý vị và Telegram; bản thân khóa này sẽ không bao giờ được gửi đi. Theo tài liệu hướng dẫn của Telegram: sau khi ủy quyền, khóa sẽ được liên kết với người dùng, và mọi yêu cầu sử dụng khóa này đều được thực thi dưới danh nghĩa người dùng đó. Các chương trình khác sử dụng cùng một cặp khóa sẽ có khóa riêng của họ và không thể sử dụng khóa của quý vị. - #### Dữ liệu truyền tải được mã hóa bằng khóa của quý vị Mọi yêu cầu và phản hồi đều được mã hóa bằng khóa ủy quyền của phiên làm việc, chứ không phải bằng mã băm API. Việc biết mã băm API sẽ không giúp giải mã được bất kỳ thông tin nào. - #### Chủ sở hữu của cặp API ID/API hash sẽ không nhìn thấy bất kỳ thông tin nào Telegram không cung cấp phương thức nào để liệt kê các tài khoản, phiên làm việc hoặc tin nhắn theo ID API. Chủ sở hữu của một cặp tài khoản chỉ có thể xem cài đặt ứng dụng của mình tại my.telegram.org. - #### Chỉ tài khoản của quý vị mới có thể biết đó là ứng dụng nào Trong phần Cài đặt → Thiết bị của tài khoản cá nhân quý vị, danh sách này hiển thị tên ứng dụng và ID API, thiết bị, địa chỉ IP cũng như ngày tháng của từng phiên làm việc. Không ai khác có thể truy cập danh sách này. Tài liệu hướng dẫn của Telegram - [Xác thực người dùng: khóa sẽ được liên kết với người dùng](https://core.telegram.org/api/auth) - [auth.sendCode: api_id, api_hash](https://core.telegram.org/method/auth.sendCode) - [initConnection](https://core.telegram.org/method/initConnection) - [Tạo khóa ủy quyền MTProto](https://core.telegram.org/mtproto/auth_key) - [Mã hóa MTProto](https://core.telegram.org/mtproto/description) - [account.getAuthorizations](https://core.telegram.org/method/account.getAuthorizations) - [Một mục ủy quyền (phiên làm việc) trên Telegram bao gồm những thông tin nào](https://core.telegram.org/constructor/authorization) - [Cách lấy api_id](https://core.telegram.org/api/obtaining_api_id) - [Mã nguồn mở của các ứng dụng Telegram](https://telegram.org/apps#source-code) Các thư viện và chuỗi thảo luận - [Telethon: đăng nhập vào Telegram](https://docs.telethon.dev/en/stable/basic/signing-in.html) - [opentele: Thông tin đăng nhập API của các ứng dụng chính thức](https://opentele.readthedocs.io/en/latest/documentation/authorization/api/) - [opentele: TelegramClient](https://opentele.readthedocs.io/en/latest/documentation/telethon/telegramclient/) - [Stack Overflow: liệu giá trị `api_hash` có nên được giữ bí mật hay không?](https://stackoverflow.com/questions/49490818/should-telegram-api-hash-be-kept-secret) ### Các cặp API ID/API hash tương tự trong các chương trình khác 7 Các cặp API ID/API hash của các ứng dụng Telegram chính thức là công khai và được tích hợp sẵn trong nhiều chương trình và thư viện độc lập: - [opentelePython · src/api.py](https://github.com/anmv/opentele/blob/4df17bd8c443d6452afc5a2d29ec7922fad1a5c3/src/api.py#L575) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [opentele2Rust · opentele2-core/src/api.rs](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/api.rs#L641) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [GrampoPython · Grampo/ut/api.py](https://github.com/abbas-bachari/Grampo/blob/00aa662d853c4ac2180432371c5e0d9444bbfe9e/Grampo/ut/api.py#L526) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [tgmanagePython · api/schemas/api_app.py](https://github.com/xdsnich/tgmanage/blob/f67c46be0ab234bd04526a8663d3936bd98a8597/api/schemas/api_app.py#L47) - Android 6 - iOS 8 - Desktop 2040 - macOS 2834 - Telegram X 21724 - Web K 2496 - [LyChatBotTDLib · helpers/tdlib/index.js](https://github.com/LyoSU/LyChatBot/blob/fac0ae5d5f2cddb8a26312014f51c0f6f40ec191/helpers/tdlib/index.js#L11) - macOS 2834 - [hsadasdPython · config.py](https://github.com/herobrinovaleksandr-png/hsadasd/blob/6842c74895038c16e219324fcd07dbe8153f37f0/config.py#L68) - Desktop 2040 - Desktop 17349 - Telegram X 21724 - macOS 2834 - iOS 10840 - Web 2496 - +4 - [blb.teamblb.team/threads/…294](https://blb.team/threads/app-hash-app-id-ofitsial-nykh-kliyentov.294/) - Android 4 · 5 · 6 - iOS 8 - Desktop 2040 - Desktop 17349 - macOS 2834 - Telegram X 21724 Một bài đăng trên diễn đàn liệt kê các cặp API ID/API hash của các ứng dụng Telegram chính thức, được công bố nhằm mục đích đăng ký tài khoản 03 ## Các cách để tạo tài khoản bổ sung Tài khoản Telegram cần có số điện thoại để nhận mã đăng nhập. Quý vị hãy lựa chọn dựa trên thời gian tồn tại dự kiến của tài khoản. - Lựa chọn tối ưu ### Thẻ SIM trả trước hoặc eSIM ******** Thời gian hiệu lực là bao lâu Miễn là quý vị duy trì mức nạp đầy đủ Xin lưu ý Phương án đáng tin cậy nhất: Telegram ưu tiên chấp nhận các số điện thoại di động thực. Một số điện thoại bị nhà mạng thu hồi sẽ được cấp cho người khác. - ### Một ứng dụng cung cấp số điện thoại ảo ******** Thời gian hiệu lực là bao lâu Miễn là ứng dụng vẫn giữ nguyên số điện thoại Xin lưu ý Telegram có thể từ chối cấp số điện thoại ảo, không gửi mã xác minh hoặc ngay lập tức áp đặt giới hạn đối với tài khoản mới; một số ứng dụng sẽ thu hồi các số điện thoại không được sử dụng. - ### Dịch vụ cho thuê số điện thoại ******** Thời gian hiệu lực là bao lâu Về thời hạn thuê Xin lưu ý Khi quá trình này kết thúc, số thứ tự sẽ được chuyển sang khách hàng tiếp theo. - ### Kích hoạt một lần ******** Thời gian hiệu lực là bao lâu Chỉ có một mã đăng nhập Xin lưu ý Số điện thoại này sẽ ngay lập tức quay trở lại kho số, thường kèm theo lịch sử các chủ sở hữu trước đó. Hãy thiết lập mật khẩu đám mây trước tiên. Bất kỳ ai sở hữu số điện thoại này sau này đều có thể yêu cầu mã đăng nhập. Mật khẩu đám mây (xác minh hai bước) sẽ ngăn họ đăng nhập; nếu không có mật khẩu này, tài khoản sẽ thuộc về chủ sở hữu tiếp theo của số điện thoại đó. Tài liệu hướng dẫn của Telegram - [Câu hỏi thường gặp về thư rác: số điện thoại ảo và chủ sở hữu trước đây](https://telegram.org/faq_spam) - [Xác minh hai bước](https://core.telegram.org/api/srp) ### Các số +888 được thuê (Fragment) Một số nền tảng và dịch vụ cung cấp dịch vụ cho thuê tạm thời các số điện thoại chính thức +888 của Telegram từ Fragment. Mức giá dự kiến: 20 USD mỗi ngày. - Quý vị có thể đăng ký tài khoản trực tiếp trên Telegram Web hoặc Telegram Desktop. - Quý vị có thể xóa các tài khoản trên số điện thoại đó và tạo tài khoản mới. - Các tài khoản này thường phải trải qua ít bước kiểm tra chống gian lận hơn, nhưng chúng không mang lại sự miễn trừ hay đặc quyền nào. Số điện thoại này không thuộc về quý vị. Sau khi thời hạn thuê kết thúc, chủ sở hữu có thể lấy lại số này. Hãy thiết lập mật khẩu đám mây ngay lập tức và không nên coi tài khoản này là tài khoản dài hạn. Việc tự sở hữu số +888 hoặc sử dụng thẻ SIM trả trước do quý vị kiểm soát vẫn là phương án đáng tin cậy hơn. ### Các tài khoản sẵn có từ các sàn giao dịch Một số nền tảng giao dịch (ví dụ như G2G hoặc Z2U) bán các tài khoản Telegram đã được tạo sẵn — bao gồm tài khoản mới, tài khoản đã sử dụng một thời gian hoặc kèm theo tệp phiên làm việc. - [G2G: Danh sách tài khoản Telegram](https://www.g2g.com/uk/categories/telegram-accounts) - [Z2U: Danh sách tài khoản Telegram](https://www.z2u.com/telegram/accounts-5-15140) KHÔNG BAO GIỜ SỬ DỤNG TÀI KHOẢN CHÍNH CỦA QUÝ VỊ! Một tài khoản chuyên dụng được tạo theo cách này vẫn an toàn hơn so với việc đưa tài khoản Telegram chính của quý vị vào TgWitness. #### Các cảnh báo trước khi mua - Hành vi này vi phạm Điều khoản Dịch vụ của Telegram. - Nhiều tài khoản được đăng ký hàng loạt (đăng ký tự động) hoặc có lịch sử không rõ ràng. - Một số người bán có thể vẫn còn quyền truy cập khôi phục. - Các tài khoản từ những thị trường này thường bị cấm hoặc hạn chế sử dụng sau này. - Tránh các nền tảng thương mại điện tử công khai bán các phần mềm đánh cắp thông tin, công cụ lừa đảo hoặc các tài khoản rõ ràng là đã bị đánh cắp. - Việc mua tài khoản — ngay cả những tài khoản được quảng cáo là tự động đăng ký — từ các nền tảng công khai bán công cụ lừa đảo, phần mềm đánh cắp thông tin, phiên đăng nhập hoặc tài khoản bị đánh cắp không chỉ vi phạm Điều khoản Dịch vụ của Telegram mà còn vi phạm luật pháp của hầu hết các quốc gia. Điều này có thể khiến bằng chứng của quý vị sau này bị coi là không hợp lệ. Hãy lựa chọn cẩn thận. #### Nếu quý vị sử dụng tùy chọn này 1. Hãy coi tài khoản này là tài khoản dùng một lần. 2. Hãy ngắt kết nối tất cả các phiên khác, thiết lập mật khẩu đám mây và thay đổi phương thức khôi phục ngay lập tức. 3. Vui lòng sử dụng 2–3 tài khoản từ các nhà cung cấp khác nhau hoặc các tài khoản do chính quý vị đăng ký. **Gói Premium, việc xóa tài khoản và thời gian trì hoãn bảy ngày** Nếu tài khoản có gói Premium, người có quyền truy cập vào số điện thoại sẽ không thể xóa tài khoản ngay lập tức. Quý vị sẽ nhận được thông báo và có bảy ngày trước khi tài khoản bị xóa. Điều này rất quan trọng vì cuộc điều tra của quý vị phụ thuộc vào tài khoản này: quý vị vẫn còn thời gian để chuẩn bị một tài khoản thay thế. **Tài khoản mới và thông tin đăng nhập API** Nếu quý vị lấy và sử dụng api_id/api_hash của riêng mình từ một tài khoản mới do chính quý vị đăng ký bằng số điện thoại nhận được từ dịch vụ SMS, tài khoản đó sẽ bị đăng xuất ngay tại yêu cầu API đầu tiên hoặc khi xác thực phiên làm việc. Xin lưu ý điều này khi lên kế hoạch điều tra. 04 ## Tạo tài khoản Từ việc lấy số điện thoại cho đến cuộc trò chuyện đầu tiên được ghi lại. 1. ### Lấy số điện thoại Sử dụng SIM trả trước hoặc eSIM khi tài khoản cần duy trì hoạt động lâu dài; thuê SIM hoặc kích hoạt một lần cho các công việc ngắn hạn. Danh sách các dịch vụ được liệt kê dưới đây. 2. ### Vui lòng đăng ký bằng tài khoản riêng biệt với tài khoản chính của quý vị Vui lòng đăng ký trong ứng dụng Telegram chính thức trên một thiết bị riêng biệt, trình giả lập hoặc hồ sơ điện thoại, không nên sử dụng cùng thiết bị với tài khoản chính của quý vị. 3. ### Bảo vệ tài khoản bằng mật khẩu đám mây Hãy thiết lập ngay mật khẩu đám mây và địa chỉ email khôi phục mà quý vị chưa từng sử dụng ở bất kỳ nơi nào khác. 4. ### Hạn chế cài đặt quyền riêng tư của tài khoản Số điện thoại: **“Không ai**”, “Tìm tôi qua số điện thoại của tôi”, **“Danh bạ của tôi**”, “Lần cuối truy cập”, “Ảnh đại diện” và “Tiểu sử”: **“Không ai”** hoặc **“Danh bạ của tôi**”; tắt tính năng đồng bộ danh bạ. 5. ### Ngăn không cho tài khoản tự hủy Hãy thiết lập thời gian tự hủy tài khoản ở mức dài nhất, để trường hợp TgWitness ngừng hoạt động sẽ không khiến quý vị mất tài khoản. 6. ### Tạo hồ sơ trung lập cho tài khoản Không sử dụng tên, ảnh đại diện, tên người dùng hoặc phần giới thiệu từ các tài khoản khác của quý vị, cũng như không sử dụng danh bạ cá nhân. 7. ### Làm nóng tài khoản mới từ từ Ban đầu, quý vị chỉ nên tham gia một vài cuộc trò chuyện mỗi ngày. Các tài khoản mới nếu vội vàng tham gia sẽ bị giới hạn trước tiên. 8. ### Không chia sẻ bất kỳ thông tin nào với các bot Không bao giờ nhấn vào “Chia sẻ số điện thoại” hoặc “Chia sẻ vị trí” cho bất kỳ bot nào. Hãy mở các liên kết và Ứng dụng nhỏ (Mini Apps) thông qua VPN hoặc máy chủ proxy trên thiết bị đó. 9. ### Kết nối tài khoản với TgWitness Trong không gian làm việc riêng của ứng dụng, hãy kết nối qua **mục Tài khoản → Mã QR**, sau đó nhấn vào **Nguồn → Chế độ điều tra**. Ứng dụng là nơi quý vị thực hiện các thao tác, còn TgWitness là công cụ ghi lại. Tài liệu hướng dẫn của Telegram - [Xác minh hai bước](https://core.telegram.org/api/srp) - [Cài đặt quyền riêng tư](https://core.telegram.org/api/privacy) - [Tự hủy tài khoản nếu không hoạt động](https://core.telegram.org/method/account.setAccountTTL) 05 ## Các dịch vụ số điện thoại Đây là các tùy chọn để quý vị bắt đầu. Các quốc gia, mức giá và việc Telegram có chấp nhận một số điện thoại cụ thể hay không thường xuyên thay đổi, do đó xin vui lòng kiểm tra kỹ trước khi thanh toán. ### SIM trả trước và eSIM 11 - [SMARTYsmarty.co.uk](https://smarty.co.uk) - UK - SIM - [VOXIvoxi.co.uk](https://www.voxi.co.uk) - UK - SIM - [iD Mobileidmobile.co.uk](https://www.idmobile.co.uk) - UK - SIM - [Threethree.co.uk](https://www.three.co.uk) - UK - SIM - [Asda Mobilemobile.asda.com](https://mobile.asda.com) - UK - SIM - [Ultra Mobileultramobile.com](https://www.ultramobile.com) - US - Trả trước Gói PayGo, giá rất rẻ - [US Mobileusmobile.com](https://www.usmobile.com) - US - Trả trước - [Mint Mobilemintmobile.com](https://www.mintmobile.com) - US - Trả trước - [Tracfonetracfone.com](https://www.tracfone.com) - US - Trả trước - [eSIM Plusesimplus.me](https://esimplus.me) - eSIM - [Numero eSIMnumeroesim.com](https://numeroesim.com) - eSIM ### Các ứng dụng có số điện thoại ảo 20 - [Google Voicevoice.google.com](https://voice.google.com) - US Chỉ áp dụng tại Hoa Kỳ; việc đăng ký yêu cầu số điện thoại tại Hoa Kỳ - [TextNowtextnow.com](https://www.textnow.com) - US - CA Số này sẽ được thu hồi nếu quý vị không sử dụng nó - [TextFreetextfree.us](https://www.textfree.us) - US - [2ndLine2ndline.co](https://www.2ndline.co) - US - CA - [Talkatonetalkatone.com](https://www.talkatone.com) - US - [TextMego-text.me](https://go-text.me) - US - CA - Các quốc gia khác - [textPlustextplus.com](https://textplus.com) [Google Play](https://play.google.com/store/apps/details?id=com.gogii.textplus) - [FreeToneGoogle Play](https://play.google.com/store/apps/details?id=com.textmeinc.freetone) - US [TextMe Up · textmeup.com](https://www.textmeup.com) - [Nextplusnextplus.me](https://nextplus.me) - US - [Dingtonedingtone.me](https://www.dingtone.me) - US - CA - [Burnerburnerapp.com](https://www.burnerapp.com) - US - CA - Dịch vụ trả phí Kèm theo thời gian dùng thử - [Hushedhushed.com](https://hushed.com) - Nhiều quốc gia - Dịch vụ trả phí Giá rẻ - [Sidelinesideline.com](https://www.sideline.com) - US - [MySudomysudo.com](https://mysudo.com) - US - CA - UK - [2NumberGoogle Play](https://play.google.com/store/apps/details?id=com.bpmobile.second.phone) [App Store](https://apps.apple.com/app/id1216135390) - [SLYNUMBERslynumber.com](https://slynumber.com) [Google Play](https://play.google.com/store/apps/details?id=com.dev.slynumber) - [Phonerphonerapp.com](https://phonerapp.com) - [Onoffonoff.app](https://www.onoff.app) - EU Các số điện thoại di động châu Âu trong một ứng dụng - [Sonetelsonetel.com](https://sonetel.com) - Nhiều quốc gia - Một số điện thoại miễn phí - [Zadarmazadarma.com](https://zadarma.com) - Nhiều quốc gia Số điện thoại ảo ### Dịch vụ cho thuê số điện thoại và kích hoạt một lần 12 Việc thuê số điện thoại giúp quý vị giữ số đó trong vài tuần hoặc vài tháng. Quá trình kích hoạt một lần sẽ cung cấp một mã đăng nhập duy nhất: hãy thiết lập mật khẩu đám mây ngay sau khi đăng ký. - [OnlineSimonlinesim.io](https://onlinesim.io) - Thuê số điện thoại - Kích hoạt một lần - [SMSPVAsmspva.com](https://smspva.com) - Thuê số điện thoại - Kích hoạt một lần - [5SIM5sim.net](https://5sim.net) - Thuê số điện thoại - Kích hoạt một lần - [SMSPoolsmspool.net](https://www.smspool.net) - Thuê số điện thoại - Kích hoạt một lần - [VAK-SMSvak-sms.com](https://vak-sms.com) - Thuê số điện thoại - Kích hoạt một lần - [TextVerifiedtextverified.com](https://www.textverified.com) - Thuê số điện thoại - Kích hoạt một lần - [JuicySMSjuicysms.com](https://juicysms.com) - Thuê số điện thoại - Kích hoạt một lần - [365SMS365sms.org](https://365sms.org) - Thuê số điện thoại - Kích hoạt một lần - [SIMSMSsimsms.org](https://simsms.org) - Thuê số điện thoại - Kích hoạt một lần - [GrizzlySMSgrizzlysms.com](https://grizzlysms.com) - Kích hoạt một lần - [SMS-MANsms-man.com](https://sms-man.com) - Kích hoạt một lần - [Tiger SMStiger-sms.com](https://tiger-sms.com) - Kích hoạt một lần --- # Telegram · Kết nối tài khoản Canonical page: https://phishdestroy.io/tgwitness/vi/docs/accounts/ Kết nối Telegram qua mã QR, số điện thoại hoặc nhập phiên làm việc. Chọn các nguồn và kiểm tra xem các tin nhắn mới có được ghi vào sổ nhật ký của quý vị hay không. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Một không gian làm việc = một tài khoản, sổ nhật ký và khóa của nó. ## Chọn cách đăng nhập **Tài khoản** → thêm không gian làm việc → cài đặt kết nối. Hãy dùng một tài khoản riêng cho việc này. - **Mã QR:** quét từ màn hình Thiết bị trong Telegram và xác nhận. - **Số điện thoại:** số, mã, rồi mật khẩu 2FA nếu có. - **Nhập phiên:** tệp phiên của riêng bạn hoặc dữ liệu Telegram Desktop. Dùng hồ sơ API có sẵn hoặc API ID và hash của riêng bạn. Nó chỉ nhận diện ứng dụng, không đăng nhập giúp bạn và không che giấu gì cả. **Quý vị có cần sử dụng máy chủ proxy trước không?** Quý vị có thể [lựa chọn và kiểm tra lộ trình kết nối](https://phishdestroy.io/tgwitness/vi/docs/proxies/) trước khi đăng nhập. Mỗi tài khoản đều có lộ trình riêng. ## Chọn nội dung cần theo dõi 1. Chọn các cuộc trò chuyện, nhóm hoặc kênh bạn cần. 2. Kiểm tra cài đặt thu thập, kể cả phương tiện. 3. Khởi động rồi kiểm tra kết nối và hoạt động gần đây. Tài khoản phải có quyền truy cập. Quản trị viên và thành viên thấy những thứ khác nhau, sổ nhật ký cho thấy tài khoản này đã nhận được gì. Cả tài khoản? **Nguồn → Phạm vi quan sát → Chế độ điều tra**, kiểm tra, rồi **Lưu phạm vi**. Hướng dẫn đầy đủ: [điều tra toàn bộ tài khoản](https://phishdestroy.io/tgwitness/vi/docs/cases/). ## Kiểm tra toàn bộ đường dẫn Trong nhóm thử nghiệm, gửi một tin nhắn từ tài khoản khác, sửa nó, rồi xóa nó. Cả ba sự kiện đều phải hiện trong sổ nhật ký. Sau đó [xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/exports/). "Đã kết nối" nghĩa là kết nối hoạt động. Tin nhắn thử được ghi lại nghĩa là sự kiện thực sự đến nơi. ## Thêm một tài khoản khác Không gian làm việc mới trong **Tài khoản**, các bước như cũ. Ghi lại dấu vân tay khóa của từng tài khoản để sau này phân biệt các bản xuất. --- # Telegram · Chọn một máy chủ proxy Canonical page: https://phishdestroy.io/tgwitness/vi/docs/proxies/ Quản lý các tuyến đường MTProxy tự động hoặc sử dụng máy chủ proxy của riêng quý vị. Chọn chế độ IP, quy tắc dự phòng và tuyến đường cho các yêu cầu bên ngoài. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Giữ tài khoản trực tuyến, và tự bạn quyết định nó có được để lộ IP máy chủ hay không. ## Vui lòng chọn chế độ IP trước tiên 01**Ẩn địa chỉ** Chỉ dùng proxy. Nếu không cái nào hoạt động, nó chờ. 02**Chỉ sử dụng phương án này khi không còn lựa chọn nào khác** Kết nối trực tiếp sau một khoảng chờ, quay lại proxy khi có cái hoạt động. 03**Máy chủ nằm sau một đường hầm hoặc VPN** Kết nối trực tiếp cũng được. Nó không thiết lập hay kiểm tra VPN giúp bạn. Tuyến đường sẽ quyết định loại kết nối. Chế độ IP sẽ xác định liệu kết nối trực tiếp có được phép hay không. ## Hãy để nhóm duy trì lộ trình 1. **Tài khoản → Cài đặt → Cài đặt kết nối**. 2. Chọn chế độ IP và **MTProxy tự động**, hoặc một tuyến cố định. 3. Lưu, rồi **Kiểm tra kết nối Telegram** (dùng được cả trước khi đăng nhập). 4. Bắt đầu thu thập và tự gửi cho mình một tin nhắn thử. Không gian làm việc mới khởi đầu với MTProxy tự động và **Ẩn địa chỉ**. Nhóm proxy lấy bốn danh sách công khai, kiểm tra máy chủ, giữ cái tốt và thay cái đã chết. ## Vui lòng sử dụng máy chủ proxy của riêng quý vị SOCKS5, HTTP CONNECT, liên kết proxy Telegram hoặc danh mục của nhà vận hành. Hãy tạm dừng quan sát trước khi chuyển. Khóa bí mật Fake TLS (`ee`…) không hoạt động. **Cài đặt xoay vòng, chia sẻ và thử lại** **Tham số → MTProxy tự động**: ngưỡng lỗi, thời gian nghỉ, xoay vòng, số tài khoản mỗi proxy. Giới hạn 1 nghĩa là tài khoản sẽ chờ thay vì dùng chung. Các proxy khác nhau vẫn có thể dùng chung một IP thoát. ## Tách biệt Telegram khỏi các yêu cầu từ bên ngoài MTProxy chỉ mang lưu lượng Telegram. Dấu thời gian, thông báo, bản sao và kiểm tra mã đi qua một proxy SOCKS5/HTTP riêng, tuyến SOCKS5/HTTP của tài khoản, hoặc trực tiếp nếu chế độ cho phép. Hoặc tắt chúng đi. `TGWITNESS_PROXY_FEED_PROXY` đặt tuyến dùng để tải danh sách. [Nhân chứng](https://phishdestroy.io/tgwitness/vi/docs/witness/) có cài đặt riêng. Không cái nào đụng tới trình duyệt hay mạng hệ thống của bạn. Thêm: [các chế độ và giá trị mặc định](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/#ip-modes), [ai được đổi tuyến](https://phishdestroy.io/tgwitness/vi/docs/access/). --- # Telegram · Xuất và xác minh Canonical page: https://phishdestroy.io/tgwitness/vi/docs/exports/ Xuất lịch sử Telegram đã ghi lại, xác minh chữ ký và so sánh sổ nhật ký với bản sao lưu được lưu giữ bởi một nhân chứng độc lập. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Trao cho người khác những tệp họ có thể tự đối chiếu với không gian làm việc của bạn. Giữ lại tham chiếuXuất tệp ZIP đã được ký điện tửNgười nhận xác minh Mới làm quen với chữ ký và điểm kiểm tra? [Thay đổi một bản ghi mẫu](https://phishdestroy.io/tgwitness/vi/docs/concepts/#chain) và xem bước kiểm tra nào phát hiện ra. Muốn lưu giữ một bản sao ngoài phạm vi của người thu thập dữ liệu? Vui lòng truy cập [phần Cài đặt S3](https://phishdestroy.io/tgwitness/vi/docs/exports/#s3), [tính năng Khóa đối tượng](https://phishdestroy.io/tgwitness/vi/docs/exports/#s3-retention) hoặc [tính năng khôi phục đã được xác minh](https://phishdestroy.io/tgwitness/vi/docs/exports/#s3-restore). ## Lưu giữ một nguồn tham khảo đáng tin cậy Ghi lại dấu vân tay khóa của không gian làm việc ở một nơi khác ngoài trình thu thập. Trong quá trình thu thập, hãy bật chế độ bằng chứng để các điểm kiểm tra nhận được dấu thời gian theo tiêu chuẩn RFC 3161 và OpenTimestamps, hoặc chạy một [chứng nhân](https://phishdestroy.io/tgwitness/vi/docs/witness/) đăng bài lên kênh công khai. Cũng nên lưu trữ các điểm kiểm tra đã ký ở nơi khác: người nhận sẽ đối chiếu khóa, thời gian và trạng thái nhật ký trước đó với các điểm kiểm tra này. ## Tải xuống tệp ZIP đã được ký số **Xuất** → ZIP bằng chứng có chữ ký. Bên trong có toàn bộ sổ nhật ký và bản kê tệp có chữ ký. Định hình báo cáo dễ đọc trong [Report studio](https://phishdestroy.io/tgwitness/vi/docs/reports/), hoặc chỉ gửi dữ liệu đã chọn dưới dạng [bản trích xuất bàn giao](https://phishdestroy.io/tgwitness/vi/docs/handover/). Báo cáo HTML, PDF và JSON có dấu niêm phong riêng. CSV chỉ là bản sao làm việc; để đảm bảo toàn vẹn, hãy dùng CSV bên trong ZIP đã xác minh. ## Vui lòng xác minh bằng một bản sao đáng tin cậy của TgWitness Trong môi trường của dự án, với dấu vân tay và đường dẫn của bạn: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` Kết quả kiểm tra hiển thị `key_pinned: true` và `checkpoint_checked: true`. `--require evidence` cũng yêu cầu thời gian từ bên thứ ba cho bản ghi cuối cùng, chẳng hạn như dấu thời gian đã được xác minh: điểm kiểm tra được ký bằng khóa của chính bạn, vì vậy chỉ riêng nó là chưa đủ. Hãy lưu kết quả này bên cạnh tệp lưu trữ. Điểm kiểm tra phải nằm tại hoặc trước thời điểm kết thúc quá trình xuất dữ liệu. ## Sử dụng kết quả xác minh - **Tệp:** bản kê ràng buộc mã băm của chúng, chữ ký ràng buộc sổ nhật ký. Mọi thay đổi đều lộ ra. - **Danh tính:** dấu vân tay bạn đã giữ chứng minh đó là khóa bạn mong đợi. - **Trạng thái trước đó:** điểm kiểm tra so sánh bản xuất với phần đầu sổ nhật ký đã lưu trước khi bàn giao. - **Phạm vi:** khoảng trống, kết quả thu nhận và phép thử gửi → sửa → xóa cho thấy cấu hình này thực sự bắt được gì. Chi tiết: [xác minh chứng minh được gì](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope). ## Thiết lập bản sao lưu ngoài trang web trên S3 **Xuất → Bản sao ngoài trang web** trong không gian làm việc của bạn. Hoạt động với AWS S3 và mọi dịch vụ tương thích S3. Nó sao chép các đoạn sổ nhật ký, tệp đã lưu, điểm kiểm tra kèm dấu thời gian và bản xuất trò chuyện đã hoàn tất, mỗi thứ được mã hóa bằng `AES-256-GCM` trước khi rời máy thu thập. Bản demo trực tuyến hiển thị các điều khiển này nhưng tắt tải lên. Chỉ nhập thông tin xác thực thật trong bản cài đặt của riêng bạn. [![Bảng điều khiển sao lưu ngoài trang web đầy đủ: điểm cuối, khu vực, thùng lưu trữ, khóa truy cập, lịch trình, các thiết lập kiểm soát Object Lock và khóa khôi phục](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4)](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4) Bảng điều khiển đầy đủ với các tùy chọn nâng cao đã được mở rộng. Không hiển thị bất kỳ thông tin đăng nhập lưu trữ nào. | Lĩnh vực | Nội dung cần nhập | | --- | --- | | Điểm cuối | URL lưu trữ, không kèm đường dẫn bucket hay thông tin xác thực. Ví dụ: `https://s3.example.invalid`. | | Khu vực | Theo yêu cầu của nhà cung cấp. Mặc định `us-east-1`. | | Bucket | Một bucket có sẵn mà bạn ghi được. Ví dụ: `example-case-backup`. | | Thư mục trong bucket | Tiền tố, mặc định `tgwitness`. Một tiền tố riêng cho mỗi không gian làm việc được thêm vào phía sau. | | ID khóa truy cập / Khóa truy cập bí mật | Cả hai cùng nhau, lưu trong kho bảo mật. Sau này để trống cả hai thì giá trị cũ được giữ. | | Địa chỉ theo kiểu đường dẫn | Bật: `endpoint/bucket`. Tắt: `bucket.endpoint`. Tùy nhà cung cấp. | | Khoảng thời gian sao chép | 1 đến 1.440 phút, mặc định 5. Chỉ khi ứng dụng đang chạy. | | Chính sách lưu trữ Object Lock | Số ngày và chế độ, nếu bucket hỗ trợ Object Lock. Số 0 giữ mặc định của bucket. | 1. Tạo bucket, điền đích đến và thông tin xác thực trong khi **Giữ bản sao ngoài trang web** chưa được chọn, rồi bấm **Lưu bản sao ngoài trang web**. 2. **Kiểm tra kết nối** tải lên một đối tượng thử đã mã hóa. 3. **Tải xuống khóa mã hóa** và cất xa máy thu thập. Không có khóa thì không khôi phục được. 4. Chọn **Giữ bản sao ngoài trang web**, lưu, rồi **Sao chép ngay** hoặc để lịch chạy. ## Kiểm tra tiến độ lưu trữ và sao chép Trong **Tùy chọn khác**, chọn số ngày lưu giữ và `GOVERNANCE` hoặc `COMPLIANCE`. TgWitness đọc lại cài đặt lưu giữ từ một đối tượng đã tải lên và báo cho bạn: đã xác nhận, thiếu hoặc kiểm tra thất bại. Bảng điều khiển hiển thị lượt chạy gần nhất, số đối tượng, số byte, ranh giới sổ nhật ký đã sao chép và lỗi. Tệp cục bộ bị thiếu sẽ được báo và thử lại ở lượt sau, phần còn lại vẫn tiếp tục sao chép. Tải lên đi qua kết nối trực tiếp, SOCKS5 hoặc HTTP. Với tuyến chỉ có MTProxy, bản sao sẽ chờ kèm lỗi. ## Hãy lưu giữ khóa khôi phục ở một nơi riêng biệt Tệp JSON khóa chứa khóa giải mã, đích đến, tiền tố và dấu vân tay khóa. Để khôi phục, bạn cần nó cùng thông tin xác thực lưu trữ có quyền đọc. Đã đổi endpoint, bucket hoặc tiền tố? Hãy tải lại khóa. Một bản sao mới bắt đầu ở đích mới; các bản xuất trò chuyện cũ vẫn ở chỗ cũ. ## Khôi phục và xác minh trên một máy tính khác Bạn cần một bản cài TgWitness đáng tin cậy, tệp JSON khóa, thông tin xác thực lưu trữ chỉ đọc và một thư mục trống: ### 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 ``` Mọi thứ được kiểm tra trước trong một thư mục tạm riêng tư: toàn bộ sổ nhật ký, điểm kiểm tra, mã băm và kích thước tệp. Đường dẫn không an toàn, các đoạn mâu thuẫn hoặc sổ nhật ký ngắn hơn điểm kiểm tra của nó sẽ thất bại, và khi đó không có gì được ghi ra. Khi thành công, bạn nhận được `events.jsonl`, `media/`, `checkpoints/` và `exports/`. Giữ kết quả JSON của lệnh cùng chúng, và so sánh với các điểm kiểm tra hoặc bản ghi nhân chứng bạn tự lưu. --- # Telegram · Ghi lại các hành động trên GitHub Actions Canonical page: https://phishdestroy.io/tgwitness/vi/docs/capture/ Chọn Takeout, xuất qua API thông thường hoặc nhật ký trò chuyện trên runner GitHub tạm thời. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Chọn Takeout, xuất qua API thông thường hoặc nhật ký trò chuyện trên runner GitHub tạm thời. Vui lòng bật JavaScript để tạo khóa và giải mã tệp lưu trữ của quý vị. **Tham khảo đầy đủ** [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Quay phim độc lập](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md) ![Quay phim độc lập](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b) **Có thể xem trước từ trang `main`.** Một nhánh (fork) sẽ khởi chạy quy trình làm việc có thể tái sử dụng đã được ghim từ `phishdestroy/TgWitness`. Quy trình làm việc này xuất một tài khoản, các cuộc trò chuyện đã chọn hoặc nhật ký sự kiện của một cuộc trò chuyện bằng cách sử dụng một phiên Telegram mới được tạo, xác thực bằng chứng dưới dạng tệp ZIP hoặc bản kê khai đa phần, và chỉ tải lên các gói dữ liệu được mã hóa bởi người nhận. Bảng điều khiển quản trị thông thường không được hiển thị. Chọn `client=official_web` để chạy trình [chứng kiến client chính thức](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) với các điều khiển Telegram Web được bảo vệ và video. Tính năng này yêu cầu bạn phải có proxy upstream riêng và chỉ theo dõi một cuộc trò chuyện đã được hiển thị. Mặc định `client=api` sẽ giữ nguyên các chế độ xuất toàn bộ tài khoản được mô tả bên dưới. Người xác minh sẽ đối chiếu tệp lưu trữ với chứng nhận trên GitHub, quy trình làm việc đã được phê duyệt và các bản cam kết của bộ thu thập, cũng như nhật ký đã ký và các hàm băm tệp đính kèm. Quá trình thu thập sử dụng mã nguồn từ nguồn chính đã được cố định và không gian lưu trữ mới. Người đánh giá có thể kiểm tra mã nguồn đó và xác minh tệp lưu trữ đã được cung cấp dựa trên bản ghi quá trình thực thi tương ứng. **Trên trang này** - [Quy trình người dùng](https://phishdestroy.io/tgwitness/vi/docs/capture/#user-flow) - [Thời lượng dự kiến của phiên họp](https://phishdestroy.io/tgwitness/vi/docs/capture/#session-time-budget) - [Chọn chế độ này hoặc một không gian làm việc cố định](https://phishdestroy.io/tgwitness/vi/docs/capture/#choose-this-mode-or-a-persistent-workspace) - [Điều gì là công khai, và điều gì phải được giữ riêng tư](https://phishdestroy.io/tgwitness/vi/docs/capture/#what-is-public-and-what-must-stay-private) - [Khắc phục sự cố](https://phishdestroy.io/tgwitness/vi/docs/capture/#troubleshooting) - [Giải mã và xác minh tại chỗ](https://phishdestroy.io/tgwitness/vi/docs/capture/#local-decryption-and-verification) - [Cách giữ fork nằm ngoài quá trình capture](https://phishdestroy.io/tgwitness/vi/docs/capture/#how-the-fork-is-kept-outside-the-capture-process) - [Chuyển giao mật mã](https://phishdestroy.io/tgwitness/vi/docs/capture/#cryptographic-handoff) - [Phạm vi và việc xác thực](https://phishdestroy.io/tgwitness/vi/docs/capture/#scope-and-validation) - [Quy trình phát hành của người duy trì](https://phishdestroy.io/tgwitness/vi/docs/capture/#maintainer-release-sequence) ## Quy trình người dùng Trợ lý sẽ giải thích năm giai đoạn và cho phép bạn thử tính năng thay thế tin nhắn hoặc bộ thu thập trên dữ liệu mẫu. **Nhấn Bắt đầu ghi lại** để mở trình hướng dẫn. 1. Chọn **GitHub Actions capture (bản xem trước)** trên trang chủ dự án, màn hình đăng nhập không gian làm việc hoặc tại mục **Xuất → Mở trình hỗ trợ capture**. Bạn cũng có thể mở trình [hỗ trợ chính thức](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) hoặc tệp ``tgwitness/static/capture.html`` từ một bản checkout đáng tin cậy trong trình duyệt hiện đại. Trình trợ giúp không thực hiện bất kỳ yêu cầu mạng nào để xử lý khóa hoặc tệp. Trình trợ giúp hỗ trợ các ngôn ngữ giao diện của trang web; bảng thu thập tạm thời hỗ trợ tiếng Anh và tiếng Nga và sẽ mở bằng ngôn ngữ của trình duyệt nếu đó là một trong hai ngôn ngữ trên. 2. Tạo khóa và lưu **tệp sealed-key.json**. Đây là khóa riêng tư duy nhất dùng để giải mã. Sao chép giá trị khóa công khai của **người nhận**. Nếu mất khóa riêng tư, bạn sẽ mất quyền truy cập vào cả kết nối lẫn tệp lưu trữ. Xác nhận rằng bạn đã lưu tệp này để mở khóa bước tiếp theo. Nếu bạn đã có tệp giao hàng, hãy tải khóa đã lưu và chọn **Tôi đã có tệp lưu trữ**. 3. Tạo nhánh (fork) từ TgWitness, kích hoạt tính năng Actions trong nhánh đó và chạy **tính năng ghi lại cuộc trò chuyện được mã hóa (Sealed chat capture)**. Dán địa chỉ người nhận công khai và chọn 30, 60 hoặc 120 phút. Tuyệt đối không được đưa số điện thoại, mã đăng nhập, mật khẩu Telegram, khóa riêng tư hoặc phiên làm việc vào các trường đầu vào của quy trình làm việc, các bản cam kết (commits), các vấn đề (issues) hoặc nhật ký (logs). 4. Trong quá trình chạy, hãy tải xuống tệp **sealed-connection** từ Artifacts và giải nén nó. Tải `connection.tgwsealed` trong trình trợ giúp, sử dụng khóa riêng đã lưu. Liên kết kết quả chứa một khóa truy cập ngẫu nhiên trong phần URL fragment. Hãy giữ liên kết này bí mật. Bảng điều khiển sẽ loại bỏ phần fragment và lưu trữ khóa truy cập trong bộ nhớ phiên của tab này; nó không được ghi vào nhật ký truy cập HTTP. 5. Mở liên kết kết nối. Đăng nhập bằng mã QR hoặc bằng số điện thoại và mã đăng nhập. Nhập mật khẩu xác minh hai bước nếu Telegram yêu cầu. Theo mặc định, hệ thống sẽ sử dụng kho thông tin đăng nhập API tích hợp sẵn, giống như trong không gian làm việc thông thường. Bạn có thể mở rộng phần thông tin đăng nhập tùy chỉnh (tùy chọn) và nhập cả hai `api_id` và `api_hash` từ [my.telegram.org/apps](https://my.telegram.org/apps). Để trống cả hai trường để sử dụng kho thông tin đăng nhập tích hợp sẵn; cặp thông tin không đầy đủ hoặc sai định dạng sẽ bị từ chối. Không cho phép nhập phiên làm việc. Chọn chế độ xuất và phạm vi. Liên kết kết nối chứa một khóa truy cập bí mật: hãy giữ bí mật thông tin này. 6. Chọn **Telegram Takeout**, **API Telegram thông thường** hoặc **Nhật ký sự kiện trò chuyện**. Để xuất dữ liệu tài khoản, hãy chọn tất cả các cuộc trò chuyện có thể truy cập hoặc tải và chọn một hoặc nhiều cuộc trò chuyện, sau đó thiết lập ngày tháng, loại cuộc trò chuyện, danh mục tài khoản và quy tắc tệp đính kèm. Kiểm tra cài đặt và kích thước, tùy chọn lưu tệp JSON cài đặt cho người kiểm tra độc lập, sau đó nhấn **Bắt đầu thu thập**. Cài đặt sẽ được cố định sau khi bắt đầu. Chức năng Tiếp tục chỉ hoạt động khi trình chạy này còn tồn tại; việc kết thúc sớm sẽ giữ lại dữ liệu đã thu thập và ghi lại các khoảng trống. Hết hạn sau khi bắt đầu sẽ tạo ra một tập tin lưu trữ không đầy đủ; hết hạn trước khi bắt đầu hoặc hủy bỏ sẽ không tạo ra tập tin lưu trữ nào. 7. Hãy đợi **kết quả được niêm phong**, tải xuống và giải nén, sau đó giải mã `delivery.tgwsealed` trong tệp trợ giúp. Bạn sẽ nhận được `delivery.zip`, chứa `evidence.zip`, `attestation.jsonl`, cùng với hướng dẫn. Việc giải mã bằng trình duyệt bị giới hạn ở 256 MiB; các gói dữ liệu lớn hơn hãy sử dụng lệnh truyền trực tiếp cục bộ bên dưới. Các kết quả có dung lượng lớn cũng bao gồm `delivery-NNNNNN.tgwsealed` các phần; phần chính `delivery.tgwsealed` sau đó chứa `evidence.parts.json` và chứng nhận. Tải xuống từng phần và ghép lại tại địa phương theo hướng dẫn dưới đây. 8. Hãy kết thúc phiên làm việc tạm thời trong phần Cài đặt Telegram → Thiết bị nếu việc thu hồi quyền truy cập chưa được xác nhận hoặc quá trình chạy đã bị ngắt. Khi hoàn tất bình thường, hệ thống sẽ yêu cầu đăng xuất và quá trình chạy sẽ ghi lại liệu việc thu hồi quyền truy cập đã được xác nhận hay chưa. Kho lưu trữ phải chứa các bản cam kết đã được xuất bản của nguồn được ghim và quy trình làm việc có thể tái sử dụng. Một nhánh cục bộ đơn lẻ không thể được gọi bởi một kho lưu trữ GitHub khác. ## Thời lượng dự của phiên# Trước khi thu hồi, **Tính toán thời gian và dung lượng** ước tính lịch sử và các tệp đã chọn dựa trên số lượng tin nhắn và một mẫu có giới hạn. Màn hình hiển thị bao gồm thời gian đã dành cho việc đăng nhập, thời gian thu thập ước tính và thời gian dự phòng để đóng gói. Đối với các tệp, ước tính ban đầu dựa trên tốc độ 1 MiB/s và biên độ thời gian gấp đôi; khi quá trình tiến hành, giả định này sẽ được thay thế bằng tốc độ thực tế đã đo được. Sử dụng **Chỉ tin nhắn** hoặc chọn ít cuộc trò chuyện hơn khi thời gian ước tính vượt quá thời gian còn lại. Thời gian chờ Takeout được báo cáo của Telegram được tính vào ngân sách. Trình thu thập sẽ ngừng quá trình thu thập khi thời gian còn lại cần dành cho việc đóng gói, lưu giữ dữ liệu đã thu thập và đánh dấu kết quả bán phần. Do đó, một phiên 120 phút sẽ sử dụng khoảng thời gian thu thập còn lại thay vì chờ đến hạn chót mới bắt đầu chuẩn bị kho lưu trữ. Màn hình hiển thị các mục đã chọn mà không thể lấy mẫu ở kích thước đầy đủ. ## Chọn chế độ này hoặc một cố định# | Chế độ chụp | Phạm vi có thể tùy chỉnh | Sự khác biệt | | --- | --- | --- | | Telegram Takeout, tùy chọn mặc định | Tất cả các cuộc trò chuyện trên đám mây có thể truy cập hoặc các cuộc trò chuyện đã chọn, ngày tháng, danh mục tài khoản, chính sách phương tiện truyền thông và chế độ xem JSON/HTML | Sử dụng cơ chế xuất dữ liệu chính thức của Telegram; có thể cần phải được phê duyệt hoặc phải chờ đợi. Takeout có thể liệt kê các kênh/nhóm còn lại trong trường hợp Telegram cho phép và yêu cầu thêm dữ liệu cá nhân. | | API Telegram thông thường | Phạm vi tài khoản và các tùy chọn đầu ra tương tự, tùy thuộc vào các phương thức có sẵn thông qua API thông thường | Không khởi tạo Takeout; không thể liệt kê các kênh bên trái/siêu nhóm hoặc truy xuất dữ liệu cá nhân chỉ có trên Takeout. Danh bạ chỉ bao gồm người dùng Telegram chứ không phải toàn bộ danh sách liên hệ đã lưu trên điện thoại. Giới hạn tốc độ vẫn được áp dụng. | | Nhật ký sự kiện trò chuyện | Một cuộc trò chuyện được chọn, các chính sách về tệp đính kèm và hình đại diện tùy chọn | Ghi lại lịch sử và những thay đổi được quan sát thấy trong quá trình chạy này. Các danh mục tài khoản, bộ lọc theo ngày và chế độ xem tương thích với máy tính để bàn không áp dụng. | Cả ba chế độ này đều có cùng chứng nhận GitHub và tính năng truyền tải được mã hóa. Takeout chọn phương thức thu thập dữ liệu và không bao giờ bị thay thế một cách âm thầm bằng việc truy cập API thông thường. TgWitness tạo các bản xem JSON/HTML từ các bản ghi đã thu thập và giữ nguyên phương thức thu thập dữ liệu đã chọn trong tệp xuất. Xem [API chính thức của Takeout](https://core.telegram.org/api/takeout). Mặc định sẽ sử dụng Takeout, bao gồm tất cả các loại cuộc trò chuyện có thể truy cập (kể cả các cuộc trò chuyện đã lưu trữ), tất cả ngày tháng, hồ sơ tài khoản và danh bạ, các định dạng JSON và HTML tương thích, cũng như các tệp tải xuống. Dung lượng lưu trữ phương tiện ban đầu là 4 GiB, với các giới hạn tệp theo từng loại được hiển thị rõ ràng; đối với các tệp có dung lượng lớn hơn hoặc khi đã hết dung lượng tải xuống, hệ thống sẽ sử dụng các giá trị băm (hash) từ máy chủ nếu có sẵn. Vui lòng kiểm tra các giới hạn này trước khi tiến hành thu thập. Các giá trị băm không thể khôi phục lại tệp gốc. Các tùy chọn như ảnh, câu chuyện, siêu dữ liệu phiên và dữ liệu cá nhân bổ sung vẫn là các lựa chọn riêng biệt. Việc lấy dữ liệu có thể cần được phê duyệt trong một phiên Telegram đã thiết lập sẵn. Telegram quy định thời gian chờ; việc đăng nhập mới hoặc trình chạy mới sẽ không thể bỏ qua thời gian này. Khoảng thời gian ghi lại tối đa là 120 phút, bao gồm cả quá trình đăng nhập và phê duyệt, do đó, đối với tài khoản có dung lượng lớn hoặc thời gian chờ phê duyệt kéo dài, quá trình này có thể không hoàn tất. Việc xuất dữ liệu cục bộ liên tục có thể tiếp tục cùng một phiên, nhưng không kế thừa chứng nhận từ GitHub. ### Đồng ý và xác nhận các cài Sau khi **kiểm tra cài đặt và kích thước**, hãy nhấn **Lưu cài đặt để xác minh**. Thống nhất kết quả `sealed-export-settings.json` với người đánh giá trước khi thu thập. Các thay đổi sẽ làm mất hiệu lực của bản đánh giá đã lưu. Người thu thập ký xác nhận các cài đặt có hiệu lực và mã SHA-256 của chúng, đồng thời các biên lai xuất tài khoản cũng ràng buộc các tùy chọn tương ứng. Người xác minh báo cáo chế độ thực tế, lựa chọn và tính đầy đủ, và từ chối bất kỳ sự không nhất quán nào giữa nhật ký và bản xuất tài khoản lồng nhau. ``` python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete ``` `--expected-selection` từ chối các phương thức truyền tải, phạm vi trò chuyện, bộ lọc hoặc chính sách tệp đính kèm khác. `--require-complete` chỉ chấp nhận các bản xuất tài khoản và nhật ký trò chuyện được ghi nhận là đã hoàn tất. Nếu không có các cờ này, quá trình xác minh vẫn kiểm tra nguồn gốc và tính toàn vẹn đồng thời báo cáo các cài đặt đã ghi lại và các lỗ hổng. Thống nhất lựa chọn dự kiến trước khi chạy và lưu trữ riêng biệt với kho lưu trữ. Phạm vi và khoảng thời gian thu thập xác định tài liệu được thu thập trong quá trình chạy; sử dụng các quan sát trước đó đã được lưu giữ khi so sánh với các phiên bản trước. | Yêu cầu | Chế độ | | --- | --- | | Xuất dữ liệu tài khoản có thể truy cập hoặc các cuộc trò chuyện đã chọn trong một phiên làm việc có thời hạn và cung cấp cho người kiểm tra một bản lưu trữ đã được xác nhận bởi bên thứ ba | GitHub Actions: Bản ghi lại (bản xem trước) | | Theo dõi liên tục nhiều cuộc trò chuyện, quản lý tài khoản, tìm kiếm và đọc kho lưu trữ ngày càng mở rộng | Không gian làm việc cục bộ hoặc Docker | Thao tác này sẽ bắt đầu một quá trình thu thập dữ liệu riêng biệt với thông tin đăng nhập mới. Quá trình này sẽ không tải lên nhật ký cục bộ hiện có của bạn, không xuất không gian làm việc đang mở, cũng như không tái sử dụng phiên Telegram của nó. Một quá trình thu thập dữ liệu trên đám mây chưa hoàn tất sẽ không thể tiếp tục sau khi trình chạy của nó bị hủy; một quy trình làm việc mới sẽ bắt đầu một quá trình thu thập dữ liệu mới. Tính năng **Exports → Open capture helper** trong không gian làm việc sẽ mở trình hướng dẫn đầy đủ ngay trong bảng điều khiển. Trang độc lập cũng sử dụng cùng một trình hướng dẫn, các điều khiển và chủ đề. Cả hai đều lưu trữ khóa và quá trình giải mã trong trình duyệt của bạn. Quá trình khởi động quy trình làm việc GitHub và bảng điều khiển Telegram tạm thời sẽ mở trong các tab riêng biệt; trình hướng dẫn sẽ thông báo cho bạn biết khi nào cần quay lại. Việc khóa không gian làm việc sẽ xóa khóa đang được lưu trong bộ nhớ của trình hướng dẫn. Tệp khóa đã lưu của bạn vẫn được giữ lại trên thiết bị của bạn. ## Điều gì là công khai, và điều gì phải được giữ riêng Quá trình thu thập dữ liệu được thực hiện trên một trình chạy tiêu chuẩn do GitHub lưu trữ. GitHub, trình thu thập dữ liệu đã được phê duyệt cùng các phụ thuộc, trang trợ giúp, trình duyệt và đường hầm HTTPS là những thành phần đáng tin cậy trong cấu hình này. Máy chủ tạm thời xử lý phiên Telegram và các tin nhắn dạng văn bản thuần túy; các sản phẩm được chuyển giao sẽ được mã hóa dành cho người nhận. Việc tạo nhánh sẽ sao chép mã nguồn dự án vào kho lưu trữ của bạn. Quá trình này **không** xuất tài khoản Telegram của bạn. Dữ liệu đầu vào cho quy trình làm việc của người nhận là một khóa mã hóa công khai. Giữ `sealed-key.json`, thông tin đăng nhập Telegram, mã đăng nhập, mật khẩu 2FA và URL kết nối đã được giải mã khỏi các commit, đầu vào quy trình làm việc và nhật ký công khai. Quy trình làm việc này sẽ công bố các thành phần kết nối/kết quả đã được mã hóa trong vòng một ngày. Hãy tải cả hai xuống kịp thời; các điều kiện về tính khả dụng của GitHub Actions, giới hạn tài khoản và thanh toán sẽ được áp dụng. Việc tạo bản phân nhánh công khai không đồng nghĩa với việc được đảm bảo sử dụng tài nguyên tính toán miễn phí không giới hạn. Không có khoản thanh toán nào hoặc mã thông báo truy cập GitHub nào được nhập vào công cụ hỗ trợ. Khóa giải mã riêng tư được lưu trữ trong trình duyệt/tệp của bạn. Dữ liệu phiên Telegram và các quan sát dưới dạng văn bản thuần túy nhất thiết phải tồn tại bên trong bộ thu thập tạm thời. GitHub và đường hầm HTTPS vẫn là cơ sở hạ tầng đáng tin cậy. Chứng thực có thể công khai bản tóm tắt lưu trữ và danh tính quy trình làm việc; nội dung lưu trữ không được đưa vào chứng thực. Dấu thời gian của chứng thực không phải là dấu thời gian của tin nhắn. ## Khắc phục sự cố | Triệu chứng | Bước tiếp theo | | --- | --- | | Không **Chạy quy trình công việc** nút | Hãy tạo nhánh riêng của bạn, kích hoạt tính năng Actions và đồng bộ hóa nó với nhánh nguồn `main`. Không được chỉnh sửa các pin đã được phê duyệt từ nguồn chính để vượt qua lỗi. | | Không `sealed-connection` vật phẩm | Kiểm tra xem tác vụ đã bắt đầu và hoàn tất bước khởi động/tải lên hay chưa. Các sự cố liên quan đến hàng đợi, trình chạy, tải xuống hình ảnh, đường hầm hoặc chính sách kho lưu trữ có thể khiến quá trình khởi động bị gián đoạn. | | Không thể thiết lập kết nối | Tải khóa đã lưu cho lần chạy này, giải nén tệp đã tải xuống và chọn `connection.tgwsealed`. Trình chạy vẫn phải đang hoạt động. | | Lịch sử đang tạm dừng | Kiểm tra trạng thái của bảng điều khiển và sử dụng tính năng “Tiếp tục” khi phiên làm việc vẫn còn hoạt động, hoặc kết thúc với dữ liệu đã thu thập được. Các giới hạn của Telegram và nội dung không thể truy cập có thể gây ra những khoảng trống. | | Không `sealed-result` | Việc hủy bỏ hoặc hết hạn trước khi bắt đầu thu thập sẽ không tạo ra tệp lưu trữ; quá trình đó sẽ kết thúc với thông báo **Không có tệp lưu trữ**. Một bước thu thập, xác nhận hoặc đóng gói không thành công cũng sẽ ngăn cản việc giao hàng; bước không thành công sẽ nêu rõ lý do của người giám sát mà không bao gồm dữ liệu cá nhân. Kiểm tra thông tin này mà không cần đăng nhập bằng thông tin xác thực. | | Trình duyệt không thể giải mã một tệp lưu trữ có dung lượng lớn | Hãy sử dụng CLI streaming dưới đây cho các gói có dung lượng lớn hơn 256 MiB. Nếu khóa riêng bị sai hoặc bị mất, kết quả sẽ không thể được giải mã. | | Quá trình xác minh từ chối người ký | Hãy sử dụng một bản cài đặt TgWitness đáng tin cậy và mới nhất cùng với tệp caller chính xác `OWNER/REPOSITORY`. Không chấp nhận chính sách thay thế đi kèm với tệp lưu trữ. | | Telegram vẫn hiển thị phiên làm việc tạm thời | Hãy kết thúc quá trình này tại Cài đặt → Thiết bị. Quá trình đăng xuất có thể không thành công và quy trình làm việc bị buộc dừng có thể không thực hiện được việc dọn dẹp. | Trước khi dựa vào bản xem trước này, hãy thử một cuộc trò chuyện nhỏ do bạn kiểm soát: tạo một tin nhắn và tệp đính kèm, thu thập chúng, giải mã kết quả, chạy trình xác minh, kiểm tra kết quả về phạm vi bảo mật/phương tiện truyền thông và xác nhận việc thu hồi phiên Telegram. Các kiểm tra tự động sử dụng một ứng dụng Telegram mô phỏng cùng với một bài kiểm tra chứng chỉ GitHub thực tế riêng biệt; chưa có bất kỳ lần chạy nào trên tài khoản thực với phiên bản hiện tại được ghi nhận. ## Giải mã và xác minh tại Hãy sử dụng các công cụ từ một nguồn cài đặt đáng tin cậy và độc lập, chứ không phải các tệp thực thi được cung cấp từ một kho lưu trữ bằng chứng không rõ nguồn gốc: ``` python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip # Unzip delivery.zip using your archive manager, then: python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` Đối với việc phân phối nhiều phần, hãy giải mã gói chính trước tiên và giữ tệp manifest đã giải nén của gói đó bên cạnh mỗi phần được mã hóa, sau đó chạy lệnh: ``` python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` Bản kê khai là đối tượng được xác thực và liên kết mọi phần cũng như tệp ZIP đã nén. Sử dụng `--max-gib` để đặt giới hạn xác minh sau khi giải nén phù hợp cho một tập tin lưu trữ lớn; giá trị mặc định là 4 GiB. Các kiểm tra "expected-selection" và "complete-scope" cũng hoạt động với việc truyền tải nhiều phần. Python 3.11 trở lên, các phụ thuộc của dự án và phiên bản GitHub CLI mới nhất hỗ trợ `--signer-digest` và `--deny-self-hosted-runners` là bắt buộc. Một công cụ tạo khóa CLI cũng có sẵn: `python -m tgwitness.sealed_crypto keygen sealed-key.json`. Trình xác minh sử dụng `tgwitness/sealed_policy.json` từ bản cài đặt đáng tin cậy. Nó kiểm tra kho lưu trữ của người gọi, quy trình ký của bên nguồn, cam kết của người ký được phê duyệt, yêu cầu về trình chạy được lưu trữ, bản tóm tắt ZIP đầy đủ, nhật ký nội bộ và tính toàn vẹn của tệp đính kèm, nguồn khóa tài khoản mới nhất, và cam kết của bộ thu thập như dự kiến. Nó hiển thị lịch sử và kết quả phương tiện thay vì ngụ ý rằng tất cả dữ liệu đã được lưu trữ. Danh sách bản phát hành được phê duyệt trống sẽ bị từ chối. Việc cập nhật chính sách là một quyết định tin cậy rõ ràng; tuyệt đối không tự động chấp nhận chính sách do chính kho lưu trữ đề xuất. Để sử dụng ngoại tuyến, hãy lấy các khóa gốc đáng tin cậy từ trước từ một môi trường đáng tin cậy: ``` gh attestation trusted-root > trusted_root.jsonl python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl ``` Dấu thời gian của chứng nhận liên quan đến cam kết của kho lưu trữ. Nó không xác thực dấu thời gian của tin nhắn hay đồng hồ thực tế của người thu thập. Xem [các tùy chọn xác minh của GitHub](https://cli.github.com/manual/gh_attestation_verify). ## Cách giữ fork nằm ngoài quá trình capture Lệnh gọi chứa một tham chiếu cấp công việc đến quy trình làm việc có thể tái sử dụng ở phía thượng nguồn tại một SHA cam kết đầy đủ. Quy trình làm việc đó thực hiện việc kiểm tra mã nguồn **từ kho lưu trữ phía thượng nguồn tại một SHA cố định của bộ thu thập**. Một quy trình làm việc mặc định `actions/checkout` trong quy trình làm việc có thể tái sử dụng sẽ kiểm tra mã nguồn của đối tượng gọi và được thiết kế để không được sử dụng. Quy trình làm việc này không khôi phục bộ nhớ đệm của bên gọi, không sử dụng các thành phần của bên gọi, không thực thi các tệp của bên gọi, cũng như không chấp nhận các URL nguồn/hình ảnh, lệnh shell, tệp ZIP đã chuẩn bị sẵn, hoặc các giá trị băm để ký. Quy trình này chỉ chấp nhận người nhận công khai được giới hạn và thời lượng phiên làm việc. Các hành động, hình ảnh cơ sở Python và các thành phần được Cloudflare tùy chỉnh được cố định bằng các giá trị băm bất biến; các phụ thuộc Python sử dụng các yêu cầu đã được khóa bằng băm sẵn có. Hình ảnh được xây dựng từ nguồn đáng tin cậy mà không sử dụng bộ nhớ đệm. Trình thu thập chạy với tư cách người dùng không phải root, sử dụng hình ảnh chỉ đọc, đã vô hiệu hóa các khả năng của Linux, có giới hạn tài nguyên và không có môi trường socket Docker hay token GitHub. Các thư mục được gắn duy nhất của nó là thư mục cấu hình mới, thư mục không gian làm việc và thư mục đầu ra. Ứng dụng FastAPI bị hạn chế này cung cấp các chức năng đăng nhập, hộp thoại, tài khoản có thể cấu hình hoặc thu thập tin nhắn trò chuyện, trạng thái, tiếp tục, hoàn tất và hủy bỏ. Không có đường dẫn tải xuống dưới dạng văn bản thuần túy, đường dẫn quản trị chung, đường dẫn nhập dữ liệu hoặc điểm cuối ký tên. Người giám sát dừng các container kết nối mạng trước khi thao tác xác nhận đọc bản sửa lỗi cuối cùng `evidence.zip` hoặc `evidence.parts.json`. Container đóng gói không có kết nối mạng. Các bước tải lên chỉ có tên `connection.tgwsealed` và `delivery*.tgwsealed`; cả bằng chứng văn bản thuần túy lẫn thông tin đăng nhập Telegram đều không được tải lên dưới dạng sản phẩm. Quá trình dọn dẹp sẽ xóa các thư mục và container riêng tư, và GitHub sẽ loại bỏ máy ảo runner được lưu trữ sau khi công việc hoàn tất. Thời gian lưu giữ sản phẩm là một ngày; hãy tải xuống trước khi hết hạn. Chủ sở hữu nhánh có thể thay thế người gọi hoặc tạo một tệp đã ký khác. Hệ thống kiểm tra nghiêm ngặt phải từ chối **quy trình làm việc/bản tóm tắt của người ký khác** thu được. Cơ chế này vẫn phụ thuộc vào việc không có lỗ hổng có thể bị khai thác trong mã nguồn đã được phê duyệt cũng như vào tính toàn vẹn của trình chạy và cơ sở hạ tầng ký của GitHub. ## Chuyển giao mật Mỗi khóa người nhận là RSA-3072 (cũng chấp nhận các khóa RSA-4096 được nhập vào), số mũ 65537. Mỗi lớp bọc có một khóa AES-256 ngẫu nhiên mới và giá trị nonce 96 bit. RSA-OAEP với SHA-256/MGF1-SHA256 bao bọc khóa AES. AES-GCM với thẻ 128-bit xác thực toàn bộ tiền tố và tải trọng. Khóa công khai của người nhận là DER SPKI ở định dạng base64; tệp khóa riêng chứa DER PKCS8 ở định dạng base64. Các byte của phần bao gồm `TGWSEAL1\n`, độ dài tiêu đề JSON dạng uint32 theo định dạng big-endian, tiêu đề, văn bản mã hóa và thẻ GCM 16 byte. Tiêu đề có chính xác `algorithm`, `key`, và `nonce`; thuật toán là `RSA-OAEP-256+A256GCM`. Tiền tố hoàn chỉnh trong tiêu đề là dữ liệu xác thực bổ sung của GCM. Kích thước tiêu đề được giới hạn ở 8192 byte. CLI truyền tải dữ liệu có dung lượng lên đến 8 GiB và thực hiện xác thực trước khi ghi kết quả được yêu cầu; nó từ chối ghi đè lên đích đã tồn tại. Đây là một lớp bao bọc dành riêng cho dự án xung quanh các nguyên thủy mật mã tiêu chuẩn: RSA-OAEP với SHA-256 và AES-256-GCM, có sẵn trong OpenSSL và mọi thư viện mật mã chính. Các byte bằng chứng gốc được xác thực **trước khi** đưa bằng chứng và chứng nhận vào gói bên ngoài đã được mã hóa. Điều này giúp tránh sự phụ thuộc tuần hoàn giữa hàm băm của kho lưu trữ và chứng chỉ được bao gồm bên trong chính kho lưu trữ đó. Đối với các kho lưu trữ công khai, siêu dữ liệu xác thực (kho lưu trữ, quy trình làm việc, lần cam kết, tên thành phẩm và bản tóm tắt) là công khai. Tuyệt đối không được đưa tên người dùng vào siêu dữ liệu công khai. ## Phạm vi và việc xác thực Chế độ này sử dụng nhật ký có chữ ký và bộ máy xuất dữ liệu tài khoản. Các cuộc trò chuyện bí mật, lịch sử đã xóa trước thời điểm thu thập và dữ liệu mà tài khoản không thể truy cập được sẽ bị loại trừ. Các cuộc trò chuyện trên đám mây riêng sẽ được tính vào nếu được chọn. Trình chọn cuộc trò chuyện được giới hạn ở 20.000 cuộc đối thoại; quá trình xuất tài khoản sẽ tự động xác định khối lượng dữ liệu của chính nó. Dữ liệu thiếu, tệp bị lỗi và các tác vụ chưa hoàn thành sẽ được ghi lại. Các giới hạn về tệp đính kèm cũng như giới hạn dung lượng đĩa và thời gian của trình chạy vẫn được áp dụng. Việc gửi dữ liệu lớn sử dụng các phần được mã hóa thay vì giới hạn gửi cố định 4 GiB. Hoàn thành có nghĩa là các tác vụ đã chọn bị đóng băng đã kết thúc, không phải là mọi bản ghi lịch sử của Telegram đều tồn tại trong kho lưu trữ. Nhật ký trò chuyện cũng có thể theo dõi các cập nhật trực tiếp; không có chế độ nào là bản chụp nhanh nguyên tử. Ảnh chụp màn hình và bản ghi màn hình được tạo ra không thuộc phạm vi của chế độ này. Các bài kiểm tra bao gồm đăng nhập mới mô phỏng, cách ly phạm vi, phương tiện truyền thông, hủy bỏ, hoàn thành một phần hạn chót, đăng xuất thất bại, các đường dẫn và trường API bị cấm, từ chối không gian làm việc được tải sẵn, từ chối do khóa sai và can thiệp, các cờ xác thực bắt buộc, và khả năng tương tác mã hóa giữa trình duyệt và Python. Bài kiểm tra chấp nhận trình duyệt sử dụng một chứng nhận giả được ghi nhãn rõ ràng; đây không phải là bài kiểm tra Sigstore thực tế. Các bài kiểm tra thực tế trên máy chủ lưu trữ, Docker, chứng thực GitHub và kiểm tra chấp nhận Telegram trực tiếp phải được báo cáo riêng biệt với các kiểm tra tổng hợp cục bộ. [Các điều khoản của GitHub Actions](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) giới hạn việc sử dụng các runner được lưu trữ trong phạm vi vòng đời của dự án phần mềm. Việc tạo nhánh (fork) không loại bỏ các hạn chế này; bản xem trước này không được quảng bá là dịch vụ lưu trữ sản xuất miễn phí không giới hạn. [Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) cũng được thiết kế dành cho mục đích thử nghiệm và phát triển. Các tệp helper/workflow phù hợp để đánh giá tính năng này; việc đáp ứng các điều kiện cho dịch vụ sản xuất vẫn là một yêu cầu triển khai riêng biệt. ## phát hành của người duy trì# 1. Ghi lại và kiểm tra các thành phần thu thập dữ liệu, trình giám sát, định nghĩa vùng chứa và các bài kiểm thử. 2. Ghim bản cam kết của bộ thu thập vào `sealed-collector.yml`, sau đó thực hiện commit/kiểm duyệt quy trình làm việc có thể tái sử dụng. Không bao giờ tự động lấy mã nguồn từ SHA của người gọi một cách im lặng. 3. Ghim bản cam kết quy trình làm việc có thể tái sử dụng vào `sealed-witness.yml` và thêm cặp SHA của workflow/collector vào `sealed_policy.json` trong một bản phát hành đáng tin cậy. 4. Xuất bản tất cả các commit được tham chiếu và hàm trợ giúp, sau đó kiểm thử một nhánh fork độc lập và chứng chỉ GitHub thực tế. Không được gộp các commit được tham chiếu bởi các điểm neo này trừ khi các tham chiếu đó được tạo lại và xuất bản lần nữa. Xem [các quy trình làm việc có thể tái sử dụng và các xác nhận](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) để hiểu rõ sự khác biệt giữa kho lưu trữ của bên gọi và bên ký ở phía thượng nguồn. --- # Telegram · Điều tra trên tất cả các cuộc trò chuyện Canonical page: https://phishdestroy.io/tgwitness/vi/docs/cases/ Tiến hành điều tra Telegram từ đầu đến cuối trên các kênh, nhóm, cuộc trò chuyện riêng tư và bot: thu thập toàn bộ tài khoản, lịch sử, danh sách người dùng, liên kết, tệp tin, dòng thời gian và bằng chứng đã được xác minh. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Một vụ việc trọn vẹn qua kênh, nhóm, trò chuyện riêng và bot: thu thập, nối các manh mối, dựng lại dòng thời gian, bàn giao. Một sự cố bịa, từ đầu đến cuối. Thu thập, tìm kiếm và hồ sơ người tìm ra các bản ghi, [Case Board](https://phishdestroy.io/tgwitness/vi/docs/case-board/) sắp xếp chúng, [Report studio](https://phishdestroy.io/tgwitness/vi/docs/reports/) trình bày chúng. TRƯỜNG HỢP ĐÃ XỬ LÝ / ĐỊA CHỈ NHẬN THANH TOÁN ĐÃ ĐƯỢC THAY ĐỔI ### Một sự cố. Bốn cuộc trò chuyện. Một dấu vết cần được tái hiện. Một bài đăng trên kênh trỏ tới một bot. Một nhóm bàn về liên kết thanh toán mới và bot hiển thị nó. Bài đăng bị sửa, một cuộc trò chuyện riêng lặp lại liên kết, một tin nhắn trong nhóm biến mất. Ai là người đã đăng tải từng phiên bản?Liên kết này xuất hiện ở đâu?Tệp nào đã được lưu giữ?Điều gì đã thay đổi và vào thời điểm nào? Tải lịch sử, AI, MCP, OCR và webhook: [Làm việc với kho lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/archive/). ## 1. Đảm bảo phạm vi bao quát toàn bộ tài khoản Phạm vi toàn tài khoản chỉ dùng cho tài khoản chuyên dụng. Tài khoản chính chỉ dùng các cuộc trò chuyện được chọn hoặc một thư mục. 1. [Kết nối tài khoản](https://phishdestroy.io/tgwitness/vi/docs/accounts/) trong không gian làm việc riêng. Ghi lại mã vụ việc, ID tài khoản, không gian làm việc và dấu vân tay khóa. 2. **Nguồn → Phạm vi quan sát → Chế độ điều tra**: **Toàn bộ tài khoản**, cả bốn loại nguồn, **Hành động của chính mình**. Mỗi cuộc trò chuyện mới được lưu hồ sơ và **200 tin nhắn hiển thị** gần nhất. **Lưu phạm vi** và xác nhận. 3. **Tải các cuộc trò chuyện** và so sánh với danh sách trò chuyện của tài khoản. Giới hạn là 1.000 hội thoại (tối đa 20.000 trong **Tham số → Các cuộc trò chuyện được đọc từ danh sách tài khoản**); những cuộc vượt giới hạn sẽ hiện ra khi chúng có hoạt động. 4. **Cài đặt ghi lại** → **Tất cả hoạt động hiển thị**, kiểm tra giới hạn tệp đính kèm và dung lượng đĩa. Khởi động, rồi thử bằng một tin nhắn, một lần sửa và một lần xóa. Các kênhCác nhómCác cuộc trò chuyện riêng tưCác bot MỘT TÀI KHOẢN / MỘT KHÓA KÝ**Tất cả các hoạt động có thể nhìn thấy trên tài khoản đã được chọn → một sổ ghi chép duy nhất** Tin nhắn · các thao tác chỉnh sửa · thông báo xóa · phản ứng hiển thị · các sự kiện liên quan đến tư cách thành viên · các hành động của chính người dùng "Toàn bộ tài khoản" nghĩa là mọi cuộc trò chuyện tài khoản này mở được, trừ các mục loại trừ. Trò chuyện bí mật được ghi lại bằng mô-đun Secret Chats. Cuộc trò chuyện mới được thêm khi xuất hiện; lịch sử cũ được tải khi bạn yêu cầu. ## 2. Thu thập lịch sử và bảo quản các tệp tin Tạo một bộ sưu tập Case Board và đánh dấu những gì quan trọng. Giữ sổ đăng ký nguồn: ID trò chuyện, tiêu đề, tài khoản, vai trò, thời điểm bắt đầu ghi trực tiếp, kết quả lịch sử, kết quả phương tiện, khoảng trống. | Yêu cầu | Thao tác trên bảng điều khiển | Các tính năng mà công cụ này cung cấp | | --- | --- | --- | | Lịch sử trong các cuộc trò chuyện đã kích hoạt | Nguồn → Tải lịch sử đầy đủ | Các tin nhắn trước đây có sẵn sẽ được đưa vào nhật ký không gian làm việc, kèm theo tính năng tạm dừng/tiếp tục và báo cáo tiến độ có chữ ký. [Hướng dẫn lịch sử](https://phishdestroy.io/tgwitness/vi/docs/reference/history/). | | Bối cảnh cuộc trò chuyện hiện có trong sổ ghi chép | Nguồn → Cài đặt ghi lại → Bản chụp lịch sử | Các tin nhắn gần đây dưới dạng bản ghi có chữ ký. Mặc định 500, tối đa 10.000 trong **Tham số → Bản chụp lịch sử lớn nhất**. | | Lịch sử đầy đủ hiện có của một cuộc trò chuyện | Xuất toàn bộ cuộc trò chuyện → Xuất toàn bộ cuộc trò chuyện, hoặc Cuộc trò chuyện → Xuất cuộc trò chuyện | Một gói có chữ ký riêng chứa `chat.json` và `chat.html`, mỗi cuộc trò chuyện một gói. | | Bối cảnh khi một cuộc trò chuyện mới xuất hiện | Phạm vi quan sát → Khi một cuộc trò chuyện hoặc bot mới xuất hiện | Hồ sơ của nó và tối đa 1.000 tin nhắn gần đây (200 trong Chế độ điều tra). Không áp dụng cho các cuộc trò chuyện đã có. | | Dung lượng tệp đính kèm | Tải xuống các tệp đính kèm có thể xem được + giới hạn theo từng loại | Tìm `media.saved` kèm SHA-256 và kích thước. Đang chờ, bị bỏ qua hoặc thất bại nghĩa là chưa được lưu. | Bản xuất trò chuyện không đi vào sổ nhật ký hay hồ sơ người. Để tìm lịch sử cũ bên trong TgWitness, hãy dùng **Tải toàn bộ lịch sử** hoặc bản chụp. Ở đây: kênh, nhóm, cuộc trò chuyện với bot và cuộc trò chuyện riêng, cùng tệp hóa đơn và mã băm của nó. Những gì bị xóa trước khi ghi đã mất. ## 3. Theo dõi diễn biến cuộc trò chuyện và các hành động của chính quý vị Cứ để nó chạy. Gắn sao cho các cuộc trò chuyện nóng để ưu tiên, chỉnh việc kiểm tra lại trong **Cài đặt ghi lại → Kiểm tra lại**, và theo dõi `recheck.completed`, FloodWait cùng kết quả phương tiện. **Trò chuyện → Hồ sơ → Lưu hồ sơ ngay** lưu phần mô tả của cuộc trò chuyện, lệnh bot và siêu dữ liệu khác. **Theo dõi một bot hoặc lời mời trong khuôn khổ vụ việc** 1. **Trò chuyện → Mở liên kết Telegram**, lưu bản xem trước trước. Liên kết và bản xem trước trở thành bản ghi có chữ ký. 2. Nếu cần, **Tham gia / mở và quan sát** sẽ tham gia cuộc trò chuyện hoặc khởi động bot với tham số khởi động của nó. 3. Để ghi lại một hành động, hãy trả lời hoặc dùng **Nhấn nút** từ bảng điều khiển. Bạn nhận được `interaction.requested` và `interaction.result` kèm câu trả lời của bot. Đây là những hành động thật. Nút được nhấn trong ứng dụng khác không nhìn thấy được, chỉ thấy câu trả lời của bot. Không hỗ trợ ứng dụng web, thanh toán hay điện thoại/vị trí. ## 4. Theo dõi các cá nhân, liên kết và tệp tin trong các cuộc trò chuyện 1. **Sổ nhật ký**, **Tất cả nguồn**, tìm một cụm từ, tên miền hoặc tên người dùng. Mở kết quả và gửi chúng **Vào bảng**. 2. **Trò chuyện → Mọi người → Bật hồ sơ**, chọn một người: lịch sử tên, các lần trả lời, hoạt động, **Cũng có trong…**, liên kết, ví, số điện thoại. Mở các bản ghi được trích dẫn. 3. Lần theo cùng một ID người dùng dạng số sang các cuộc trò chuyện khác. Tên, ví hoặc ảnh đại diện trùng khớp là manh mối cần đối chiếu với ID số. 4. So sánh mã băm tệp. Cùng SHA-256 = cùng byte. BẢN ĐỒ VỤ VIỆC / THEO DÕI CÁC THAM CHIẾUTrường hợp giả định · không phải biểu đồ thực tế KÊNH / THÔNG BÁO**Bản gốc → bản đích đã chỉnh sửa** Bản ghi số 101, số 188 – Tin nhắn số 84 · không xác định người gửi NHÓM / HOẠT ĐỘNG**Người dùng 71001 đã đăng liên kết mới** Bản ghi số 146 · tin nhắn số 309 · Biên nhận tệp đã lưu số 151 BOT / CUỘC TRÒ CHUYỆN ĐẶT HÀNG**Một nút bấm dẫn đến trang đích đó** Bản ghi số 173 · tin nhắn số 12: Dữ liệu meta của nút “Quay lại” RIÊNG TƯ / THEO DÕI**Người dùng 71001 lặp lại địa chỉ đích** Bản ghi số 205 · tin nhắn số 922 · Biên nhận tệp đã lưu số 209 Bốn cuộc trò chuyện cung cấp các quan sát khác nhau. Theo dõi các bản ghi nguồn cho mọi kết nối; bài đăng trên kênh không có người gửi được xác định. Các ID số và tham chiếu bản ghi được tạo ra riêng cho hướng dẫn này. Bản đồ giải thích này cho thấy cách kết nối kết quả tìm kiếm, hồ sơ và các bản ghi đã kiểm tra; Case Board lưu trữ các thẻ tương ứng và tham chiếu nguồn. | Kết nối | Quan sát bổ sung | Kết luận cần giữ lại | | --- | --- | --- | | Cùng một tài khoản Telegram | ID người dùng 71001 trong nhóm #146 và cuộc trò chuyện riêng tư #205 | Cùng ID người gửi ở cả hai cuộc trò chuyện. | | Địa chỉ đích lặp lại | `pay.example.invalid/new` tại #146, siêu dữ liệu nút #173, bài đăng đã chỉnh sửa #188 và #205 | Cùng một liên kết ở bốn nơi. | | Cùng số byte tệp | Các giá trị SHA-256 hoàn toàn trùng khớp trong các biên nhận phương tiện đã hoàn tất số #151 và #209 | Hai tệp giống hệt nhau đến từng byte. | Hồ sơ chỉ bao gồm những người đã viết gì đó trong *không gian làm việc này*, không phải danh sách thành viên. Số trích dẫn mỗi dữ kiện: **Tham số → Số bản ghi được trích dẫn mỗi dữ kiện**. ## 5. Phục dựng trình tự và đánh dấu các khoảng trống Xem phiên bản trong **Trò chuyện**, rồi **Sổ nhật ký** với **Tất cả nguồn** + **Lần sửa**, **Lần xóa**, **Phạm vi**. Ghi cả hai mốc thời gian vào dòng thời gian: ngày của Telegram và lúc được quan sát. 1. 09:00 · #101**Bài đăng trên kênh đã được ghi lại** Địa chỉ đích ban đầu được giữ nguyên. 2. 09:12 · #146 / #151**Nhóm giới thiệu một liên kết khác** Người dùng 71001 đã đăng tải nội dung này; quá trình tải xuống tệp đính kèm đã hoàn tất. 3. 09:16 · #173**Bot hiển thị cùng một đích đến** Dữ liệu siêu liên kết được lưu trữ trong thông tin siêu dữ liệu bàn phím. 4. 09:20 · #188**Các thay đổi trong thông báo trên kênh** Cả các quan sát ban đầu lẫn các quan sát đã được chỉnh sửa đều được giữ nguyên. 5. 09:24 · #205 / #209**Phần tiếp theo dành cho đối tượng riêng tư cũng lặp lại nội dung này** Tệp đính kèm đã lưu có mã SHA-256 đầy đủ trùng khớp với #151. 6. 09:28 · #231**Thông báo về việc xóa nhóm đã được gửi đến** Quan sát trước đó vẫn còn nguyên giá trị; thông tin về người xóa cũng như thời điểm xóa chính xác đều không được cung cấp. Các mốc thời gian quan sát và tham chiếu mang tính minh họa. Các bản ghi nhật ký khác xuất hiện giữa các mục này. Thứ tự trong sổ nhật ký là thứ tự đến, không nhất thiết là thứ tự xảy ra. Hãy tách riêng bản ghi trực tiếp, bản chụp, tin nhắn khôi phục, lần xóa và "không thấy khi kiểm tra lại", và đánh dấu mọi khoảng trống là không rõ. ## 6. Mở rộng phạm vi áp dụng sang các tài khoản thu thập khác Mỗi tài khoản một không gian làm việc, các bước như cũ. Ghi lại vai trò và dấu vân tay của từng cái. Số tin nhắn tính theo từng tài khoản, nên luôn nói rõ không gian làm việc và cuộc trò chuyện nào. Một [nhóm tài khoản](https://phishdestroy.io/tgwitness/vi/docs/groups/) hiển thị trạng thái, chia sẻ cài đặt và xuất tất cả cùng lúc, mỗi tài khoản vẫn có sổ nhật ký và khóa riêng. Dòng thời gian xuyên tài khoản thì bạn tự dựng trong ghi chú. Vụ việc kéo dài? Hãy thêm một [nhân chứng độc lập](https://phishdestroy.io/tgwitness/vi/docs/witness/), và thử xem mỗi tài khoản thực sự bắt được gì. ## 7. Cung cấp một gói hồ sơ vụ việc có thể kiểm tra được Một ZIP có chữ ký từ mỗi không gian làm việc (luôn là toàn bộ sổ nhật ký, bộ lọc không ảnh hưởng), cùng hồ sơ người, bản xuất trò chuyện và tệp. ``` CASE-001/ # assembled by the analyst case-notes.md # question, findings, alternative explanations sources.csv # every chat, role, acquisition result and gap timeline.csv # account + chat + message + seq + both times workspace-A/ evidence.zip # complete signed observation journal retained-checkpoint.json profiles-operations.json # separately signed people profiles history-channel.zip # signed current-history export history-group.zip verification.txt workspace-B/ # separate journal and trusted fingerprint witness/ # retained checks, journal and signed posts SHA256SUMS # hashes of the delivered files ``` Gửi dấu vân tay riêng. Xác minh mọi thứ với chính không gian làm việc của nó: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` Điểm kiểm tra được ký bằng khóa thu thập, do đó bản thân nó không đáp ứng yêu cầu tối thiểu về bằng chứng; lệnh `--require evidence`cũng cần có dấu thời gian đã được xác minh hoặc bài đăng của người làm chứng bao phủ bản ghi cuối cùng. Giữ kết quả của công cụ xác minh, bản gốc, phạm vi và biên bản chuyển giao cùng các phát hiện của bạn. Viết thành báo cáo trong Report studio. Nếu người nhận cần ít hơn, hãy làm một [bản bàn giao rút gọn](https://phishdestroy.io/tgwitness/vi/docs/handover/). --- # Telegram · Tạo Case Board Canonical page: https://phishdestroy.io/tgwitness/vi/docs/case-board/ Thu thập các quan sát đã lưu, các điểm nổi bật chính xác và các đoạn hành động trên một bảng riêng tư, thảo luận với nhóm của bạn và trình bày bộ sưu tập. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Biến tin nhắn đã lưu thành một vụ việc mà cả nhóm cùng xử lý. Dấu trang, trích dẫn chính xác, lát cắt và thảo luận, mỗi thứ đều liên kết tới nguồn. Mọi thay đổi là một bản sửa đổi có chữ ký. ## Từ một tin nhắn đến một thẻ vụ án 1. **Điều tra → Case Board** (chế độ Tiêu chuẩn hoặc Chuyên gia). Tạo một bộ sưu tập cho vụ việc. 2. Trong **Sổ nhật ký** hoặc một cuộc trò chuyện, bấm **Vào bảng** (hoặc **B**). Thẻ rơi vào Hộp thư đến, đặt tiêu đề rồi di chuyển nó. 3. Chọn văn bản trong tin nhắn, **Đánh dấu → bảng** giữ trích dẫn chính xác và phiên bản. Ghi chú vì sao nó quan trọng. 4. Thảo luận, đặt trạng thái, quay về nguồn bất cứ khi nào cần. **Trình bày** dẫn cả nhóm đi qua từng phần. ### Sử dụng một liên kết thanh toán đã được cập nhật Ví dụ tổng hợp · minh họa địa phương 1. **Ghi lại.** Mở bản ghi quan sát đã lưu #142 và phiên bản tin nhắn của nó. 2. **Đánh dấu trang.** Lưu lại trích dẫn, nguồn tham khảo và câu hỏi của bạn vào một thẻ. 3. **Xem xét.** Thêm bình luận của nhóm và chuyển thẻ sang trạng thái “Xem xét”. 4. **Trình bày.** Hướng dẫn quy trình thu thập và mở bối cảnh nguồn được trích dẫn. #### Ghi chú đã lưu #142 “Sử dụng liên kết thanh toán mới.” Trò chuyện vận hành · tin nhắn 38 · quan sát lúc 09:12 UTC #### Thẻ: đã thay đổi đích đến > Sử dụng liên kết thanh toán mới. Câu hỏi: đích đến nào đã xuất hiện trong phiên bản trước đó? #### Kiểm duyệt của nhóm Chuyên viên phân tích: so sánh với quan sát số 101. Trạng thái: Đang xem xét · bản sửa đổi được giữ nguyên #### Bối cảnh nguồn Thẻ → phiên bản đã lưu → quan sát trước đó Chú thích và quá trình quan sát Telegram vẫn có thể được nhận diện riêng biệt. ## Lưu một phạm vi hữu ích một lần Shift-click hai tin nhắn để **Cắt lát ở giữa**, dùng **Cắt lát theo thời gian**, hoặc lưu bộ lọc Sổ nhật ký hiện tại. **Hiển thị bản ghi được thêm kể từ dấu trang** cho thấy những gì đến sau. Lát cắt theo thời gian dùng thời điểm quan sát; lát cắt theo ID tin nhắn đi theo các tin nhắn đó khi chúng thay đổi. ## Gán vai trò phù hợp cho từng đồng nghiệp **Người kiểm duyệt** đọc, **Nhà phân tích** thêm thẻ và bình luận, **Người vận hành** còn quản lý bộ sưu tập và quyết định. Quyền trò chuyện cũng áp dụng cho thẻ. ## Hoàn thiện công việc thành sản phẩm đầu ra Lát cắt xuất ra JSON có chữ ký hoặc CSV. Báo cáo có thể gồm dấu trang, lát cắt và bình luận, thiết lập điều đó trong [Report studio](https://phishdestroy.io/tgwitness/vi/docs/reports/). Với người nhận bị giới hạn, hãy dùng [bản bàn giao](https://phishdestroy.io/tgwitness/vi/docs/handover/). Chi tiết: [tài liệu tham khảo Case Board](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/). --- # Telegram · Thiết kế báo cáo Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reports/ Chọn dữ liệu báo cáo, một trong tám mẫu thiết kế và nội dung, sau đó xem trước và xuất dưới dạng HTML, PDF có chữ ký hoặc gói bằng chứng hoàn chỉnh. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Đưa người đọc từ câu hỏi của vụ việc thẳng tới các bản ghi đã lưu. Report studio ghép dữ liệu bạn chọn, lịch sử thay đổi, biểu đồ và các phát hiện của bạn. Tám thiết kế, HTML và PDF gốc. Mọi báo cáo HTML, PDF và JSON đều được niêm phong bằng khóa của bạn. ## Tạo báo cáo trong ba bước 1. **Xuất → Cấu hình và xem trước → Dữ liệu**: toàn bộ không gian làm việc, hoặc chọn cuộc trò chuyện, tác giả, ngày (UTC, lúc TgWitness thấy bản ghi) và loại bản ghi. 2. **Thiết kế & nội dung**: chọn thiết kế và những gì được đưa vào: biểu đồ, người tham gia, bản ghi hội thoại, thay đổi, mục Case Board, chi tiết vụ việc và ghi chú của bạn. 3. **Xem trước**: kiểm tra số lượng, hoạt động, mẫu và các dải ID bị thiếu. Lưu, rồi tải định dạng bạn cần. ### Sắp xếp lại các tài liệu đã lưu trữ sao cho phù hợp với người đọc Ví dụ tổng hợp · bố cục sơ đồ, không phải báo cáo được tạo tự động 1. **Chọn.** Chọn hai cuộc trò chuyện và khoảng thời gian quan sát cho vụ việc. 2. **Soạn thảo.** Chọn bố cục và các phần trả lời câu hỏi. 3. **Xem trước.** Kiểm tra số lượng đã chọn và văn bản trước và sau khi dịch đã được lưu. 4. **Xác minh.** Tạo tệp cuối cùng và kiểm tra chữ ký của tệp đó so với dấu vân tay của không gian làm việc đáng tin cậy. #### Một số lưu ý 2 cuộc trò chuyện · 1 ngày quan sát Tin nhắn, các thao tác chỉnh sửa và thông báo xóa #### Cấu trúc báo cáo ##### Đã thay đổi địa chỉ nhận thanh toán Câu hỏi vụ việc → phạm vi → kết quả → tham chiếu hồ sơ **Bối cảnh tin nhắn** Ghi chú #142: “Sử dụng liên kết thanh toán mới.” **Thay đổi đã lưu** Trước: old.example.invalid → Sau: new.example.invalid #### Xem lại các lựa chọn 18 nhận xét · 2 bản sửa đổi đã lưu Thời gian gửi, chỉnh sửa và quan sát có các nhãn riêng biệt. #### Sản phẩm cuối cùng Tệp PDF đã ký + tệp JSON đã ký, hoặc tệp ZIP đã ký kèm theo báo cáo có thể đọc được Người nhận kiểm tra tệp và dấu vân tay đáng tin cậy. ## Chọn phong cách trình bày **Classic, Editorial, Briefing, Analytics, Technical, Overview, Reading series, and Ledger & margin**: cùng bản ghi, khác diện mạo. Khi chuyển, lựa chọn và ghi chú của bạn vẫn được giữ. Bất kỳ ngôn ngữ nào trong 25 ngôn ngữ. PDF được tạo bằng phông chữ đi kèm, không cần trình duyệt. Tiếng Trung, Nhật và Hàn cần phông chữ như Noto Sans CJK trên máy chủ (toàn hệ thống hoặc trong `TGWITNESS_FONT_DIR`), nếu không bạn chỉ có HTML và JSON. ## Đọc nội dung thay đổi cùng với bối cảnh của nó Lần sửa hiển thị trước và sau, lần xóa hiển thị phiên bản đã lưu cuối cùng. Trả lời, chuyển tiếp, biểu cảm, nút và tệp đính kèm giữ nguyên tham chiếu. Bản xem trước thiết kế dùng 50.000 bản ghi đầu tiên, bản xem trước dữ liệu đếm chính xác mọi thứ. Để xem bố cục trang cuối cùng, hãy tạo PDF. ## Chọn bản dành cho người nhận một cách cẩn thận Bộ lọc chỉ định hình báo cáo, ZIP bằng chứng vẫn chứa toàn bộ sổ nhật ký và tệp. Nếu người nhận chỉ nên nhận ít hơn, hãy dùng [bản bàn giao rút gọn](https://phishdestroy.io/tgwitness/vi/docs/handover/). Thêm: [nội dung báo cáo](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/), [xác minh bản xuất](https://phishdestroy.io/tgwitness/vi/docs/exports/). --- # Telegram · Chuẩn bị bản sao để chia sẻ Canonical page: https://phishdestroy.io/tgwitness/vi/docs/handover/ Chọn các bản ghi và trường dữ liệu mà người nhận có thể truy cập, kiểm tra bản sao hoàn chỉnh và xác minh bản kê khai đã ký cùng ranh giới nhật ký nguồn. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Chỉ chia sẻ những gì cần, bản gốc vẫn nguyên vẹn. Bản bàn giao là một bản trích xuất có chữ ký riêng: chọn cuộc trò chuyện và người, ẩn danh tính hoặc nội dung, chọn tệp và ghi chú của nhóm. Bản kê ghi lại những gì được giữ, cắt bớt và loại bỏ. ## Chuẩn bị bản trích xuất cho người nhận 1. **Xuất → Trích xuất bàn giao**: ghi mục đích, chọn cuộc trò chuyện và khoảng thời gian, **Tải người từ các cuộc trò chuyện đã chọn** nếu bạn cần người có tên. 2. Tất cả những người khác: bí danh, loại bỏ, hoặc như đã ghi. Nội dung và tệp là các công tắc riêng; số điện thoại và email có thể được che. 3. Case Board: không gì cả, dấu trang và lát cắt, hoặc thẻ kèm bình luận. Tên thành viên nhóm có thể đổi thành bí danh. 4. **Tải xuống bản trích xuất bàn giao**, mở ra, xác minh, xem qua trước khi gửi. ### Một bản gốc, một bản sao để chia sẻ có chủ đích Ví dụ tổng hợp · chỉ mang tính minh họa 1. **Chọn.** Bao gồm cuộc trò chuyện của vụ việc và xác định người mà đoạn trích liên quan đến. 2. **Tối giản hóa.** Chọn cách hiển thị người tham gia khác trong bản sao được chia sẻ. 3. **Kiểm tra.** Mở báo cáo và các bản ghi trong tệp lưu trữ đã tạo trước khi gửi. 4. **Chia sẻ.** Gửi bản đã kiểm tra và thông báo mã băm đáng tin cậy của bản dịch này riêng biệt. #### Quan sát ban đầu Nora · người dùng 71002 “Tôi đã nhận được liên kết đã được sửa đổi.” Tạp chí nguồn lưu giữ quan sát đã lưu này. #### Bản dành cho người nhận Hiển thị như đã ghi lại: Nora · người dùng 71002 · “Tôi đã nhận được liên kết đã được sửa đổi.” Bí danh: P01 · “Tôi đã nhận được liên kết đã được sửa đổi.” Loại bỏ: tin nhắn của người tham gia này không được đưa vào bản dịch. #### Kiểm tra các tệp thực tế Đọc tệp report.html và records.jsonl. Kiểm tra danh tính, nội dung văn bản, tệp đính kèm và các bình luận tùy chọn của nhóm. #### Trích đoạn đã ký Lựa chọn + băm tệp + bản kê khai đã ký Một gói riêng biệt được liên kết với ranh giới nhật ký nguồn của nó ## Sử dụng các điều khiển này cùng nhau | Kiểm soát | Ảnh hưởng đến nội dung bản dịch | | --- | --- | | Người dùng | Người được chọn giữ nguyên tên; những người khác nhận bí danh hoặc bị loại bỏ. | | Văn bản | Toàn bộ nội dung, chỉ nội dung của người được chọn và tài khoản của bạn, hoặc không gì cả. | | Tệp tin | Tệp của người được chọn và tài khoản của bạn, tất cả tệp đang hiển thị, hoặc không gì cả. | | Bảng trường hợp | Không gì cả, dấu trang và lát cắt, hoặc thẻ kèm thảo luận. | Hãy đọc cả nội dung và tệp: bí danh không xóa những cái tên được viết bên trong tin nhắn hay tệp đính kèm. Nếu một tệp được chọn bị thiếu, hãy khôi phục nó hoặc loại tệp đính kèm ra. ## Đảm bảo nội dung có thể được kiểm tra độc lập ``` python -m tgwitness.verify handover.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` Tự giữ kho lưu trữ gốc và các điểm kiểm tra. Người nhận có thể xác minh bản sao của họ mà không cần nhận cả không gian làm việc. Thiết kế: [Report studio](https://phishdestroy.io/tgwitness/vi/docs/reports/). Mốc tham chiếu tin cậy: [xác minh bản xuất](https://phishdestroy.io/tgwitness/vi/docs/exports/). --- # Telegram · Quản lý một nhóm tài khoản Canonical page: https://phishdestroy.io/tgwitness/vi/docs/groups/ So sánh các không gian làm việc nhóm, tìm nguồn, xem xét các khoảng thời gian quan sát và áp dụng các cài đặt chung với các ngoại lệ cho từng tài khoản. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Chạy nhiều tài khoản cùng nhau, mỗi tài khoản vẫn có bản ghi và khóa riêng. Nhóm đặt trạng thái kết nối, bắt đầu/tạm dừng, cài đặt dùng chung và bản xuất trên một màn hình. Tiện khi nhiều tài khoản cùng làm một vụ việc. ## Mở tổng quan về nhóm Mở nhóm trong **Tài khoản**. Mỗi tài khoản hiển thị trạng thái, tuyến, độ trễ và tin nhắn được lưu gần nhất. **Cần chú ý** liệt kê những cái đang lỗi, **Sửa** đưa bạn thẳng tới đó. **Bắt đầu tất cả** / **Tạm dừng tất cả** sẽ hỏi trước khi thực hiện. **Cài đặt nhóm** được dùng chung, nhưng giá trị riêng của tài khoản vẫn giữ cho đến khi bạn thay. ### Kiểm tra thay đổi lộ trình trong một nhóm Ví dụ tổng hợp · các kiểm tra minh họa và kết quả 1. **Chọn.** Chọn nhóm và xem xét các tài khoản nào sẽ thay đổi. 2. **Chuẩn bị.** Giữ nguyên lộ trình riêng của tài khoản khi cần tách biệt. 3. **Kiểm tra.** Thử nghiệm kết nối được đề xuất và kiểm tra các kết quả đo lường. 4. **Áp dụng.** Kiểm tra lại trước khi lưu và xem xét kết quả cho từng tài khoản. #### Nhóm điều tra Trình thu thập kênh · Trình thu thập nhóm · Tài khoản tham chiếu 3 không gian làm việc riêng biệt #### Danh sách đã được xem xét 2 tài khoản sẽ thực hiện theo lộ trình đề xuất. Tài khoản tham chiếu duy trì lộ trình riêng của mình. #### Kiểm tra chuẩn bị Trình thu thập kênh: Thời gian truyền dữ liệu Telegram 84 ms Trình thu thập nhóm: Thời gian truyền dữ liệu Telegram 91 ms Các con số này là số liệu giả định dùng cho ví dụ. #### Kết quả ứng dụng Trình thu thập kênh: đã định tuyến bản lưu, tiếp tục quan sát. Trình thu thập nhóm: kiểm tra lại không thành công, các cài đặt trước đó đã được khôi phục. Tài khoản tham chiếu: giữ nguyên đường dẫn hiện tại. ## Thay đổi quy trình bằng cách thêm bước xem xét 1. **Thay đổi lộ trình nhóm**, chọn loại và cài đặt. 2. **Xem lại lựa chọn**: xem tài khoản nào thay đổi và tài khoản nào có tuyến riêng. 3. **Chuẩn bị và kiểm tra** thử một kết nối Telegram mới, cùng IP thoát nếu có thể. 4. **Áp dụng kết nối đã kiểm tra** và xem từng kết quả. Tài khoản đang chạy tiếp tục, tài khoản đang nghỉ vẫn nghỉ. Độ trễ là thời gian thiết lập kết nối Telegram, IP thoát là IP mà tuyến hiển thị lúc kiểm tra. Kết quả có thể khác nhau giữa các tài khoản. ## Sử dụng quyền truy cập chồng chéo **Trò chuyện mà nhiều tài khoản thấy** liệt kê các nguồn chung và phạm vi của chúng. Kênh và siêu nhóm có thể được nhiều tài khoản xuất cùng lúc bằng **Xuất với … tài khoản**. Trò chuyện riêng và nhóm thường thì không, vì số tin nhắn của chúng tính theo từng tài khoản. ## Xuất nhóm dưới dạng gói **Xuất nhóm** cho một ZIP chứa bản xuất có chữ ký của mọi tài khoản và danh sách có chữ ký của chúng. Mỗi bản giữ dấu vân tay riêng để xác minh. Dòng thời gian gộp thì bạn vẫn phải tự dựng. Tiếp theo: [báo cáo](https://phishdestroy.io/tgwitness/vi/docs/reports/), [Case Board](https://phishdestroy.io/tgwitness/vi/docs/case-board/), [xác minh bản xuất](https://phishdestroy.io/tgwitness/vi/docs/exports/). --- # Telegram · Tìm hiểu cách thức hoạt động của bằng chứng Canonical page: https://phishdestroy.io/tgwitness/vi/docs/concepts/ Theo dõi một tin nhắn từ khi được ghi lại cho đến điểm kiểm tra. Thay đổi một bản ghi mẫu, tính toán lại chuỗi SHA-256 của nó và xem điểm kiểm tra được lưu giữ sẽ phát hiện điều gì. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Tin nhắn thay đổi. Bản ghi về những gì bạn đã thấy thì không nên đổi, và ai cũng phải kiểm tra được điều đó. Bên dưới là hai thí nghiệm nhỏ. Tin nhắn giả, mọi thứ chạy trong trình duyệt của bạn, không gì được gửi tới Telegram. ## Từ bản xuất cuộc trò chuyện đến bản ghi có thể xác minh [Bản xuất của Telegram Desktop](https://telegram.org/blog/export-and-more) lưu lịch sử bạn thấy lúc này dưới dạng HTML hoặc JSON. TgWitness bổ sung một sổ nhật ký thay đổi liên tục, chữ ký trên mọi bản ghi và các điểm kiểm tra mà người khác có thể đối chiếu. | Nhiệm vụ | Xuất dữ liệu từ Telegram Desktop | TgWitness | | --- | --- | --- | | Đọc các cuộc trò chuyện đã lưu | HTML hoặc JSON kèm theo các tệp phương tiện đã chọn | Các cuộc trò chuyện đã lưu, nhật ký có thể tìm kiếm và báo cáo ngoại tuyến | | Theo dõi sự thay đổi theo thời gian | Lịch sử có sẵn khi xuất | Phiên bản cũ, các lần sửa sau và lần xóa, giữ lại tất cả | | Kiểm tra các tệp sau khi bàn giao | Các tệp xuất chuẩn HTML/JSON không có chữ ký | Bản kê có chữ ký, bản ghi có chữ ký và báo cáo niêm phong, kiểm tra bằng khóa tin cậy | | So sánh với trạng thái được lưu giữ trước đó | Giữ một bản sao tham khảo riêng biệt hoặc mã băm | Các điểm kiểm tra đã ký, một nhân chứng riêng biệt và dấu thời gian bên ngoài tùy chọn | Phần so sánh dựa trên [mã xuất của Telegram Desktop](https://github.com/telegramdesktop/tdesktop/tree/768d47cda6c7f447c10a25d1f363279493a90ed7/Telegram/SourceFiles/export/output) tính đến ngày 2 tháng 11 năm 2026. ## Một tin nhắn, ba nhận định Một tin nhắn mới, một lần sửa và một lần xóa trở thành ba bản ghi riêng biệt. Lần sửa không ghi đè bản đầu, và lần xóa không xóa sạch nó. 01 / QUÁ TRÌNH DI CHUYỂN CỦA TIN NHẮNTrình tự minh họa Telegram delivers an update to the collector, which appends a journal record. · Telegram · Trình thu thập · Sổ ghi chép · cập nhật → · thêm vào → XEM CUỘC TRÒ CHUYỆN HIỆN TẠI Tin nhắn số 42 Tin nhắn đã bị xóa Tin nhắn đã biến mất khỏi giao diện trò chuyện. SỔ NHẬT KÝ QUAN SÁT 3 bản ghi 1. 01 `message.new` Hẹn gặp lúc 10:00 ✓ 2. 02 `message.edited` Hẹn gặp lúc 11:00 ✓ 3. 03 `message.deleted` Thông báo xóa đối với #42 ✓ Cả ba quan sát đã nhận được đều được lưu giữ trong sổ ghi chép. Quy trình đơn giản hóa dành cho một nguồn đã được chọn sẵn. Các bản ghi hoạt động cũng được chia sẻ trong sổ nhật ký thực tế. Việc ghi lại phụ thuộc vào những gì tài khoản có thể xem được và những gì Telegram cung cấp. ## Thay đổi một bản ghi. Theo dõi mã băm. Mỗi bản ghi chứa mã băm của bản ghi trước nó. Một điểm kiểm tra lưu ở nơi khác cố định độ dài sổ nhật ký và mã băm cuối cùng. 02 / HASH-CHAIN SANDBOXSHA-256 thực · các bản ghi mẫu GHI CHÉP 01**Đã nhận được tin nhắn**`h₁ = SHA-256(e₁)`Liên kết đến 64 số 0 GHI CHÉP 02**Hẹn gặp lúc 11:00**`h₂ = SHA-256(e₂)`Bao gồm thẻ h₁ GHI CHÉP 03**Đã ghi nhận hành vi xóa tin nhắn**`h₃ = SHA-256(e₃)`Bao gồm h₂ ĐƯỢC LƯU TRỮ TẠI NƠI KHÁC**3 bản ghi · tiêu đề `h₃`**Hãy so sánh ranh giới cố định này với nhật ký được cung cấp. Việc thay đổi một sự kiện sẽ làm thay đổi giá trị băm của nó. Việc tái tạo chuỗi sẽ thay đổi phần đầu của chuỗi. Việc xóa phần cuối sẽ khiến chuỗi ngắn hơn so với điểm kiểm tra được lưu giữ. **Xem bản ghi số 2 và các giá trị băm đầy đủ** Đây chính là dữ liệu JSON định dạng UTF-8 đã được băm trong ví dụ này. Các giá trị trong đây là hư cấu; chín trường dữ liệu và cách tuần tự hóa đều phù hợp với định dạng sổ nhật ký. ``` ``` Bản ghi đã lưu 2 hash `` Băm của bản ghi số 2 đã được tính toán lại `` Môi trường thử nghiệm này chỉ tính toán các giá trị băm, không phải chữ ký. Công cụ xác minh thực tế cũng kiểm tra chữ ký Ed25519, trình tự và liên kết của từng sự kiện. Việc chỉ tái tạo các giá trị băm không thể tạo ra các chữ ký hợp lệ dưới khóa tin cậy. ## Các quy tắc cụ thể, tóm tắt trong vài dòng HASH + CHỮ KÝ h0 = 064 hi = hex(SHA-256(C(ei))) σi = Ed25519.Sign(sk, unhex(hi)) **C** là chín trường sự kiện dưới dạng JSON UTF-8: khóa được sắp xếp, không có khoảng trắng thừa, không thoát ASCII, không NaN/vô cực. `previous_hash` là hi−1, h0 là 64 số không, chữ ký bao phủ 32 byte thô của bản tóm lược. Các trường: `seq`, `observed_at`, `source_at`, `kind`, `chat_id`, `message_id`, `actor_id`, `payload`, `previous_hash`. Đặc tả đầy đủ: [mã hóa sự kiện](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#event-canonicalization). ĐIỂM KIỂM TRA ĐƯỢC GIỮ LẠI Nexport ≥ Ncheckpoint hexport[Ncheckpoint] = Hcheckpoint Kiểm tra chữ ký điểm kiểm tra bằng khóa đã ghim, rồi so sánh với sổ nhật ký. Bản xuất sau có thể dài hơn, nhưng phải khớp tại điểm kiểm tra. ## Ba câu hỏi, ba bước kiểm tra khác nhau [01 / TÍNH TOÀN VẸN**Bản ghi này có thay đổi không?** Mã băm và chữ ký đối chiếu với khóa bạn tin cậy.](https://phishdestroy.io/tgwitness/vi/docs/exports/)[02 / TÍNH LIÊN TỤC**Những nội dung nào đã được lưu giữ trước đó?** So sánh bản xuất với các điểm kiểm tra mà nhân chứng đã lưu.](https://phishdestroy.io/tgwitness/vi/docs/witness/)[03 / PHƯƠNG THỨC CUNG CẤP**Các sự kiện thử nghiệm này đã được gửi đến chưa?** Gửi, sửa và xóa tin nhắn thử, rồi xem mỗi tài khoản bắt được gì.](https://phishdestroy.io/tgwitness/vi/docs/cases/) Chữ ký trả lời "có bị thay đổi không", điểm kiểm tra trả lời "có khớp với những gì có trước đó không", tin nhắn thử trả lời "chúng ta có bắt được hết không". [Xác minh chứng minh được gì.](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) Tiếp theo: một [cuộc điều tra toàn bộ tài khoản](https://phishdestroy.io/tgwitness/vi/docs/cases/) từ đầu đến gói hồ sơ vụ việc. [Hướng dẫn xuất dữ liệu: Xem thí nghiệm trên máy tính để bàn được kiểm soát](https://phishdestroy.io/tgwitness/vi/docs/export-clinic/). Hãy so sánh đoạn phim dài hai phút, bản ghi gốc và bảy cặp tệp xuất thử nghiệm. Các chỉnh sửa cục bộ đã được công bố. --- # Telegram · Hãy đảm bảo tính bảo mật Canonical page: https://phishdestroy.io/tgwitness/vi/docs/security/ Tìm hiểu vị trí lưu trữ các phiên làm việc, khóa và bằng chứng; những dữ liệu nào được truyền ra khỏi máy tính của quý vị; phạm vi bảo vệ bao gồm những gì; cũng như cách tăng cường bảo mật cho hệ thống cài đặt. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Những gì rời khỏi máy của bạn, mỗi khóa bí mật mở được gì, và các lớp bảo vệ lo phần nào, phần nào là trách nhiệm của bạn. **127.0.0.1**Địa chỉ bảng điều khiển theo mặc định **256 bit**mã thông báo bảng ngẫu nhiên **0**CDN, phân tích dữ liệu hoặc phông chữ từ xa **Ed25519**chữ ký trên mỗi bản ghi ## Nơi lưu trữ mọi thông tin Máy thu thập, bảng điều khiển và mọi bản ghi đều ở trên máy của bạn. Mặc định chỉ liên lạc với Telegram; mọi thứ khác là một công tắc riêng. 06 / NHỮNG GÌ ĐƯỢC LƯU LẠI TỪ HỆ THỐNGQuá trình cài đặt của quý vị MÁY TÍNH HOẶC MÁY CHỦ CỦA QUÝ VỊ **Bảng điều khiển**127.0.0.1:8787 · mã thông báo bearer **Trình thu thập**Mỗi không gian làm việc tương ứng với một ứng dụng Telegram THƯ MỤC DỮ LIỆU **Sổ ghi chép**SQLite · chuỗi băm · có chữ ký **Phương tiện truyền thông**các tệp được đặt tên theo mã SHA-256 **Vault**Fernet · phiên làm việc, cặp API, khóa ký, máy chủ proxy - **Telegram**Luôn luôn · thông qua lộ trình của quý vị Kết nối MTProto của tài khoản: trực tiếp, SOCKS5, HTTP hoặc MTProxy. Chế độ Ẩn địa chỉ IP sẽ chờ một máy chủ proxy hoạt động. Chế độ chuyển sang kết nối trực tiếp yêu cầu phải có chế độ cho phép rõ ràng việc này. - **Nội dung ngoài trang web**Tùy chọn · tắt theo mặc định Nhật ký, tệp tin và các điểm kiểm tra được mã hóa bằng thuật toán AES-GCM trước khi tải lên kho lưu trữ tương thích với S3. Khóa mã hóa do quý vị quản lý; các tệp đính kèm được đặt tên dựa trên hàm băm có khóa, chứ không phải hàm băm nội dung của chúng. - **Thông báo**Tùy chọn · tắt theo mặc định Các vấn đề và số lần thay đổi được hiển thị kèm theo tiêu đề cuộc trò chuyện. Các đoạn trích tin nhắn chỉ được gửi khi quý vị bật tính năng này. - **Tính xác thực của dấu thời gian**Tùy chọn · tắt theo mặc định Chỉ bao gồm mã SHA-256 của điểm kiểm tra đã được ký và một giá trị ngẫu nhiên (nonce). Không chứa tin nhắn hay tên người dùng trong cuộc trò chuyện. - **Witness**Tùy chọn · tắt theo mặc định Công cụ này trích xuất các điểm kiểm tra đã được ký và số lần ghi lại bằng một mã thông báo chỉ đọc. Công cụ này không thể đọc nội dung cuộc trò chuyện hoặc thay đổi cài đặt. Mặc định: chỉ kết nối Telegram mới được truyền ra khỏi máy này. Các đích lưu trữ tùy chọn được cấu hình riêng cho từng không gian làm việc. ## Mỗi bí mật sẽ mở ra điều gì | Bí mật | Nơi lưu trữ | Những lợi ích mà công cụ này mang lại | Trong trường hợp thông tin bị rò rỉ | | --- | --- | --- | --- | | **Mã thông báo bảng điều khiển** | `panel-token.txt` trong thư mục dữ liệu; trình duyệt giữ nó theo từng tab | Mọi thứ trong mọi không gian làm việc | Dừng TgWitness, xóa `panel-token.txt`, khởi động lại: bạn nhận được token mới | | **Phiên làm việc trên Telegram** | Kho lưu trữ, được mã hóa (`credentials.enc`) | Tài khoản Telegram này | Kết thúc phiên làm việc trên Telegram tại *mục Cài đặt → Thiết bị* | | **Khóa ký** | Kho lưu trữ, được mã hóa (`signing.enc`) | Ký bản ghi dưới dấu vân tay của bạn | Điểm kiểm tra lưu ở nơi khác, nhân chứng và dấu thời gian vẫn cho thấy những gì đã tồn tại trước đó | | **Khóa kho lưu trữ** | `vault.key` cạnh dữ liệu, hoặc một khóa chính bên ngoài | Kho bảo mật | Hãy coi như phiên và khóa ký cũng đã bị lộ | | **Token Witness** | Trên máy chủ Witness | Chỉ đọc: điểm kiểm tra và tình trạng | Xóa nó trên trang Nhân chứng, tạo cái mới | | **Nội dung chính trên trang web bên ngoài** | Vault; chỉ cần tải xuống một lần để phục hồi | Bản sao ngoài trang web | Ai có cả bucket đều giải mã được: hãy coi bản sao là đã bị lộ | ## Phạm vi bảo vệ bao gồm những gì ### Đã được đề cập - Bản ghi bị sửa, xóa hoặc đổi thứ tự: chuỗi băm hoặc chữ ký bị phá vỡ. - Sổ nhật ký bị cắt bớt hoặc dựng lại sau khi bạn đã lưu điểm kiểm tra ở nơi khác: điểm kiểm tra không còn khớp. - Đoán token: 256 bit ngẫu nhiên, so sánh thời gian hằng định, 15 lần thất bại trong một phút là địa chỉ bị chặn. - Nội dung trò chuyện độc hại: văn bản vẫn là văn bản, không bao giờ là HTML; tệp đính kèm tải xuống dưới dạng tệp; bảng điều khiển không tải gì từ trang web khác. - Thư mục dữ liệu bị đánh cắp khi dùng khóa kho bảo mật bên ngoài: phiên và khóa vẫn được mã hóa. ### , xin để quý vị tự quyết định - Token chính làm được mọi thứ. Hãy cấp cho người khác quyền truy cập giới hạn và giữ token chính cho riêng mình. - Hãy giữ dấu vân tay và điểm kiểm tra ở nơi khác. - Hãy mã hóa ổ đĩa, siết chặt quyền. - HTTP thường bên ngoài localhost làm lộ token. Hãy dùng HTTPS hoặc đường hầm SSH. - Hãy kiểm tra phạm vi để tìm khoảng trống và thử việc nhận tin trên chính tài khoản và nguồn của bạn. [Chia sẻ quyền truy cập vào một vụ việc](https://phishdestroy.io/tgwitness/vi/docs/access/) với quyền hạn, thời hạn và giới hạn phiên. ## Tăng cường bảo mật cho hệ thống cài đặt Đã hoàn thành 0/8 1. **Hãy sử dụng một tài khoản Telegram chuyên dụng**, không bao giờ dùng tài khoản chính. 2. **Giữ bảng điều khiển trên 127.0.0.1.** Truy cập từ xa chỉ qua HTTPS (Caddy đi kèm) hoặc đường hầm SSH. 3. **Mã hóa ổ đĩa** chứa thư mục dữ liệu. 4. **Hãy giới hạn thư mục dữ liệu** cho tài khoản dịch vụ (0700 trên Unix, quyền thư mục trên Windows). 5. **Giữ khóa kho bảo mật ở nơi khác** trên máy chủ: đặt `TGWITNESS_VAULT_KEY_FILE` trước lần khởi động đầu tiên. 6. **Lưu dấu vân tay và điểm kiểm tra** trên một hệ thống khác, chạy nhân chứng trên một máy chủ khác. 7. **Tuyệt đối không được tải lên các** khóa `data/`, phiên làm việc, `panel-token.txt` hoặc khóa kho lưu trữ lên GitHub hoặc trong các cuộc trò chuyện. 8. **Không ghi lại** các tiêu đề `Authorization` hoặc nội dung yêu cầu tại máy chủ proxy ngược. **Tôi có thể thay đổi mã thông báo bảng điều khiển mà không làm mất dữ liệu không?** Có, nó chỉ mở bảng điều khiển. Dừng TgWitness, xóa `panel-token.txt`, khởi động lại. Sổ nhật ký, phiên và khóa vẫn còn. Nếu đã đặt `TGWITNESS_TOKEN`, giá trị đó được ưu tiên hơn tệp. ## Báo cáo lỗ hổng bảo mật **Security → Report a vulnerability** trên GitHub. Phiên bản, tác động và cách tái hiện tối thiểu bằng dữ liệu giả. Không bao giờ gửi thông tin xác thực, thư mục tài khoản hay bằng chứng thật. Nếu báo cáo riêng tư bị tắt, hãy mở một issue xin kênh riêng tư, không kèm chi tiết khai thác. --- # Telegram · Thiết lập bot chứng cứ Canonical page: https://phishdestroy.io/tgwitness/vi/docs/witness/ Xuất bản các mốc kiểm tra của sổ nhật ký đã được ký số lên kênh Telegram của quý vị thông qua một nhân chứng độc lập, có khóa riêng và quyền truy cập chỉ đọc vào bộ thu thập dữ liệu. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Một tiến trình riêng kiểm tra sổ nhật ký của bạn và đăng các điểm kiểm tra có chữ ký lên một kênh. ## Hai máy chủ, hai khóa ký TỰ LẮP ĐẶT / THIẾT BỊ THU THẬP**Tài khoản + sổ ghi chép** Khóa ký của Trình thu thập phiên Telegram Điểm cuối kiểm tra chỉ đọc ← yêu cầu câu trả lời có chữ ký → HOST B / WITNESS**Xác minh + lưu trữ** Dấu vân tay bộ thu được ghim sẵn; Khóa ký chứng thực riêng biệt Sổ nhật ký riêng + mã thông báo bot Witness → API Bot Telegram →**Kênh của quý vị · các bài đăng TGW1 đã được ký điện tử** Công cụ TgWitness tự động thực hiện việc kiểm tra. Quyền truy cập của bộ thu thập chỉ giới hạn ở chế độ đọc. Việc đăng tải của bot sử dụng kết nối và mã thông báo của TgWitness; TgWitness không được cấp bất kỳ phiên tài khoản nào. 03 / CÁC QUYẾT ĐỊNH TẠI ĐIỂM KIỂM TRACác câu trả lời minh họa BẢN CUỐI CÙNG ĐƯỢC CHẤP NHẬN**120 bản ghi**`head 9c7d…` CÂU TRẢ LỜI TIẾP THEO**128 bản ghi**`head a4f2…` Đã được chấp nhận: số lượng tăng lên, chữ ký đã được xác minh và khóa khớp. TgWitness duy trì ranh giới mới này. Tất cả các ví dụ trả lời đều giả định có chữ ký hợp lệ và khóa được ghim. Các giá trị băm ở đây chỉ là minh họa tóm tắt. Để xác nhận toàn bộ tiền tố cũ không thay đổi, hãy so sánh bản xuất với các điểm kiểm tra đã lưu giữ. ## Chuẩn bị một bot và một kênh Tạo một bot bằng BotFather và cho phép nó đăng bài trong kênh của bạn. Hãy chạy nhân chứng ở nơi khác: một máy chủ khác, lý tưởng là do người khác vận hành, giá trị hơn nhiều so với một tiến trình thứ hai cạnh máy thu thập. ## Ba bước trong phần Tiện ích bổ sung 1. **Quyền chỉ đọc.** **Tiện ích → Nhân chứng độc lập**, tạo token, lưu tệp. Nó đọc điểm kiểm tra và tình trạng, không gì khác. 2. **Kênh và khoảng thời gian.** Kênh Telegram hoặc webhook Discord, cùng địa chỉ máy thu thập mà nhân chứng truy cập được. Lưu tệp cài đặt. 3. **Khởi chạy.** Đặt `witness.json`, `witness-token.txt` và `bot-token.txt` cùng nhau trên máy chủ nhân chứng và chạy: ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json ``` Chờ bài đăng có chữ ký đầu tiên trong kênh, rồi lưu dấu vân tay của nhân chứng ở nơi an toàn. Muốn dùng Discord? Lưu URL webhook thành `discord-webhook.txt`. Một nhân chứng đăng vào một nơi; các lần kiểm tra dài đến Discord dưới dạng tệp. ## Chọn tần suất đăng tải Đăng mỗi lần kiểm tra tạo ra một bản ghi bên ngoài đều đặn: cứ năm phút một lần là khoảng 288 bài mỗi ngày cho mỗi không gian làm việc. Cài đặt nâng cao có thể chỉ đăng khi có thay đổi hoặc sự cố, dùng proxy hoặc Bot API tùy chỉnh. **Thực tế, bot này xác nhận điều gì?** Nó yêu cầu máy thu thập cung cấp điểm kiểm tra có chữ ký, kiểm tra bằng khóa mong đợi và giữ sổ nhật ký có chữ ký riêng, kể cả các phản hồi bị lỡ và bị từ chối. Nó kiểm tra trạng thái sổ nhật ký, bản thân nó không theo dõi Telegram. Để làm việc đó, hãy chạy một phép thử nhận tin có kiểm soát. ## Xin vui lòng kiểm tra bằng chứng sau này Giữ sổ nhật ký của nhân chứng, các bài đăng và dấu vân tay. [Cách đối chiếu chúng](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/#verify) với bản xuất của máy thu thập. --- # Tại sao lại là mô hình Zero Trust: Taylor Wessing, Tiến sĩ Zurheide, Tiến sĩ Schelinski Canonical page: https://phishdestroy.io/tgwitness/vi/docs/signed-export/ Một nghiên cứu điển hình về mô hình “không tin tưởng”: một giải pháp tuân thủ GDPR do Tiến sĩ Patrick Zurheide và Tiến sĩ Tobias Schelinski thuộc công ty luật Taylor Wessing ký tên, đã được đối chiếu với chính tài liệu của nó, cùng với mô hình có thể kiểm chứng được, vốn không để lại bất kỳ khoảng trống nào cho sự gian dối hay nghi ngờ. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) **Nghiên cứu trường hợp thực tế**Tài liệu thật · chữ ký thật · mã băm được công bố dưới đây · số liệu có thể kiểm chứng lại ngoại tuyến Một nghiên cứu điển hình về lý do tại sao mô hình “Zero Trust” là cần thiết. Một yêu cầu truy cập dữ liệu cá nhân của chính người đó theo Điều 15 của GDPR, được các đối tác của một công ty luật quốc tế hàng đầu trả lời kèm theo chữ ký có chứng thực. Mọi cam kết trong câu trả lời đều phải được chấp nhận dựa trên sự tin tưởng: chữ ký, chức danh, “một tháng rà soát thủ công”, việc bảo vệ các bên thứ ba, “mọi tòa án đều sẽ đồng ý”. Khi đối chiếu với tệp tin được cung cấp, không có cam kết nào trong số đó được xác thực. Trang này cho thấy kết quả của việc đặt niềm tin, và cách một mô hình có thể kiểm chứng sẽ không để lại bất kỳ khoảng trống nào cho sự lừa dối hay nghi ngờ. Ngày 15 tháng 8 năm 2025 · thư[Tiến sĩ Tobias Schelinski](https://www.taylorwessing.com/en/people/germany/hamburg/dr-tobias-schelinski)Đối tác, Taylor Wessing · luật sư chuyên về luật công nghệ thông tin Ngày 1 tháng 10 năm 2025 · thư và Phụ lục 1[Tiến sĩ Patrick Zurheide, Thạc sĩ Luật (LL.M.)](https://www.taylorwessing.com/de/people/germany/hamburg/patrick-vincent-zurheide)Salary Partner, Taylor Wessing, từ năm 2025 · Công nghệ thông tin, bảo vệ dữ liệu và tranh tụng về công nghệ Các chức danh nghề nghiệp được trích dẫn từ các hồ sơ liên kết của công ty. Trang này không đề cập đến việc việc khóa tài khoản Steam có hợp lý hay không. Trang này chỉ trình bày nội dung của tệp tin đã được gửi và những gì các văn bản có chữ ký nêu ra về tệp tin đó. Mọi số liệu đều có thể được đối chiếu với các tệp tin. **830 trang**trong tệp đính kèm của lá thư thứ hai **36 giây**từ khi tạo ra đến lần thay đổi cuối cùng của tệp đính kèm đó **905.672 ký tự** có thể đọc được dưới các hình chữ nhật màu đen đó **2 chữ ký**được nêu rõ trong hai lá thư, mỗi lá một **Tóm lại,** chữ ký cho bạn biết ai là người gửi tệp tin. Nó không thể xác nhận liệu tệp tin đó có đầy đủ, chính xác hay đúng sự thật hay không. Chỉ có việc kiểm tra các byte mới có thể làm được điều đó, và bất kỳ ai cũng có thể thực hiện các kiểm tra này. ## Mô hình Zero Trust: Kiểm tra tệp tin, không phải người gửi “Zero trust” có nghĩa là không ai được tin tưởng: không phải một công ty, không phải một chức danh, không phải một chữ ký, và cũng không phải chúng tôi. Phản hồi đối với một yêu cầu truy cập phải tự chứng minh tính hợp lệ của mình. Nó phải trả lời được ba câu hỏi, trong khi chữ ký lại không trả lời được câu hỏi nào trong số đó. **Bản sao đã hoàn tất chưa?**Người yêu cầu đã có đầy đủ mọi thứ thuộc về mình chưa, và mọi thiếu sót đã được thống kê và giải thích chưa? **Bản sao có còn nguyên vẹn không?**Mỗi bản ghi có phải là thông tin ban đầu đã được lưu trữ hay không, và liệu bất kỳ thay đổi nào sau này có được hiển thị không? **Ai là người quyết định điều gì là bí mật?**Việc khấu trừ đó có phải do người có thẩm quyền quyết định hay không, và liệu sau đó có ai có thể kiểm tra lại việc đó không? Hầu hết các tranh chấp pháp lý trong Liên minh Châu Âu (EU) đều được giải quyết kín đáo: các thỏa thuận dàn xếp theo thỏa thuận bảo mật (NDA), hồ sơ được niêm phong, và các phán quyết không bao giờ được công bố. Chúng tôi không có ý kiến gì về điều đó. Trường hợp này thì khác, và có lẽ không phải vì những gì xảy ra trong đó là hiếm gặp. Trường hợp này không có thỏa thuận bảo mật (NDA) cũng như không có phán quyết của tòa án, nên có thể đọc từ đầu đến cuối: một đạo luật rất đơn giản, đó là GDPR; một yêu cầu truy cập dữ liệu cá nhân của chính người đó; những gì thực tế đã được cung cấp; và các hình chữ nhật màu đen mà bất kỳ ai cũng có thể xóa bỏ. Điều khiến vụ việc này trở nên đặc biệt chính là danh tính của những người trả lời và cách thức họ thực hiện. Tiến sĩ Tobias Schelinski và Tiến sĩ Patrick Zurheide là các luật sư hợp danh của Taylor Wessing — theo lời mô tả của chính công ty này, [đây là “một thế lực hàng đầu trong lĩnh vực dịch vụ pháp lý tại châu Âu”](https://www.businesswire.com/news/home/20251217415857/en/Taylor-Wessing-Diversifies-Its-International-Strategy). Cả hai đều có bằng tiến sĩ; một người là luật sư chuyên môn được chứng nhận về luật công nghệ thông tin, người kia có bằng Thạc sĩ Luật của Đại học Aberdeen. Họ đã mất 106 ngày để không xử lý một yêu cầu truy cập hợp pháp. Trong quá trình đó, họ đã cung cấp cho chủ tài khoản bị báo cáo các văn bản khiếu nại và thông tin đăng nhập của hơn 1.800 người khác, trong đó có thể có cả trẻ vị thành niên, dưới dạng các hình chữ nhật màu đen mà bất kỳ ai cũng có thể xóa bỏ. **Quan điểm của PhishDestroy.** Thông tin đăng nhập, cụ thể là tên người dùng, là dữ liệu mang tính cá nhân cao. Thông tin này được sử dụng lại trên nhiều dịch vụ khác nhau, và một tài khoản đã tồn tại trong nhiều năm, trong hầu hết các trường hợp, đều gắn liền với một người thật có thể được xác định danh tính thông qua đó. Nếu chỉ xem xét 50 mảnh thông tin hiển thị, chúng tôi cho rằng bất kỳ tòa án nào cũng có thể bị dẫn dắt sai lầm. Khi xem xét bức tranh toàn cảnh, dòng thời gian và các số liệu trên trang này cho thấy rõ ràng rằng yêu cầu theo GDPR đã không được xử lý. Việc thiếu chữ ký hay các lỗi chính tả trong tên cũng không thay đổi sự thật đó. ## Điều mà sự tin tưởng đã mang lại, và điều mà mô hình đó lẽ ra đã làm Mỗi khẳng định trong câu trả lời được trình bày dưới đây dựa trên tệp đã được cung cấp và dựa trên mô hình có thể kiểm chứng mà trang này đề xuất. Bằng chứng cho từng dòng được trình bày ở phần dưới. **Chữ ký** „Dieses Schreiben ist qualifiziert elektronisch signiert“ Ở đó ghi rõ ai là người gửi những lá thư đó. Phía dưới, 905.672 ký tự vẫn có thể đọc được dù bị che bởi những hình chữ nhật màu đen. [Bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#signature) Công ty ký một hàm băm có muối cho mỗi trường dữ liệu được ẩn đi. Nội dung sẽ được kiểm tra, chứ không phải người gửi. **Việc lựa chọn** Luật sư sẽ quyết định những gì người yêu cầu được phép đọc. Còn lại 50 đơn khiếu nại có thể đọc được, tất cả đều được nộp sau khi có lệnh chặn và yêu cầu; trong đó có 43 đơn là “Suspected Hijacker”. 1.944 đã được bao phủ. [Bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#convenient) Một quy định được ban hành và ký duyệt khi bản sao được lập, mọi hồ sơ bị giữ lại đều được thống kê, và quyết định đó được cơ quan có thẩm quyền xem xét. **“Một tháng rà soát thủ công”** „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ Một tệp tin dài 830 trang được tạo ra trong 36 giây. Dòng đầu tiên có thể đọc được trong tệp tin này là một lời lăng mạ mang tính kỳ thị người đồng tính, và những lời phàn nàn vẫn còn nguyên vẹn trong tệp tin lại bị chính tệp tin đó bác bỏ. [Bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#refuted) Lời nói của ai về sự nỗ lực cũng không có giá trị. Bản tài liệu tự nó đã chứng minh tất cả, và bất kỳ ai cũng có thể tìm ra mâu thuẫn trong đó. **Quyền của bên thứ ba** „soweit keine Rechte Dritter entgegenstehen“ Thông tin đăng nhập và nội dung khiếu nại của hơn 1.800 người khác, được hiển thị dưới dạng các hình chữ nhật màu đen mà bất kỳ ai cũng có thể xóa bỏ. [Bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#under) Dữ liệu của người khác không bao giờ xuất hiện trong bản sao của người yêu cầu. Dữ liệu này được truyền đi dưới dạng mã hóa, chỉ có thể giải mã bằng khóa của cơ quan có thẩm quyền. **Bản sao của dữ liệu** „Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ Các khoản thanh toán, phiếu yêu cầu hỗ trợ và hồ sơ liên quan đến vụ việc này đều không có. Chỉ có các khiếu nại là có vẻ đầy đủ. [Bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#inventory) Bảng kê hàng đã ký nêu rõ những mặt hàng được bao gồm và liệt kê những mặt hàng không có trong danh sách. Không có khoảng trống nào có thể bị bỏ sót. **“Mọi tòa án”** „Aus unserer Erfahrung wird jedes Gericht …“ Năm mươi đoạn trích có thể gây hiểu lầm. Toàn bộ tệp cho thấy một yêu cầu chưa được xử lý. [Bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#authority) Tòa án hoặc cơ quan quản lý mở bản gốc đầy đủ ra và đối chiếu từng mục với nội dung mà công ty đã ký. **Mỗi hàng đều có cấu trúc giống nhau.** Một lời cam kết mà người ta buộc phải tin, một tệp tin mâu thuẫn với lời cam kết đó, và một cuộc kiểm tra lẽ ra đã khiến lời cam kết đó trở nên thừa thãi. Với mẫu này, không có gì để lừa dối và cũng không có gì để nghi ngờ: người yêu cầu thấy những thông tin thuộc về họ, cơ quan chức năng thấy phần còn lại, và mọi trường dữ liệu đều tuân thủ đúng những gì công ty đã ký kết. [Xem mẫu](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#sealed) ## Các bằng chứng, từng điểm một Mỗi dòng trong phần so sánh ở trên đều dựa trên các tài liệu dưới đây: hai lá thư có chữ ký và Phụ lục 1. Các tham chiếu trang tuân theo thứ tự trang trong tệp PDF, và mọi hình vẽ đều có thể được tái tạo khi không kết nối mạng. ### Văn bản vẫn nằm bên dưới các hình chữ nhật màu đen. Đây là hình thức của một câu trả lời cho một yêu cầu tiếp cận thông tin đơn giản khi nó đến từ những người đứng đầu trong ngành. Các hình chữ nhật màu đen đã che đi phần văn bản gốc trong tệp tin. Điều này giúp người đọc có thể so sánh hai nhóm thông tin: 50 mô tả vẫn được hiển thị và 1.944 mô tả bị che khuất. BỨC THƯTẬP TIN ĐÃ GỬI “Bất kể nội dung cụ thể của các khiếu nại là gì” Chỉ riêng con số này đã cho thấy những vi phạm lặp đi lặp lại đối với thỏa thuận của Steam. Tiến sĩ Schelinski · 15 tháng 8 năm 2025 · tr. 2 „Unabhängig von den Einzelheiten der Beschwerden …“ **50**các mô tả vẫn hiển thị **Tháng 8–tháng 9 năm 2025** **1,944**các mô tả bị che khuất **Tháng 2 năm 2021 – Tháng 7 năm 2025** Trong số 50 mô tả có thể nhìn thấy, có 43 mô tả được gắn nhãn “Suspected Hijacker”. Trong số 1.944 mô tả được đề cập, có 269 mô tả mang nhãn đó. Phụ lục 1, tr. 444–620. Có một bản ghi khác có phần mô tả trống: 50 + 1.944 + 1 = 1.995 hàng trong bảng được cung cấp. ### Năm mươi đơn khiếu nại thuận tiện cho luật sư Bức thư tháng 10 nêu rõ lý do khóa tài khoản: tài khoản đã bị khóa vì „Used for Hijacking“ (Tiến sĩ Zurheide, tr. 8). Trong số 50 đơn khiếu nại mà người yêu cầu được phép đọc, có 43 đơn đều nêu cùng một nội dung: “Suspected Hijacker”. Tất cả 50 yêu cầu này đều được gửi đi nhiều tháng sau khi tài khoản bị khóa vĩnh viễn, sau khi có yêu cầu cấp quyền truy cập và sau lần đăng nhập cuối cùng được ghi lại trong cùng tệp tin đó. Phụ lục 1, trang 1, nêu rõ `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)`. Tài khoản này đã bị khóa vào ngày 7 tháng 5 năm 2025. Vào ngày 9 tháng 5 năm 2025, Bộ phận Hỗ trợ Steam đã trả lời phiếu yêu cầu đầu tiên: việc khóa tài khoản không phải là lỗi, mà là vĩnh viễn, và phiếu yêu cầu đã được đóng lại. Yêu cầu khôi phục quyền truy cập được gửi tiếp theo vào ngày 17 tháng 6. Theo chính lời kể trong các lá thư, vào thời điểm đó, tài khoản đã thuộc sở hữu của một bên thứ ba: Tiến sĩ Schelinski viết rằng tài khoản này được mua lại từ một bên thứ ba sau ngày 3 tháng 5 năm 2025 (trang 2), còn Tiến sĩ Zurheide cho biết một bên thứ ba đã thực hiện các khoản thanh toán qua tài khoản này sau ngày 3 tháng 5, lần cuối cùng vào ngày 30 tháng 7 năm 2025 (trang 1–2). Bảng khiếu nại được cung cấp sau đó ghi nhận: **53**Tháng 8 năm 2024 **54**Tháng 9 **70**Tháng 10 **79**Tháng 11 **82**Tháng 12 **92**Tháng 1 năm 2025 **32**Tháng 2 **35**Tháng 3 **20**Tháng 4 **12**Tháng Năm*bị chặn ngày 7 tháng 5 ; lần đăng nhập gần nhất vào ngày 23 tháng 5* **1**Tháng Sáu **7**Tháng Bảy **47**Tháng 8 **3**Tháng 9 Nội dung khiếu nại nằm dưới một hình chữ nhật màu đenNội dung đơn khiếu nại vẫn được giữ nguyên Số lượng khiếu nại hàng tháng trong Phụ lục 1, từ tháng 8 năm 2024 đến tháng 9 năm 2025, được thống kê từ lớp văn bản của tệp; lịch sử đầy đủ có tại mục[Tự kiểm tra](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#verify). Sau khi bị khóa vào ngày 7 tháng 5 và lần đăng nhập cuối cùng vào ngày 23 tháng 5: có một khiếu nại vào tháng 6, bảy khiếu nại vào tháng 7, rồi 47 khiếu nại vào tháng 8. 1. Ngày 3 tháng 5 năm 2025**Kể từ ngày này, theo các văn bản nêu trên: một bên thứ ba**Tài khoản này được “mua lại từ một bên thứ ba”: Tiến sĩ Schelinski, tr. 2 · “các khoản thanh toán do một bên thứ ba thực hiện”: Tiến sĩ Zurheide, tr. 1 2. Ngày 7 tháng 5 năm 2025**Tài khoản đã bị khóa**Steam 3. Ngày 9 tháng 5 năm 2025**Không phải lỗi, tình trạng cố định; phiếu yêu cầu đã được đóng**Bộ phận Hỗ trợ Steam, phiếu yêu cầu hỗ trợ đầu tiên 4. 23 tháng 5 năm 2025**Lần đăng nhập gần nhất**Phụ lục 1, trang 1 5. 17 tháng 6 năm 2025**Yêu cầu truy cập**Tiến sĩ Zurheide, trang 1 6. 29 tháng 7 năm 2025**Thời hạn bắt đầu, “nếu có”**Tiến sĩ Schelinski, trang 1 7. 30 tháng 7 năm 2025**“Khoản thanh toán gần nhất do bên thứ ba thực hiện”; từ đây trở đi, dữ liệu chỉ được ghi nhận cho người yêu cầu**Tiến sĩ Zurheide, trang 2 8. Tháng 8 năm 2025**47 đơn khiếu nại, tất cả đều có thể đọc được**Phụ lục 1, tr. 444–448 9. 15 tháng 8 năm 2025**Kết luận: 1.938 đơn khiếu nại, “bất kể nội dung cụ thể ra sao”**Tiến sĩ Schelinski, trang 2 10. Tháng 9 năm 2025**3 khiếu nại, nội dung dễ đọc**Phụ lục 1, tr. 444 11. 29 tháng 9 năm 2025**“Ngày lập báo cáo”**Phụ lục 1, trang 1 12. Ngày 1 tháng 10 năm 2025**Câu trả lời: “cả tháng”, dữ liệu được làm sạch “bằng tay”**Tiến sĩ Zurheide, trang 1 Tiến sĩ Zurheide viết rằng phải sử dụng toàn bộ khoảng thời gian một tháng và phải làm sạch dữ liệu bằng tay: „musste leider die volle Monatsfrist ausgeschöpft werden … manuell die Daten bereinigt werden mussten“ (tr. 1). Ba trong số các đơn khiếu nại có thể đọc được có ngày tháng là tháng 9 năm 2025, còn bản báo cáo này có ngày 29 tháng 9. Các đơn này được nộp trong những tuần cuối cùng trước khi có văn bản trả lời, trong khi theo lời kể của ông, lúc đó dữ liệu đang được xử lý. > “This account just started acting shady overnight” > > Suspected Hijacker · Tháng 8 năm 2025 · tr. 446 > “Suddenly messaging people weird links probably stolen” > > Suspected Hijacker · Tháng 8 năm 2025 · tr. 448 > “Friend warned me to report this one” > > Suspected Hijacker · Tháng 8 năm 2025 · tr. 446 > “Everyone in voice chat agrees it's a stolen account” > > Suspected Hijacker · Tháng 8 năm 2025 · tr. 446 #### Chính tập tin đó lại mâu thuẫn với những điều đó Một số trong số năm mươi người này đưa ra những tuyên bố mà Anlage 1 có thể tự kiểm tra. Tệp này ghi lại các lần đăng nhập vào tài khoản và lịch sử bảo mật của tài khoản đó. Cả hai thông tin này đều có trong đó; lịch sử bảo mật nằm dưới một hình chữ nhật màu đen. Còn có thể đọc được · Suspected Hijacker · Tháng 8 năm 2025 · tr. 446 > “My friend can't log in, says someone changed the password” Lịch sử an ninh · trang 830 · dưới một hình chữ nhật màu đen**Lần thay đổi mật khẩu gần nhất: Tháng 7 năm 2024** Không phải do chủ sở hữu thực hiện, như chính tệp tin này cho thấy. Không có thay đổi mật khẩu nào vào năm 2025. Có thể đọc được · Tháng 8 năm 2025 · tr. 446, 448 > “This account just started acting shady overnight” > “Suddenly messaging people weird links probably stolen” Lịch sử đăng nhập · tr. 1–119**Lần đăng nhập gần nhất: 23 tháng 5 năm 2025** Lịch sử đăng nhập kết thúc vào tháng 5 năm 2025. Không có bất kỳ lần đăng nhập nào được ghi nhận trong các tháng 6, 7, 8 hoặc 9. Tài khoản này đã bị khóa kể từ ngày 7 tháng 5 năm 2025; vào ngày 9 tháng 5, bộ phận Hỗ trợ Steam đã xác nhận rằng việc khóa tài khoản này là vĩnh viễn. Có thể đọc được · Tháng 8 năm 2025 · tr. 445, 448 > “Real person probably got locked out” > “My friend said they can't get into this account anymore” Lịch sử an ninh · tr. 830**Không có thay đổi nào về an ninh vào năm 2025** Thay đổi gần đây nhất được ghi lại trong lịch sử bảo mật là việc đặt lại mật khẩu vào tháng 7 năm 2024. **Bản đọc của PhishDestroy.** Cụm từ xúc phạm ở trang 444 cần được dịch. Những lời phàn nàn này được viết bằng tiếng Anh, và câu trả lời cho chúng cũng nằm trong cùng một tệp tin. Sau một tháng rà soát thủ công, nội dung đã trở nên dễ đọc hơn và dòng văn bản mâu thuẫn với những lời phàn nàn đó đã được đánh dấu bằng một hình chữ nhật. #### Cách đọc con số năm mươi Cách trình bày không chứng minh được ai là người đã viết đơn khiếu nại. Đó chính là điều mà tòa án sẽ xem xét trước khi chấp nhận đơn khiếu nại đó. | Kiểm tra | Còn lại có thể đọc được · 50 | Đã được che phủ · 1.944 | | --- | --- | --- | | Kỳ | Tháng 8–tháng 9 năm 2025 | Tháng 2 năm 2021 – Tháng 7 năm 2025 | | “Suspected Hijacker” danh mục | **86%**43 trên 50 | **13,**8% và 269 trong tổng số 1.944 | | Mô tả có chứa ký tự Cyrillic | **4%**2 trên 50 | **55,4%** (1.077 trên 1.944) | | Đăng nhập dành cho phóng viên: Chữ cái Latinh + 3–5 chữ số | **62%**31 trên 50 | **21,**6% (420 trên 1.944) | Chữ Cyrillic: ít nhất một ký tự thuộc bảng chữ cái đó. Cấu trúc tên đăng nhập: các chữ cái La-tinh tiếp theo là 3–5 chữ số, không có gì khác. Tất cả 1.995 tên đăng nhập của phóng viên, bao gồm cả những tên nằm bên cạnh 50 văn bản hiển thị, đều được ghi lại và vẫn có thể trích xuất được. Không có tên đăng nhập nào của phóng viên được trích dẫn tại đây. Bốn văn bản có thể đọc được lặp lại y nguyên từng từ trong chín bản ghi; “Acting way off pretty sure someone else is using it” xuất hiện ba lần (trang 446, 447). Tiến sĩ Schelinski · 15 tháng 8 năm 2025 · tr. 2 > „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ “Dù nội dung cụ thể của các khiếu nại là gì đi chăng nữa, thì chỉ riêng con số đó cũng cho thấy…” **Nội dung đó có thực sự không liên quan đến tòa án không?** Tiến sĩ Zurheide · 1 tháng 10 năm 2025 · tr. 9 > „Aus unserer Erfahrung wird jedes Gericht die Sperrung … als rechtmäßig qualifizieren.“ “Theo kinh nghiệm của chúng tôi, mọi tòa án đều sẽ công nhận việc phong tỏa đó… là hợp pháp.” **Liệu kinh nghiệm của ông ấy có bao gồm tất cả các tòa án không? Và liệu tất cả các tòa án có đồng ý với cách xử lý dữ liệu như thế này không?** Hai câu hỏi này là của PhishDestroy. Chúng tôi không đưa ra ý kiến về việc tòa án nên ra phán quyết như thế nào về việc phong tỏa này. Chúng tôi chỉ cho rằng tòa án cần có khả năng đọc được những gì mà tòa được yêu cầu kiểm đếm. ### Những hình chữ nhật màu đen che khuất những gì Hai lá thư này đề cập đến cùng một số khiếu nại nhưng theo hai cách khác nhau. Bác sĩ Schelinski đã xem xét tất cả các khiếu nại đó như những điểm bất lợi đối với người yêu cầu, „1.938 Mal“, bất kể chi tiết cụ thể ra sao (ngày 15 tháng 8 năm 2025, trang 2). Tiến sĩ Zurheide sau đó đã đặt mốc thời gian là ngày 30 tháng 7 năm 2025: chỉ kể từ ngày đó „können wir … davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen“ (1 tháng 10 năm 2025, tr. 2). Các hình chữ nhật màu đen đi theo đường đó: mọi nội dung khiếu nại cho đến ngày 23 tháng 7 năm 2025, tức là nội dung khiếu nại cuối cùng trước đó, đều bị che khuất; còn mọi nội dung từ tháng 8 trở đi đều có thể đọc được. **Bài viết của PhishDestroy.** Trước ngày 30 tháng 7 năm 2025, số lượng khiếu nại được tính là một con số đối với người yêu cầu và được giữ lại khỏi người đó với tư cách là dữ liệu không thuộc về người đó. Bản thân bức thư tháng 10 đã lập luận rằng „zwischen 2019 und 2023“ (tr. 7). Phụ lục 1 · trang 444 · dòng đầu tiên có thể đọc được Offensive AvatarTháng 9 năm 2025`p***r` Một từ lăng mạ mang tính kỳ thị người đồng tính, đã được che đi ở đây. Đây là mục đầu tiên mà người yêu cầu có thể đọc được, sau một tháng rà soát thủ công. #### Có gì ẩn dưới những hình chữ nhật đó? 1.148 đơn khiếu nại, chiếm hơn một nửa số đơn trong bảng, được nộp dưới dạng “Offensive Profile”. Không còn một dòng nào có thể đọc được: 1.147 dòng bị che khuất nội dung và một dòng không có nội dung. Khi đọc từ phía dưới các hình chữ nhật đó, mà không cần đăng nhập, những mô tả bị che khuất vẫn liên tục xoay quanh những chủ đề giống nhau: | Chủ đề | Được bảo hiểm | Dễ đọc | | --- | --- | --- | | Phát xít, chủ nghĩa Phát xít | **110** | 0 | | Sự thù hận, lời nói kích động thù hận | **108** | 0 | | Chủ nghĩa phân biệt chủng tộc | **99** | 0 | | Ukraine, người Ukraine | **90** | 0 | | Chủ nghĩa bài Nga | **84** | 0 | | Xúc phạm đất nước hoặc người Nga | **65** | 0 | | Tuyên truyền | **64** | 0 | | Một từ mang tính xúc phạm về chủng tộc dành cho người Ukraine | **50** | 0 | | Chính trị | **46** | 0 | Trong số 1.944 mô tả được xem xét, có 615 mô tả đề cập đến ít nhất một trong những chủ đề này; trong khi đó, không có mô tả nào trong số 50 mô tả có thể đọc được đề cập đến những chủ đề này. Các văn bản dài cũng lặp lại: 18 văn bản có từ 8 từ trở lên xuất hiện nguyên văn trong 48 hàng. Trong đó, có hai văn bản lặp lại bốn lần mỗi văn bản: > “I made this account to report this user because he has stolen my account” > > Có mái che · 4 hàng > “I created this account in order to expose this user because he robbed my account.” > > Có mái che · 4 hàng Một trong số 50 văn bản có thể đọc được (trang 448) là một trang hồ sơ Steam được dán vào, trong đó có đề cập đến tên của những người dùng khác. Trang này không được trích dẫn lại ở đây. Các hình chữ nhật đã che đi thông tin đăng nhập của từng phóng viên nhưng vẫn giữ nguyên khả năng đọc được nội dung trang đó. ### Các tuyên bố và các tài liệu được cung cấp Mỗi tuyên bố dưới đây được trích dẫn từ các lá thư đã ký tên. Mỗi tài liệu đều có trong hồ sơ mà họ đã nộp. Tiến sĩ Schelinski · trang 2 ### “Hàng trăm” mỗi năm „In jedem Jahr, bis ins Jahr 2025 hinein, gab es demnach hunderte Beschwerden.“ **2021: 25 · 2022: 122** Số liệu thống kê hàng năm được trình bày trong bảng khiếu nại được cung cấp. Số liệu thống kê hàng tháng đầy đủ có trong phần[Tự kiểm tra](https://phishdestroy.io/tgwitness/vi/docs/signed-export/#verify). Tiến sĩ Zurheide · trang 1 ### Suốt cả tháng, được làm sạch bằng tay „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ **36 giây** Anlage 1 được tạo vào lúc 19:58:05 và được sửa đổi lần cuối vào lúc 19:58:41, bao gồm 830 trang. Lời phàn nàn đầu tiên có thể đọc được trong đó là một lời lăng mạ mang tính kỳ thị người đồng tính. Tiến sĩ Schelinski · tr. 3 ### Bảo vệ quyền lợi của bên thứ ba „soweit keine Rechte Dritter entgegenstehen“ **Còn lại 905.672 ký tự** Vẫn có thể trích xuất được nội dung văn bản bên dưới 1.044 hình chữ nhật màu đen chồng lên nó. Các hình chữ nhật này cũng che lấp lịch sử bảo mật của chính tài khoản đó (trang 830). Tiến sĩ Zurheide · tr. 7 ### “Trong giai đoạn từ năm 2019 đến năm 2023” „Über einen Zeitraum von mehreren Jahren, zwischen 2019 und 2023 …“ **Được thành lập vào tháng 8 năm 2020** Phụ lục 1, trang 1, nêu rõ thời điểm tạo tài khoản: tháng 8 năm 2020. Tiến sĩ Zurheide · tr. 9 ### Mọi tòa án đều sẽ đồng ý „jedes Gericht … als rechtmäßig qualifizieren“ **Dự báo** Câu này cho rằng mọi tòa án đều sẽ kết luận việc khóa tài khoản Steam là hợp pháp. Câu này không nêu tên tòa án nào và cũng không trích dẫn phán quyết nào. ### Những điều chữ ký có thể và không thể cho bạn biết Chữ ký điện tử đủ điều kiện là bằng chứng có giá trị cao về người gửi. Nó không phải là bằng chứng về nội dung. Hai vấn đề này cần được xem xét riêng biệt. ### Một chữ ký có thể thể hiện - ai đã ký vào văn bản đó - rằng các byte đã ký không thay đổi kể từ khi ký ### Chữ ký không thể hiển thị - rằng quá trình xuất đã hoàn tất - rằng việc bôi đen đã loại bỏ bất kỳ nội dung nào - rằng các tuyên bố trong đó là đúng - rằng ai cũng nên đọc kỹ trước khi ký BA LẦN KIỂM TRA · SỐ TÀI LIỆU 42603633 · PHỤ LỤC 1Ngoại tuyến 01 · NGƯỜI GỬI**Chữ ký điện tử hợp lệ**`„qualifiziert elektronisch signiert“`Được công ty công bố tại trang 9. 02 · TÍNH CHÍNH TRỰC**Giá trị SHA-256 của Phụ lục 1**`2bb927e2…4ff7d6af`Khớp với giá trị băm đã ghi lại. 03 · NỘI DUNG**Lớp văn bản của Phụ lục 1**`pdftotext Anlage1.pdf -`905.672 ký tự có thể đọc được trong 1.044 hình chữ nhật. Người gửi: đã được xác nhận. Tính toàn vẹn: khớp. Nội dung: bị hỏng. Chữ ký đã trả lời câu hỏi đầu tiên nhưng không trả lời bất kỳ câu hỏi nào khác. Các bước kiểm tra 02 và 03 chỉ cần tệp tin và các công cụ tiêu chuẩn. Bước kiểm tra 01 cho biết ai là người gửi. Chỉ có bước 02 và 03 mới cho biết nội dung đã được gửi là gì. Số tài liệu 42603633 · trang 1Một trang, hai cách viết `Dr. Patrick Zurheide, LL.M. (Aberdeen)`Bên ký kết `p.zurheode@*****wessing.com`Giấy tiêu đề `p.zurheide@*****wessing.com`Hồ sơ công khai Tiêu đề được viết đúng chính tả. Tuy nhiên, tên của người ký trên tiêu đề thư lại không đúng. Trang 6 có nội dung „Die Antwortet lautet ja, in den dort genannten Grenzen.“ hai lần, nguyên văn, ở phần cuối của các mục 1.5 và 1.6. Trang 3 gửi dữ liệu bằng „Anbei übersenden wie Ihnen …“. ### Yêu cầu mà bản xuất này nhằm đáp ứng Đằng sau những chữ ký đó là một yêu cầu truy cập dữ liệu cá nhân. Luật quy định về vấn đề này khá ngắn gọn. NGHỊ ĐỊNH (EU) 2016/679 · VĂN BẢN CHÍNH THỨC Điều 15, khoản 1 “Chủ thể dữ liệu có quyền yêu cầu người kiểm soát dữ liệu xác nhận liệu dữ liệu cá nhân liên quan đến mình có đang được xử lý hay không, và nếu có, thì có quyền truy cập vào dữ liệu cá nhân đó…” Điều 15, khoản 3 “Bên kiểm soát phải cung cấp một bản sao của dữ liệu cá nhân đang được xử lý.” Điều 12, khoản 3 “… mà không được chậm trễ một cách không hợp lý và trong mọi trường hợp phải trong vòng một tháng kể từ ngày nhận được yêu cầu. Thời hạn đó có thể được gia hạn thêm hai tháng nếu cần thiết …” Nguồn: [EUR-Lex](https://eur-lex.europa.eu/eli/reg/2016/679/oj) Các bức thư đều biết đến quy luật này. Bức thư của Tiến sĩ Zurheide mở đầu bằng quy luật này: „nachfolgend erteilen wir Namens und in Vollmacht unserer Mandantin Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ (tr. 1). Ngoại trừ một lần đề cập đến quyền của bên thứ ba (Tiến sĩ Schelinski, tr. 3), cả hai lá thư đều không trích dẫn bất kỳ quy định nào cho phép chủ thể kiểm soát dữ liệu hạn chế quyền truy cập: không phải Điều 12(5), không phải Điều 23, cũng không phải Luật Bảo vệ Dữ liệu Liên bang Đức (BDSG). Thay vào đó, yêu cầu này đã nhận được: 1. 15 tháng 8 năm 2025 · Tiến sĩ Schelinski · tr. 1**Hạn chót, “nếu có”** „Die Frist nach Art. 15 DSGVO hat, wenn überhaupt, erst … am 29. Juli 2025 begonnen“ 2. 15 tháng 8 năm 2025 · Tiến sĩ Schelinski · tr. 2**Tài khoản đã bị khóa** „Hiermit kündigen wir daher Namens und in Vollmacht der Valve Corporation … mit sofortiger Wirkung.“ 3. 15 tháng 8 năm 2025 · Tiến sĩ Schelinski · tr. 2**Chứng minh bằng cách đếm: 1.938 đơn khiếu nại, bất kể nội dung cụ thể của chúng là gì** „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ 4. Ngày 1 tháng 10 năm 2025 · Tiến sĩ Zurheide · tr. 2**Dữ liệu được thu hẹp đến ngày 30 tháng 7 năm 2025** „… können wir erst ab diesem Zeitpunkt davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen.“ 5. Ngày 1 tháng 10 năm 2025 · Tiến sĩ Zurheide · tr. 8**Phần còn lại, với điều kiện là** „Gerne beauskunften wir die restlichen (bzw. noch weitere) personenbezogene Daten, sobald Ihr Mandant uns nachvollziehbar darstellen kann …“ 6. Ngày 1 tháng 10 năm 2025 · Tiến sĩ Zurheide · tr. 8**“Đồng phạm”** „… dass Ihr Mandant bzw. dessen Komplizen seine Phishing-Angriffe … in verschleierter Form fortsetzen will“ 7. Ngày 1 tháng 10 năm 2025 · Tiến sĩ Zurheide · tr. 9**Bốn điều luật hình sự** „… §§ 263, 263a, 202a, 303a StGB) einer strafrechtlichen Verfolgung zuzuführen.“ **Không có điều nào trong số này được quy định tại Điều 15.** Quyền tiếp cận không bị hủy bỏ bởi việc chấm dứt hợp đồng, dự báo về phán quyết của tòa án hay quy định của luật hình sự. 106 ngày sau khi nộp đơn, nội dung đó vẫn giữ nguyên như đã được ghi. **Cách hiểu của PhishDestroy.** Các bác sĩ trích dẫn luật ở trang 1, nhưng sau đó lại viết như thể không có luật đó vậy. ### Bức thư liệt kê những thông tin mà Valve xử lý. Tài liệu này lại bỏ qua phần lớn những thông tin đó. Từ trang 2 đến trang 6, lá thư tháng 10 trích dẫn Chính sách Bảo mật của Steam để mô tả các loại dữ liệu cá nhân mà Valve xử lý. Mỗi danh mục được nêu trong đó sẽ được so sánh với Phụ lục 1 dưới đây. Phụ lục 1 bao gồm mười hai mục: tài khoản, hồ sơ, lịch sử tên, thông tin đăng nhập, mã sản phẩm, thời gian chơi, số điện thoại, khiếu nại, trò chuyện, thiết bị Steam Guard, danh sách bạn bè và các thay đổi về bảo mật. | Dữ liệu | Được nêu tên trong thư | Trong Phụ lục 1 | | --- | --- | --- | | Giao dịch và thanh toán | „Transaktions- und Zahlungsdaten“ · p. 2 „… Transaktionsdaten … für einen Zeitraum von bis zu zehn (10) Jahren aufbewahren muss“ · p. 6 | **Vắng mặt** | | Các ngành nghề và Chợ cộng đồng | „… Konsistenz des Gameplays oder Steam-Community-Marktes …“ · p. 6 | **Vắng mặt** | | Thành tích, tiến trình chơi game, vật phẩm trong game | „Ihre erspielten Errungenschaften … Ihren Spielfortschritt … Ihre im Spiel erhaltenen Gegenstände“ · p. 4 | **Vắng mặt** | | Quyền sở hữu trò chơi | „… mindestens Ihr Eigentum am fraglichen Spiel“ · p. 4 | **Vắng mặt** · thời gian chơi và 100 lần kích hoạt phím chỉ trong một ngày duy nhất | | Cấp độ, huy hiệu, thẻ sưu tập | „Daten über die Nutzung des Steam-Clients und der Steam-Websites“ · p. 3 · items and market · pp. 4, 6 | **Vắng mặt** | | Bài đăng, bình luận, người theo dõi | „… veröffentlichen, kommentieren oder denen Benutzer folgen“ · p. 3 „Message Boards, Foren und/oder Chatbereiche“ · p. 5 | **Vắng mặt** | | Trò chuyện | „Informationen, die Benutzer im Chat gesendet haben“ · p. 3 | 2 mục, đã được đề cập | | Yêu cầu hỗ trợ | „… wenn Benutzer Informationen oder Support von Valve anfordern“ · p. 3 | **Vắng mặt** · bao gồm cả vé tháng 5 năm 2025 đã xác nhận việc chặn | | Các tài khoản của bên thứ ba đã được liên kết | „… mit dem Konto eines Drittanbieters zu verknüpfen“ · p. 5 | **Vắng mặt** | | Các bản ghi phía sau khối | „Zum Entdecken von Verstößen erforderliche Informationen“ · p. 3 „… nach einer manuellen Prüfung durch einen Mitarbeiter der Valve Corporation“ · p. 7 | **Vắng mặt** · không có hồ sơ đánh giá, không có liên kết thiết bị, không có báo cáo lừa đảo | **Bức thư mô tả các dữ liệu. Tệp đính kèm lại không chứa những dữ liệu đó.** Các khoản thanh toán là cơ sở cho kết luận của cả hai luật sư về quyền sở hữu, song loại hình thanh toán lại là thông tin bị bỏ sót trong hồ sơ. #### Tập tin này chứa những nội dung gì và trong khoảng thời gian nào Các khoảng thời gian được lấy từ các ngày trong tệp, bao gồm cả các ngày nằm dưới các hình chữ nhật màu đen. | Mục | Trong Phụ lục 1 | Khoảng thời gian trong tệp | | --- | --- | --- | | Thông tin tài khoản cơ bản · email, quốc gia, tên người dùng, ID Steam | Dễ đọc | Tình trạng hiện tại | | Tài khoản đăng nhập | Ngày và loại có thể đọc được; thời gian, địa chỉ IP, ID phần cứng bị che khuất | Tháng 10 năm 2023 – Tháng 5 năm 2025 · Tài khoản này được tạo từ tháng 8 năm 2020 | | Giờ chơi | Có thể đọc được thông tin trên bao bì; ngày và giờ sử dụng lần cuối được che khuất | Tháng 12 năm 2020 – Tháng 5 năm 2025 | | Trò chuyện | 2 mục, đã được đề cập | Chỉ tháng 9 năm 2025 | | Các khiếu nại liên quan đến tài khoản | 1.995 hàng · 50 mô tả có thể đọc được | Tháng 2 năm 2021 – Tháng 9 năm 2025 | | Bạn bè và các khối | 5.789 hàng · đã được xử lý | Tháng 2 năm 2021 – Tháng 9 năm 2025 | | Thiết bị Steam Guard · số điện thoại đã đăng ký · các thay đổi về bảo mật | Được bảo hiểm | Nhật ký bảo mật: Tháng 8 năm 2020 – Tháng 7 năm 2024 · 4 hàng | | Kích hoạt khóa sản phẩm | Các phím đã được đề cập | 100 hàng, một ngày: 13 tháng 3 năm 2025 | **Có vẻ như chỉ có các khiếu nại là được ghi chép đầy đủ.** Hầu như không có thông tin nào khác: các lần đăng nhập bắt đầu từ tháng 10 năm 2023, danh sách bạn bè từ tháng 2 năm 2021, các khóa sản phẩm chỉ tập trung vào một ngày duy nhất, và toàn bộ các danh mục mà các cửa hàng của Valve quản lý đều vắng mặt. Các danh mục mà chính các quyết định trong thư này dựa vào – bao gồm các giao dịch thanh toán và hồ sơ liên quan đến việc chặn tài khoản – hoàn toàn không có trong tệp tin. Danh sách bạn bè có 5.789 mục: 4.410 mục “Người dùng bị chặn”, 1.182 mục “Bạn bè” và 200 mục “Người mời”, có ngày từ 24 tháng 2 năm 2021 đến 28 tháng 9 năm 2025; trong đó có 74 mục có ngày sau lần đăng nhập gần nhất. Không thể xác định được từ tệp này liệu đây là danh sách kết nối hiện tại hay là lịch sử đầy đủ bao gồm cả những kết nối đã bị xóa. Câu trả lời cho Điều 15(1) đặt ra thêm ba câu hỏi. Các bên nhận dữ liệu (điểm c) và nguồn dữ liệu (điểm g) chỉ được nêu dưới dạng văn bản chính sách chung, không dành riêng cho tài khoản này. Thời hạn lưu trữ (điểm d) là trích dẫn từ chính sách, không có thông tin cụ thể. Và thư này gửi dữ liệu „als Anlage 1 und 2“ (tr. 3); ở đây chỉ xem xét Phụ lục 1. ### Valve đã xác minh chủ sở hữu của tài khoản này Tài khoản này đã được đăng ký với tư cách là đối tác Steamworks nhằm phát hành một trò chơi. Quy trình này bao gồm khoản phí Steam Direct trị giá 100 USD, cuộc phỏng vấn về thuế, thông tin tài khoản ngân hàng để nhận thanh toán và việc xác minh danh tính do chính Valve thực hiện. Tất cả những thông tin này đều là dữ liệu cá nhân mà Valve xử lý. Điều 15 của GDPR áp dụng cho mọi loại dữ liệu cá nhân được xử lý, không chỉ những loại được liệt kê trong chính sách bảo mật. Không có thông tin nào trong số đó xuất hiện trong Phụ lục 1. Tiến sĩ Schelinski · tr. 1 ### “Không có bất kỳ bằng chứng nào về quyền sở hữu” „… kein einziger Beleg für die Inhaberschaft (Verfügungsbefugnis) Ihres Mandanten für den Account …“ **Đã được Valve xác minh danh tính** Việc xác minh đối tác, các tài liệu liên quan và khoản thanh toán 100 USD đang do khách hàng được đề cập trong thư này giữ. Tiến sĩ Schelinski · tr. 3 ### Yêu cầu người nộp đơn cung cấp bằng chứng „… gefälschten ‚Utility Bill‘ …“ · „… tatsächlich alleiniger Inhaber des Accounts …“ **Bằng chứng không được cung cấp cho người yêu cầu** Người yêu cầu được yêu cầu chứng minh quyền sở hữu, trong khi các hồ sơ về quyền sở hữu mà chính Valve đã xác minh lại không được đưa vào bản sao mà người này được cấp. ## Mô hình: không ai tự mình quyết định, không có gì có thể được hoán đổi Vấn đề ở đây không phải là về một phần mềm cụ thể. Vấn đề là ai là người ra quyết định. Trong trường hợp này, hai luật sư đã quyết định 50 đơn khiếu nại nào là quan trọng và phần còn lại thì không. Không có tòa án, cũng không có cơ quan quản lý. Một số thông tin phải được giữ bí mật: thông tin đăng nhập của các phóng viên là dữ liệu của người khác. Câu hỏi đặt ra là ai là người quyết định, và liệu có ai có thể kiểm tra quyết định đó sau này hay không. Một hình chữ nhật màu đen không trả lời được cả hai câu hỏi này, và bất kỳ ai cũng có thể xóa nó đi. Hai công cụ tiêu chuẩn có thể giải quyết cả hai vấn đề: một hàm băm có giá trị muối (salted hash) trong bản sao của người yêu cầu, và bản gốc được niêm phong bằng khóa công khai của cơ quan giám sát hoặc tòa án. CAM KẾT ĐÁNH DẤU · MỘT LẦN CHO MỖI LẦN BỊ GIỮ LẠI c = SHA-256(salt ‖ value) Mã muối là 16 byte ngẫu nhiên, được tạo mới cho mỗi trường. Bản sao của bên yêu cầu chứa `c` thay thế cho giá trị, dưới chữ ký của công ty. Giá trị và mã xác thực của nó được truyền đi trong một phong bì được mã hóa bằng khóa công khai của cơ quan có thẩm quyền, sử dụng OpenPGP hoặc X25519 kết hợp với AES-GCM. Nếu không có khóa riêng của cơ quan có thẩm quyền, không ai có thể mở phong bì đó, và công ty không thể thay đổi giá trị mà không vi phạm cam kết mà họ đã ký. 1. Bước 1 · Người yêu cầu**Đưa bản sao và phong bì cho** Bản sao đã ký kèm theo các cam kết và phong bì đã niêm phong sẽ được gửi đến cơ quan giám sát hoặc tòa án. 2. Bước 2 · Cơ quan có thẩm quyền**Mở phong bì và tính lại** Người thanh tra giải mã bằng khóa riêng của cơ quan có thẩm quyền và tính lại giá trị SHA-256(salt ‖ giá trị) cho từng trường dữ liệu. Mỗi kết quả phải trùng khớp với cam kết mà doanh nghiệp đã ký. 3. Bước 3 · một cơ quan độc lập**Xác định điều gì thực sự được bảo vệ** Chính cơ quan chức năng, chứ không phải công ty, sẽ xem xét toàn bộ các thông tin đã bị giữ lại — trong trường hợp này là 1.944 nội dung khiếu nại và lịch sử bảo mật — và quyết định liệu việc giữ lại những thông tin đó có phải là để bảo vệ quyền lợi của bên thứ ba hay không. PHỤ LỤC 1 · TRANG 514 · MỘT HÀNG, HAI CÁCH ĐỂ ẨN NÓTrực tiếp · ngay trên trình duyệt của bạn Như khi giao hàng · hình chữ nhật màu đenChỉ hiển thị lớp phủ hình ảnh Aspose.PDF for .NET 20.8 · page 514Lớp văn bản + hình chữ nhật Phóng viên: [đăng nhập · không được đăng lại tại đây] Ngày: 2024-03-28 Loại: Offensive Profile Nội dung: русофоб Các hình chữ nhật màu đen được vẽ lên trên. Văn bản bên dưới vẫn được giữ nguyên trong tệp. Bản sao của người yêu cầu · các cam kết có điều kiệnĐược ký bởi công ty c = SHA-256(salt ‖ value)Được niêm phong theo yêu cầu của cơ quan có thẩm quyền Phóng viên: [không tiết lộ · cam kết] Ngày: 2024-03-28 Loại: Offensive Profile Nội dung: [withheld · commitment] Lớp bảo mật · RSA-OAEP-256 + AES-256-GCMđối với khóa công khai của cơ quan này Bản sao chứa các cam kết. Các giá trị và mã muối nằm trong phong bì. 1. **1.** Người yêu cầu trao bản sao và phong bì 2. **2** Cơ quan có thẩm quyền mở hồ sơ đó ra và tính toán lại từng khoản cam kết 3. **3** Cơ quan có thẩm quyền quyết định những gì sẽ bị giữ lại Cả hai bảng điều khiển đều ẩn cùng hai trường này. Hãy đọc các byte thô, sau đó thực hiện kiểm tra của cơ quan có thẩm quyền. Bên trái: một hàng trong Anlage 1 như khi được cung cấp; nội dung khiếu nại nằm dưới một hình chữ nhật màu đen ở trang 514 và được trích dẫn mà không có thông tin đăng nhập của người báo cáo, trường thông tin này chứa một ký hiệu giữ chỗ. Bên phải: cùng một hàng với các cam kết được mã hóa bằng muối, các giá trị của nó được niêm phong bằng khóa của cơ quan có thẩm quyền. Cặp khóa được tạo ra trong trình duyệt của bạn cho mục đích minh họa này, và “phong bì” chính là phương thức mà TgWitness sử dụng để chuyển giao niêm phong. Quyết định ở bước 3 là một ví dụ. **Không ai tự mình quyết định cả**Công ty vẫn đưa ra đề xuất về những thông tin cần được giữ kín. Một người nắm rõ toàn bộ tình hình và không có lợi ích liên quan đến tranh chấp sẽ kiểm tra lại đề xuất đó. **Không có gì bị rò rỉ**Người yêu cầu không thể xem dữ liệu của bất kỳ ai khác. Giá trị muối khiến cam kết trở nên vô dụng đối với việc đoán: nếu không có nó, chỉ cần băm một danh sách từ là có thể tìm ra một từ duy nhất để khiếu nại. **Không có gì có thể được hoán đổi**Mỗi giá trị đều phải phù hợp với cam kết mà công ty đã ký kết. Nếu nội dung khác biệt hoặc thiếu nội dung, kết quả kiểm tra sẽ không đạt yêu cầu. **Chữ ký mang một ý nghĩa nào đó**Một chữ ký hợp lệ trên các cam kết sẽ ràng buộc công ty đối với mọi giá trị tiềm ẩn, chứ không chỉ đối với thư giới thiệu. **Chức danh không quan trọng**Việc kiểm tra này là về mặt toán học. Nó cần bản sao, phong bì và chìa khóa của cơ quan có thẩm quyền, chứ không phải lời nói của bất kỳ ai. Tất cả những điều này đều không cần cơ sở hạ tầng mới. Các cơ quan giám sát của Đức đã công bố các khóa OpenPGP: Ủy viên Liên bang về Bảo vệ Dữ liệu [liệt kê một khóa cho mỗi đơn vị](https://www.bfdi.bund.de/DE/Service/Kontakt/Schluessel/Schluessel-node.html), còn LfDI Baden-Württemberg [cung cấp khóa công khai của mình để gửi email được mã hóa](https://www.baden-wuerttemberg.datenschutz.de/kontaktdaten-des-verantwortlichen/). Các tòa án Đức hiện đã tiếp nhận các hồ sơ thông qua hệ thống EGVP, với [cơ chế mã hóa đầu cuối dựa trên giao thức OSCI](https://egvp.justiz.de/behoerdenpostfach/Informationsmaterial_fuer_Behoerden_zu_BeBPo_und_eEB_V1_3_2.pdf). **Quan điểm của PhishDestroy.** Ai đã trao cho các luật sư quyền quyết định điều gì là quan trọng và điều gì không? Các luật sư không nên đưa ra quyết định đó. Mọi thứ đều phải được bàn giao: không phải dưới dạng những hình chữ nhật màu đen mà bất kỳ ai cũng có thể xóa bỏ, mà phải được niêm phong và chỉ tòa án hoặc cơ quan quản lý mới có chìa khóa mở, để không còn chỗ cho những “sai sót”, những “hiểu lầm” hay việc chỉ công bố những thông tin thuận tiện. ## Mô hình minh bạch: dữ liệu đầy đủ, quy tắc được công bố rõ ràng, khóa có quyền hạn Người yêu cầu sẽ nhận được ngay lập tức tất cả những gì không có tranh chấp. Bất kỳ thông tin nào bị giữ lại đều không được thể hiện qua bản vẽ và cũng không bị giấu đi một cách im lặng. Thông tin đó sẽ được gửi đi, đầy đủ và đã ký tên, được mã hóa bằng khóa của cơ quan có thẩm quyền quyết định về vấn đề đó. | Câu hỏi | Chuyện gì đã xảy ra | Mô hình trung thực | | --- | --- | --- | | Ai là người quyết định những gì sẽ được giữ lại? | Luật sư đại diện cho bên trong vụ tranh chấp | Một quy định được ban hành và ký duyệt khi bản sao được lập; cơ quan có thẩm quyền sẽ xem xét quy định đó | | Những gì người yêu cầu nhận được | Các hàng đã được chọn; toàn bộ danh mục không có; một điểm cắt mà không có bản ghi nào phía sau | Mọi hồ sơ không có tranh chấp phải được xử lý ngay lập tức | | Dữ liệu của các bên thứ ba | Vẫn còn trong hồ sơ và được phủ đầy các bản vẽ | Đã xóa khỏi bản sao của người yêu cầu; vẫn giữ nguyên trong bản gốc để làm căn cứ | | Các bộ phận chưa được công bố | Không rõ số lượng, không rõ nội dung | Đã được kiểm đếm trong bản kê khai có chữ ký; bản gốc đầy đủ đã được mã hóa bằng khóa của cơ quan có thẩm quyền | | Bằng chứng về cách bản sao được lựa chọn | Chỉ tồn tại vì việc bôi đen đã thất bại | Được tích hợp sẵn: quy tắc, số lượng, hàm băm của bản gốc | | Các lĩnh vực còn tranh cãi | Được quyết định dựa trên nội dung bức thư: “mọi tòa án đều sẽ đồng ý” | Do cơ quan quản lý hoặc tòa án quyết định, ai có quyền mở các tài khoản đó | | Thời gian | 106 ngày | Xuất khẩu và giao hàng | | Vai trò của luật sư | Xác định phạm vi, nghĩa vụ chứng minh và phán quyết | Tham gia tranh tụng tại tòa án; không chỉnh sửa dữ liệu của người yêu cầu | Cơ quan chức năng cũng không cần sự tin tưởng. Khoản 1, Điều 58, Chữ e của GDPR đã trao quyền cho cơ quan giám sát được tiếp cận tất cả dữ liệu cá nhân mà chủ thể xử lý dữ liệu đang xử lý. Mô hình này chỉ chuyển giao dữ liệu dưới dạng có thể được xác minh ngay khi nhận được. **Các lý do được nêu trong các lá thư – như nghi vấn về quyền sở hữu, các khoản thanh toán từ bên thứ ba, khiếu nại, nghi ngờ lừa đảo qua email – giải thích tại sao Điều 15 không được tuân thủ. Những lý do này không đáp ứng yêu cầu của điều khoản.** Dù căn cứ là gì đi chăng nữa, kết quả vẫn như nhau: người yêu cầu không nhận được dữ liệu của mình, dữ liệu của người khác lại được cung cấp dưới dạng bản vẽ, và việc lựa chọn chỉ có thể được kiểm tra một cách tình cờ. Quyền truy cập dữ liệu là quyền của chủ thể dữ liệu, chứ không phải là công cụ mặc cả trong tranh chấp của người khác. ## Cách TgWitness lưu giữ bản gốc và đảm bảo các bản sao có thể được kiểm tra TgWitness xuất các cuộc trò chuyện dưới dạng bằng chứng. Thiết kế của ứng dụng này xuất phát từ bài học rút ra từ vụ việc này: việc xuất dữ liệu không nên được coi là đáng tin cậy chỉ vì người cung cấp nó là ai. Nhật ký gốc đã được ghi lại vẫn được lưu giữ. Một bản sao chia sẻ ghi lại các bản ghi và trường dữ liệu đã chọn, các quy tắc công bố cũng như số lượng bản ghi bị loại trừ trong bản kê khai đã được ký điện tử. Nguyên tắc “không tin tưởng” áp dụng cho tất cả mọi người, kể cả chúng tôi. Bảo tồn ### Giữ nguyên bản gốc Giữ lại toàn bộ nhật ký đã ghi lại và các chữ ký kèm theo. Lưu giữ một bản sao kiểm tra độc lập để có thể kiểm tra xem sau này có bị thay thế hoặc cắt xén hay không. Bảo vệ ### Mã hóa quá trình chuyển phát Mã hóa tệp lưu trữ bằng khóa của người nhận hoặc bảo vệ quá trình gửi bằng mật khẩu. Để giải mã, cần phải có khóa hoặc mật khẩu tương ứng. Tiết lộ ### Hãy chỉ ra những nội dung bị thiếu Ghi rõ mục đích và các quy tắc vào bản kê khai đã ký. Đánh dấu các bản ghi đã được rút gọn, đếm số bản ghi bị loại trừ và giữ lại các liên kết đến sổ nhật ký nguồn. TgWitness đã niêm phong các bản gốc đầy đủ cho một khóa người nhận, bằng phong bì được sử dụng trong phần trình diễn ở trên, đồng thời đánh dấu những nội dung bị ẩn trong quá trình tiết lộ. Người xác minh kiểm tra chữ ký của bản ghi và liên kết của bản sao được chia sẻ với nhật ký nguồn; việc đối chiếu nội dung bị ẩn với giá trị băm gốc của nó đòi hỏi phải có bản gốc đầy đủ được lưu giữ. Các cam kết có thêm giá trị muối cho từng trường dành cho một cơ quan có thẩm quyền là bước mà trường hợp này đề xuất. | Trong Phụ lục 1 | Chuyên mục TgWitness | Séc đã ghi sổ | | --- | --- | --- | | Chữ nằm dưới các hình chữ nhật màu đen | Các trường bị ẩn đã bị loại bỏ khỏi bản sao được chia sẻ; bản gốc được lưu giữ riêng biệt | Các trường hợp bỏ sót được nêu tên và mã băm của bản ghi gốc | | 50 mô tả đang hiển thị; 1.944 mô tả đã được bao quát | Các quy tắc công bố đã được ký kết và số lượng hồ sơ bị loại trừ | Phạm vi được lựa chọn và nguồn tham khảo từ tạp chí gốc | | Tệp đính kèm PDF | Gửi tệp lưu trữ đã thu thập dưới dạng mã hóa | Giải mã đã được xác thực; chữ ký và hàm băm của tệp lưu trữ | | Tệp được xác định bằng mã SHA-256 dưới đây | Ghi lại các giá trị băm, chữ ký và các điểm kiểm tra được lưu giữ | So sánh với nhật ký đã lưu trước đó | ### Phần mềm này được phát triển nhằm đảm bảo điều gì **Tính toàn vẹn của dữ liệu**Mỗi bản ghi đều được mã hóa băm thành một chuỗi và được ký bằng thuật toán Ed25519. Người xác minh sẽ tính toán lại từng bản ghi, do đó bất kỳ thay đổi nào cũng sẽ được phát hiện. **Bạn có thể kiểm tra tình trạng giao hàng**Các tệp lưu trữ được mã hóa khi gửi đến người nhận; các tệp có dung lượng lớn được chia thành các phần đã được mã hóa kèm theo tệp danh sách nội dung có chữ ký, sau đó được ghép lại và xác minh tại địa phương. **Dữ liệu của người khác vẫn được giữ kín**Theo quy tắc, một bản sao chia sẻ sẽ ẩn đi một số thông tin và nêu rõ những thông tin đã bị ẩn. Việc tiết lộ một giá trị bị che giấu trong bảng điều khiển sẽ được kiểm tra. **Không được phép mắc sai lầm**Các bước kiểm tra này mang tính toán học: tệp tin, dấu vân tay khóa đáng tin cậy và điểm kiểm tra được lưu giữ. Không cần phải dựa vào lời nói của ai cả. **Không có chỗ cho sự thao túng**Các thao tác chỉnh sửa và xóa sẽ trở thành các bản ghi mới; một nhật ký bị rút gọn sẽ không đáp ứng được yêu cầu so với điểm kiểm tra đã lưu giữ; và một bản công bố sẽ không bao giờ được coi là hoàn chỉnh nếu nó thực sự chưa hoàn chỉnh. Một lỗi chính tả trong tên không làm thay đổi dữ liệu đã được phần mềm ký xác nhận. Việc trễ hạn một tháng cũng không làm thay đổi các bản ghi gốc. Bất kỳ thay đổi nào cũng sẽ làm đứt chuỗi xác thực, và người xác minh sẽ chỉ ra điều đó. Hãy thử cả hai cách dưới đây. SHA-256 · TRONG TRÌNH DUYỆT CỦA BẠNChỉnh sửa một trong hai dòng Đã ký · trên giấy tiêu đề`86582990a7b364adbd83071c9edb4774ed6e8ea50b80dca1ae426c3fa679a1d6` Hồ sơ công khai`17fae25500c51998112b146c76b21b04bf3d4034407f2f958bced7d6d6e928ba` **1** đặc điểm nổi bật**60** trong số 64 chữ số hệ thập lục phân khác nhau**Có 128** trong số 256 bit khác nhau Chỉ khác nhau một ký tự. Hai dấu vân tay không liên quan đến nhau. Một hàm băm đã phát hiện ra một ký tự mà quá trình ký tên đã bỏ sót. Một tiêu đề chỉ là thêm một vài byte: nó thay đổi dấu vân tay, chứ không bao giờ thay đổi sự thật. TẬP NHẬT KÝ CÓ CHỮ KÝ · BẢN ĐƠN GIẢNCác hồ sơ minh họa BẢN GHI 1**17.06.2025 · access request**`adc396074b0f04…`= giá trị băm đã lưu BẢN GHI 2**01.10.2025 · letterhead p.zurheode**`0b8eda5c2f43ae…`= giá trị băm đã lưu BẢN GHI SỐ 3**01.10.2025 · Anlage 1 · 830 pages**`dbe2eef85bfb5a…`= giá trị băm đã lưu Mỗi bản ghi đều chứa “dấu vân tay” của bản ghi ngay trước nó. Việc thay đổi bản ghi số 2 sẽ làm thay đổi giá trị băm của nó và làm đứt liên kết với bản ghi số 3. Tóm tắt: mỗi dấu vân tay sẽ bao phủ dấu vân tay trước đó và một dòng văn bản. TgWitness tạo hàm băm cho chín trường sự kiện chuẩn, trong đó có một trường là hàm băm trước đó, và ký mỗi bản tóm tắt bằng thuật toán Ed25519. [Xem chuỗi đầy đủ kèm các điểm kiểm tra](https://phishdestroy.io/tgwitness/vi/docs/concepts/) [Cách thức hoạt động của việc chia sẻ bản sao trên TgWitness](https://phishdestroy.io/tgwitness/vi/docs/handover/) · [Chiếc phong bì niêm phong](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md#cryptographic-handoff) · [Phạm vi triển khai và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) ## Hãy tự mình kiểm tra xem Bất kỳ cơ quan quản lý, tòa án hoặc đơn vị kiểm toán nào đang lưu giữ các tệp tin này đều có thể thực hiện lại mọi bước kiểm tra trên trang này ở chế độ ngoại tuyến. Chỉ công bố kết quả tổng hợp: thông tin đăng nhập của người báo cáo, mã định danh tài khoản và dữ liệu hồ sơ cá nhân sẽ không được công bố tại đây. **Tất cả các tháng: 2021–2025** | Năm | Tháng Giêng | Tháng 2 | Tháng 3 | Tháng 4 | Tháng Năm | Tháng Sáu | Tháng Bảy | Tháng 8 | Tháng 9 | Tháng 10 | Tháng 11 | Tháng 12 | Tổng cộng | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 2021 | 0 | 2 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 1 | 20 | **25** | | 2022 | 10 | 7 | 43 | 9 | 2 | 7 | 2 | 11 | 7 | 6 | 5 | 13 | **122** | | 2023 | 111 | 48 | 156 | 59 | 52 | 53 | 66 | 52 | 73 | 44 | 53 | 58 | **825** | | 2024 | 69 | 58 | 111 | 36 | 33 | 46 | 83 | 53 | 54 | 70 | 79 | 82 | **774** | | 2025 | 92 | 32 | 35 | 20 | 12 | 1 | 7 | 47 | 3 | — | — | — | **249** | 0 có nghĩa là không có dữ liệu cho tháng đó trong bản xuất này; — nằm sau mốc thời gian tháng 9 năm 2025. Tổng cộng: **1.995**. **Tất cả các danh mục báo cáo trong bảng được cung cấp** | Loại báo cáo đã ghi lại | Tất cả các bản ghi | Mô tả dễ hiểu | Các mô tả được đề cập | | --- | --- | --- | --- | | Offensive Profile | 1,148 | 0 | 1,147 | | Suspected Hijacker | 312 | 43 | 269 | | Gian lận | 290 | 2 | 288 | | Offensive Persona Name | 87 | 1 | 86 | | Offensive Avatar | 57 | 3 | 54 | | Quấy rối | 46 | 1 | 45 | | Gửi thư rác | 37 | 0 | 37 | | Giả mạo | 16 | 0 | 16 | | Tự động kiểm duyệt | 1 | 0 | 1 | | Lừa đảo thương mại | 1 | 0 | 1 | Cái Offensive Profile Tổng số này đã bao gồm một mục mô tả trống. Tổng cộng: 1.995 bản ghi, 50 mục mô tả có thể đọc được, 1.944 mục mô tả đã được xử lý, 1 mục mô tả trống. **Lịch sử đăng nhập và bảo mật** Phụ lục 1, trang 1: `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)` và `Date of Report: 09-29-2025`. Lịch sử đăng nhập trên các trang 1–119 liệt kê các lần đăng nhập gần đây nhất trước tiên; các mục mới nhất trong đó là từ tháng 5 năm 2025, và không có mục nào muộn hơn. Trang 830, “Lịch sử bảo mật”, nằm dưới các hình chữ nhật màu đen. Lần thay đổi mật khẩu gần nhất là vào tháng 7 năm 2024; không ghi nhận bất kỳ thay đổi nào trong năm 2025. Ngày tháng, địa chỉ và mã định danh từ các hàng đó không được trình bày lại. ``` pdftotext -f 1 -l 1 Anlage1.pdf - # last logon, date of report pdftotext -f 830 -l 830 Anlage1.pdf - # security history ``` **Siêu dữ liệu PDF và tuyên bố chữ ký** Siêu dữ liệu PDF: người tạo `Aspose.PDF for .NET 20.8`; tạo vào ngày 1 tháng 10 năm 2025, lúc 19:58:05; sửa đổi lúc 19:58:41, cả hai đều theo múi giờ UTC+02:00. Hai dấu thời gian này là **Cách nhau 36 giây**. Cả hai lá thư đều ghi rõ về chữ ký điện tử có giá trị pháp lý ở trang cuối cùng: „Dieses Schreiben ist qualifiziert elektronisch signiert“. Việc xác thực chữ ký là một bước kiểm tra riêng biệt so với các bước kiểm tra nội dung và kiểm tra việc che giấu thông tin được trình bày ở đây. **Lấy lại số đếm và so sánh các giá trị băm nguồn** Tập lệnh đếm được gắn với mã băm của Anlage 1 dưới đây. Tập lệnh này tái tạo các hàng bảng trên các trang 444–620 và nối 118 ô kéo dài qua ranh giới trang. Tính hiển thị được xác định dựa trên giao điểm giữa ô từ và các hình chữ nhật màu đen không trong suốt; mô tả trống duy nhất được ghi lại riêng biệt. Việc đếm ký tự Cyrillic sử dụng các ký tự từ U+0400 đến U+052F. Việc so sánh định dạng đăng nhập sử dụng mẫu chuỗi đầy đủ `[A-Za-z]+[0-9]{3,5}`. Số lần lặp lại được tính sau khi các khoảng trắng được loại bỏ và chuẩn hóa. Số lượng từ trong các mô tả được xem xét luôn khớp với các gốc từ trong mọi trường hợp. Đây là các chỉ số mang tính mô tả, chứ không phải là kết quả tự động xác định việc đồng tác giả hay hành vi vi phạm đạo đức. Các ước tính ngôn ngữ tùy chọn trong tệp JSON sử dụng Lingua 2.2.0 trên máy cục bộ; các đoạn văn bản ngắn và mơ hồ vẫn chưa được gán ngôn ngữ. Việc kiểm tra 905.672 ký tự này đếm từng ký tự không phải khoảng trắng có khung giới hạn giao nhau một lần với một hình chữ nhật màu đen; trong số 1.329 hình chữ nhật màu đen, có 1.044 hình chồng lên các đoạn văn bản như vậy. [Tổng số · JSON](https://phishdestroy.io/tgwitness/assets/signed-export-statistics.json?v=b84f21c8824d) · [Tập lệnh đếm số liệu địa phương · Python](https://phishdestroy.github.io/TgWitness/assets/signed-export-audit.py) ``` python signed-export-audit.py Anlage1.pdf --output counts.json sha256sum Anlage1.pdf pdfinfo Anlage1.pdf | grep -E "Producer|CreationDate|ModDate" pdftotext -layout Anlage1.pdf - | less ``` Tập lệnh này yêu cầu PyMuPDF và lingua-language-detector. Nó không thực hiện bất kỳ yêu cầu kết nối mạng nào và chỉ xuất ra các số liệu tổng hợp, chứ không phải các văn bản khiếu nại hay thông tin đăng nhập. | Tệp | SHA-256 | | --- | --- | | Số tài liệu: 42603633 (Tiến sĩ Zurheide) | `de0fdcf6bfaccedc98d1670438bc7ca3330479096875e716dbb9678922b43ab9` | | Số tài liệu: 42282474 (Tiến sĩ Schelinski) | `b48e09c28ee40a46f1d404041751f718fb185d1eb774ddabb4373fdd53bbe2f1` | | Phụ lục 1 | `2bb927e2c42fdc2e3ad089ae302dd887c343f6798aba00fcfac279224ff7d6af` | **Bài học cho bất kỳ văn bản xuất khẩu nào.** Luật sư có thể ký vào văn bản xuất khẩu. Chữ ký chỉ xác nhận ai là người gửi, chứ không xác nhận nội dung trong đó có đúng hay không. Sự thật là điều còn lại sau khi trải qua quá trình kiểm chứng mà bất kỳ ai cũng có thể lặp lại. ## Quan điểm của chúng tôi **Quan điểm của PhishDestroy.** Chúng tôi tôn trọng pháp luật và các tòa án. Pháp luật không phải là kẻ thù của sự thật. Những ai bóp méo pháp luật để trốn tránh việc tuân thủ thì không phải là đồng minh của tòa án, và danh hiệu tiến sĩ không thể là cơ sở để khẳng định uy quyền của ai đó. Bằng tiến sĩ chỉ là một thực tế lịch sử: một công trình nghiên cứu trong một lĩnh vực lý thuyết hẹp, được bảo vệ một lần. Nó không thể biến ai thành luật sư chuyên về công nghệ thông tin. Theo những gì chúng tôi nhận thấy, không có chi tiết nào trong tiêu đề giải thích được những sai sót này: không phải các lập luận được nêu dưới phần chữ ký, không phải tên bị viết sai chính tả, cũng không phải việc rò rỉ dữ liệu mà chính các lá thư đó tuyên bố sẽ bảo vệ. Sau đó, cả hai bên ký kết đều đã nộp đơn yêu cầu tìm kiếm và gỡ khỏi danh sách theo Điều 17 (xem [Thông báo dành cho nhà khai thác](https://phishdestroy.io/tgwitness/vi/docs/reference/notice/)). Quyền được “quên đi” không nên làm lu mờ sự cẩu thả trong công việc của một chuyên gia. Và liệu có ai kiểm tra các tài liệu được ký bằng chữ ký điện tử có giá trị pháp lý trước khi gửi đi không? Những lá thư này đọc giống như một email gửi cho bạn bè, chứ không giống một tài liệu có ý nghĩa công cộng. “Không tin tưởng ai cả”. Tiền thì tốt. Tuy nhiên, theo quan điểm của chúng tôi, việc bán rẻ luật pháp của chính đất nước mình để đổi lấy tiền không phải là cách sử dụng tiền hợp lý nhất. Nhưng chúng tôi không phải là chuyên gia. PhishDestroy không phải là bên liên quan trong tranh chấp và không đưa ra nhận định về việc liệu việc khóa tài khoản Steam có hợp lý hay không. Chủ thể dữ liệu không được nêu tên trên trang này; các thông tin nhận dạng tài khoản, tên đăng nhập, địa chỉ IP và dữ liệu cá nhân không được trích dẫn. Nội dung các đơn khiếu nại được trích dẫn mà không kèm theo tên đăng nhập của người khiếu nại, bao gồm cả các đoạn văn bản nằm trong các hình chữ nhật màu đen, vốn vẫn được giữ nguyên trong lớp văn bản của tệp. Thư: Số tài liệu 42282474, ngày 15 tháng 8 năm 2025 (3 trang); Dok.-Nr. 42603633, ngày 1 tháng 10 năm 2025 (9 trang). Phụ lục: Anlage 1 (830 trang). Các tham chiếu trang tuân theo thứ tự trang trong tệp PDF. Các bản dịch tiếng Anh của các trích dẫn tiếng Đức do chúng tôi thực hiện. [Hồ sơ vụ việc mở rộng](https://phishdestroy.io/steam_dossier/taylor_wessing) · [Hồ sơ GDPR kéo dài 106 ngày](https://github.com/phishdestroy/TgWitness/blob/main/docs/TAYLOR-WESSING-GDPR-FILE.md). --- # Telegram · Quản lý kho lưu trữ Canonical page: https://phishdestroy.io/tgwitness/vi/docs/archive/ Xem lịch sử tải xuống, tìm kiếm các bản ghi đã lưu, xem xét các nguồn AI và kết nối các công cụ của bạn. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Tìm tin nhắn. Kiểm tra nguồn. Xây dựng hồ sơ vụ việc. 01**Hiển thị lịch sử** Kéo tin nhắn cũ từ các nguồn đã bật vào không gian làm việc. 02**Theo dõi các nguồn** Tìm kiếm, rồi mở tin nhắn đã lưu đằng sau mỗi kết quả. 03**Giữ cho phần chuyển giao thông tin rõ ràng** Phân tích của bạn trong một tệp, bằng chứng có chữ ký nằm bên cạnh. Các bản ghi được thu thập, văn bản được nhận diện và kết luận của nhà phân tích được phân biệt rõ ràng. ## Tải các tin nhắn trước đây 1. **Nguồn → Trò chuyện trong phạm vi**: kiểm tra các cuộc trò chuyện đã bật, bắt đầu quan sát. 2. **Tải toàn bộ lịch sử**. Nó lấy danh sách nguồn đúng như hiện tại. 3. **Tạm dừng lịch sử** / **Tiếp tục lịch sử** bất cứ lúc nào. Sau khi khởi động lại, hãy tiếp tục thủ công. 4. Kiểm tra kết quả theo từng nguồn và hàng đợi tải xuống, giữ báo cáo tiến độ có chữ ký cùng bản xuất. Việc này lấp đầy không gian làm việc. Xuất HTML/JSON một cuộc trò chuyện là chuyện khác. [Chi tiết](https://phishdestroy.io/tgwitness/vi/docs/reference/history/). ## Tìm kiếm trước, sau đó quyết định về AI 1. **Sổ nhật ký** tìm kiếm cục bộ, lọc theo nguồn và thời gian. 2. Tìm một cụm từ hoặc tên miền, mở bản ghi và các phiên bản của nó. 3. Để dùng AI, quản trị viên thiết lập nhà cung cấp trong **Tích hợp**. Sau đó **Hỏi kho lưu trữ**: chọn cuộc trò chuyện và khoảng thời gian, xem **Dữ liệu được gửi đến mô hình** và bỏ chọn những gì không được gửi ra ngoài. 4. Kiểm tra trích dẫn, lưu câu trả lời thành báo cáo, thêm ghi chú của bạn. Tìm kiếm không cần AI. Báo cáo giữ nguồn và các bản sửa đổi riêng, tách khỏi sổ nhật ký có chữ ký. [Thiết lập nhà cung cấp](https://phishdestroy.io/tgwitness/vi/docs/reference/analysis/). ## Chọn kết nối phù hợp với nhu cầu của bạn | Nhiệm vụ | Mở | Cài đặt | | --- | --- | --- | | Cho phép ứng dụng AI đọc các cuộc trò chuyện được chọn | **Tích hợp → MCP** | [Cài MCP, tạo token giới hạn phạm vi, kết nối](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/) | | Nhận diện văn bản trong các tệp phương tiện đã lưu | Một bản ghi `media.saved` → **Nhận diện tệp đính kèm** | [Thiết lập worker Docker cục bộ](https://phishdestroy.io/tgwitness/vi/docs/reference/media-analysis/) | | Gửi sự kiện đến n8n hoặc một hệ thống SIEM | **Tích hợp → Webhook đi** | [Thêm bên nhận, kiểm tra HMAC, loại trùng ID](https://phishdestroy.io/tgwitness/vi/docs/reference/webhooks/) | **Token truy cập nào được sử dụng ở đâu?** Quyền vào bảng điều khiển là cho con người. MCP có token chỉ đọc riêng, webhook có khóa bí mật HMAC riêng. Không cái nào cần phiên Telegram. [Chia sẻ quyền truy cập bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/access/) hoặc [cấu hình máy khách MCP](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/). ## Cung cấp nguồn thông tin và kết luận Đặt báo cáo cạnh tệp ZIP có chữ ký. Báo cáo là cách bạn đọc các nguồn, còn ZIP là thứ người nhận xác minh. [Xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/exports/) · [Tiến hành một cuộc điều tra toàn diện](https://phishdestroy.io/tgwitness/vi/docs/cases/) --- # Telegram · Chia sẻ một trường hợp Canonical page: https://phishdestroy.io/tgwitness/vi/docs/access/ Cung cấp cho các nhà đánh giá và nhà phân tích quyền truy cập vào các tài khoản và cuộc trò chuyện được chọn lọc, kèm theo các quyền truy cập riêng biệt, giới hạn phiên làm việc và mã thông báo có thể thu hồi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Hãy chia sẻ những trường hợp mà người khác cần. Đồng thời, hãy giữ quyền kiểm soát đối với phần còn lại. 01**Chọn bằng chứng** Toàn bộ không gian làm việc hoặc từng cuộc trò chuyện. 02**Chọn các hành động** Xem, xuất, hoặc chỉ những thao tác họ cần. 03**Đặt các giới hạn** Một token cá nhân với thời hạn, giới hạn phiên và quy tắc IP nếu bạn muốn. Phạm vi thu thập quyết định những nội dung nào sẽ được ghi lại. Phạm vi truy cập quyết định những gì một người có thể xem và thực hiện. ## Cấp quyền truy cập cho ai đó 1. Với tư cách quản trị viên, mở **Truy cập**. 2. Đặt tên, chọn không gian làm việc và cuộc trò chuyện. 3. Người kiểm duyệt chỉ cần **Xem**. Thêm **Xuất** nếu cần tải xuống. 4. Vui lòng thiết lập các giới hạn, sau đó nhấn vào nút **“Tạo quyền truy cập**”. 5. Sao chép token (chỉ hiện một lần) và gửi riêng cùng địa chỉ bảng điều khiển. 6. Trước tiên hãy kiểm tra họ sẽ thấy gì trong một phiên trình duyệt riêng. ## Hãy bắt đầu từ nhiệm vụ mà họ cần thực hiện | Người | Truy cập | Kết quả | | --- | --- | --- | | Người đánh giá | Các cuộc trò chuyện được chọn lọc; chỉ xem | Đọc cuộc trò chuyện, không thay đổi được gì. | | Chuyên viên phân tích | Các cuộc trò chuyện được chọn lọc; xem và xuất | Đọc và tải xuống những gì vụ việc cần. | | Người vận hành | Các không gian làm việc được chọn lọc; nguồn và bộ sưu tập | Quyết định cái gì được quan sát, bắt đầu và dừng máy thu thập. | Đây chỉ là ví dụ, không phải vai trò cố định. Quyền truy cập giới hạn theo cuộc trò chuyện không bao giờ có cài đặt tài khoản hay xuất toàn bộ sổ nhật ký. Quyền truy cập tất cả không gian làm việc bao gồm cả các tài khoản được thêm sau. ## Quý vị có thể thay đổi quyết định bất cứ lúc nào Sửa quyền truy cập bất cứ lúc nào, áp dụng từ yêu cầu kế tiếp. Kết thúc một phiên hoặc thu hồi tất cả. Tệp đã tải xuống thì không lấy lại được. Việc thu thập vẫn tiếp tục. **Giới hạn phiên và địa chỉ IP** Giới hạn phiên song song và số lần đăng nhập, đặt ngày kết thúc, cho phép IP hoặc mạng con, hoặc khóa vào IP đăng nhập đầu tiên. Thời hạn tính theo thời gian không hoạt động, bảng điều khiển đang mở được tính là hoạt động. Khi ở sau proxy, hãy kiểm tra ứng dụng thấy IP máy khách nào. **Khóa chính và nhật ký hoạt động** Token chính ở lại với quản trị viên. Quyền truy cập được cấp không thể quản lý quyền của người khác hay mở bảng quản trị. Thay đổi quyền truy cập và các phiên được ký vào sổ nhật ký, không kèm token. Quản trị viên máy chủ vẫn thấy được mọi thứ. Cả bảy quyền và quy tắc phiên: [tài liệu tham khảo về truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/access/). --- # Telegram · Hãy duy trì hoạt động của nó Canonical page: https://phishdestroy.io/tgwitness/vi/docs/server/ Vui lòng chạy TgWitness trên một máy chủ có bộ nhớ lưu trữ lâu dài, quyền truy cập bảng điều khiển riêng tư, tính năng sao lưu và các quy trình kiểm tra sau khi khởi động lại. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Giữ máy thu thập luôn chạy và dữ liệu an toàn qua các lần khởi động lại. ## Vui lòng chọn phương thức triển khai Cài đặt trực tiếp: [trình khởi chạy](https://phishdestroy.io/tgwitness/vi/docs/start/) cùng các mẫu dịch vụ trong [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Docker, từ thư mục dự án: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Bảng điều khiển lắng nghe trên localhost:8787. Mở nó cục bộ hoặc qua đường hầm SSH, với token từ lệnh thứ hai. ## Giữ nguyên toàn bộ thư mục dữ liệu Cài đặt trực tiếp: `data/live`. Docker: volume `tgwitness-data`. Sổ nhật ký, phiên và khóa phải đi cùng nhau. Bản xuất có chữ ký là bằng chứng, không phải bản sao lưu. 1. Dừng thu thập trước. 2. Sao chép toàn bộ thư mục dữ liệu tới một nơi an toàn, ngoài máy chủ. 3. Thử khôi phục trên một bản cài riêng trước khi tin tưởng nó. ## Vui lòng kiểm tra lại sau khi khởi động lại Kiểm tra không gian làm việc và khóa, kết nối, nguồn và xem tin nhắn mới có vào không. TgWitness bắt kịp những gì Telegram vẫn còn giữ, không phải mọi thứ đã xảy ra khi nó ngừng chạy. Container "healthy" nghĩa là máy chủ web có phản hồi. Việc thu thập có chạy không thì tin nhắn thử và nhân chứng sẽ cho biết. ## Chỉ công bố những thông tin mà quý vị dự định công bố HTTPS, volume, cập nhật và khôi phục có trong tài liệu triển khai. Những gì đã thực sự được kiểm thử: [hồ sơ kiểm định](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/). --- # Telegram · Tìm hiểu nguyên nhân sự cố Canonical page: https://phishdestroy.io/tgwitness/vi/docs/troubleshooting/ Vui lòng kiểm tra quyền truy cập bảng điều khiển, kết nối Telegram, các tin nhắn bị thiếu, FloodWait và trạng thái chứng nhân bằng cách sử dụng các tín hiệu phù hợp cho từng vấn đề. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Bắt đầu từ triệu chứng, kiểm tra từng thứ một. ## Ban tổ chức yêu cầu một mã xác thực Nó cần token bảng điều khiển từ tệp mà trình khởi chạy đã in ra. Docker: `docker compose exec tgwitness cat /data/panel-token.txt`. Không phải mã Telegram, không phải token bot, không phải token nhân chứng. ## Telegram không kết nối Chạy kiểm tra kết nối. Nếu dùng proxy công khai, hãy chọn cái khác và lưu. Kiểm tra loại proxy và định dạng khóa bí mật. Làm mới danh sách không tự đổi tuyến. ## Đang kết nối, nhưng không có tin nhắn mới 1. Quan sát có đang chạy, đúng không gian làm việc không? 2. Nguồn đã được chọn và tài khoản đó có thấy không? 3. Gửi một tin nhắn duy nhất trong nhóm thử nghiệm và tìm nó. 4. Tìm các lần gián đoạn hoặc lỗi Telegram trong sổ nhật ký. Cuộc trò chuyện im ắng chỉ là không có gì mới. Nếu độ đầy đủ quan trọng, hãy chạy một phép thử nhận tin có kiểm soát. ## FloodWait hoặc khoảng trống sau khi khởi động lại FloodWait là Telegram nói "chậm lại". Hãy chờ cho qua và giảm tải, kết nối lại không giúp được gì. Sau khi khởi động lại, TgWitness bắt kịp những gì Telegram vẫn còn giữ; phần còn lại là khoảng trống, nên hãy ghi lại. ## Bot đã được cấu hình nhưng chưa đăng tải bất kỳ nội dung nào Nhân chứng có đang chạy không, bot có đăng được vào kênh không, nó có kết nối được tới máy thu thập và Bot API không? Tìm các bài đăng thất bại trong sổ nhật ký của nó. Có truy vấn ở phía máy thu thập không có nghĩa là bài đã được đăng. ## Tính năng tích hợp mã thông báo GitHub hiện nằm ở đâu? **Đang trong giai đoạn lập kế hoạch.** Phần “Extras” mô tả quy trình làm việc được đề xuất cho việc phân nhánh (fork) và xác minh bản dựng. Hiện tại chưa có biểu mẫu mã thông báo GitHub hay cơ chế xác nhận tự động nào để đảm bảo rằng một bản cài đặt đang hoạt động khớp với kho lưu trữ. Vui lòng tham khảo [tình trạng tính năng hiện tại](https://phishdestroy.io/tgwitness/vi/docs/reference/features/). Báo lỗi? Phiên bản, hệ điều hành, các bước và thông báo lỗi đã che thông tin riêng. Không bao giờ đưa phiên, token, tin nhắn riêng tư hay thư mục dữ liệu vào issue công khai. --- # Export Clinic Canonical page: https://phishdestroy.io/tgwitness/vi/docs/export-clinic/ Hãy theo dõi một thí nghiệm xuất dữ liệu có kiểm soát trên Telegram Desktop, so sánh bảy cuộc trò chuyện thử nghiệm và kiểm tra bản ghi gốc cùng các tệp đi kèm. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Cửa sổ trò chuyện hiển thị thông báo “FAIL”. Trang đã xuất ra lại hiển thị thông báo “PASS”. Hãy theo dõi sự thay đổi này, so sánh các tệp và tìm hiểu xem điều này xảy ra như thế nào. Thí nghiệm này sử dụng các tài khoản thử nghiệm và các cuộc trò chuyện được lập trình sẵn. Ứng dụng Telegram Desktop đã được tải xuống từ nguồn chính thức và tệp thực thi của nó không bị thay đổi. Một công cụ hỗ trợ cục bộ đã cố ý thay đổi một số tệp xuất được chọn. Hãy theo dõi các bước tải xuống, đăng nhập và xuất dữ liệu, sau đó so sánh cuộc trò chuyện trên Telegram với các tệp HTML và JSON đã được chỉnh sửa. Thí nghiệm này cho thấy những phần nào trong quá trình xuất dữ liệu thông thường có thể bị thay đổi và tại sao việc ghi lại quá trình thu thập dữ liệu lại quan trọng. Phim tóm tắt **1:59,7****6:08,8 –** bản ghi âm nguyên bản đầy đủ**7** cuộc hội thoại thử nghiệm ## Xem thí nghiệm [Tải phim về](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) 1:59,7 · Các bước thiết lập và các bước lặp lại được tăng tốc từ ×2 đến ×15 và được gắn nhãn. Quá trình đăng nhập, lần xuất dữ liệu đầu tiên và các so sánh đã chọn được chạy ở tốc độ ban đầu. Không có âm thanh. [Tải xuống tệp MKV gốc ↗](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) ## So sánh các tệp xuất thử nghiệm Các đoạn trích này được lấy từ các tệp JSON đã được lưu giữ và chỉnh sửa. Hãy chọn một loại cuộc trò chuyện, so sánh các tin nhắn, sau đó tải xuống toàn bộ các tệp xuất dữ liệu tương ứng để tự mình kiểm tra mã HTML, JSON và các hình ảnh đi kèm. ### Hướng dẫn xuất | Kiểm tra tệp PDF 5 tin nhắn · 2 tin nhắn đã được chỉnh sửa **TRƯỚC KHI CÓ SỰ THAY ĐỔI TẠI ĐỊA PHƯƠNG**Giữ nguyên các byte ban đầu KIỂM TRA TÀI LIỆU / THỬ NGHIỆM TỔNG HỢP KẾT QUẢ: KHÔNG ĐẠT Văn bản ẩn vẫn có thể được chọn bên dưới hình chữ nhật màu đen. Đây là kết quả được lập trình sẵn cho tệp PDF minh họa, không phải là kết quả kiểm tra tài liệu của bên thứ ba. d58d19814e1e07d5… **SAU KHI THAY ĐỔI TẠI ĐỊA PHƯƠNG**Các byte bị thay đổi một cách có chủ ý KIỂM TRA TÀI LIỆU / KIỂM TRA TỔNG HỢP KẾT QUẢ: ĐẠT Tất cả nội dung nhạy cảm đã được xóa vĩnh viễn. Đây là kết quả minh họa được thay thế một cách có chủ đích. 83a0a37eb7110d51… result.json · thông báo 1216 Nội dung cảnh được viết sẵn. Kết luận của bot không phải là kết quả kiểm tra một tài liệu thực tế của bên thứ ba. Đã sửa tin nhắn 1 trong 2 **So sánh với hình ảnh được đính kèm trong tệp xuất này** ![Hình ảnh trước khi chỉnh sửa cục bộ](https://phishdestroy.io/tgwitness/vi/docs/export-clinic/) TRƯỚC · các byte hình ảnh được giữ lại ![Hình ảnh đã được chỉnh sửa có chủ đích](https://phishdestroy.io/tgwitness/vi/docs/export-clinic/) SAU · hình ảnh được thay thế một cách có chủ ý Các tệp đính kèm không được bao gồm trong bản xuất của bot này. Tập tin lưu trữ vẫn giữ nguyên hạn chế đó. JavaScript đã bị tắt. Tính năng so sánh bot mặc định và tất cả các tệp tải xuống vẫn có sẵn. Hãy tải xuống tệp lưu trữ chứa các cuộc hội thoại để xem xét sáu cuộc hội thoại còn lại. ## Điều mà sự so sánh này cho thấy là [Tính năng xuất thông thường](https://telegram.org/blog/export-and-more) của Telegram lưu lại lịch sử trò chuyện và các tệp phương tiện đã chọn dưới dạng tệp cục bộ. Trong trường hợp này, một tài khoản phụ có quyền ghi sẽ thay đổi các tệp đó trong khi ứng dụng chính thức vẫn hiển thị nội dung cuộc trò chuyện ban đầu. Các tệp tương ứng này cho phép bạn kiểm tra từng thay đổi. 1. **Ứng dụng chính thức:** Tải xuống, đăng nhập và xem các cuộc trò chuyện thử nghiệm. 2. **Xuất bản gốc:** khách hàng tự viết mã HTML, JSON và các hình ảnh đã chọn. 3. **Hành động can thiệp được tiết lộ:** một người hỗ trợ tại chỗ cố ý thay đổi các tệp đã chọn. 4. **So sánh:** nội dung cuộc trò chuyện và bản xuất đã được chỉnh sửa được hiển thị song song. ### Ghi lại dữ liệu ngay khi thu thập được Thời điểm ký kết có ý nghĩa quan trọng. Việc ký vào một tệp xuất đã bị sửa đổi sẽ giữ nguyên phiên bản đã bị sửa đổi đó. TgWitness kết nối với Telegram, ghi lại nội dung được gửi đến tài khoản, đồng thời ký và liên kết các mục nhật ký trong quá trình thu thập. Người nhận có thể đối chiếu các bản ghi và tệp đã lưu với các chữ ký đó cũng như các điểm kiểm tra được lưu giữ độc lập. Đối với quy trình thu thập dữ liệu được ghi lại từ bên ngoài, [GitHub Actions sẽ khởi](https://phishdestroy.io/tgwitness/vi/docs/capture/) chạy trình thu thập TgWitness đã được ghim với một phiên Telegram mới. GitHub xác thực tệp lưu trữ thu được. Quá trình xác minh sẽ kiểm tra quy trình làm việc và phiên bản trình thu thập đã được phê duyệt, băm của tệp lưu trữ, nhật ký và các tệp đính kèm. [Xác minh tệp lưu trữ TgWitness](https://phishdestroy.io/tgwitness/vi/docs/exports/#verify) · [Hãy thử thay đổi một bản ghi có dấu](https://phishdestroy.io/tgwitness/vi/docs/concepts/#chain) · [Thực hiện quá trình thu thập dữ liệu từ GitHub](https://phishdestroy.io/tgwitness/vi/docs/capture/) ## Các công cụ pháp y thực sự chứng nhận điều gì Export Clinic đưa ra một trường hợp cụ thể. Mô hình mà nó bộc lộ không chỉ riêng đối với Telegram. Trong phần lớn các vụ việc mà chúng tôi đã xem xét — bao gồm các tài liệu nộp lên tòa án, các cuộc thảo luận về vụ án và các phân tích đã được công bố — “chứng cứ kỹ thuật số” đều tuân theo một định dạng nhất quán: một tệp xuất từ Telegram (dạng HTML hoặc JSON, đôi khi là bản ghi màn hình, đôi khi là video quay từ iPhone khi duyệt qua các trang hồ sơ) kèm theo chữ ký của chuyên gia. Đó thường là toàn bộ chuỗi chứng cứ. Các tệp xuất từ Telegram cung cấp một bản chụp nhanh nhằm đảm bảo tính di động của dữ liệu cá nhân. TgWitness bổ sung bản ghi quá trình thu thập, các quan sát và thay đổi được lưu giữ, mã băm tệp, chữ ký của người thu thập cùng các bản ghi xác minh bên ngoài có sẵn cho chế độ đã chọn. Tổng hợp lại, những thông tin này cho phép người nhận so sánh tài liệu đã lưu với bối cảnh, thời gian và điều kiện thu thập được ghi lại. ### Các công cụ thì trung thực. Vấn đề nằm ở chỗ mọi người cho rằng chúng chứng minh điều gì. Chúng tôi đã hợp tác trực tiếp với UFED Cellebrite. Đây là một phần mềm tuyệt vời. Khi phần mềm này trích xuất dữ liệu từ thiết bị, tính toán các giá trị băm SHA-256 và tạo ra một báo cáo có chữ ký, nó đang xác nhận một cách chính xác một điều duy nhất: *những byte này đã tồn tại trên thiết bị này tại thời điểm trích xuất, và không có bất kỳ thay đổi nào xảy ra trong quá trình truyền tải.* Điều đó là sự thật. Điều đó hữu ích. Đó chính là toàn bộ những gì mà điều đó chứng minh được. Nó không đề cập gì đến những gì có trên thiết bị trước khi cơ quan thực thi pháp luật tiếp xúc với nó. Nó cũng không đề cập gì đến việc liệu dữ liệu đó có phản ánh thực tế trong quá khứ hay không. Công cụ này là chính xác. Công cụ này không phải là nhân chứng. Chúng ta có thể sử dụng các công cụ được phát triển riêng để xử lý các tệp xuất từ cuộc trò chuyện trên Telegram — các trình xem, trình lưu trữ, các công cụ đóng gói để trình bày trước tòa — thử nghiệm từng công cụ với các tệp xuất đã chuẩn bị sẵn, và lập một bảng so sánh. Nhưng chúng ta sẽ không làm vậy. Vấn đề không phải là công cụ nào phát hiện được điều gì. Không có công cụ nào làm được điều đó. Chúng chỉ xử lý những gì có trong tệp xuất. Nếu tệp xuất đã được cấu trúc sẵn trước khi đến tay chúng, chúng sẽ phản ánh chính xác cấu trúc đó. Chữ ký mật mã xác nhận tính toàn vẹn của dữ liệu *kể từ thời điểm ký trở đi*. Nó không đưa ra bất kỳ khẳng định nào về những gì đã xảy ra trước đó. Nếu dữ liệu đầu vào được tạo ra trước khi trích xuất, báo cáo sẽ hoàn hảo về mặt mật mã nhưng sai sự thật. Công cụ này sẽ báo cáo cả hai kết quả này giống hệt nhau. ### Khoảng cách về trách nhiệm giải trình Hãy tưởng tượng một khu vực pháp lý nơi thiết bị pháp y được mua sắm thông qua đấu thầu công khai — các phiên bản, cấu hình và tiến độ mua sắm đều được công khai trong hồ sơ công khai. Nơi không có luật nào quy định các thiết bị phải sử dụng phiên bản phần mềm hệ thống mới nhất. Nơi các chuyên gia làm chứng không phải chịu trách nhiệm hình sự cá nhân trước tòa án về các kết luận của họ. Tại Hoa Kỳ và Vương quốc Anh, mỗi chuyên gia pháp y phải chịu trách nhiệm pháp lý cá nhân đối với mọi hành động liên quan đến chứng cứ. Chính trách nhiệm đó — chứ không phải phần mềm — mới là yếu tố đảm bảo chuỗi chứng cứ hoạt động hiệu quả. Nếu loại bỏ trách nhiệm đó, chính công cụ vốn phục vụ công lý lại có thể bị lợi dụng để phục vụ bất kỳ mục đích nào mà người sở hữu giấy phép cho là thuận tiện. **Cơ chế kỹ thuật xác định trạng thái của thiết bị trước khi xảy ra sự cố** Nếu một đối tượng biết trước về một cuộc tấn công sắp xảy ra với thời gian chuẩn bị đủ dài — bảy ngày là quá đủ — thì các phản ứng hoảng loạn không chỉ phản tác dụng mà ở một số khu vực pháp lý, còn bị coi là hành vi phạm tội riêng biệt. Một đối tượng đã chuẩn bị kỹ lưỡng, có khả năng tiếp cận kỹ thuật và nguồn lực sẽ hành động theo cách khác: họ thiết lập một trạng thái thiết bị. **Khoảng thời gian cập nhật firmware.** Các dòng cao cấp của Samsung như Galaxy S Ultra, Z Fold — có tính năng bảo mật Knox và bộ nạp khởi động bị khóa. Khoảng cách giữa thời điểm phát hành bản vá bảo mật và thời điểm bản vá đó có sẵn cho một thiết bị cụ thể tại khu vực nào đó thường lên tới một tháng. Đối với các mẫu máy mới ra mắt, khoảng thời gian này trong ba đến bốn tháng đầu tiên còn kéo dài hơn đáng kể. Theo chúng tôi được biết, không có khu vực pháp lý nào quy định bắt buộc phải cài đặt phiên bản firmware mới nhất trên thiết bị cá nhân. **Các công cụ quản lý dịch vụ.** Phần mềm bảo trì thương mại cho phép truy cập cấp thấp vào thiết bị trong khoảng thời gian này mà không kích hoạt các chỉ báo can thiệp của Knox – những dấu hiệu mà chuyên gia pháp y sẽ tìm kiếm. **Xây dựng dòng thời gian.** Việc triển khai bản sao lưu toàn bộ thiết bị lên trình giả lập, cùng với việc điều khiển thời gian thông qua tập lệnh và cách ly mạng, cho phép xây dựng dòng thời gian sự kiện theo ý muốn: các cuộc gọi, tin nhắn, hoạt động của ứng dụng, tọa độ GPS. **Vị trí mà không cần dựa vào dữ liệu di động.** Hồ sơ thanh toán từ các trạm phát sóng di động có thể được xác minh độc lập — đừng động vào chúng. Thay vào đó, các kết nối với các điểm truy cập Wi-Fi công cộng sẽ được ghi lại. Các địa chỉ MAC của hạ tầng công cộng được các tập đoàn công nghệ lớn thu thập và phân phối một cách có hệ thống. Từ dữ liệu công khai, có thể xây dựng được một chuỗi địa lý liên tục bao phủ bất kỳ khoảng thời gian nào mong muốn. **Luân chuyển tài khoản.** Quá trình xóa tài khoản Samsung mất khoảng bảy ngày để hoàn tất việc xóa bỏ. Một tài khoản mới được tạo ra, bản sao lưu đã chuẩn bị sẵn được khôi phục. Không có xung đột về tính toàn vẹn hệ thống, bộ nạp khởi động (bootloader) không bị can thiệp, không kích hoạt cờ phát hiện can thiệp. **Cụ thể là Telegram.** Trên một số dòng thiết bị nhất định, cơ sở dữ liệu và bộ nhớ đệm của ứng dụng — bao gồm các cuộc trò chuyện, tệp đa phương tiện, siêu dữ liệu thông báo, mẫu hoạt động — có thể được thay thế ở cấp độ khả năng của hệ điều hành mà không cần quyền truy cập root theo cách truyền thống. Phân tích sâu do các chuyên gia thực hiện trên bản sao lưu thô đầy đủ có thể phát hiện ra các điểm bất thường. Tuy nhiên, quá trình phân tích này tốn kém, chậm chạp và theo kinh nghiệm của chúng tôi, về cơ bản hầu như không bao giờ được yêu cầu trong các thủ tục tố tụng tiêu chuẩn. ### “Rác vào, rác ra” Báo cáo đã ký sẽ liên kết các byte được trích xuất với lần thu thập dữ liệu đó. Lịch sử hoạt động trước đó của thiết bị được đánh giá dựa trên các bản ghi từ giai đoạn trước đó. Quy trình tiếp theo — các chuyên gia làm chứng đọc kết quả từ công cụ, viết báo cáo phân tích, ký kết luận — cũng đảm bảo độ chính xác tương tự ở từng bước riêng lẻ. Không ai trong quy trình này nói dối. Không ai trong quy trình này chứng minh sự thật lịch sử. Mỗi người tham gia đều báo cáo chính xác những gì họ nhận được từ bước trước đó. Bằng tiến sĩ là bằng chứng cho thấy đã hoàn thành các công trình nghiên cứu trong quá khứ. Nó không phải là chứng chỉ xác nhận năng lực hiện tại, và cũng không thể biến một khẳng định không thể kiểm chứng về mặt toán học thành sự thật. Chúng tôi đề xuất một tiêu chuẩn khác: **hãy tin vào toán học, chứ không phải vào danh hiệu.** ### Mô hình Zero Trust trong lĩnh vực chứng cứ Trong lĩnh vực an ninh thông tin, “Zero Trust” có nghĩa là không có chủ thể nào được tin cậy theo mặc định, bất kể vị trí hay thông tin xác thực của họ là gì — mọi tuyên bố đều phải được xác minh một cách độc lập. Chúng tôi đề xuất áp dụng nguyên tắc tương tự đối với chứng cứ số. Niềm tin là một lỗ hổng. Nếu một tuyên bố không thể được xác minh một cách độc lập và theo phương pháp toán học, thì đó là một tuyên bố dựa trên niềm tin — và niềm tin có thể bị đặt nhầm chỗ, bị mua chuộc hoặc bị ép buộc. Đặc biệt đối với bằng chứng xuất từ Telegram: đừng tin chúng tôi, đừng tin Telegram, đừng tin nhà phân tích, đừng tin nhân chứng chuyên môn. Hãy kiểm tra lại các phép tính. Trên thực tế, điều này thể hiện như sau: Các chứng nhận của TgWitness tham chiếu đến mô hình SLSA v1 Cấp độ 3 — nguồn gốc bản dựng được ký bởi hạ tầng GitHub Actions, gắn liền với một mã băm cam kết cụ thể và một lần chạy quy trình làm việc. Chứng nhận này có thể được xác minh một cách độc lập, mà không cần tin tưởng bất kỳ cá nhân nào tham gia vào quá trình thu thập. Nó không loại bỏ hoàn toàn các giả định về sự tin cậy — mà ghi lại chính xác những giả định nào vẫn còn tồn tại và chúng là gì. **Về các chuyên gia làm chứng và các biện pháp khuyến khích tài chính** Một luật sư đại diện cho một bên trong một vụ tranh chấp, đồng thời tự xưng là chuyên gia bên thứ ba trung lập trong cùng một vụ việc, với mức thù lao phụ thuộc vào kết quả của thân chủ: đây là một mâu thuẫn về mặt cơ cấu. Chúng tôi không đưa ra cáo buộc đối với bất kỳ cá nhân nào. Chúng tôi đang đặt câu hỏi tại sao cơ cấu này lại được coi là chấp nhận được, và tại sao nó lại hiếm khi được xem xét kỹ lưỡng đến vậy. Lập luận phản bác tiêu chuẩn: *việc nói dối sẽ khiến họ phải trả giá bao nhiêu?* Tại các khu vực pháp lý có quyền xóa dữ liệu và quyền được lãng quên, chi phí thực tế để khởi kiện chuyên gia về tội khai man thường là: rất ít. Những người nêu lên lo ngại về một kết luận chuyên môn sai lệch thường nhận được văn bản pháp lý yêu cầu ngừng nêu lo ngại. Quá trình đó tốn kém đối với người nêu lo ngại. Nhưng nó không tốn kém đối với chuyên gia. Chúng tôi không có ý nói rằng tất cả các nhân chứng chuyên môn đều không trung thực. Chúng tôi chỉ muốn nói rằng câu “chi phí để nói dối sẽ quá cao đối với họ” không phải là một tiêu chuẩn chứng minh. Đó là một tiêu chuẩn về lòng tin. Và lòng tin là một điểm yếu. Một đối tượng muốn phản đối chứng nhận của TgWitness sẽ phải phá vỡ chữ ký mật mã, thuyết phục hệ thống ký số của GitHub chứng nhận ngược lại một điều mà hệ thống này chưa từng thực hiện, và thực hiện điều đó trên một lịch sử cam kết bất biến — với sự có mặt của một nhân chứng. Nếu những khả năng đó thực sự tồn tại và chỉ đơn thuần bị che giấu dưới lớp khó khăn khi sử dụng phần mềm PDF, chúng tôi thực sự hoan nghênh việc chứng minh điều đó. Chúng tôi không khẳng định rằng các công cụ của mình tốt hơn — chúng tôi không có sản phẩm thương mại và cũng không có ý định phát triển sản phẩm như vậy. Chúng tôi đã nhận thấy một vấn đề: quan niệm phổ biến cho rằng kết quả từ phần mềm pháp y đồng nghĩa với sự thật lịch sử, và rằng các dấu hiệu chuyên môn đồng nghĩa với bằng chứng. Quan niệm đó hiếm khi bị thách thức ở cấp độ kỹ thuật trong các phiên tòa — nơi nó có ý nghĩa quan trọng nhất. Thí nghiệm này chỉ là một dữ liệu được kiểm soát. Toán học không có quan điểm về các danh xưng. ## Tải xuống các tài liệu Các video và tệp ZIP được lưu trữ trên [phishdestroy.io](https://phishdestroy.io/). Hãy chọn các tệp bạn muốn kiểm tra. Cả hai tệp ZIP đều chứa dữ liệu thử nghiệm đã chọn và tài liệu hướng dẫn. Công cụ chỉnh sửa, mã nguồn, cấu hình, thông tin đăng nhập và các phiên làm việc không được bao gồm trong đó. ### Trước / sau khi xuất khẩu Bảy cuộc hội thoại thử nghiệm: HTML, JSON, hình ảnh được nhúng và các tài nguyên của trình xem tiêu chuẩn. Bao gồm tệp danh sách nội dung và sổ ghi chép thay đổi đã chọn. [Xuất thử nghiệm · ZIP · 3,0 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-paired-files.zip) Không có video. Không có công cụ chỉnh sửa. ### Video + các tệp xuất thử nghiệm Bản ghi gốc đầy đủ, đoạn phim dài hai phút, các tệp xuất song song, phần giải thích, bản xem xét siêu dữ liệu, bản đồ chỉnh sửa và các tổng kiểm tra. [Video + tệp xuất thử nghiệm · ZIP · 46,9 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-review-package.zip) Chứa tệp ZIP có dung lượng nhỏ hơn. Không có công cụ chỉnh sửa. **Chính xác thì bên trong tệp ZIP 46,9 MB có những gì?** - `video/ExportClinic_2026-11-03_12-50-40.mkv` — bản ghi âm đầy đủ nguyên bản, 6:08,8. - `video/export-clinic-2min.mp4` — bản tóm tắt phim, 1:59,7. - `data/export-clinic-paired-files.zip` — giải nén tệp ZIP lồng nhau này để kiểm tra `before/` và `modified/` thư mục. - `description/article-en.md` — phần giải thích và các giới hạn. - `verification/` — bốn tệp JSON/Markdown liên quan đến việc chỉnh sửa bản đồ, kiểm tra siêu dữ liệu và rà soát gói. - `README.md` và `SHA256SUMS.txt` — đọc hướng dẫn và tổng kiểm tra tệp. Có mười tệp trong tệp ZIP bên ngoài. Tệp MP4 đầy đủ riêng biệt đã được loại bỏ vì tệp MKV gốc đã chứa toàn bộ bản ghi. Phần `js/script.js` bên trong mỗi cuộc trò chuyện đã xuất là tài nguyên trình xem HTML nguyên bản của Telegram. ### Các tệp video riêng lẻ - [Tệp MKV gốc · 6:08,8 · 29,6 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) — bản ghi nguồn giống hệt từng byte. - [Mở tệp MP4 đầy đủ · 6:08,8 · 29,9 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-full.mp4) — bản chuyển đổi định dạng tương thích với trình duyệt, không mã hóa lại video. - [Mở tệp MP4 nén · 1:59,7 · 14,3 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) — các thay đổi về tốc độ phát lại được ghi chú rõ ràng. [Tải xuống các giá trị kiểm tra tổng](https://phishdestroy.io/tgwitness/assets/export-clinic/SHA256SUMS.txt)[Bản đồ chỉnh sửa video](https://phishdestroy.io/tgwitness/assets/export-clinic/recording-manifest.json?v=42fbcde007f1)[Danh sách các tệp ghép đôi](https://phishdestroy.io/tgwitness/assets/export-clinic/review-file-manifest.json?v=c725b2ecbe50)[Kiểm tra siêu dữ liệu](https://phishdestroy.io/tgwitness/assets/export-clinic/original-metadata-notes.md)[Hướng dẫn giải thích và xác minh hiện hành](https://phishdestroy.io/tgwitness/assets/export-clinic/article-en.md) Tệp ZIP đánh giá có thể tải xuống vẫn giữ nguyên tệp README và bài viết gốc. Phần giải thích hiện tại bao gồm hướng dẫn thu thập và xác minh TgWitness. **Cách thức tái tạo trạng thái “trước khi thay đổi”:** đây là cấu trúc thư mục trước khi thay đổi đã được tái tạo. Các tệp đã thay đổi được khôi phục từng byte một từ các bản sao lưu còn lưu giữ và được đối chiếu với các giá trị băm đã ghi lại. Các tài nguyên trình xem không thay đổi được sao chép từ bản xuất đã được ghi lại. Danh sách tệp ghi lại các phiên bản được cung cấp. Trong bảy cuộc trò chuyện này, có tổng cộng 45 bản ghi tin nhắn; có 17 bản ghi và 32 tệp tin khác nhau. Mỗi phiên bản chứa 340 tệp tin. Các tệp đính kèm định dạng PDF không được chọn trong các bản xuất đã ghi lại và do đó không có trong các kho lưu trữ này. ## Chi tiết thí nghiệm **Sự thay đổi đã diễn ra ở đâu?** Một công cụ hỗ trợ địa phương đã sửa đổi các tệp do Telegram Desktop tạo ra. Tệp thực thi của ứng dụng chính thức và các cuộc trò chuyện hiển thị trong Telegram vẫn không thay đổi. Kết quả so sánh cho thấy các tin nhắn gốc được hiển thị bên cạnh bản xuất đã bị sửa đổi. **Đây có phải là các tệp xuất dữ liệu tài khoản đầy đủ không?** Không. Các tài liệu này bao gồm bảy cuộc trò chuyện thử nghiệm do hệ thống quản lý: một cuộc trò chuyện cá nhân, một bot, một nhóm riêng tư, các siêu nhóm riêng tư và công khai, cùng các kênh riêng tư và công khai. Chúng chứa 45 bản ghi tin nhắn. Không bao gồm các cuộc trò chuyện, danh bạ hoặc kho lưu trữ toàn tài khoản không liên quan. **Các tệp đính kèm PDF có được bao gồm không?** Không. Các thiết lập xuất đã ghi lại không bao gồm các tệp đính kèm. Các tin nhắn và hình ảnh thử nghiệm đề cập đến một tệp PDF, nhưng các tệp nén này không chứa tệp PDF đó. Sự khác biệt này được giữ nguyên trong các tệp và phần mô tả. **Gói sản phẩm có bao gồm công cụ sửa đổi không?** Không bao gồm bất kỳ tệp thực thi, mã nguồn hỗ trợ, cấu hình chuyển đổi, dữ liệu phiên, thông tin đăng nhập hay nhật ký hoạt động đầy đủ nào. Các tệp JavaScript nhỏ bên trong các tệp xuất được ghép đôi là các tài nguyên trình xem HTML tiêu chuẩn của Telegram chưa qua chỉnh sửa, đã được kiểm tra và xác nhận là giống hệt nhau trên cả hai phiên bản. **Làm thế nào để kiểm tra các tệp đã tải xuống?** Tính toán giá trị SHA-256 của từng tệp và so sánh với các tổng kiểm tra đã công bố. Các giá trị trùng khớp sẽ xác nhận rằng bạn đang sở hữu chính xác các byte đã được công bố. Danh sách tệp liệt kê cả hai phiên bản xuất; bản đồ chỉnh sửa video ghi lại phiên bản phim đã được rút gọn. Thời gian ghi được lấy từ đồng hồ của máy chủ. **TgWitness làm thế nào để đảm bảo tính minh bạch của hồ sơ?** Trình thu thập sẽ ký xác nhận các mục khi nhận được dữ liệu từ Telegram. Kho lưu trữ bao gồm nhật ký, các giá trị băm tệp và dữ liệu xác minh. Lưu giữ dấu vân tay khóa và điểm kiểm tra riêng biệt, sau đó đối chiếu bản sao của người nhận với các thông tin này. Tính năng ghi lại trên GitHub bổ sung việc xác minh quy trình thu thập đã được phê duyệt và kết quả đầu ra của quy trình đó. [Thực hiện theo các bước xác minh ↗](https://phishdestroy.io/tgwitness/vi/docs/exports/) Bảy cuộc hội thoại này đã được chuẩn bị cho thí nghiệm này. Bản ghi âm, các tệp xuất tương ứng và sổ cái thay đổi ghi lại các thay đổi đối với tệp cục bộ như đã mô tả ở trên. Thí nghiệm có kiểm soát với tệp cục bộ · Ngày 3 tháng 11 năm 2026 Đã sao chép toàn bộ SHA-256 --- # 56 329 tin nhắn. Canonical page: https://phishdestroy.io/tgwitness/vi/docs/validation/ 56.329 tin nhắn Telegram đã được xuất trong hai lần thử nghiệm có đo lường. So sánh số lượng tin nhắn, tốc độ thu thập, thời gian xuất và các tệp lưu trữ đã ký. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) TGWITNESS / XUẤT KHẨU THỰC TẾ Đã ghi lại. Đã xuất. Hai tệp xuất từ Telegram mới, ghi lại thời gian từ khi thu thập dữ liệu cho đến khi hoàn thành tệp lưu trữ. Khám phá không gian làm việc, xem xét các số liệu và tải xuống một mẫu. [Khám phá bản demo](https://phishdestroy.github.io/TgWitness/demo/?lang=en)[Tải xuống mẫu xuất dữ liệu](https://phishdestroy.github.io/TgWitness/demo/downloads/tgwitness-demo.zip) Bản demo tương tác và ví dụ sử dụng các tin nhắn hư cấu. Các số liệu dưới đây được lấy từ các đợt xuất khẩu thực tế. TGW / 001 Ảnh chụp màn hình đã ghi lại · không phải giám sát trực tiếp Đã kiểm tra tại 2026-11-06 18:37:38 UTC Bản sửa đổi đã được kiểm tra [92e539af](https://github.com/phishdestroy/TgWitness/commit/92e539af40d8368d198ff5e040f1d876f2c1310e) Văn bản + siêu dữ liệu · các tài liệu lưu trữ có chữ ký **56 329**Các tin nhắn đã xuất **160.531**Tin nhắn/giây · lượt chạy thu thập tốt nhất **2**Các đợt xuất khẩu đã ký kết **3**Các máy chủ đã được kiểm tra Máy chủ AWARP · 2 tài khoản **27 030**Các tin nhắn đã xuất **142.983**tin nhắn/giây Chỉ nhận hàng trực tiếp 189.043 s Xuất toàn bộ 211.647 s Máy chủ BWARP · 2 tài khoản **29 299**Các tin nhắn đã xuất **160.531**tin nhắn/giây Chỉ nhận hàng trực tiếp 182.513 s Xuất toàn bộ 206.650 s 01 / ## Dựa trên số liệu xuất khẩu thực tế. Mỗi máy chủ thực hiện một lần xuất mới, sử dụng hai tài khoản trên mỗi máy chủ. Văn bản và siêu dữ liệu được truyền qua WARP; không bao gồm tệp đính kèm. tin nhắn/giây Máy chủ A**142.983 tin nhắn/giây** Máy chủ B**160.531 tin nhắn/giây** Máy chủ C Chưa được đo lường — Số tin nhắn ÷ thời gian thu thập. Các công đoạn chuẩn bị, lựa chọn và đóng gói không nằm trong khoảng thời gian này. Số tin nhắn ÷ tổng thời gian xuất khẩu được đo lường, bao gồm cả thời gian chuẩn bị và đóng gói. Không có biên lai xác nhận điểm chuẩn thu thập dữ liệu cho máy chủ C. Không có bản ghi nào bị tái sử dụng hay ID trùng lặp trong cả hai lần chạy. Máy chủ A cũng có một tác vụ đọc nguồn được bảo vệ đang chạy ngầm. Các khoảng dừng FloodWait đã được tuân thủ: A · 4, B · 3. **Các số đo chính xác và mã băm lưu trữ** | Máy chủ | Tin nhắn | Chỉ nhận hàng trực tiếp | Xuất toàn bộ | | --- | --- | --- | --- | | Máy chủ A | 27 030 | 189.043 s **142.983 tin nhắn/giây** | 211.647 s **127.713 tin nhắn/giây** | | 2026-11-06T18:26:51.500Z → 2026-11-06T18:30:23.228Z SHA-256 `20e507fc68446680ed002fd486d0968a944ec0c71e02f937331ae2b19ab4cd66` | | | | | Máy chủ B | 29 299 | 182.513 s **160.531 tin nhắn/giây** | 206.650 s **141.781 tin nhắn/giây** | | 2026-11-06T18:25:40.419Z → 2026-11-06T18:29:07.173Z SHA-256 `824601b502762efaabb8ff9afdb1e8d7fff189862ef2cbc4d8d26d0d68c83e4c` | | | | Cả hai kho lưu trữ đều đã vượt qua quá trình xác minh bằng khóa thu thập được ghim. 02 / ## Cả ba điều này, với phạm vi được nêu rõ. Tính toàn vẹn của nhật ký, quyền truy cập tệp, dung lượng lưu trữ, các tuyến mạng và các tiến trình đang chạy đã được kiểm tra trên từng máy chủ. A Đã kiểm tra ### Máy chủ A Thu thập và xuất khẩu 8 vCPU · 16 GiB · Ubuntu 24.04 Các tạp chí đã được kiểm tra 21 Các sự kiện trên tạp chí 4 517 Các trạm kiểm soát 147 Thực hiện đánh giá hiệu chuẩn bộ dữ liệu mới, xác minh kho lưu trữ và kiểm tra tính toàn vẹn của bản sao lưu. B Đã kiểm tra ### Máy chủ B Thu thập và xuất khẩu 8 vCPU · 16 GiB · Ubuntu 24.04 Các tạp chí đã được kiểm tra 21 Các sự kiện trên tạp chí 1 993 Các trạm kiểm soát 147 Thực hiện đánh giá hiệu chuẩn bộ dữ liệu mới, xác minh kho lưu trữ và kiểm tra tính toàn vẹn của bản sao lưu. C Đã kiểm tra ### Máy chủ C Bảng điều khiển và máy ảo lồng nhau 8 vCPU · 32 GiB · Ubuntu 24.04 Các tạp chí đã được kiểm tra 14 Các sự kiện trên tạp chí 7 185 Các trạm kiểm soát 973 Đã kiểm tra xác thực bảng điều khiển, liên kết vòng lặp và máy ảo lồng nhau. Không có điểm chuẩn thu thập dữ liệu trên máy chủ này. **Kết quả thử nghiệm, phạm vi và ghi chú kỹ thuật** 03 / ## Các đường chuyền và khoảng trống, song song với nhau. Kết quả mới nhất theo từng trường hợp pytest, bao gồm cả các lần chạy lại. Các bộ kiểm thử trên trình duyệt độc lập và bộ kiểm thử bằng chứng được tính riêng biệt dưới đây; chúng không được cộng vào tổng số của pytest. **1 585**Đã đỗ **3**Không thành công **37**Bỏ qua Ba bài kiểm tra trình duyệt ghi lại dữ liệu cần có môi trường cách ly Chromium, mà các container này không cung cấp; do đó, môi trường cách ly vẫn được bật. 37 trường hợp bỏ qua nền tảng được tính riêng biệt với các trường hợp vượt qua. - Bộ trình duyệt**102 đã thông qua** - Bộ giao diện**66 đã thông qua** - Bộ bằng chứng**15 đã thông qua** - Bộ giải pháp trang web**9 đã thông qua** - Các phòng suite khác**13 đã thông qua** 04 / ## Phạm vi của bản tóm tắt này. 1. 01 ### Môi trường cách ly trình duyệt Ba bài kiểm tra trình duyệt đang chờ một môi trường có hộp cát Chromium. 2. 02 ### Thời gian sao lưu gần đây nhất 42 nhật ký sao lưu và 51.285 tệp đã vượt qua kiểm tra tính toàn vẹn. Tại thời điểm chụp nhanh, bản sao lưu mới nhất còn thiếu 3.507 sự kiện so với dữ liệu thu thập trực tiếp. 3. 03 ### Phạm vi phủ sóng mạng 24 trong số 40 tuyến đường đã đáp ứng điều kiện. 16 tài khoản còn lại vẫn ở trạng thái ngắt kết nối thay vì chuyển sang kết nối trực tiếp. 4. 04 ### Thời gian độc lập Nhật ký chứng nhân được lưu giữ đã vượt qua các kiểm tra tính toàn vẹn. Sự kiện gần nhất của nó diễn ra vào lúc 07:27 UTC ngày 6 tháng 11. 5. 05 ### Các biện pháp kiểm soát an ninh Các biện pháp bảo vệ khóa, bảo vệ tài khoản, lưu trữ lâu dài và kiểm soát việc giải phóng dữ liệu được mô tả trong mô hình bảo mật; các kết quả kiểm toán được công bố trong báo cáo đã được ký tên. 6. 06 ### Các máy chủ đã được kiểm tra Ba máy chủ đã được kiểm tra là nội dung chính của trang này. 7. 07 ### Khối lượng công việc được đo lường Hai nguồn công khai, hai lần chạy riêng biệt, dữ liệu văn bản và siêu dữ liệu mà không tải xuống tệp đính kèm. Máy chủ C hoạt động mà không có số liệu đo lường tốc độ thu thập dữ liệu. Mỗi số liệu áp dụng cho khối lượng công việc được ghi nhận tương ứng. 05 / ## Một bản ghi đã cũ, với nguồn gốc từ những con số. Các số liệu do nhóm quản trị thu thập, được ký bằng khóa kiểm toán. Tệp JSON chỉ chứa dữ liệu tổng hợp. Thông tin nguồn và danh tính tài khoản, nội dung tin nhắn, thông tin xác thực và kho lưu trữ riêng tư không được công bố. 1. Ghim phiên bản nguồn và xác minh phiên bản đã cài đặt. 2. Tập hợp vào một không gian làm việc mới, không giữ lại bất kỳ bản ghi nào đã được tái sử dụng. 3. Đo lường khoảng thời gian thu thập và khoảng thời gian xuất toàn bộ dữ liệu một cách riêng biệt. 4. Kiểm tra tính toàn vẹn của tệp lưu trữ dựa trên khóa đã ghim; lưu lại giá trị băm SHA-256 của tệp đó. Phiên bản đã được kiểm thử `92e539af40d8-83e41104669e` [Tải xuống dữ liệu ↓](https://phishdestroy.io/tgwitness/validation/snapshot.json?v=4fcf5cecaf21) SIGNED AUDIT / ENGLISH ### Check the numbers. The English report includes the measured results, open findings and a reproducible signature check. [Read the report ↗](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)[Signed statement ↓](https://phishdestroy.io/tgwitness/validation/audit/PROOF.json?v=5b89c774b601)[Measurements CSV ↓](https://phishdestroy.github.io/TgWitness/validation/audit/MEASUREMENTS.csv)[Python verifier ↓](https://phishdestroy.github.io/TgWitness/validation/audit/VERIFY.py)[File checksums ↓](https://phishdestroy.io/tgwitness/validation/audit/SHA256SUMS.txt) The signature binds the report and its measurements to the audit key; a change to any signed file fails VERIFY.py. The report records the completed audit at 19:08 UTC; the infrastructure snapshot above was taken earlier. **Tóm tắt biên lai nguồn** Các giá trị băm này dùng để xác định các biên lai đã ký và được lưu giữ của các kết quả đo; các bản gốc riêng tư được các nhà quản trị lưu giữ. - benchmark-1.json`66cdf2db25901ee1f780a0e2d14b9b84888dbe525bff73bae19819b217f95d0c` - benchmark-2.json`ad2978fe2a7563476da43293eaaf5f498ee12522f0ea3e401bc43205c64874d1` - test-totals.json`922cf87d9320b149f2fc6791fc05f98335ec0952f9258e6eaeff179aeef33bb1` - infra-summary.json`325d390ef752b15f44203f97348863e24f0f631fe88998d5e1f398a5311a9339` Mỗi biểu đồ đều ghi rõ phiên bản, khối lượng công việc và môi trường tương ứng. Các chỉ số chưa được đo lường sẽ được hiển thị là “thiếu”. --- # TgWitness: Telegram Export, OSINT & Verification Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/ Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/llms.txt) Cài đặt bằng một lệnh hoặc thực hiện trên GitHub Actions. Nắm rõ các tùy chọn điều tra, phạm vi đã công bố và những gì mà kho lưu trữ xác minh. TgWitness là một công cụ xuất dữ liệu Telegram mã nguồn mở và không gian làm việc điều tra. Cài đặt nó chỉ với một lệnh, kết nối tài khoản, chọn các cuộc trò chuyện và xuất một tệp lưu trữ đã được ký. Nó cũng hỗ trợ thu thập dữ liệu tạm thời trên GitHub Actions và tiếp tục các cuộc điều tra với các chỉnh sửa đã lưu, ghi nhận việc xóa, tìm kiếm và báo cáo. ## Bắt đầu với nhiệm vụ bạn đang có | Nhiệm vụ của bạn | Đường đi ngắn nhất | Những gì bạn sẽ nhận được | | --- | --- | --- | | Lưu cuộc trò chuyện hoặc tài khoản | Cài đặt, kết nối tài khoản, chọn phạm vi xuất dữ liệu | Một tệp lưu trữ đã được ký số chứa lịch sử đã chọn, kết quả thu thập và tài liệu xác minh | | Thu thập trên một trình chạy tạm thời | Sử dụng GitHub Actions để thu thập dữ liệu, ủy quyền cho một phiên mới và chọn phạm vi | Một tệp lưu trữ được mã hóa kèm theo nguồn gốc quy trình làm việc trên GitHub | | Theo dõi các thay đổi theo thời gian | Tiếp tục quá trình quan sát đối với các cuộc trò chuyện đã chọn | Các phiên bản đã lưu, thông báo xóa, tệp đính kèm và phạm vi ghi lại | | Nghiên cứu và chia sẻ kết quả | Tìm kiếm trong kho lưu trữ, sử dụng Bảng trường hợp và cấu hình báo cáo hoặc bản sao để chia sẻ | Các phát hiện có liên kết đến nguồn và quy trình chuyển giao có thể xác minh, phù hợp với người nhận | ### Cài đặt bằng một lệnh duy nhất Trình cài đặt bao gồm Python và các phụ thuộc. Việc tải mã nguồn, Docker, nhà cung cấp AI và nhân chứng độc lập là các tùy chọn, không phải là điều kiện tiên quyết để cài đặt. Linux / macOS: ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Windows, trong PowerShell hoặc Command Prompt: ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Mở bảng điều khiển, kết nối tài khoản Telegram của bạn và chọn phạm vi thu thập. Quá trình cài đặt không tự động bắt đầu thu thập dữ liệu. Hướng dẫn cài đặt giải thích về truy cập cục bộ, máy chủ, cập nhật và kiểm tra bản dựng đã tải xuống. Để sử dụng trình chạy tạm thời, hãy làm theo hướng dẫn [Github Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). Quy trình này yêu cầu một bản fork trên GitHub, quyền truy cập và mật khẩu tệp lưu trữ. Trang hướng dẫn capture giải thích các bước này cùng với thời gian phiên được phân bổ trước khi chạy. Tải xuống và lưu giữ tệp lưu trữ kết quả cùng tài liệu xác minh của nó. ## Các thiết lập bổ sung khi nhiệm vụ yêu cầu Việc xuất dữ liệu từ một cuộc trò chuyện duy nhất yêu cầu có tài khoản và phạm vi được chọn. Quan sát liên tục, nhiều tài khoản, máy chủ proxy, chính sách tệp đính kèm, thiết kế báo cáo, quyền truy cập của người đánh giá, dấu thời gian bên ngoài và lưu trữ ngoài trang web phục vụ các yêu cầu điều tra và chuyển giao khác nhau. Cấu hình các tính năng này khi chúng có liên quan. Phạm vi, quyền truy cập và các bản sao chia sẻ được tối ưu hóa giúp người vận hành lựa chọn những gì cần thu thập và tiết lộ. Hướng dẫn về thẩm quyền và cài đặt báo cáo ghi lại quy trình đã chọn và các bước chuẩn bị. Xem [xuất tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/account-export/), [quyền truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/access/) và [cấu hình báo cáo](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/). Ứng dụng chạy trên máy tính hoặc máy chủ đã chọn. Việc thu thập cơ bản không yêu cầu GPU hoặc mô hình ngôn ngữ lớn (LLM). Các tính năng tùy chọn như OCR, chuyển đổi văn bản và phân tích AI có yêu cầu tài nguyên riêng. Cân đối quy mô triển khai dựa trên tốc độ tin nhắn, tệp đính kèm, lịch sử lưu trữ và số lượng tài khoản đồng thời. ## Giữ nguyên bản ghi, dù nó có giúp ích cho ai đi chăng nữa Mục đích là bảo tồn tài liệu quan sát, bối cảnh và các thay đổi bất kể chúng ủng hộ quan điểm của ai. Bằng chứng có thể thách thức chính bản tường trình của bộ thu thập về các sự kiện. Giữ cho các quan sát nguồn, phạm vi chưa được bao phủ và kết luận phân tích có thể nhận diện được để người khác có thể đánh giá cùng một tài liệu. Quy trình như sau: quan sát hiển thị trên tài khoản → nhật ký có chữ ký → xuất → xác minh của người nhận. Các chỉnh sửa được lưu sẽ tạo ra các phiên bản mới. Các quan sát bị xóa vẫn giữ lại nội dung đã được ghi lại trước đó. Hồ sơ phạm vi bao phủ cho thấy các sự gián đoạn đã biết. Các báo cáo và phân tích AI tham chiếu trở lại các nguồn đã lưu; một cách diễn giải không trở thành một quan sát nguồn chỉ vì nó xuất hiện trong một báo cáo có chữ ký. | Kiểm tra xác minh | Những gì người nhận có thể xác định | | --- | --- | | Hashes tệp, chữ ký và chuỗi nhật ký | Các bản ghi và tệp được cung cấp phù hợp với khóa dự kiến và ranh giới nhật ký | | Một điểm kiểm tra hoặc chứng cứ được lưu giữ riêng biệt | Tập tin lưu trữ này khớp với trạng thái nhật ký đã được lưu giữ trước đó | | Dấu thời gian bên ngoài đã được xác minh | Các byte được tham chiếu tồn tại tại thời điểm được ghi nhận theo các giả định tin cậy đã nêu | | Chứng nhận ghi lại trên GitHub | Tập tin lưu trữ phù hợp với quy trình làm việc đã được phê duyệt, phiên bản trình thu thập và bản tóm tắt đã ghi lại | | Chứng thực Intel TDX | Trích dẫn, trạng thái nền tảng, các chỉ số dự kiến của hệ điều hành/ứng dụng, độ mới và danh tính bộ thu thập đều vượt qua các kiểm tra đã được cấu hình | Trong quá trình thu thập được chứng thực, kết nối Telegram đã được xác thực của bộ thu thập được phê duyệt và đầu ra được liên kết với môi trường thực thi đã được kiểm tra. Kho lưu trữ giữ lại nội dung và bối cảnh đã thu thập; các báo cáo và phân tích tham chiếu trở lại các bản ghi đó. Sử dụng các bước xác minh cụ thể theo chế độ và các đầu vào đáng tin cậy trong [hướng dẫn tin cậy](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) và [định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/). ## Quy mô đã công bố và hiệu suất đo được Các kết quả sau đây mô tả các khối lượng công việc và ngày tháng khác nhau. Số lượng không thể hoán đổi cho nhau: một sự kiện nhật ký không nhất thiết là một tin nhắn Telegram duy nhất. | Ngày | Khối lượng công việc | Kết quả đã công bố | Những gì đã được đo lường | | --- | --- | --- | --- | | 1 tháng 1 năm 2026 | Máy chủ đang chạy, mười cơ sở dữ liệu không gian làm việc | 1,610,818: bản ghi nhật ký; 900,232: sự kiện tin nhắn mới; 80,683: sự kiện chỉnh sửa; và 400,536: sự kiện xóa | Danh mục chỉ đọc của các nhật ký được lưu trữ | | 5 tháng 11 năm 2026 | Tìm kiếm trong các tin nhắn tổng hợp 1,000,000 trong các cuộc trò chuyện 200 | Chỉ mục được xây dựng trong 71 giây; thời gian tìm kiếm trung vị cho mỗi truy vấn là 9–190 ms | Tiêu chuẩn đánh giá tìm kiếm cục bộ | | Ngày 6 tháng 11 năm 2026 | Hai tệp xuất dữ liệu Telegram mới nhất | Tin nhắn 27,030 và 29,299; 56,329 trong cả hai lần chạy | Mỗi lần chạy qua WARP chỉ bao gồm hai tài khoản, bao gồm văn bản và siêu dữ liệu, không tải xuống tệp đính kèm | | Ngày 6 tháng 11 năm 2026 | Hai tệp xuất giống nhau, bao gồm cả quá trình chuẩn bị và đóng gói | 127.713 và 141.781 tin nhắn/giây | Tỷ lệ xuất dữ liệu hoàn chỉnh đã được đo lường; cả hai kho lưu trữ đều đã được xác minh bằng các khóa được ghim | Bản [ghi xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/) cung cấp danh mục máy chủ, kiểm tra thu thập thời gian thực và số liệu tìm kiếm. Báo cáo [hiệu suất xuất](https://phishdestroy.io/tgwitness/docs/validation/) ra hai lần chạy thực tế, phần cứng, thời lượng, băm lưu trữ và tệp số liệu đã ký, mỗi tệp kèm theo phiên bản và điều kiện ghi lại. [Chứng nhận lịch sử công khai](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) cũng ghi nhận **48 kho lưu trữ đã được xác minh với 3,598,381 bản ghi** trên danh sách đầu vào gồm 50 nguồn và 40 không gian làm việc tài khoản. Nguồn A với tám tài khoản đã thu thập được **768,007 bản ghi lịch sử trong 1,117.082 giây**, bao gồm thời gian chờ: **687.512 bản ghi/giây**, với tính năng tải xuống tệp đính kèm bị vô hiệu hóa. Toàn bộ quá trình thử nghiệm, bao gồm cả việc xác thực, mất 1,574.920 giây. Các số liệu này mô tả khối lượng công việc đó, cùng với các ví dụ xuất dữ liệu mới có quy mô nhỏ hơn ở trên. ### Lịch sử và thời gian thử nghiệm TgWitness đã được phát triển và thử nghiệm trong khoảng sáu tháng. Bộ thu thập, nhật ký có chữ ký và bộ xác minh được phát triển trước tiên; bảng điều khiển web và các mô-đun bổ sung được xây dựng dựa trên chúng sau đó. Kho lưu trữ này được tạo mới vào ngày 29 tháng 10 năm 2026 nhằm mục đích công bố và bắt đầu từ mã nguồn hiện có, do đó tuổi của kho lưu trữ này không phải là tuổi của dự án ([lịch sử phát triển](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)). Tổng khối lượng công việc đã thực hiện vào khoảng 100 triệu, bao gồm các lần chạy trước đó, các sự cố, các bản sửa lỗi và quá trình xác thực lặp lại. Các lần chạy được lựa chọn, mỗi lần có phiên bản, phương pháp và kết quả riêng, được ghi chép trong các [báo cáo đo lường công khai có ghi ngày tháng](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements). ## Đọc chính xác trạng thái khả năng Đánh giá từng quy trình làm việc dựa trên việc triển khai, bản dựng đã công bố và các bài kiểm tra đã ghi lại . Nguồn hiện được gắn nhãn là bản xem trước. Nhãn phát hành đó tồn tại song song với bộ sưu tập đang hoạt động, các bản xuất, xác minh độc lập và các phép đo quy mô đã công bố. Một tính năng xem trước và một quy trình làm việc đã được xác thực có thể tồn tại trong cùng một ứng dụng; hãy mô tả tính năng cụ thể và bằng chứng đằng sau mỗi đánh giá. Sử dụng [khả năng hiện tại](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [tính năng và giới hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/features/), [xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/) và [nhật ký thay đổi](https://phishdestroy.io/tgwitness/vi/docs/reference/changelog/) cùng nhau. Ghi lại phiên bản đã được kiểm thử khi trích dẫn kết quả. Bản 6 Bản chụp nhanh đo lường tháng 11 cũng lưu giữ các bài kiểm tra thất bại và bị bỏ qua; những bài kiểm tra đó không được coi là đã vượt qua. ## Dễ đọc cho cả con người và các công cụ AI Trang web cung cấp bản tóm tắt `llms.txt`, cẩm nang tiếng Anh đầy đủ ở `llms-full.txt` và `llms-full.md`, cùng các phiên bản Markdown của các trang. Đây là các định dạng tài liệu, không phải yêu cầu của AI để chạy TgWitness. Tùy chọn [MCP](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/) và [(truy cập dòng lệnh)](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/) cho phép các công cụ được ủy quyền đọc các bản ghi đã lưu được chọn. Nội dung tin nhắn vẫn là đầu vào không đáng tin cậy. Các bản tóm tắt nên trích dẫn nguồn, phân biệt sự kiện quan sát được với suy luận và giữ nguyên mức độ không chắc chắn. Tìm kiếm toàn văn, OCR và kết quả đầu ra từ AI không thay đổi các quan sát đã ký ban đầu. --- # Telegram · Hướng dẫn bắt đầu nhanh Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/ Tất cả các phương thức cài đặt và khởi chạy TgWitness: gói phần mềm dành cho Windows, Python, Docker và bản demo tổng hợp, kèm theo các bước kiểm tra ban đầu. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Tất cả các phương thức cài đặt và khởi chạy TgWitness: gói phần mềm dành cho Windows, Python, Docker và bản demo tổng hợp, kèm theo các bước kiểm tra ban đầu. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Bắt đầu](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) **Tiếng Anh** · [Tiếng Nga](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [Tiếng Ukraina](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [Tiếng Tây Ban Nha](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [Tiếng Bồ Đào Nha (Brazil)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [Tiếng Thổ Nhĩ Kỳ](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [Tiếng Ả Rập](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [Tiếng Ba Tư](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [Tiếng Urdu](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [Tiếng Hindi](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [Tiếng Indonesia](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [Tiếng Trung giản thể](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md) TgWitness là một ứng dụng độc lập dùng để theo dõi các nhóm và kênh Telegram mà tài khoản của quý vị có quyền truy cập. Ứng dụng này chạy cục bộ với thư mục dữ liệu riêng. **Lần đầu truy cập?** [Hãy khám phá bản demo](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/#explore-the-interface) trước khi kết nối tài khoản. [Chọn hướng dẫn](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) về proxy, nhân chứng, xuất dữ liệu hoặc thiết lập máy chủ. [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) (bản xem trước) thực thi quá trình capture trong chi nhánh GitHub của riêng bạn thay vì cài đặt cục bộ. ## Cài đặt và bắt đầu Trình cài đặt có hướng dẫn đi kèm với Python riêng và kiểm tra băm gói cũng như chữ ký bản phát hành trước khi cài đặt. Chạy lại trình cài đặt này sẽ cập nhật bản cài đặt hiện có. **Linux / macOS:** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` **Windows (PowerShell hoặc Command Prompt):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Trên máy chủ Ubuntu, hãy chạy với quyền root để cài đặt dịch vụ chạy nền; trên máy tính để bàn, hãy chạy với tư cách người dùng thông thường. Trên Ubuntu, trình cài đặt sẽ hiển thị địa chỉ bảng điều khiển và khóa truy cập; trên macOS và Windows, bảng điều khiển cục bộ sẽ mở trong trình duyệt của bạn. Tiếp tục tại **phần Kết nối Telegram** bên dưới. [Phần Cài đặt, xác minh và cập nhật](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/) bao gồm các tùy chọn truy cập máy chủ, kiểm tra tập lệnh trước khi chạy, cập nhật và gỡ bỏ. ### Các phương pháp khác Các bản phát hành trên GitHub, mã nguồn và Docker là các lựa chọn thay thế cho trình cài đặt. Các bản tải xuống di động sẽ có sẵn sau khi bản dựng phát hành được công bố: | Máy chủ | Không cần cài đặt bất kỳ phần mềm nào | Từ nguồn: Python 3.11 trở lên | Docker: Engine/Desktop với Compose 2.20 trở lên | | --- | --- | --- | --- | | Windows | Trích xuất tệp `TgWitness--windows-amd64-portable.zip` từ GitHub Releases, nhấp đúp vào tệp `TgWitness.cmd` | Nhấp đúp vào `Start.cmd` | Nhấp đúp vào `scripts\Docker.cmd` | | Linux / macOS | — | `sh start.sh` | `sh scripts/docker-start.sh` | Đối với các phương pháp dùng mã nguồn, hãy [tải xuống và giải nén nhánh `main` hiện tại](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) hoặc sao chép (clone) kho lưu trữ: ``` git clone https://github.com/phishdestroy/TgWitness.git cd TgWitness ``` `Start.cmd` đề xuất cài đặt Python 3.12 cho người dùng Windows của bạn nếu không tìm thấy Python phù hợp (qua winget, hoặc trình cài đặt có chữ ký số từ python.org). `start.sh` sẽ in ra lệnh cài đặt chính xác cho bản phân phối Linux hoặc macOS của bạn nếu thiếu Python. Lần khởi chạy từ mã nguồn đầu tiên sẽ tự động tạo `.venv` và cài đặt các gói phụ thuộc. Docker sẽ biên dịch ứng dụng và khởi chạy nó ở chế độ nền; không cần phải cài đặt Python trên máy chủ. `scripts\Docker.cmd` và `scripts/docker-start.sh` sẽ hiển thị địa chỉ bảng điều khiển và mã thông báo khi container hoạt động bình thường. Các lệnh Docker tương ứng trên mọi hệ điều hành được hỗ trợ là: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Mở trang **http://127.0.0.1:8787**. Sử dụng mã thông báo được tạo bởi trình trợ giúp Docker hoặc lệnh Docker thứ hai, hoặc truy cập **tệp data/live/panel-token.txt** đối với bản cài đặt di động hoặc từ nguồn. Tiếp tục tại **phần “Kết nối Telegram”** bên dưới. Các bản cài đặt gốc và Docker sử dụng bộ nhớ lưu trữ riêng biệt; việc khởi động Docker sẽ không nhập nhật ký gốc hiện có. Đối với máy chủ, [quá trình triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) bao gồm kích hoạt HTTPS tự động, khởi động lại hệ thống, các hình ảnh được công bố, các bản cập nhật và sao lưu. ## Khám phá giao diện 1. Vui lòng chạy **tệp `TgWitness-Demo.cmd`** trong gói di động, tệp **`scripts\Demo.cmd`** trong thư mục nguồn của Windows hoặc tệp ``sh start.sh --demo` ` trên hệ điều hành Linux/macOS. Khi khởi chạy từ nguồn, hệ thống sẽ tự động tạo tệp ``.venv` ` và cài đặt các thành phần phụ thuộc. 2. Truy cập **http://127.0.0.1:8787**. 3. Bản demo cục bộ sẽ tự động mở sổ nhật ký mẫu. Không cần sao chép mã thông báo để truy cập trực tiếp tại địa phương. Các tin nhắn trong phần demo là hư cấu. Chế độ demo không thể kết nối với tài khoản Telegram thực tế. ## Kết nối với Telegram > [!CẢNH BÁO] **Sử dụng các tài khoản chuyên dụng.** Telegram có thể hạn chế hoặc cấm vĩnh viễn các tài khoản do lượng yêu cầu mà họ coi là quá mức, bất kể khách hàng là ai. Hãy kết nối các tài khoản được chuẩn bị sẵn cho việc quan sát thay vì các tài khoản cá nhân hoặc có giá trị, và tạo ID API / băm trên một tài khoản chuyên dụng. 1. Nếu bản demo gốc đang chạy, hãy dừng nó lại và chạy **tệp Start.cmd** hoặc `sh start.sh`. Nếu không, hãy tiếp tục chạy bản cài đặt trực tiếp đã được khởi động ở trên. 2. Sử dụng mã thông báo bảng điều khiển để đăng nhập. Một không gian làm việc mới sẽ mở ra [để thực hiện thiết lập ban đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/). Chọn **Chỉ tải xuống**, **Theo dõi các cuộc trò chuyện** hoặc **Bằng chứng cho một vụ việc**. 3. Kiểm tra lại kết nối. Cấu hình proxy của riêng bạn nếu cần; các cài đặt kết nối vẫn có sẵn sau khi thiết lập. 4. Tại **Connect Telegram**, hãy chọn số điện thoại, mã QR, tệp tài khoản (TData, `.session`, StringSession, tệp JSON tài khoản) hoặc một khóa ủy quyền hoàn chỉnh. Vui lòng hoàn tất xác nhận Telegram, nhập mã và mật khẩu xác thực hai bước khi được yêu cầu. 5. Kiểm tra tài khoản được hiển thị, chọn các cuộc trò chuyện và xem lại cài đặt của bạn. Hoàn tất từ màn hình cuối cùng. Đối với **tùy chọn Chỉ tải xuống**, **Bắt đầu xuất** sẽ khởi động quá trình xuất một lần và mở phần Xuất để hiển thị tiến trình; tùy chọn này không kích hoạt tính năng quan sát liên tục. Sau khi thiết lập, **mục Chats → Choose** sẽ thay đổi các cuộc trò chuyện đã chọn. **Cài đặt** điều khiển việc thu thập và tệp tin; **More tools → Sources** cung cấp danh sách nguồn chi tiết ở mức Standard hoặc Expert. [Hướng dẫn bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/) mô tả sáu phần chính và các điều khiển theo ngữ cảnh của chúng. **API ID + Hash** là tùy chọn: không gian làm việc sử dụng cặp đã lưu hoặc nhập sẵn, hoặc một cặp hoạt động từ nhóm tích hợp sẵn. Để sử dụng ứng dụng của riêng bạn, hãy dán một cặp `API ID:API Hash` vào trường API ID. Đối với **khóa xác thực (Auth key)**, hãy dán toàn bộ 512 ký tự thập lục phân và chọn DC ID được cung cấp. ID người dùng là tùy chọn và sẽ được kiểm tra nếu được nhập. Thông tin đăng nhập API dùng để xác định ứng dụng của quý vị; chúng không tự động cấp quyền truy cập cho tài khoản nào cả. Các nhóm riêng tư không yêu cầu tên người dùng công khai, nhưng tài khoản của quý vị phải có quyền truy cập. Đối với các tài khoản hiện có, hãy xem [các định dạng tài khoản và phiên](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/): bảng điều khiển hỗ trợ Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP cho một tài khoản duy nhất và định dạng JSON tài khoản được hỗ trợ. Chọn một phiên cùng với tệp JSON đi kèm, nhấn **Kiểm tra tệp**, sau đó **nhấn Kết nối tài khoản**. Đăng nhập qua mã QR cũng có sẵn với các cài đặt API tùy chọn tương tự. TDLib, phiên bot và danh sách tài khoản CSV/JSON không được hỗ trợ. Đối với nhiều tài khoản, hãy sử dụng **Tài khoản → Nhập tài khoản** và chọn các tệp phiên được hỗ trợ của chúng. Các tệp JSON đi kèm được ghép nối theo tên cơ sở (basename); mỗi tài khoản được nhập sẽ có không gian làm việc riêng. Xem [nhập hàng loạt và nhóm tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#bulk-import-and-account-groups). Để thêm một tài khoản khác, nhấn vào biểu tượng **+** bên cạnh trình chọn tài khoản hoặc sử dụng **Tài khoản → Thêm tài khoản**. Các không gian làm việc có các phiên, nhật ký, khóa, nguồn và hàng đợi riêng biệt. Việc chuyển đổi chế độ xem sẽ không làm gián đoạn hoạt động của các bộ thu khác. Cùng một tài khoản Telegram không thể được gán cho hai không gian làm việc trong cài đặt này. Không có số lượng cố định cho các không gian làm việc; chúng chia sẻ chung một tiến trình, do đó dung lượng phụ thuộc vào máy tính. Mã thông báo bảng điều khiển trực tiếp bảo vệ quyền truy cập vào các thông tin ủy quyền Telegram và tài liệu đã lưu trữ của quý vị; mã này tách biệt với thông tin đăng nhập API của Telegram. Chỉ bản demo cục bộ được khởi chạy rõ ràng và truy cập trực tiếp mới được cấp quyền truy cập tự động. Bản demo từ xa hoặc qua proxy vẫn sử dụng mã `data/demo/panel-token.txt`. ## Xem lại và xuất dữ liệu - **Sổ nhật ký:** tìm kiếm và lọc các ghi nhận theo nguồn và loại sự kiện. - Vui lòng chọn một sự kiện để xem bản ghi gốc, thông tin nguồn gốc và các phiên bản đã lưu của sự kiện đó. - Chi tiết chỉnh sửa hiển thị nội dung trước và sau khi chỉnh sửa (nếu có). Chi tiết xóa hiển thị nội dung được ghi lại lần cuối (nếu có); đối tượng không xác định vẫn được giữ nguyên trạng thái không xác định. - **Các định dạng xuất:** tệp ZIP có chữ ký, JSONL, CSV và HTML ngoại tuyến. - **Xuất toàn bộ cuộc trò chuyện** (**Chats → Export chat**, hoặc **Exports → Capture or export one chat**): tải xuống toàn bộ lịch sử hiển thị của một cuộc trò chuyện dưới dạng gói đã ký kèm tệp `chat.json` (theo phong cách xuất Telegram) và tệp `chat.html` có thể đọc được. Các cuộc trò chuyện riêng tư hoạt động khi tài khoản là thành viên. Đây là bản chụp nhanh hiện tại, không phải bản tái tạo các tin nhắn đã xóa hoặc đã chỉnh sửa trước đó. Xác minh bản sao bằng lệnh `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256`. - **Lưu điểm kiểm tra:** duy trì ranh giới của sổ nhật ký đã được ký số bên ngoài bộ thu thập dữ liệu. - **Tải xuống biên nhận thực thi có chữ ký:** lưu giữ bản ghi chương trình/phiên bản của bộ thu thập dữ liệu. - **Chuẩn bị yêu cầu dấu thời gian:** chuẩn bị một yêu cầu ngoại tuyến gửi đến cơ quan cấp dấu thời gian; thực hiện theo hướng dẫn trong [tệp TIMESTAMP.md](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/) để nhận và xác minh phản hồi. - **Xác minh nhật ký:** kiểm tra chữ ký sự kiện và các liên kết trong chuỗi. Tính năng xuất dưới dạng ZIP cũng kiểm tra các tệp phương tiện. Các trình duyệt được hỗ trợ có thể lưu trực tiếp các tệp xuất có dung lượng lớn vào tệp đã chọn. Các trình duyệt khác chỉ có thể lưu tạm tối đa 128 MiB. Trong khi máy chủ đang hoạt động, giao diện dòng lệnh (CLI) truyền trực tiếp hỗ trợ tải xuống các tệp có dung lượng lớn hơn mà không cần lưu tạm toàn bộ phản hồi: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Đối với không gian làm việc khác, thêm `--profile ID` bằng cách sử dụng **Exports → Workspace ID**. Đối với máy chủ từ xa, thêm `--url https://your-server`. Giới hạn truyền tải mặc định là 5 GiB; `--max-mib` thay đổi giới hạn này. Nội dung ZIP đã ký có giới hạn xác minh riêng là 4 GiB khi giải nén theo mặc định (**More tools → Parameters** cho phép tăng giới hạn này; xác minh các tệp lưu trữ này bằng `verify.py --max-gib N`). Xác minh tệp lưu trữ bằng cách sử dụng bản sao đáng tin cậy của công cụ xác minh, dấu vân tay khóa được lưu giữ độc lập và, để đảm bảo bằng chứng tối thiểu, chứng chỉ gốc của cơ quan cấp dấu thời gian (`--tsa-ca`). ## Xem hướng dẫn cài đặt ``` python start.py --setup-only python start.py --check python start.py --check --json ``` `--check` kiểm tra các phụ thuộc cục bộ, hỗ trợ ký số, bộ nhớ lưu trữ, cấu hình khóa và địa chỉ lắng nghe. Công cụ này không cài đặt bất kỳ thành phần nào cũng như không kết nối với Telegram. Nếu cổng đang bận, điều này có thể cho thấy một phiên bản khác đang chạy. Vui lòng sử dụng `--port` khác hoặc dừng phiên bản hiện tại trước. Trình khởi chạy sẽ được cài đặt vào thư mục `.venv`. Các lệnh phụ trợ `python -m tgwitness...` phải sử dụng `.venv\Scripts\python.exe` trên Windows hoặc `.venv/bin/python` trên Linux/macOS, trừ khi môi trường đó đã được kích hoạt sẵn. ## Các phiên làm việc, biện pháp bảo vệ và quy trình vận hành Một tệp `.session` của Telethon SQLite đóng và nhất quán có thể được chuyển đổi cục bộ bằng lệnh `python -m tgwitness.sessions account.session --out account.tgwitness-session`, sau đó tải lên tại **Công cụ khác → Tài khoản → Tệp**. Tính năng nhập tệp trực tiếp và đăng nhập qua mã QR cũng có sẵn. Xem [tệp CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/) để biết các định dạng đăng nhập, SOCKS5, HTTP CONNECT, MTProxy và khóa chính bên ngoài. **Tạm dừng quan sát** sẽ ngừng quá trình thu thập. **Chế độ Khóa** chỉ chặn quyền truy cập trình duyệt. Đóng tab sẽ không làm dừng quá trình thu thập. Việc dừng quá trình này mới thực sự ngắt quá trình thu thập; bản chụp lịch sử không thể tái tạo lại toàn bộ các thao tác chỉnh sửa hoặc xóa đã bỏ lỡ. Xem [cách thức hoạt động của quá trình thu thập](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/) đối với các chính sách sự kiện, hàng đợi tệp đính kèm, cách ly tài khoản và hành vi khởi động lại. Các phiên và thông tin bí mật được mã hóa. Nội dung tin nhắn, phương tiện truyền thông và các tệp xuất ra yêu cầu một đĩa hoặc khối lượng dữ liệu được mã hóa. Xác minh chữ ký nhật ký so với một khóa đáng tin cậy và lưu trữ các điểm kiểm tra riêng biệt. Xem xét các bản ghi thu thập, biên nhận thời gian bên ngoài và chứng nhận môi trường cho chế độ thu thập đã chọn. Vui lòng tham khảo [tệp OPERATIONS.md](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/) để biết thông tin về sao lưu/khôi phục, [tệp DEPLOYMENT.md](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) về việc triển khai máy chủ, và [thư mục deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) để xem các ví dụ về dịch vụ. Bảng điều khiển đã cài đặt cũng bao gồm hướng dẫn thiết lập ngoại tuyến tại `/guide.html`. Quá trình xác minh thực tế và các giới hạn hiện còn tồn tại được ghi chép trong [các tệp VERIFICATION.md](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/) và [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md). --- # Cài đặt, xác minh và cập nhật Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/installation/ Cài đặt chỉ với một lệnh, kiểm tra chữ ký và mã băm, cập nhật và gỡ bỏ cài đặt. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Cài đặt chỉ với một lệnh, kiểm tra chữ ký và mã băm, cập nhật và gỡ bỏ cài đặt. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bắt đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/) ![Bắt đầu](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Dự án](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [Hướng dẫn nhanh](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/) · [Triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) **Trên trang này** - [Cài đặt bằng một lệnh](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#install-with-one-command) - [Nơi mọi thứ diễn ra](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#where-everything-runs) - [Cài đặt tìm kiếm toàn văn](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#full-text-search-settings) - [Truy cập qua dòng lệnh](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#command-line-access) - [Xác minh trước khi chạy](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#verify-before-running) - [Cập nhật bản cài đặt hiện có](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#update-an-existing-installation) - [Các lệnh thường dùng trên Ubuntu](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#everyday-commands-on-ubuntu) - [Xóa TgWitness](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#remove-tgwitness) ## Cài đặt chỉ với một lệnh Dịch vụ tải xuống chính thức của dự án, `get.destroy.tools`, cung cấp trình cài đặt có hướng dẫn và các tệp phát hành đã được ký. Dịch vụ này bao gồm một môi trường chạy Python riêng tư và kiểm tra băm gói phần mềm cũng như chữ ký phát hành trước khi cài đặt. Mỗi bản phát hành cập nhật đồng thời các tập lệnh khởi chạy, băm, chữ ký và thông tin xây dựng; mỗi bản xây dựng cũng có một URL phát hành không thể thay đổi. Chọn trình cài đặt có hướng dẫn để thiết lập nhanh, hoặc sử dụng [các bản phát hành trên GitHub, mã nguồn hoặc Docker](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/) . Đây là các đường dẫn cài đặt được hỗ trợ cho cùng một dự án mã nguồn mở. Đối với việc triển khai yêu cầu phê duyệt một bản dựng chính xác trước khi thực thi, hãy sử dụng [tùy chọn Xác minh trước khi chạy](https://phishdestroy.io/tgwitness/vi/docs/reference/installation/#verify-before-running) với dấu vân tay khóa phát hành được lưu giữ độc lập và URL bất biến của bản dựng. Việc cập nhật dịch vụ tải xuống sẽ không tự động cập nhật bảng điều khiển đã cài đặt. **Linux / macOS (Bash):** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Trên máy chủ Ubuntu, hãy chạy với quyền root để cài đặt dịch vụ chạy nền. Trên máy tính để bàn, hãy chạy với tư cách người dùng thông thường. **Windows (PowerShell hoặc Command Prompt):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Không cần quyền quản trị viên trên Windows. Quy trình con PowerShell sẽ giữ cho cửa sổ terminal của bạn mở với kết quả hiển thị. Python và các phụ thuộc được giữ lại trong thư mục cài đặt. Trên Ubuntu, hãy chọn **"Máy tính này**", **"Liên kết HTTPS tạm thời**" hoặc **"Miền riêng**". Trình cài đặt sẽ hiển thị địa chỉ bảng điều khiển và khóa truy cập. Đối với liên kết tạm thời, hãy mở địa chỉ HTTPS đó trong trình duyệt của bạn và nhập khóa. Với quyền truy cập cục bộ trên máy chủ từ xa, hãy sử dụng chuyển tiếp SSH từ máy tính của bạn (`ssh -L 8787:127.0.0.1:8787 user@server`) và mở `http://127.0.0.1:8787`. Trên macOS và Windows, bảng điều khiển cục bộ sẽ mở trong trình duyệt của bạn; hãy giữ cho cửa sổ terminal của nó tiếp tục chạy. Đăng nhập vào Telegram trong bảng điều khiển và chọn những nội dung cần thu thập. Chỉ cài đặt thôi thì chưa đủ để bắt đầu thu thập dữ liệu từ Telegram. ## Nơi mọi thứ hoạt động `get.destroy.tools` là một **Cloudflare Worker phục vụ các tệp tải xuống tĩnh**. Nó không có bảng TgWitness, phiên Telegram hoặc cơ sở dữ liệu bằng chứng người dùng. Nó không được định tuyến đến một máy chủ ảo (VPS) của dự án. Ứng dụng chạy trên máy tính nơi bạn thực thi lệnh. | Cài đặt | Chương trình | Dữ liệu | | --- | --- | --- | | Ubuntu với quyền root | `/opt/tgwitness` | Dịch vụ hệ thống: `/var/lib/tgwitness-`; sử dụng `tgwitness paths` để biết đường dẫn chính xác. | | Người dùng Linux / macOS | `~/.local/share/tgwitness` | `data/live` trong quá trình cài đặt đó. | | Người dùng Windows | `%LOCALAPPDATA%\TgWitness` | `data\live` trong quá trình cài đặt đó. | Chọn `TGWITNESS_INSTALL_DIR` để chọn một thư mục khác. Các phiên bản đã cài đặt và dữ liệu được tách biệt. Trình cài đặt không tải lên tài khoản, tin nhắn hoặc khóa của bạn lên trang web tải xuống. Chọn đường hầm Cloudflare sẽ chuyển lưu lượng truy cập bảng điều khiển qua Cloudflare; sử dụng tên miền riêng của bạn sẽ trỏ đến máy chủ của chính bạn. Với `TGWITNESS_TRUSTED_PROXIES`, bảng điều khiển chấp nhận một `X-Forwarded-Proto: https` duy nhất từ một proxy đáng tin cậy để thiết lập cookie tải xuống an toàn. Mỗi bản cài đặt đều bao gồm **các tệp START-HERE.html** và **START-HERE.txt**, với các đường dẫn cục bộ, lệnh và liên kết đến kho lưu trữ. Chạy `tgwitness guide` để mở hướng dẫn. Trên Windows, hãy sử dụng `& "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide` trong PowerShell. ## Cài đặt tìm kiếm toàn văn [Tính năng tìm kiếm toàn văn](https://phishdestroy.io/tgwitness/vi/docs/reference/search/) (bản xem trước) không cần thiết lập. Chỉ mục của nó được xây dựng ở chế độ nền sau khi cập nhật. | Biến hoặc lệnh | Hiệu quả | | --- | --- | | `TGWITNESS_FULLTEXT=disk` | Mặc định: chỉ mục được lưu trữ trong `search/fulltext.sqlite3` của mỗi không gian làm việc | | `TGWITNESS_FULLTEXT=memory` | Không có tệp chỉ mục; chỉ mục được xây dựng lại mỗi khi khởi động | | `TGWITNESS_FULLTEXT=off` | Không có chỉ mục; chỉ tìm kiếm theo văn bản chính xác | | `tgwitness index status` | Trạng thái chỉ mục của mỗi không gian làm việc | | `tgwitness stop`, `tgwitness index rebuild`, `tgwitness start` | Xây dựng lại mọi chỉ mục từ nhật ký được ký điện tử | Lựa chọn của quản trị viên trong **Nhật ký → Bộ lọc → Chỉ mục tìm kiếm** sẽ ghi đè lên biến cho không gian làm việc đó. Các lệnh sẽ tìm thư mục dữ liệu của bản cài đặt chạy chúng; ở các vị trí khác, hãy thêm `--data-dir` với đường dẫn từ `tgwitness paths`. Để có từ điển tiếng Ukraina đầy đủ (dữ liệu GPL-3.0), hãy cài đặt `pymorphy3-dicts-uk` trong môi trường Python của bản cài đặt. ## Truy cập qua dòng lệnh [Dòng](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/) [lệnh](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/) (bản xem trước) đọc tệp lưu trữ để tìm các tập lệnh và tác nhân. | Biến | Hiệu quả | | --- | --- | | `TGWITNESS_URL` | Địa chỉ bảng điều khiển cho `tgwitness search`, `context`, `messages`, `stats` và `export`; mặc định `http://127.0.0.1:8787` khi đã thiết lập mã thông báo | | `TGWITNESS_MCP_TOKEN` | Lưu mã thông báo kết nối từ **Công cụ khác → Tích hợp → MCP**, được chia sẻ với các khách hàng MCP; `--token-file` sẽ đọc mã này từ một tệp thay thế | | `TGWITNESS_DATA` | Thư mục dữ liệu được đọc trực tiếp khi không `--data-dir`, URL hoặc mã thông báo nào được cung cấp | ## Kiểm tra trước khi chạy Trình cài đặt nhúng khóa công khai phát hành của dự án và kiểm tra chữ ký SHA-256 và RSA trên gói ứng dụng và khóa phụ thuộc trước khi cài đặt chúng. Cả Bash và PowerShell đều dừng lại khi một kiểm tra bắt buộc không thành công. Tập lệnh ban đầu được phân phối qua HTTPS và có chữ ký riêng biệt; các lệnh dưới đây cũng cho phép bạn xác minh tập lệnh đó trước khi thực thi. Khóa công khai là [release-signing.pub](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/release-signing.pub). SHA-256 của nó là: ``` 039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d ``` Hãy lưu giữ dấu vân tay này từ một phiên bản kho lưu trữ mà bạn tin cậy. Tổng kiểm tra từ cùng một máy chủ tải xuống sẽ phát hiện sự không khớp; khóa công khai được tin cậy độc lập chính là yếu tố xác thực chữ ký bản phát hành. Hãy sử dụng một thư mục mới, trống để chứa các tệp tải xuống xác minh dưới đây. **Linux / macOS — chạy trong một thư mục tải xuống mới và trống** (yêu cầu curl và OpenSSL): ``` curl -fSLO https://get.destroy.tools/install.sh && curl -fSLO https://get.destroy.tools/install.sh.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh && bash install.sh ``` Quá trình `&&` chuỗi sẽ dừng lại trước khi thực thi nếu quá trình tải xuống, kiểm tra dấu vân tay khóa hoặc kiểm tra chữ ký không thành công. Nếu có bản phát hành mới trong khoảng thời gian từ khi tải xuống tập lệnh đến khi kiểm tra chữ ký, hãy tải lại cả hai. Các trình cài đặt cũ vẫn giữ nguyên URL gói không thể thay đổi của chúng. **Windows — hãy kiểm tra thẻ SHA-256 trước khi chạy:** ``` Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing Get-FileHash .\install.ps1 -Algorithm SHA256 Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt ``` So sánh giá trị băm với `install.ps1` dòng này. Để kiểm tra chữ ký độc lập, hãy sử dụng OpenSSL (ví dụ: từ Git Bash) và dấu vân tay khóa công khai tương tự như trên: ``` curl -fSLO https://get.destroy.tools/install.ps1 && curl -fSLO https://get.destroy.tools/install.ps1.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 && powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1 ``` Quá trình cài đặt trên Windows tự động xác minh chữ ký gói bằng .NET và không cần OpenSSL. Đây là các chữ ký RSA-3072 / SHA-256 độc lập, không phải Authenticode. Bản [kê khai](https://get.destroy.tools/manifest.json) ghi lại phiên bản phần mềm, cam kết Git chính xác, ID bản phát hành bất biến và SHA-256 của từng thành phần. Trang này liên kết đến nguồn tương ứng. Bản kê khai và danh sách tổng kiểm tra cũng có các chữ ký độc lập (`manifest.json.sig` và `SHA256SUMS.txt.sig`). ## Cập nhật bản cài đặt hiện có **Một bản phát hành mới sẽ cập nhật trang tải xuống; các chương trình đã cài đặt sẽ được cập nhật khi bạn chạy trình cài đặt lại.** Không có trình cập nhật tự động hoặc tính năng khởi động lại tự động cho bộ sưu tập đang chạy. Kênh trình cài đặt hiện tại là **bản xem trước**; nó dựa trên các bản dựng đã được phát hành và kiểm tra từ `main`, trong đó commit có thể mới hơn so với bản phát hành GitHub được đánh số gần nhất. Phiên bản của trang này xuất phát từ `pyproject.toml`; cam kết và ID bản dựng của nó giúp phân biệt các bản cập nhật trong cùng một phiên bản xem trước. Việc xuất bản diễn ra tự động sau khi commit cụ thể đó vượt qua các kiểm tra ứng dụng và bảo mật, đồng thời gói đã ký được xác thực, cài đặt và kiểm tra trên Ubuntu và Windows. Các yêu cầu kéo (pull requests) thay đổi trình cài đặt cũng chạy `install.sh` và `install.ps1` hai lần trên bản sao cục bộ của trang web. Trong khi các kiểm tra đang chạy, hoặc nếu chúng thất bại, các lệnh tương tự sẽ tiếp tục cài đặt bản dựng đã được kiểm tra trước đó. Bản kê khai bản dựng hiển thị cam kết nào hiện đang có sẵn; riêng số phiên bản có thể giữ nguyên giữa các bản cập nhật bản xem trước. Sử dụng cùng thư mục cài đặt và tài khoản người dùng hệ điều hành như trước đây. Sao lưu toàn bộ thư mục dữ liệu khi quá trình thu thập dữ liệu đã dừng; `tgwitness paths` xác định nó. Một tệp xuất đã được ký không phải là bản sao lưu cài đặt đầy đủ. **Cài đặt Ubuntu với quyền root tại `/opt/tgwitness`:** ``` curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start ``` Sau khi cài đặt thành công: ``` /opt/tgwitness/bin/tgwitness restart /opt/tgwitness/bin/tgwitness status /opt/tgwitness/bin/tgwitness open ``` Đối với người dùng Linux/macOS, hãy sử dụng bản gốc `TGWITNESS_INSTALL_DIR` hoặc cài đặt mặc định và chạy lại lệnh cài đặt đầu tiên. Đóng bảng điều khiển đang chạy ở chế độ nền trước khi cập nhật và khởi động lại nó sau đó. Đối với dịch vụ đã được cấu hình trên Linux, hãy chạy lệnh `tgwitness restart` lệnh đó. **Windows:** đóng bảng điều khiển đang chạy, chạy lại lệnh cài đặt Windows, sau đó mở `bin\tgwitness.cmd` trong cùng một bản cài đặt. Trình cài đặt sẽ giữ lại dữ liệu, phiên làm việc, cài đặt truy cập và khóa ký. Trình khởi chạy chỉ được chuyển đổi sau khi môi trường mới vượt qua các bước kiểm tra; nếu cài đặt thất bại, trình khởi chạy trước đó sẽ vẫn được giữ nguyên. Hãy giữ bản sao lưu trước khi nâng cấp để đề phòng các thay đổi về định dạng lưu trữ. ## Các lệnh thường dùng trên Ubuntu | Lệnh | Kết quả | | --- | --- | | `tgwitness open` | URL bảng điều khiển hiện tại và khóa truy cập. | | `tgwitness paths` | Đường dẫn chính xác đến chương trình, dữ liệu và hướng dẫn. | | `tgwitness guide --print` | Hướng dẫn sử dụng ngoại tuyến. | | `tgwitness status` / `tgwitness logs` | Tình trạng sẵn sàng / nhật ký dịch vụ. | | `tgwitness stop` / `tgwitness start` | Dừng / tiếp tục dịch vụ; giữ lại dữ liệu. | | `tgwitness token rotate` | Thay thế khóa quản trị viên và kết thúc các phiên trình duyệt. | | `tgwitness tunnel off` | Vô hiệu hóa đường hầm nhanh công khai; giữ lại bảng điều khiển cục bộ. | | `tgwitness tunnel on` / `tgwitness tunnel restart` | Tạo liên kết đường hầm nhanh / thay thế địa chỉ của nó. | Xem [phần Quyền truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/access/) để biết thông tin về mã thông báo đồng nghiệp, phiên làm việc và hạn chế IP, cũng như [phần Xuất bản trình cài đặt](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/README.md#automatic-publication-from-github) để tìm hiểu quy trình phát hành từ GitHub sang Cloudflare. ## Xóa TgWitness Không có trình gỡ cài đặt: bạn chỉ cần tắt bảng điều khiển và xóa các thư mục của nó. Việc xóa thư mục dữ liệu sẽ xóa vĩnh viễn các nhật ký, khóa ký, phiên Telegram và các tệp đã lưu. Trước khi thực hiện điều đó: 1. Xuất những gì bạn cần (**Xuất → Tải xuống tệp đã ký ZIP**) và lưu giữ dấu vân tay khóa ký cùng các điểm kiểm tra bên ngoài máy này. Để giữ lại chính không gian làm việc, hãy sao chép toàn bộ thư mục dữ liệu khi quá trình thu thập đã dừng lại. 2. Xóa các máy chủ được tạo trong mục **“More tools → Extras → Server 24/7”** khỏi **danh sách Your servers** hoặc bằng lệnh `python -m tgwitness.cloud destroy`; nhà cung cấp sẽ tiếp tục tính phí cho các máy chủ này cho đến khi chúng được xóa. 3. Kết thúc phiên làm việc của từng tài khoản trên Telegram tại **mục Cài đặt → Thiết bị**. Việc xóa các tệp này sẽ không đăng xuất phiên làm việc đó trên phía Telegram. **Cài đặt với quyền root trên Ubuntu.** Lưu ý thư mục dữ liệu, dừng dịch vụ, sau đó xóa dịch vụ, các thư mục và lối tắt: ``` /opt/tgwitness/bin/tgwitness paths /opt/tgwitness/bin/tgwitness stop systemctl list-unit-files 'tgwitness-*' systemctl disable tgwitness- rm /etc/systemd/system/tgwitness-.service systemctl daemon-reload rm -rf /opt/tgwitness /var/lib/tgwitness- /usr/local/bin/tgwitness ``` **Cài đặt cho người dùng Linux hoặc macOS.** Đóng bảng điều khiển. Dịch vụ người dùng Linux đã được cấu hình sẽ bị dừng bằng `systemctl --user disable --now tgwitness-`; đơn vị của nó nằm trong `~/.config/systemd/user/`. Sau đó xóa `~/.local/share/tgwitness` (hoặc của bạn `TGWITNESS_INSTALL_DIR`) và `~/.local/bin/tgwitness` lối tắt. **Windows.** Đóng bảng điều khiển và xóa `%LOCALAPPDATA%\TgWitness` (hoặc `TGWITNESS_INSTALL_DIR`). Trình cài đặt không thêm bất kỳ dịch vụ, tác vụ được lên lịch hoặc lối tắt nào. --- # Telegram · Cài đặt ban đầu và cấu hình Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/settings/ Trình hướng dẫn thiết lập, mục tiêu, cấp độ giao diện, đường dẫn kết nối và các cài đặt được chia sẻ bởi một nhóm tài khoản. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Trình hướng dẫn thiết lập, mục tiêu, cấp độ giao diện, đường dẫn kết nối và các cài đặt được chia sẻ bởi một nhóm tài khoản. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bắt đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/) ![Bắt đầu](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/) · [Kết nối](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/) · [Truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/access/) Một không gian làm việc mới sẽ mở ra `/first-run`. Màn hình đầu tiên sẽ hỏi quý vị muốn thực hiện thao tác gì: **Chỉ tải xuống**, **Theo dõi các cuộc trò chuyện** hoặc **Bằng chứng cho một vụ việc**. Lựa chọn này sẽ xác định mục tiêu và mức độ giao diện: Đơn giản dành cho tùy chọn Chỉ tải xuống, Tiêu chuẩn dành cho hai tùy chọn còn lại. Mức độ này quyết định số lượng trường hiển thị trên mỗi biểu mẫu; mọi trang đều được duy trì trong menu. **Các tùy chọn bổ sung** trên cùng màn hình này cho phép thiết lập rõ ràng mức độ, chủ đề và múi giờ; danh sách ngôn ngữ nằm ở phần đầu của trình hướng dẫn. Các màn hình tiếp theo bao gồm phần kết nối, Telegram và các cuộc trò chuyện. Các tuyến kết nối sẽ được thu gọn trong khi quá trình kiểm tra tự động diễn ra và sẽ mở ra khi quá trình này không thành công. Thanh tiến trình năm giai đoạn sẽ quay lại các giai đoạn đã hoàn thành. Mỗi câu trả lời sẽ được lưu trên máy chủ ngay khi có thay đổi, do đó việc tải lại trang sẽ tiếp tục từ cùng một bước. Màn hình cuối cùng liệt kê các câu trả lời và cho phép quý vị quay lại bất kỳ câu trả lời nào trong số đó. Ngôn ngữ, múi giờ IANA, chủ đề và mức độ được lưu trữ theo từng người vận hành và từng không gian làm việc. Các giá trị mặc định là ngôn ngữ trình duyệt, múi giờ thiết bị, chủ đề hệ thống và giao diện đơn giản. Việc thay đổi ngôn ngữ sẽ giữ nguyên phiên làm việc trên bảng điều khiển. Thời gian trong nhật ký đã ký kết không bao giờ thay đổi. `/settings` chỉnh sửa cùng các bản ghi như trình hướng dẫn. Tìm kiếm bao gồm các trường chính, tham số và biểu mẫu mở rộng; có thể mở một trường ẩn mà không đổi cấp độ. Cấp độ chỉ thay đổi những gì được hiển thị: máy chủ tự kiểm tra quyền. Phần có mọi cài đặt đều cao hơn cấp độ đã chọn vẫn hiển thị chúng. Cài đặt thu thập và kết nối đầu tiên thuộc quyền quản trị viên không gian làm việc. Trang cài đặt là một danh sách. Thẻ tài khoản ở trên cùng mở **Tài khoản Telegram**. Bên dưới, mỗi dòng nêu một phần và giá trị đang dùng: **Những cuộc trò chuyện nào?** và **Kết nối** trong **Tài khoản**; **Mục tiêu**, **Ghi và tệp**, **Bảo vệ bản ghi** và **Thông báo và bản sao bên ngoài** trong **Đang ghi**; **Ngôn ngữ, thời gian và giao diện** trong **Bảng điều khiển**; và các trang chuyên sâu trong **Các công cụ khác**. Bên cạnh danh sách, một thẻ cho biết các giá trị khuyến nghị có đang bật không, kèm các giá trị chính và **Hoàn tác thay đổi cuối cùng**, còn **Các thay đổi gần đây** liệt kê các chỉnh sửa gần nhất. Một phần sẽ mở ra trong một cửa sổ phía trên danh sách và có địa chỉ riêng, chẳng hạn như `/settings/connection`. Mũi tên quay lại, nút đóng, phím Escape, nhấp chuột bên ngoài cửa sổ và nút Quay lại của trình duyệt sẽ đưa bạn trở lại danh sách. **Những cuộc trò chuyện nào?** sẽ được giữ lại khi chọn **Lưu lựa chọn cuộc trò chuyện**; khi đóng mà chưa lưu thay đổi, hệ thống sẽ hỏi xác nhận trước. Việc lưu sẽ giữ lại các loại nguồn, các cuộc trò chuyện bị loại trừ, các hành động của chính bạn và cài đặt cuộc trò chuyện mới trong **Công cụ khác → Nguồn → Phạm vi**; một cuộc trò chuyện được chọn tại đây sẽ được loại khỏi danh sách các cuộc trò chuyện bị loại trừ và được ghi lại như một nguồn được chọn thủ công. Mỗi thay đổi sẽ hiển thị **tùy chọn Undo** trong 20 giây, và mỗi mục trong **Recent changes** có thể được hoàn tác sau này. Một lệnh hoàn tác chỉ khôi phục lại các cài đặt mà mục đó đã thay đổi, bao gồm cả giới hạn tệp tùy chỉnh. Khi một thay đổi sau đó tác động đến cùng các cài đặt đó, lệnh hoàn tác sẽ bị từ chối và không có gì thay đổi. Một lệnh hoàn tác là một bản ghi mới `settings.changed` trong nhật ký. | Cấp độ | Các trường | Thanh bên | | --- | --- | --- | | Đơn giản | Chỉ những yếu tố cần thiết | Trang chủ, Trò chuyện, Nhật ký, Xuất dữ liệu, Tài khoản và Cài đặt | | Tiêu chuẩn | Các cài đặt chung kèm theo giải thích | Thêm các mục Bảng trường hợp, Nguồn, Quyền truy cập và Tài liệu vào phần Công cụ khác | | Chuyên gia | Tất cả các trường, giới hạn và chi tiết kỹ thuật | Ngoài ra, còn bổ sung các mục Bản đồ hệ thống, Cấu trúc mạng, Tính năng bổ sung, Hỏi kho lưu trữ, Thông số, Tài khoản, Nhật ký hệ thống và Tích hợp trong phần Công cụ khác | Tên các phần giữ nguyên ở mọi cấp độ. Mở mục Giao diện ở cuối thanh bên để thay đổi cấp độ. [Hướng dẫn bảng](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/) điều khiển mô tả từng phần. ## Mục tiêu | Mục tiêu | Bộ sưu tập | Tệp tin | Các dịch vụ bên ngoài | Địa chỉ máy chủ | | --- | --- | --- | --- | --- | | Chỉ tải xuống | Việc xuất dữ liệu một lần bắt đầu từ màn hình thiết lập cuối cùng; chế độ thu thập liên tục được tắt | Ảnh có dung lượng tối đa 20 MB | Dấu thời gian | Tự động | | Theo dõi các cuộc trò chuyện | Liên tục | Ảnh và video có thời lượng tối đa 60 giây / dung lượng tối đa 20 MB | Dấu thời gian và thông báo sự cố | Tự động | | Bằng chứng cho một vụ án | Liên tục | Tất cả các tệp có dung lượng tối đa 1 GB | Dấu thời gian, drand, thông báo | Không, ẩn đi | Bản sao ngoài nền tảng, bot chứng thực và tính năng kiểm tra mã được khuyến nghị để làm bằng chứng. Địa chỉ lưu trữ và thông báo cần có đích đến trước tiên. Một tính năng kết nối với dịch vụ bên ngoài sẽ yêu cầu cho phép các yêu cầu bên ngoài Telegram; việc tắt tính năng này sẽ đồng thời tắt các dấu thời gian, thông báo và bản sao ngoài nền tảng. Việc thay đổi mục tiêu sẽ hiển thị sự khác biệt trước tiên, và các thay đổi thủ công có thể được giữ lại. Một trường khác với mục tiêu sẽ được đánh dấu **là “Đã được bạn thay đổi”** và có thể được khôi phục. Bản sửa đổi cài đặt ngăn không cho sự khác biệt đã được xem xét ghi đè lên một thay đổi được thực hiện trong một tab khác. ## Kết nối Cho đến khi chọn được một tuyến đường tại đây, không gian làm việc mới sẽ sử dụng **MTProxy Tự động · danh sách công khai** với tùy chọn **Ẩn địa chỉ** ([bảo mật kết nối](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/)). Tùy chọn **Tự động** bên dưới là một bước thiết lập riêng biệt. **Automatic** sẽ thử WARP trước, sau đó là các máy chủ MTProxy công khai, rồi mới đến kết nối trực tiếp, chỉ thực hiện kết nối trực tiếp khi địa chỉ máy chủ có thể được hiển thị. Automatic và WARP có thể cài đặt các thành phần được kiểm tra băm và đăng ký máy chủ với Cloudflare; nếu không có sự đồng ý đó, Automatic sẽ bỏ qua WARP. WARP sử dụng trình quản lý wgcf/wireproxy hiện có và cổng SOCKS5 cục bộ; bảng định tuyến hệ thống không bị thay đổi. **Tính năng nhập hàng loạt** yêu cầu chọn đường dẫn trước khi bất kỳ phiên nào kết nối với Telegram: WARP (mặc định), MTProxy công khai hoặc kết nối trực tiếp. Quá trình kiểm tra phiên sử dụng cùng loại đường dẫn, và mỗi tài khoản được nhập sẽ có đường hầm WARP riêng trước lần đăng nhập đầu tiên. Proxy của riêng bạn chấp nhận `tg://proxy`, `socks5://`, `http://` và `https://`. Chứng chỉ của một proxy HTTPS sẽ được kiểm tra trước khi thông tin đăng nhập được gửi đến nó. Kiểm tra kết nối có hiệu lực trong năm phút và gắn liền với lộ trình, chính sách và các câu trả lời trong trình hướng dẫn; việc thay đổi bất kỳ yếu tố nào trong số đó đều yêu cầu kiểm tra lại. Tùy chọn **“Tiếp tục mà không kiểm tra”** có sẵn nhưng không thay thế cho việc đăng nhập Telegram. Lộ trình đã chọn sẽ được kiểm tra lại ở chế độ nền, và chế độ Tự động sẽ chạy lại chuỗi của nó sau khi mất kết nối. Khi không có proxy công khai nào phản hồi, chỉ số sẽ chuyển sang màu đỏ kèm theo các hành động WARP và kiểm tra lại . ## Nhóm tài khoản Các tài khoản trong một nhóm sẽ chia sẻ cài đặt với nhau. Mở **Tài khoản → Nhóm và cài đặt chung → Cài đặt chung**, hoặc **Cài đặt nhóm** trên trang Cài đặt của tài khoản. Nhóm chia sẻ mục tiêu, tệp đã lưu, dấu thời gian, drand, thông báo sự cố, bản sao ngoài nền tảng, yêu cầu bên ngoài Telegram, chế độ IP, nội dung cần ghi lại, lịch trình kiểm tra lại, quy tắc thông báo, cài đặt báo cáo, tham số và đường dẫn kết nối. Địa chỉ nhận thông báo, thông tin đăng nhập proxy và thông tin đăng nhập được lưu riêng cho từng tài khoản, cũng như việc bắt đầu và tạm dừng quá trình thu thập dữ liệu. - Mọi thành viên đều theo dõi nhóm. Cài đặt cho phép chọn giá trị 🔗 **Từ nhóm** hoặc ✏️ **Giá trị riêng**; **Chọn “Quay lại giá trị của nhóm”** để khôi phục giá trị ban đầu. - Một thay đổi sẽ liệt kê các tài khoản mà nó ảnh hưởng (**Áp dụng cho 2 trong số 3 tài khoản**) và hỏi từng tài khoản trước khi thay thế giá trị hiện tại của tài khoản đó. Các tài khoản chưa được chọn sẽ giữ nguyên giá trị của mình. - Một tham số mà nhóm không chia sẻ sẽ vẫn ở trạng thái **"Chưa chia sẻ": mỗi tài khoản sẽ giữ giá trị riêng của mình** cho đến khi bạn nhấn **"Chia sẻ giá trị này**". - **Việc sao chép cài đặt từ một tài khoản** sẽ lấy các giá trị của tài khoản được chọn làm cài đặt chung cho nhóm. - Khi một tài khoản được chuyển vào nhóm, hệ thống sẽ hỏi: **“Có muốn áp dụng các giá trị của nhóm không?”.** Nếu không, tài khoản đó sẽ giữ nguyên các giá trị của riêng mình, được đánh dấu bằng ✏️. Các tài khoản được thêm vào sau đó sẽ bắt đầu với các giá trị của nhóm. - Một tài khoản quan sát sẽ duy trì chế độ IP của mình cho đến khi bị tạm dừng. Mỗi thay đổi đều được ghi lại trong nhật ký đã được ký số của không gian làm việc chính và của mọi thành viên mà thay đổi đó ảnh hưởng đến. Việc xóa một nhóm sẽ giữ lại các tài khoản trong nhóm và các giá trị hiện tại của chúng. Trang nhóm `/groups/` hiển thị danh sách thành viên, những nội dung cần chú ý và các cuộc trò chuyện mà nhiều tài khoản cùng theo dõi. Xem [phần Nhóm tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#bulk-import-and-account-groups). ## Các không gian làm việc hiện có Một không gian làm việc có phiên làm việc hoặc đã hoàn tất thiết lập trước đó sẽ không hiển thị trình hướng dẫn. Các giá trị của nó sẽ không bị thay thế bởi mục tiêu khi trang được tải. Việc ẩn một trường không tắt tính năng này hoặc xóa giá trị của nó. **Mở thiết lập đầu tiên** trong Cài đặt sẽ hiển thị lại các màn hình tương tự; việc hoàn tất chúng sẽ không khởi chạy bất kỳ quá trình xuất hoặc quan sát mới nào và sẽ thông báo điều đó, và lựa chọn trò chuyện đã thay đổi chỉ được lưu lại khi **nhấn Lưu lựa chọn trò chuyện**. Ước tính về dung lượng và thời gian dựa trên tối đa ba cuộc trò chuyện được chọn và tối đa 20 tin nhắn từ mỗi cuộc trò chuyện. Đây chỉ là ước tính: nó không dự đoán các giới hạn của Telegram, tốc độ của một máy chủ cụ thể hoặc các tệp trong mỗi cuộc trò chuyện. --- # Telegram · Các định dạng tài khoản và phiên làm việc Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/ Đăng nhập bằng số điện thoại, mã QR hoặc khóa xác thực, nhập các phiên làm việc từ Telethon, Pyrogram hoặc Telegram Desktop, và quản lý nhiều tài khoản cùng lúc. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Đăng nhập bằng số điện thoại, mã QR hoặc khóa xác thực, nhập các phiên làm việc từ Telethon, Pyrogram hoặc Telegram Desktop, và quản lý nhiều tài khoản cùng lúc. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bắt đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/) ![Bắt đầu](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) TgWitness đăng nhập dưới dạng tài **khoản người dùng Telegram** (không phải bot) qua giao thức MTProto, sử dụng Telethon. Mỗi tài khoản tồn tại trong **không gian** làm việc riêng (được gọi là *“workspace”* trong API và các công cụ dòng lệnh) với phiên làm việc, nguồn dữ liệu, nhật ký và khóa ký riêng. Các tệp phiên làm việc, chuỗi phiên làm việc và Khóa xác thực là **các thông tin ủy quyền tài khoản**: bất kỳ ai sở hữu chúng đều có thể thực hiện các thao tác như chủ tài khoản đó. Chúng không chứa lịch sử tin nhắn. > [!CẢNH BÁO] **Sử dụng các tài khoản chuyên dụng.** Telegram hạn chế và có thể cấm vĩnh viễn các tài khoản do khối lượng yêu cầu mà họ coi là quá mức, bất kể khách hàng hay mục đích là gì, và chỉ ghi chép một phần các giới hạn đó. Hãy kết nối các tài khoản được chuẩn bị sẵn cho mục đích quan sát thay vì các tài khoản cá nhân hoặc các tài khoản có giá trị khác, và tạo ID API / băm API trên một tài khoản chuyên dụng. - [Tổng quan](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#at-a-glance) - [Trước khi bắt đầu: ID API và mã băm API](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#before-you-start-api-id-and-api-hash) - [Số điện thoại](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#phone-number) · [Mã QR](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#qr-code) · [Khóa xác thực (Auth Key) + ID DC](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#auth-key--dc-id) - [Tệp tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#pyrogram-session) · [Cặp phiên + JSON](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#telethon-stringsession) · [Khóa xác thực (Auth key) và DC trên cùng một dòng](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [Tệp JSON tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#account-json) - [Xác định những gì quý vị đang có](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#identify-what-you-have) · [Các định dạng không được hỗ trợ](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#unsupported-formats) - [Nhiều tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#multiple-accounts) · [Bảo vệ an toàn cho các tệp tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#keeping-account-files-safe) · [Khắc phục sự cố](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#troubleshooting) ## Tổng quan | Những gì quý vị có | Tab **“Thêm tài khoản**” | Quý vị cũng sẽ cần | | --- | --- | --- | | Số điện thoại và quyền truy cập vào các mã đăng nhập của công cụ này | **Điện thoại** | Mật khẩu xác thực hai yếu tố (2FA) nếu tính năng này đã được kích hoạt | | Telegram đang mở trên một thiết bị khác | **Mã QR** | Mật khẩu xác thực hai yếu tố (2FA) nếu tính năng này đã được kích hoạt | | Một tệp `.session` (Telethon hoặc Pyrogram) | **Tệp tin** | Tệp JSON đi kèm (tùy chọn) dành cho cài đặt ứng dụng | | `.session` + `.json` cùng tên | **Tệp tin** (chọn cả hai) | Thông thường không có nội dung nào khác | | Thư mục `tdata` trên Telegram Desktop | **Tệp tin** (dạng ZIP) | Mật mã cục bộ trên máy tính để bàn (nếu đã được thiết lập) | | Một phiên StringSession của Telethon (văn bản, `.txt`, `.tgwitness-session`) | **Tệp tin** | Không cần cặp API riêng biệt | | Khóa xác thực và DC được ghi trên cùng một dòng, `<512 hex>:<1–5>` | **Tệp** (dán hoặc tệp văn bản) | Không cần cặp API riêng biệt | | Một khóa `.json` kèm theo phiên làm việc hoặc Khóa xác thực (Auth Key) | **Tệp tin** | Không cần cặp API riêng biệt | | Một Khóa xác thực (512 ký tự hex) và số DC tương ứng | **Khóa xác thực** | ID người dùng (tùy chọn) | TgWitness nhận diện các tệp dựa trên **nội dung** chứ không phải tên tệp. Việc đổi tên tệp sẽ không bao giờ làm thay đổi nội dung của tệp đó. ## Trước khi bắt đầu: ID API và mã băm API Bạn có thể đăng nhập mà không cần tạo ứng dụng API Telegram. Khi không có cặp khóa nào được nhập, nhập từ nguồn bên ngoài hoặc đã được lưu sẵn trong không gian làm việc, TgWitness sẽ chọn một cặp từ kho dự trữ tích hợp sẵn gồm 50 cặp API công khai (`tgwitness/api_pool.py`), ưu tiên Telegram Desktop cho lần đăng nhập mới và ưu tiên sử dụng cặp đã lưu trước; các cặp còn lại sẽ được xáo trộn ngẫu nhiên. Nếu Telegram từ chối một cặp (`API_ID_INVALID`, `API_ID_PUBLISHED_FLOOD`, `UPDATE_APP_TO_LOGIN`), cặp tiếp theo sẽ được thử, tối đa tám cặp cho mỗi lần đăng nhập; các cặp bị từ chối sẽ bị bỏ qua cho đến khi khởi động lại. Cặp đã dùng để đăng nhập sẽ được lưu cùng với tài khoản và được tái sử dụng cho tài khoản đó. Các cặp tích hợp sẵn là công khai: chúng được công bố trong mã nguồn mở của các ứng dụng khách và thư viện Telegram. **ID API** và **băm API** dùng để xác định ứng dụng đối với Telegram và không cấp quyền truy cập vào dữ liệu tài khoản. Quá trình đăng nhập sử dụng cơ chế xác thực riêng của tài khoản: mã đăng nhập và mật khẩu 2FA, hoặc phiên làm việc mà tài khoản đó đã xác thực trước đó. Mỗi `observation.started` bản ghi đều ghi rõ cặp thông tin được sử dụng, do đó một cặp tích hợp sẵn được ghi chép cho tòa án theo cách tương tự như cặp của chính bạn. Thay vào đó, bạn có thể nhập cặp thông tin của riêng mình từ my.telegram.org. Theo kinh nghiệm của dự án, việc tạo một cặp thông tin cá nhân mới thường khiến hầu hết các tài khoản bị đăng xuất, vì vậy chỉ nên sử dụng cặp này khi vụ việc yêu cầu ứng dụng của riêng bạn: hãy tạo cặp này bằng một tài khoản chuyên dụng và nhập nó trước khi quá trình thu thập dữ liệu bắt đầu (các bước dưới đây). Các trường kết nối bị thiếu sẽ sử dụng cặp thiết bị/hệ điều hành xác định từ các danh mục [opentele2 2.0.0 đi kèm](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735): Desktop `2040`, Android `6`, Android X `21724`, iOS `10840`, macOS `2834` và Web `2496`. ID xây dựng nguồn của Android `4` cũng sử dụng danh mục Android, như được xác định trong [BuildVars của Telegram Android](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java). Web mặc định là A; hậu tố phiên bản ứng dụng `K` được nhập hoặc gói ngôn ngữ `macos` sẽ chọn K, và phiên bản `0.7.0` sẽ chọn Webogram. Các ID ứng dụng không xác định sẽ giữ nguyên các giá trị mặc định của máy chủ Telethon. Các trường được nhập vào luôn được ưu tiên, bao gồm cả phiên bản ứng dụng cũ hơn và gói ngôn ngữ trống. Danh mục không bao giờ thay đổi ID/băm API. Ảnh chụp phiên bản của nó được xem xét rõ ràng, không được lấy trong quá trình đăng nhập. Hồ sơ đã lưu sẽ vẫn ổn định sau khi cập nhật. `account.getAuthorizations` báo cáo siêu dữ liệu ủy quyền đã lưu của Telegram; đây không phải là bản sao của mỗi `initConnection` mới. So sánh nó với hồ sơ thực tế đã được gửi. Việc kết nối một ủy quyền hiện có không xác thực băm API đi kèm: `initConnection` gửi ID API, trong khi băm được sử dụng cho các yêu cầu đăng nhập. Sau khi xác thực bằng điện thoại mới hoặc mã QR, TgWitness yêu cầu cấu hình, trung tâm dữ liệu (DC) gần nhất, trạng thái trực tuyến, ngôn ngữ (khi gói ngôn ngữ không trống), cập nhật ứng dụng và cập nhật điều khoản dịch vụ, với khoảng thời gian 0.3–1.5 giây giữa các yêu cầu. Việc cập nhật trạng thái sẽ tạm thời đánh dấu tài khoản là đang trực tuyến. Chuỗi thao tác này chỉ chạy một lần khi hoàn tất đăng nhập, không chạy khi nhập dữ liệu, kết nối lại hoặc khởi động lại. Việc xác thực được lưu trước tiên; một yêu cầu thất bại sẽ dừng chuỗi thao tác mà không thử lại hoặc hủy bỏ quá trình đăng nhập. Kết quả được ghi lại dưới dạng `account.initialized`, với tên lỗi thay vì nội dung phản hồi. Các chính sách riêng của Telegram quyết định các hạn chế đối với tài khoản. Đối với `tdesktop` , nếu thiếu `tz_offset` , hệ thống sẽ sử dụng độ lệch UTC cục bộ của máy chủ, được làm tròn đến 900 giây bằng thuật toán [opentele2](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (MIT; giấy phép tại `tgwitness/client_profiles.LICENSE` ). Giá trị này được cập nhật trên mỗi lần kết nối để phản ánh các thay đổi do giờ mùa hè. `tz_offset` được nhập vào sẽ được ưu tiên trên mọi nền tảng và được giữ nguyên chính xác, kể cả giá trị bằng không. Các mục `initConnection.params` khác vẫn được giữ lại. Biểu mẫu đăng nhập HTTP chấp nhận múi giờ dạng số được trả về từ quá trình nhập tệp; các giá trị boolean, số thập phân và độ lệch nằm ngoài phạm vi được hỗ trợ sẽ bị từ chối. Các tuyến đường Direct, SOCKS5 và HTTP CONNECT sử dụng `ConnectionTcpObfuscated` của Telethon (MTProto được rút gọn và làm mờ). HTTPS CONNECT duy trì TLS đến proxy và sử dụng cùng một giao thức truyền tải được làm mờ bên trong đường hầm. MTProxy duy trì giao thức truyền tải trung gian ngẫu nhiên và xử lý khóa bí mật theo yêu cầu. Việc chuyển đổi đường dẫn áp dụng các lựa chọn tương tự. Việc làm mờ thay đổi cấu trúc gói tin; nó không che giấu tài khoản hoặc siêu dữ liệu khách hàng của tài khoản đó khỏi Telegram cũng như không ngụ ý khả năng miễn trừ các hạn chế. Sau khi kết nối với một máy khách được ủy quyền, TgWitness sẽ kiểm tra cấu hình, trung tâm dữ liệu (DC) gần nhất, tình trạng ủy quyền hiện tại, cơ sở tham chiếu lớp đã được xem xét, ngôn ngữ, các bản cập nhật ứng dụng và các bản cập nhật điều khoản dịch vụ. Các chẩn đoán này chạy một lần cho mỗi phiên bản máy khách, trước khi thu thập dữ liệu, và được hiển thị trong chi tiết kết nối kèm theo thời gian thực hiện. `account.connection_checked` ghi lại kết quả mà không bao gồm băm phiên, địa chỉ IP, mã thông báo hoặc băm API. Chúng không bao giờ chấp nhận điều khoản hoặc cài đặt bản cập nhật. Lỗi yêu cầu hoặc FloodWait sẽ dừng các yêu cầu tiếp theo; kết quả bị thiếu sẽ được ghi nhận là không xác định. Các kiểm tra cục bộ vẫn có thể báo cáo kết quả trong khi các kiểm tra mạng bị bỏ qua. Khi bật chế độ[chọn lọc cuộc trò chuyện nghiêm ngặt](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#strict-chosen-chats), thông tin ủy quyền hiện tại sẽ không được yêu cầu và kiểm tra đó sẽ được hiển thị là đã bị bỏ qua. Sau khi đăng nhập và mỗi khi kết nối mới, TgWitness sẽ đọc cài đặt nội dung nhạy cảm của tài khoản. Khi cài đặt này bị tắt và Telegram cho phép thay đổi, TgWitness sẽ bật nó lên để nội dung mà Telegram đánh dấu là nhạy cảm (18+) được lưu lại, đồng thời ghi lại giá trị của ` `account.content_settings``. Cài đặt này thuộc về tài khoản và áp dụng cho mọi ứng dụng Telegram. Chế độ "Strict chosen chats" sẽ không thay đổi cài đặt này; hãy bật chế độ đó trước khi đăng nhập. Các yêu cầu đồng thời nhằm khôi phục kết nối của một không gian làm việc sẽ chia sẻ cùng một client và chờ cho đến khi quá trình thiết lập kết nối của không gian làm việc đó hoàn tất. Nếu một lần thử bị thất bại hoặc bị hủy, hệ thống sẽ giải phóng yêu cầu tiếp theo để thử lại. Nếu thông tin đăng nhập đã lưu, client hoặc trạng thái ủy quyền thay đổi trong quá trình thiết lập, lần thử trước đó sẽ dừng lại thay vì báo cáo rằng kết nối đã sẵn sàng. Chẩn đoán FloodWait lưu giữ phương thức TL bị lỗi, bất kỳ trình bao bọc Takeout/range nào, thời gian chờ do máy chủ yêu cầu và thời hạn hiệu lực trong `telegram.backoff`. Chi tiết kết nối hiển thị phương thức và thời hạn trong khi các yêu cầu bị tạm dừng. Chẩn đoán bao gồm bộ đếm số lần gọi của khách hàng theo từng phương thức kể từ khi khách hàng đó được tạo; chúng đếm việc giải quyết đối tác lồng nhau riêng biệt, nhưng không đếm gói tin hoặc các lần thử lại nội bộ của Telethon. Các bộ đếm hiện tại cũng có sẵn dưới dạng `collector.rpc_activity` trong API trạng thái. Không bao gồm đối số yêu cầu, tên người dùng, hàm băm truy cập hoặc văn bản ngoại lệ. Chẩn đoán cuối cùng và thời hạn đầy đủ vẫn tồn tại sau khi khởi động lại. Các lần chờ trước đó không có bản ghi phương thức không thể được gán lại sau này. Xem giới hạn xuất để xem xét nguồn và sự khác biệt giữa khám phá và thu thập lịch sử. `official_app=True` hoặc `False` là cờ ủy quyền hiện tại của Telegram. Cả hai giá trị này đều không xác định liệu tài khoản đó có bị hạn chế, đáng tin cậy hay đang được giám sát hay không. Các bản chụp nhanh `account.devices` ở chế độ bằng chứng hiện có vẫn lưu giữ lịch sử của tất cả các thiết bị đã đăng nhập; chẩn đoán kết nối chỉ lưu giữ mô tả thiết bị hiện tại. Trước khi kết nối, các kiểm tra tư vấn so sánh nền tảng API, gói ngôn ngữ, định dạng thiết bị/hệ điều hành và phiên bản ứng dụng, vùng địa phương của hệ thống di động, cùng lớp lược đồ thực tế của Telethon với cơ sở tham chiếu danh mục đã được xem xét. Các cảnh báo xuất hiện trong nhật ký máy chủ và siêu dữ liệu trạng thái tài khoản; chúng không bao giờ thay thế các giá trị đã nhập hoặc thay đổi lớp lược đồ. Một lớp khác là tín hiệu để xem xét tính tương thích; trạng thái kết nối của chính tài khoản sẽ cho biết liệu nó có hoạt động hay không. Telegram quyết định các hạn chế từ phía mình, bất kể hồ sơ khách hàng nào được sử dụng. Trạng thái tài khoản bị ngắt kết nối sẽ sử dụng hồ sơ đã lưu thay vì tạo một mô tả thiết bị khác. Để sử dụng ứng dụng của riêng bạn thay thế: 1. Vui lòng truy cập [my.telegram.org](https://my.telegram.org) và đăng nhập bằng bất kỳ số điện thoại nào mà quý vị đang sở hữu. Mã xác minh sẽ được gửi đến ứng dụng Telegram, không phải qua tin nhắn SMS. 2. Chọn **các công cụ phát triển API**. 3. Tạo ứng dụng: bất kỳ tiêu đề và tên ngắn nào (5–32 ký tự), nền tảng **Máy tính để bàn**. Các trường URL và mô tả có thể để trống. 4. Vui lòng sao chép **App api_id** (một số) và **App api_hash** (32 ký tự thập lục phân). Trong bảng điều khiển, phần **“API ID + Hash**” nằm ngay dưới biểu mẫu đăng nhập. Quý vị có thể dán một cặp `api_id:api_hash` duy nhất vào **ô “API ID”** và cả hai trường sẽ được điền tự động. Một cặp này có thể được sử dụng cho tất cả các tài khoản của quý vị. Sau khi đăng nhập thành công, thông tin này sẽ được lưu trữ dưới dạng mã hóa, chỉ trong không gian làm việc đó và tuyệt đối không bao giờ được gửi trở lại trình duyệt. Có ba loại thông tin xác thực khác nhau liên quan đến vấn đề này: | Bí mật | Mở | Địa chỉ trang web | | --- | --- | --- | | Mã thông báo bảng điều khiển | Bảng điều khiển web TgWitness | `panel-token.txt` trong thư mục dữ liệu, hoặc `TGWITNESS_TOKEN` | | ID API + mã băm | Không có nội dung nào riêng lẻ; chỉ xác định ứng dụng | Cặp tài khoản tích hợp sẵn, cài đặt được nhập vào hoặc ứng dụng của riêng quý vị tại my.telegram.org | | Xác thực tài khoản | Tài khoản Telegram | Được tạo thông qua đăng nhập bằng điện thoại/mã QR hoặc được nhập dưới dạng phiên làm việc | Nếu phải truy cập Telegram qua proxy, hãy thiết lập trước tại mục **Công cụ khác → Tài khoản → Cài đặt → Cài đặt kết nối → Thay đổi đường dẫn kết nối**. ## Số điện thoại 1. Mở **thêm công cụ → Tài khoản**, tab **Điện thoại**, và nhập số theo định dạng quốc tế, ví dụ: `+44 7700 900123`. Khoảng trắng và dấu gạch ngang sẽ được tự động loại bỏ. 2. Nhấn vào **“Tiếp tục**”. Các trường API ID và Hash có thể để trống. 3. Nhập mã mà Telegram gửi, thường là vào ứng dụng Telegram; Telegram sẽ quyết định có gửi tin nhắn SMS hay không. 4. Nếu tài khoản đã bật xác thực hai bước, vui lòng nhập mật khẩu đó. Đây không phải là mã token trên bảng điều khiển và cũng không phải là mã khóa thiết bị. 5. Vui lòng kiểm tra ID tài khoản hiển thị sau khi đăng nhập, sau đó chọn các nguồn. Mã đăng nhập và mật khẩu xác thực hai yếu tố (2FA) tuyệt đối không bao giờ được lưu trữ trên đĩa cứng. ## Mã QR Vui lòng sử dụng tính năng này khi tài khoản đã được đăng nhập sẵn trên điện thoại hoặc máy tính khác. 1. Nhấp vào tab **Mã QR** → **Hiển thị mã QR**. Các trường API ID và Hash có thể để trống. 2. Trên thiết bị đã đăng nhập: **Cài đặt → Thiết bị → Kết nối thiết bị máy tính để bàn**, quét mã và xác nhận. 3. Vui lòng nhập mật khẩu xác thực hai yếu tố (2FA) vào TgWitness nếu Telegram yêu cầu. Hình ảnh mã QR được tạo tại địa phương. Mã có thời hạn sử dụng; vui lòng nhấn vào **“Tạo mã QR khác”** để thử lại. Việc khóa bảng điều khiển, chuyển sang không gian làm việc khác hoặc đăng nhập bằng tài khoản khác sẽ hủy bỏ mã đang chờ xử lý. ## Khóa xác thực (Auth Key) + ID DC Khóa xác thực (Auth Key) là khóa ủy quyền thô dài 256 byte đằng sau mỗi phiên Telegram, được biểu diễn dưới dạng **512 ký tự thập lục phân**, kèm theo số trung tâm dữ liệu **từ DC 1 đến DC 5**. 1. Tab **Khóa xác thực**. Vui lòng dán toàn bộ khóa; khóa rút gọn có chứa ký tự `…` sẽ không hoạt động. 2. Vui lòng chọn ID DC được cung cấp kèm theo khóa. 3. Quý vị có thể nhập **ID người dùng (**tùy chọn). TgWitness sẽ từ chối kết nối nếu Telegram báo cáo một tài khoản khác. 4. **Tài khoản** Press **Connect**. Khóa xác thực (512 ký tự) không phải là mã băm API (32 ký tự). Cùng một khóa này cũng có thể được nhập dưới dạng JSON; vui lòng tham khảo [phần JSON tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#account-json). ## Tệp tài khoản Mở **Thêm tài khoản → Tệp** và chọn tối đa **bốn tệp thuộc về một tài khoản**, tổng dung lượng **8 MiB**, nhấn **Kiểm tra tệp**, sau đó nhấn **Kết nối tài khoản**. Việc chọn tệp hoặc dán văn bản phiên làm việc sẽ không gửi đi bất kỳ dữ liệu nào; **lệnh Kiểm tra tệp** sẽ gửi chúng đến máy chủ TgWitness của bạn, máy chủ này sẽ đọc các tệp đó mà không cần đăng nhập và hiển thị phiên làm việc mà nó tìm thấy. Các biểu mẫu **Files**, **Auth key** và nhập hàng loạt hiển thị cảnh báo phiên song song trước khi kết nối. Theo mặc định, các ủy quyền đã nhập sẽ được tái sử dụng. Giữ ứng dụng gốc đóng trong khi khóa của nó đang được sử dụng tại đây. **Files** và **Auth key** cũng cung cấp **Tạo ủy quyền độc lập**, được mô tả bên dưới. Nhập hàng loạt vẫn sử dụng chế độ trực tiếp. Đăng nhập qua điện thoại và QR tương tác sẽ tạo ra các ủy quyền riêng biệt. Tiêu đề cảnh báo vẫn hiển thị trong biểu mẫu nhập; phần giải thích đầy đủ sẽ mở ra tự động khi các tệp hoặc chuỗi khóa/phiên được cung cấp. Phần này có thể được thu gọn sau khi đọc, để trình chọn tệp và các điều khiển kết nối vẫn có thể sử dụng được trên điện thoại. Việc [triển khai đã được xác thực](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/) (Phala Cloud, Intel TDX) không thu thập dữ liệu từ khóa đã nhập. Trong trường hợp này, **Tệp** và **Khóa xác thực** chỉ kết nối khi tùy chọn **Tạo ủy quyền độc lập**được chọn; việc nhập hàng loạt bị từ chối. Đăng nhập bằng điện thoại và mã QR vẫn hoạt động bình thường. - Các tệp tin được chuyển đổi trực tiếp **trong bộ nhớ** trên máy chủ TgWitness của quý vị. Các tệp tải lên không được lưu trữ, các tệp ZIP không được giải nén ra đĩa và không có dịch vụ bên ngoài nào được liên hệ. - Phiên ghi chép thu được sau đó sẽ được đối chiếu với Telegram. Nếu một tệp ghi nhận ID người dùng, thì ID đó phải trùng khớp với thông tin tài khoản mà Telegram cung cấp. - Các tệp mô tả các tài khoản khác nhau hoặc thông tin đăng nhập API khác nhau sẽ bị từ chối thay vì chỉ chọn một tài khoản duy nhất. - **Mã thông báo hoặc văn bản phiên làm việc** chứa trường mã thông báo cục bộ TData, một ô để dán StringSession và **đọc tệp mà không cần đăng nhập** (điền biểu mẫu mà không cần kết nối với Telegram). Việc dán StringSession sẽ xóa các tệp đã chọn, và việc chọn tệp sẽ xóa văn bản đã dán, do đó quá trình kiểm tra và kết nối sẽ sử dụng lựa chọn mới nhất. Sau khi thay đổi mật khẩu, hãy nhấn **Kiểm tra tệp** một lần nữa. ### Tạo một quy trình ủy quyền độc lập Chọn **Tạo một ủy quyền độc lập** trước khi kết nối các tệp đã nhập hoặc một Khóa ủy quyền. TgWitness kết nối tạm thời với thiết bị nguồn đã nhập, sử dụng nó để phê duyệt mã thông báo đăng nhập QR của khách hàng mới, và ngắt kết nối thiết bị nguồn ngay sau khi phê duyệt. Khách hàng mới có khóa ủy quyền riêng và một hồ sơ máy tính để bàn được chọn riêng. Thông tin đăng nhập API và hồ sơ thiết bị do người hiến tặng cung cấp chỉ được sử dụng cho kết nối với người hiến tặng. Không có ủy quyền hiện có nào bị đăng xuất hoặc thu hồi. **Trong bước này, hãy giữ cho ứng dụng khách gốc của người tặng hoàn toàn ở trạng thái đóng.** Kết nối ban đầu vẫn sử dụng khóa đã sao chép, do đó chế độ này không thể loại bỏ rủi ro sử dụng song song ban đầu đó. Sau khi kết nối ủy quyền mới được thiết lập, chủ sở hữu có thể mở lại ứng dụng khách gốc và sử dụng cả hai cùng lúc. Đăng nhập tương tác **qua mã QR** cho phép khách hàng gốc phê duyệt việc đăng nhập mà không cần sao chép hoặc kết nối khóa của nó tại đây. **Không được đăng xuất hoặc kết thúc phiên làm việc của người tặng.** Khi phiên làm việc đã phê duyệt đăng nhập qua mã QR kết thúc, Telegram cũng sẽ kết thúc phiên làm việc mà nó đã phê duyệt; trong một lần kiểm tra thực tế, việc xác thực mới đã bị ngừng chỉ trong vòng một giây sau khi người tặng đăng xuất. Quá trình nhập dữ liệu sẽ ghi lại thông tin phiên làm việc của người tặng (`session_origin.approved_by`: thiết bị, ID API và thời gian tạo). Danh sách phiên sẽ đánh dấu phiên đó; tùy **chọn Kết thúc phiên** sẽ từ chối phiên; còn các tùy chọn **Kết thúc tất cả các phiên khác** và **Làm cho đây là phiên duy nhất** sẽ giữ cho người tặng vẫn đăng nhập. Nếu Telegram yêu cầu xác thực hai yếu tố (2FA), chế độ này sẽ sử dụng `twoFA` từ tệp JSON đã chọn nếu có sẵn, hoặc yêu cầu nhập mật khẩu. Nếu mật khẩu nhập vào bị từ chối, hệ thống sẽ quay lại biểu mẫu nhập mật khẩu. Mật khẩu sẽ không được lưu lại. Khóa dự phòng được lưu dưới dạng mã hóa trong `independent_login.enc`, bao gồm cả các thay đổi trong quá trình di chuyển trung tâm dữ liệu. Sau khi bị gián đoạn, hãy chọn cùng một tài khoản nguồn và tùy chọn này để tiếp tục với khóa ứng viên đã lưu. Tài khoản nguồn sẽ được kiểm tra `help.getAppConfig` trước khi phê duyệt; một tài khoản bị đóng băng sẽ dừng lại tại đó. Nếu Telegram từ chối tài khoản nguồn trước khi phê duyệt đăng nhập, khóa ứng viên chưa được phê duyệt sẽ bị loại bỏ và quá trình nhập có thể bắt đầu lại. Một tài khoản nguồn khác chỉ thay thế khóa ứng viên đã lưu khi Telegram báo cáo rằng khóa ứng viên đó chưa đăng nhập; một khóa ứng viên đang đăng nhập hoặc đang chờ mật khẩu 2FA sẽ được giữ lại. Không gian làm việc vẫn được dành riêng cho tài khoản đó; việc hoàn tất không thành công sẽ không xóa không gian làm việc mới. Giữ lại thư mục dữ liệu và khóa kho của nó. Thông tin đăng nhập cuối cùng và `account.authorized` bản ghi nhật ký bao gồm phương thức nhập, định dạng đầu vào và ID API của người hiến tặng, không bao gồm khóa hoặc mật khẩu của người hiến tặng. Vào ngày 5 tháng 11 năm 2026, một tài khoản chuyên dụng đã vượt qua các kiểm tra trực tiếp với các nhà tài trợ Telethon, Pyrogram và TData: hoàn tất xác thực hai yếu tố (2FA), các khóa ủy quyền mới riêng biệt, truy cập đồng thời của nhà tài trợ và khách hàng mới, cũng như đọc kênh công khai. Trường hợp Telethon cũng đã khôi phục một ứng viên đã lưu sau khi bị gián đoạn ở bước nhập mật khẩu. Mỗi lần xác thực mới đều hoàn tất sáu yêu cầu khởi tạo sau khi đăng nhập, và nhật ký đã ký của nó được xác minh. Phiên làm việc ban đầu vẫn có thể sử dụng được ở cả bốn định dạng được cung cấp. Cơ sở dữ liệu lỗi [RPC của Telegram](https://core.telegram.org/api/errors.json) liên kết `FRESH_CHANGE_ADMINS_FORBIDDEN` với việc thay đổi quản trị viên, `FRESH_CHANGE_PHONE_FORBIDDEN` với việc thay đổi số điện thoại, và `FRESH_RESET_AUTHORISATION_FORBIDDEN` với việc thu hồi các phiên khác, thay đổi thời hạn tồn tại của chúng hoặc đăng ký khóa truy cập. `SESSION_TOO_FRESH_*` và `PASSWORD_TOO_FRESH_*` liên quan đến việc chuyển nhượng quyền sở hữu và rút tiền thu nhập hoặc quà tặng. Đây không phải là các thao tác thu thập dữ liệu; việc đăng nhập mới không đồng nghĩa với lệnh cấm đọc toàn diện trong 24 giờ. Tính năng xuất dữ liệu có thể trả về `TAKEOUT_INIT_DELAY_*` riêng biệt. TgWitness giữ lại các khoảng tạm dừng do máy chủ yêu cầu và không tự động thử lại việc chấp nhận token hoặc thu hồi phiên để vượt qua các hạn chế. **Các công cụ khác → Tài khoản → Bảo mật tài khoản → Các phiên của tài khoản này → Kết thúc tất cả các phiên khác** sẽ gọi hàm ``auth.resetAuthorizations`` theo yêu cầu của nhà điều hành và ghi lại ``account.all_other_sessions_terminated`` kèm theo số lượng phiên trước và sau đó. Telegram chấp nhận yêu cầu này từ một phiên đã đăng nhập trong vòng 24 giờ. Khi không gian làm việc này đăng nhập bằng mã QR từ một phiên đã nhập, phiên đã phê duyệt nó vẫn duy trì trạng thái đăng nhập: TgWitness sẽ kết thúc các phiên còn lại lần lượt bằng hàm ``account.resetAuthorization`` và ghi lại vào trường ``kept_approving_session``. Khi**phiên này trở thành phiên duy nhất**, hệ thống sẽ dừng lại với lý do đó và không thay đổi mật khẩu. **Hãy đảm bảo đây là phiên làm việc duy nhất** thực hiện thao tác này đối với một khóa được tạo ra khi đăng nhập từ không gian làm việc này, sau đó kích hoạt tính năng xác thực hai bước nếu tài khoản chưa có. Bảng điều khiển sẽ hiển thị mật khẩu đó một lần duy nhất; TgWitness chỉ lưu trữ mật khẩu đó trong kho lưu trữ của không gian làm việc cho đến thời điểm đó. Nhật ký ghi lại `session.exclusive_from`. Nếu sau này Telegram liệt kê một phiên khác, nhật ký sẽ ghi lại `session.exclusive_ended` và bảng điều khiển sẽ hiển thị cảnh báo. Trình xác minh sẽ hiển thị cả hai thông tin này. **Đảm bảo đây là phiên duy nhất khi Telegram cho phép** thực hiện cùng một hành động theo lịch trình. Tùy chọn này xuất hiện trong **phần Phiên của tài khoản này** cho khóa được tạo trong không gian làm việc này và được ghi lại dưới dạng `session.exclusive_automatic`. Trong quá trình quan sát, bộ thu thập kiểm tra mỗi năm phút xem đã trôi qua 24 giờ kể từ bản ghi `account.authorized` của khóa đó hay chưa — Telegram trả về `FRESH_RESET_AUTHORISATION_FORBIDDEN` trước thời điểm đó — và sau đó thực hiện cùng một hoạt động một lần. Thành công được ghi lại dưới dạng `session.exclusive_from`, tương tự như nút bấm thủ công. Việc từ chối được ghi lại một lần dưới dạng `session.exclusive_postponed` kèm theo lý do từ Telegram, và trình thu thập dữ liệu sẽ thử lại với thời gian chờ tăng dần lên đến sáu giờ. Chế độ chỉ đọc không có tác dụng ở đây: việc kết thúc phiên là một hành động bảo mật tài khoản, không phải hành động trong cuộc trò chuyện. Mật khẩu hai bước được tạo ra bởi quá trình chạy tự động sẽ được lưu trữ trong kho lưu trữ của không gian làm việc, được mã hóa bằng khóa không gian làm việc, trước khi Telegram thiết lập mật khẩu này. Bảng điều khiển sẽ truy xuất mật khẩu này một lần từ `POST /api/account/sessions/only/password`, sau đó hệ thống sẽ xóa mật khẩu này, và hiển thị nó trong cùng một hộp thoại như quy trình thủ công khi quý vị mở **mục Phiên làm việc của tài khoản này**. Trang kết nối sẽ thông báo rằng có một mật khẩu đang chờ xử lý. Mật khẩu này không bao giờ được ghi vào nhật ký và vẫn tồn tại sau khi khởi động lại cho đến khi được hiển thị. Các phiên mới cũng được báo cáo trong quá trình quan sát: khi danh sách phiên của Telegram có thêm một mục, bản ghi `account.sessions` sẽ đặt tên cho mục đó dưới `added` và bảng điều khiển sẽ hiển thị cảnh báo kèm theo thiết bị, ứng dụng và quốc gia từ ảnh chụp nhanh đó. ### Thăm dò nhân chứng **Các công cụ khác → Tài khoản → Bảo mật tài khoản → Kiểm tra Probe của Witness** để xác minh liệu một khách hàng khác có nhận được các cập nhật từ tài khoản này hay không. Thêm một không gian làm việc thứ hai đã đăng nhập bằng tài khoản Telegram khác và có khóa phiên riêng, tạo một nhóm riêng tư với cả hai tài khoản, sau đó chọn nhóm đó làm **chat Probe** và không gian làm việc thứ hai làm **không gian làm việc Witness**, rồi bật tính năng Probe. Cả hai tài khoản phải tắt **chế độ Chỉ đọc**, và không gian làm việc Witness phải đang ở chế độ quan sát. Trong quá trình quan sát, không gian làm việc này gửi `probe::` vào nhóm mỗi 60–120 giây và ghi lại `probe.sent`. Nhân chứng trả lời `ack::` và ghi lại `probe.seen` cùng `probe.ack_sent`. Một xác nhận (ack) đến phiên làm việc này dưới dạng cập nhật trực tiếp trong vòng 20 giây sẽ được ghi lại là `probe.acked`. Nếu không, không gian làm việc sẽ đọc lịch sử gần đây của nhóm. Một tín hiệu xác nhận được tìm thấy ở đó nhưng không được gửi trực tiếp sẽ được ghi lại dưới dạng `coverage.gap` với lý do `probe_ack_missed_live`: bảng điều khiển sẽ phát cảnh báo và đánh dấu việc tiếp nhận sự kiện là thất bại cho đến khi một tín hiệu xác nhận sau đó đến trực tiếp (`connection.restored`, lý do `probe_ack_live`). Không có tín hiệu xác nhận nào được ghi lại dưới dạng `probe.unanswered`; sự gián đoạn kết nối trong thời gian chờ hoặc lịch sử không thể đọc được sẽ được ghi lại dưới dạng `probe.inconclusive`. Các trường hợp chỉ đọc, hạn chế của Telegram và các khoảng dừng FloodWait được ghi lại một lần dưới dạng `probe.skipped`. ### Telethon `.session` | | | | --- | --- | | Đây là gì | Cơ sở dữ liệu SQLite mà các công cụ dựa trên Telethon tạo ra, ví dụ như `my_account.session` | | Được công nhận bởi | Các bảng `sessions` (cùng với `dc_id`, `server_address`, `port`, `auth_key`) và `version` = 7 hoặc 8 | | Yêu cầu | Chính xác là một hàng phiên làm việc được ủy quyền; một cơ sở dữ liệu khép kín và hoàn chỉnh | Trước tiên, hãy đóng chương trình đã tạo ra tệp đó. Nếu tệp `my_account.session-journal` hoặc `my_account.session-wal` vẫn tồn tại bên cạnh tệp chính, điều đó có nghĩa là cơ sở dữ liệu chưa được hoàn tất: hãy mở và đóng ứng dụng khách gốc một cách đúng quy trình. Việc xóa các tệp phụ này có thể để lại một bản sao bị hỏng. ### Pyrogram `.session` | | | | --- | --- | | Đây là gì | Các công cụ dựa trên Pyrogram tạo ra cơ sở dữ liệu SQLite | | Được công nhận bởi | Bảng `sessions` với `dc_id`, `auth_key`, `test_mode`, `user_id`, `is_bot`; `version` = 2 hoặc 3 | | Yêu cầu | Chỉ chấp nhận một phiên đăng nhập **của người dùng** được ủy quyền trên mạng sản xuất. Các phiên của bot và máy chủ thử nghiệm (test-DC) sẽ bị từ chối | ID người dùng được lưu trữ sẽ được đối chiếu với hệ thống Telegram trong quá trình đăng nhập. ### Cặp phiên + JSON Các tài khoản thường được phân phối dưới dạng hai tệp có cùng tên, ví dụ như `447700900123.session` và `447700900123.json`. Vui lòng chọn **cả hai tệp** cùng một lúc. - Dựa trên dữ liệu JSON, TgWitness sử dụng các giao thức `app_id`/`api_id` và `app_hash`/`api_hash`, do đó quý vị thường không cần phải nhập thông tin đăng nhập API. - Cấu hình kết nối sử dụng `device_model` (biệt danh `device`), `system_version` (biệt danh `sdk`), `app_version`, `lang_code`, `system_lang_code` (biệt danh `system_lang_pack`), `lang_pack` và tùy chọn `tz_offset` (giây so với UTC, từ -43200 đến 50400). Các trường được cung cấp có ưu tiên cao hơn các giá trị mặc định được tạo tự động và ngôn ngữ của bảng điều khiển/trình duyệt . Các tên gọi khác nhau gây xung đột sẽ bị từ chối. Hồ sơ đã được giải quyết được lưu trong thông tin đăng nhập không gian làm việc được mã hóa và được tái sử dụng sau khi khởi động lại, bao gồm cả phiên bản ứng dụng của nó. - `phone`, cài đặt proxy và mã thông báo thiết bị được **bỏ qua**. `twoFA` chỉ ở chế độ đọc khi **Tạo ủy quyền độc lập** được chọn; nhập trực tiếp sẽ bỏ qua nó. - Một tệp JSON không có trường ủy quyền được hỗ trợ chỉ là siêu dữ liệu. Thêm tệp phiên làm việc của nó hoặc tiếp tục đăng nhập bằng điện thoại hoặc mã QR. Một tệp JSON chứa phiên làm việc được hỗ trợ hoặc Khóa ủy quyền (Auth Key) có thể tự thực hiện ủy quyền; xem [Account JSON](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#account-json). ### Telegram Desktop (TData) TData là thư mục `tdata` của ứng dụng Telegram Desktop (ứng dụng đa nền tảng từ desktop.telegram.org). | Hệ thống | Vị trí mặc định `tdata` | | --- | --- | | Windows | `%APPDATA%\Telegram Desktop\tdata` (phiên bản Telegram di động: bên cạnh `Telegram.exe`) | | Linux | `~/.local/share/TelegramDesktop/tdata` | | macOS | `~/Library/Application Support/Telegram Desktop/tdata` | Để nhập dữ liệu: > **Cảnh báo về phiên song song.** Nhập TData trực tiếp sẽ tái sử dụng khóa ủy quyền của Telegram Desktop. Không sử dụng khóa đó đồng thời trên Desktop và TgWitness. Telegram có thể vô hiệu hóa ủy quyền với `AUTH_KEY_DUPLICATED`, khiến cả hai bản sao không thể sử dụng được cho đến khi đăng nhập lại. > > > > Đóng hoàn toàn Desktop, bao gồm cả tiến trình trong khay hệ thống, và giữ bản sao đó ở trạng thái đóng trong khi TgWitness sử dụng phiên đã nhập. **: Đóng ứng dụng, không đăng xuất hoặc thu hồi phiên:** việc thu hồi cũng làm vô hiệu hóa bản sao đã nhập. Nếu bạn cần cả hai ứng dụng khách chạy cùng lúc, hãy chọn **Tạo ủy quyền độc lập** và giữ Desktop ở trạng thái đóng cho đến khi đăng nhập mới thành công, hoặc đăng nhập vào TgWitness bằng điện thoại hoặc mã QR. Nên sử dụng một tài khoản chuyên dụng, nhưng điều này không đảm bảo an toàn khi sử dụng các khóa nhân bản song song. > > > > Quy định này cũng áp dụng cho các `.session` , văn bản StringSession và mã khóa xác thực (Auth Key) dưới dạng HEX. Các ứng dụng khách khác có các phiên xác thực được tạo độc lập vẫn có thể duy trì trạng thái đã đăng nhập. Xin tham khảo [tài liệu về AUTH_KEY_DUPLICATED của Telegram](https://core.telegram.org/api/errors#406-not-acceptable). 1. Đóng hoàn toàn ứng dụng Telegram Desktop. 2. Vui lòng tạo một tệp ZIP **chỉ** chứa hai mục sau đây từ `tdata`: - `key_datas` - tệp gồm 16 ký tự kết thúc bằng `s` nằm ngay bên cạnh, thường là `D877F783D5D3EF8Cs` Việc nén toàn bộ thư mục cùng bộ nhớ đệm phương tiện thường vượt quá giới hạn (512 mục, 32 MiB sau khi giải nén). 3. Chọn tệp ZIP trong **phần Tệp**. Nếu Telegram Desktop có **mã thông báo cục bộ**, hãy nhập mã đó vào **ô Mã thông báo hoặc văn bản phiên** trước tiên. Đây không phải là mật khẩu xác thực hai yếu tố (2FA). Hỗ trợ: một tài khoản cho mỗi kho lưu trữ, công nghệ lưu trữ hiện đại `key_datas`/`key_data0`/`key_data1`, mã thông báo cục bộ. Không hỗ trợ: các thư mục chứa nhiều tài khoản đã đăng nhập, các giao diện Desktop cũ, các tệp ZIP được bảo vệ bằng mật khẩu, và ứng dụng gốc riêng biệt trên macOS có tên “Telegram for macOS”. ### Telethon StringSession Một dòng văn bản duy nhất, thường bắt đầu bằng `1` và dài khoảng 350 ký tự. Vui lòng tải tệp này dưới dạng tệp `.txt` hoặc `.tgwitness-session` (tối đa 4 KiB), hoặc dán vào phần **Mã thông báo hoặc văn bản phiên làm việc**. Chỉ chấp nhận các chuỗi Telethon; các chuỗi Pyrogram và TDLib sử dụng các định dạng khác. ### Khóa xác thực (Auth key) và DC trên cùng một dòng Danh sách tài khoản thường chứa thông tin ủy quyền thô dưới dạng `<512 hexadecimal characters>:`, ví dụ: `a1b2…ef:5`. Dán dòng đó vào trường **Passcode hoặc session text**, tải nó dưới dạng tệp văn bản, hoặc nhập vào trường `session` trong [JSON tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#account-json). TgWitness mapping các DC từ 1 đến 5 với các địa chỉ sản xuất tương ứng như trong quá trình nhập JSON `auth_key` + `dc_id` và báo cáo định dạng dưới dạng **Auth key HEX và DC**. Bất kỳ số DC hoặc độ dài khóa nào khác đều bị từ chối. ### Tệp JSON tài khoản Một đối tượng JSON, tối đa **64 KiB**, trong một tệp có phần mở rộng là **`.json`**. | Trường (tên gọi khác) | Ý nghĩa | | --- | --- | | `api_id` (`app_id`) | ID ứng dụng, một số dương | | `api_hash` (`app_hash`) | Băm ứng dụng, gồm 32 ký tự thập lục phân | | `string_session` (`session_string`, `session_str`; `session` cũ) | Văn bản Telethon StringSession, hoặc `<512 hexadecimal characters>:`, không phải là tên tệp | | `auth_key` (`auth_key_hex`) + `dc_id` | Khóa xác thực (Auth Key) đầy đủ gồm 512 ký tự và DC 1–5 | | `user_id` (`id`) | Tùy chọn; đã được đối chiếu với Telegram trước khi lưu thông tin ủy quyền | | `device_model` (`device`) | Mô tả thiết bị kết nối | | `system_version` (`sdk`) | Phiên bản hệ điều hành kết nối | | `app_version` | Phiên bản ứng dụng được gửi đến Telegram | | `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | Ngôn ngữ khách hàng, ngôn ngữ hệ thống và gói ngôn ngữ khách hàng; cho phép giá trị `lang_pack` trống | | `tz_offset` | Chênh lệch múi giờ UTC (tùy chọn) tính bằng giây, được gửi trong trường `initConnection.params`; chuỗi số nguyên hoặc số thập phân | Nếu cả tên gọi tắt và tên chính đều có mặt, chúng phải trùng khớp. Các trường phiên Telethon rõ ràng có ưu tiên cao hơn blob `session` chung chung ở định dạng khác. Nếu cả hai đều chứa các phiên Telethon có thể nhận diện được, chúng phải mô tả cùng một quyền truy cập. Nếu không có trường rõ ràng, `session` phải là một StringSession hợp lệ của Telethon hoặc khóa xác thực và DC dưới dạng `<512 hexadecimal characters>:`. Ví dụ: ``` { "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" } ``` ``` { "api_id": 1234567, "api_hash": "0123456789abcdef0123456789abcdef", "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS", "dc_id": 2, "user_id": 123456789 } ``` Ví dụ đầu tiên chỉ yêu cầu điền thông tin đăng nhập API; quý vị có thể đăng nhập qua số điện thoại hoặc mã QR, hoặc thêm tệp phiên làm việc. Các danh sách hàng loạt (mảng JSON chứa danh sách tài khoản) sẽ không được chấp nhận. ## Xác định những gì quý vị đang có | Quý vị có thể thấy | Đây là | Cách sử dụng | | --- | --- | --- | | `*.session`; khi mở tệp này trong trình soạn thảo văn bản, phần đầu sẽ hiển thị `SQLite format 3` | Telethon hoặc Pyrogram SQLite | **Tệp tin** (được phát hiện tự động) | | Một thư mục `tdata` chứa `key_datas` | Telegram Desktop TData | Nén hai tệp thành định dạng ZIP, sau đó là **các tệp** | | Một dòng văn bản bắt đầu bằng `1`, khoảng 350 ký tự | Telethon StringSession | **Tệp tin** | | Một dòng văn bản `512 characters 0-9a-f`, sau đó là `:` và một chữ số từ 1 đến 5 | Khóa xác thực và DC | **Tệp**, **mã PIN hộp hoặc văn bản phiên làm việc** | | `*.json` cùng với `app_id`/`app_hash` | Siêu dữ liệu đi kèm | **Các tệp tin**, cùng với phiên làm việc tương ứng | | `*.json` kết hợp với `auth_key` hoặc `string_session` | Tệp JSON tài khoản | **Tệp tin** | | 512 ký tự `0-9a-f` | Khóa xác thực | **Khóa xác thực** | | 32 ký tự `0-9a-f` | Băm API | **ID API + Băm** | | `td.binlog` hoặc `db.sqlite` từ ứng dụng TDLib | Bộ lưu trữ TDLib | Không được hỗ trợ | | `123456789:AA…` | Mã thông báo bot | Không được hỗ trợ | ## Các định dạng không được hỗ trợ | Định dạng | Lựa chọn thay thế | | --- | --- | | Bộ lưu trữ TDLib (`td.binlog`) và các tệp xuất từ TDLib | Đăng nhập bằng số điện thoại hoặc mã QR | | **Các chuỗi** phiên làm việc của Pyrogram | Vui lòng sử dụng tệp Pyrogram `.session`, hoặc quét mã QR bằng điện thoại | | TData với nhiều tài khoản đã đăng nhập | Vui lòng đăng xuất khỏi các tài khoản khác trên Telegram Desktop, hoặc sử dụng tệp phiên làm việc riêng của từng tài khoản | | Mã thông báo bot | Không được hỗ trợ: TgWitness chỉ thực hiện quan sát với tư cách là một tài khoản người dùng | | Danh sách CSV/JSON của nhiều tài khoản | Nhập các tệp phiên được hỗ trợ qua **Tài khoản → Nhập tài khoản**, hoặc đăng nhập bằng số điện thoại/mã QR trong các không gian làm việc riêng biệt | | Các phiên thử nghiệm (Test-DC) hoặc phiên bot | Vui lòng sử dụng tài khoản người dùng chính thức | ## Nhiều tài khoản Nhấn vào **biểu tượng +** bên cạnh trình chọn tài khoản, hoặc mở **Công cụ khác → Tài khoản → Cài đặt → Cài đặt kết nối → Không gian làm việc**, nhập nhãn và đăng nhập. - Bất kỳ số lượng không gian làm việc nào, bao gồm cả không gian làm việc chính. Mỗi không gian làm việc đều có phiên làm việc, tuyến đường proxy , nguồn dữ liệu, chính sách ghi lại, sổ nhật ký, khóa ký, điểm kiểm tra và các tùy chọn xuất dữ liệu riêng biệt. - Việc chuyển đổi không gian làm việc đang hiển thị sẽ không làm tạm dừng các không gian làm việc khác. - Một sổ ghi chép luôn gắn liền với tài khoản đã tạo ra nó. Việc đăng nhập bằng một tài khoản khác yêu cầu phải có một không gian làm việc riêng, và một tài khoản không thể được gán cho hai không gian làm việc. - Token bảng điều khiển chính quản lý tất cả các không gian làm việc. [Quyền truy cập được cấp](https://phishdestroy.io/tgwitness/vi/docs/reference/access/) có thể giới hạn quyền của người khác đối với các tài khoản và cuộc trò chuyện đã chọn, kèm theo các quyền truy cập riêng biệt và giới hạn phiên làm việc. - **Tài khoản** sẽ đổi tên một không gian làm việc và xóa một không gian làm việc đã thêm vào, cùng với phiên làm việc, nhật ký, các nguồn và khóa ký của không gian đó. Không gian làm việc chính không thể bị xóa khỏi bảng điều khiển. ### Nhập hàng loạt và nhóm tài khoản Sử dụng **Accounts → Import accounts** để thêm nhiều tài khoản, ghép nối các tệp theo tên gốc và xem kết quả đăng nhập của từng tài khoản. Mỗi tài khoản sẽ có không gian làm việc riêng. Một nhóm giúp tập hợp các tài khoản có liên quan lại với nhau mà không hợp nhất các phiên, khóa hoặc bằng chứng của chúng. **Mở nhóm** trên **Tài khoản** dẫn đến trang của nó tại `/groups/`: - **Tài khoản:** lộ trình kết nối, thông tin quan sát và tin nhắn cuối cùng của từng thành viên, kèm theo Bắt đầu**tất cả** và **Tạm dừng tất cả**. - **Cần chú ý:** các tài khoản đã đăng xuất, không khả dụng hoặc gặp vấn đề về kết nối, nhập liệu, nguồn hoặc phương tiện; mỗi tên sẽ dẫn đến thẻ thông tin tương ứng. - **Các cuộc trò chuyện trên nhiều tài khoản hiển thị:** các nguồn được chia sẻ, các tài khoản đang theo dõi chúng và các gián đoạn trong khoảng thời gian quan sát không gian làm việc có sẵn (tối đa bảy ngày). **Khi xuất với N tài khoản,** quá trình xuất kênh hoặc siêu nhóm sẽ được chia đều giữa các tài khoản này và tạo ra một tệp lưu trữ duy nhất. - **Xuất nhóm:** một ZIP chứa bản xuất đã được ký của từng tài khoản dưới `accounts/` và `manifest.json` liệt kê các SHA-256 và dấu vân tay khóa của chúng, được ký bởi không gian làm việc chính trong `manifest.signature.json`. Xác minh từng bản lưu trữ tài khoản riêng lẻ bằng `python -m tgwitness.verify` và dấu vân tay đáng tin cậy của tài khoản đó. Các thành viên chia sẻ cài đặt chung của nhóm; mỗi tài khoản có thể giữ nguyên các giá trị riêng của mình. Xem [phần cài đặt chung](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/#account-groups), [hướng dẫn nhập dữ liệu và quản lý nhóm](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) cùng với [bảng điều khiển nhóm MTProxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources). ## Đăng xuất **Các công cụ khác → Tài khoản → Đăng xuất khỏi Telegram** (với việc quan sát tạm dừng) yêu cầu Telegram kết thúc phiên làm việc, do đó phiên này cũng biến mất khỏi mục **Cài đặt → Thiết bị** của tài khoản và xóa phiên làm việc khỏi kho lưu trữ không gian làm việc. Nhật ký, nguồn, cài đặt và khóa ký vẫn được giữ lại, và nhật ký ghi lại thao tác đăng xuất. Không gian làm việc vẫn thuộc về tài khoản của nó: chỉ có tài khoản đó mới có thể kết nối lại với nó. Nếu Telegram không phản hồi, phiên vẫn bị xóa tại đây và bảng điều khiển sẽ thông báo điều đó; hãy kết thúc phiên trong Telegram tại **Cài đặt → Thiết bị**. ## Khi Telegram kết thúc phiên làm việc Nếu Telegram khóa, đóng băng hoặc đăng xuất tài khoản, hoặc kết thúc phiên làm việc từ một thiết bị khác, nhật ký sẽ ghi lại nguyên nhân, lỗi của Telegram, tuyến đường và trung tâm dữ liệu. Tình trạng của tài khoản hiển thị **“Tải xuống báo cáo mất tài khoản**”: một tệp JSON đã được ký số chứa các bản ghi nhật ký trong 24 giờ trước khi mất tài khoản, bao gồm các kết nối, tuyến đường, phiên làm việc, thông báo tài khoản và các khoảng trống trong phạm vi phủ sóng, mỗi mục đều có băm nhật ký và chữ ký riêng. Kiểm tra bằng `python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP`; tệp xuất bằng chứng chứa chuỗi băm hoàn chỉnh. Tài khoản bị đóng băng cũng được phát hiện khi nó kết nối và trong quá trình theo dõi, đồng thời các hành động gửi và tham gia của tài khoản đó sẽ bị tắt. ## Bảo vệ an toàn cho các tệp tài khoản - Hãy coi mọi `.session`, TData ZIP, StringSession, Auth Key và tệp JSON tài khoản như một mật khẩu. TgWitness lưu trữ thông tin ủy quyền đã nhập vào kho lưu trữ được mã hóa của mình; quý vị có thể xóa các tệp gốc sau đó. - Không được thực hiện cùng một quy trình ủy quyền trên hai chương trình cùng lúc. Telegram có thể thu hồi ủy quyền đó (`AUTH_KEY_DUPLICATED`), và cả hai bản sao sẽ ngừng hoạt động. - Một phiên làm việc đã hết hạn hoặc bị thu hồi không thể được khôi phục thông qua quá trình chuyển đổi. Vui lòng đăng nhập lại. ## Khắc phục sự cố | Tin nhắn hoặc triệu chứng | Hướng dẫn thực hiện | | --- | --- | | *Không thể đọc phiên làm việc này. Vui lòng đóng ứng dụng gốc…* | Tệp SQLite hiện đang mở hoặc chưa hoàn tất (tệp phụ `-journal`/`-wal`). Vui lòng đóng chương trình gốc một cách đúng quy trình và sao chép lại tệp. | | *Các lược đồ SQLite của Telethon được hỗ trợ: 7 và 8* / *Pyrogram … 2 và 3* | Tệp này được tạo ra bởi một phiên bản thư viện rất cũ hoặc không xác định. Vui lòng đăng nhập bằng số điện thoại hoặc mã QR thay thế. | | *Chỉ hỗ trợ các phiên làm việc của người dùng được ủy quyền* | Tệp Pyrogram này thuộc về một bot hoặc mạng thử nghiệm. | | *Kho lưu trữ TData đã vượt quá 512 mục hoặc 32 MiB* | Chỉ bao gồm các tệp ZIP `key_datas` và `D877F783D5D3EF8Cs`, không bao gồm toàn bộ thư mục. | | *Không thể giải mã TData. Vui lòng kiểm tra mật mã cục bộ trên máy tính để bàn* | Vui lòng nhập mã mật khẩu cục bộ của Telegram Desktop vào ô **“Mật khẩu” hoặc “Văn bản phiên làm việc**”. | | *Nhập từng tài khoản TData một* | Telegram Desktop hỗ trợ nhiều tài khoản; vui lòng tham khảo phần [“Các định dạng không được hỗ trợ](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#unsupported-formats)”. | | *Các tệp được chọn mô tả các tài khoản hoặc thông tin đăng nhập API khác nhau* | Chỉ chọn các tệp tin từ một tài khoản duy nhất. | | *Tệp JSON không chứa thông tin xác thực hoặc ủy quyền API nào được hỗ trợ* | Vui lòng kiểm tra các tên trường trong tệp [JSON Tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#account-json). | | *Chỉ bao gồm siêu dữ liệu API* | Tệp JSON không có phiên làm việc. Vui lòng thêm tệp `.session` hoặc sử dụng số điện thoại/mã QR. | | *Mã khóa xác thực (Auth Key) dưới dạng HEX phải chứa đầy đủ 512 ký tự thập lục phân* | Khóa đã bị cắt ngắn hoặc chứa chuỗi ký tự "`…`". | | ID tài khoản không khớp với tài khoản đã nhập | ID người dùng trong tệp này khác với thông tin mà Telegram báo cáo; tệp này thuộc về một tài khoản khác. | | Tài khoản này hiện đã thuộc về một không gian làm việc khác | Vui lòng mở không gian làm việc đó thay vì thêm tài khoản hai lần. | | Đã kết nối, nhưng thiếu một nhóm riêng tư trong danh sách trò chuyện tại **Công cụ khác → Nguồn** | Kiểm tra tư cách thành viên. Trình chọn sẽ kiểm tra 1,000 cuộc đối thoại đầu tiên; tăng giới hạn tại mục **Công cụ khác → Tham số**. | | Kết nối proxy không thành công | Kiểm tra chế độ định tuyến và IP. Tự động MTProxy sẽ thử một mục nhập khác đang hoạt động. Chế độ ẩn địa chỉ sẽ chờ; chế độ Trực tiếp (Direct) là phương án cuối cùng, có thể kết nối trực tiếp sau thời gian trễ đã cấu hình. Xem [các chế độ định tuyến](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/#ip-modes). | Xem thêm: các vấn đề về [kết nối và bảo mật](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/) liên quan đến máy chủ proxy và mã hóa, cũng như [cách thức thu thập dữ liệu](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/) đối với những nội dung được ghi lại sau khi đăng nhập. --- # Telegram · Quyền truy cập và quyền hạn Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/access/ Quản lý quyền truy cập vào các tài khoản và cuộc trò chuyện, chọn quyền hạn, giới hạn phiên truy cập và địa chỉ IP, cũng như thu hồi quyền truy cập. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Quản lý quyền truy cập vào các tài khoản và cuộc trò chuyện, chọn quyền hạn, giới hạn phiên truy cập và địa chỉ IP, cũng như thu hồi quyền truy cập. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bắt đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/) ![Bắt đầu](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) Cấp quyền truy cập cho người đánh giá vào một cuộc trò chuyện, cấp quyền cho nhà phân tích để xuất dữ liệu vụ việc, hoặc cấp quyền kiểm soát các tài khoản đã chọn cho người vận hành. Mỗi người sẽ nhận được mã thông báo riêng. Mã thông báo trên bảng điều khiển chính sẽ do quản trị viên nắm giữ. [Thiết lập tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/) · [Các tuyến kết nối](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/) · [Mô hình bảo mật](https://phishdestroy.io/tgwitness/vi/docs/reference/security/) ## Hai phạm vi, hai nhiệm vụ khác nhau **Phạm vi thu thập** quyết định những gì một tài khoản sẽ ghi lại: các cuộc trò chuyện được chọn, một thư mục Telegram hoặc toàn bộ tài khoản. **Phạm vi truy cập** quyết định những tài khoản và cuộc trò chuyện đã được ghi lại nào mà người khác có thể xem và sử dụng. Việc cấp quyền truy cập không đồng nghĩa với việc tham gia cuộc trò chuyện trên Telegram, bắt đầu quá trình thu thập hay cấp quyền truy cập vào tài khoản Telegram. Một quyền truy cập có thể mở các không gian làm việc được chọn, các cuộc trò chuyện được chọn trong đó, tất cả các không gian làm việc hoặc mọi tài khoản trong một [nhóm tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#bulk-import-and-account-groups). **Tất cả các không gian làm việc, bao gồm cả những không gian được thêm vào sau này**, cũng bao gồm các tài khoản trong tương lai. Quyền truy cập nhóm cũng bao gồm các tài khoản được thêm vào nhóm đó sau này. Hãy chọn các không gian làm việc một cách rõ ràng khi một vụ việc cần được giới hạn trong phạm vi của chúng. ## Cấp quyền truy cập cho ai đó 1. Đăng nhập với tư cách quản trị viên chính và mở **Công cụ khác → Quyền truy cập**. 2. Trong phần **“Cấp quyền truy cập cho ai đó**”, vui lòng nhập tên mà quý vị có thể nhận ra trong nhật ký. 3. Vui lòng chọn các không gian làm việc và, khi cần thiết, các cuộc trò chuyện riêng lẻ. 4. Vui lòng chọn những hành động mà người này có thể thực hiện. Tính năng **“Xem”** luôn được bao gồm. 5. Vui lòng thiết lập thời hạn hiệu lực, giới hạn đăng nhập/phiên làm việc và các địa chỉ được phép theo nhu cầu. 6. Nhấn vào **“Tạo quyền truy cập**”. Sao chép mã thông báo ngay bây giờ: mã này chỉ hiển thị một lần duy nhất. 7. Vui lòng gửi địa chỉ bảng điều khiển và mã thông báo một cách riêng tư. Người nhận sẽ nhập mã thông báo đó trên trang đăng nhập thông thường; họ không cần mã thông báo bảng điều khiển chính của quý vị hay phiên Telegram nào cả. Vui lòng mở bảng điều khiển có chứa mã thông báo đã được cấp trong một phiên trình duyệt riêng biệt và kiểm tra các cuộc trò chuyện hiển thị cũng như các thao tác được phép trước khi chuyển giao mã thông báo này. Tên quyền truy cập được lưu trữ trong bộ nhớ cục bộ được mã hóa và được giải quyết thông qua bảng điều khiển của quản trị viên. Tên được loại bỏ khỏi các bản ghi kiểm toán về quyền truy cập mới và việc tạo không gian làm việc; các bản ghi đã ký hiện có vẫn giữ nguyên các trường ban đầu. ## Chọn các quyền truy cập Để thực hiện trình diễn công khai chỉ chứa văn bản, hãy sử dụng **“Trình diễn công khai”** thay vì quyền truy cập người đánh giá thông thường. Tính năng này hiển thị các kênh công khai được chọn rõ ràng, các thao tác chỉnh sửa và xóa đã được lưu giữ, cùng với số liệu thống kê đã được ký xác nhận, trong đó các trường tác giả được che đi và các tệp được đóng lại tại ranh giới API. [Tạo và xác minh một trình diễn](https://phishdestroy.io/tgwitness/vi/docs/reference/showcase/). | Quyền sử dụng | Các tính năng mà công cụ này cung cấp | | --- | --- | | `view` | Xem các cuộc trò chuyện được phép truy cập, tin nhắn đã ghi lại, hồ sơ cá nhân, tệp tin và các bản ghi nhật ký đã được lọc. Luôn được bao gồm đầy đủ. | | `export` | Cho phép xuất lịch sử trò chuyện và hồ sơ. Việc xuất toàn bộ bằng chứng trong không gian làm việc yêu cầu quyền truy cập vào toàn bộ không gian làm việc đó. | | `sources` | Quản lý nguồn, ảnh chụp nhanh và thu thập thông tin hồ sơ. Quyền truy cập giới hạn theo cuộc trò chuyện chỉ có hiệu lực đối với các cuộc trò chuyện được phép; việc phát hiện nguồn và cài đặt phạm vi trên toàn tài khoản vẫn được giữ ở trạng thái đóng. | | `collect` | Khởi động hoặc dừng trình thu thập dữ liệu. Yêu cầu quyền truy cập toàn bộ không gian làm việc vì quá trình thu thập sẽ ảnh hưởng đến tài khoản. | | `interact` | Thực hiện các tương tác được hỗ trợ trên Telegram trong phạm vi quyền truy cập. Quyền truy cập giới hạn ở chế độ trò chuyện không thể sử dụng tính năng xem trước liên kết trên toàn tài khoản. | | `settings` | Thay đổi cài đặt thu thập dữ liệu, dấu thời gian, thông báo, bản sao lưu ngoài trang web và các thông số. Yêu cầu quyền truy cập toàn bộ không gian làm việc. | | `account` | Đăng nhập hoặc đăng xuất khỏi Telegram và quản lý các tuyến kết nối. Yêu cầu quyền truy cập toàn bộ không gian làm việc. | | `board.read` | Chỉ được đọc các ghi chú trên Bảng vụ án trong phạm vi không gian làm việc và các cuộc trò chuyện được phép. | | `board.write` | Thêm dấu trang, đánh dấu nổi bật, đoạn trích, bình luận và trạng thái mở/xem lại. Cũng cần có chức năng ``board.read``. | | `board.manage` | Quản lý các bộ sưu tập, trạng thái cuối cùng của nhóm và thẻ của các thành viên khác. Ngoài ra, cần quyền đọc/ghi trên bảng điều khiển. | Chỉ quản trị viên chính mới có thể tải xuống khóa khôi phục bản sao ngoài trang web. Quyền truy cập `settings` hoặc `account` được ủy quyền không cấp quyền truy cập vào khóa đó. Quyền truy cập và phạm vi sẽ được kiểm tra đồng thời. Việc chọn một quyền truy cập sẽ không mở các cuộc trò chuyện khác hoặc kích hoạt thao tác trên toàn không gian làm việc đối với quyền truy cập bị giới hạn trong một cuộc trò chuyện cụ thể. Để thực hiện xuất song song, quyền truy cập phải bao gồm cuộc trò chuyện được xuất trong mọi tài khoản đã chọn. Một quyền truy cập đã được cấp không thể tạo ra các quyền truy cập mới, quản lý các phiên làm việc của người khác hoặc mở bảng điều khiển quản trị viên. ### Ba cách thiết lập hữu ích | Người | Phạm vi | Quyền truy cập | | --- | --- | --- | | Người đánh giá | Các cuộc trò chuyện được ghi lại trong một vụ việc | `view` | | Chuyên viên phân tích đang chuẩn bị bàn giao công việc | Các cuộc trò chuyện cần điều tra và xuất dữ liệu | `view`, `export`; chỉ thêm `interact` nếu họ cần thực hiện các thao tác thông qua Telegram | | Nhân viên thu thập dữ liệu | Các không gian làm việc được chọn lọc | `view`, `sources`, `collect`; chỉ thêm `settings` hoặc `account` khi cần thiết | Các cài đặt mặc định ban đầu của biểu mẫu Access cũng bao gồm Bảng vụ việc: Người xem xét có thể đọc, Nhà phân tích có thể đọc và viết, còn Người vận hành có thể quản lý. Các cài đặt mặc định vẫn có thể chỉnh sửa, và các quyền truy cập hiện có sẽ không được mở rộng tự động. Xem [Bảng vụ việc](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/) để biết phạm vi trò chuyện được kế thừa và quyền riêng tư khi xuất dữ liệu. ## Giới hạn và phiên làm việc | Bối cảnh | Cách thức hoạt động | | --- | --- | | Các phiên họp song song | Hạn chế số phiên truy cập đồng thời từ 1 đến 100. Khi đạt đến giới hạn này, hệ thống sẽ từ chối lần đăng nhập tiếp theo hoặc kết thúc phiên truy cập lâu đời nhất. | | Cho phép đăng nhập | Hạn chế số lần sử dụng thành công mã thông báo để bắt đầu các phiên làm việc. Các phiên làm việc hiện có sẽ không bị kết thúc chỉ vì lần đăng nhập được phép cuối cùng đã được sử dụng. | | Hiệu lực đến | Thời hạn truy cập đã hết hiệu lực hoàn toàn. Tài khoản đã hết hạn không thể đăng nhập hoặc tiếp tục thực hiện các yêu cầu. | | Thời gian không có hoạt động | Thời gian chờ do không hoạt động trong phiên, từ 5 phút đến 30 ngày. Các yêu cầu thành công sẽ gia hạn thời gian này; một bảng điều khiển đang mở có thể duy trì trạng thái hoạt động bằng cách thực hiện các yêu cầu kiểm tra định kỳ. | | Các địa chỉ được phép | Chấp nhận các địa chỉ IP cụ thể hoặc các mạng con CIDR. Để trống để cho phép bất kỳ địa chỉ nào, trừ khi tính năng ràng buộc lần đăng nhập đầu tiên được kích hoạt. | | Liên kết với lần đăng nhập đầu tiên | Lần đăng nhập thành công đầu tiên sẽ xác định địa chỉ được phép cho lần truy cập đó. | Địa chỉ IP là địa chỉ máy khách mà ứng dụng nhận diện được. Trong trường hợp sử dụng proxy ngược hoặc đường hầm, vui lòng kiểm tra địa chỉ hiển thị trong **phần “Các phiên đang mở”** trước khi áp dụng các quy tắc dựa trên IP: nếu không, nhiều người dùng có thể bị nhận diện là đang chia sẻ cùng một địa chỉ proxy. ## Thay đổi hoặc thu hồi quyền truy cập Chỉnh sửa một mục trong **phần “Granted access” (Quyền truy cập đã cấp)** để thay đổi phạm vi, quyền hoặc giới hạn của nó. Các thay đổi về phạm vi và quyền sẽ được kiểm tra trên các yêu cầu tiếp theo, bao gồm các yêu cầu từ các phiên đang mở. Việc thu hồi quyền truy cập sẽ kết thúc các phiên đó và khiến mã thông báo đã cấp không còn sử dụng được. **Tính năng “Open sessions” (Phiên đang mở)** cũng cho phép quản trị viên kết thúc một phiên riêng lẻ mà không cần thu hồi toàn bộ quyền truy cập. Các bản sao xuất đã lưu giữ nguyên thông tin về người tạo, không gian làm việc, phạm vi trò chuyện và quyền truy cập cần thiết. Một quyền truy cập đã cấp chỉ có thể liệt kê hoặc tải xuống các bản sao của chính nó khi các quyền đó vẫn còn hiệu lực; các bản sao chứa Bảng trường hợp (Case Board) cũng yêu cầu quyền `board.read`. Quản trị viên có thể truy xuất tất cả các bản sao. Các bản sao cũ hơn không có siêu dữ liệu này và các gói nhóm chỉ dành riêng cho quản trị viên. Vé tải xuống và các phản hồi tệp đã chuẩn bị sẽ kiểm tra lại quyền truy cập sau khi chuẩn bị tệp, trước khi gửi các byte của tệp đó. Mỗi quyền truy cập, bao gồm cả quản trị viên, có thể giữ mười vé tải xuống đang chờ xử lý cho mỗi không gian làm việc; giới hạn cho toàn bộ không gian làm việc là 1,000. Vé hết hạn sau 120 giây và chỉ sử dụng một lần. Việc thu hồi không thể khôi phục các tệp mà người dùng đã tải xuống. Việc đăng xuất, khóa bảng điều khiển hoặc kết thúc phiên làm việc sẽ không làm dừng trình thu thập đang hoạt động. ## Những thông tin mà quản trị viên có thể xem Người đánh giá và nhà phân tích nhận được tiến độ thu thập dữ liệu mà không kèm theo các điểm cuối proxy, chẩn đoán nhóm, đường dẫn máy chủ hoặc lỗi kết nối thô. Chẩn đoán kết nối yêu cầu quyền `account` trên toàn bộ không gian làm việc. Việc đọc thông báo, sao chép ngoài hệ thống và cài đặt tham số yêu cầu quyền `settings`. Các chuỗi User-Agent đầy đủ trong trình duyệt không được lưu giữ trong các phiên truy cập. Việc nâng cấp cũng xóa chúng khỏi bộ nhớ đệm phiên có thể thay đổi. Nhật ký quá trình của bảng điều khiển che giấu các địa chỉ IP, thông tin xác thực URL và các bí mật được gắn nhãn. Nhật ký dịch vụ cục bộ và các bản ghi nhật ký đã được ký trước đó không bị ghi đè. Các quy tắc truy cập và bản ghi đăng nhập đã được ký vẫn sử dụng địa chỉ của máy khách. ### Thay thế khóa chính Sử dụng **Công cụ khác → Truy cập → Giới hạn của tôi → Phát hành lại khóa quản trị viên**, hoặc chạy lệnh `tgwitness token rotate` từ một bản cài đặt được quản lý trong khi bảng điều khiển đang chạy. Tất cả các phiên trình duyệt hiện có sẽ kết thúc, bao gồm cả các phiên được mở bằng token đồng nghiệp. Trình duyệt yêu cầu sẽ nhận được một phiên mới; hãy lưu khóa quản trị viên mới trước khi ẩn nó đi. Các token đồng nghiệp đã được cấp vẫn có hiệu lực cho đến khi bị thu hồi riêng biệt. Một bản cài đặt sử dụng `TGWITNESS_TOKEN` phải thay đổi cài đặt môi trường đó và khởi động lại. ### Ranh giới yêu cầu và proxy API cho phép tối đa 600 yêu cầu mỗi phút cho mỗi khách hàng và nhóm thông tin xác thực: panel, archive/MCP hoặc witness. Thời gian chờ xác thực được tính riêng cho từng nhóm này. Mười lần xác thực bị từ chối trong vòng một phút sẽ kích hoạt thời gian chờ theo cấp số nhân, từ một giây lên đến năm phút. Một lần thử không thành công sau khi hết thời gian chờ sẽ làm tăng thời gian chờ; mười phút không có lần thử không thành công sẽ đặt lại mức tăng. Các yêu cầu bị từ chối trả về mã trạng thái HTTP 429 và `Retry-After` . Các giới hạn được lưu trữ trong bộ nhớ, được chia sẻ giữa các không gian làm việc trong một quy trình panel; việc khởi động lại sẽ xóa các giới hạn này. Các luồng trực tiếp bị giới hạn ở bốn luồng cho mỗi token bearer và 32 luồng cho quy trình panel. Việc mở một luồng cũng tiêu tốn ngân sách yêu cầu API. Nội dung yêu cầu có thời hạn nhận là 60 giây, giảm xuống còn 10 giây đối với đăng nhập, truy cập demo, API lưu trữ và các đường dẫn đầu chứng nhân, hoặc 8 giây đối với giao thức MCP. Mỗi ứng dụng cho phép bốn nội dung chưa hoàn thành cho mỗi địa chỉ khách hàng, với giới hạn tổng cộng là 32 và 64 MiB dung lượng đường dẫn được phân bổ. Các yêu cầu không có nội dung không tiêu tốn các khe này. Nội dung quá khổ trả về 413, nội dung hết thời gian chờ trả về 408, và trường hợp vượt quá dung lượng khách hàng trả về 429 kèm `Retry-After: 1`. Khi dung lượng tổng thể cho nội dung đã cạn kiệt, hệ thống sẽ trả về mã trạng thái 503 kèm theo `Retry-After`. Các tiêu đề IP được chuyển tiếp sẽ bị bỏ qua trừ khi đối tác TCP thực sự thuộc về `TGWITNESS_TRUSTED_PROXIES` (các địa chỉ IP hoặc CIDR được phân tách bằng dấu phẩy). Đặt `TGWITNESS_PROXY_HEADER` thành `x-forwarded-for` hoặc `cf-connecting-ip`. XFF được di chuyển từ proxy gần nhất đến đối tác không đáng tin cậy đầu tiên. Siêu dữ liệu địa chỉ đáng tin cậy bị lỗi hoặc trùng lặp sẽ bị từ chối, do đó nó không thể kế thừa địa chỉ proxy trong danh sách cho phép. Đường hầm nhanh được quản lý tin tưởng trình kết nối cloudflared cục bộ; thiết lập miền riêng tin tưởng Caddy cục bộ. Các triển khai trực tiếp mặc định không tin cậy bất kỳ proxy nào. Nếu tự khởi chạy Uvicorn, hãy vô hiệu hóa tính năng xử lý tiêu đề proxy của nó để ranh giới này nhận được peer thực tế. `TGWITNESS_PANEL_ALLOWED_IPS` hạn chế toàn bộ quyền truy cập bảng điều khiển, bao gồm cả quản trị viên, chỉ cho phép từ các địa chỉ IP hoặc CIDR được liệt kê. Công cụ kiểm tra định danh định tuyến của trình cài đặt vẫn ở chế độ công khai và không trả về dữ liệu tài khoản. Hãy bao gồm đường dẫn quản trị cục bộ bắt buộc trước khi kích hoạt danh sách cho phép. Hướng dẫn **START-HERE** dành cho cài đặt được quản lý bao gồm các hướng dẫn cấu hình dịch vụ và khôi phục. Bộ chọn truy vấn API `ws` phải xác định không gian làm việc trong đường dẫn yêu cầu; các bộ chọn không xác định, không khớp hoặc trùng lặp sẽ bị từ chối với mã trạng thái 404. Các tập lệnh và kiểu dáng của bảng điều khiển chứa siêu dữ liệu tính toàn vẹn SHA-384. Bản đồ nhập (import map) cũng bao gồm các mô-đun JS được nhập cục bộ trong các trình duyệt hỗ trợ tính toàn vẹn của import-map. Phản hồi ngôn ngữ được tạo động là một phần riêng biệt. Các kiểm tra này phát hiện việc thay thế tài sản so với trang được phân phối; bản thân trang và các hàm băm của nó đến từ máy chủ bảng điều khiển, do đó hãy bảo vệ máy chủ đó và đường dẫn phân phối của nó. **Nhật ký kể từ khi bắt đầu này** kết hợp các bản ghi quá trình với hoạt động nhật ký từ mọi không gian làm việc: các lần đăng nhập, từ chối, thay đổi lộ trình và hành động của người vận hành. Đây là một bảng điều khiển trong bộ nhớ dành cho quá trình hiện tại, chứ không phải bản sao vĩnh viễn của mọi tin nhắn. Các sự kiện tin nhắn xảy ra thường xuyên sẽ được lưu trong nhật ký thay vì làm đầy bảng điều khiển. Việc cấp, thay đổi và thu hồi quyền truy cập, cũng như bắt đầu hoặc kết thúc phiên làm việc, đều tạo ra các bản ghi nhật ký `access.*` được ký điện tử. Các mã thông báo (token) không được bao gồm trong các bản ghi này. Các mã thông báo đã được cấp và thông tin xác thực phiên làm việc được lưu giữ dưới dạng băm (hash) trong kho lưu trữ được mã hóa. Một đăng nhập QR đang chờ xử lý thuộc về phiên bảng điều khiển đã khởi tạo nó. Việc kết thúc hoặc hủy bỏ phiên đó, hoặc xoay vòng mã thông báo bảng điều khiển chính, sẽ hủy bỏ yêu cầu đăng nhập QR đang chờ xử lý trên máy chủ. Điều này cũng áp dụng khi trình duyệt không thể gửi yêu cầu hủy bỏ của riêng mình. Việc xoay vòng mã thông báo cũng hủy bỏ các lần đăng nhập QR được khởi tạo trực tiếp bằng mã thông báo bảng điều khiển chính. Một yêu cầu QR đang chờ một thao tác khác sẽ kiểm tra quyền truy cập lại trước khi bắt đầu. Các ủy quyền Telegram đã hoàn tất và các lần đăng nhập đang chờ xử lý được khởi tạo bởi một phiên bảng điều khiển khác sẽ được giữ nguyên. ****Quản trị viên chính và ranh giới tin cậy**** Thẻ bảng điều khiển chính vẫn không bị hạn chế. Việc đăng nhập trình duyệt bằng thẻ này sẽ tạo ra các phiên tuân theo giới hạn phiên do quản trị viên cấu hình. Các tập lệnh gửi thẻ chính trực tiếp vẫn giữ quyền truy cập đầy đủ và không được tính là các phiên trình duyệt. Đây là cơ chế kiểm soát truy cập cấp ứng dụng trong một lần cài đặt. Tất cả các không gian làm việc đều chia sẻ quá trình máy chủ; điều này không có nghĩa là cách ly khỏi quản trị viên máy chủ. Giữ bí mật mã thông báo chính, các phiên Telegram, khóa ký và thư mục dữ liệu. Mã thông báo chứng kiến là một chứng chỉ kiểm tra trạng thái/điểm kiểm tra riêng biệt, không phải là mã thông báo truy cập bảng điều khiển. --- # Telegram · Kết nối, máy chủ trung gian và bảo vệ dữ liệu Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/connection/ Xác thực, nhóm proxy tự động, chế độ IP, chính sách dự phòng, yêu cầu bên ngoài và lưu trữ khóa bí mật. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Xác thực, nhóm proxy tự động, chế độ IP, chính sách dự phòng, yêu cầu bên ngoài và lưu trữ khóa bí mật. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Triển khai và khôi phục](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) ![Triển khai & khôi phục](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Tài liệu này mô tả hành vi của TgWitness0.9.3 và các giới hạn của nó. Xác thực, quyền truy cập nguồn, kết nối mạng và tính đầy đủ của dữ liệu thu thập là các trạng thái riêng biệt. Để biết các bước đăng nhập, định dạng tệp và quản lý nhiều tài khoản, hãy bắt đầu với [các định dạng tài khoản và phiên làm việc](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/). Để biết chính sách sự kiện và hành vi khởi động lại, hãy xem [cách thức hoạt động của quá trình thu thập](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/). ## Hướng dẫn thiết lập kết nối Trong **Các công cụ khác → Tài khoản → Đường dẫn kết nối**, người quản trị có thể chọn **Tài khoản này**, **Một tài khoản nhóm** hoặc **Tất cả các tài khoản**, sau đó chọn một lộ trình. **Lựa chọn bài đánh giá** liệt kê các tài khoản bị ảnh hưởng. **Chuẩn bị và kiểm tra** kiểm tra lộ trình được đề xuất mà không thay đổi lộ trình đã lưu. **Áp dụng kết nối đã được kiểm tra** xác nhận bản xem trước, tạm dừng quá trình quan sát nếu cần thiết, lưu lộ trình và tiếp tục quá trình quan sát đang diễn ra. Hệ thống sẽ không bao giờ bắt đầu thu thập dữ liệu trong một tài khoản đã ở trạng thái không hoạt động trước đó. Việc tải xuống lịch sử vẫn bị tạm dừng và có thể được tiếp tục riêng biệt. Tạm dừng các tác vụ xuất dữ liệu đang hoạt động trước khi chuyển đổi. Theo mặc định, các thay đổi trong nhóm sẽ giữ nguyên đường dẫn riêng cho từng tài khoản. Chỉ hủy chọn tùy chọn đó khi bản xem trước liệt kê các thay đổi mà bạn dự định thực hiện. Ứng dụng báo cáo kết quả của từng tài khoản; đây không phải là giao dịch “tất cả hoặc không gì cả” giữa các cơ sở dữ liệu. Một lần chuyển đổi thất bại sẽ khôi phục cài đặt trước đó của tài khoản đó. Trường hợp không thể tiếp tục sẽ được hiển thị rõ ràng. Bản xem trước hết hạn sau mười phút và các thay đổi đối với cài đặt kết nối hoặc tư cách thành viên nhóm yêu cầu kiểm tra lại. Chức năng “Apply” sẽ tái sử dụng kết quả kiểm tra sơ bộ thành công trong tối đa 90 giây khi tuyến đường, chế độ và chính sách của nó không thay đổi. Một đường hầm được quản lý vẫn phải có cùng một quá trình đang chạy. Các kết quả cũ hơn, các quá trình đường hầm đã thay đổi và các tuyến đường tự động của nhóm MTProxy sẽ được kiểm tra lại. Bản ghi ứng dụng đã ký giữ lại thời gian kiểm tra ban đầu và ghi lại việc tái sử dụng cũng như thời gian tồn tại của nó. Mỗi lần kiểm tra sơ bộ sẽ đóng kết nối khách hàng tạm thời chưa được xác thực của mình; bộ thu thập dữ liệu sẽ kết nối bằng phiên được ủy quyền của chính nó. | Lộ trình | TgWitness quản lý những gì | | --- | --- | | Trực tiếp | Kết nối từ máy chủ; VPN từ máy chủ bên ngoài không được phát hiện hoặc áp dụng. | | VPN | Mỗi tài khoản có một cấu hình WireGuard đường hầm đầy đủ, được thực thi bởi quá trình SOCKS5 trong không gian người dùng cục bộ. Không cài đặt giao diện máy chủ hoặc trình điều khiển nào. | | Proxy của tôi | Thông tin đăng nhập SOCKS5, HTTP CONNECT hoặc MTProxy. Một URL có thể được điền vào các trường SOCKS5/HTTP. Việc chọn nhiều tài khoản sẽ chia sẻ proxy đã nhập này. | | MTProto công khai | Bể hiện tại gán các tuyến đường Telegram. Các yêu cầu từ bên ngoài bị vô hiệu hóa cho đến khi một proxy phù hợp riêng biệt được cấu hình trong cài đặt nâng cao. | | WARP | Một đường hầm cục bộ riêng biệt cho mỗi tài khoản được chọn, kèm theo đăng ký WARP và hồ sơ WireGuard được lưu trữ trong kho lưu trữ của tài khoản đó. | Việc kiểm tra tuyến đường hiện tại sử dụng một kênh truyền tải Telegram mới chưa được xác thực, chứ không phải phiên làm việc của tài khoản. Quá trình này thiết lập một kết nối truyền tải qua tuyến đường đến trung tâm dữ liệu của tài khoản và thực hiện một lượt đi-về MTProto chưa được xác thực (`req_pq_multi`); quá trình này không tạo khóa ủy quyền và không sử dụng tài khoản nào. Độ trễ được báo cáo là tổng của thời gian kết nối cộng với thời gian đi-về, và quá trình kiểm tra ghi lại cả hai phần này riêng biệt. Đối với các tuyến hỗ trợ HTTP, quá trình này còn yêu cầu dữ liệu theo dõi HTTPS của Cloudflare qua tuyến đường đó và hiển thị địa chỉ IP đầu ra được báo cáo, quốc gia, trạng thái WARP và thời gian kiểm tra. Quá trình chuẩn bị WARP sẽ thất bại trừ khi dữ liệu theo dõi báo cáo rằng WARP đang hoạt động. Các kiểm tra sơ bộ này báo cáo khả năng kết nối của tuyến đường và điểm đầu ra được quan sát. Xem lại các bản ghi đã thu thập thông qua kết quả thu thập và xác minh của kho lưu trữ. Chỉ riêng việc có một tiến trình cục bộ đang chạy không được coi là kiểm tra điểm đầu ra thành công. Bảng điều khiển theo dõi giá trị trung bình động của năm lần kiểm tra gần nhất. Một tuyến đường được coi là **chậm** khi giá trị trung bình vượt quá 5 giây hoặc ba lần kiểm tra liên tiếp vượt quá ngưỡng này, và **sẽ bị coi là không khả dụng** sau hai lần kiểm tra thất bại liên tiếp; `network.slow_route` và `network.route_recovered` ghi lại các thay đổi. Đối với một tuyến WARP chậm, **Re-roll WARP** khởi động lại đường hầm của tài khoản với các điểm cuối Cloudflare WARP khác, giữ lại tuyến nhanh nhất và ghi lại `network.warp_rerolled` cùng với thời gian trước và sau đó; **New WARP identity** đăng ký một thiết bị WARP mới và chỉ giữ lại khi thiết bị đó nhanh hơn. Địa chỉ proxy cục bộ, tài khoản Telegram và phiên làm việc của nó vẫn giữ nguyên; các kết nối Telegram sẽ kết nối lại qua đường hầm đã được khởi động lại. Một tuyến WARP chậm sẽ được khởi động lại tự động tối đa một lần mỗi 30 phút; khi điều đó không giúp ích, các lần khởi động lại tiếp theo sẽ chờ sự can thiệp của người vận hành. ### WARP và WireGuard di động Đây là bản tích hợp WARP không chính thức **** sử dụng [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1) và [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3). Quản trị viên phải chấp nhận thiết lập một cách rõ ràng trước lần tải xuống đầu tiên hoặc đăng ký WARP. Các kết nối thiết lập này truy cập trực tiếp đến GitHub và Cloudflare và tiết lộ địa chỉ IP của máy. Lưu lượng truy cập của tài khoản thông thường vẫn giữ nguyên tuyến đường hiện có cho đến khi ứng dụng được khởi chạy. Cloudflare chọn địa chỉ thoát và quốc gia; các đường hầm riêng biệt có thể chia sẻ cùng một địa chỉ thoát. Tính năng này không cung cấp lựa chọn quốc gia, xoay vòng IP định kỳ và tính năng ngắt kết nối VPN toàn hệ thống. Các bản tải xuống trình hỗ trợ được hỗ trợ: Linux và macOS x86-64/ARM64, và Windows x86-64. Các tệp tin được kiểm tra so với các giá trị băm SHA-256 được gói sẵn trong mã nguồn đã được xem xét, và các tệp thực thi được lưu trong bộ nhớ đệm sẽ được kiểm tra lại trước khi khởi chạy. Không có công cụ hỗ trợ nào được thêm vào PATH, cài đặt dưới dạng dịch vụ hệ thống hoặc được cấp trình nghe công khai. Tất cả các tệp đều nằm trong thư mục `portable-routes/` của không gian làm việc và các mục kho lưu trữ được mã hóa. Trình nghe vòng lặp SOCKS5 yêu cầu thông tin đăng nhập được tạo độc lập. Hồ sơ cá nhân và thông tin đăng nhập tài khoản WARP được mã hóa bằng kho lưu trữ không gian làm việc hiện có. Trong khi chạy, trình trợ giúp cần một cấu hình văn bản thuần túy chỉ dành cho chủ sở hữu; nó sẽ bị xóa khi dừng bình thường. Sự cố máy chủ có thể khiến tệp này bị bỏ lại trong thư mục dữ liệu chỉ dành cho chủ sở hữu. Điều này không mã hóa đĩa hoặc bảo vệ chống lại quản trị viên. Trình giám sát sẽ đóng đường hầm nếu ống dẫn cha của bảng điều khiển biến mất. Một đường hầm bị lỗi sẽ không bao giờ kích hoạt chế độ dự phòng trực tiếp. Khởi động lại bảng điều khiển sẽ khôi phục đường hầm đã chọn; các lần khởi động thất bại sẽ thử lại với độ trễ giới hạn. **Dừng đường hầm** cũng tạm dừng việc giám sát và duy trì trạng thái đã dừng. **Bắt đầu đường hầm** khởi động đường hầm; tiếp tục giám sát riêng biệt khi sẵn sàng. Các cấu hình WireGuard được tải lên phải chứa một Giao diện (Interface) và một Nút kết nối (Peer), các tuyến đường IPv4 và IPv6 đầy đủ, và không được chứa các hook, include, thay thế biến môi trường hoặc các trình nghe (listener) bổ sung. Các địa chỉ điểm cuối công khai được giải quyết và cố định trước khi khởi động. Sử dụng VPN bên ngoài hoặc cổng SOCKS5 cho OpenVPN/IPsec và các điểm cuối riêng tư. ## Các phương thức xác thực **ID API và mã băm API dùng để xác định một ứng dụng; chúng không thay thế cho thông tin đăng nhập tài khoản.** Chúng là tùy chọn trong TgWitness. Thứ tự ưu tiên: cặp được nhập vào biểu mẫu, tiếp theo là cặp từ tệp JSON tài khoản đã nhập, sau đó là cặp được lưu trong không gian làm việc, và cuối cùng là nhóm 50 cặp công khai, được thử theo thứ tự ngẫu nhiên với cơ chế luân phiên tự động khi Telegram từ chối một cặp. Chỉ có cặp Telegram Desktop (2040) mới được gửi kèm theo mô tả ứng dụng Telegram Desktop tương ứng. Cặp thông tin của riêng quý vị từ Công cụ Phát triển API tại [my.telegram.org](https://my.telegram.org) có thể được sử dụng cho tất cả các tài khoản của quý vị; mỗi tài khoản vẫn có quyền ủy quyền riêng. | Phương pháp | Yêu cầu | Hỗ trợ TgWitness | | --- | --- | --- | | Số điện thoại, mã xác thực, xác thực hai yếu tố (2FA) tùy chọn | Quyền truy cập tài khoản; cặp API là tùy chọn | Đăng nhập vào bảng điều khiển | | Mã xác thực HEX + ID DC | Khóa đầy đủ 512 ký tự và DC 1–5 | Tab **“Khóa xác thực** trực tiếp”; tùy chọn kiểm tra ID người dùng trước khi lưu thông tin xác thực | | Telethon StringSession | Một chuỗi phiên làm việc hợp lệ | Đăng nhập vào bảng điều khiển | | Telethon SQLite `.session` | Nội dung hoàn chỉnh, nhất quán | Tính năng nhập trực tiếp các lược đồ qua bảng điều khiển 7/8; tùy chọn sử dụng CLI ngoại tuyến | | Pyrogram SQLite `.session` | Phiên làm việc của người dùng trong môi trường sản xuất đã đóng | Nhập trực tiếp các lược đồ từ bảng điều khiển 2/3 | | Tệp ZIP TData của Telegram Desktop | Một tài khoản hiện đại; mã PIN cục bộ nếu được bảo vệ | Chuyển đổi trong bộ nhớ kèm theo các kiểm tra tổng kiểm tra (checksum) và giải mã | | Tệp JSON tài khoản | Các trường API/phiên làm việc/khóa được hỗ trợ | Chỉ riêng siêu dữ liệu đã đủ để điền thông tin đăng nhập API; tuy nhiên, vẫn cần phải đăng nhập bằng phiên/khóa hoặc số điện thoại/mã QR | | Đăng nhập bằng mã QR | Xác nhận từ ứng dụng Telegram được ủy quyền | Tạo mã QR cục bộ, thiết lập thời hạn hiệu lực/thử lại, tùy chọn xác thực hai yếu tố (2FA) | | TDLib / Pyrogram StringSession | Các định dạng khác dành riêng cho thư viện | Không được hỗ trợ | | Mã thông báo bot | Một bot có mô hình truy cập/cập nhật riêng | Không được sử dụng bởi người thu thập này | Telegram chọn phương thức gửi mã, bao gồm cả việc có gửi SMS hay không. Một băm API không thể khôi phục một phiên đã bị thu hồi hoặc thay thế mật khẩu 2FA bị quên. TgWitness không lưu trữ mã đăng nhập hoặc mật khẩu 2FA của Telegram lên đĩa. Đối với nguồn riêng tư, tài khoản phải đã có quyền truy cập. Tên người dùng nhóm là không cần thiết. Việc nhập thông qua proxy hoặc phiên làm việc không cấp quyền thành viên cũng như quyền quản trị viên . Cài đặt của cuộc trò chuyện quyết định liệu các thành viên có thể xem lịch sử trước khi họ tham gia hay không. ## Nhập tệp phiên làm việc Telethon Telethon SQLite, Pyrogram SQLite và Telegram Desktop TData sử dụng các định dạng khác nhau. Bảng điều khiển sẽ tự động phát hiện và chuyển đổi các cấu trúc được hỗ trợ; việc đổi tên tệp không được coi là quá trình chuyển đổi. Chọn một phiên và tệp JSON đi kèm trong mục **Files**, nhấn **Check files**, sau đó nhấn **Connect account**. Hệ thống chấp nhận tối đa bốn tệp khớp và tổng dung lượng tối đa là 8 MiB. Xem [giới hạn định dạng](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/) để biết chi tiết về TData/JSON. Không có tính năng khôi phục mật mã. Đăng nhập bằng điện thoại/2FA hoặc mã QR sẽ tạo một ủy quyền riêng biệt. Đường dẫn dòng lệnh tùy chọn dành riêng cho Telethon vẫn có sẵn: 1. Hãy ngừng sử dụng phiên làm việc gốc trên ứng dụng khách và tạo một bản sao nhất quán. Trình chuyển đổi sẽ từ chối các tệp có nhật ký WAL/journal chưa hoàn tất. Vui lòng đóng ứng dụng khách gốc một cách đúng quy trình thay vì xóa các tệp đó để né tránh quá trình kiểm tra. 2. Từ môi trường TgWitness, hãy thực thi lệnh: ``` python -m tgwitness.sessions account.session --out account.tgwitness-session ``` 1. Tại mục **Thêm tài khoản → Tệp**, hãy tải lên kết quả hoặc dán chuỗi ký tự của nó, sau đó tiếp tục. 2. Vui lòng kiểm tra ID tài khoản số được hiển thị, chọn các nguồn và bắt đầu quá trình theo dõi. **Tệp đã chuyển đổi là một khóa truy cập tài khoản chưa được mã hóa.** Hãy lưu giữ nó trong kho lưu trữ được bảo vệ và tuyệt đối không được đưa vào kho lưu trữ chung hay gửi cho bất kỳ dịch vụ chuyển đổi bên thứ ba nào. TgWitness lưu trữ phiên đăng nhập được ủy quyền trong kho lưu trữ được mã hóa của mình. Việc sao chép một phiên đăng nhập sẽ không tạo ra một ủy quyền riêng biệt: xin đừng chạy các ứng dụng khách đồng thời với các khóa xác thực đã được sao chép và cho rằng các bản cập nhật sẽ được phân phối độc lập. Quá trình chuyển đổi chỉ chuyển giao quyền truy cập, chứ không chuyển các tin nhắn gốc, bộ nhớ đệm của thực thể hay con trỏ cập nhật bền vững. Quá trình này không đảm bảo khả năng khôi phục cập nhật sau khi khởi động lại quy trình. ## MTProto, Telethon và các máy chủ proxy MTProto là giao thức của Telegram. Telethon là thư viện khách hàng Python mà TgWitness sử dụng. MTProxy là một proxy truyền tải Telegram; SOCKS5 và HTTP CONNECT cung cấp các đường hầm chung. Không có phương thức nào thay thế cho việc xác thực tài khoản. Lưu đường dẫn cho từng không gian làm việc tại **Công cụ khác → Tài khoản → Cài đặt → Cài đặt kết nối → Thay đổi đường dẫn kết nối** trước khi đăng nhập. Các không gian làm việc mới mặc định sử dụng **MTProxy Tự động · danh sách công khai** với tùy chọn **Ẩn địa chỉ**. Các không gian làm việc hiện có đã sử dụng chế độ Trực tiếp một cách rõ ràng sẽ vẫn giữ chế độ cho phép điều này. Các tệp được đọc qua các kết nối riêng biệt so với kết nối dùng để đọc tin nhắn, giống như cách các ứng dụng chính thức thực hiện. Trong trung tâm dữ liệu của chính tài khoản đó, họ tái sử dụng khóa ủy quyền của tài khoản với một phiên MTProto mới; đối với trung tâm dữ liệu khác, một khóa mới sẽ được tạo và ủy quyền trong khi tài khoản đang kết nối và chỉ được lưu trữ trong bộ nhớ. Mỗi kết nối tệp đều sử dụng cùng một tuyến đường với tài khoản. Số lượng kết nối này trên mỗi trung tâm dữ liệu được giới hạn bởi **mục Cài đặt → Hiệu suất → Số kết nối tệp trên mỗi trung tâm dữ liệu Telegram**; giá trị 0 có nghĩa là chỉ đọc tệp qua kết nối chính của tài khoản. Tối đa năm kết nối Telegram được thiết lập cùng lúc trên tất cả các tài khoản của một bản cài đặt. ## Các chế độ IP Tuyến đường kết nối sẽ quyết định cách kết nối. Chế độ IP và tính năng **bảo vệ IP** trong phần Tài khoản của bảng điều khiển sẽ xác định thời điểm địa chỉ máy chủ có thể bị lộ. Các tùy chọn này không cài đặt VPN hay định tuyến toàn bộ lưu lượng truy cập của máy. | Chế độ | Telegram | Yêu cầu từ bên ngoài | | --- | --- | --- | | Ẩn địa chỉ (`hide`) | Vui lòng sử dụng máy chủ proxy; nếu không có máy chủ nào hoạt động, xin vui lòng chờ đợi. Không có phương án dự phòng trực tiếp. | Yêu cầu sử dụng SOCKS5/HTTP; từ chối các yêu cầu không có proxy phù hợp. | | Chỉ sử dụng phương án này khi không còn lựa chọn nào khác (`fallback`) | MTProxy tự động có thể sử dụng kết nối trực tiếp (Direct) sau khoảng thời gian trễ đã được cấu hình, sau đó quay trở lại sử dụng proxy đang hoạt động. | Ưu tiên sử dụng proxy bên ngoài đã được cấu hình hoặc tuyến SOCKS5/HTTP của tài khoản; nếu không, có thể sử dụng chế độ Trực tiếp. | | Máy chủ nằm sau một đường hầm hoặc VPN (`tunnel`) | Các đường dẫn trực tiếp và cơ chế chuyển hướng tự động sang nhóm dự phòng ngay lập tức đều được phép. | Việc kết nối trực tiếp được phép khi không có máy chủ trung gian nào được cấu hình. | Chế độ đường hầm hoặc VPN giả định rằng bạn quản lý mạng đó riêng biệt. Nếu không có đường hầm hoạt động, các điểm đến có thể nhìn thấy địa chỉ của chính máy chủ. Hãy chọn chế độ phù hợp với mạng thực tế của bạn, chứ không phải dựa vào tên của tùy chọn. ### Chọn một lộ trình | Lộ trình | Cài đặt | Phạm vi | | --- | --- | --- | | MTProxy tự động | Các danh sách tích hợp sẵn hoặc danh mục toán tử | Luôn duy trì một tuyến kết nối Telegram hoạt động; phương án dự phòng trực tiếp phụ thuộc vào chế độ IP | | Trực tiếp | Chế độ Tunnel hoặc VPN | Telethon sử dụng tuyến mạng của nhà cung cấp dịch vụ | | SOCKS5 | Máy chủ, cổng, tên người dùng/mật khẩu (tùy chọn) | python-socks, đã kích hoạt tính năng DNS đích từ xa | | HTTP CONNECT | Máy chủ, cổng, tên người dùng/mật khẩu (tùy chọn) | Sử dụng kết nối HTTP CONNECT thuần túy; giao thức TLS đến chính máy chủ proxy chưa được triển khai | | MTProxy | Máy chủ, cổng, khóa bí mật | Phương thức truyền tải Telethon thử nghiệm; 32 chữ số thập lục phân hoặc `dd` + 32 chữ số thập lục phân | Các khóa bí mật TLS giả mạo `ee` sẽ bị từ chối. Tính năng chuẩn hóa của Telethon 1.45 có thể loại bỏ tiền tố và tên miền, nhưng tính năng này không hỗ trợ TLS giả mạo. Vui lòng dán `tg://proxy?server=…&port=…&secret=…` hoặc `https://t.me/proxy?server=…&port=…&secret=…` và chọn **“Điền trường từ liên kết**”. Thao tác này sẽ xác thực và điền thông tin vào các trường mà không cần kết nối hay lưu lại; quý vị hãy kiểm tra và lưu đường dẫn đó riêng biệt. Các trường nhập liệu thủ công vẫn có sẵn. Vui lòng tham khảo [các liên kết proxy Telegram](https://core.telegram.org/api/links#proxy-links). ### Các máy chủ proxy công cộng do hệ thống cài đặt của quý vị cung cấp Danh sách tích hợp sẵn kết hợp bảy nguồn: [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto), [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro), [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector), [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector), [Therealwh/MTPproxyLIST](https://github.com/Therealwh/MTPproxyLIST), [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) và [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list). Bản chụp nhanh đi kèm chứa thông tin về điểm cuối, nguồn gốc và ngày tải xuống. Các danh sách này là dữ liệu đầu vào; các kiểm tra kết nối dưới đây sẽ quyết định proxy nào sẽ được sử dụng. **MTProxy tự động** kiểm tra kết nối truyền tải Telegram, duy trì một proxy đang hoạt động và chuyển sang proxy khác khi proxy đó gặp sự cố. Các không gian làm việc ưu tiên các proxy khác nhau khi có đủ các mục proxy đang hoạt động; các proxy có thể chia sẻ một địa chỉ thoát. Các proxy gặp sự cố sẽ tạm dừng trước khi thử lại. Nếu không có proxy nào hoạt động, chế độ IP sẽ xác định liệu việc thu thập phải chờ đợi hay có thể sử dụng kết nối trực tiếp. Việc thay đổi proxy không làm thay đổi tài khoản hay xóa nhật ký của tài khoản đó. Các lựa chọn và thay đổi về đường dẫn được ghi lại trong nhật ký đã được ký. Khi các tuyến tự động đang hoạt động, danh sách sẽ được làm mới mỗi giờ và các kiểm tra truyền tải được thực hiện mỗi mười phút theo mặc định. Các khoảng thời gian này có thể tùy chỉnh. **Việc cập nhật danh sách công khai** sẽ yêu cầu làm mới; chỉ xem danh sách sẽ không thay đổi tuyến thủ công đã lưu. **Lưu lượng Telegram và các yêu cầu HTTPS sử dụng các tuyến đường khác nhau.** Việc tải xuống danh sách sử dụng một kết nối HTTPS riêng biệt và tuyến đường yêu cầu bên ngoài được cung cấp. Phiên bản `TGWITNESS_PROXY_FEED_PROXY` sẽ ghi đè rõ ràng tuyến đường đó bằng một proxy HTTP/SOCKS5; cả hai biến thể Compose của trình thu thập dữ liệu đều chuyển tiếp tuyến đường này. Nhóm nền sẽ tuân theo không gian làm việc chính. Không có phiên Telegram, thông tin đăng nhập API, mã thông báo bảng điều khiển hay mã thông báo bot nào được gửi đến các nhà cung cấp nguồn cấp dữ liệu. Tên nhà cung cấp, ngày chụp nhanh và tuyến đường tải xuống được hiển thị trong phần **“Nguồn gốc của danh sách**”. Một MTProxy chỉ truyền tải lưu lượng Telegram. Các thao tác HTTP của không gian làm việc như dấu thời gian, thông báo, bản sao ngoài trang web và kiểm tra nguồn sử dụng một proxy SOCKS5/HTTP riêng biệt khi được cấu hình, sau đó là tuyến SOCKS5/HTTP của tài khoản. Nếu không có cả hai, tính năng Ẩn địa chỉ sẽ từ chối yêu cầu; các chế độ khác cho phép Trực tiếp. Các yêu cầu bên ngoài có thể bị vô hiệu hóa. Một proxy tải xuống nguồn cấp dữ liệu được cấu hình rõ ràng vẫn là một quyền ưu tiên riêng biệt của người vận hành. Dịch vụ chứng kiến độc lập duy trì đường dẫn riêng của mình. Đối với các dịch vụ riêng tư do nhà điều hành quản lý, cài đặt môi trường máy chủ hiện có `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1` cho phép các đích đến riêng tư và duy trì việc giải quyết tên máy chủ phía proxy. Tính năng này không thể được kích hoạt từ bảng điều khiển. Chế độ chỉ công khai sẽ từ chối các đích đến `.onion` trước khi truy vấn trình giải quyết công khai; các dịch vụ Tor onion yêu cầu cài đặt đích đến riêng tư rõ ràng và một proxy phù hợp. Hành vi DNS này áp dụng cho các hoạt động HTTP bên ngoài, không áp dụng cho giao thức truyền tải của Telegram. Cloudflare cung cấp tài liệu về [điểm cuối DNS JSON](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/). ****Các tham số nhóm tự động**** Trong phần**Công cụ khác → Thông số → MTProxy tự động**, hãy cấu hình ngưỡng lỗi, thời gian chờ, lịch trình luân phiên, chia sẻ proxy và độ trễ dự phòng được phép. | Kiểm soát | Mặc định | | --- | --- | | Ngắt kết nối trước khi thay thế | 3 trong vòng 10 phút | | Số lượng proxy được thử cho mỗi lần kết nối | 3 | | Thời gian nghỉ đầu tiên / tối đa sau khi xảy ra lỗi | 10 phút / 6 giờ | | Lịch trình luân phiên | Đã tắt; bật khi gặp lỗi | | Số lượng tài khoản trên mỗi proxy | 0: ưu tiên các mục riêng biệt, chia sẻ khi cần thiết. Đặt 1 để chờ một mục độc quyền. | | Thời gian trễ trước khi được phép chuyển sang phương án dự phòng trực tiếp | 10 phút; Ẩn địa chỉ vẫn từ chối Direct | | Kiểm tra làm mới nguồn cấp dữ liệu / kiểm tra truyền tải | Biên bản 60/10; các giá trị của không gian làm việc chính áp dụng cho nhóm chia sẻ | Các proxy khác nhau có thể chia sẻ cùng một địa chỉ thoát. Các giới hạn của Telegram áp dụng cho mọi tuyến đường. Để thay thế danh sách công khai bằng danh mục nhà mạng của riêng quý vị, vui lòng cấu hình tùy chọn ghi đè dưới đây. Tùy chọn này sẽ vô hiệu hóa hoàn toàn các đăng ký bên ngoài, kể cả khi mảng `proxies` của nó trống. Vui lòng sao chép [danh mục trống](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example) vào `proxy-config/proxies.json` và thêm các điểm cuối công khai đã triển khai của quý vị: ``` {"format": "tgwitness-proxy-catalog-v1", "proxies": [ {"id": "project-eu", "label": "Project EU", "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"} ]} ``` Các giá trị ví dụ phải được thay thế. Hệ thống chấp nhận tối đa 32 mục riêng biệt. Danh sách đã được xác thực sẽ trả về các nhãn/máy chủ/cổng mà không cần sử dụng khóa bí mật chung; việc chọn một mục sẽ lưu thông tin xác thực của mục đó vào kho lưu trữ của không gian làm việc. Tính khả dụng vẫn chưa được kiểm tra cho đến khi thực hiện một bài kiểm tra truyền tải rõ ràng. Trong trường hợp danh mục bị lỗi, người dùng vẫn có thể thực hiện cấu hình thủ công. Khởi chạy trên hệ điều hành gốc: thiết lập đường dẫn JSON cục bộ là `TGWITNESS_PROXY_CATALOG`. Docker: ``` docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build ``` Lớp phủ được gắn vào `proxy-config` ở chế độ chỉ đọc; các tệp phải có thể được đọc bởi UID 10001 của container. Thư mục đó bị loại trừ khỏi Git, bối cảnh xây dựng Docker và các kho lưu trữ nguồn. Danh mục này cấu hình các tài khoản thu thập; [bot chứng thực](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/) sử dụng đường dẫn HTTP/SOCKS5 riêng của mình, không phải MTProxy. Chế độ dự phòng trực tiếp tuân theo chế độ IP nêu trên. Vui lòng tạm dừng quá trình quan sát trước khi thay đổi lộ trình. Việc lưu lại sẽ ngắt kết nối các máy khách cũ và hủy bỏ các phiên đăng nhập chưa hoàn tất; một máy khách mới sẽ sử dụng lộ trình đã được lưu. Sự liên kết giữa nhật ký và phiên làm việc của tài khoản vẫn được duy trì. Các thiết lập sẽ thay thế lộ trình trước đó: vui lòng nhập lại thông tin đăng nhập proxy khi chỉnh sửa. Thông tin đăng nhập được mã hóa theo tiêu chuẩn `network.enc`. API không trả về tên người dùng, mật khẩu hoặc khóa bí mật. Các bản ghi có chữ ký chứa loại đường dẫn và thông tin về việc có thông tin đăng nhập hay không, đồng thời loại trừ điểm cuối và các khóa bí mật. Người vận hành có thể xem điểm cuối trên bảng điều khiển. Các trường chứa khóa bí mật sẽ bị xóa sau khi lưu, khóa hoặc chuyển đổi không gian làm việc. **Tính năng Kiểm tra kết nối Telegram**, cũng có sẵn trước khi đăng nhập, sẽ mở và đóng một kết nối Telegram tạm thời không được ủy quyền thông qua tuyến đường này. Tính năng này không liên hệ với bất kỳ trang web kiểm tra IP nào. Việc thực hiện thành công chỉ xác nhận kết nối truyền tải, chứ không phải quyền truy cập vào nhóm, việc gửi tin nhắn đến nơi hay tính ẩn danh. Proxy này áp dụng cho các kết nối của ứng dụng Telegram, bao gồm cả việc tải xuống phương tiện từ máy chủ phân phối (DC) của Telegram. Các công cụ TSA được khởi chạy qua trình duyệt, pip, SSH hoặc theo cách thủ công sẽ đi theo các đường dẫn riêng biệt. Tên máy chủ proxy có thể được giải quyết tại địa phương. `rdns` ảnh hưởng đến tên máy chủ đích; Telegram thường cung cấp các địa chỉ IP số của máy chủ phân phối (DC). SOCKS5 và HTTP CONNECT thuần túy bản thân chúng không mã hóa thông tin đăng nhập proxy hoặc đường hầm từ máy khách đến proxy. MTProto bảo vệ riêng lưu lượng Telegram. Sử dụng kênh bảo mật thích hợp để kết nối với proxy trên mạng không đáng tin cậy. Các nhóm riêng tư là các cuộc trò chuyện trên đám mây được bảo vệ bởi MTProto trong quá trình truyền tải; các Cuộc trò chuyện bí mật đầu cuối là một loại cuộc trò chuyện riêng biệt, được ghi lại bởi [mô-đun Cuộc trò chuyện bí mật](https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/). ## Mã hóa và chữ ký | Lớp | Đã triển khai | Trách nhiệm của người vận hành | | --- | --- | --- | | Lưu lượng Telegram | Telethon MTProto | Niềm tin vào nền tảng, lộ trình và tính sẵn sàng | | Bảng điều khiển web | Token mang theo, cài đặt mặc định loopback, giới hạn yêu cầu | Sử dụng HTTPS hoặc đường hầm SSH để truy cập từ xa | | Bí mật | Fernet dùng để quản lý thông tin đăng nhập API, phiên làm việc, thông tin đăng nhập proxy và khóa riêng dùng để ký số | Bảo vệ khóa giải mã và máy chủ đang chạy | | Khóa kho lưu trữ | Khóa cục bộ hoặc khóa chính bên ngoài dành cho một cài đặt mới | Lưu trữ được bảo vệ riêng biệt và sao lưu khóa | | Tin nhắn và tệp đính kèm | Lưu trữ ứng dụng dưới dạng văn bản thuần túy | Ổ đĩa/khối lượng được mã hóa | | ZIP/JSONL/CSV/HTML | Kiểm tra tính toàn vẹn, không mã hóa nội dung | Bảo vệ các bản sao đã xuất và quá trình chuyển giao | | Nguồn gốc và thời gian | Nhật ký có chữ ký, biên nhận quá trình, các công cụ tuân thủ RFC 3161 | Khóa tin cậy, các điểm kiểm tra độc lập/TSA và quy trình lưu giữ | **Tính năng bảo vệ lưu trữ** trong phần Tài khoản hiển thị các trạng thái này. Mã thông báo bảng điều khiển là một mã truy cập bí mật, không phải mật khẩu mã hóa. Mã này cấp quyền truy cập cho quản trị viên; [các mã thông báo được cấp](https://phishdestroy.io/tgwitness/vi/docs/reference/access/) có thể được giới hạn phạm vi cho các tài khoản và cuộc trò chuyện. Các không gian làm việc chia sẻ quá trình máy chủ và không phải là các đơn vị thuê riêng biệt. BitLocker, LUKS, FileVault hoặc một phân vùng được mã hóa và quản lý có thể bảo vệ bộ nhớ lưu trữ theo các mô hình đe dọa tương ứng của chúng. Quản trị viên của một máy tính đang hoạt động và không bị khóa vẫn có thể đọc được dữ liệu. Hãy bao gồm SQLite WAL/SHM, tệp đa phương tiện, tệp xuất tạm thời, vùng hoán đổi, bản sao lưu và các tệp tải xuống từ trình duyệt vào kế hoạch lưu trữ. Một phân vùng Docker không được mã hóa chỉ đơn thuần vì nó là một phân vùng. ## Khóa chính bên ngoài Đối với việc cài đặt **mới**, vui lòng đặt khóa chính bên ngoài thư mục dữ liệu. Thao tác này sẽ không tự động di chuyển kho khóa cục bộ hiện có. Hãy chuẩn bị một thư mục chứa khóa mà chỉ tài khoản dịch vụ mới có quyền truy cập, sau đó thực hiện lệnh: ``` python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key python -m tgwitness --data-dir /private/observations/new-case ``` PowerShell, sử dụng môi trường dự án đã được cài đặt: ``` python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key $env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key' python -m tgwitness --data-dir E:\PrivateData\new-case ``` Trong Docker, hãy gắn tệp ở chế độ chỉ đọc bên ngoài `/data`, ví dụ như tại `/run/secrets/tgwitness-master.key`, và thiết lập biến môi trường trỏ đến đường dẫn đó. UID của dịch vụ phải có quyền đọc tệp này. Vui lòng truyền đường dẫn, chứ không phải các byte khóa, thông qua các tệp môi trường/cấu hình. Mỗi không gian làm việc sẽ nhận được một giá trị salt công khai ngẫu nhiên cùng với khóa Fernet riêng của mình, được tạo ra thông qua HKDF-SHA256. `vault.external.json` lưu trữ siêu dữ liệu về quá trình tạo khóa, chứ không phải khóa chính. Nếu thiếu hoặc nhập sai khóa, hệ thống sẽ không khởi động được mà không tự động thay thế khóa đó. Vui lòng lưu giữ cả siêu dữ liệu về giá trị salt lẫn khóa chính để phục hồi hệ thống. Tất cả các không gian làm việc đều được tạo ra từ cùng một khóa chính; việc khóa này bị xâm phạm sẽ ảnh hưởng đến toàn bộ hệ thống cài đặt. Quá trình đang chạy có thể giải mã các thông tin bí mật. Đây không phải là HSM hay KDF mật khẩu. Không chấp nhận sử dụng mật khẩu do người dùng tự đặt thay thế cho khóa ngẫu nhiên. Vui lòng giữ lại khóa hiện có cho các bản cài đặt hiện tại cho đến khi quá trình di chuyển có chủ đích được triển khai và xác minh. Việc xóa `vault.key` hoặc thay thế khóa chính có thể làm mất quyền truy cập vào các phiên làm việc/khóa ký. Hãy lưu trữ các bản sao lưu được mã hóa và các khóa riêng biệt, đồng thời thử nghiệm quá trình khôi phục trong một môi trường cách ly. --- # Telegram · Triển khai Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/ Vui lòng chạy TgWitness dưới dạng dịch vụ trên Windows, Linux, macOS hoặc Docker, thông qua kết nối HTTPS, kèm theo tính năng sao lưu và cập nhật. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Vui lòng chạy TgWitness dưới dạng dịch vụ trên Windows, Linux, macOS hoặc Docker, thông qua kết nối HTTPS, kèm theo tính năng sao lưu và cập nhật. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Triển khai & khôi phục](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **Tiếng Anh** · [Tiếng Nga](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [Tiếng Ukraina](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [Tiếng Tây Ban Nha](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [Tiếng Bồ Đào Nha (Brazil)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [Tiếng Thổ Nhĩ Kỳ](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [Tiếng Ả Rập](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [Tiếng Ba Tư](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [Tiếng Urdu](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [Tiếng Hindi](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [Tiếng Indonesia](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [Tiếng Trung giản thể](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md) ## Chọn phương thức cài đặt Đối với gói phần mềm di động, vui lòng giải nén tệp `TgWitness--windows-amd64-portable.zip` từ GitHub Releases. Đối với các phương pháp khác, vui lòng tải xuống và giải nén tệp ZIP nguồn hoặc sao chép kho lưu trữ, sau đó thực thi lệnh sau từ thư mục dự án: | Cài đặt | Bắt đầu | Công cụ này có chạy ngầm không? | | --- | --- | --- | | Gói phần mềm di động dành cho Windows | `TgWitness.cmd` | Không; hãy giữ cửa sổ mở. | | Phiên bản dành riêng cho Windows | `Start.cmd` | Không; hãy sử dụng tác vụ đăng nhập tùy chọn để chạy nền. | | Hỗ trợ bản địa trên Linux/macOS | `sh start.sh` | Không; hãy sử dụng systemd/launchd để chạy nền. | | Docker trên bất kỳ máy chủ nào được hỗ trợ | `docker compose up -d --build --wait` | Đúng vậy, miễn là daemon Docker vẫn đang chạy. | | Trợ lý Docker trên Windows | `scripts\Docker.cmd` | Đúng vậy; trình trợ giúp sẽ chờ kiểm tra tình trạng hoạt động của máy chủ web. | | Trợ lý Docker trên Linux/macOS | `sh scripts/docker-start.sh` | Đúng vậy; trình trợ giúp sẽ chờ kiểm tra tình trạng hoạt động của máy chủ web. | Đối với máy chủ đám mây mà bên thứ ba có thể kiểm tra — được tạo thông qua API của nhà cung cấp, không sử dụng SSH và chỉ có thể truy cập qua Cloudflare Tunnel — xin tham khảo [phần triển khai có độ tin cậy cao](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/). Quá trình khởi động gốc sẽ tạo ra một bản `.venv` riêng tư và cài đặt các phụ thuộc đã được ghim sẵn. Docker sẽ xây dựng chúng bên trong hình ảnh, mà không cần Python trên máy chủ. Lần cài đặt đầu tiên cần có kết nối Internet. Khi không tìm thấy Python 3.11 trở lên, `Start.cmd` sẽ hỏi ý kiến người dùng trước khi cài đặt Python 3.12 cho người dùng Windows hiện tại (sử dụng winget, hoặc trình cài đặt từ python.org sau khi xác minh chữ ký của Python Software Foundation); công cụ này tuyệt đối không yêu cầu quyền quản trị viên. Docker và các dịch vụ hệ điều hành vẫn là các điều kiện tiên quyết. Các bản cài đặt gốc và di động sử dụng `data/live` bên trong thư mục của chúng. Docker sử dụng khối lượng có tên `tgwitness-data` tại `/data`. Đây là các bản cài đặt riêng biệt cho đến khi quý vị chủ động di chuyển toàn bộ thư mục dữ liệu. Xin lưu ý rằng một container Docker mới sẽ không tự động phát hiện các tài khoản gốc. ## Yêu cầu cài đặt Việc cài đặt bản gốc yêu cầu Python 3.11 trở lên cùng với `venv` và `ensurepip`, kết nối Internet để cài đặt các phụ thuộc ban đầu, và một thư mục dự án có quyền ghi cho `.venv`. Bảng điều khiển đi kèm không cần Node.js hay quá trình xây dựng giao diện người dùng. Vui lòng chạy trình khởi chạy từ tài khoản hệ điều hành thông thường của quý vị; TgWitness không yêu cầu quyền quản trị viên/root. - **Hệ điều hành Windows:** `Start.cmd` sẽ kiểm tra thư mục `py -3`, sau đó là `python`, tiếp theo là thư mục cài đặt mặc định theo từng người dùng và thư mục Program Files, đồng thời yêu cầu phiên bản 3.11 trở lên. Nếu không có thư mục nào phù hợp, chương trình sẽ đề xuất phương án cài đặt tự động theo từng người dùng như đã mô tả ở trên. `py -3 start.py` cũng hoạt động được. Gói phần mềm di động hoàn toàn không cần Python. - **Linux:** `start.sh` sẽ thử các phiên bản `python3.13`, `python3.12`, `python3.11`, `python3` và `python`, đồng thời hiển thị lệnh cài đặt tương ứng cho apt, dnf, pacman, zypper, apk hoặc Homebrew nếu không có phiên bản nào đáp ứng yêu cầu. Các hệ thống Debian/Ubuntu có thể cần gói `python3-venv` tương thích với trình thông dịch đã chọn. Phiên bản Python mặc định cũ hơn của hệ điều hành phân phối đó phải được thay thế hoặc bổ sung bằng Python 3.11 trở lên. - **macOS:** hãy cài đặt bản phân phối Python 3.11+ mới nhất; không nên cho rằng trình thông dịch do hệ điều hành cung cấp đáp ứng yêu cầu. Vui lòng sử dụng tệp `python3 start.py` từ thư mục dự án. - **Docker:** sử dụng Docker Engine/Desktop với Compose phiên bản 2.20 trở lên. Docker Desktop phải sử dụng các container Linux trên Windows. Container sẽ tự cài đặt các thành phần phụ thuộc Python của riêng mình; máy chủ không cần cài đặt Python riêng biệt. ## Máy tính cục bộ Vui lòng sử dụng `Start.cmd` trên Windows hoặc `sh start.sh` trên Linux/macOS. `scripts\Setup.cmd` hoặc `sh start.sh --setup-only` sẽ tiến hành chuẩn bị môi trường. Trình khởi chạy sẽ cài đặt các thành phần phụ thuộc khi sử dụng lần đầu; các lần khởi chạy sau đó sẽ tái sử dụng môi trường đã có sẵn. Cần có kết nối Internet để thiết lập và thu thập dữ liệu từ Telegram, tuy nhiên, việc duyệt qua các bản ghi hiện có và tạo tệp xuất vẫn có thể thực hiện ngoại tuyến. Vui lòng chạy lệnh ``python start.py --check`` sau khi thiết lập để kiểm tra các phụ thuộc cục bộ, Ed25519, bộ nhớ lưu trữ, cấu hình khóa và địa chỉ lắng nghe mà không cần khởi động trình thu thập dữ liệu. Sử dụng lệnh `--json` để nhận kết quả đầu ra có cấu trúc. Chuyển các lệnh `--data-dir`, `--host` và `--port` theo mục đích. Quá trình kiểm tra này không cài đặt gói phần mềm, không tạo nhật ký cũng như không kết nối với Telegram; đây không phải là quá trình đánh giá tính toàn vẹn hay phạm vi bao phủ. Quá trình khởi động sẽ xác minh riêng biệt các nhật ký hiện có. Lệnh `python start.py --help` cũng không yêu cầu cài đặt. Sau khi chạy tệp start.py, quý vị hãy thực thi các lệnh phụ trợ bằng lệnh ``.venv\Scripts\python.exe`` trên Windows hoặc ``.venv/bin/python`` trên Linux/macOS, hoặc kích hoạt môi trường đó trước tiên. Các ví dụ ``python -m ...`` dưới đây giả định rằng môi trường đã được kích hoạt. ``` python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787 ``` Biến môi trường: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE chọn chế độ khóa bên ngoài cho cài đặt mới; xem [Khóa chính bên ngoài](https://phishdestroy.io/tgwitness/vi/docs/reference/security/#external-master-key). TGWITNESS_TOKEN, nếu được cung cấp, phải chứa ít nhất 24 ký tự; hãy sử dụng một giá trị ngẫu nhiên được tạo bằng thuật toán mã hóa . Nếu không có biến này, ứng dụng sẽ tạo một mã thông báo ngẫu nhiên 256 bit trong tệp panel-token.txt. Việc ghi đè biến môi trường sẽ không ghi đè lên tệp đó. Khởi động lại để xoay vòng thông tin xác thực. Chỉ có đúng một tiến trình được phép sở hữu một thư mục dữ liệu. Cơ chế khóa tệp trên nhiều nền tảng hệ điều hành sẽ ngăn chặn tình trạng ghi đồng thời vô tình xảy ra. Vui lòng sử dụng một công cụ Uvicorn. Bảng điều khiển có thể quản lý bất kỳ số lượng không gian làm việc nào, với các thư mục không gian làm việc bổ sung nằm trong thư mục profiles//. Đối với các phiên bản dịch vụ riêng biệt, hãy sử dụng các thư mục và cổng riêng biệt. Các tệp WAL của SQLite phải được lưu trữ trên bộ nhớ lưu trữ cục bộ lâu dài, chứ không phải trên hệ thống tệp mạng. Không được chia sẻ cùng một khối lưu trữ giữa các bản sao. ## Gói phần mềm di động dành cho Windows Mỗi bản phát hành trên GitHub đều bao gồm `TgWitness--windows-amd64-portable.zip` và `.sha256` tương ứng. Bản phát hành này chứa phiên bản runtime Python 3.12 chính thức có thể nhúng từ python.org (tổng kiểm tra được cố định trong `tools/build_portable.py`), TgWitness cùng các phụ thuộc được cố định của nó, và ba trình khởi chạy: | Tệp | Mục đích | | --- | --- | | `TgWitness.cmd` | Khởi chạy bảng điều khiển; các tùy chọn bổ sung sẽ được truyền vào, ví dụ: `TgWitness.cmd --port 8790` | | `TgWitness-Demo.cmd` | Khởi chạy bản demo tổng hợp tại `data\demo` | | `TgWitness-Check.cmd` | Vui lòng thực hiện kiểm tra sẵn sàng mà không cần khởi động | Từ điển hình thái tiếng Nga được ghim và các cấu hình màu PDF được gói sẵn để sử dụng ngoại tuyến. Quy trình đóng gói chỉ cho phép các đường dẫn tệp đã biết bên trong các thư mục phụ thuộc `data`; các tệp không mong đợi trong các thư mục đó sẽ khiến quá trình xây dựng thất bại. Vui lòng giải nén toàn bộ tệp lưu trữ vào một thư mục có quyền ghi như `Documents\TgWitness`; không chạy chương trình từ bên trong tệp ZIP hoặc từ thư mục Program Files. Môi trường chạy sử dụng đường dẫn mô-đun cách ly, do đó các bản cài đặt Python khác và thư mục `PYTHONPATH` sẽ không ảnh hưởng đến nó. Dữ liệu được lưu trữ trong thư mục `data` của gói phần mềm. Để cập nhật, hãy dừng TgWitness, giải nén phiên bản mới vào một thư mục mới và sao chép thư mục `data` sang đó. Tự xây dựng trên hệ điều hành Windows 64-bit bằng Python 3.12: ``` python tools/build_portable.py ``` ## Thùng chứa ``` docker compose up -d --build --wait ``` Điều này tạo ra một khối lượng lưu trữ bền vững có tên cho /data. Cổng web được ánh xạ đến 127.0.0.1:8787. Quy trình chạy với UID 10001, các quyền hạn bị loại bỏ, hệ thống tệp gốc chỉ đọc, và các thư mục /data và /tmp có thể ghi. `--wait` kiểm tra tình trạng hoạt động của máy chủ web trước khi trả về kết quả; quá trình ủy quyền và giao nhận Telegram hiển thị trên bảng điều khiển. Các hàm trợ giúp được cung cấp sử dụng thời gian chờ sẵn sàng 180 giây sau khi xây dựng. Việc tải xuống các phụ thuộc ban đầu có thể mất nhiều thời gian hơn mức đó. Cả hai tệp Compose cơ sở đều sử dụng tên dự án `tgwitness`, do đó việc giải nén bản phát hành mới vào một thư mục khác sẽ không tự động chọn một khối dữ liệu mới. Chỉ duy trì một bản triển khai hoạt động cho dự án đó. Đối với các cài đặt độc lập, hãy sử dụng tên `docker compose -p NAME ...` duy nhất cùng cổng máy chủ khác, và giữ nguyên cả hai khi cập nhật. Đối với một bản triển khai cũ hơn sử dụng tên dự án khác, hãy tiếp tục sử dụng tên ban đầu của nó cùng với `-p`; `docker compose ls` liệt kê các dự án hiện có. Sao chép `deploy/env.example` vào `.env` và thay đổi `TGWITNESS_PORT` để sử dụng một cổng loopback khác. Ví dụ: `TGWITNESS_PORT=8788` hiển thị bảng điều khiển tại `http://127.0.0.1:8788`; container vẫn lắng nghe trên cổng 8787. `.env` bị Git bỏ qua. Lấy mã thông báo ban đầu: ``` docker compose exec tgwitness cat /data/panel-token.txt ``` Các lệnh hữu ích: ``` docker compose ps docker compose logs --tail 100 -f docker compose stop docker compose up -d --wait ``` `restart: unless-stopped` sẽ khởi động lại trình thu thập sau khi xảy ra sự cố hoặc khi daemon Docker được khởi động lại. Trên máy chủ Linux, hãy kích hoạt Docker khi khởi động bằng trình quản lý dịch vụ của bản phân phối hệ điều hành mà quý vị đang sử dụng, thường là `sudo systemctl enable --now docker`. Trên Windows/macOS, hãy kích hoạt cài đặt “khởi động khi đăng nhập” của Docker Desktop. Việc đăng xuất khỏi máy tính để bàn, chuyển sang chế độ ngủ hoặc khi daemon có thể làm gián đoạn quá trình thu thập dữ liệu. Một container bị dừng rõ ràng sẽ vẫn ở trạng thái dừng cho đến khi quý vị khởi động lại nó. Trong cấu hình ví dụ, dung lượng của phân vùng /tmp được giới hạn ở mức 512 MiB. Quá trình xuất dữ liệu sẽ sử dụng thư mục ``temporary-exports/`` của từng không gian làm việc trên phân vùng /data có tính bền vững thay thế. Hãy dành dung lượng tại đó cho các tác vụ xuất dữ liệu đồng thời, sự gia tăng của nhật ký/WAL, tệp phương tiện và bản sao lưu. Trình khởi chạy sử dụng tệp `deploy/constraints.txt` để cố định các phiên bản phụ thuộc thời gian chạy đáp ứng yêu cầu. Các máy chủ Docker và máy chủ có độ tin cậy cao được cài đặt từ deploy/requirements.lock và deploy/build.lock bằng lệnh pip --require-hashes: mỗi tệp gói phải khớp với mã SHA-256 được ghi lại trong commit, do đó tệp bị thay thế trên PyPI hoặc máy chủ gương sẽ bị từ chối. Các gói chỉ cung cấp mã nguồn (jieba, pyaes) được xây dựng bằng setuptools được cố định trong deploy/build.lock (tùy chọn `--no-build-isolation`) bởi trình khởi chạy, trình xây dựng di động trên Windows và tệp Dockerfile, do đó pip không thiết lập một môi trường xây dựng riêng biệt và không được cố định. Hình ảnh cơ sở Python và các gói hệ điều hành vẫn yêu cầu quá trình kiểm định phiên bản độc lập. Không sử dụng lệnh `docker compose down -v` trừ khi quý vị có ý định xóa sổ nhật ký và các khóa mã hóa. Báo cáo tình trạng container phản ánh tính khả dụng của máy chủ web, chứ không phải việc ghi lại tin nhắn Telegram thành công. Kiểm tra trạng thái bộ thu thập, tín hiệu hoạt động, lỗi và các sự kiện phạm vi phủ sóng trên bảng điều khiển. ### Hồ sơ nhân chứng độc lập Dịch vụ `witness` (tùy chọn) chạy một [nhân chứng độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/) trong thùng chứa riêng của nó, với khóa và nhật ký riêng trong khối lượng `witness-data` và chỉ có một mã thông báo nhân chứng chỉ đọc dành cho bộ thu thập. Tạo mã thông báo trong bảng điều khiển tại **More tools → Extras → Independent witness**, thêm nó cùng với mã thông báo bot và kênh vào `.env`, sau đó khởi động cấu hình: ``` docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag docker compose logs witness # witness key fingerprint ``` Dịch vụ này kết nối với bộ thu thập (collector) trong mạng Compose tại địa chỉ `http://tgwitness:8787` (`TGWITNESS_WITNESS_COLLECTOR` sẽ ghi đè lên địa chỉ này; ví dụ: `/profiles/` dành cho một không gian làm việc khác). Đối với tệp chứng cứ (witness) trên một máy chủ riêng biệt do người khác quản lý, quý vị hãy sử dụng `deploy/compose/compose.witness.yaml` tại đó và thiết lập `TGWITNESS_WITNESS_COLLECTOR` thành địa chỉ HTTPS của bộ thu thập; tệp này chỉ chứa duy nhất tệp chứng cứ. ## Cài đặt hình ảnh đã được phát hành Sao chép `deploy/env.example` vào `.env`. Đặt `TGWITNESS_IMAGE` thành phiên bản đã được phát hành, bằng cách sử dụng đường dẫn kho lưu trữ **viết thường**, ví dụ: ``` TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3 TGWITNESS_PORT=8787 ``` Vui lòng chạy tệp này một cách độc lập, thay vì sử dụng tệp `compose.yaml`: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt ``` Không cần xây dựng mã nguồn, Python hay trình biên dịch trên máy chủ. Quy trình phát hành nhắm đến các container Linux AMD64 và ARM64, bao gồm cả máy ảo Linux của Docker Desktop. Vui lòng sử dụng thẻ phiên bản hoặc mã `ghcr.io/owner/repository@sha256:...` từ phần tóm tắt quy trình. Không có cấu hình nào cho việc di chuyển thẻ `latest` hay nâng cấp ứng dụng tự động. Các biến thể hình ảnh và mã nguồn sẽ sử dụng cùng một khối lượng dữ liệu khi tên dự án của chúng trùng khớp. ## Tự động kích hoạt HTTPS trên máy chủ Vui lòng sử dụng máy chủ chạy Docker, một tên miền do quý vị quản lý và bộ nhớ cục bộ lâu dài. Hướng các bản ghi A/AAAA của tên miền đến máy chủ; chỉ công bố bản ghi AAAA nếu địa chỉ IPv6 truy cập được đến máy chủ đó. Cho phép kết nối TCP 80 và 443 từ bên ngoài vào, cũng như kết nối DNS/HTTPS ra bên ngoài để cấp chứng chỉ. Các dịch vụ khác không được chiếm dụng các cổng này trước đó. Sao chép `deploy/env.example` vào `.env` và thiết lập tên máy chủ, không kèm theo lược đồ hoặc đường dẫn: ``` TGWITNESS_DOMAIN=watch.your-domain.org ``` Bắt đầu quá trình biên dịch mã nguồn với lớp phủ HTTPS: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt ``` ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait ``` Đối với hình ảnh đã được đăng tải, vui lòng sử dụng `deploy/compose/compose.image.yaml` làm tệp đầu tiên thay thế. Hãy giữ lại cả hai tham số `-f` để sử dụng cho các lệnh trạng thái, nhật ký, cập nhật và dừng sau này. Caddy thực hiện việc lấy và gia hạn chứng chỉ, chuyển hướng HTTP sang HTTPS, đồng thời chuyển tiếp các yêu cầu đến bộ thu thập trên mạng Compose riêng tư. Trạng thái chứng chỉ có khối lượng lưu trữ riêng biệt và bền vững. Cổng máy chủ trực tiếp của bộ thu thập vẫn chỉ hoạt động ở chế độ loopback. Cấu hình Caddy được cung cấp không kích hoạt tính năng ghi nhật ký truy cập. Mở `https://watch.your-domain.org` và nhập mã thông báo bảng điều khiển. Chuẩn bị sẵn sàng bao gồm các thùng chứa; việc cấp chứng chỉ và khả năng kết nối bên ngoài phụ thuộc vào DNS và tường lửa. Nếu HTTPS chưa sẵn sàng, hãy kiểm tra DNS, các quy tắc tường lửa và: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy ``` Hình ảnh Caddy được cung cấp đi kèm với thẻ `2-alpine`. Việc thực hiện lệnh `pull` sẽ cập nhật hình ảnh đó; quý vị có thể ghim một bản tóm tắt đã được kiểm thử vào môi trường triển khai của mình nếu cần sử dụng các phiên bản cơ sở hạ tầng cố định. ## Cập nhật và sao lưu Giữ nguyên tên dự án Compose và dung lượng dữ liệu qua các bản cập nhật. Trước tiên, hãy dừng trình thu thập dữ liệu và thực hiện sao lưu toàn bộ. Đối với triển khai dựa trên nguồn mặc định: ``` docker compose stop docker compose cp tgwitness:/data ../tgwitness-backup-before-update ``` Hãy sử dụng một đích sao lưu mới mỗi lần, nằm bên ngoài kho lưu trữ, và bảo vệ nó như tài liệu truy cập tài khoản. Đường dẫn ví dụ chỉ mang tính minh họa; quý vị hãy sử dụng vị trí sao lưu riêng tư của mình. Sao chép toàn bộ thư mục, bao gồm các tệp ẩn, tất cả không gian làm việc, khóa, sổ nhật ký và phương tiện truyền thông. Nếu đã cấu hình, hãy sao lưu riêng khóa chính của kho lưu trữ bên ngoài. Tệp ZIP chứa bằng chứng không phải là bản sao lưu ứng dụng có thể khôi phục. Đối với HTTPS, hãy lưu giữ thêm các khối lượng Caddy nếu quý vị cần duy trì trạng thái chứng chỉ/tài khoản của nó. Để triển khai từ mã nguồn, quý vị hãy tải xuống các tệp bản phát hành mới và thực thi lệnh: ``` docker compose up -d --build --wait ``` Để triển khai phiên bản hình ảnh, quý vị hãy thay đổi `TGWITNESS_IMAGE` thành phiên bản mong muốn, sau đó thực thi lệnh: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait ``` Vui lòng sử dụng (các) tệp Compose của bản cài đặt của quý vị cho các lệnh dừng/sao chép nêu trên. Hãy giữ nguyên `.env`, cấu hình tùy chỉnh và tên dự án như cũ. `down` giữ lại các khối dữ liệu được đặt tên; **`down -v` sẽ xóa chúng**. Không sao chép `.venv` giữa các hệ điều hành hoặc các phiên bản Python khác nhau. Để cập nhật bản gốc, hãy dừng TgWitness, sao lưu toàn bộ thư mục dữ liệu của nó, thay thế các tệp nguồn và chạy `python start.py --setup-only` trước khi khởi động. Kiểm tra quyền truy cập bảng điều khiển, danh tính tài khoản, trạng thái quan sát và phạm vi phủ sóng sau khi cập nhật. Sau khi khởi động lại, TgWitness sẽ tiếp tục từ vị trí cập nhật Telegram đã lưu và yêu cầu các bản cập nhật bị bỏ lỡ trong quá trình cập nhật. Việc khôi phục có thể yêu cầu bản sao lưu trước khi cập nhật nếu phiên bản tương lai thay đổi định dạng lưu trữ. ## Máy chủ từ xa Hãy giữ dịch vụ kết nối với loopback và sử dụng đường hầm SSH, hoặc kết thúc kết nối HTTPS tại một proxy ngược. Tệp Compose cơ bản chỉ hoạt động cục bộ; lớp phủ `deploy/compose/compose.https.yaml` (tùy chọn) cung cấp Caddy cho tên miền đã được cấu hình. Hãy đảm bảo token bearer không xuất hiện trong các URL và nhật ký proxy. Máy chủ proxy ngược nên giới hạn kích thước yêu cầu và tần suất kết nối. Không được để HTTP thuần túy tiếp xúc với Internet. Các ví dụ về systemd, tác vụ đăng nhập Windows, trình duyệt người dùng macOS và Caddy được cung cấp trong [thư mục deploy/.](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) Vui lòng kiểm tra và điều chỉnh các đường dẫn này trước khi cài đặt. Đây là các mẫu được cung cấp sẵn, không phải các cấu hình nền tảng được thực thi cục bộ. Không có dịch vụ nền hay tác vụ nào được đăng ký bởi trình khởi chạy thông thường. Trên hệ điều hành Windows, khi khởi chạy `pythonw.exe` ở chế độ không hiển thị cửa sổ, các thông tin chẩn đoán khởi động/máy chủ sẽ được lưu trữ trong thư mục `logs/server.log` thuộc thư mục dữ liệu (5 MiB mỗi tệp, kèm theo hai bản sao lưu luân phiên). Khi khởi chạy qua giao diện dòng lệnh, hệ thống sẽ lưu lại nhật ký dòng lệnh. Tính năng ghi nhật ký truy cập HTTP bị vô hiệu hóa trong cả hai chế độ. Quý vị cần bảo vệ các tệp nhật ký cùng với thư mục dữ liệu và kiểm tra kỹ lưỡng trước khi chia sẻ. ## Khởi động lại và các khoảng trống Trạng thái quan sát được yêu cầu gần nhất sẽ được lưu giữ. Nếu quá trình quan sát đang hoạt động, hệ thống sẽ cố gắng kết nối lại và tiếp tục theo dõi các nguồn đã chọn khi khởi động. Việc tạm dừng thủ công sẽ xóa bỏ ý định đó. Các trường hợp khởi động lại không thành công sẽ được ghi lại và hiển thị trên bảng điều khiển. TgWitness lưu trữ vị trí cập nhật của Telegram cho tài khoản và cho từng kênh (pts, qts, seq và date) trong kho lưu trữ không gian làm việc và khôi phục chúng khi khởi động lại. Sau đó, client yêu cầu các bản cập nhật bị bỏ lỡ trong thời gian quá trình bị dừng, và việc kiểm tra lại định kỳ sẽ khôi phục các tin nhắn bị bỏ lỡ và ghi lại những tin nhắn đã được lưu mà Telegram không còn trả về nữa. Các cuộc trò chuyện được tải lại khi khởi động. Mỗi lần khởi động đều ghi lại đầu nhật ký trước đó, ranh giới ngoại tuyến và vị trí cập nhật mà nó tiếp tục từ đó. Trình giám sát kiểm tra kết nối mỗi 10 giây và thêm tín hiệu kiểm tra kết nối mỗi phút (**Công cụ khác → Thông số → Ghi lại trạng thái hoạt động mỗi**). Các trường hợp ngắt kết nối và khoảng thời gian im lặng được ghi lại dưới dạng khoảng trống trong phạm vi phủ sóng kèm theo lý do. Các bản chụp lịch sử được lưu trữ dưới dạng các quan sát lịch sử hiện tại riêng biệt bên cạnh các bản ghi trực tiếp. Hàng đợi phương tiện được lưu trữ trong cơ sở dữ liệu SQLite của từng không gian làm việc. Một tin nhắn và tác vụ của nó được cam kết nguyên tử. Các tác vụ đang chạy bị gián đoạn sẽ được khôi phục để thử lại khi khởi động. Mỗi lần tải xuống có thời gian chờ cơ bản 120 giây cộng với thời gian tính theo tốc độ 256 KiB/s dựa trên kích thước của tệp, và giới hạn 1–2,000 MiB cho mỗi loại tệp đính kèm; thời gian chờ, tốc độ và số lần thử lại được cấu hình trong **Công cụ khác → Thông số**. Trình thu thập sẽ bỏ qua các tệp có kích thước không xác định. Việc tạm dừng sẽ giữ nguyên các tác vụ đang xếp hàng. Quá trình thử lại sử dụng mã định danh tệp ban đầu đã quan sát được, chứ không bao giờ sử dụng phiên bản mới nhất của tin nhắn đã được chỉnh sửa sau đó. Các lỗi tạm thời có số lần thử lại giới hạn; việc tạm dừng do quá tải phương tiện (FloodWait) sẽ được duy trì sau khi khởi động lại. Việc khôi phục phương tiện là độc lập với quá trình khôi phục cập nhật Telegram và không thể tái tạo các tệp đã biến mất. ## Sao lưu, khôi phục và dung lượng `tgwitness backup FOLDER` sao chép thư mục dữ liệu trong khi bảng điều khiển vẫn tiếp tục hoạt động: trước tiên là các điểm kiểm tra (checkpoints), sau đó là các tệp SQLite thông qua API sao lưu trực tuyến, tiếp theo là các khóa, phương tiện và hồ sơ, do đó không có điểm kiểm tra nào được sao chép mới hơn nhật ký đã sao chép. Tệp `backup-manifest.json` liệt kê mã SHA-256 của từng tệp và các đầu nhật ký. Để khôi phục, hãy dừng TgWitness và thay thế toàn bộ thư mục dữ liệu bằng thư mục đó. Lần khởi động tiếp theo sẽ ghi nhận rằng nhật ký đã được khôi phục từ một bản sao cũ hơn. Bản ghi này so sánh nhật ký với đầu nhật ký được lưu trữ trong `TGWITNESS_STATE_DIR` , một thư mục nằm ngoài thư mục dữ liệu: khối lượng `tgwitness-state` trong Compose, `/var/lib/tgwitness-state` trong các đơn vị systemd, và thư mục trạng thái cục bộ của người dùng trong các trường hợp khác. Nếu không có thư mục trạng thái có thể ghi, quá trình khôi phục sẽ không được phát hiện và nhật ký sẽ thông báo điều này một lần. Nếu không có lệnh này, hãy dừng quy trình trước khi sao chép **toàn bộ thư mục dữ liệu**, bao gồm các tệp vault.key, signing.enc, credentials.enc, cơ sở dữ liệu SQLite và các tệp WAL, phương tiện, mã thông báo, điểm kiểm tra, cùng tất cả các thư mục con trong thư mục profiles. Khôi phục bản sao hoàn chỉnh trong khi dịch vụ đích đang bị dừng. Việc thiếu khóa vault hoặc khóa ký không khớp sẽ khiến quá trình khởi động thất bại; không được tái tạo khóa để buộc truy cập. Hãy bảo mật các bản sao lưu bằng cách mã hóa và kiểm soát quyền truy cập. Các tệp ZIP chứa bằng chứng có tính di động cao để xem xét các bằng chứng, chứ không phải là bản sao lưu ứng dụng hay bản sao lưu phiên Telegram. Hệ thống không có tính năng xóa tự động theo thời hạn lưu trữ. Quý vị cần lên kế hoạch về dung lượng đĩa cho tất cả tin nhắn, siêu dữ liệu thô, tệp đa phương tiện, các tệp xuất tạm thời và bản sao lưu. Bắt đầu xác minh và xuất các bản ghi luồng thay vì tải toàn bộ nhật ký. Việc xuất dữ liệu cố định một bản chụp đọc trong khi các ghi WAL mới vẫn có thể tiếp tục; các quá trình xuất kéo dài có thể giữ lại các trang WAL, do đó dung lượng đĩa vẫn là yếu tố quan trọng. Các tệp ZIP bị giới hạn ở 4 GiB khi chưa nén để phù hợp với cài đặt mặc định của trình xác minh độc lập; **Thêm công cụ → Thông số → Tệp ZIP có chữ ký lớn nhất** sẽ tăng giới hạn này, và các tệp lưu trữ như vậy được xác minh bằng lệnh `verify.py --max-gib N`. Các định dạng khác không có giới hạn về số lượng sự kiện. Các trình duyệt được hỗ trợ truyền các khối phản hồi theo luồng vào tệp do người dùng chọn. Các trình duyệt khác chỉ đệm tối đa 128 MiB và chuyển các tệp lớn hơn trực tiếp đến CLI đã được xác thực: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Sử dụng `--profile ID` từ **mục Xuất → ID Không gian làm việc** cho một không gian làm việc khác, `--format zip|jsonl|csv|html`, `--url https://your-server` cho máy chủ từ xa, hoặc `--max-mib` để thay đổi giới hạn truyền tải 5 GiB. Giao thức HTTP thuần túy chỉ được phép sử dụng cho loopback. Các mã thông báo được truyền qua tiêu đề, các yêu cầu chuyển hướng sẽ bị từ chối, các tệp hiện có sẽ không bị ghi đè, và các tệp tải xuống chưa hoàn tất sẽ không được công bố như các tệp đã hoàn tất. Nếu TGWITNESS_TOKEN ghi đè lên mã thông báo đã tạo, hãy sử dụng một tệp được bảo vệ riêng biệt chứa giá trị đang hoạt động đó: tệp panel-token.txt sẽ không bị ghi đè bởi giá trị này. Giá trị SHA-256 của lệnh này chỉ là tổng kiểm tra truyền tải; quý vị cần xác minh độc lập tệp ZIP đã được ký. Bảng điều khiển hiển thị các tệp đa phương tiện đang chờ xử lý/thất bại, tệp đa phương tiện đang chờ xử lý lâu nhất, dung lượng đĩa trống, các lần tạm dừng yêu cầu từ Telegram, và các nguồn chưa được xác nhận quyền truy cập. Các chẩn đoán này không phải là một công cụ giám sát việc truyền tải từ đầu đến cuối hoàn chỉnh. Các không gian làm việc chia sẻ chung một quy trình; một tài khoản gây nhiễu vẫn có thể ảnh hưởng đến những tài khoản khác. Các quy trình xử lý riêng biệt, chính sách lưu trữ/xoay vòng, khả năng phục hồi cập nhật bền vững và quy trình đánh giá triển khai đầy đủ vẫn được duy trì. Quyền truy cập bảng điều khiển theo phạm vi được ghi chép trong [phần quyền truy cập và quyền hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/access/); các điểm kiểm tra độc lập được đề cập trong [hướng dẫn dành cho nhân chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/). Các quy trình chi tiết: [kết nối/bảo mật](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/) và [các chế độ hoạt động](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/). --- # Phala / Intel TDX · Triển khai có độ tin cậy cao Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/ Một máy chủ được bảo mật 24/7 trên Hetzner hoặc Phala Cloud, Gateway DNS và các kiểm tra mà bên thứ ba có thể lặp lại. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Một máy chủ được bảo mật 24/7 trên Hetzner hoặc Phala Cloud, Gateway DNS và các kiểm tra mà bên thứ ba có thể lặp lại. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Triển khai và khôi phục](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) ![Triển khai & khôi phục](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Việc triển khai có độ tin cậy cao bổ sung các kiểm tra độc lập đối với môi trường thu thập vào quá trình xác minh kho lưu trữ. Người đánh giá sẽ truy vấn các bản ghi triển khai và truy cập do nhà cung cấp dịch vụ đám mây và Cloudflare lưu giữ, đồng thời việc triển khai Intel TDX bổ sung chứng thực phần cứng cho môi trường của bộ thu thập. Việc sử dụng thông thường trên máy cục bộ và Docker vẫn không thay đổi. Không có gì ở đây hoạt động trừ khi bạn triển khai bằng `python -m tgwitness.cloud`, và trình thu thập dữ liệu chỉ đọc máy chủ của nó khi quá trình triển khai được thiết lập `TGWITNESS_ASSURANCE`. Sơ đồ quy trình · Người vận hành → Máy chủ, tường lửa không có quy tắc cho lưu lượng vào (API nhà cung cấp); Người vận hành → Tunnel và DNS (API Cloudflare); Máy chủ, tường lửa không có quy tắc cho lưu lượng vào → Tunnel và DNS (chỉ gửi đi); Máy chủ, tường lửa không có quy tắc cho lưu lượng vào → Khóa ký được tạo trên máy chủ; Verifier, các token chỉ đọc → Nhật ký nhà cung cấp và tường lửa; Verifier, các token chỉ đọc → Địa chỉ kết nối đường hầm và cổng vào; Verifier, các token chỉ đọc → Tuyên bố /api/assurance đã được ký; Verifier, các token chỉ đọc → Tệp ZIP chứa bằng chứng · Người vận hành · Verifier, các token chỉđọc · Máy chủ, tường lửa khôngcó quy tắc cho lưu lượngvào · Nhật ký nhà cung cấp vàtường lửa · Địa chỉ kết nối đường hầmvà cổng vào · Tuyên bố /api/assurance đãđược ký · Tệp ZIP chứa bằng chứng · Tunnel và DNS · Khóa ký được tạo trên máychủ · API nhà cung cấp · API Cloudflare · chỉ gửi đi **Sơ đồ dưới dạng văn bản** 1. Người vận hành → Máy chủ, tường lửa không có quy tắc cho lưu lượng vào (API nhà cung cấp) 2. Người vận hành → Tunnel và DNS (API Cloudflare) 3. Máy chủ, tường lửa không có quy tắc cho lưu lượng vào → Tunnel và DNS (chỉ gửi đi) 4. Máy chủ, tường lửa không có quy tắc cho lưu lượng vào → Khóa ký được tạo trên máy chủ 5. Verifier, các token chỉ đọc → Nhật ký nhà cung cấp và tường lửa 6. Verifier, các token chỉ đọc → Địa chỉ kết nối đường hầm và cổng vào 7. Verifier, các token chỉ đọc → Tuyên bố /api/assurance đã được ký 8. Verifier, các token chỉ đọc → Tệp ZIP chứa bằng chứng **Trên trang này** - [Những gì trình xác minh có thể kiểm tra](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#what-a-verifier-can-check) - [Nhà cung cấp](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#providers) - [Máy ảo bảo mật trên Phala Cloud (Intel TDX)](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) - [Trước khi bắt đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#before-you-start) - [Từ bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#from-the-panel) - [Kênh nhanh không cần tên miền](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#quick-tunnel-without-a-domain) - [Triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#deploy) - [Triển khai gỡ lỗi và khóa](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#debug-deployment-and-lock) - [Xóa một bản triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#remove-a-deployment) - [Bất kỳ máy chủ nào (tự chứng thực)](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#any-server-self-attested) - [Xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#verify) - [Báo cáo về việc bàn giao bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#report-for-evidence-handover) - [Cloudflare với tư cách là bên chứng kiến độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#cloudflare-as-an-outside-witness) - [Đọc kết quả triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#reading-the-deployment-result) ## Những gì người xác minh có thể kiểm tra | Tuyên bố | Cách kiểm tra | Quản lý bởi | | --- | --- | --- | | Máy chủ đã được tạo thông qua API của nhà cung cấp vào một thời điểm cụ thể | Đối tượng máy chủ và quá trình tạo ra nó trong nhật ký riêng của nhà cung cấp | Nhà cung cấp | | Không ai sử dụng các đường dẫn truy cập của nhà cung cấp | Nhật ký các yêu cầu trên bảng điều khiển, khôi phục, đặt lại mật khẩu, xây dựng lại, ISO, hình ảnh, bản sao lưu | Nhà cung cấp | | Không có gì có thể kết nối với nó | Tường lửa của nhà cung cấp không có quy tắc cho phép kết nối vào; SSH bị ẩn ngay từ lần khởi động đầu tiên | Nhà cung cấp (tường lửa), máy chủ (SSH) | | Bảng điều khiển chỉ có thể truy cập thông qua đường hầm | Lưu lượng vào đường hầm chỉ được chuyển tiếp đến bảng điều khiển; trình kết nối chạy từ địa chỉ máy chủ | Cloudflare | | Chính phần mềm này đang chạy | Hash cây nguồn đã ký của trình thu thập tương đương với bản checkout của commit đã được triển khai | Collector, được kiểm tra dựa trên Git | | Khóa ký đã được tạo trên máy chủ đó | Khóa này ký một tuyên bố nêu rõ ID máy chủ của nhà cung cấp và giá trị băm của tệp cloud-init mà nó đã nhận được | Collector, đã được kiểm tra với nhà cung cấp | | Nhật ký này thuộc về khóa và máy chủ đó | Mỗi quá trình bắt đầu trong bằng chứng ZIP đều chứa thông số đo lường máy chủ cho máy chủ đó | Bằng chứng ZIP | | Khóa Telegram được tạo ra trong lần chạy đã được xác thực | `account.authorized` ghi lại `key_origin: "created"` | Bằng chứng ZIP | Trình thu thập ghi lại trạng thái SSH, các phiên, lịch sử đăng nhập và thông tin khởi động trong các bản ghi process-start và `host.state` đã được ký. Trên một máy ảo thông thường, đây là các bản ghi kiểm kê cục bộ, mà người đánh giá sẽ so sánh với các bản ghi độc lập của nhà cung cấp. Việc triển khai Intel TDX dưới đây còn xác minh thêm các phép đo được hỗ trợ bởi phần cứng. Một triển khai được chứng thực không thu thập dữ liệu dựa trên khóa phiên được nhập vào. Đăng nhập qua điện thoại hoặc mã QR, hoặc sử dụng tệp phiên để đăng nhập độc lập: dù bằng cách nào thì khóa ủy quyền Telegram cũng được tạo bên trong quá trình chạy được chứng thực, nhật ký ghi lại `key_origin: "created"`, và lệnh `python -m tgwitness.cloud verify` sẽ thông qua `account_key`. Một nhật ký có khóa được nhập vào sẽ không vượt qua kiểm tra này. ## Nhà cung cấp | `--provider` | Thông tin đăng nhập | Quyền truy cập chỉ đọc của Verifier | Nhật ký nhà cung cấp dành cho người xác minh | Dành cho | | --- | --- | --- | --- | --- | | `hetzner` | `HCLOUD_TOKEN` | Token đọc của cùng dự án | Các hành động liên quan đến máy chủ và tường lửa | Trong khi các tài nguyên vẫn còn tồn tại | | `digitalocean` | `DIGITALOCEAN_TOKEN` | Mã truy cập cá nhân chỉ đọc | Các hành động của Droplet | Trong khi Droplet vẫn tồn tại | | `linode` | `LINODE_TOKEN` | `linodes`, `firewall`, `events` phạm vi chỉ đọc | Sự kiện tài khoản, phiên bản quy tắc tường lửa | 90 ngày | | `vultr` | `VULTR_API_KEY` | Người dùng có quyền truy cập đọc và `activity_logs` quyền | Nhật ký hoạt động tài khoản (phương thức, đường dẫn, tác nhân) | 30 ngày, thời gian lưu trữ có thể kéo dài hơn nếu đăng ký dịch vụ nhật ký kiểm toán | | `aws` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | `ec2:DescribeInstances`, `ec2:DescribeSecurityGroups`, `cloudtrail:LookupEvents` | Lịch sử sự kiện CloudTrail | 90 ngày | | `phala` | `PHALA_CLOUD_API_KEY` | Một khóa API của cùng một không gian làm việc | Các bản cập nhật ứng dụng và thao tác trên CVM: Thay đổi cấu hình và môi trường Docker Compose, khởi động lại, nâng cấp hệ điều hành | Mặc dù ứng dụng này hiện đã tồn tại | | `generic` | không có | không có | none: **tự chứng thực** | – | Sử dụng một dự án, nhóm, tài khoản hoặc tài khoản con dành riêng cho từng vụ việc: quyền truy cập chỉ đọc của người xác minh sau đó sẽ chỉ hiển thị triển khai này. Thông tin đăng nhập được đọc từ `--provider-token-file` hoặc biến ở trên, không bao giờ từ dòng lệnh. Đối với AWS, tệp chứa `ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]`; khu vực là `--location`. Mỗi báo cáo nêu rõ phạm vi các bản ghi của từng nhà cung cấp. Tóm lại: Hetzner ghi lại các yêu cầu trên giao diện điều khiển; Giao diện điều khiển khôi phục của DigitalOcean, Lish/Glish của Linode và giao diện điều khiển web của Vultr không được ghi lại dưới dạng đó, do đó tài khoản root bị khóa ngay từ lần khởi động đầu tiên và việc đăng nhập vào giao diện điều khiển sẽ yêu cầu đặt lại mật khẩu hoặc thay đổi chế độ khởi động, những thao tác này đều được ghi lại. Vultr trả về địa chỉ giao diện điều khiển cho bất kỳ khóa nào có thể đọc được instance; cả bản ghi lẫn báo cáo đều không lưu trữ thông tin này. ## Máy ảo bảo mật trên Phala Cloud (Intel TDX) Với `--provider phala` trình thu thập chạy trong một máy ảo bảo mật Intel TDX trên [Phala Cloud](https://phala.com/), được quản lý bởi dstack. Máy chủ và nhân viên của Phala không thể đọc bộ nhớ của nó, và bộ xử lý ký xác nhận về những gì máy đã khởi động. Trình xác minh không chỉ tin vào lời của Phala: `tgwitness.tdx` mà tự kiểm tra từng bản xác nhận, lên đến Intel SGX Root CA được ghim, so sánh với danh sách thu hồi của Intel và dữ liệu nền tảng được ký bởi Intel, đồng thời từ chối các máy có thể bị gỡ lỗi hoặc di chuyển. | Nhập báo cáo | Nội dung hiển thị | | --- | --- | | `tdx_binding` | Giấy chứng nhận bao gồm tuyên bố đã được ký của người thu thập và giá trị ngẫu nhiên của yêu cầu này | | `tdx_quote` | Intel xác nhận tính hợp lệ của chứng nhận; chứng nhận chỉ được cấp khi Intel đánh giá nền tảng đó là cập nhật nhất | | `tdx_compose_hash` | RTMR3, được tái tạo từ nhật ký sự kiện dstack, đo lường quá trình soạn thảo trong ứng dụng mà trình thu thập dữ liệu báo cáo | | `tdx_compose` | Mã nguồn đó, từng byte một, chính là mã nguồn được xây dựng từ commit đã triển khai: các tệp nguồn được cố định bằng băm, cả hai hình ảnh đều được cố định bằng bản tóm tắt, không có mã nguồn nào khác | | `tdx_identity` | Chứng nhận này được tạo ra từ ứng dụng và phiên bản đã triển khai, sử dụng các khóa từ hệ thống quản lý khóa (KMS) của Phala và một đĩa được mã hóa | | `tdx_os` | MRTD và RTMR0-2 bằng các giá trị mà trình xác minh tính toán từ hình ảnh hệ điều hành dstack do Dstack-TEE công bố, được xác định thông qua băm hình ảnh hệ điều hành mà CVM báo cáo, cũng như từ các bảng ACPI mà QEMU xây dựng dựa trên cấu hình của máy ảo: phần sụn, nhân hệ điều hành, initrd, dòng lệnh kèm băm hệ thống tệp gốc, bộ nhớ, vCPU và các thiết bị. Hình ảnh phát triển bị lỗi | Hình ảnh hệ điều hành (khoảng 180 MB, trong đó 21 MB được giữ lại) được tải xuống một lần từ [Dstack-TEE/meta-dstack](https://github.com/Dstack-TEE/meta-dstack/releases) vào `dstack-images` bên cạnh bản ghi; `--tdx-image FOLDER` sử dụng một thư mục khác hoặc hình ảnh đã giải nén, `--tdx-image none` bỏ qua so sánh. Việc đo lường tuân theo `dstack-mr` và crate `qemu-acpi` của Dstack-TEE/dstack. Các sự suy giảm hiệu suất đo lường riêng tư so sánh đầu ra ACPI của chính QEMU với một bản ghi Phala Cloud được lưu giữ; việc kiểm định trực tiếp cũng cần hình ảnh đã được công bố. `--tdx-measurements` vẫn so sánh MRTD và RTMR0-2 được cung cấp dưới dạng JSON thay thế. Mỗi lần khởi động bộ thu thập được ghi lại trong nhật ký đều kèm theo chứng nhận như vậy, do đó `verify --evidence` sẽ kiểm tra từng lần khởi động và hình ảnh hệ điều hành mà nó đã khởi động. Các phiên bản ứng dụng của Phala cùng các hoạt động của CVM đóng vai trò như nhật ký của nhà cung cấp: nếu cấu hình Docker Compose bị thay đổi sau khi triển khai, báo cáo sẽ bị từ chối, và các lần khởi động lại sẽ được liệt kê để xem xét. Trong bảng điều khiển, chọn **Máy ảo bảo mật · Phala Cloud** trong mục**Công cụ khác → Tiện ích → Máy chủ 24/7** và dán khóa API Phala Cloud; đường hầm nhanh hoạt động giống như trên Hetzner. Từ dòng lệnh: ``` python -m tgwitness.cloud deploy --provider phala --name case-1 --server-type tdx.small \ --ref v0.8.0 --repository https://github.com/phishdestroy/TgWitness --quick-tunnel \ --provider-token-file phala-key.txt python -m tgwitness.cloud verify --record deployments/case-1/deployment.json \ --provider-token-file phala-key.txt --cloud-init deployments/case-1/docker-compose.yaml \ --source CHECKOUT_OF_COMMIT --fingerprint COLLECTOR_FINGERPRINT --report certificate.md python -m tgwitness.cloud check-report --report certificate.pdf --verifier-fingerprint VERIFIER_KEY ``` `--tdx-collateral` đọc các chứng chỉ và danh sách thu hồi của Intel từ một tệp thay vì tải chúng xuống từ Intel. Dịch vụ Gateway DNS không khả dụng tại đây: Phala không có tường lửa của nhà cung cấp cho lưu lượng truy cập đi. Lệnh ``verify --source`` sẽ tạo trình cài đặt tham chiếu từ bản checkout của bạn, giúp chạy mã nguồn của bản checkout đó trên máy tính này. Đối với việc triển khai từ một kho lưu trữ khác với kho chính thức, lệnh ``verify`` sẽ từ chối trừ khi bạn cũng truyền tham số ``--trust-source``; chỉ nên thực hiện điều này đối với bản checkout mà bạn đã đọc qua. ### Kiểm tra ngoại tuyến bằng verify.py Người nhận không có tài khoản Phala sẽ kiểm tra các trích dẫn bằng trình xác minh độc lập, ngoại tuyến: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_FINGERPRINT python verify.py phala-tdx-attestation.json ``` Đối với trích dẫn của mỗi bản ghi `process.started` trong kho lưu trữ bằng chứng, và đối với trích dẫn của một tuyên bố bộ thu thập đã ký (cũng nằm trong bản ghi triển khai hoặc bản ghi chứng thực đã công bố), `verify.py` kiểm tra chữ ký ECDSA P-256 của trích dẫn bằng khóa chứng thực của nó, chữ ký của báo cáo vùng an toàn trích dẫn bằng chứng bằng chứng chỉ PCK, rằng báo cáo này nêu tên khóa chứng thực (SHA-256 của khóa và dữ liệu xác thực QE), rằng nó đến từ vùng trích dẫn TDX của Intel ở chế độ sản xuất, và chuỗi chứng chỉ PCK → Intel SGX PCK Platform hoặc Processor → CA gốc Intel SGX, có giá trị SHA-256 được cố định trong `verify.py`. Chương trình từ chối các TD có thể gỡ lỗi hoặc di chuyển, kiểm tra xem REPORTDATA có phải là giá trị SHA-512 của bản ghi bắt đầu (khóa nhật ký, phiên chạy, cây nguồn , máy chủ) hay của tuyên bố đã ký, và in ra MRTD, RTMR0-3 và REPORTDATA. Bộ thu thập cũng lưu trữ tài liệu đảm bảo của Intel (Thông tin TCB, Danh tính QE, danh sách thu hồi và chuỗi người phát hành của chúng) cùng với mỗi trích dẫn khi dịch vụ của Intel trả lời. Với dữ liệu này, `verify.py` kiểm tra chữ ký và danh sách thu hồi của Intel, đồng thời tính toán trạng thái TCB tại thời điểm ghi lại, hoặc tại ngày phát hành của tài liệu đảm bảo nếu ngày đó muộn hơn. Nếu thiếu thông tin này, kết quả sẽ hiển thị “Trạng thái TCB chưa được kiểm tra (không có tài liệu đảm bảo trong kho lưu trữ)”. Mã mà máy ảo (VM) đã chạy (các chỉ số RTMR3, hình ảnh hệ điều hành đằng sau MRTD và RTMR0-2), nhật ký nhà cung cấp và xếp hạng hiện tại của Intel vẫn được kiểm tra bằng lệnh `python -m tgwitness.cloud verify`; do đó, quá trình kiểm tra ngoại tuyến sẽ đánh dấu lần thu thập được xác thực là chưa hoàn chỉnh và bản thân nó không đạt đến cấp độ `sealed` hoặc hồ sơ `attested`. ### Chứng chỉ xác thực Đối với việc triển khai Phala, `verify --report certificate.md` cũng ghi lại chứng chỉ: một `certificate.html` độc lập và một tệp A4 `certificate.pdf` kèm theo kết luận, chuỗi tin cậy từ chứng chỉ gốc của Intel đến khóa thu thập, so sánh với các máy chủ thông thường và máy chủ có độ tin cậy cao, các số liệu đo lường bên cạnh các giá trị được tính toán từ hình ảnh đã công bố, ai là người xác nhận từng phần, chuỗi chứng chỉ của Intel, mọi bước kiểm tra, nhật ký nhà cung cấp, và cách thức lặp lại quá trình xác minh. Báo cáo JSON vẫn là bản ghi chính thức; các trang web hiển thị nội dung này. Báo cáo được niêm phong kỹ thuật số bằng chữ ký và dấu thời gian, trong tệp `certificate.seal.json` cùng các tệp `.tsq`/`.tsr` đi kèm: | Con dấu | Tính năng mới | | --- | --- | | Dấu thời gian điện tử được chứng nhận, `http://tsa.belgium.be/connect` | Dấu thời gian theo tiêu chuẩn RFC 3161 được áp dụng lên chính xác các byte của `certificate.json` từ nhà cung cấp dịch vụ chứng thực đủ điều kiện của Chính phủ Liên bang Bỉ (FPS Policy and Support, BOSA). Đơn vị này được liệt kê là dịch vụ đóng dấu thời gian đủ điều kiện, với trạng thái đã được cấp phép, trong danh sách tin cậy của EU tại Bỉ; chứng chỉ gốc (Belgium Root CA6) và các mục trong danh sách, tính đến danh sách được ban hành vào ngày 20 tháng 10 năm 2026, đã được cố định trong `tgwitness/tsa_roots.py`. Theo Điều 41 của Quy định (EU) số 910/2014, dấu thời gian như vậy được coi là chính xác về ngày giờ cũng như tính toàn vẹn của dữ liệu tại mọi quốc gia thành viên EU | | Dấu thời gian theo RFC 3161, FreeTSA | Một dấu thời gian thứ hai, độc lập | | Chữ ký của trình xác minh | Ed25519 được áp dụng cho một tuyên bố nêu rõ mã SHA-256 của báo cáo và mọi dấu thời gian, bằng chính khóa của bên xác minh (`--sign-with FOLDER`, mặc định là `~/.tgwitness/verifier`); tệp PDF mang chữ ký được tạo bằng chính khóa đó | `--timestamp URL` (có thể lặp lại) sẽ chọn các cơ quan chứng thực khác, `--timestamp none` không chọn cơ quan nào, `--sign-with none` để con dấu không được ký. `check-report` kiểm tra băm của báo cáo, chữ ký của bên xác minh, mỗi dấu thời gian đến một gốc đáng tin cậy cùng trạng thái đủ điều kiện của nó, và chữ ký của tệp PDF. Giá trị pháp lý của dấu thời gian đủ điều kiện bên ngoài Liên minh Châu Âu, cũng như của toàn bộ báo cáo, thuộc về tòa án hoặc cơ quan có thẩm quyền tiếp nhận báo cáo đó; con dấu này chứng minh thời điểm báo cáo được tạo ra và khẳng định rằng báo cáo chưa bị thay đổi. Việc chứng thực dựa trên mô-đun TDX và vi mã của Intel cũng như tính toàn vẹn vật lý của bus bộ nhớ. Bất kỳ ai kiểm soát ứng dụng trong tài khoản của Phala đều có thể triển khai một bản soạn thảo khác; bản này sẽ xuất hiện dưới dạng một bản sửa đổi mới với mã băm soạn thảo mới. Máy chủ kiểm soát nguồn thời gian và mạng của máy. Việc triển khai, xác minh bằng `--evidence`, các thao tác khởi động lại, so sánh hình ảnh hệ điều hành, chứng chỉ niêm phong và hủy bỏ đã được thực thi trực tiếp trên Phala Cloud; xin tham khảo [phiên chạy ngày 4 tháng 11 năm 2026](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026). Vào ngày 9 tháng 11, một lần triển khai đã thu thập dữ liệu từ một tài khoản Telegram đang hoạt động; một phiên chạy đã sử dụng khóa phiên được tạo bên trong máy ảo (VM). Xin tham khảo [phiên chạy trên tài khoản đang hoạt động](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/#phala-cloud-with-live-telegram-account--9-november-2026) và [khóa được tạo trong máy ảo](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/#session-key-created-inside-the-tdx-vm--9-november-2026). ## Trước khi bắt đầu 1. Một vùng Cloudflare, ID tài khoản của vùng đó và một mã thông báo API có quyền **Cloudflare Tunnel Edit**, **Zone Read** và **DNS Edit**, được cung cấp cùng với `--cloudflare-token-file` hoặc `CLOUDFLARE_API_TOKEN`. Đối với người xác minh: **Cloudflare Tunnel Read**, **DNS Read** và, đối với nhật ký kiểm toán, **Account Settings Read**. Nếu không có tên miền, một [đường hầm nhanh](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#quick-tunnel-without-a-domain) không cần bất kỳ thông tin nào trong số này. 2. Thông tin đăng nhập của nhà cung cấp có quyền ghi vào một dự án chuyên dụng; `lock` cũng sử dụng cùng một: - Hetzner: Mã thông báo API có quyền Đọc & Ghi; - DigitalOcean: mã thông báo truy cập cá nhân có quyền ghi; - Linode: mã thông báo truy cập cá nhân với `linodes`, `firewall` và `events` phạm vi đọc/ghi; - Vultr: Khóa API của một tài khoản chuyên dụng hoặc tài khoản phụ; - AWS: Cho phép thông tin đăng nhập IAM `ec2:DescribeVpcs`, `ec2:DescribeImages`, `ec2:CreateSecurityGroup`, `ec2:AuthorizeSecurityGroupIngress`, `ec2:RunInstances`, `ec2:CreateTags`, `ec2:DescribeInstances`, `ec2:DescribeSecurityGroupRules` và `ec2:RevokeSecurityGroupIngress`. 3. Commit cần chạy. Một thẻ phát hành sẽ được giải quyết một lần duy nhất thành commit tương ứng với `git ls-remote`; máy chủ chỉ nhận được commit dài 40 ký tự. ## Từ bảng điều khiển Trên máy tính của bạn, **More tools → Extras → Server 24/7** sẽ thực thi cùng một lệnh `deploy` cho Hetzner qua ba bước: chọn Châu Âu hoặc Hoa Kỳ, dán mã thông báo Hetzner (Đọc & Ghi), sau đó kiểm tra loại máy chủ, giá hàng tháng, địa chỉ và phiên bản mà bảng điều khiển tìm thấy với mã thông báo đó. Không có gì được tạo ra trước khi bạn xác nhận. Bảng điều khiển hiển thị từng bước theo báo cáo củ`deploy` , sau đó là địa chỉ, mã thông báo của bảng điều khiển và dấu vân tay khóa ký. Nếu không có tên miền, máy chủ sẽ được cấp một [đường hầm tạm thời](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#quick-tunnel-without-a-domain) ; **mục Máy chủ của bạn → Tìm địa chỉ hiện tại** sẽ tra cứu lại sau khi khởi động lại. Để có địa chỉ cố định dưới tên miền riêng của bạn, hãy mở **Tùy chọn · tên miền riêng** và thêm mã thông báo Cloudflare (liên kết đã chuẩn bị sẽ chọn Zone Read, DNS Edit và Cloudflare Tunnel Edit). Các mã thông báo được truyền cùng với mỗi yêu cầu từ tab trình duyệt đến TgWitness trên cùng một máy tính và không được lưu ở bất kỳ đâu; bản ghi triển khai, cloud-init đã được che giấu, mã thông báo bảng điều khiển và, đối với đường hầm nhanh, khóa địa chỉ được lưu trữ trong `deployments/NAME` bên trong thư mục dữ liệu. Bảng điều khiển chỉ cung cấp tính năng này cho quản trị viên chính qua kết nối loopback trực tiếp (`127.0.0.1`, không có tiêu đề proxy hoặc đường hầm); một bảng điều khiển được truy cập qua mạng sẽ hiển thị các lệnh thay vào đó. Phiên bản mặc định là thẻ phát hành của bảng điều khiển đang chạy, được xác định thông qua API GitHub. Vị trí, loại máy chủ và giá cả lấy từ API của Hetzner: `cpx22` nếu dịch vụ này được cung cấp tại đó, nếu không thì sẽ là loại x86 rẻ nhất với ít nhất 2 GB bộ nhớ. ## Tunnel nhanh mà không cần tên miền `--quick-tunnel` thay thế `--zone`, `--cloudflare-account` và `--panel-host`; không liên quan đến tài khoản hoặc mã thông báo Cloudflare: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token ``` Trên máy chủ, cloudflared mở một [đường hầm nhanh](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) đến bảng điều khiển: một địa chỉ ngẫu nhiên `https://….trycloudflare.com` thay đổi mỗi khi cloudflared hoặc máy chủ khởi động lại. Một dịch vụ nhỏ trên máy chủ đăng mỗi địa chỉ lên một chủ đề ngẫu nhiên trên ntfy.sh , được ký (HMAC-SHA256) bằng một khóa chỉ có trong thư mục triển khai (`address-key.txt`), và lặp lại việc này cứ sau ba giờ vì ntfy.sh lưu giữ các bài đăng trong 12. `deploy` và **Tìm địa chỉ hiện tại** chỉ chấp nhận các bài đăng được ký, do đó một bài đăng giả mạo không thể chuyển bạn và mã thông báo bảng điều khiển của bạn đến địa chỉ của người khác. Chủ đề này được lưu trong bản ghi và cloud-init đã được công bố: bất kỳ ai có chúng đều có thể đọc địa chỉ hiện tại, địa chỉ này vẫn yêu cầu mã thông báo bảng điều khiển. Máy chủ không giữ bất kỳ cổng vào nào trong cả hai trường hợp. Một trình xác minh không có khóa địa chỉ, và bất kỳ ai đọc chủ đề đều có thể đăng bài lên đó. Do đó, trình thu thập cũng đăng chính địa chỉ đó, được ký bằng khóa Ed25519 của chính nó, và `verify` sẽ lấy bài đăng mới nhất được ký bởi khóa của trình thu thập trong bản ghi triển khai; các bài đăng được sắp xếp theo thời gian mà ntfy.sh nhận được chúng, chứ không phải thời gian mà chúng tuyên bố. Một bộ thu thập từ trước khi có thay đổi này sẽ không ký bất kỳ nội dung nào, và `verify` sau đó sẽ lấy bài đăng mới nhất và thông báo điều này trong quá trình kiểm tra `statement`; một bài đăng giả mạo chỉ có thể khiến quá trình kiểm tra đó thất bại, vì địa chỉ đó vẫn phải trả lời bằng khóa của bộ thu thập. Chi phí: không có tài khoản Cloudflare nào lưu trữ bản ghi về đường hầm nhanh, do đó `verify` báo cáo đường hầm, bộ kết nối và kiểm tra DNS là không khả dụng và kết quả tốt nhất là `incomplete` (trên Phala Cloud, kiểm tra lại thành công: trình kết nối chạy bên trong môi trường đo lường); các bản ghi nhà cung cấp, tường lửa, tuyên bố đã ký, đo lường máy chủ và so sánh trình cài đặt được kiểm tra như bình thường. So sánh byte với trình cài đặt tham chiếu yêu cầu một bản commit đã triển khai đã biết `--quick-tunnel`; việc checkout phiên bản 0.7.0 sẽ xây dựng trình cài đặt miền và báo cáo sự khác biệt. Cloudflare cung cấp các đường hầm nhanh (quick tunnels) để thử nghiệm, cho phép 200 yêu cầu đang được xử lý và không hỗ trợ Server-Sent Events, do đó các cập nhật trực tiếp trên bảng điều khiển (các phiên bản sau 0.7.0) có thể không được truyền qua đường hầm này và cần tải lại trang; phần này chưa được thử nghiệm. Đối với trường hợp cần đảm bảo tính ổn định, hãy sử dụng tên miền của riêng bạn. ## Triển khai Hãy xem trước tất cả những gì sẽ được gửi đi. `plan` không thực hiện bất kỳ yêu cầu nào đến nhà cung cấp hoặc Cloudflare: ``` python -m tgwitness.cloud plan --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org ``` Sau đó, triển khai với các tùy chọn và thông tin đăng nhập tương tự: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org \ --witness-host case-witness.example.org \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Các loại máy chủ để bắt đầu: `cpx22` (Hetzner), `s-1vcpu-2gb` (DigitalOcean), `g6-standard-1` (Linode), `vc2-1c-2gb` (Vultr), `t3.small` (AWS). `--location` và `--image` mặc định là Ubuntu 24.04 của từng nhà cung cấp tại khu vực châu Âu. `--repository` lấy bản cam kết từ một kho lưu trữ Git https khác, mà không cần thông tin đăng nhập trong URL (mặc định `https://github.com/phishdestroy/TgWitness.git`). `deploy` cũng chấp nhận `--out` cho một thư mục triển khai khác (mặc định `deployments/NAME`; một thư mục đã chứa sẵn một triển khai sẽ bị từ chối) và `--wait`, số phút chờ bản tuyên bố đã ký của trình thu thập: từ 1 đến 240, mặc định là 20, hoặc 60 cho `generic`. Lệnh: 1. tạo một đường hầm Cloudflare, trong đó lưu lượng truy cập vào (ingress) chuyển tiếp tên miền máy chủ của bảng điều khiển đến bảng điều khiển và, nếu có, tên miền máy chủ của witness đến `/api/witness/head` và `/api/assurance` chỉ; 2. tạo các bản ghi CNAME được chuyển tiếp cho các tên máy chủ đó, từ chối các tên đã tồn tại; 3. tạo một tường lửa nhà cung cấp không có quy tắc vào và một máy chủ phía sau nó không có khóa SSH, không có bản sao lưu, không có tác nhân console, và cloud-init che giấu SSH, khóa quyền root, cài đặt `cloudflared`, tải chính xác bản cam kết, kiểm tra nó và khởi động TgWitness dưới dạng dịch vụ systemd được tăng cường bảo mật; 4. chờ nhận bản tuyên bố đã được ký bởi trình thu thập và kiểm tra xem bản tuyên bố đó có đề cập đến máy chủ này và băm của tệp cloud-init này hay không. `deployments/case-2026-11/` sau đó chứa: | Tệp | Nội dung | Chia sẻ? | | --- | --- | --- | | `deployment.json` | ID, băm, các lệnh gọi API đã thực hiện (phương thức, đường dẫn, trạng thái) và tuyên bố được ký đầu tiên | Có, với trình xác minh | | `cloud-init.redacted.yaml` | Câu lệnh cloud-init chính xác với hai khóa bí mật được thay thế bằng `REDACTED` | Có | | `panel-token.txt` | Mã thông báo bảng điều khiển | Không | Mật khẩu root của nhà cung cấp, mã thông báo đường hầm và mã thông báo bảng điều khiển không bao giờ được ghi vào `deployment.json`. Hãy công bố dấu vân tay của bộ thu thập được hiển thị ở phần cuối thông qua một kênh mà bạn không kiểm soát một mình, ví dụ như một kênh chứng kiến hoặc một tin nhắn gửi đến người nhận. Đăng nhập vào Telegram tại `https://case.example.org` với mã thông báo bảng điều khiển, như được hướng dẫn trong [hướng dẫn tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/). Các hành động trên bảng điều khiển được ghi lại trong nhật ký đã được ký; chúng không phải là các phiên SSH. Một [nhân chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/) có thể kiểm tra `https://case-witness.example.org`. Không có SSH: nếu quá trình khởi động thất bại, trình thu thập dữ liệu sẽ không bao giờ phản hồi. Hãy xóa máy chủ và triển khai lại, hoặc sử dụng triển khai gỡ lỗi để tìm nguyên nhân. ### Thông tin bí mật trong dữ liệu người dùng Cloud-init chứa hai thông tin bí mật: mã thông báo bảng điều khiển và mã thông báo đường hầm Cloudflare. Khóa ký không nằm trong số đó; nó được tạo trên máy chủ. Hetzner, DigitalOcean và Linode không trả về dữ liệu người dùng qua API của họ. Vultr trả về dữ liệu cho bất kỳ khóa nào có thể đọc phân vùng, và EC2 thông qua `DescribeInstanceAttribute`. Đối với AWS, chỉ cung cấp cho người xác minh ba hành động trong bảng, tuyệt đối không `ec2:Describe*`. Đối với Vultr, giả định rằng khóa của người xác minh có thể đọc cả hai mã thông báo. Mã thông báo đường hầm cho phép ai đó chạy một trình kết nối thứ hai: `verify` báo cáo bất kỳ trình kết nối nào không có trên máy chủ, và các tuyên bố của bộ thu thập không thể bị làm giả theo cách đó vì mỗi tuyên bố đều ký một thách thức mới. Với `--quick-tunnel` mật khẩu thứ hai là khóa địa chỉ thay vào đó: bất kỳ ai đọc được nó đều có thể đăng một địa chỉ giả mà bảng điều khiển sẽ chấp nhận. Tuyên bố công khai của người thu thập dữ liệu không đề cập đến địa chỉ máy chủ và nguồn đăng nhập; cả hai thông tin này đều được lưu giữ trong nhật ký đã được ký xác thực. ## Gỡ lỗi triển khai và khóa `--debug-ssh-key KEY --debug-ssh-from 198.51.100.4` giữ SSH cho một khóa từ một địa chỉ hoặc mạng nhỏ, tối đa là /24 đối với IPv4 hoặc /48 đối với IPv6. `KEY` đã được đăng ký với nhà cung cấp: tên hoặc ID của một khóa SSH trong dự án Hetzner, ID hoặc dấu vân tay của một khóa SSH trong nhóm DigitalOcean, tên người dùng Linode có các khóa SSH trong hồ sơ được thêm vào tài khoản root, ID của một khóa SSH trong tài khoản Vultr, hoặc tên của cặp khóa EC2 trong khu vực. Các tùy chọn này không áp dụng cho `generic`. Việc triển khai như vậy được ghi nhận là `debug` và **không bao giờ** được báo cáo là có độ bảo mật cao. Khi hoàn tất, hãy chạy `sudo tgwitness-lock` làm lệnh cuối cùng của phiên SSH cuối cùng, sau đó: ``` python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token ``` Tường lửa mất tất cả các quy tắc kết nối vào. Các báo cáo sau đó hiển thị thời điểm SSH được phép và thời điểm nó bị đóng; cửa sổ đó vẫn hiển thị. ## Xóa một bản triển khai `destroy` xóa máy chủ và tường lửa của nó, được xác định bằng nhãn của bản triển khai để đảm bảo rằng một bản triển khai bị lỗi giữa chừng cũng sẽ bị xóa, sau đó là các bản ghi DNS trỏ đến đường hầm của nó, và chính đường hầm đó. Nhật ký máy chủ và khóa ký cũng bị xóa cùng lúc: hãy xuất bằng chứng trước. Bản ghi vẫn được lưu lại, được đánh dấu `removed`, cùng với các lệnh gọi API của quá trình xóa. ``` python -m tgwitness.cloud destroy --record deployments/case-2026-11/deployment.json --confirm case-2026-11 \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Việc xóa qua API đã được triển khai cho Hetzner. Đối với các nhà cung cấp khác `destroy` phải dừng lại trước khi xóa bất kỳ thứ gì và chỉ định nhãn cần xóa trong bảng điều khiển của nhà cung cấp. Một máy chủ được cài đặt thủ công (`generic`) chỉ mất đường hầm và bản ghi DNS của nó. Việc triển khai đường hầm nhanh không cần mã thông báo Cloudflare: đường hầm của nó kết thúc tại máy chủ, và các bài đăng của nó sẽ hết hạn trên ntfy.sh trong vòng 12 giờ. ## Bất kỳ máy chủ nào (được tự chứng thực) `--provider generic` dành cho máy chủ được mua hoặc cài đặt thủ công. `deploy` tạo đường hầm và DNS, ghi `install.sh` (riêng tư) và `install.redacted.sh` (để công khai), và chờ đợi. Sao chép `install.sh` vào một máy chủ Ubuntu 24.04 vừa cài đặt xong và chạy nó tại đó: ``` sudo bash install.sh ``` Nó ghi lại máy chủ ở trạng thái ban đầu (thông tin đăng nhập, tài khoản, `authorized_keys`, các socket lắng nghe, dịch vụ, tác vụ được lên lịch, gói phần mềm), cài đặt bản cam kết, kích hoạt tường lửa máy chủ, tự xóa bản thân, ẩn địa chỉ SSH và kết thúc phiên làm việc. Báo cáo cho một máy chủ như vậy tốt nhất chỉ là **TỰ CHỨNG NHẬN**: bất kỳ ai chạy trình cài đặt đều đã có quyền root trước đó, và không có bản ghi nào từ nhà cung cấp có sẵn cho người xác minh. Tuy nhiên, điều này vẫn tốt hơn so với một máy chủ không rõ nguồn gốc: danh sách tài sản, băm của trình cài đặt và mọi lần đăng nhập sau đó đều được ký điện tử. ## Xác minh Người xác minh cần `deployment.json`, trình cài đặt đã được công bố, thông tin đăng nhập chỉ đọc và, tốt nhất là bản checkout của commit và bằng chứng ZIP: ``` git clone -c core.autocrlf=false https://github.com/phishdestroy/TgWitness.git checkout git -C checkout checkout 0123456789abcdef0123456789abcdef01234567 python -m tgwitness.cloud verify --record deployment.json \ --provider-token-file read-only.token --cloudflare-token-file cloudflare-read.token \ --fingerprint COLLECTOR_FINGERPRINT --cloud-init cloud-init.redacted.yaml \ --source checkout --evidence tgwitness-evidence.zip --report report.md ``` Mọi giá trị từ nhà cung cấp và Cloudflare đều được trình xác minh yêu cầu tại thời điểm đó; bản ghi chỉ cung cấp các ID cần tra cứu. Mã thoát là 0 cho **PASS**, 1 cho **FAIL** và 2 cho **REVIEW**, **INCOMPLETE** hoặc **SELF-ATTESTED**. `--fingerprint` phải đến từ một kênh độc lập ; nếu không có nó, khóa sẽ chỉ được so sánh với bản ghi của nhà điều hành. `python verify.py` vẫn tự xác minh bằng chứng ZIP, như trong [phần Bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/). Các hành động của nhà cung cấp được phân loại: tạo mới và khởi động trong vòng 30 phút kể từ khi tạo sẽ được chấp nhận; các hành động liên quan đến console, cứu hộ, đặt lại mật khẩu, xây dựng lại, ISO, hình ảnh, ảnh chụp nhanh, sao lưu, Systems Manager, kết nối EC2 Instance và mở cổng tường lửa sẽ bị từ chối; các hành động liên quan đến nguồn điện và bất kỳ hành động nào không mong đợi sẽ được đánh dấu để xem xét. Một hành động không xác định sẽ không bao giờ được chấp nhận mà không có cảnh báo. ## Báo cáo về việc bàn giao bằng chứng `--report report.md` viết báo cáo Markdown và `report.json` bên cạnh đó: 1. kết quả, dấu vân tay khóa thu thập, triển khai, nhà cung cấp, cam kết, máy chủ, tường lửa, đường hầm; 2. mỗi lần kiểm tra kèm theo trạng thái và nguồn (API của nhà cung cấp, API Cloudflare, báo cáo của bộ thu thập, sổ ghi chép bằng chứng); 3. nhật ký của nhà cung cấp với đánh giá về mỗi hành động và, nếu nhà cung cấp ghi lại, thì cả thông tin về chủ thể thực hiện hành động đó; 4. các điểm cuối Cloudflare lưu trữ các kết nối, cấu hình và nhật ký kiểm toán của đường hầm; 5. bản tuyên bố đã được ký của người thu thập; 6. báo cáo bao gồm những nội dung gì và những nội dung nào nằm ngoài phạm vi của báo cáo; 7. các lệnh để tái tạo nó, và thẻ SHA-256 của mọi tệp được cung cấp. Giao nộp báo cáo, `report.json`, `deployment.json`, trình cài đặt đã được phát hành và bằng chứng ZIP. Hãy lập báo cáo sớm: nhật ký của nhà cung cấp chỉ được lưu giữ trong một khoảng thời gian giới hạn. ## Cloudflare với vai trò là bên chứng kiến bên ngoài Mọi thứ ở đây đều là tùy chọn. Ngay cả khi không có tài khoản Cloudflare, máy chủ vẫn hoạt động, và hai trong số các tùy chọn này hiện đang hoạt động: | Nội dung | Nội dung hiển thị | Trong TgWitness | | --- | --- | --- | | Tunnel nhanh hoặc tunnel của tên miền của bạn | Bảng điều khiển chỉ có thể truy cập thông qua đường hầm | trình hướng dẫn cài đặt máy chủ, xem ở trên | | drand relay `drand.cloudflare.com` | các bản ghi sau vòng drand mới hơn bản ghi này: nhật ký được viết theo tiến trình thực hiện | chế độ bằng chứng, **Thêm nhân chứng**, không có tài khoản ([định dạng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) | | Thông báo về tình trạng đường hầm | khi đường hầm bị ngắt kết nối, qua email hoặc webhook từ Cloudflare | thiết lập chúng trong bảng điều khiển Cloudflare | | Gateway DNS (`--gateway-dns`, hoặc **Cloudflare Gateway DNS** trong trình hướng dẫn) | mọi tên miền mà máy chủ đã tra cứu, được Cloudflare trả lời qua TLS; tường lửa Hetzner không cho phép DNS truy cập bất kỳ dịch vụ nào khác; liệu chính sách Gateway có thể sửa đổi các phản hồi hay không | Hetzner, gói Zero Trust miễn phí, không cần tên miền; `verify` kiểm tra tường lửa, vị trí, ghi nhật ký, chính sách, các truy vấn của máy chủ và nhật ký kiểm toán; chế độ bằng chứng sao chép nhật ký vào sổ nhật ký | | Cổng kết nối với Cloudflare: Một client trên máy chủ, một tường lửa ra ngoài chỉ cho phép kết nối qua Cloudflare | mọi kết nối mà máy chủ thực hiện, không chỉ giới hạn ở DNS | chưa được xây dựng | | Truy cập ở phía trước bảng điều khiển | Ai đã đăng nhập vào bảng điều khiển và vào thời điểm nào | chưa được triển khai: cần có tên miền riêng của bạn | | Ghi nhật ký lệnh SSH | mỗi lệnh trong một phiên gỡ lỗi | chưa được xây dựng | Logpush, tính năng giúp lưu giữ bản sao riêng của Cloudflare trong R2, là một tính năng dành cho doanh nghiệp: trên gói miễn phí , Cloudflare trả lời `logpush is not enabled for this account`. Nhật ký Gateway của nó tồn tại trong 24 giờ tại đó, do đó chế độ bằng chứng sẽ sao chép nó vào nhật ký đã ký (**nhật ký của Cloudflare Gateway về các truy vấn DNS của máy chủ này**, một token chỉ đọc với quyền Account Analytics Read). `--gateway-location ID` (kết hợp với `--gateway-dns`) sử dụng vị trí DNS của Gateway hiện có, được xác định bằng ID gồm 32 ký tự, thay vì tạo một vị trí mới; lệnh `destroy` sẽ giữ nguyên vị trí đó. Nếu không có kế hoạch Zero Trust, một tài khoản sẽ có một vị trí DNS. Khi Cloudflare từ chối một vị trí khác, máy chủ sẽ chia sẻ vị trí hiện có và các truy vấn của nó được phân biệt thông qua địa chỉ; bộ lọc đó cũng cần quyền truy cập Zero Trust PII Read, và `destroy` để lại một vị trí được chia sẻ. Một truy vấn nhật ký kéo dài tối đa ba giờ, do đó việc sao chép và `verify` đọc dữ liệu theo các khung thời gian ba giờ trong ngày. Gateway DNS bao gồm bộ giải quyết tên miền của hệ thống. DNS qua HTTPS trên cổng 443 đến một bộ giải quyết tên miền khác, và các kết nối đến một địa chỉ không được tra cứu ở bất kỳ đâu (ví dụ như các trung tâm dữ liệu của Telegram) sẽ không được ghi lại trong nhật ký của nó. Cloudflare không thể xem nội dung bên trong lớp mã hóa của Telegram, các thiết bị khác trên tài khoản Telegram (danh sách thiết bị trong chế độ bằng chứng ghi lại chúng từ phía Telegram) hoặc hypervisor của nhà cung cấp. ## Xem kết quả triển khai Đối với một máy ảo (VM) thông thường, nhà cung cấp kiểm soát cơ sở hạ tầng máy chủ, và danh mục tài nguyên cục bộ được kiểm tra song song với các bản ghi của nhà cung cấp. Đối với Intel TDX, người xác minh còn kiểm tra thêm thông số phần cứng, liên kết bộ thu thập, quá trình tạo lệnh và các chỉ số hệ điều hành. Hãy xem xét từng kết quả để biết các kiểm tra nào đã vượt qua hoặc không khả dụng. Chi tiết tường lửa lịch sử phụ thuộc vào nhà cung cấp; Linode lưu giữ các phiên bản quy tắc. Bản ghi xác thực liệt kê các triển khai đã được kiểm tra và các kiểm tra trực tiếp còn lại, và phạm vi xác minh kết nối các kiểm tra môi trường này với việc thu thập và tính toàn vẹn của kho lưu trữ. --- # Telegram · Hướng dẫn sử dụng bảng điều khiển Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/panel/ Mọi màn hình của bảng điều khiển: cuộc trò chuyện, nhật ký, nguồn, xuất dữ liệu, Tính năng bổ sung, chế độ bảo vệ và kiểm tra mã nguồn. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Translation coverage: this edition includes material from the English original. Mọi màn hình của bảng điều khiển: cuộc trò chuyện, nhật ký, nguồn, xuất dữ liệu, Tính năng bổ sung, chế độ bảo vệ và kiểm tra mã nguồn. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bắt đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/) ![Bắt đầu](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Cài đặt ban đầu và cấu hình](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/) · [Tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/) · [Xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) · [Báo cáo trường hợp](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) Chức năng của từng màn hình, nội dung được ghi vào nhật ký đã ký và vị trí của hướng dẫn chi tiết. Bảng điều khiển hiển thị một không gian làm việc tại một thời điểm: một tài khoản Telegram với các nguồn, nhật ký và khóa ký riêng. Công cụ chọn tài khoản ở thanh trên cùng dùng để chuyển đổi giữa các không gian làm việc. Địa chỉ chứa thông tin về không gian làm việc (`?ws=…`); khi địa chỉ, công cụ chọn và tài khoản đã tải không khớp nhau, các thao tác sẽ bị chặn. Sử dụng phương pháp so sánh [Compare](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) để lựa chọn giữa quan sát trực tiếp, lịch sử đầy đủ, xuất dữ liệu tài khoản/cuộc trò chuyện mới và chuyển giao bản ghi đã lưu. Trang Xuất dữ liệu bao gồm bảng so sánh tương tự ở phía trên các nút điều khiển tải xuống. **Trên trang này** - [Tìm đường](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#find-your-way) - [Bắt đầu từ đây](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#start-here) - [Trò chuyện](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#chats) - [Nhật ký](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#journal) - [Nguồn](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#sources) - [Xuất](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#exports) - [Cài đặt, tài khoản và kết nối](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#settings-accounts-and-connection) - [Phụ lục](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#extras) - [Chế độ bảo vệ](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#protection-modes) - [Các công cụ khác](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#more-tools) ## Tìm hiểu cách sử dụng Thanh bên (sidebar) nhóm sáu phần hàng ngày lại với nhau: **Trang chủ**, **Trò chuyện**, **Nhật ký**, **Xuất dữ liệu**, **Tài khoản** và **Cài đặt**. Các phần mà quyền truy cập của bạn không cho phép sẽ bị bỏ qua. **Phần Công cụ khác** chứa các công cụ điều tra và quản trị. Mở **Giao diện** ở cuối thanh bên để thay đổi ngôn ngữ, chủ đề, múi giờ hoặc mức độ giao diện: | Cấp độ | Các phần trong thanh bên | | --- | --- | | Đơn giản | Các phần hàng ngày | | Tiêu chuẩn | Ngoài ra còn có Bảng trường hợp, Nguồn, Quyền truy cập và Tài liệu trong phần Công cụ khác | | Chuyên gia | Ngoài ra còn có Bản đồ hệ thống, Cấu trúc mạng, Tính năng bổ sung, Hỏi kho lưu trữ, Thông số, Tài khoản, Nhật ký hệ thống và Tích hợp trong mục Công cụ khác | Tên các phần giữ nguyên ở mọi cấp độ. Một cấp độ chỉ ẩn các phần. Một tính năng bị ẩn vẫn tiếp tục hoạt động, và máy chủ tự động kiểm tra mọi quyền truy cập. Cấp độ, ngôn ngữ, chủ đề và múi giờ được lưu theo người vận hành và không gian làm việc; xem [cài đặt](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/). Sử dụng **Đi đến phần** ở đầu thanh bên (Ctrl+K, hoặc ⌘K trên Mac) để tìm một cuộc trò chuyện, một tham số hoặc một bản ghi nhật ký bằng `#number`. Các phím mũi tên để di chuyển, phím Enter để mở, phím Esc để đóng. Thanh trên cùng có: - **Thông báo**: các sự cố và thay đổi trong cuộc trò chuyện được xử lý từ nhật ký. **Chọn “Đánh dấu tất cả là đã đọc”** sẽ xóa số đếm, còn **“Quy tắc thông báo”** sẽ mở cửa sổ quy tắc. Việc gửi thông báo đến Telegram, Discord hoặc email được thiết lập trong [Phần bổ sung → Thông báo](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#notifications). - Menu trạng thái bộ sưu tập với điều khiển bắt đầu/tạm dừng, cài đặt kết nối và chẩn đoán tình trạng hoạt động cho Telegram, việc thu thập sự kiện, các nguồn và hàng đợi tệp đính kèm. Trên màn hình hẹp, hãy mở menu này bằng biểu tượng hoạt động. - **Khóa**: đóng bảng điều khiển trong trình duyệt này. Bộ sưu tập vẫn tiếp tục chạy trên máy chủ. Phiên bản và chế độ bảo vệ nằm trong **mục Giao diện**; xem [các chế độ bảo vệ](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#protection-modes). Khi cài đặt, ứng dụng sẽ mở **màn hình Trang chủ** sau khi đăng nhập; một liên kết cụ thể sẽ mở màn hình được yêu cầu. Người đánh giá trong phạm vi trò chuyện sẽ mở **màn hình Trò chuyện**. Các địa chỉ `/home`, `/case-board`, `/pseudo-secret` và `/network-topology` cũng mở các màn hình tương ứng của chúng. Các địa chỉ trang không xác định sẽ trả về mã trạng thái HTTP 404 kèm theo các đề xuất trang gần đó. Không gian làm việc demo chứa các tin nhắn giả định và không bao giờ kết nối với Telegram. Các thao tác có thể thay đổi không gian làm việc thực tế sẽ bị từ chối tại đây. [Bản đồ hệ thống](https://github.com/phishdestroy/TgWitness/blob/main/docs/SYSTEM-MAP.md) hiển thị các đường dẫn tài khoản, trạng thái proxy, điểm cuối socket, kho lưu trữ được mã hóa, dịch vụ bằng chứng và các yêu cầu mạng được quan sát của cài đặt này. Chọn một tài khoản để kiểm tra đường dẫn của nó. Các dịch vụ có sẵn nhưng bị vô hiệu hóa vẫn hiển thị. ## Bắt đầu tại đây Tổng quan sẽ xóa biểu đồ và bản tóm tắt dành riêng cho tài khoản đó khi bạn chuyển sang tài khoản khác hoặc đăng nhập lại. Các trạng thái “Đang tải”, “Đọc không thành công” và “Khoảng thời gian không có bản ghi nào được lưu” có các trạng thái riêng biệt. **Tính năng Thử lại** sẽ lặp lại thao tác đọc không thành công; nếu máy chủ yêu cầu chờ, thời gian thử lại tiếp theo sẽ hiển thị. Khi làm mới không thành công, hệ thống sẽ giữ lại dữ liệu thành công gần nhất cho cùng một không gian làm việc và gắn nhãn cho dữ liệu đó bằng thời gian cập nhật gần nhất. Mỗi tài khoản được kết nối sẽ hiển thị riêng biệt **thông tin Collector heartbeat** và **“Last event received** ”. Thông tin đầu tiên thể hiện hoạt động của bộ thu thập; thông tin thứ hai là bản cập nhật Telegram mới nhất đã nhận được. Một nguồn không có hoạt động có thể giữ nguyên giá trị của thông tin thứ hai trong khi bộ thu thập vẫn tiếp tục hoạt động. Mở menu “collection-status” để kiểm tra chẩn đoán về kết nối, quá trình thu thập, nguồn và tệp đính kèm. Choose a task. **Export my account** downloads what the account can read now. **Follow an investigation** records new messages, observed edits and deletion notices from the chats you choose. While observation is paused, Chats, Journal and Sources show the setup card: connect the account, choose sources, start observation. With the goal **Evidence for a case**, or in the Witnessed, Case preparation, GitHub-verified or Maximum [protection mode](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#protection-modes), starting observation first reads Telegram's session list (not while **Strict: read only the chosen chats** is on). If other sessions are signed in, the panel names their number and offers **Start anyway** or **Open Sessions of this account**. Other goals and modes start without that question. The goal question stays on this page until you answer or skip it. A new workspace opens the [first setup](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/) instead. ## Cuộc trò chuyện Các cuộc trò chuyện đã lưu, mặc định chỉ cho phép xem. Các hàng trò chuyện hiển thị trạng thái thu thập, các tệp đang chờ tải xuống và tải xuống thất bại, quá trình tải lịch sử ban đầu cũng như các hạn chế được trả về trong siêu dữ liệu hộp thoại của Telegram. Trạng thái truy cập bị mất hoặc chưa được xác nhận không đồng nghĩa với việc nội dung bị cấm. Mở **mục Bộ lọc** để chọn các trạng thái này hoặc sắp xếp theo hàng đợi tệp; lựa chọn này sẽ được giữ nguyên trong URL khi trang được tải lại. Bộ lọc **Thử lại** tìm các lần tải trò chuyện ban đầu đang chờ xử lý sau khi xảy ra lỗi. Biểu tượng của chúng hiển thị loại lỗi và, trong quá trình thu thập, thời gian thử lại tiếp theo. Trang Chủ tóm tắt số lượng lần tải cần thử lại. Chế độ thu thập tạm dừng sẽ giữ lại các tác vụ cho đến khi được tiếp tục. In **Simple** mode Home also shows **Can be handed to a court: yes** or **no · missing: …**. Yes means timestamps are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does not check the signing key: the recipient confirms its fingerprint, received separately, and runs `verify.py` with `--tsa-ca` and the authority's root certificate. A Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here. Các mục nhật ký có thông tin đính kèm được lưu giữ hiển thị loại, tên và kích thước (tính bằng byte) đã quan sát được. Các kết quả tải xuống mới cũng lưu giữ loại phương tiện và thời lượng khi Telegram cung cấp chúng. Các bản ghi đã ký trước đó vẫn giữ nguyên; siêu dữ liệu bị thiếu sẽ không được tái tạo. - Tìm kiếm trong danh sách theo tên hoặc ID. Hệ thống sẽ khớp với nhiều từ theo bất kỳ thứ tự nào, bao gồm cả tên và một phần của ID kết hợp với nhau. Nút **+** cho phép **Thêm cuộc trò chuyện hoặc kênh** (thêm hoặc xóa các cuộc trò chuyện đang theo dõi), **Mở liên kết Telegram** và **Pseudo-secret · Bắt đầu cuộc trò chuyện**. Tính năng **Mở liên kết Telegram** nhận tên người dùng hoặc liên kết mời và lưu bản xem trước vào nhật ký; việc tìm kiếm @tên người dùng hoặc liên kết t.me mà không có kết quả trùng khớp cũng thực hiện tương tự. **Tham gia / mở và theo dõi** sẽ tham gia cuộc trò chuyện và thêm nó vào danh sách nguồn của bạn; việc mở bot sẽ gửi lệnh `/start` cho bot đó. - Các cuộc trò chuyện “Pseudo-secret” xuất hiện trong cùng một danh sách, có màu xanh lá cây kèm biểu tượng ổ khóa, và được mở trong chế độ “Pseudo-secret”. Khi tính năng quan sát bị tắt, danh sách sẽ hiển thị một mục **“Quan sát ngoại** tuyến” kèm tùy chọn **Bắt đầu quan sát**. - Các bộ lọc nhanh là các tab xếp thành một hàng: **Tất cả**, **Bán bí mật**, **Ưu tiên**, **Thay đổi** (các chỉnh sửa đã lưu hoặc thông báo xóa) và **Cần chú ý** (mất quyền truy cập hoặc quyền truy cập chưa được xác nhận, tin nhắn không tìm thấy khi kiểm tra lại, tệp đa phương tiện không thành công, thử lại lịch sử hoặc hạn chế của Telegram). Các tab trống sẽ bị ẩn. Số lượng tuân theo bộ lọc tìm kiếm và loại; bộ lọc nhanh thay thế bộ lọc trạng thái. Các lựa chọn này vẫn được giữ lại trong URL khi tải lại trang và điều hướng Quay lại/Tiếp theo. **Cần chú ý** không đánh dấu tin nhắn là đã xóa. Loại, trạng thái và sắp xếp tùy chỉnh vẫn hiển thị dưới dạng các ô có thể tháo rời khi **phần Bộ lọc** được thu gọn. - Các danh sách lớn hiển thị 80 kết quả phù hợp cùng một lúc; **nút Hiển thị thêm** sẽ hiển thị 80 kết quả tiếp theo. Cửa sổ trò chuyện đang mở và hàng được chọn vẫn được giữ nguyên khi có kết quả phù hợp, ngay cả khi nằm ngoài đợt hiển thị đó. Bộ đếm hiển thị số lượng cuộc trò chuyện đã hiển thị so với tổng số kết quả phù hợp. Tính năng tìm kiếm áp dụng cho toàn bộ danh sách, bao gồm cả những cuộc trò chuyện chưa được hiển thị. - Từ màn hình tìm kiếm, **phím ↓** di chuyển đến kết quả đầu tiên, **phím ↑** di chuyển đến kết quả cuối cùng được hiển thị, và **phím Enter** mở kết quả khớp đầu tiên. Trong danh sách, **các phím ↑/↓** và **Home/End** di chuyển tiêu điểm; **phím Enter** mở cuộc trò chuyện đang được chọn. **Phím Escape** quay lại màn hình tìm kiếm, nơi nhấn phím này lần nữa sẽ xóa truy vấn. **Tùy chọn Xóa bộ lọc** sẽ thiết lập lại danh sách mà không thay đổi bộ sưu tập hoặc cuộc trò chuyện đang mở. - Tiêu đề cuộc trò chuyện đếm các tin nhắn **đã xóa, giữ nguyên văn bản**, **đã xóa trước khi lưu** và **không tìm thấy khi kiểm tra lại**. Mỗi số đếm là một nút chỉ hiển thị các tin nhắn đó; nhấn lần nữa để hiển thị tất cả. **Đã xóa** và **Không tìm thấy khi kiểm tra lại** trên một tin nhắn mở ghi chú với thời gian và điều đã quan sát được. Danh sách trò chuyện và thông báo dùng cùng định nghĩa. Tin nhắn đã xóa có màu đỏ và giữ văn bản đã lưu; tin nhắn đã sửa giữ mọi phiên bản đã lưu. - **Tính năng tìm kiếm tin nhắn đã lưu** sẽ tìm kiếm toàn bộ lịch sử trò chuyện được lưu giữ, bao gồm cả các phiên bản văn bản trước đó. Các bộ lọc dành cho tin nhắn đã xóa, đã chỉnh sửa, phương tiện truyền thông và tác giả cũng áp dụng cho toàn bộ lịch sử trò chuyện được lưu giữ. Trường hợp **Không tìm thấy khi kiểm tra lại** là độc lập với các thông báo xóa tin nhắn đã nhận. Tính năng tìm kiếm không yêu cầu Telegram cung cấp tin nhắn; hãy sử dụng **Tải lịch sử** để lấy thêm thông tin. Kết quả trùng khớp trong phiên bản trước đó sẽ mở các phiên bản đã lưu kèm theo liên kết nhật ký tương ứng. **Phiên bản hiển thị** xác định bản ghi được sử dụng cho tin nhắn và dấu trang của nó; phản hồi lịch sử muộn không thể thay thế bản chỉnh sửa trực tiếp mới hơn trên màn hình. - Giữa các tin nhắn, cuộc trò chuyện hiển thị hai loại dấu khoảng trống. **Số tin nhắn không được ghi nhận** liệt kê các số mà nhật ký không có bản ghi, chỉ trong kênh và siêu nhóm: các cuộc trò chuyện khác dùng chung một dãy số cho toàn tài khoản, nên bước nhảy ở đó không nói gì về cuộc trò chuyện. **Khoảng trống trong phạm vi bao phủ** đánh dấu khoảng thời gian giữa một lần gián đoạn được ghi nhận và lần tiếp tục được ghi nhận kế tiếp, kèm lý do nếu nhật ký có. Các dấu xuất hiện khi hiển thị tất cả tin nhắn và ẩn đi khi bộ lọc tin nhắn đang bật. - **Báo cáo xây dựng** Nút ở phía trên các tin nhắn sẽ mở Report Studio với cuộc trò chuyện này được chọn sẵn. Nút tương tự trong thẻ thông tin tác giả sẽ chọn cả cuộc trò chuyện và tác giả đó. Cả hai thao tác này chỉ thay đổi bản nháp; hãy lưu lại trước khi xuất. - Nhấn vào tên tác giả sẽ mở một thẻ thông tin cá nhân bên cạnh các tin nhắn: hồ sơ đã lưu, tiểu sử, ảnh đại diện, quà tặng, liên kết, số lượng tin nhắn và dòng thời gian hoạt động cùng các bản ghi nhật ký, cùng với các tùy chọn **Làm mới hồ sơ** và **Tạo báo cáo**. **Nút Đóng**, phím Esc hoặc một cuộc trò chuyện khác sẽ đóng thẻ này; cuộc trò chuyện vẫn giữ nguyên vị trí. **Rhythm** trong thẻ đếm các tin nhắn đã lưu của tác giả trong cuộc trò chuyện này theo múi giờ UTC: số ngày hoạt động, bắt đầu sau 6 giờ im lặng, thời gian trung bình để trả lời người khác trong vòng 24 giờ, chuỗi tin nhắn liên tiếp dài nhất, tỷ lệ chia sẻ được gửi từ 00:00 đến 06:00 và bản đồ nhiệt theo ngày trong tuần × giờ. - **Chọn** phía trên tin nhắn bật chế độ chọn tin nhắn: nhấn vào tin nhắn để đánh dấu, nhấn kèm Shift để đánh dấu một dải, hoặc dùng **Chọn hiển thị** rồi **Tạo báo cáo**. Trình tạo báo cáo mở ra với **Tin nhắn đã chọn** đã được điền. Báo cáo bao gồm bản ghi của các tin nhắn đó (quan sát, chỉnh sửa, thông báo xóa) vượt qua các bộ lọc khác; bộ lọc tác giả bỏ qua thông báo xóa vì chúng không có người gửi. Có thể chọn tối đa 1.000 tin nhắn; một thẻ trong trình tạo xóa một tin nhắn, và có thể thêm toàn bộ cuộc trò chuyện bên cạnh. Số tin nhắn bị thiếu chỉ được báo cáo cho cuộc trò chuyện được chọn toàn bộ. - **Lịch sử tải** hiển thị 100, 250 hoặc 500 tin nhắn gần nhất trong giao diện này và trong nhật ký. Bạn có thể tìm thấy nó tại **Các thao tác trong trò chuyện**, cùng với các cài đặt ghi, chế độ chỉ đọc và các tùy chọn ẩn thông tin bí mật. Menu sẽ đóng lại khi nhấn phím Escape hoặc nhấp chuột bên ngoài menu. Việc tải các tin nhắn trước đó sẽ giữ nguyên vị trí đang đọc. Nếu truy vấn hoặc trang thay đổi trong khi Telegram đang phản hồi, quá trình tải hoàn tất sẽ cập nhật nhật ký đã lưu mà không thay thế giao diện mới hơn. Trường hợp tải tự động không thành công sẽ hiển thị **Thử lại**. Để tải tất cả các nguồn đã được kích hoạt, hãy sử dụng [Nguồn → Lịch sử đầy đủ](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#sources). - **Tính năng Xuất cuộc trò chuyện** sẽ tải xuống toàn bộ lịch sử hiển thị dưới dạng tệp đã được ký `chat.json` và `chat.html`. Một số tài khoản được kết nối có thể chia sẻ công việc: mỗi tài khoản tải xuống phạm vi số tin nhắn của riêng mình và ký xác nhận phần của mình, còn tài khoản khởi tạo quá trình xuất sẽ ký xác nhận tệp lưu trữ. Xem [hướng dẫn xuất một cuộc trò chuyện](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md). - Danh sách **Người** hiển thị tất cả những người có tin nhắn được lưu trong cuộc trò chuyện này. Hồ sơ Người được tắt theo mặc định vì chúng là dữ liệu cá nhân về bên thứ ba. Khi được bật cho một cuộc trò chuyện, hồ sơ sẽ hiển thị tên và lịch sử tên người dùng, cờ Telegram, băm ảnh đại diện, hoạt động, ai trả lời ai, các cuộc trò chuyện khác được quan sát, cũng như ví, số điện thoại, tên người dùng và liên kết được đề cập. Mỗi thông tin đều trỏ đến bản ghi tương ứng. **Tính năng Xuất hồ sơ** sẽ lưu một tệp đã ký, tùy chọn bảo vệ bằng mật khẩu ZIP; việc tắt hồ sơ sẽ xóa tệp hồ sơ. Xem [hồ sơ người dùng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#people-profiles). - **Tính năng “Tập hợp tất cả tác giả** trên cùng một tab” sẽ yêu cầu Telegram cung cấp thông tin hồ sơ, tiểu sử, ảnh đại diện, quà tặng và liên kết tiểu sử của tất cả những người có tin nhắn được lưu trong cuộc trò chuyện. Trong một kênh hoặc siêu nhóm, các tài khoản khác đang kết nối có thể cùng tham gia công việc này. Mỗi tài khoản được chọn sẽ được dành riêng cho bộ sưu tập, thu thập thông tin đầy đủ về từng người và liên hệ với tác giả thông qua một trong những tin nhắn đã lưu của tác giả đó. Một tài khoản đang bận với nhiệm vụ khác sẽ không bị can thiệp và sẽ tham gia ngay khi rảnh rỗi. Nếu không thể liên hệ được với một tác giả, hệ thống sẽ quay lại tài khoản chính của cuộc trò chuyện. Tiến trình hiển thị tỷ lệ phần trăm, thời gian còn lại và phần đóng góp của từng tài khoản; **nút Tạm dừng** sẽ giải phóng các tài khoản. Mỗi bản ghi đã lưu đều ghi rõ tên tài khoản đã đọc nó, và nhật ký ghi lại thời điểm mỗi tài khoản tham gia và rời khỏi. - **Tính năng "Lưu hồ sơ" hiện** ghi lại bản chụp nhanh của hồ sơ cuộc trò chuyện hoặc bot: mô tả, thành viên, liên kết mời, lệnh bot. ### Chế độ chỉ đọc, gửi tin nhắn và thông tin bí mật Hai công tắc phía trên các tin nhắn giúp bảo vệ tài khoản và người đọc: - **Chỉ đọc** được bật khi một cuộc trò chuyện được mở. Tắt tính năng này để gửi tin nhắn hoặc nhấn các nút bot . Mỗi hành động sẽ yêu cầu xác nhận qua **Gửi dưới dạng @tài_khoản?** hoặc **Nhấn nút bot này dưới dạng @account?**, thông báo cho bạn biết rằng các thành viên trong cuộc trò chuyện sẽ thấy thông báo này và nó sẽ được ghi vào nhật ký đã được ký. **Không hỏi lại trong vòng 10 phút trong cuộc trò chuyện này** sẽ bỏ qua yêu cầu xác nhận trong một thời gian. Tính năng gửi tin nhắn bị tắt đối với mục tiêu **Bằng chứng cho một vụ án**, cả trong bảng điều khiển và trong API. - **Tính năng "Mask secrets"** ẩn đi những thông tin trông giống như mật khẩu, mã đăng nhập, khóa API hoặc băm (hash), token bot, chuỗi phiên, khóa riêng tư, JWT hoặc số thẻ thanh toán (số thẻ thanh toán được kiểm tra bằng tổng Luhn). **Tính năng "Show"** hiển thị một giá trị; việc hiển thị này được ghi lại trong nhật ký. Việc tắt tính năng ẩn thông tin cho trình duyệt này cũng được ghi lại. Chỉ nội dung hiển thị bị thay đổi: các bản ghi gốc và mọi bản xuất vẫn giữ nguyên văn bản đầy đủ. ### Lưu các tin nhắn đã chọn dưới dạng hình ảnh Trong một cuộc trò chuyện trên đám mây, hãy chọn **Chọn**, đánh dấu các tin nhắn, sau đó chọn **“Lưu dưới dạng hình ảnh**”. Để chụp toàn bộ cuộc trò chuyện, hãy chọn **“Lưu cuộc trò chuyện dưới dạng hình ảnh**” trong menu công cụ trò chuyện; tính năng này sẽ tải tối đa 2.000 tin nhắn được lưu gần đây nhất và thông báo khi các tin nhắn cũ hơn bị loại bỏ. Chế độ xem trước cung cấp các kiểu **Sáng**, **Tối** và **Cổ điển**; sử dụng “Trước” và “Tiếp theo” để chụp các đoạn dài hơn. **Tải xuống tệp ZIP đã ký** sẽ lưu từng trang dưới dạng PNG cùng với `pages.sig.json` và `README.txt` ([hình ảnh cuộc trò chuyện đã ký](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#signed-chat-images)). Bạn có thể chọn tối đa 50 tin nhắn, và tất cả các tin nhắn này phải vẫn còn trong cửa sổ cuộc trò chuyện đã tải. Bảng điều khiển sẽ yêu cầu bạn thu hẹp phạm vi lựa chọn quá lớn thay vì tự động loại bỏ các tin nhắn. Mỗi trang đều kết thúc bằng một khối xác thực: bao gồm số hồ sơ nhật ký được hiển thị, nội dung trò chuyện, thời gian hiển thị, dấu vân tay khóa không gian làm việc, `verify.py` lệnh cho trang đó và một mã QR chứa nội dung trò chuyện, khóa và thời gian hiển thị. Việc ký tên yêu cầu quyền xuất và thêm một `export.image_attested` bản ghi vào nhật ký. Hình ảnh này bao gồm nội dung đã lưu, tác giả, số tin nhắn, thời gian UTC, số phản hồi, nhãn tệp đính kèm và trạng thái chỉnh sửa/xóa đã lưu. Hình ảnh sử dụng nội dung đã lưu mới nhất cùng với số phiên bản được lưu giữ; nội dung tệp đính kèm, các nút tích hợp, phản hồi và các phiên bản nội dung trước đó sẽ không được hiển thị. Một tin nhắn dài sẽ tiếp tục ở trang tiếp theo kèm theo số tin nhắn và số phần. Mỗi trang đều ghi rõ rằng nội dung được hiển thị từ các tin nhắn đã lưu. Tệp PNG chỉ là một trích đoạn hình ảnh; hãy sử dụng kho lưu trữ và công cụ xác minh của nó khi chuyển giao các bản ghi đã ký và tệp đính kèm. Quá trình hiển thị diễn ra trong trình duyệt mà không cần gửi yêu cầu đến Telegram; đối với việc ký tên, chỉ có mã SHA-256 và số bản ghi của từng trang được gửi đến bảng điều khiển. Tính năng che giấu thông tin bí mật hiện có giúp bảo vệ văn bản, tên tác giả và nhãn tệp đính kèm. Bản xem trước lưu giữ ảnh chụp màn hình cho đến khi được đóng lại và sẽ bị xóa khi bảng điều khiển bị khóa hoặc khi thay đổi không gian làm việc/cuộc trò chuyện. Nhật ký đã ký và lựa chọn báo cáo vẫn giữ nguyên. Xem [các báo cáo trường hợp](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) để biết cách xuất báo cáo đầy đủ. ### Chuyển tiếp tin nhắn Tắt **chế độ Chỉ đọc** cho cuộc trò chuyện, sau đó chọn **Chuyển tiếp** bên dưới một tin nhắn, hoặc **Chọn**, đánh dấu tối đa 100 tin nhắn và chọn **Chuyển tiếp**. Chọn đích đến theo tên: danh sách này bao gồm các cuộc trò chuyện đã lưu và các cuộc trò chuyện Telegram của tài khoản mà tài khoản đó có thể đăng (các nhóm, cuộc trò chuyện riêng tư, bot và kênh mà tài khoản đó quản trị). Bảng điều khiển sẽ yêu cầu xác nhận, sau đó tự động chuyển tiếp qua Telegram với tốc độ gửi tin nhắn của tài khoản. Yêu cầu và kết quả của nó là các bản ghi nhật ký được ký tên, trong đó nêu rõ cuộc trò chuyện nguồn, số tin nhắn và đích đến. Các bản sao chỉ được lưu trữ tại đích khi cuộc trò chuyện đó được theo dõi. Một cuộc trò chuyện cấm chuyển tiếp sẽ trả về thông báo từ chối và không có gì được gửi đi. ### Chuyển tiếp cuộc trò chuyện sang một kênh hoặc nhóm Quản trị viên chính có thể mở một cuộc trò chuyện trên đám mây đã lưu và chọn **Chuyển tiếp cuộc trò chuyện** từ menu công cụ của nó. Chọn **Kênh mới**, **Nhóm mới** hoặc **Kênh hiện có hoặc Nhóm hiện có**. Các đích đến mới là riêng tư. Đối với đích đến hiện có, **tùy chọn Chọn cuộc trò chuyện** sẽ liệt kê các nhóm và kênh mà tài khoản đó quản trị; tìm kiếm theo tên. Điểm đến phải cho phép tài khoản này đăng bài. Các điểm đến là diễn đàn không được hỗ trợ. Hãy tạm dừng quá trình quan sát hoặc một tác vụ tài khoản đang hoạt động khác và bật các hành động Telegram trước khi xem trước. Các tài khoản chỉ đọc và **Bằng chứng cho một vụ án** chuyển nhượng cầu thủ. **Xem trước** đọc giới hạn lịch sử Telegram có thể truy cập và kiểm tra đích đến. Nó không tạo đích đến cũng như không gửi tin nhắn. **Bắt đầu** bắt đầu quá trình chuyển; bản xem trước sẽ hết hạn sau mười phút. Mỗi không gian làm việc chỉ có thể có một quá trình chuyển đang hoạt động. Quá trình chuyển tiếp sẽ đọc lịch sử Telegram từ cũ nhất đến mới nhất, cho đến tin nhắn cuối cùng được hiển thị trong bản xem trước. Quá trình này không giới hạn ở những tin nhắn đã được lưu trong TgWitness. Các tin nhắn đến sau mốc thời gian đó sẽ bị loại trừ. Tính năng chuyển tiếp gốc giữ nguyên thông tin tác giả và phương tiện truyền thông có sẵn trên Telegram mà không cần tải xuống và tải lên bản sao. Các album nằm trong phạm vi này sẽ được giữ nguyên. Thông báo sẽ không phát ra âm thanh. Các phản hồi, cấu trúc chủ đề, phản ứng, chỉnh sửa cũng như các tin nhắn đã bị xóa hoặc không thể truy cập sẽ không được khôi phục. Các cuộc trò chuyện bí mật nằm ngoài quy trình này. Các biện pháp bảo vệ nội dung và hạn chế đăng tải của Telegram vẫn có hiệu lực. Bảng điều khiển hiển thị các tin nhắn đã gửi thành công, các tin nhắn bị bỏ qua, trạng thái và thời gian thử lại tiếp theo được phép. Các tin nhắn dịch vụ và tin nhắn được bảo vệ riêng lẻ sẽ bị bỏ qua kèm theo lý do được ghi lại. Khoảng cách giữa các tin nhắn và giới hạn theo giờ của tài khoản áp dụng cho mọi tin nhắn; một album sẽ chờ cho đến khi các khung thời gian đã được dành riêng cho nó đến hạn. Các khoảng dừng do FloodWait và chế độ chậm sẽ cập nhật thời gian chờ RPC chung của tài khoản. Các thiết lập mặc định hiện có về tốc độ gửi tin nhắn của tài khoản vẫn giữ nguyên. **Tạm dừng** sẽ ngừng các yêu cầu đang chờ xử lý; **Hủy** sẽ dừng các tác vụ còn lại mà không xóa các tin nhắn đã gửi hoặc xóa đích đã tạo. Một yêu cầu đang được xử lý có thể hoàn tất trước khi một trong hai hành động này có hiệu lực. Đóng hộp thoại sẽ không hủy công việc. Sau khi khởi động lại quy trình, các tác vụ chưa hoàn thành cần phải được **Tiếp tục** một cách rõ ràng. Phản hồi gửi bị mất hoặc không đầy đủ sẽ tạm dừng tác vụ để kiểm tra: hãy kiểm tra đích đến trước khi tiếp tục. Việc thử lại sẽ giữ lại các ID ngẫu nhiên và số lần xác nhận đã lưu trữ của Telegram; điều này không đảm bảo việc loại trừ trùng lặp vô thời hạn bởi Telegram. Kết quả tạo đích đến không xác định không thể được tiếp tục tự động: hãy kiểm tra Telegram và hủy tác vụ cũ trước khi bắt đầu một lần chuyển mới đến đích đến đã được tạo (nếu có). Nếu việc lưu công việc hoặc mục nhật ký của công việc đó không thành công, người thực hiện sẽ khôi phục trạng thái được lưu gần nhất và giải phóng tài khoản. Một lệnh gửi hoặc tạo có thể đã được chuyển đến Telegram vẫn được đánh dấu để xem xét. Hãy thử lại thao tác khởi động không thành công hoặc tiếp tục sau khi bộ nhớ đã sẵn sàng trở lại; tiến trình đã được xác nhận chỉ được tiếp tục cùng với mục nhật ký tương ứng. Đã ký `interaction.forward.*` các mục nhật ký ghi lại ranh giới, đích đến, ID tin nhắn nguồn/đích đã được xác nhận và các bước bỏ qua. Chúng ghi lại quá trình chuyển giao; chúng không thay thế các quan sát và bản xuất ban đầu đã được ký. ## Sổ ghi chép Tất cả các bản ghi mà không gian làm việc đã ký, sắp xếp theo thứ tự từ mới nhất đến cũ nhất. - **Tổng quan** thống kê số tin nhắn được theo dõi, số lần chỉnh sửa được ghi lại, thông báo xóa và các nguồn được chọn. - **Dòng thời gian sự kiện** lọc theo loại sự kiện (tất cả, chỉnh sửa, xóa, phản hồi, thành viên, phạm vi phủ sóng), theo văn bản và theo nguồn. **Tải các sự kiện trước đó** quay lại trang trước. - Mở một bản ghi để xem chi tiết, mã băm và nội dung của nó. **Liên kết đến bản ghi này** là một địa chỉ mở cùng bản ghi đó. Các thông tin bí mật có thể có sẽ được che đi trong bản xem trước này; các tệp xuất vẫn giữ nguyên bản gốc. - Nhật ký chỉ cho phép ghi thêm: không có thao tác nào trên bảng điều khiển có thể chỉnh sửa hoặc xóa bản ghi. Kiểm tra bằng cách chọn **Xuất → Xác minh nhật ký** hoặc `python -m tgwitness.verify`; xem [phần xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/). ## Nguồn Không gian làm việc này ghi lại những cuộc trò chuyện nào và lưu giữ những thông tin gì từ các cuộc trò chuyện đó. Các thay đổi sẽ áp dụng cho các hoạt động trong tương lai; các bản ghi đã lưu vẫn được giữ nguyên. **Tính năng Refresh chat list** đọc các cuộc trò chuyện và thư mục của tài khoản. Tính năng này không tải xuống tin nhắn. ### Phạm vi - **Những nội dung mà tài khoản này ghi lại** : **Các cuộc trò chuyện đã chọn** (chỉ các cuộc trò chuyện bạn thêm vào), **Thư mục Telegram** (một trong các thư mục của tài khoản, bao gồm cả các cuộc trò chuyện được thêm vào sau này) hoặc **Toàn bộ tài khoản** (mọi cuộc trò chuyện, cũng như mọi cuộc trò chuyện mới, nhóm, cuộc trò chuyện riêng tư hoặc bot ngay khi chúng xuất hiện). **Chế độ điều tra** dành cho một tài khoản chuyên dụng: nó ghi lại mọi thứ mà tài khoản đó nhìn thấy, các tin nhắn và thao tác nhấn nút của chính tài khoản đó, đồng thời lưu ngay lập tức hồ sơ của mỗi cuộc trò chuyện mới cùng các tin nhắn đã hiển thị trước đó. Hình [hướng dẫn dành riêng cho tài khoản](https://phishdestroy.io/tgwitness/docs/dedicated-account/) giải thích lý do tại sao không bao giờ nên sử dụng tài khoản chính của bạn. - **Chế độ Nghiêm ngặt: chỉ đọc các cuộc trò chuyện đã chọn** (Chỉ các cuộc trò chuyện đã chọn, tắt theo mặc định) sẽ ngừng việc đọc các thông báo dịch vụ của Telegram, danh sách phiên và các tin nhắn trước đó của cuộc trò chuyện khi chế độ này được bật, không thay đổi cài đặt nội dung nhạy cảm và bỏ qua các cập nhật về cuộc gọi điện thoại. Xem [phần Chế độ Nghiêm ngặt: Chỉ các cuộc trò chuyện đã chọn](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#strict-chosen-chats). - **Các loại nguồn** giới hạn chế độ thư mục và chế độ toàn tài khoản cho các kênh, nhóm, cuộc trò chuyện riêng tư và bot. **Các hành động của chính mình** thêm các tin nhắn, thao tác chỉnh sửa và các lần nhấn phím trả lời của chính tài khoản đó. - **Khi có cuộc trò chuyện hoặc bot mới xuất hiện**: lưu hồ sơ của nó và tối đa số lượng tin nhắn mới nhất hiển thị đã chọn. - **Các cuộc trò chuyện đã chọn** được đánh dấu là đề xuất. Tùy chọn **Hủy bỏ thay đổi** sẽ đưa biểu mẫu trở lại phạm vi đã lưu cho đến khi bạn nhấn **Lưu phạm vi**. [Pseudo-secret](https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/) là giao diện Trò chuyện bí mật được tích hợp sẵn, được kích hoạt cho từng tài khoản sau khi cài đặt mô-đun giao thức chỉ bằng một nút bấm. Chức năng theo dõi trên đám mây và lịch sử sử dụng các cài đặt riêng. Không có dữ liệu nào được ghi lại khi TgWitness không đang chạy; sau khi khởi động lại, ứng dụng chỉ cập nhật những gì Telegram vẫn trả về, và báo cáo sẽ hiển thị khoảng trống đó. Các cuộc trò chuyện vượt quá giới hạn danh sách trò chuyện (1.000 cuộc trò chuyện trừ khi được thay đổi trong Tham số) sẽ được thêm vào khi chúng trở nên hoạt động lần tiếp theo. Các nút bot nhúng được nhấn trong một ứng dụng khác sẽ không hiển thị; phản hồi của bot sẽ được ghi lại. ### Các cuộc trò chuyện trong phạm vi Lọc theo trạng thái (**Đã bật**, **Đã tạm dừng**, **Ưu tiên**, **Đã loại trừ**, **Chưa xác nhận quyền truy cập**, **Đã bỏ qua**) và loại, sau đó thực hiện hành động trên phần đã chọn: bật, tạm dừng, đánh dấu hoặc xóa ưu tiên, loại trừ khỏi phạm vi hoặc xóa. Biểu tượng trạng thái chỉ hiển thị tình trạng; các hành động nằm trong menu của mỗi hàng kèm theo dòng mô tả chức năng của chúng. Việc tạm dừng và loại trừ sẽ yêu cầu xác nhận, kể cả khi thực hiện hàng loạt. Việc xóa một nguồn sẽ yêu cầu nhập tên của nguồn đó và xóa các hồ sơ cá nhân liên quan; các bản ghi đã lưu của nguồn đó vẫn được giữ lại trong nhật ký. Một nguồn mà danh sách trò chuyện của tài khoản không hiển thị đang **nhận được cập nhật, không có trong danh sách trò chuyện**trong khi các bản ghi vẫn tiếp tục đến; nếu không, **quyền truy cập chưa được xác nhận**. **Tính năng "Trò chuyện có sẵn"** cho phép thêm các cuộc trò chuyện bằng cách chọn **"Thêm đã chọn**" hoặc **"Thêm tất cả các cuộc trò chuyện phù hợp**". ### Lịch sử đầy đủ Tải lịch sử có sẵn của mọi nguồn đã bật vào phần Trò chuyện và nhật ký. Tiến trình được giữ nguyên sau khi khởi động lại; tệp đính kèm tuân theo cài đặt phương tiện của bạn. Xem [lịch sử nguồn](https://phishdestroy.io/tgwitness/vi/docs/reference/history/). ### Ghi lại - **Chọn những thay đổi cần lưu giữ**: tin nhắn mới, chỉnh sửa, thông báo xóa, phản ứng hiển thị, tham gia và rời khỏi. Một cài đặt sẵn sẽ thay đổi biểu mẫu; **Lưu cài đặt ghi lại** sẽ áp dụng cài đặt đó. Việc bật lại một danh mục sẽ không khôi phục các sự kiện đã bỏ lỡ. - **Lưu giữ phương tiện khi có sẵn**: tải xuống tệp đính kèm với kích thước tối đa cho mỗi tệp, thiết lập theo từng loại từ 1 đến 2.000 MiB và giới hạn độ dài video tính bằng giây (0 có nghĩa là không giới hạn). Mỗi lần thử tải xuống đều được ghi lại kết quả. - **Kiểm tra lại**: kiểm tra các cuộc trò chuyện ưu tiên vài phút một lần, các cuộc trò chuyện khác thì hiếm khi, để tài khoản không bị vượt quá giới hạn FloodWait của Telegram. Nhập 0 để tắt nhóm. Đánh dấu các cuộc trò chuyện ưu tiên bằng dấu sao trong danh sách; số lượng cuộc trò chuyện mỗi lần kiểm tra và khoảng thời gian tạm dừng giữa các cuộc trò chuyện được thiết lập trong Phần Thông số. Xem [bộ sưu tập](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/). - The save bar says whether these settings match the recommended ones. **Return to recommended** fills in the recommended values; **Save recording settings** applies them and **Discard changes** restores the saved ones. ## Xuất dữ liệu **Tải xuống** chuẩn bị các tệp; **Báo cáo xây dựng** chọn cách hiển thị của các báo cáo. | Nội dung | Sử dụng nó để | Hướng dẫn | | --- | --- | --- | | Xuất tài khoản | Một bản chụp nhanh mới nhất về những nội dung mà tài khoản có thể đọc được hiện tại | [Xuất tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/account-export/) | | Chia sẻ bản sao | Một phiên bản thu gọn của tệp xuất tài khoản đã hoàn tất | [Thông báo](https://phishdestroy.io/tgwitness/vi/docs/reference/account-export/#prepare-a-disclosure-for-a-lawyer-or-another-recipient) | | Đã ký ZIP | Nhật ký, báo cáo, tệp đính kèm và các công cụ xác minh tại một ranh giới nhật ký cố định | [Xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) | | Báo cáo định dạng HTML, PDF, JSON | Một báo cáo có thể đọc được và được niêm phong | [Báo cáo trường hợp](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) | | JSONL, CSV | Bản ghi gốc có chữ ký; bảng tính an toàn với công thức | [Xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) | | Trích đoạn bàn giao | Chỉ các cuộc trò chuyện, khoảng thời gian và những người mà người nhận cần | [Bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#investigation-handoff) | | Xuất nội dung trò chuyện | Một cuộc trò chuyện đã được ký `chat.json` và `chat.html` | [Xuất một cuộc trò chuyện](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md) | - **Việc mã hóa các tệp tải xuống ở trên bằng mật khẩu** (tối thiểu 12 ký tự) sẽ tạo ra một tệp AES-256 ZIP mà 7-Zip hoặc WinRAR có thể mở được. Tệp đã được ký bên trong vẫn giữ nguyên. Mật khẩu không được lưu trữ. - Khi khóa phiên của không gian làm việc này được nhập vào, các hộp thoại xuất tài khoản và xuất cuộc trò chuyện sẽ thông báo điều này trong một dòng: các bản sao của khóa đó có thể tồn tại bên ngoài danh sách phiên của Telegram . Dòng đó cũng cung cấp **tùy chọn Tạo ủy quyền độc lập**, giúp mở trang đăng nhập với tùy chọn này đã được chọn sẵn. Xem [phần tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#create-an-independent-authorization). - Việc xuất cuộc trò chuyện bị lỗi hoặc bị hủy vẫn giữ nguyên phạm vi đã lưu. Chức năng **Capture or export one chat** sau đó sẽ hiển thị các tùy chọn **Resume export** và **Start over**; xem phần " [export one chat"](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md). - Trong khi tính năng xuất lịch sử trò chuyện có tên **Tải xuống các tin nhắn đã đọc cho đến nay** sẽ lưu một tệp ZIP, trong đó các trang được ký số ngay khi được ghi vào; dòng bên dưới hiển thị số lượng tin nhắn đã được ký số. - **Các tệp xuất đã chuẩn bị** lưu trữ tối đa 20 tệp trong giới hạn 2 GiB, cộng với tệp mới nhất, để tải xuống lặp lại; mỗi tệp đều kèm theo mã SHA-256 để người nhận đối chiếu. Mỗi thẻ ghi rõ nội dung của tệp: **Tệp lưu trữ đã ký** (nhật ký đầy đủ và số lượng bản ghi), **Báo cáo**, **Bản ghi nhật ký** hoặc **Trích xuất bàn giao**, tiêu đề và ID vụ việc, cùng với các tiêu chí lựa chọn báo cáo được sử dụng để tạo tệp (cuộc trò chuyện, tin nhắn được chọn, ngày tháng). **Chức năng Hiển thị** sẽ thu hẹp danh sách xuống còn một loại khi danh sách chứa nhiều loại. - Khi trình duyệt từ chối hiển thị hộp thoại lưu, bảng điều khiển sẽ chuyển sang chế độ tải xuống thông thường. - **Danh tính ký của bạn** hiển thị dấu vân tay khóa. **Lưu điểm kiểm tra** và Tải xuống **biên nhận chạy đã ký** cung cấp cho bạn các bản ghi để lưu trữ bên ngoài bộ thu thập. Chuẩn bị **yêu cầu dấu thời gian** tạo ra một yêu cầu RFC 3161 mà không cần liên hệ với bất kỳ dịch vụ nào. ## Cài đặt, tài khoản và kết nối - **Cài đặt**: mục tiêu, kết nối, nội dung cần ghi lại và giao diện. Xem [hướng dẫn thiết lập ban đầu và cài đặt](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/). - **Tài khoản**: mỗi không gian làm việc với trạng thái, nguồn, sự kiện và hàng đợi tệp đính kèm của nó. Lọc theo **Cần chú ý**, **Thu thập**, **Ngoại tuyến hoặc tạm dừng** hoặc **Chưa kết nối**, tạm dừng hoặc tiếp tục một lựa chọn, nhập hàng loạt tệp tài khoản và quản lý các nhóm. Xem [tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/). - **Tài khoản**: đăng nhập và lộ trình kết nối của tài khoản này. Trực tiếp, một cấu hình WireGuard , proxy của riêng bạn, nhóm MTProto công cộng hoặc WARP; chuẩn bị và kiểm tra lộ trình, sau đó áp dụng nó cho tài khoản này, một nhóm hoặc tất cả các tài khoản. Xem [kết nối và máy chủ proxy](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/) và [máy chủ proxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md). **Bảo mật tài khoản → Các phiên của tài khoản này** hiển thị danh sách các phiên Telegram, kết thúc một hoặc tất cả các phiên đó, và — đối với khóa được tạo trong không gian làm việc này — cung cấp **Đặt đây làm phiên làm việc duy nhất khi Telegram cho phép**, tính năng này sẽ lặp lại hành động đó sau 24 giờ mà Telegram yêu cầu và hiển thị mật khẩu xác thực hai bước mà nó thiết lập một lần. Xem [bảo mật tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#create-an-independent-authorization). **Bảo mật tài khoản → Kiểm tra chứng kiến** sử dụng một không gian làm việc thứ hai để kiểm tra xem phiên này có nhận được các bản cập nhật theo thời gian thực hay không; xem [kiểm tra chứng kiến](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#witness-probe). Tính năng tạm dừng và tiếp tục hàng loạt sẽ giữ nguyên lựa chọn đã được xác nhận trong phiên làm việc nơi nó được mở. Các nút điều khiển sẽ bị vô hiệu hóa trong khi đang chờ xác nhận hoặc thực thi; việc chuyển đổi không gian làm việc hoặc khóa bảng điều khiển sẽ hủy bỏ các lệnh còn lại. Sau khi thực thi, bảng điều khiển sẽ làm mới trạng thái tài khoản. Một yêu cầu thất bại sẽ được báo cáo là lỗi yêu cầu, vì máy chủ có thể đã áp dụng lệnh đó. Các lệnh sẽ không được lặp lại tự động. ## Tính năng bổ sung Tùy chọn: chỉ cần một tài khoản và các nguồn là đủ để bắt đầu thu thập. Chỉ tùy chọn mà bạn chọn mới mở cài đặt của nó, và không có gì được kết nối tự động. Thẻ **“Mức độ bảo vệ**” ở phía trên hiển thị chế [độ bảo vệ](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#protection-modes). | Thẻ | Tính năng mới | Hướng dẫn | | --- | --- | --- | | Lưu trữ & dung lượng đĩa | Sao lưu, di chuyển các tệp cũ lên đám mây của bạn, một bản sao bằng chứng không thể bị xóa | [Lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/storage/) | | Mục tiêu & mức độ bảo mật | Các cài đặt được đề xuất cho mục tiêu và hai thang đo của bạn | [dưới đây](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#goal-and-protection-level) | | Thông báo | Các vấn đề, tin nhắn đã thay đổi và bản tóm tắt hàng ngày; bot điều khiển của riêng bạn | [dưới đây](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#notifications) | | Bằng chứng & bản sao lưu | Dấu thời gian, thêm các nhân chứng và bản sao được mã hóa lưu trữ ngoài hệ thống | [dưới đây](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#evidence-and-backups) | | Máy chủ hoạt động 24/7 | Một máy chủ đám mây không hỗ trợ SSH, được tạo và xóa trực tiếp từ bảng điều khiển | [Độ tin cậy cao](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#from-the-panel) | | Nhân chứng độc lập | Các bản kiểm tra đã được ký sẽ được đăng lên kênh Telegram hoặc Discord của bạn | [Witness](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/) | | Kiểm tra mã nguồn | So sánh chương trình đang chạy với một commit công khai trên GitHub | [dưới đây](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#code-check) | ### Mục tiêu và mức độ bảo mật Bốn câu hỏi: 1. **Công cụ này dùng để làm gì?** Để lưu trữ hồ sơ cá nhân, phục vụ công tác điều tra hoặc làm bằng chứng cho một vụ việc. 2. **Bạn sẽ theo dõi bao nhiêu?** Một vài cuộc trò chuyện (tối đa khoảng 50), nhiều cuộc trò chuyện (tối đa khoảng 500) hoặc toàn bộ tài khoản. Điều này sẽ đặt giới hạn danh sách cuộc trò chuyện thành 1.000, 3.000 hoặc 20.000. 3. **Ảnh và tệp tin?** Chỉ văn bản, ảnh và phương tiện truyền thông ngắn (ảnh 20 MB, video 100 MB), hoặc tất cả (video và tài liệu tối đa 1 GB mỗi loại). Tùy chọn “Tất cả” với tài khoản đầy đủ cũng giữ lại 4 GiB dung lượng đĩa trống. 4. **Nó sẽ chạy ở đâu?** Trên máy tính này hoặc trên một máy chủ luôn hoạt động. Phần đề xuất liệt kê các dấu thời gian độc lập, drand và danh sách thiết bị của Telegram, mỗi mục đều kèm theo một dòng mô tả về chức năng của nó. Dấu thời gian được tạo mỗi 60, 30 hoặc 10 phút cho bản ghi cá nhân, cuộc điều tra hoặc bằng chứng; drand và danh sách thiết bị cần có dấu thời gian. Chỉ **áp dụng** các thay đổi này, chính sách tệp đính kèm và hai tham số ở trên. Mỗi thay đổi là một bản ghi nhật ký, cộng với `setup.applied`. Thông báo, bản sao ngoài trang web, máy chủ, Gateway DNS, kiểm tra mã và nhân chứng được đề xuất làm các bước tiếp theo với các biểu mẫu riêng. Hai thang đo được tính toán dựa trên các thiết lập hiện tại, chứ không phải dựa trên mục tiêu: | Quy mô | Điểm | | --- | --- | | Độ tin cậy | Nhật ký đã ký 1, dấu thời gian 3, drand 1, danh sách thiết bị 1, kiểm tra mã khớp 1, thăm dò chứng nhân 1, máy chủ được xác thực 2, nhật ký DNS Gateway 1 | | Độ tin cậy | Máy chủ luôn hoạt động 3, bản sao ngoài cơ sở 3, Object Lock 1, thông báo sự cố 1 | Tỷ lệ đọc **tối đa** 80% trở lên, 50% **là cao**, 25% **là trung bình**, dưới mức đó **là cơ bản**. Độ tin cậy hiện được tính dựa trên máy chủ luôn hoạt động theo câu trả lời cho câu hỏi 4, trước khi kiểm tra bất kỳ máy chủ nào. ### Thông báo Các thông báo được gửi qua Apprise đến Telegram, Discord, Slack, ntfy, email, Matrix và hơn 100 dịch vụ khác. Chọn một dịch vụ, điền vào một hoặc hai trường và gửi thử nghiệm, hoặc dán trực tiếp các địa chỉ Apprise. - **Các vấn đề**: đĩa gần đầy, tài khoản đã đăng xuất, lỗi thu thập, sao chép hoặc dấu thời gian , một phiên mới đăng nhập vào tài khoản bằng thiết bị, ứng dụng và danh sách quốc gia của Telegram, mã đăng nhập hoặc lần đăng nhập mới mà Telegram báo cáo trong quá trình quan sát, và một phiên khác sau khi **thiết lập Đây là phiên duy nhất**. Trên một máy chủ được niêm phong, cổng SSH mở hoặc việc đăng nhập cũng là vấn đề. - **Thay đổi**: các tin nhắn đã xóa, đã chỉnh sửa và bị thiếu trong các cuộc trò chuyện được theo dõi, được nhóm lại thành một thông báo cho mỗi lần kiểm tra (mỗi phút trừ khi được thay đổi trong phần Cài đặt). - **Các tác vụ đã hoàn thành**: lịch sử, xuất dữ liệu và bản sao lưu. - **Các kết quả trùng khớp trong danh sách theo dõi**: các kết quả trùng khớp từ các danh sách theo dõi được thiết lập để gửi cảnh báo. - **Tóm tắt hàng ngày** vào giờ đã chọn, theo giờ máy chủ. Các thông báo hiển thị tên cuộc trò chuyện và số lượng tin nhắn. Trích đoạn tin nhắn bị tắt theo mặc định; khi bật tính năng này, nội dung tin nhắn sẽ được gửi ra khỏi máy này. **Bot điều hành của bạn** là bot do chính bạn tạo từ @BotFather, có chức năng trả lời `/status` và `/stats`, và tùy chọn `/pause`, `/resume` và `/copy`. Chỉ các cuộc trò chuyện và ID người dùng Telegram được liệt kê mới có thể sử dụng nó; nội dung cuộc trò chuyện được lưu trữ trong không gian làm việc. Sử dụng một bot riêng nếu một ứng dụng khác đã nhận các lệnh của nó. Xem [phần thông báo](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Notifications.md) và [bot điều hành](https://phishdestroy.io/tgwitness/vi/docs/reference/storage/#operator-bot-and-completion-notices). ### Bằng chứng và bản sao lưu - **Các dấu thời gian độc lập** chỉ gửi giá trị SHA-256 của mỗi điểm kiểm tra đã ký đến các cơ quan theo RFC 3161 và lịch OpenTimestamps, cứ sau 5 đến 1,440 phút. Người nhận cần thời gian từ bên thứ ba này như điều kiện tối thiểu để làm bằng chứng. **Anchor hiện** đang thực hiện một vòng quét. Xem [các dấu thời gian](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/). - **Các bản ghi khác**, mỗi bản đều bị tắt cho đến khi được chọn: vòng drand mới nhất, danh sách các thiết bị đã đăng nhập của Telegram (không kèm địa chỉ IP) và nhật ký các truy vấn DNS của máy chủ từ Cloudflare Gateway. Xem [các bản ghi tùy chọn](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices). - **Bản sao lưu được mã hóa** sẽ sao chép nhật ký, tệp tin, điểm kiểm tra và bản xuất cuộc trò chuyện vào bộ lưu trữ tương thích với S3 (Wasabi, Amazon S3, Backblaze B2, Cloudflare R2, MinIO). Mọi thứ đều được mã hóa trên máy này trước tiên. **Tải xuống khóa mã hóa** và lưu giữ nó riêng biệt: nếu không có khóa này, bản sao sẽ không thể đọc được. Chức năng Object Lock ở chế độ Quản trị hoặc Tuân thủ ngăn không cho các đối tượng bị xóa trong một số ngày nhất định. Xem [bản sao ngoài trang web](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Off-site-Copy.md). ### Kiểm tra mã nguồn Kiểm tra xem chương trình đã cài đặt có khớp với phiên bản đã phát hành hay không. 1. Nhập tên kho lưu trữ GitHub (kho chính thức đã được điền sẵn) và một thẻ, nhánh hoặc bản cam kết. 2. **Check now** truy vấn API của GitHub, thông qua đường dẫn dành cho các yêu cầu từ bên ngoài của không gian làm việc này, để lấy danh sách tệp của commit đó. Nó so sánh ID blob git của mỗi tệp chương trình được đo lường với commit. Một bản checkout trên Windows với các ký tự kết thúc dòng đã được chuyển đổi vẫn khớp. 3. Kết quả liệt kê các tệp đã thay đổi, thêm mới và thiếu (tối đa 50 tệp cho mỗi loại) và được lưu dưới dạng một `source.checked` bản ghi nhật ký. Kết quả chỉ được coi là cập nhật khi các tệp chương trình đang chạy không thay đổi: hãy kiểm tra lại sau khi cập nhật. Không cần mã thông báo và chỉ các kho lưu trữ công khai mới hoạt động; các cuộc trò chuyện và thông tin đăng nhập không được tải lên. Một kết quả khớp xác định mã trên đĩa. Đây không phải là chứng thực phần cứng; để biết thêm về điều này, hãy xem [Phala Cloud](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx). ## Các chế độ bảo vệ Nút chuyển đổi bên cạnh số phiên bản hiển thị chế độ đã chọn và số lượng trong số 18 lớp bảo vệ đang hoạt động, ví dụ `🟠 Witnessed 9/18`. **Để thay đổi chế độ** trong **“Extras → Protection level”** sẽ mở ra menu lựa chọn. Mỗi chế độ mô tả một mục tiêu cụ thể và liệt kê những gì vẫn còn thiếu; quá trình ghi lại, ký xác thực và cài đặt đã lưu đều giống nhau ở mọi chế độ. | Chế độ | Dành cho | Thêm | | --- | --- | --- | | 🟢 Dễ dàng | Theo dõi một cuộc trò chuyện và lưu giữ bản sao | Các cuộc trò chuyện, nhật ký và bản xuất cuộc trò chuyện; quá trình ký diễn ra ở chế độ nền | | 🟡 Đã ký | Báo cáo lên nền tảng, máy chủ hoặc bộ phận xử lý vi phạm | Tập tin lưu trữ đã ký, kiểm tra nhật ký, điểm kiểm tra, bản trích xuất bàn giao | | 🟠 Đã được chứng thực | Các trường hợp mà ai đó có thể khẳng định bản ghi đã bị thay đổi | Một nhân chứng độc lập đăng các tiêu đề nhật ký đã được ký | | 🔴 Sẵn sàng cho phiên tòa | Bằng chứng dành cho luật sư, cảnh sát hoặc tòa án | Dấu thời gian, bản sao được mã hóa lưu trữ ngoài hệ thống, chi tiết vụ việc trong các báo cáo | | 🟣 Được xác minh bởi GitHub | Các bản ghi mà bất kỳ ai cũng phải có thể kiểm tra phần mềm của chúng | Kiểm tra mã nguồn và ghi lại các hành động trên GitHub | | ⚫ Tối đa | Các vụ án có mức độ rủi ro cao chống lại một đối thủ có nguồn lực dồi dào | Một máy chủ được bảo mật 24/7, địa chỉ IP ẩn, tất cả 18 lớp bảo mật | Các lớp: mọi bản ghi đều được ký và liên kết; biên nhận chạy đã ký; tệp đính kèm được lưu với SHA-256; các điểm kiểm tra đã ký; kiểm tra lại; cảnh báo sự cố; quyền truy cập chứng nhân chỉ đọc; một chứng nhân kiểm tra theo lịch trình; dấu thời gian RFC 3161; bằng chứng OpenTimestamps; một dấu thời gian mới nhất đã được xác minh; một bản sao được mã hóa tại vị trí ngoài; chi tiết vụ việc trong báo cáo; kiểm tra mã khớp; Telegram không bao giờ nhìn thấy địa chỉ IP của máy này; các yêu cầu từ bên ngoài thông qua proxy; Khóa đối tượng trên bản sao; một máy chủ được niêm phong chứa các bản ghi của nhà cung cấp. Một lớp đang tắt có tùy chọn **“Set up**”, mở biểu mẫu của nó. Chọn chế độ thấp hơn sẽ yêu cầu xác nhận và không xóa bất cứ thứ gì. ## Các công cụ khác **Tính năng bổ sung → Ghi lại độc lập**: kết nối một trình duyệt riêng biệt hoặc thiết bị ghi AyuGram, ghim khóa ký của thiết bị đó, chọn các tùy chọn ghi lại, bắt đầu/tạm dừng, chụp ảnh màn hình và tải xuống các tệp lưu trữ đã được xác minh và ký. Mỗi thiết bị ghi có thông tin đăng nhập, lộ trình, nhật ký và khóa riêng. Cả hai kết nối đều bị tắt theo mặc định. Xem [Hướng dẫn ghi lại độc lập](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md) bằng tiếng Anh. - **Tra cứu kho lưu trữ**: tìm kiếm các quan sát đã lưu, xem lại các nguồn, sau đó quyết định liệu có nên gửi chúng đến mô hình AI hay không. Xem [phân tích kho lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/analysis/) và [chức năng OCR và phiên âm cục bộ](https://phishdestroy.io/tgwitness/vi/docs/reference/media-analysis/). - **Các tham số**: giới hạn và tốc độ thu thập, kiểm tra lại, tải xuống, hồ sơ, thông báo và xuất dữ liệu. Tìm kiếm theo tên, hiển thị các giá trị **Chỉ các thông số đã thay đổi** và chuẩn bị các giá trị mặc định dưới dạng bản nháp bằng **Khôi phục mặc định…**. **Lưu các tham số** áp dụng các giá trị từ lần sử dụng tiếp theo, và mỗi thay đổi đều được ghi lại dưới dạng bản ghi nhật ký. - **Quyền truy cập**: các mã thông báo riêng biệt dành cho người đánh giá, nhà phân tích và người vận hành, giới hạn trong các không gian làm việc, cuộc trò chuyện và quyền hạn đã chọn. Xem [phần quyền truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/access/). - **Nhật ký hệ thống** : các hoạt động mà quá trình này đã thực hiện kể từ khi bắt đầu (kết nối, thay đổi proxy, đăng nhập, từ chối, thay đổi cài đặt) với địa chỉ IP được ẩn. Tính năng **“Theo dõi dòng mới”** giúp luôn hiển thị dòng mới nhất. Các tin nhắn chỉ được lưu trong nhật ký. - **Tích hợp**: nhà cung cấp AI, kết nối [MCP chỉ đọc](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/) và [webhook đã ký](https://phishdestroy.io/tgwitness/vi/docs/reference/webhooks/). - **Case Board**: ghi chú riêng tư của nhóm, dấu trang và các đoạn trích bên cạnh bằng chứng. Xem [Case Board](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/). - **Tài liệu**: ngăn chế [độ điều tra](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md). Trong khi một phiên làm việc được ghi lại đang diễn ra, nó sẽ được chuyển sang thanh bên chính. - **GitHub Actions ghi lại** trong mục Xuất: một cuộc trò chuyện được ghi lại từ bản fork của bạn. Xem [bản ghi được niêm phong](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). --- # Telegram · Cách thức thu thập dữ liệu Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/collection/ Phạm vi quan sát, cập nhật trực tiếp, kiểm tra lại, tệp đính kèm, các hành động của người dùng và ý nghĩa của “khoảng trống”, được ghi lại theo từng bản ghi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Translation coverage: this edition includes material from the English original. Phạm vi quan sát, cập nhật trực tiếp, kiểm tra lại, tệp đính kèm, các hành động của người dùng và ý nghĩa của “khoảng trống”, được ghi lại theo từng bản ghi. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bộ sưu tập](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![Bộ sưu tập](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) TgWitness ghi lại những gì một tài khoản Telegram được kết nối quan sát được. Giám sát trực tiếp lưu giữ tin nhắn, các chỉnh sửa được ghi lại, thông báo xóa và tệp đính kèm cùng với thời gian quan sát và bối cảnh nguồn của chúng. Các lần đọc lịch sử, kiểm tra lại và các bản ghi nhật ký quản trị có sẵn sẽ bổ sung các quan sát được xác định riêng biệt vào bản ghi đó. **Trên trang này** - [Từ đăng nhập đến nhật ký](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#from-login-to-a-journal) - [Phạm vi quan sát: các cuộc trò chuyện được chọn, một thư mục hoặc toàn bộ tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account) - [Phạm vi và lựa chọn sự kiện](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#scope-and-event-selection) - [Các hành động riêng](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#own-actions) - [Chế độ điều tra: tham gia các nhóm và trò chuyện với bot](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots) - [Các cấp độ kiểm tra lại](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#recheck-tiers) - [Lịch sử tin nhắn và nguồn gốc](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#message-history-and-attribution) - [Ảnh chụp lịch sử](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#history-snapshots) - [Xử lý tệp đính kèm](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#attachment-handling) - [Tạm dừng, khóa, ngắt kết nối và khởi động lại](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#pause-lock-disconnect-and-restart) - [Cách ly và xác minh tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#account-isolation-and-verification) ## Từ quá trình đăng nhập đến sổ ghi chép Đối với ảnh và tệp tự hủy, xem [Tệp đa phương tiện tự hủy](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md). Phần này giải thích về công việc ưu tiên, các kết quả đã lưu và không khả dụng, cũng như các giới hạn của tính năng chặn xác nhận đã đọc trong trình thu thập API. Sơ đồ quy trình · Xác thực tài khoản người dùng → Chọn các nhóm và kênh có thể truy cập; Chọn các nhóm và kênh có thể truy cập → Lưu cài đặt sự kiện và tệp đính kèm; Lưu cài đặt sự kiện và tệp đính kèm → Bắt đầu quan sát; Bắt đầu quan sát → Nhận thông tin cập nhật từ ứng dụng khách đang hoạt động; Nhận thông tin cập nhật từ ứng dụng khách đang hoạt động → Áp dụng chính sách về nguồn và sự kiện; Áp dụng chính sách về nguồn và sự kiện → Thêm một ghi chú có chữ ký; Thêm một ghi chú có chữ ký → Xem lại hoặc xuất sổ nhật ký; Thêm một ghi chú có chữ ký → Xử lý mọi tệp đính kèm đang chờ xử lý; Xử lý mọi tệp đính kèm đang chờ xử lý → Thêm kết quả tải xuống · Xác thực tài khoảnngười dùng · Chọn các nhóm và kênhcó thể truy cập · Lưu cài đặt sự kiện vàtệp đính kèm · Bắt đầu quan sát · Nhận thông tin cậpnhật từ ứng dụng kháchđang hoạt động · Áp dụng chính sách vềnguồn và sự kiện · Thêm một ghi chú cóchữ ký · Xem lại hoặc xuất sổnhật ký · Xử lý mọi tệp đính kèmđang chờ xử lý · Thêm kết quả tải xuống **Sơ đồ dưới dạng văn bản** 1. Xác thực tài khoản người dùng → Chọn các nhóm và kênh có thể truy cập 2. Chọn các nhóm và kênh có thể truy cập → Lưu cài đặt sự kiện và tệp đính kèm 3. Lưu cài đặt sự kiện và tệp đính kèm → Bắt đầu quan sát 4. Bắt đầu quan sát → Nhận thông tin cập nhật từ ứng dụng khách đang hoạt động 5. Nhận thông tin cập nhật từ ứng dụng khách đang hoạt động → Áp dụng chính sách về nguồn và sự kiện 6. Áp dụng chính sách về nguồn và sự kiện → Thêm một ghi chú có chữ ký 7. Thêm một ghi chú có chữ ký → Xem lại hoặc xuất sổ nhật ký 8. Thêm một ghi chú có chữ ký → Xử lý mọi tệp đính kèm đang chờ xử lý 9. Xử lý mọi tệp đính kèm đang chờ xử lý → Thêm kết quả tải xuống Ủy quyền, quyền truy cập vào nguồn, bộ thu thập đang hoạt động và việc chuyển giao hoàn chỉnh là những vấn đề khác nhau. Việc đăng nhập thành công không đồng nghĩa với việc được cấp quyền truy cập vào mọi nhóm. Việc chuyển giao được theo dõi riêng biệt: các bản ghi phạm vi phủ sóng, khôi phục khoảng trống cập nhật và kiểm tra lại cho thấy những gì đã được chuyển đến. ## Phạm vi giám sát: các cuộc trò chuyện được chọn, một thư mục hoặc toàn bộ tài khoản **Các công cụ khác → Nguồn → Phạm vi** quyết định các cuộc trò chuyện mà không gian làm việc sẽ ghi lại. Quá trình thiết lập mới bắt đầu từ mục **Chọn các cuộc trò chuyện**. Các lựa chọn đã lưu trước đó sẽ được giữ nguyên. Khi chọn **Tất cả các cuộc trò chuyện** trong trình hướng dẫn thiết lập, hệ thống sẽ yêu cầu xác nhận nếu danh sách được tải lên chứa hơn 50 cuộc trò chuyện; việc ước tính dung lượng vẫn là một thao tác riêng biệt, dựa trên mẫu. | Chế độ | Ghi lại | Các cuộc trò chuyện mới | | --- | --- | --- | | Các cuộc trò chuyện được chọn (mặc định) | Chỉ các cuộc trò chuyện mà quý vị thêm vào thủ công | Không bao giờ được thêm tự động | | Thư mục Telegram | Các cuộc trò chuyện trong một trong các thư mục của tài khoản: bao gồm các cuộc trò chuyện được liệt kê theo tên, cộng với các danh mục của thư mục (liên hệ, không phải liên hệ, nhóm, kênh, bot), trừ đi các cuộc trò chuyện bị loại trừ và, nếu thư mục có ghi rõ, các cuộc trò chuyện đã được lưu trữ | Các cuộc trò chuyện phù hợp sẽ được thêm vào ngay khi chúng trở nên hoạt động; các cuộc trò chuyện mà quý vị thêm vào thư mục trong Telegram sẽ được hệ thống thu thập trong vòng một giờ | | Toàn bộ tài khoản | Mọi cuộc trò chuyện mà tài khoản này tiếp nhận | Mọi cuộc trò chuyện, nhóm, cuộc trò chuyện riêng tư hoặc bot mới đều được thêm vào ngay khi có bản cập nhật đầu tiên | - **Các loại nguồn** (kênh, nhóm, cuộc trò chuyện riêng tư, bot) giới hạn chế độ thư mục và chế độ toàn tài khoản. Các cuộc trò chuyện được chọn có thể thuộc bất kỳ loại nào, bao gồm cả cuộc trò chuyện riêng tư và bot; các loại nguồn không bao giờ ngăn chặn một cuộc trò chuyện mà bạn đã thêm thủ công. Việc tắt một loại, thêm ngoại lệ hoặc chuyển sang chế độ “cuộc trò chuyện đã chọn” sẽ ngừng các nguồn được thêm tự động ngay khi được lưu, trước khi danh sách nguồn được tính toán lại và cả khi không thể kết nối với Telegram: các tin nhắn mới, lịch sử đã qua, lịch sử cuộc trò chuyện mới, cài đặt đồng đẳng và thông tin hồ sơ của họ. - **Các cuộc trò chuyện mà bạn thêm thủ công** sẽ vẫn được ghi lại trong chế độ thư mục và chế độ toàn tài khoản ngay cả khi chúng nằm ngoài thư mục; chỉ có *các thao tác Loại trừ*, *Xóa* hoặc tạm dừng mới có thể ngừng việc ghi lại này. Các cuộc trò chuyện được thêm theo phạm vi (*tự động*) sẽ tuân theo thư mục: cuộc trò chuyện nào rời khỏi thư mục sẽ bị tạm dừng tại lần tính toán lại tiếp theo. - **Các cuộc trò chuyện bị loại trừ** sẽ không bao giờ được ghi lại, ở bất kỳ chế độ nào. Trong chế độ theo thư mục và toàn tài khoản, khi bạn chọn *Loại trừ* hoặc *Xóa* trên một nguồn, cuộc trò chuyện đó sẽ được thêm vào danh sách này, do đó phạm vi ghi sẽ không thêm nó vào lần nữa. Việc chọn lại cuộc trò chuyện bằng tay (trong phần Nguồn, từ mục Cuộc trò chuyện hoặc trong Cài đặt → **Chọn cuộc trò chuyện nào?**) sẽ loại bỏ nó khỏi danh sách. Danh sách này có thể chứa tối đa 5.000 cuộc trò chuyện; nếu vượt quá số lượng này, *thao tác Xóa* sẽ bị từ chối và thay vào đó, bạn có thể tạm dừng cuộc trò chuyện đó. - **Các hành động của chính tài khoản** (mặc định là bật): các tin nhắn mà tài khoản này gửi đi, các thao tác chỉnh sửa và các lần nhấn phím trên bàn phím trả lời. Khi tắt tính năng này, các tin nhắn gửi đi và các thao tác chỉnh sửa sẽ bị bỏ qua. - Việc chuyển sang một thư mục hoặc toàn bộ tài khoản sẽ yêu cầu xác nhận: các chế độ này ghi lại các cuộc trò chuyện riêng tư và tin nhắn của bên thứ ba, và chỉ nên được sử dụng trên một tài khoản chuyên dụng. Việc xác nhận và mọi thay đổi phạm vi đều được ghi lại dưới dạng các bản ghi `scope.changed`. Trên một tài khoản được thiết lập làm tài khoản chính của bạn, biểu mẫu phạm vi và tính năng Điều tra sẽ từ chối cho phép truy cập vào một thư mục hoặc toàn bộ tài khoản, giống như khi bắt đầu; chỉ có thể sử dụng chúng thông qua một lần sao chép duy nhất mà không ghi lại. - Các cuộc trò chuyện được phạm vi thêm vào sẽ xuất hiện dưới dạng các nguồn được đánh dấu là *auto*, được ghi lại dưới dạng `scope.applied` (khi bắt đầu và mỗi giờ) hoặc `source.discovered` (một cuộc trò chuyện mới trong quá trình quan sát). Việc chuyển trở lại các cuộc trò chuyện đã chọn sẽ tạm dừng tất cả các nguồn được thêm tự động cùng lúc, mà không cần đọc lại danh sách cuộc trò chuyện của tài khoản. Một cuộc trò chuyện bị loại trừ sẽ ngừng được ghi lại ngay khi phạm vi được lưu, và nguồn của nó sẽ bị tạm dừng ngay cả khi Telegram không trả về danh sách cuộc trò chuyện. Trong khi quan sát, việc lưu phạm vi sẽ áp dụng lại phạm vi đó, ngay cả khi các giá trị không thay đổi. Phạm vi của các chế độ này: - **Tính năng Trò chuyện bí mật** sử dụng [tích hợp Pseudo-secret](https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/) đi kèm, với mô-đun giao thức được cài đặt từ bảng điều khiển và công tắc kích hoạt cho từng tài khoản. Lịch sử trên đám mây và Takeout sử dụng một đường dẫn thu thập dữ liệu riêng biệt. - **Các khoảng thời gian ngoại tuyến.** Sau khi khởi động lại, TgWitness sẽ tiếp tục từ vị trí cập nhật đã lưu, yêu cầu Telegram cung cấp các bản cập nhật bị bỏ lỡ và kiểm tra lại các cuộc trò chuyện. Telegram duy trì một danh sách công việc tồn đọng có giới hạn, do đó sau một thời gian ngừng hoạt động dài, các báo cáo và `verify.py` sẽ liệt kê khoảng thời gian còn lại dưới dạng một khoảng trống (xem [phạm vi bao phủ](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)). - Chỉ có 1,000 cuộc trò chuyện đầu tiên được liệt kê khi bắt đầu (giới hạn này nằm trong **mục Công cụ khác → Tham số**); các cuộc trò chuyện cũ hơn sẽ được thêm vào khi chúng hoạt động trở lại. Lịch sử trước đó của một cuộc trò chuyện đã thêm sẽ không được lấy về — hãy tạo một bản chụp lịch sử hoặc xuất toàn bộ cuộc trò chuyện khi bạn cần. - Các điều kiện của thư mục thay đổi liên tục (bị tắt tiếng, đã đọc) sẽ không được áp dụng: các cuộc trò chuyện đó vẫn tiếp tục được theo dõi. - **Các nút bot nhúng (callback)** được nhấn trong một ứng dụng khác sẽ không hiển thị trong phiên làm việc thứ hai; phản hồi hoặc thao tác chỉnh sửa của bot sẽ được ghi lại. Các thao tác nhấn phím trên bàn phím để trả lời sẽ được gửi dưới dạng tin nhắn đi và được gắn nhãn `button_press`. - Càng nhiều cuộc trò chuyện đồng nghĩa với việc càng có nhiều yêu cầu. Telegram sẽ hạn chế các tài khoản có khối lượng tin nhắn mà nền tảng này coi là quá mức, đây chính là một lý do nữa để sử dụng các tài khoản chuyên dụng. ### Các cuộc trò chuyện được chọn lọc kỹ lưỡng **Nghiêm ngặt: Chỉ các cuộc trò chuyện đã chọn mới** xuất hiện trong **phần Cuộc trò chuyện đã chọn** và tùy chọn này bị tắt theo mặc định. Tùy chọn này dành cho quyền truy cập chỉ áp dụng cho các cuộc trò chuyện đã chọn. Khi tùy chọn này được bật: - Các thông báo dịch vụ của Telegram (777000) không được đọc: không được đọc khi bắt đầu hoặc kết thúc quá trình quan sát, cũng như không được đọc mỗi phút trong quá trình quan sát. Không có bản ghi nào thuộc loại ``session.security_baseline`` hoặc ``account.security_event`` được ghi lại. - Danh sách phiên của tài khoản không được đọc: không được đọc khi bắt đầu hoặc kết thúc quá trình quan sát (câu hỏi trên bảng điều khiển về các phiên khác liên quan đến **Bằng chứng cho một vụ án** và các chế độ bảo vệ bằng chứng cũng bị bỏ qua), không được đọc cứ sau hai phút trong quá trình quan sát, không được đọc khi kết nối được thiết lập, và cũng không được đọc bởi quá trình kiểm tra kết nối — trong đó *mục*được hiển thị là đã bỏ qua. Trạng thái xác minh hai bước được sử dụng bởi quá trình kiểm tra tiếp quản cũng không được đọc. Do đó, các trường `account.sessions`, `session.concurrent_at_start` và `session.takeover_risk` không được ghi, và một phiên kết thúc từ thiết bị khác không được báo cáo dưới dạng `session_revoked_externally`. - Mặc dù đây là phiên duy nhất của tài khoản (**Đặt đây là phiên duy nhất** hoặc phiên tự động), danh sách phiên vẫn được đọc mỗi hai phút trong quá trình theo dõi và khi có kết nối được thiết lập, do đó giá trị ``session.exclusive_ended`` sẽ được ghi lại khi có phiên khác xuất hiện. 777000 vẫn chưa được đọc trong khoảng thời gian đó, mặc dù bản ghi ``session.exclusive_from`` cho thấy các thông báo đăng nhập của Telegram vẫn tiếp tục được ghi lại. - Các thông báo xóa chỉ được so sánh với kiểm tra phiên làm việc nếu có một phiên được thực hiện trong 10 phút qua (khi đây là phiên duy nhất, hoặc sau khi mở **các phiên làm việc của tài khoản này**). Nếu không, trừ khi lần kiểm tra quyền gần nhất cho thấy tài khoản này không thể xóa tin nhắn (điều này không bao giờ xảy ra trong các cuộc trò chuyện riêng tư và nhóm thông thường), thông báo sẽ hiển thị: *Không rõ ai đã xóa tin nhắn này: chính tài khoản này, từ một phiên làm việc hoặc thiết bị khác, cũng có thể đã xóa nó.* - Với khóa phiên đã được nhập vào, không có thông tin nào trong nhật ký cho biết thời gian phiên này đăng nhập cho đến khi danh sách phiên được đọc (ví dụ: trong phần **Các phiên của tài khoản này**). Cho đến lúc đó, các bản xuất tin nhắn trò chuyện và các bản xuất tài khoản **tự động** sẽ sử dụng phiên thông thường thay vì Takeout, với lý do là `session_age_unknown`. - Turning a chat on does not read its earlier messages. Without the switch, each chat turned on (in Sources, in Chats, by joining from the panel or in the setup wizard) gets one `baseline` snapshot of its latest messages, up to **More tools → Parameters → Largest history snapshot** (500 by default), when observation next runs. A waiting snapshot that comes due while the switch is on is dropped. A chat joined from the panel does not get its latest messages read as a new chat either (the **When a new chat or bot appears** count, 100 by default), and opening a chosen chat with no saved messages in Chats does not load its last 100 messages by itself. **Load history** and snapshots you start yourself still read history. - Cài đặt nội dung nhạy cảm của tài khoản sẽ không bị đọc hay thay đổi. Nếu không bật công tắc này, mỗi lần đăng nhập và mỗi lần kết nối mới sẽ kích hoạt cài đặt này khi nó đang tắt, và Telegram cho phép thay đổi (`account.content_settings`); cài đặt này thuộc về tài khoản và được áp dụng trên mọi ứng dụng Telegram. Nội dung mà Telegram đánh dấu là nhạy cảm có thể vẫn bị ẩn. - Các cập nhật từ cuộc gọi điện thoại không được ghi lại dưới dạng ``account.phone_call``. - Việc dừng quan sát chỉ ghi lại dấu vân tay của khóa phiên; nó không đọc danh sách phiên hay 777000. Tính năng này không giới hạn những gì Telegram gửi: các cập nhật của mọi cuộc trò chuyện vẫn được chuyển đến phiên làm việc này, và chỉ những cuộc trò chuyện đã chọn mới được ghi lại. Danh sách cuộc trò chuyện của tài khoản (bao gồm **các cuộc trò chuyện đã đọc trong danh sách tài khoản**) và các thư mục của nó vẫn được đọc khi bắt đầu, và một lần nữa khi phạm vi được lưu lại trong quá trình theo dõi, nhằm tìm ra các cuộc trò chuyện đã chọn. Các thông báo xóa không kèm theo cuộc trò chuyện (`deletion.unscoped`) vẫn được ghi lại: chúng chỉ chứa ID tin nhắn và có thể thuộc về một cuộc trò chuyện riêng tư đã chọn hoặc một nhóm thông thường. Kiểm tra tài khoản bị đóng băng (`help.getAppConfig`), các kiểm tra kết nối khác và các tính năng bạn tự bật (tự động kết thúc các phiên khác, kiểm tra nhân chứng, cuộc trò chuyện bí mật giả, **Các phiên của tài khoản này** và danh sách thiết bị đã đăng nhập của Telegram trong **mục Thêm nhân chứng**, tính năng này đọc danh sách phiên tại mỗi lần qua dấu thời gian và thiết lập các mốc thời gian cho các mục tiêu **Theo dõi các cuộc trò chuyện** và **Bằng chứng cho một vụ việc**) vẫn tiếp tục hoạt động. Hãy bật tính năng này trước khi đăng nhập; nếu không, chính quá trình đăng nhập sẽ kiểm tra quyền truy cập hiện tại và kích hoạt nội dung nhạy cảm. Mỗi thay đổi là một bản ghi `scope.changed` đã được ký, và `observation.started` chứa giá trị này dưới dạng `scope.strict`. Việc chuyển sang một thư mục hoặc toàn bộ tài khoản sẽ tắt tính năng này. ## Phạm vi và việc lựa chọn sự kiện Mỗi không gian làm việc có các nguồn riêng. TgWitness không tham gia nhóm, chấp nhận lời mời hoặc liệt kê tự động mọi thành viên. Các nguồn phải đã có sẵn cho tài khoản. Khi khởi động, bộ thu thập kiểm tra các nguồn đã chọn so với các cuộc trò chuyện hiển thị của tài khoản; 1,000 cuộc trò chuyện đầu tiên sẽ được kiểm tra trừ khi **cài đặt trong Công cụ khác → Thông số → Cuộc trò chuyện được đọc từ danh sách tài khoản** quy định khác. Một nguồn vắng mặt sẽ được đánh dấu là **chưa xác nhận quyền truy cập**, chứ không được coi là đã xóa bạn. | Bối cảnh | Thu thập | Tác động khi bị vô hiệu hóa | | --- | --- | --- | | Tin nhắn mới | Các tin nhắn đã được gửi đi thông thường | Các thao tác chỉnh sửa/xóa sau này có thể không có văn bản đã được ghi lại trước đó để so sánh. | | Các chỉnh sửa | Cung cấp các phiên bản tin nhắn đã được chỉnh sửa | Các thay đổi ở giai đoạn trung gian sẽ không được tái tạo lại sau này. | | Các hành động xóa | Thông báo xóa có phạm vi cụ thể và thông báo cấp tài khoản không có phạm vi cụ thể | Các thông báo xóa tin nhắn sẽ không được thêm vào sổ ghi chép. | | Phản hồi | Các bản chụp nhanh phản ứng đã được cung cấp | Các bản cập nhật phản hồi riêng lẻ sẽ không được bổ sung. | | Thành viên | Đã gửi các thông báo về dịch vụ thành viên và thông tin cập nhật cho người tham gia | Các quan sát liên quan đến tư cách thành viên không được bổ sung vào đây. | Các cài đặt này áp dụng cho tất cả các nguồn đã chọn trong không gian làm việc. Vui lòng lưu biểu mẫu để áp dụng các thay đổi; các thay đổi sẽ được ghi lại kèm theo các giá trị trước và sau đã được ký xác thực. Việc vô hiệu hóa một danh mục sẽ không xóa các bản ghi trước đó. Việc kích hoạt lại danh mục này sẽ không khôi phục các bản cập nhật đã bỏ lỡ. Các bản ghi hoạt động và các sự kiện dịch vụ nhóm khác vẫn được tách biệt với các tùy chọn này. Các tin nhắn dịch vụ thành viên có thể tạo bản ghi tin nhắn khi tính năng thành viên được kích hoạt, ngay cả khi tính năng ghi lại tin nhắn mới thông thường bị tắt. Các đối tượng Telegram được ghi lại vẫn giữ nguyên siêu dữ liệu nhúng; một tùy chọn không phải là quy tắc che giấu thông tin. **Các thao tác xóa trong cuộc trò chuyện riêng tư và nhóm thông thường** được gửi dưới dạng ID tin nhắn mà không kèm theo cuộc trò chuyện. Các cuộc trò chuyện này chia sẻ một chuỗi ID tin nhắn chung cho toàn tài khoản, do đó khi một tin nhắn có ID đó đã được lưu trước đó, cuộc trò chuyện của nó sẽ được xác định: thao tác xóa được ghi lại trong cuộc trò chuyện đó kèm theo tham số `chat_resolution` giải thích cách thức. Các ID chưa từng được lưu sẽ là thao tác **xóa không xác định phạm vi** với một cuộc trò chuyện chưa được xác định rõ ràng. Đây là các thông báo xóa của Telegram, được lưu giữ ngay cả khi cuộc trò chuyện liên quan chưa thể được xác định. Cấu trúc của thông báo chứa các ID; nhật ký bổ sung thời gian nhận và bất kỳ bối cảnh tin nhắn đã lưu nào, bao gồm `deleted_message_was_outgoing`. Các mục nhật ký quản trị có sẵn cung cấp một nguồn riêng biệt về hành động, người thực hiện và thời gian nguồn. ## Các hành động của chính mình Các tin nhắn được gửi từ tài khoản đang được theo dõi sẽ được gắn nhãn `outgoing`. Việc chỉnh sửa một tin nhắn gửi đi ghi chú rằng trong các cuộc trò chuyện riêng tư và nhóm, chỉ tác giả của tin nhắn đó mới có thể chỉnh sửa, trong khi các bài đăng trên kênh có thể được chỉnh sửa bởi các quản trị viên khác. Khi một tin nhắn gửi đi lặp lại nội dung của một nút từ bàn phím trả lời được lưu gần đây nhất trong cuộc trò chuyện đó, tin nhắn này sẽ mang mã `button_press` kèm theo liên kết đến bản ghi của bàn phím đó. Việc loại trừ các hành động do chính người dùng thực hiện cũng áp dụng cho việc kiểm tra lại nền và lịch sử cuộc trò chuyện mới tự động. Các tin nhắn gửi đi bị bỏ qua sẽ làm dịch chuyển vị trí kiểm tra lại, do đó chúng không thể chặn các tin nhắn đến sau đó. Các thao tác rõ ràng trên bảng điều khiển và các bản chụp lịch sử được yêu cầu thủ công vẫn được ghi lại. ## Chế độ điều tra: tham gia các nhóm và trao đổi với các bot **Các công cụ khác → Nguồn → Phạm vi → Chế độ điều tra** chuẩn bị phạm vi cho một tài khoản chuyên dụng tham gia các cuộc trò chuyện nhóm, khởi chạy bot và gửi tin nhắn đến chúng: toàn bộ tài khoản, mọi loại nguồn, các hành động của chính tài khoản, và đối với mỗi cuộc trò chuyện hoặc bot xuất hiện, hồ sơ của nó cùng 200 tin nhắn hiển thị gần nhất. Kiểm tra biểu mẫu và nhấn **Lưu phạm vi**; việc chuyển sang toàn bộ tài khoản sẽ yêu cầu xác nhận thông thường. - **Các nút.** Các nút nằm dưới một tin nhắn sẽ được giữ nguyên cùng với tin nhắn đó và hiển thị trong **phần Trò chuyện**: các liên kết, ứng dụng web , liên kết đăng nhập, văn bản cần sao chép, dữ liệu gọi lại, truy vấn nội tuyến, yêu cầu cung cấp số điện thoại hoặc vị trí. Các liên kết được hiển thị dưới dạng văn bản và không bao giờ được bảng điều khiển mở ra. Khi một bot chỉ thay đổi các nút (ví dụ: một liên kết thanh toán mới), đó được coi là một phiên bản mới của tin nhắn, áp dụng cho cả các bản cập nhật trực tiếp lẫn các lần kiểm tra lại. - **Các cuộc trò chuyện và bot mới.** Ở chế độ theo thư mục và toàn bộ tài khoản, **khi một cuộc trò chuyện hoặc bot mới xuất hiện**, hệ thống sẽ lưu lại ngay lập tức sau khi nó xuất hiện: - hồ sơ của nó dưới dạng bản ghi `source.profile`: mô tả bot và các lệnh, phần giới thiệu về người dùng, nhóm hoặc kênh, danh sách thành viên, liên kết cuộc trò chuyện và liên kết mời khi Telegram cung cấp liên kết đó; - các tin nhắn hiển thị gần đây nhất (tối đa 1.000 tin nhắn) dưới dạng bản chụp lịch sử được đánh dấu là `new_chat`: các tin nhắn trước đó trong một cuộc trò chuyện nhóm vừa tham gia, hoặc những gì bot đã nói trước khi hệ thống giám sát phát hiện ra cuộc trò chuyện đó. Các tin nhắn đã được lưu trữ trực tiếp sẽ không được lặp lại. Các cuộc trò chuyện vừa được chọn sẽ sử dụng các cài đặt này khi phạm vi được áp dụng, bao gồm cả các cuộc trò chuyện đã có sẵn trong danh sách hội thoại của tài khoản. Quá trình tải hồ sơ và lịch sử ban đầu diễn ra đồng thời cho tối đa ba cuộc trò chuyện; các tác vụ liên quan đến cùng một cuộc trò chuyện vẫn được thực hiện theo thứ tự. Mỗi giai đoạn xử lý lịch sử/hồ sơ sử dụng thời gian chờ hoạt động đã được cấu hình, do đó các yêu cầu bị đình trệ sẽ giải phóng công nhân của chúng. Lịch sử được lưu trước khi đọc hồ sơ (tùy chọn); việc đọc hồ sơ thất bại không ngăn cản việc ghi lại lịch sử đó. Các giai đoạn thất bại sẽ thử lại sau 5 giây, thời gian chờ tăng gấp đôi lên tối đa 5 phút mà không chiếm dụng nhân viên xử lý trong thời gian trì hoãn. ID đang chờ xử lý, thời hạn thử lại và các giai đoạn đã hoàn thành được lưu trữ cục bộ. Khi khởi động lại, hệ thống chỉ tiếp tục các giai đoạn chưa hoàn thành; việc thử lại hồ sơ không lặp lại quá trình đọc lịch sử đã hoàn tất. Các nguồn bị vô hiệu hóa trước khi đến lượt sẽ bị bỏ qua. Bảng tổng quan hiển thị các cuộc trò chuyện đang hoạt động, đang chờ xử lý và đang thử lại riêng biệt với việc tải xuống tệp đính kèm. FloodWait tạm dừng công việc này và nó sẽ tiếp tục sau đó; các lỗi được ghi lại và việc ghi lại trực tiếp cuộc trò chuyện vẫn tiếp tục. Điều này bao gồm thời gian chờ trong khi xác định danh tính của cuộc trò chuyện mới: tác vụ hồ sơ/lịch sử đang chờ xử lý được giữ lại để thử lại, và thời gian chờ dài hơn hiện có trên toàn tài khoản sẽ không bị rút ngắn. Các công nhân chia sẻ thời gian chờ này; tính đồng thời không vượt qua giới hạn yêu cầu của Telegram. - **Hồ sơ theo yêu cầu.** **Trò chuyện → Hồ sơ → Lưu hồ sơ hiện** lưu hồ sơ hiện tại của bất kỳ nguồn nào; hồ sơ mới nhất được hiển thị phía trên các tin nhắn. - **Ảnh chụp nhanh trạng thái cuộc trò chuyện (bản xem trước).** Trạng thái bên ngoài luồng tin nhắn thay đổi mà không cần tin nhắn: việc gỡ ghim mọi tin nhắn không để lại dấu vết ở cấp độ tin nhắn, một quản trị viên mất quyền, một món quà bị ẩn, chuyển đổi, nâng cấp hoặc hoàn tiền. Trong quá trình quan sát, mọi nguồn được kích hoạt đều được đọc định kỳ và lưu dưới dạng bản ghi có chữ ký `chat.state` : tiêu đề, tên người dùng, mô tả, số lượng thành viên và quản trị viên, cuộc trò chuyện được liên kết, chế độ chậm, ID tin nhắn được ghim (tối đa 100), quản trị viên cùng quyền hạn và chức danh của họ, cũng như quà tặng hiển thị trên các kênh và hồ sơ người dùng (tối đa 100). Mỗi bản ghi liệt kê các điểm khác biệt so với bản chụp nhanh trước đó: các trường đã thay đổi kèm theo giá trị trước và sau, tin nhắn được ghim được thêm hoặc xóa, quản trị viên và quà tặng được thêm, thay đổi hoặc không còn được liệt kê. - Phần mà Telegram từ chối cung cấp (ví dụ: danh sách quản trị viên của một kênh đối với một thành viên không phải là quản trị viên) sẽ được nêu tên trong `errors`; giá trị trước đó của nó được giữ lại và liệt kê trong `carried_forward`, không bao giờ được báo cáo là đã bị xóa. - Một bản ghi mà những thay đổi duy nhất là số lượng, và một kiểm tra không phát hiện thay đổi nào, sẽ tham chiếu đến trạng thái đầy đủ cuối cùng với `state_seq` và tích lũy `state_overrides`. Một trạng thái đầy đủ được ghi lại ít nhất mỗi bảy ngày và bất cứ khi nào có thay đổi nào khác ngoài số lượng. - `parts_complete` đánh dấu các danh sách có giới hạn. Việc thêm vào yêu cầu phải có danh sách trước đó đầy đủ, việc xóa yêu cầu phải có danh sách hiện tại đầy đủ, và các giá trị trống rõ ràng ghi lại việc xóa sạch bản ghi. - **Công cụ khác → Thông số → Trạng thái trò chuyện** thiết lập khoảng thời gian (mặc định là 12 giờ, 0 sẽ tắt tính năng chụp nhanh ), khoảng dừng giữa các nguồn, những phần nào được đọc, và liệu các kiểm tra không phát hiện thay đổi có được ghi lại hay không. `FLOOD_WAIT` và `FLOOD_PREMIUM_WAIT` dừng các yêu cầu chụp nhanh còn lại, giữ nguyên bất kỳ thời hạn toàn tài khoản nào còn hiệu lực, và để cuộc trò chuyện bị gián đoạn đủ điều kiện để thử lại sau khoảng thời gian chờ đó. - **Không hiển thị.** Các nút nhúng (callback) được nhấn trong ứng dụng Telegram khác, cửa sổ bật lên hoặc liên kết mà bot trả lời khi nhấn nút đó, và các liên kết mời được sử dụng trong ứng dụng khác sẽ không đến TgWitness. Những gì bot gửi hoặc chỉnh sửa sau đó sẽ được ghi lại. ### Hành động từ bảng điều khiển **Tính năng Trò chuyện** hiện đã tích hợp một ứng dụng khách thu nhỏ sử dụng tài khoản Telegram của không gian làm việc đã chọn: - Quý vị có thể soạn một tin nhắn dạng văn bản thuần túy hoặc chọn **“Trả lời”** bên dưới một tin nhắn đã lưu. Tin nhắn gửi đi được trả về sẽ được ghi lại ngay cả khi phạm vi ghi lại không bao gồm các cập nhật tin nhắn gửi đi. - Nhấn **nút “Press”** bên dưới nút gọi lại hoặc nút văn bản hiện tại. Máy chủ sẽ lấy lại tin nhắn và từ chối thao tác nếu nội dung trên bàn phím khác với phiên bản đã lưu. Biên nhận gọi lại vẫn giữ nguyên văn bản cửa sổ bật lên, cờ cảnh báo và URL của Telegram; câu trả lời cũng được hiển thị bên dưới cuộc trò chuyện. Các URL vẫn là văn bản có thể chọn và không được mở tự động. - Nhấn **+** → **Mở liên kết Telegram**, nhập `@username`, một liên kết công khai `https://t.me/name`, `https://t.me/+invite` / `joinchat/invite`, hoặc liên kết bot có `?start=parameter`, rồi nhấn **Lưu bản xem trước**. Liên kết gốc và bản xem trước của Telegram sẽ được xác thực trước khi tham gia. **Tham gia / mở và quan sát,** sau đó tham gia nhóm/kênh hoặc mở người dùng/bot, thêm cuộc trò chuyện làm nguồn được kích hoạt, và gửi lệnh `/start` đến bot, bao gồm tham số khởi động của nó. Yêu cầu tham gia đang chờ phê duyệt của quản trị viên sẽ được ghi nhận là “đang chờ xử lý”, không phải là “thành viên”. Bật tùy chọn **Bắt đầu quan sát** để ghi lại các phản hồi đến theo thời gian thực. Các thao tác trên bảng điều khiển vẫn hoạt động khi quá trình quan sát bị tạm dừng; bảng điều khiển sau đó lưu các phản hồi trực tiếp của mình, và chế độ quan sát trực tiếp ghi lại phần còn lại của cuộc trò chuyện. Các nguồn mới được thêm vào sẽ sử dụng cấu hình hồ sơ/lịch sử đã thiết lập khi quá trình quan sát đang chạy. Khi một nguồn bị tạm dừng, hãy kích hoạt nó trong **Công cụ khác → Nguồn** trước khi gửi hoặc nhấn các nút của nó. `interaction.preview`, `interaction.requested` và `interaction.result` là các sự kiện nhật ký có chữ ký thông thường được bao gồm trong các tệp xuất bằng chứng. Các yêu cầu xác định tài khoản, tin nhắn/nút hoặc bản ghi xem trước và liệu quá trình quan sát có đang chạy hay không. Các biên nhận phân biệt giữa thành công, bị từ chối, đang chờ phê duyệt và kết quả không xác định. Một yêu cầu bị gián đoạn có thể đã được gửi đến Telegram: vui lòng kiểm tra cuộc trò chuyện trước khi thực hiện hành động mới. Việc sử dụng lại ID yêu cầu sẽ truy xuất biên nhận đã lưu mà không cần lặp lại thao tác, kể cả sau khi khởi động lại. Bảng điều khiển sẽ giữ lại ID sau khi nhận được phản hồi không rõ ràng cho cùng một thao tác trong phiên trang hiện tại. Nó cũng giữ lại ID đó khi việc làm mới giao diện không thành công sau một thao tác thành công: biên nhận vẫn hiển thị, và việc nhấp lại sẽ truy xuất biên nhận đó. Các RPC gọi lại và tham gia chỉ có một lần thử; các thao tác đọc có thể thử lại sẽ giữ nguyên chính sách thử lại đã cấu hình. Việc chuyển sang cuộc trò chuyện khác ngay lập tức sẽ xóa bản nháp và mục tiêu trả lời, đồng thời vô hiệu hóa việc gửi tin nhắn cho đến khi cuộc trò chuyện mới được tải xong. Ứng dụng mini này hỗ trợ các nút văn bản và nút gọi lại. Các nút ứng dụng mini sẽ hiển thị tùy chọn **Mở ứng dụng mini**, tính năng này sẽ khởi chạy ứng dụng trong một trình duyệt riêng biệt ([Ứng dụng mini](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)). Các yêu cầu đăng nhập, số điện thoại và vị trí, thanh toán, truy vấn trực tiếp và tệp đính kèm vẫn cần có ứng dụng Telegram; thông tin meta của các nút đã lưu vẫn hiển thị. Các điều khiển mới sử dụng văn bản tiếng Anh. ## Các cấp độ kiểm tra lại Quá trình kiểm tra lại sẽ yêu cầu Telegram cung cấp lại các tin nhắn bị bỏ lỡ, các chỉnh sửa và các tin nhắn mà Telegram không còn trả về. Các nguồn được đánh dấu bằng dấu sao là nguồn **ưu tiên**, được kiểm tra lại mỗi 15 phút theo mặc định; tất cả các nguồn khác được kiểm tra lại mỗi 6 giờ. Các cuộc trò chuyện được chọn ban đầu là nguồn ưu tiên, các cuộc trò chuyện được thêm vào qua thư mục hoặc toàn bộ tài khoản sẽ là nguồn thông thường. Tối đa 30 nguồn được kiểm tra lại trong mỗi lần quét và phần còn lại sẽ chờ đến phút tiếp theo; sau khi kết nối lại, các nguồn ưu tiên sẽ được xử lý trước. Cả hai khoảng thời gian này đều được thiết lập trong mục**Công cụ khác → Nguồn → Ghi lại → Kiểm tra lại** (0 để tắt cấp độ) và được ghi lại dưới dạng `recheck.changed`. Các tin nhắn bị bỏ lỡ sẽ được lấy lại từ điểm dừng của lần quét trước, tối đa là số lượng được thiết lập tại **More tools → Parameters → Missed messages recovered per chat and pass** (mặc định là 1,000). Sau một khoảng thời gian ngừng hoạt động dài, quá trình kiểm tra lại sẽ lấp đầy toàn bộ khoảng trống, ngay cả khi các tin nhắn trực tiếp mới hơn khoảng trống đó đã được lưu trước. Một cuộc trò chuyện vẫn đang trong quá trình cập nhật sẽ được kiểm tra lại vào phút tiếp theo thay vì chờ đến khoảng thời gian định kỳ của nó; `recheck.completed` sẽ hiển thị `continues_after` cho đến khi hoàn tất. Các yếu tố được so sánh bao gồm nội dung tin nhắn, các thực thể, thao tác trên bàn phím (bao gồm cả việc xóa) và nội dung/thông tin nhận dạng của tệp đính kèm. Việc thay đổi mã băm truy cập tệp hoặc tham chiếu tệp đơn thuần không được coi là một hành động chỉnh sửa, cũng như những thông tin mà Telegram tự động điền vào: quá trình tải bản xem trước liên kết, số lượt xem bài đăng, nội dung đa phương tiện trả phí được mở khóa bởi tài khoản này, hoặc biên lai hóa đơn. Mỗi phiên bản được lưu trong mục “Trò chuyện” đều có liên kết đến bản ghi nhật ký đầy đủ của nó, bao gồm cả siêu dữ liệu phương tiện. ## Lịch sử tin nhắn và nguồn gốc Giả sử công cụ thu thập ghi nhận “Cuộc họp lúc 10:00”, sau đó thấy “Cuộc họp lúc 11:00”, và tiếp theo nhận được thông báo xóa tin nhắn. Công cụ sẽ bổ sung ba ghi nhận riêng biệt. Nội dung gốc vẫn được giữ nguyên, bản chỉnh sửa là một phiên bản riêng biệt, và thông báo ghi lại rằng đã phát hiện hành vi xóa tin nhắn. Nếu quá trình thu thập bắt đầu sau khi phiên bản đầu tiên biến mất, thì nội dung văn bản đó sẽ không còn khả dụng. Nếu có nhiều lần chỉnh sửa xảy ra trong thời gian hệ thống ngừng hoạt động, thì chỉ những phiên bản được ghi nhận sau đó mới có thể được lưu lại. Thông báo xóa bỏ không thể khôi phục nội dung chưa từng được ghi lại. Bản ghi kết hợp nhiều nguồn: | Nguồn | Thông tin được bảo toàn | | --- | --- | | Tin nhắn trực tiếp hoặc cập nhật chỉnh sửa | ID tin nhắn, siêu dữ liệu người gửi, phiên bản được ghi lại, thời gian nhận và ngày gửi/chỉnh sửa tin nhắn Telegram. | | Thông báo xóa dữ liệu theo thời gian thực | ID tin nhắn được báo cáo, thời gian nhận, thông báo thô và các liên kết đến nội dung đã lưu trước đó. | | Nhật ký quản trị có sẵn | Hành động, tác nhân, ngày nguồn và nội dung tin nhắn được cung cấp, được đọc bởi một tài khoản có quyền cần thiết. | | Tương tác với bảng điều khiển | Hành động được yêu cầu và kết quả được ghi lại của hành động đó dưới tài khoản đã chọn. | | Kiểm tra lại | Phản hồi hiện tại của Telegram so với tin nhắn đã lưu trước đó. | `observed_at` là thời gian bản ghi được tạo ra theo đồng hồ thu thập và tăng lên cùng với `seq`. Các bản ghi được ghi trong khi xử lý một bản cập nhật trực tiếp cũng chứa `received_at`, thời gian bản cập nhật đến bộ thu thập, và `processing_delay_ms`, thời gian từ khi nhận được đến khi ghi; các bản cập nhật được giữ lại trong khi quá trình quan sát bắt đầu sẽ được xử lý theo thứ tự đến trước, trước các bản cập nhật đến sau. `source_at` giữ lại ngày nguồn nếu sự kiện đó cung cấp thông tin này. Các quan sát về độ lệch đồng hồ của Telegram, các bản ghi về sự gián đoạn đồng hồ và [các kiểm tra thời gian bên ngoài](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/) cung cấp bối cảnh thời gian liên quan. Các trường của một thông báo tin nhắn thông thường mô tả thông báo đó; các bản ghi nhật ký quản trị và tương tác giữ lại thông tin nguồn gốc riêng của chúng. ## Các bản chụp lịch sử Một bản chụp nhanh yêu cầu các tin nhắn hiển thị mới nhất từ một nguồn đã được bật, tối đa 500 tin nhắn cho mỗi yêu cầu. Kết quả được gắn nhãn là các quan sát lịch sử. Các bản chụp nhanh thủ công được thực hiện song song với quá trình quan sát. Các quan sát lặp lại được lưu giữ dưới dạng các bản ghi riêng biệt. Việc bật một nguồn cũng sẽ tạo ra một bản chụp nhanh `baseline`, trừ khi [tính năng chọn lọc cuộc trò chuyện nghiêm ngặt](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#strict-chosen-chats) đang được bật. Việc tạo bản chụp nhanh sẽ dừng lại nếu nguồn bị vô hiệu hóa trong quá trình đọc. Các phản hồi phải thuộc về cuộc trò chuyện được yêu cầu và chứa các ID tin nhắn dương giảm dần một cách nghiêm ngặt dưới giới hạn được yêu cầu. Một phản hồi không hợp lệ sẽ làm gián đoạn quá trình tạo bản chụp nhanh trước khi tin nhắn đó được lưu; các tin nhắn đã được lưu giữ vẫn tồn tại trong nhật ký đã ký cùng với bản ghi về sự gián đoạn. Các bản chụp nhanh tuân thủ chính sách đính kèm nhưng vẫn tách biệt với các chuyển đổi sự kiện trực tiếp. Chúng không khôi phục các tin nhắn đã bị xóa hoặc các phiên bản trung gian bị bỏ lỡ. Quý vị có thể yêu cầu tạo bản chụp nhanh khi quá trình đang tạm dừng; mọi tệp đính kèm được xếp hàng sẽ chờ cho đến khi quá trình quan sát bắt đầu và trình xử lý tải xuống được khởi chạy. Lượt chạy **Lịch sử** là tác vụ độc quyền riêng: đọc nguồn đã chọn và tải lần lượt các tệp đính kèm trong hàng đợi mà không khởi động giám sát. Tạm dừng sẽ giải phóng tài khoản; tiếp tục sẽ nối lại lượt chạy đã lưu. Để lọc ngày, ngôn ngữ và phản hồi trên nhiều tài khoản rảnh, xem [Xuất cuộc trò chuyện phân tán](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md). ## Xử lý tệp đính kèm Tính năng tải xuống tệp đính kèm được bật theo mặc định và sẽ tạm dừng khi dung lượng đĩa trống còn dưới 1 GiB. Trình thu thập sẽ thực hiện công việc quan sát tin nhắn và tải xuống cùng lúc. Công việc này giữ nguyên thông tin mô tả phương tiện gốc và chính sách về kích thước, do đó tệp đính kèm bị chỉnh sửa sau này sẽ không bị thay thế một cách âm thầm. Quá trình tải xuống diễn ra sau khi thu thập tin nhắn. Một lần tải xuống hoàn tất sẽ tạo ra bản ghi `media.saved` kèm theo giá trị SHA-256 và số byte. Các trường hợp bị bỏ qua, thất bại, thử lại và bị gián đoạn có kết quả riêng biệt; một tệp được coi là đã được lưu giữ khi bản ghi `media.saved` của nó tồn tại. Tệp đã hoàn tất cũng phải khớp với số byte trong mô tả tệp đính kèm ban đầu được quan sát. Phản hồi ngắn hơn hoặc dài hơn dự kiến sẽ không được ghi nhận là phương tiện đã được lưu giữ. Tệp và mục thư mục của nó được ghi ra đĩa trước khi ghi giá trị ``media.saved``. Khi quá trình thu thập dữ liệu trước đó kết thúc mà không được dừng một cách có trật tự, lần khởi động tiếp theo sẽ đọc tất cả các tệp được ghi nhận là đã lưu trong lần chạy đó. Một tệp bị thiếu hoặc có các byte khác với giá trị SHA-256 đã ghi sẽ được gán bản ghi ``media.missing_after_restart``, quá trình tải xuống của tệp đó sẽ được xếp lại vào hàng đợi, và các byte khác biệt sẽ được chuyển vào thư mục ``media-damaged/``. Các tệp đã được chuyển sang kho lưu trữ ngoài sẽ không được đọc. Trong cùng một không gian làm việc, các tác vụ đang xếp hàng đồng thời cho cùng một bản thể hiện tệp đính kèm sẽ chờ quá trình truyền dữ liệu đang hoạt động, sau đó kiểm tra lại các byte đã lưu trước khi tái sử dụng. Mỗi tác vụ lưu giữ kết quả có dấu và tham chiếu riêng đến bản ghi tệp đã lưu trước đó. Việc hủy bỏ một tác vụ đang chờ không làm hủy bỏ quá trình truyền dữ liệu đang hoạt động; nếu quá trình truyền đó thất bại hoặc bị hủy bỏ, tác vụ tiếp theo có thể thử lại. Các tệp đính kèm khác nhau có thể được tải xuống đồng thời. Các tác vụ có cùng tài khoản, đại diện, kích thước dự kiến và hành động thu thập sẽ được giữ trong hàng đợi trong khi một tác vụ phù hợp đang được thực thi. Chúng không chiếm các khe tải xuống, do đó các tệp khác vẫn có thể bắt đầu tải xuống ngay cả khi hàng đợi ban đầu chứa nhiều bản sao của một tệp tải chậm. Việc hoàn tất một lần thử sẽ kích hoạt lại hàng đợi. Các làn ưu tiên, thời gian chờ thử lại đã lưu và quyền sở hữu lịch sử vẫn được áp dụng; mỗi lần quan sát sẽ nhận được kết quả riêng của mình. Các tác vụ xuất dữ liệu qua trò chuyện cũng chia sẻ một luồng truyền dữ liệu đang hoạt động để xử lý các bản sao lặp lại của tệp trong cùng một thư mục xuất. Mỗi tin nhắn giữ nguyên tham chiếu đến tệp đính kèm của mình, và việc tái sử dụng yêu cầu kiểm tra lại kích thước và mã băm SHA-256. Các tệp khác nhau có thể được kiểm tra song song mà không cần giữ khóa khóa truyền dữ liệu chung. Các đường dẫn tải xuống và sao chép tạm thời là duy nhất cho từng thao tác; quá trình hủy bỏ sẽ chờ cho đến khi tất cả các trình đọc tệp cục bộ đang hoạt động hoàn tất trước khi dọn dẹp. Chỉ mục tệp xuất chỉ tuần tự hóa việc truy cập siêu dữ liệu, không bao gồm việc tính băm tệp hay tải xuống. Các thao tác đọc băm trên máy chủ cho các tệp đính kèm khác nhau cũng diễn ra đồng thời, chia sẻ ba khe yêu cầu tệp của máy khách với các hoạt động tải xuống theo byte. Các lần đọc lặp lại cùng một biểu diễn chỉ tái sử dụng kết quả đã được lưu trong bộ nhớ đệm hoàn chỉnh. Các thao tác đọc tệp không chiếm dụng hàng đợi yêu cầu thông thường; các thời hạn FloodWait đã lưu sẽ được kiểm tra lại khi một yêu cầu nhận được một khe. Các giới hạn được thiết lập **theo từng loại**: ảnh, video, GIF và hình động, tin nhắn video dạng vòng lặp, tin nhắn thoại, nhạc và âm thanh, nhãn dán, và tệp tin. Mỗi loại có thể được tắt và có giới hạn dung lượng riêng từ 1 đến 2.000 MiB; các không gian làm việc mới bắt đầu với 20 MiB cho ảnh, 100 MiB cho video, 50 MiB cho tệp tin, âm thanh và video tròn, 20 MiB cho tin nhắn thoại và GIF, cùng 5 MiB dành cho nhãn dán. Các không gian làm việc mới sẽ để GIF và nhãn dán ở trạng thái tắt cho đến khi được bật. Các không gian làm việc có chính sách được lưu trước khi áp dụng giới hạn theo từng loại sẽ giữ tất cả các loại ở trạng thái bật và duy trì giới hạn chung duy nhất cho mỗi loại. *Giới hạn kích thước tệp tối đa* sẽ áp dụng đồng thời cho mọi loại. Một loại bị tắt sẽ tạo ra bản ghi `media.skipped`; các tệp có kích thước không xác định hoặc vượt quá giới hạn sẽ không được tải xuống. Các tệp lớn sẽ có thời gian tải xuống thêm dựa trên kích thước của chúng và tốc độ cơ bản là 256 KiB/s. Các tác vụ vẫn tồn tại sau khi khởi động lại, nhưng các tham chiếu đã hết hạn, quyền truy cập bị mất hoặc các tệp đã bị xóa vẫn có thể cản trở việc khôi phục. Các tác vụ đang chờ sẽ giữ nguyên giới hạn đã lưu kèm theo chúng, do đó việc tăng giới hạn chỉ áp dụng cho các tệp mới. Việc tắt một loại tệp hoặc giảm giới hạn của loại đó cũng sẽ bỏ qua các tệp đang chờ thuộc loại bị loại trừ, mỗi tệp sẽ có một bản ghi `media.skipped`; việc tắt tính năng tải xuống sẽ tạm dừng hàng đợi cho đến khi tính năng này được bật lại. ## Tạm dừng, khóa, ngắt kết nối và khởi động lại | Hành động hoặc điều kiện | Hiệu quả | | --- | --- | | Chuyển đổi không gian làm việc | Thay đổi chế độ xem bảng điều khiển; các trình thu thập khác vẫn giữ nguyên trạng thái của chúng. | | Khóa bảng điều khiển hoặc đóng tab | Giữ cho máy chủ và quá trình giám sát tiếp tục hoạt động. | | Tạm dừng quan sát | Tạm dừng quá trình thu thập và bảo toàn các tệp đính kèm đang chờ xử lý. | | Vô hiệu hóa một nguồn | Tính năng này sẽ ngừng việc ghi lại theo phạm vi trong tương lai; các tác vụ phương tiện đang chờ xử lý sẽ bị tạm dừng trong thời gian tính năng này bị vô hiệu hóa. | | Loại bỏ một nguồn | Hệ thống sẽ loại bỏ nguồn này và xóa các hồ sơ người dùng liên quan; các bản ghi đã được lưu trữ vẫn được giữ lại trong sổ nhật ký chỉ ghi thêm. Các tệp đính kèm vẫn đang chờ xử lý sẽ được ghi nhận là thất bại (`source_removed`). Trong chế độ theo thư mục và chế độ toàn tài khoản, các tệp này cũng sẽ bị loại trừ. | | Thay đổi lộ trình kết nối | Yêu cầu tạm dừng, đóng các phiên khách hàng cũ và hủy các phiên đăng nhập chưa hoàn tất. | | Dừng tiến trình Python | Tạm dừng tất cả các không gian làm việc; không có bất kỳ ghi nhận nào được thực hiện trong thời gian công cụ này ở chế độ ngoại tuyến. | | Khởi động lại sau khi quan sát tích cực | Hệ thống sẽ cố gắng khôi phục phạm vi đã lưu bằng cách sử dụng phiên làm việc đã lưu. Việc tạm dừng thủ công sẽ hủy bỏ ý định đó. | Bộ thu thập ghi lại các sự cố ngắt kết nối, lần thử lại, lỗi, khởi động/dừng và nhịp đập được phát hiện. Các gián đoạn ngắn có thể bị bỏ sót trong các kiểm tra kết nối định kỳ. Sau khi khởi động lại, các bản cập nhật bị bỏ sót sẽ được yêu cầu từ vị trí cập nhật đã lưu và các cuộc trò chuyện được quan sát sẽ được kiểm tra lại định kỳ; xem [định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#durable-collection-and-process-receipts-02). Một bản chụp nhanh thêm trạng thái hiện tại làm bối cảnh, và khoảng trống vẫn được ghi lại. ## Cách ly và xác minh tài khoản Mỗi không gian làm việc đều có sổ nhật ký, quyền truy cập, khóa ký, chính sách và hàng đợi riêng. Chỉ khách hàng đang hoạt động của không gian làm việc đó mới có thể đóng góp các quan sát trực tiếp. Các khách hàng bị từ chối, đang chờ xử lý, bị thay thế và đang kiểm tra kết nối không thể ghi các cập nhật trực tiếp vào sổ nhật ký của không gian làm việc đó. Các tài khoản khác nhau có thể theo dõi cùng một nhóm, nhưng sổ nhật ký của họ vẫn được tách biệt. Mỗi sự kiện bao gồm mã băm trước đó và chữ ký Ed25519. Các tệp xuất bao quát toàn bộ nhật ký không gian làm việc thông qua một số thứ tự cố định. Các bộ lọc trên bảng điều khiển không lọc dữ liệu xuất; quá trình thu thập có thể tiếp tục vượt ra ngoài ranh giới của nhật ký trong khi tệp xuất đang được chuẩn bị. **Tính năng Xác minh Nhật ký** sẽ kiểm tra chuỗi sự kiện và các chữ ký thông qua phạm vi hiển thị. Kết quả của tính năng này sẽ bị xóa khi không gian làm việc thay đổi, và bảng điều khiển sẽ xác định các bản ghi mới được thêm vào sau khi kiểm tra. Tính năng xuất dưới dạng ZIP cũng xác minh các tệp phương tiện đã thu thập. Giữ nguyên các dấu vân tay và điểm kiểm tra một cách độc lập. Xem phần “ [Phạm vi xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope)” để biết các kiểm tra thu thập dữ liệu trong từng chế độ, và phần “[Hoạt động hàng ngày](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/)” để biết việc thu thập dữ liệu định kỳ. --- # Telegram · Trò chuyện bí mật: thiết lập và ghi lại Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/ Cài đặt tiện ích giao thức Trò chuyện bí mật, bật cho từng tài khoản và ghi lại các cuộc trò chuyện mà TgWitness tạo hoặc chấp nhận. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Cài đặt tiện ích giao thức Trò chuyện bí mật, bật cho từng tài khoản và ghi lại các cuộc trò chuyện mà TgWitness tạo hoặc chấp nhận. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) Ứng dụng đã được phát hành bao gồm phần nền tảng của Secret Chat, tích hợp bộ thu thập dữ liệu, các tuyến API và giao diện **Pseudo-secret**. Thư viện giao thức là một mô-đun riêng biệt: mở **Pseudo-secret**, nhấn **Cài đặt và bật tính năng**. Tính năng tự động chấp nhận tin nhắn đến sẽ ở trạng thái tắt cho đến khi bạn bật nó lên. ## Mô-đun giao thức | | | | --- | --- | | Mô-đun | `kiaro-telethon-secret-chat` 0.2.0 | | Tác giả | KiaroSama | | Giấy phép | GPL-3.0-hoặc-phiên bản-mới-hơn; `LICENSE` và `NOTICE` giữ nguyên trong tệp lưu trữ đã lưu | | Nguồn | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) tại commit `d87bf037b90060383c7b704d8a06ebb98c621c6f` | | Kiểm tra | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` trên danh sách các tệp gói và các giá trị SHA-256 tương ứng của chúng | Chức năng **cài đặt và kích hoạt** chỉ dành cho quản trị viên chính. TgWitness tải xuống tập tin lưu trữ nguồn của bản cam kết đó từ GitHub thông qua đường dẫn của không gian làm việc dành cho các yêu cầu bên ngoài Telegram, so sánh từng tệp trong gói với giá trị đã được cố định trong bản phát hành TgWitness, lưu tập tin lưu trữ vào `modules/telethon-secret-chat-.zip` trong thư mục dữ liệu và tải mã từ bộ nhớ. Không cần khởi động lại. Quá trình kiểm tra sẽ được thực hiện lại mỗi khi khởi động; tệp lưu trữ có sự khác biệt sẽ không được tải và trang sẽ hiển thị thông báo về điều này. Tệp gói bị thay đổi, thiếu hoặc được thêm vào sẽ khiến quá trình kiểm tra không thành công. Mô-đun này là một tác phẩm độc lập với giấy phép riêng. TgWitness không cung cấp sẵn mô-đun này: mỗi lần cài đặt sẽ tải xuống mô-đun từ kho lưu trữ của tác giả. **Thông tin chi tiết** trên trang hiển thị mô-đun đã được tải, tác giả, giấy phép, commit và mã SHA-256 của mô-đun đó. Một người quản trị không có quyền truy cập GitHub có thể cài đặt cùng một commit vào môi trường Python thay thế; sau đó, bảng điều khiển sẽ sử dụng bản sao đó: ``` python -m pip install ".[secret-chats]" ``` TgWitness trở thành điểm cuối cho các cuộc trò chuyện mà nó tạo ra hoặc chấp nhận. Nó ghi lại các tin nhắn, tệp đính kèm có sẵn, thay đổi bộ đếm thời gian và thông báo xóa trong nhật ký đã ký. Nội dung đã lưu trước đó vẫn có sẵn sau khi có thông báo xóa sau này. ## Tình trạng sẵn có của gói Vào ngày 8 tháng 11 năm 2026 , gói cài đặt đã được công bố đã được kiểm tra tại mã nguồn [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) , bản phát hành `b35f8e18f3d1-1ff85ec98bb2` , phiên bản 0.9.1 bản xem trước. Gói [wheel bất biến](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) và khóa phụ thuộc của nó đã vượt qua quá trình xác minh chữ ký phát hành SHA-256 và RSA. Phần backend và giao diện được đóng gói khớp từng byte với phiên bản mã nguồn đó. Gói này cũng chứa đăng ký API và các hook của bộ thu thập dữ liệu. Gói đó không chứa thư viện giao thức, và nó cũng không có trong tệp lock phụ thuộc. Phần `secret-chats` phần extra trong [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) cố định cùng một commit như nút trên bảng điều khiển. Việc kiểm tra gói này xác định các tệp và khai báo phụ thuộc nào được phân phối. Bản [ghi xác thực](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/) xác định các kiểm tra thời gian chạy riêng biệt. Hướng dẫn ngày 6 tháng 11 trước đó mô tả một bản chụp nhanh phát triển; nó không còn mô tả gói trên nữa. ## Sử dụng giao diện Mở **Pseudo-secret**, cài đặt mô-đun nếu trang web cung cấp, bật tính năng này cho tài khoản và kết nối. Các yêu cầu đến sẽ chờ được chấp nhận trừ khi tính năng chấp nhận tự động đã được bật. Các thao tác khởi động, chấp nhận, gửi và đóng sẽ sử dụng quyền tương tác của tài khoản và chế độ bảo vệ chỉ đọc. | Hành động | Kết quả được bảo toàn | | --- | --- | | Bắt đầu cuộc trò chuyện bằng tên người dùng hoặc ID người dùng | Yêu cầu đi ra; đối tác chấp nhận yêu cầu đó trên thiết bị của họ. | | Chấp nhận yêu cầu | TgWitness trở thành điểm cuối nhận dữ liệu. | | Gửi hoặc nhận tin nhắn | `secret_chat.message` cùng với hướng, nội dung và bộ đếm thời gian được cung cấp. | | Nhận tệp | Các byte đã được giải mã được lưu trữ bằng SHA-256 và biên nhận `secret_chat.file`; được bao gồm trong tệp xuất bằng chứng. | | Nhận thông báo về thời gian đếm ngược hoặc thông báo xóa | Một bản ghi hành động riêng biệt cùng với các tin nhắn và tệp tin được lưu giữ. | | Xem lại cuộc trò chuyện | Cuộc trò chuyện, biên nhận tệp, thông báo và trực quan hóa khóa. | Các Cuộc trò chuyện bí mật hiện có trên thiết bị khác vẫn giữ nguyên các khóa dành riêng cho thiết bị đó. Một phiên đám mây được nhập vào sẽ không chuyển các khóa đó. Vật liệu khóa và bộ đếm của cuộc trò chuyện bí mật sử dụng kho lưu trữ không gian làm việc; các tin nhắn được lưu giữ và các tệp đã được giải mã sử dụng các biện pháp bảo vệ lưu trữ không gian làm việc thông thường. ## Tìm các tin nhắn đã lưu Sử dụng **tính năng Tìm kiếm tin nhắn** trong một cuộc trò chuyện đang mở để tìm một cụm từ chính xác, không phân biệt viết hoa hay viết thường. **Nhấn Trước** và **Tiếp theo**, hoặc nhấn phím Enter và Shift+Enter trong ô tìm kiếm, để chuyển giữa các tin nhắn phù hợp. Bộ đếm hiển thị số tin nhắn; cụm từ phù hợp đầu tiên trong mỗi tin nhắn sẽ được đánh dấu. Nhấn phím Escape để xóa tìm kiếm. Tính năng Tìm kiếm giúp hiển thị các cuộc trò chuyện xung quanh, các tệp đã lưu và thông báo xóa. Tính năng này tìm kiếm trong các bản ghi đã được tải sẵn trong bảng điều khiển. Khi còn các bản ghi cũ hơn, bảng điều khiển sẽ thông báo điều này; tùy chọn **Tải các bản ghi cũ hơn** sẽ mở rộng lịch sử và cập nhật kết quả tìm kiếm trong khi vẫn giữ nguyên tin nhắn hiện tại. Mỗi cuộc trò chuyện sẽ giữ lại lịch sử tìm kiếm khi bạn chuyển đổi trong cùng một không gian làm việc. Việc khóa bảng điều khiển hoặc chuyển sang không gian làm việc khác sẽ xóa các lịch sử tìm kiếm đó. Các từ khóa tìm kiếm được lưu trong bộ nhớ của trang và không được lưu trữ trong bộ nhớ trình duyệt cũng như không được gửi dưới dạng các yêu cầu API. Việc tìm kiếm không gửi tin nhắn Telegram hay thông báo gõ phím/đã đọc. Các cài đặt hiển thị hiện có vẫn áp dụng cho việc mở cuộc trò chuyện và các thao tác khác. **Báo cáo xây dựng** sẽ giữ nguyên phạm vi báo cáo của cuộc trò chuyện đã chọn; việc tìm kiếm trên giao diện hiển thị sẽ không tự động giới hạn các bản ghi được xuất ra. Hãy xem trước phạm vi lựa chọn của báo cáo trước khi tải xuống. ## Kiểm soát tính bền vững và tương tác Việc triển khai tích hợp sử dụng tính năng tra cứu nhật ký bền vững để phát hiện trùng lặp, giữ các tác vụ đính kèm ở trạng thái chờ sau khi tải xuống thất bại, và định tuyến việc đóng qua cùng một bộ bảo vệ tương tác như các hành động từ xa khác. Những điều này thay thế ba lộ trình được báo cáo trong cuộc kiểm toán bản chụp phát triển ngày 6 tháng 11 trước đây. Các tin nhắn đã được giải mã nhưng không ghi vào nhật ký thành công sẽ được lưu giữ trong kho để thử lại. Việc kiểm tra kích thước tệp đính kèm và dung lượng đĩa trống sẽ tạm hoãn quá trình tải xuống trong khi vẫn giữ nguyên các tác vụ tương ứng. Mô-đun này tái sử dụng kết nối hiện có của tài khoản. Các thông báo đã đọc và đang gõ chỉ được gửi theo lựa chọn trong phần [Những gì phía bên kia nhìn thấy](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees); thông báo chụp màn hình không bao giờ được gửi. Xem [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [các tuyến API](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) và [chính sách truy cập](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py). Báo cáo [kiểm toán lịch sử](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) vẫn giữ nguyên các phát hiện từ bản chụp nhanh ban đầu. Tình trạng sẵn có và triển khai hiện tại nên được tham khảo từ phiên bản gói ở trên và các [tính năng hiện tại](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md). ## Demo giao diện Kịch bản trang web sử dụng các yêu cầu, tin nhắn và tệp giả định để minh họa quy trình làm việc của bảng điều khiển. Đây là một ví dụ về giao diện; các kiểm tra giao thức và thu thập dữ liệu có kết quả được ghi ngày tháng riêng trong bản ghi xác thực. --- # Telegram · Tải lịch sử nguồn Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/history/ 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ý. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) 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](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bộ sưu tập](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![Bộ sưu tập](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md) để 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](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#message-history-and-attribution) 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](https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/) 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](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope). 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. --- # Telegram · Quy trình làm việc và hoạt động Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/operations/ Hoạt động hàng ngày của bảng điều khiển: các chế độ, danh mục giám sát, thông số, thông báo, xuất dữ liệu, sao lưu và dung lượng. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Translation coverage: this edition includes material from the English original. Hoạt động hàng ngày của bảng điều khiển: các chế độ, danh mục giám sát, thông số, thông báo, xuất dữ liệu, sao lưu và dung lượng. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Triển khai và khôi phục](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) ![Triển khai & khôi phục](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Đối với lần kết nối đầu tiên, vui lòng sử dụng [các định dạng tài khoản và phiên làm việc](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/). Để tìm hiểu về các phiên bản đã lưu, chính sách sự kiện và các khoảng trống, xin tham khảo phần [giải thích về cơ chế thu thập dữ liệu](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/). Hướng dẫn này bao quát các hoạt động hàng ngày và quy trình khôi phục dữ liệu. Một bản cài đặt được quản lý bao gồm các tệp **, START-HERE.html,** và **, START-HERE.txt,** bên cạnh trình khởi chạy của nó, kèm theo liên kết kho lưu trữ và các lệnh được tùy chỉnh theo đường dẫn cài đặt của nó. Chạy tệp `tgwitness guide --print` qua SSH, hoặc tệp `tgwitness paths` để xác định vị trí thư mục dữ liệu thực tế. Một bản cài đặt systemd với quyền root lưu trữ trạng thái riêng tư trong tệp `/var/lib/tgwitness-…`; tệp `/opt/tgwitness` chứa chương trình. Đối với đường hầm Cloudflare tạm thời được quản lý, `tgwitness tunnel off` sẽ đóng quyền truy cập công khai trong khi bảng điều khiển cục bộ và quá trình thu thập dữ liệu vẫn tiếp tục hoạt động. `tgwitness tunnel on` kích hoạt quyền truy cập này; `tgwitness tunnel restart` tạo kết nối đường hầm mới. Sử dụng `tgwitness open` để xem địa chỉ hiện tại của đường hầm. Cài đặt tắt rõ ràng sẽ được duy trì ngay cả khi dịch vụ khởi động lại. `tgwitness stop` dừng cả bảng điều khiển và quá trình thu thập dữ liệu. **Trên trang này** - [Quy trình làm việc của người vận hành](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#operator-workflow) - [Chia sẻ công việc mà không cần chia sẻ khóa chính](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#share-work-without-sharing-the-main-key) - [Chế độ chạy](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#runtime-modes) - [Các danh mục giám sát](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#monitoring-categories) - [Thông báo](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#notifications) - [Bố cục bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#panel-layout) - [Môi trường triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#deployment-environments) - [Kiểm tra khởi động và xuất dữ liệu](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#startup-checks-and-exports) - [Sao lưu, khôi phục và sự gián đoạn](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#backup-restore-and-interruptions) - [Dung lượng và thời gian lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#capacity-and-retention) ## Quy trình làm việc của người vận hành Sơ đồ quy trình · Chọn phương thức lưu trữ và bảo vệ khóa → Mở bảng điều khiển bằng mã thông báo của nó; Mở bảng điều khiển bằng mã thông báo của nó → Chọn không gian làm việc; Chọn không gian làm việc → Cấu hình đường dẫn trực tiếp hoặc qua proxy; Cấu hình đường dẫn trực tiếp hoặc qua proxy → Nhập số điện thoại hoặc chọn tệp / mã QR; Nhập số điện thoại hoặc chọn tệp / mã QR → Xác minh danh tính tài khoản và chọn các nhóm có thể truy cập; Xác minh danh tính tài khoản và chọn các nhóm có thể truy cập → Lưu các chính sách về sự kiện và tệp đính kèm, sau đó bắt đầu quá trình giám sát; Lưu các chính sách về sự kiện và tệp đính kèm, sau đó bắt đầu quá trình giám sát → Theo dõi lỗi, quyền truy cập, hàng đợi và dung lượng đĩa; Theo dõi lỗi, quyền truy cập, hàng đợi và dung lượng đĩa → Giữ lại các điểm kiểm tra độc lập; Giữ lại các điểm kiểm tra độc lập → Xuất và xác minh tài liệu · Chọn phương thức lưutrữ và bảo vệ khóa · Mở bảng điều khiểnbằng mã thông báo củanó · Chọn không gian làmviệc · Cấu hình đường dẫntrực tiếp hoặc quaproxy · Nhập số điện thoạihoặc chọn tệp / mã QR · Xác minh danh tính tàikhoản và chọn các nhómcó thể truy cập · Lưu các chính sách vềsự kiện và tệp đínhkèm, sau đó bắt đầuquá trình giám sát · Theo dõi lỗi, quyềntruy cập, hàng đợi vàdung lượng đĩa · Giữ lại các điểm kiểmtra độc lập · Xuất và xác minh tàiliệu **Sơ đồ dưới dạng văn bản** 1. Chọn phương thức lưu trữ và bảo vệ khóa → Mở bảng điều khiển bằng mã thông báo của nó 2. Mở bảng điều khiển bằng mã thông báo của nó → Chọn không gian làm việc 3. Chọn không gian làm việc → Cấu hình đường dẫn trực tiếp hoặc qua proxy 4. Cấu hình đường dẫn trực tiếp hoặc qua proxy → Nhập số điện thoại hoặc chọn tệp / mã QR 5. Nhập số điện thoại hoặc chọn tệp / mã QR → Xác minh danh tính tài khoản và chọn các nhóm có thể truy cập 6. Xác minh danh tính tài khoản và chọn các nhóm có thể truy cập → Lưu các chính sách về sự kiện và tệp đính kèm, sau đó bắt đầu quá trình giám sát 7. Lưu các chính sách về sự kiện và tệp đính kèm, sau đó bắt đầu quá trình giám sát → Theo dõi lỗi, quyền truy cập, hàng đợi và dung lượng đĩa 8. Theo dõi lỗi, quyền truy cập, hàng đợi và dung lượng đĩa → Giữ lại các điểm kiểm tra độc lập 9. Giữ lại các điểm kiểm tra độc lập → Xuất và xác minh tài liệu Quyền truy cập, kết nối truyền tải, quyền tham gia nhóm và tính đầy đủ của việc gửi tin nhắn là các thuộc tính khác nhau. Trạng thái kết nối màu xanh lá cây không có nghĩa là tất cả các sự kiện đã được ghi lại. ## Chia sẻ công việc mà không cần chia sẻ khóa chính Mở **thêm công cụ → Truy cập** để cấp mã thông báo riêng cho người đánh giá hoặc nhà phân tích. Chọn các tài khoản và cuộc trò chuyện mà họ có thể truy cập, sau đó cho phép xem, xuất hoặc thực hiện các hành động vận hành. Người vận hành khởi động/dừng quá trình thu thập cần quyền truy cập toàn bộ không gian làm việc; người đánh giá có thể bị giới hạn trong một cuộc trò chuyện duy nhất. Giới hạn phiên, thời hạn hết hiệu lực và quy tắc IP là riêng biệt so với ủy quyền tài khoản Telegram. Xem [quyền truy cập và quyền hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/access/). Sử dụng **tính năng “Open sessions”** để ngắt kết nối hoặc thu hồi quyền truy cập nhằm chấm dứt tất cả các phiên làm việc của người dùng đó. Bảng điều khiển quản trị tổng hợp hoạt động của các quy trình hiện tại trên các không gian làm việc. Việc đóng phiên làm việc sẽ không ảnh hưởng đến quá trình thu thập dữ liệu. ## Các chế độ hoạt động | Chế độ | Hành động | Hành vi | | --- | --- | --- | | Bản demo | scripts\Demo.cmd hoặc `--demo` | Dữ liệu tổng hợp; tính năng kết nối với tài khoản thực đã bị vô hiệu hóa | | Quan sát | Bắt đầu quan sát | Ghi lại các bản cập nhật đã được gửi cho các nguồn được chọn | | Bản chụp lịch sử | Cuộc trò chuyện → Hành động trong cuộc trò chuyện → Tải lịch sử | Lưu trữ tối đa 500 tin nhắn hiện tại; không tái tạo lại tất cả các thay đổi trong quá khứ | | Tạm dừng | Tạm dừng quan sát | Tạm dừng thu thập dữ liệu trong khi vẫn lưu giữ dữ liệu và các tác vụ đang chờ xử lý | | Xem xét/Chuyển giao | Xuất dữ liệu | ZIP, JSONL/CSV/HTML, điểm kiểm tra, biên nhận quá trình và yêu cầu dấu thời gian | | Nhiều tài khoản | Các không gian làm việc hoặc nút **+** ở trên cùng | Có thể tạo bất kỳ số lượng không gian làm việc riêng biệt nào trong cùng một quy trình | Quyền truy cập bản demo tại địa phương sẽ tự động mở mà không cần nhập mã thông báo thủ công. Tính năng này sử dụng khả năng tồn tại trong suốt quá trình xử lý, chỉ có hiệu lực đối với quyền truy cập vòng lặp trực tiếp vào một bản demo tổng hợp được cách ly; mã thông báo của bảng điều khiển chính không được tiết lộ. Các không gian làm việc thực tế cũng như quyền truy cập bản demo từ xa hoặc qua máy chủ proxy vẫn duy trì xác thực bằng mã thông báo. Việc truy cập bản demo không cấp bất kỳ quyền ủy quyền nào trên Telegram. ## Các danh mục giám sát ![Cài đặt giám sát theo từng tài khoản với dữ liệu nguồn tổng hợp](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c) Trong **mục Công cụ khác → Nguồn → Ghi lại → Chọn những thay đổi cần giữ lại**, hãy chọn riêng biệt các tin nhắn mới, chỉnh sửa, thông báo xóa, cập nhật phản hồi và sự kiện thành viên. Cài đặt mặc định giữ lại tất cả các danh mục. Tùy chọn **Tin nhắn, chỉnh sửa & xóa** giữ nguyên bối cảnh ban đầu trong khi vô hiệu hóa các cập nhật riêng biệt về phản hồi/thành viên. Tùy chọn **Tất cả hoạt động hiển thị** khôi phục cả năm danh mục. Các cài đặt sẵn thay đổi định dạng; nhấn **Lưu cài đặt ghi lại** để áp dụng. Chính sách đã lưu sẽ áp dụng cho tất cả các nguồn được chọn trong không gian làm việc đó. Các không gian làm việc khác vẫn giữ nguyên cài đặt riêng của mình. Mỗi thay đổi thực tế đều được ghi lại kèm theo các giá trị trước và sau đã được ký xác thực; chính sách hiện tại cũng được bao gồm trong biên nhận quá trình và bản ghi bắt đầu quan sát. Việc vô hiệu hóa một danh mục sẽ không xóa các quan sát trước đó. Việc kích hoạt lại sẽ không khôi phục các thay đổi đã bỏ lỡ. Trong phiên bản này, không có tính năng ghi đè danh mục theo từng nhóm. Vui lòng duy trì tính năng ghi lại tin nhắn mới khi nội dung trước đó vẫn còn quan trọng: thông báo xóa tin nhắn không thể khôi phục lại văn bản chưa từng được ghi lại. Các bản ghi hoạt động/phạm vi phủ sóng cùng các sự kiện dịch vụ nhóm khác luôn được lưu giữ. Các bản chụp lịch sử rõ ràng là riêng biệt so với việc lựa chọn danh mục thời gian thực và có thể bao gồm các tin nhắn dịch vụ. Các tùy chọn này không che giấu siêu dữ liệu về phản ứng/thành viên được nhúng trong một đối tượng Telegram đã được ghi lại. Một bản chụp lịch sử có thể xếp các tệp đính kèm vào hàng đợi khi đang tạm dừng. Hãy bắt đầu quá trình quan sát để xử lý chúng. Việc được xếp vào hàng đợi không có nghĩa là đã được tải xuống. Một tệp gốc không khả dụng sẽ không bị thay thế bằng phiên bản đã chỉnh sửa mới hơn; các kết quả sẽ được ghi lại riêng biệt. **Nút “Lock”** sẽ xóa quyền truy cập trình duyệt và các trường bí mật nhưng vẫn duy trì quá trình thu thập dữ liệu. Việc đóng tab cũng không làm dừng quá trình thu thập dữ liệu. Việc dừng tiến trình Python hoặc dịch vụ sẽ ngừng quá trình thu thập dữ liệu bất kể trạng thái của trình duyệt. Một không gian làm việc bổ sung có thể bị xóa sau khi tệp ZIP hoặc tệp ASiC-E đã được ký điện tử, bao gồm nhật ký và các ghi chú trên Bảng trường hợp của nó, đã được tải xuống đầy đủ. Việc chuẩn bị tệp lưu trữ là chưa đủ: nếu có bản ghi nằm ngoài các sự kiện thiết lập hoặc ghi chú được thêm vào sau khi tải xuống, thì tùy **chọn Xóa** sẽ không khả dụng. Khi bảng điều khiển nhận được chính tệp đó, nó chỉ tính việc xuất sau khi đã nhận đủ mọi byte, rồi báo cáo kích thước lên `POST /api/exports/{id}/received`; một quá trình tải xuống bị gián đoạn sẽ không được tính. Với trình chọn lưu của trình duyệt (Truy cập Hệ thống Tệp), bảng điều khiển sẽ báo cáo sau khi tệp được ghi và đóng lại. Nếu không có trình chọn này, bảng điều khiển sẽ chuyển tệp đã nhận sang danh sách tải xuống của trình duyệt và không thể biết liệu trình duyệt có lưu tệp đó hay không, ví dụ như khi hộp thoại lưu tệp bị hủy; khi đó, bảng điều khiển sẽ báo rằng quá trình tải xuống đã bắt đầu, chứ không phải tệp đã được lưu. Một tệp mà trình duyệt tự tải xuống (một bản xuất có kích thước lớn hơn bộ đệm trình duyệt của bảng điều khiển) và một lần tải xuống bởi một khách hàng HTTP khác sẽ được tính khi máy chủ đã gửi toàn bộ phản hồi. Hệ điều hành và bộ đệm proxy ngược lưu trữ vài megabyte của phản hồi, do đó đối với các lần tải xuống này, máy chủ không thể phát hiện sự gián đoạn gần cuối. Trừ khi bảng điều khiển thông báo tệp đã được lưu, hãy kiểm tra tệp đã tải xuống trước khi xóa. Một tệp xuất theo nhóm sẽ được tính vào số lượng tài khoản khi nó được tải xuống ngay sau khi được chuẩn bị; việc tải lại tệp từ **mục Tệp xuất đã chuẩn bị** sẽ không được tính. Trước khi xóa, bảng điều khiển sẽ hiển thị định dạng, kích thước, thời gian chuẩn bị và giá trị SHA-256 của tệp lưu trữ đã ký được tải xuống gần nhất và yêu cầu xác nhận rằng tệp lưu trữ này đã được lưu trữ bên ngoài không gian làm việc. Máy chủ sẽ từ chối lệnh `DELETE /api/profiles/{id}` nếu tham số `kept_copy` không được đặt thành giá trị SHA-256 đó (hoặc thành `confirmed` đối với tệp lưu trữ được tải xuống trước khi dấu vân tay được ghi lại). Việc xóa một không gian làm việc bổ sung sẽ dừng trình thu thập dữ liệu của không gian đó và xóa dữ liệu cục bộ của nó. Nếu một tệp bị khóa hoặc lỗi hệ thống tệp làm gián đoạn quá trình xóa, bảng điều khiển sẽ báo cáo sự cố và giữ không gian làm việc đó trong danh sách là không khả dụng (`DeletionPending`). Vui lòng đóng các chương trình đang giữ các tệp của không gian làm việc đó và thử lại **lệnh Xóa**. Việc khởi động lại TgWitness sẽ khiến không gian làm việc đó vẫn ở trạng thái dừng và không khôi phục lại nhật ký hoặc các khóa đã bị xóa một phần. Việc xóa thành công chỉ được ghi lại sau khi thư mục đã được xóa; các bản sao được xuất hoặc sao lưu riêng biệt vẫn tuân theo chính sách lưu trữ riêng của chúng. ## Thông báo Mở **Cài đặt → Thông báo và bản sao ngoài trang web → Địa chỉ nhận thông báo**, hoặc **Công cụ khác → Tiện ích → Thông báo → Cấu hình**. TgWitness sử dụng Apprise để gửi cảnh báo đến Matrix, Telegram, Discord, Slack, ntfy, email và các dịch vụ được hỗ trợ khác. Bạn có thể thêm nhiều địa chỉ nhận thông báo vào một không gian làm việc. 1. Vui lòng nhập một URL đích Apprise trên mỗi dòng. Hãy sử dụng danh mục dịch vụ ( [danh mục dịch vụ và các định dạng URL](https://appriseit.com/services/)) phù hợp với dịch vụ của quý vị. 2. Vui lòng bật tùy chọn **“Gửi thông báo”**, sau đó chọn các cảnh báo sự cố, thay đổi trong các cuộc trò chuyện được theo dõi và bản tóm tắt hàng ngày. Giờ trong bản tóm tắt sử dụng múi giờ của máy chủ. 3. Vui lòng bật tùy chọn **“Bao gồm các đoạn trích ngắn”** nếu quý vị muốn văn bản được lưu trữ từ các tin nhắn đã bị xóa và đã chỉnh sửa xuất hiện trong các thông báo. 4. Nhấn vào **“Lưu thông báo”**, sau đó nhấn **“Gửi thử nghiệm”** để kiểm tra việc gửi đi. Đối với máy chủ nhận của riêng quý vị, vui lòng sử dụng [webhook JSON](https://appriseit.com/services/json/) của Apprise. Ví dụ: `jsons://notify.example.org/tgwitness` gửi JSON qua HTTPS đến điểm cuối đó. Đây là một ví dụ hư cấu; quý vị hãy thay thế bằng điểm đến của riêng mình. Các đích đến và cài đặt thuộc về không gian làm việc đã chọn. Thông báo thay đổi bao gồm các nguồn được theo dõi, bao gồm cả các cuộc trò chuyện mới được thêm vào. Biểu tượng chuông trên thanh trên cùng cũng liệt kê các sự cố gần đây và những thay đổi trong cuộc trò chuyện. Trong bản demo, các điều khiển thông báo hiển thị nhưng chức năng gửi đã bị vô hiệu hóa. Vui lòng cấu hình việc gửi thông báo trong một không gian làm việc thực tế. Các thông báo sẽ sử dụng đường dẫn Direct, SOCKS5 hoặc HTTP của không gian làm việc đó; MTProxy không thể truyền tải chúng. Các điểm đến không phải HTTP như SMTP yêu cầu một đường dẫn trực tiếp. ## Bố cục bảng điều khiển ![Kết nối không gian làm việc bằng dữ liệu tổng hợp](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29) **Tạp chí này** hiển thị các quan sát, chức năng tìm kiếm và bộ lọc. Khi có thao tác chỉnh sửa, các phiên bản đã được ghi lại sẽ được mở ra; khi có thao tác xóa, nội dung trước đó (nếu có) sẽ được hiển thị. Nguồn gốc không xác định vẫn được nêu rõ ràng. Số liệu thống kê có sẵn trong **phần Tổng quan**; chi tiết về quá trình thu thập được lưu giữ trong hướng dẫn cục bộ. Mở một tin nhắn đã chỉnh sửa để so sánh các phiên bản của nó bằng **Thay đổi trong văn bản** hoặc **Đặt cạnh nhau**; **Dữ liệu thô** hiển thị các trường đã lưu. Các thay đổi đối với liên kết ẩn và nút bot xuất hiện riêng biệt. Mở bản xem trước tệp đính kèm để kiểm tra hình ảnh, âm thanh hoặc video đã lưu; nút tải xuống giúp giữ cho bản gốc đã lưu trữ luôn sẵn có. **Live** cập nhật nhật ký và các cuộc trò chuyện ngay khi có bản ghi mới. Tạm dừng tính năng này khi đang xem xét, hoặc sử dụng nút sự kiện mới khi đã sẵn sàng; quá trình thu thập vẫn tiếp tục chạy. **Ctrl/Cmd+K** tìm các thao tác trên bảng điều khiển và tìm kiếm trong nhật ký. **Các công cụ khác → Nguồn** chứa phạm vi quan sát (các cuộc trò chuyện đã chọn, một thư mục Telegram hoặc toàn bộ tài khoản), các cuộc trò chuyện có thể truy cập thuộc mọi loại, các nguồn đã chọn có sao ưu tiên, cài đặt tệp đính kèm và kiểm tra lại, cùng các bản chụp lịch sử. Các nguồn riêng tư được chọn theo hộp thoại/ID mà không có liên kết công khai. Trạng thái truy cập mô tả lần kiểm tra gần nhất, không phải quyền truy cập vĩnh viễn. Lọc các nguồn, đánh dấu vào ô chọn của chúng, sau đó bật, tạm dừng hoặc đánh dấu ưu tiên cho chúng cùng lúc. Trong danh sách cuộc trò chuyện khả dụng, **Thêm mục đã chọn** sẽ sử dụng lựa chọn của bạn; **Thêm tất cả kết quả phù hợp** sẽ sử dụng bộ lọc tìm kiếm và loại hiện tại. **Phần “Trò chuyện” → “Người dùng”** liệt kê tất cả những người có tin nhắn được lưu trữ; khi tính năng hồ sơ người dùng được bật cho cuộc trò chuyện đó, chỉ cần nhấp chuột là hồ sơ của người đó sẽ mở ra kèm theo các liên kết đến các bản ghi trong sổ chứng cứ. **Các công cụ khác → Tiện ích → Independent witness** tạo các token chứng kiến chỉ đọc, hiển thị thời điểm lần cuối mỗi chứng kiến kiểm tra và cung cấp các lệnh và tùy chọn để chạy một [chứng kiến độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/). **Các công cụ khác → Phần Tham số** chứa mọi giới hạn và tốc độ của không gian làm việc không được liệt kê trên các trang khác: số lượng cuộc trò chuyện được đọc, tần suất làm mới danh sách trò chuyện, khoảng thời gian kiểm tra nhịp tim và điểm kiểm tra, bộ đệm khởi động, cách các yêu cầu kiểm tra lại được phân bổ (thời gian trễ ban đầu, số cuộc trò chuyện mỗi lần, thời gian tạm dừng giữa các cuộc trò chuyện, tin nhắn được khôi phục và yêu cầu lại), dung lượng đĩa dự phòng, thời gian chờ và số lần thử lại khi tải xuống, các tiêu chí tìm kiếm trong hồ sơ người dùng (bao gồm cả biểu thức chính quy của riêng bạn), kích thước và tần suất thông báo, giới hạn bản chụp nhanh, ZIP và tải xuống qua trình duyệt, cũng như thời gian chờ và số lần thử lại của ứng dụng Telegram. Mỗi trường hiển thị phạm vi và giá trị mặc định; các trường đã thay đổi được đánh dấu và có thể khôi phục từng trường một hoặc tất cả cùng lúc. Mọi thay đổi đều được ghi lại dưới dạng ``parameters.changed`` kèm theo các giá trị trước và sau, và các bản ghi bắt đầu theo dõi sẽ ghi lại các giá trị hiện hành. Các giá trị có hiệu lực từ lần sử dụng tiếp theo; thời gian chờ và số lần thử lại của ứng dụng sẽ áp dụng từ lần kết nối tiếp theo. Khoảng thời gian kiểm tra lại, loại và kích thước tệp đính kèm, bằng chứng và khoảng thời gian sao lưu ngoài trang web vẫn nằm trên các trang riêng biệt và có thể nhận bất kỳ giá trị nào trong phạm vi cho phép, không chỉ giới hạn ở các cài đặt sẵn. Biểu tượng chuông ở thanh trên cùng liệt kê các sự cố và thay đổi gần đây trong các cuộc trò chuyện được theo dõi; các tin nhắn chưa đọc sẽ được tính cho đến khi được đánh dấu là đã đọc. Các thay đổi được nhóm theo từng cuộc trò chuyện và theo giờ (“12 tin nhắn đã bị xóa, 1 tin nhắn đã được chỉnh sửa, 0 tin nhắn không tìm thấy”), và các sự cố như đăng xuất hoặc ổ đĩa đầy vẫn được giữ lại trong danh sách bất kể các cuộc trò chuyện có bận rộn đến mức nào. **Các công cụ khác → Tài khoản** bắt đầu từ trường số điện thoại. **Tiếp tục** sẽ dẫn trực tiếp đến mục nhập mã, chỉ yêu cầu thông tin đăng nhập API khi chưa có. Nhập qua QR và tệp là các tab thay thế. Thông tin đăng nhập API đã lưu chỉ được tái sử dụng trong chính không gian làm việc của chúng. Màn hình nhập liệu không có thanh bên, thống kê hoặc các phần cài đặt. Biểu tượng **Cài đặt** mở các tùy chọn điều khiển API, proxy, lưu trữ và tài khoản bổ sung. Một không gian làm việc mới sẽ mở [màn hình thiết lập ban đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/) ; sau khi đăng nhập, một không gian làm việc có các nguồn và bản ghi đã lưu sẽ mở **phần Trò chuyện** . Việc thay đổi lộ trình yêu cầu tạm dừng quan sát và hủy bỏ quá trình đăng nhập chưa hoàn tất. Một nhật ký hiện có không thể được liên kết lại một cách im lặng với một tài khoản Telegram khác. **Tính năng xuất** kiểm tra tính toàn vẹn của nhật ký và tạo ra các tệp có thể di chuyển. ID không gian làm việc của nó có thể được truyền vào CLI tải xuống. Mỗi lần xuất đều cố định một tiền tố nhật ký đầy đủ; các sự kiện sau đó sẽ được đưa vào lần xuất tiếp theo. Các bộ lọc tìm kiếm không thay đổi phạm vi gói. Thông tin chi tiết về việc ký và phạm vi bao phủ nằm trong **phần Xác minh và bằng chứng**. Bảng điều khiển hiển thị trạng thái bộ thu thập, các tệp phương tiện đang xếp hàng/bị lỗi, tệp phương tiện đang chờ xử lý lâu nhất, dung lượng đĩa trống, các yêu cầu tạm dừng và các nguồn chưa được xác nhận quyền truy cập trong **phần Tình trạng bộ thu thập**. Các chi tiết này ban đầu được thu gọn và ẩn đi trên trang Tài khoản. Một thẻ hướng dẫn thiết lập sẽ hiển thị bước tiếp theo: kết nối tài khoản, chọn nguồn hoặc bắt đầu theo dõi. Danh sách tài khoản là bản chụp nhanh tại thời điểm tải; không gian làm việc đã chọn sẽ được làm mới định kỳ. Đây không phải là công cụ giám sát SLA đa quy trình. Giao diện dùng tài nguyên cục bộ và hiển thị dạng văn bản cho nội dung nguồn. Bố cục máy tính và bố cục hẹp trên Chromium đã được kiểm thử. ## Môi trường triển khai | Môi trường | Cài đặt | Tình trạng xác minh | | --- | --- | --- | | Máy tính cá nhân/máy chủ Windows | Python 3.11 trở lên, scripts\Setup.cmd/Start.cmd, thư mục dữ liệu riêng tư | Đã được kiểm tra tại địa phương trên hệ điều hành Windows/Python 3.12 | | Máy chủ Linux/VPS | Môi trường ảo Python (venv), người dùng dịch vụ chuyên dụng, HTTPS/SSH | Cung cấp mã nguồn, CI và ví dụ về systemd; không được thực thi trên máy chủ này | | macOS | Môi trường ảo Python (venv), tiến trình nền trước hoặc trình duyệt | Ví dụ về launchd được cung cấp; cần thực hiện kiểm tra cài đặt riêng biệt | | Docker/Compose | Khối lượng dữ liệu ổn định, một nhân viên | Cung cấp định nghĩa và tính năng kiểm tra thời gian chạy CI; Docker không khả dụng tại địa phương | | Trình duyệt trên điện thoại | Kết nối với bảng điều khiển được bảo vệ trên máy chủ đang hoạt động | Đã thử nghiệm với bố cục Chromium thu gọn; trình thu thập dữ liệu không hoạt động trên iOS/Android | Khả năng di động có nghĩa là không bắt buộc phải sử dụng dịch vụ đám mây hay xây dựng giao diện người dùng. Mỗi hệ thống đích vẫn cần có các phụ thuộc Python/mã hóa tương thích, ổ đĩa cục bộ và quyền truy cập mạng. Vui lòng tham khảo [tệp DEPLOYMENT.md](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) và [các mẫu dịch vụ](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Các không gian làm việc chia sẻ CPU, bộ nhớ và vòng lặp sự kiện. Để cách ly các tiến trình, hãy sử dụng các phiên bản, cổng, thư mục dữ liệu và quyền truy cập tài khoản riêng biệt. Không có bảng điều khiển thống nhất giữa các phiên bản riêng biệt. Tuyệt đối không được chỉ định nhiều tiến trình làm việc truy cập cùng một cơ sở dữ liệu. ## Kiểm tra và xuất dữ liệu ban đầu Chạy lệnh `python start.py --check` trước khi khởi động môi trường đã chuẩn bị. Thêm tham số `--json` để thực hiện kiểm tra dưới dạng dữ liệu máy đọc được hoặc truyền các tham số `--data-dir`, `--host` và `--port` theo ý định. Lệnh này kiểm tra các điều kiện tiên quyết mà không cần đăng nhập Telegram hoặc tạo nhật ký. Quá trình xác minh nhật ký diễn ra trong quá trình khởi động ứng dụng, và trạng thái sẵn sàng ghi nhận sẽ hiển thị trên bảng điều khiển. Cổng bị chiếm dụng có thể chỉ là một phiên bản hiện có. Các trình duyệt hỗ trợ API Truy cập Hệ thống Tệp sẽ lưu các tệp xuất thông qua một luồng dữ liệu có thể ghi . Các trình duyệt khác chỉ lưu trữ tạm thời tối đa 128 MiB. Vui lòng sử dụng CLI truyền luồng cho các tệp xuất có dung lượng lớn hơn hoặc đối với các trình duyệt không hỗ trợ truyền tệp: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Thêm mã `--profile ID` từ mục Xuất để tạo không gian làm việc con. Sử dụng mã `--url https://server` để truy cập từ xa. Giao thức HTTP thuần túy chỉ được chấp nhận đối với các đích loopback. Mã thông báo được đọc từ tệp và gửi trong tiêu đề, không được hiển thị trên màn hình hay đưa vào URL. Các yêu cầu chuyển hướng sẽ bị từ chối. Các đích hiện có sẽ không bị ghi đè. Các lần truyền dữ liệu thất bại sẽ xóa tệp tạm thời tương ứng. Giá trị SHA-256 được báo cáo là tổng kiểm tra của quá trình truyền; quý vị cần xác minh tệp ZIP đã ký một cách riêng biệt bằng dấu vân tay/điểm kiểm tra đáng tin cậy. ## Sao lưu, khôi phục và các sự cố gián đoạn 1. Tạm dừng quá trình quan sát và dừng quy trình một cách triệt để. 2. Sao chép toàn bộ thư mục dữ liệu: cơ sở dữ liệu, WAL/SHM (nếu có), tệp phương tiện, `credentials.enc`, `signing.enc`, `network.enc`, khóa kho lưu trữ/siêu dữ liệu, mã thông báo, các điểm kiểm tra và mọi thư mục `profiles/`. 3. Đối với chế độ khóa bên ngoài, hãy bảo quản riêng biệt khóa chính và lưu giữ từng khóa `vault.external.json`. Việc tạo khóa mới sẽ không thể khôi phục các thông tin bí mật cũ. 4. Khôi phục dữ liệu trong khi đích đang bị tạm dừng; cấu hình khóa gốc, hạn chế quyền truy cập và xác minh tính toàn vẹn trước khi tiếp tục. 5. Ghi lại thời gian ngừng hoạt động và kết quả xác minh. Thời gian ngừng hoạt động vẫn là khoảng trống đã được ghi lại; một bản chụp lịch sử sẽ bổ sung trạng thái sau khoảng trống đó. Evidence ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/#updates-and-backups). Four things are protected differently: | Nội dung | Bảo vệ | | --- | --- | | Tệp xuất không có mật khẩu (mặc định) | Đã được ký số, nên mọi thay đổi đều phát hiện được; đặt mật khẩu để mã hóa bản xuất | | Tệp xuất có mật khẩu | Nếu quý vị đặt mật khẩu, tệp xuất hoàn chỉnh sẽ được lưu nguyên vẹn dưới dạng tệp ZIP được mã hóa bằng AES-256 của WinZip mà 7-Zip và WinRAR đều có thể mở được; mật khẩu sẽ không được lưu trữ ([quy trình xử lý bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/)) | | Cơ sở dữ liệu nhật ký và các tệp đính kèm được lưu trữ trên đĩa | Ổ đĩa hoặc phân vùng được mã hóa và quyền truy cập thư mục | | Các phiên Telegram và khóa ký | Được mã hóa trong thư mục dữ liệu (`credentials.enc`, `signing.enc`, `network.enc`) | Sao lưu toàn bộ dịch vụ là thư mục dữ liệu đã được lưu trữ như mô tả ở trên, chứ không phải là tệp xuất. Vui lòng sử dụng bộ nhớ được bảo vệ và cơ chế truyền tải có chủ đích cho cả hai trường hợp. Các tệp xuất tạm thời trên máy chủ được lưu trữ trong thư mục `temporary-exports/` của từng không gian làm việc; các phản hồi đã hoàn tất sẽ được xóa, còn các tệp xuất bị gián đoạn sẽ bị loại bỏ vào lần khởi động tiếp theo trong khi khóa phiên bản của không gian làm việc đó vẫn còn hiệu lực. Sau sự kiện khôi phục kết nối, bộ thu thập yêu cầu các bản cập nhật bị bỏ lỡ từ vị trí cập nhật đã lưu. Các tác vụ phương tiện bền vững và vị trí cập nhật Telegram vẫn tồn tại sau khi khởi động lại; xem [định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#durable-collection-and-process-receipts-02). ## Dung lượng và thời gian lưu trữ Giới hạn mặc định, tất cả đều có thể thay đổi trong **Công cụ khác → Tham số**: 1,000 cuộc đối thoại đầu tiên, 500 tin nhắn cho mỗi bản chụp nhanh, 4 GiB nội dung ZIP đã ký không nén (các tệp lưu trữ lớn hơn cần `verify.py --max-gib N`) và 128 MiB dự phòng trình duyệt. Tệp đính kèm chiếm 1–2,000 MiB cho mỗi loại trong **Công cụ khác → Nguồn → Ghi lại → Tệp đính kèm**. Giao diện dòng lệnh (CLI) tải xuống mặc định là 5 GiB dữ liệu được chuyển. Dung lượng đĩa khả dụng có thể là giới hạn thấp hơn. Dành dung lượng cho nhật ký, phương tiện, WAL, các tệp xuất tạm thời và bản sao lưu. Các tệp xuất sử dụng khối lượng dữ liệu thay vì thư mục 512 MiB `/tmp` của Compose. Đo lường số sự kiện/giây, tuổi hàng đợi, số byte phương tiện và độ trễ đĩa thay vì chỉ đếm các nhóm. Việc phân phối trực tiếp được đo lường trên bộ thu đang chạy. Không có cơ chế xóa tự động khi hết thời hạn lưu trữ. Việc xóa phần cuối của nhật ký sẽ làm mất hiệu lực mối quan hệ của nó với các điểm kiểm tra được lưu trữ. Kiểm tra lại ưu tiên đã có sẵn: các nguồn gắn sao mặc định được kiểm tra lại mỗi 15 phút, các nguồn khác mỗi 6 giờ (xem [các cấp kiểm tra lại](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#recheck-tiers)). Xuất dữ liệu có mật khẩu hoạt động như mô tả ở trên. Quyền truy cập giới hạn được mô tả trong [truy cập và quyền hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/access/). Xem [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md), [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) và [VERIFICATION.md](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/). --- # Telegram · Chế độ điều tra Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/ Các cuộc điều tra toàn diện về tài khoản trên các kênh, nhóm, cuộc trò chuyện riêng tư và bot, từ phạm vi điều tra cho đến bộ hồ sơ vụ việc đã được xác minh. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Các cuộc điều tra toàn diện về tài khoản trên các kênh, nhóm, cuộc trò chuyện riêng tư và bot, từ phạm vi điều tra cho đến bộ hồ sơ vụ việc đã được xác minh. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Điều tra](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Theo dõi một vụ việc qua các kênh, nhóm, cuộc trò chuyện riêng tư và bot, từ giai đoạn thu thập ban đầu cho đến dòng thời gian được trích dẫn và quá trình chuyển giao có thể xác minh. Phiên bản trang web tương tác có tại `/docs/cases/`; [hướng dẫn xem trước](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally). **Trên trang này** - [Trường hợp đã được kiểm chứng: địa chỉ đích thay đổi qua bốn cuộc trò chuyện](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#worked-case-a-destination-changes-across-four-conversations) - [1. Xác định trường hợp và thu thập toàn bộ thông tin](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#1-define-the-case-and-collect-the-whole-account) - [2. Liệt kê tất cả các nguồn và thu thập bối cảnh lịch sử](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#2-inventory-every-source-and-acquire-historical-context) - [3. Giữ nguyên bối cảnh phát triển và các tương tác có chủ đích](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#3-preserve-the-evolving-case-and-deliberate-interactions) - [4. Kết nối các quan sát giữa các cuộc trò chuyện](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#4-connect-observations-across-chats) - [5. Xây dựng dòng thời gian liên cuộc trò chuyện](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#5-build-the-cross-chat-timeline) - [6. Thêm góc nhìn tài khoản mà không làm mất nguồn gốc của chúng](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#6-add-account-perspectives-without-losing-their-origin) - [7. Tổng hợp và xác minh việc chuyển giao vụ việc](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#7-assemble-and-verify-the-case-handoff) - [Thích ứng quá trình điều tra](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/#adapt-the-investigation) ## Ví dụ thực tế: sự thay đổi về điểm đến trong bốn cuộc trò chuyện Một thông báo trỏ đến một bot. Một nhóm vận hành thảo luận về một điểm đến thanh toán mới, và bàn phím của bot hiển thị thông tin đó. Thông báo được chỉnh sửa, một tin nhắn riêng tư tiếp theo nhắc lại điểm đến, và một tin nhắn nhóm biến mất. Các câu hỏi đặt ra là: những gì đã được quan sát trước và sau khi thay đổi, tài khoản Telegram nào đã đăng từng nội dung, đích đến xuất hiện ở đâu, các byte tệp đính kèm nào đã được lưu giữ, và những khoảng thời gian nào vẫn chưa được xác định? Tất cả tên, ID, thời gian và các tham chiếu trong sổ ghi chép trong ví dụ này đều là hư cấu. Quy trình làm việc sử dụng các tính năng hiện có; sơ đồ vụ việc chỉ mang tính minh họa, không phải là biểu đồ tự động được tạo ra bởi ứng dụng. Sơ đồ quy trình · Các kênh → Nhật ký không gian làm việc; Các nhóm → Nhật ký không gian làm việc; Các cuộc trò chuyện riêng tư → Nhật ký không gian làm việc; Các bot → Nhật ký không gian làm việc; Nhật ký không gian làm việc → Tìm kiếm trên tất cả các nguồn; Nhật ký không gian làm việc → Hồ sơ cá nhân kèm theo các tham chiếu đến hồ sơ ghi chép; Nhật ký không gian làm việc → Các phiên bản đã lưu và biên nhận tệp đính kèm; Tìm kiếm trên tất cả các nguồn → Dòng thời gian của nhà phân tích và sổ đăng ký nguồn; Hồ sơ cá nhân kèm theo các tham chiếu đến hồ sơ ghi chép → Dòng thời gian của nhà phân tích và sổ đăng ký nguồn; Các phiên bản đã lưu và biên nhận tệp đính kèm → Dòng thời gian của nhà phân tích và sổ đăng ký nguồn; Nhật ký không gian làm việc → Tệp ZIP chứa bằng chứng đã được ký xác thực; Dòng thời gian của nhà phân tích và sổ đăng ký nguồn → Chuyển giao vụ việc kèm theo các bằng chứng đã được xác minh riêng biệt; Tệp ZIP chứa bằng chứng đã được ký xác thực → Chuyển giao vụ việc kèm theo các bằng chứng đã được xác minh riêng biệt · Các kênh · Các nhóm · Các cuộc trò chuyện riêngtư · Các bot · Nhật ký không gian làmviệc · Tìm kiếm trên tất cả cácnguồn · Hồ sơ cá nhân kèm theo cáctham chiếu đến hồ sơ ghichép · Các phiên bản đã lưu vàbiên nhận tệp đính kèm · Tệp ZIP chứa bằng chứng đãđược ký xác thực · Dòng thời gian của nhàphân tích và sổ đăng kýnguồn · Chuyển giao vụ việc kèmtheo các bằng chứng đãđược xác minh riêng biệt **Sơ đồ dưới dạng văn bản** 1. Các kênh → Nhật ký không gian làm việc 2. Các nhóm → Nhật ký không gian làm việc 3. Các cuộc trò chuyện riêng tư → Nhật ký không gian làm việc 4. Các bot → Nhật ký không gian làm việc 5. Nhật ký không gian làm việc → Tìm kiếm trên tất cả các nguồn 6. Nhật ký không gian làm việc → Hồ sơ cá nhân kèm theo các tham chiếu đến hồ sơ ghi chép 7. Nhật ký không gian làm việc → Các phiên bản đã lưu và biên nhận tệp đính kèm 8. Tìm kiếm trên tất cả các nguồn → Dòng thời gian của nhà phân tích và sổ đăng ký nguồn 9. Hồ sơ cá nhân kèm theo các tham chiếu đến hồ sơ ghi chép → Dòng thời gian của nhà phân tích và sổ đăng ký nguồn 10. Các phiên bản đã lưu và biên nhận tệp đính kèm → Dòng thời gian của nhà phân tích và sổ đăng ký nguồn 11. Nhật ký không gian làm việc → Tệp ZIP chứa bằng chứng đã được ký xác thực 12. Dòng thời gian của nhà phân tích và sổ đăng ký nguồn → Chuyển giao vụ việc kèm theo các bằng chứng đã được xác minh riêng biệt 13. Tệp ZIP chứa bằng chứng đã được ký xác thực → Chuyển giao vụ việc kèm theo các bằng chứng đã được xác minh riêng biệt ## 1. Xác định vụ việc và thu thập toàn bộ diễn biến sự việc 1. Kết nối tài khoản thu thập dữ liệu trong không gian làm việc riêng của nó. Trong [Case Board](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/) hoặc sổ đăng ký vụ việc của bạn, ghi lại mã tham chiếu vụ việc, ID tài khoản, không gian làm việc và thời điểm bắt đầu quan sát. Lưu giữ riêng biệt dấu vân tay khóa ký tin cậy. 2. Đối với tài khoản thu thập chuyên dụng, hãy mở **Công cụ khác → Nguồn → Phạm vi → Chế độ điều tra**. Cài đặt mặc định chọn **Toàn bộ tài khoản**, các kênh/nhóm/cuộc trò chuyện riêng tư/bot, hành động của chính người dùng, hồ sơ nguồn và 200 tin nhắn hiển thị gần nhất từ các nguồn mới được phát hiện. Kiểm tra lại, nhấn **Lưu phạm vi** và hoàn tất xác nhận phạm vi. Các tài khoản chính sử dụng các cuộc trò chuyện đã chọn hoặc một thư mục; việc thu thập toàn bộ tài khoản chỉ có sẵn cho các tài khoản được đánh dấu để điều tra. 3. **Tải các cuộc trò chuyện** và so sánh các nguồn với danh sách cuộc trò chuyện của tài khoản. Kiểm tra các trường hợp loại trừ. **Công cụ khác → Thông số → Số lượng cuộc trò chuyện được đọc từ danh sách tài khoản** mặc định là 1,000 và cho phép tối đa 20,000. Các nguồn vượt quá giới hạn danh sách sẽ được thêm vào khi chúng trở nên hoạt động. Ghi lại những gì thực sự đã được liệt kê. 4. Trong **phần Công cụ khác → Nguồn → Ghi lại**, chọn **Tất cả hoạt động hiển thị** và lưu các cài đặt giám sát. Kiểm tra các loại tệp đính kèm/giới hạn và dung lượng đĩa trống. 5. Bắt đầu quá trình quan sát. Xác thực một tin nhắn mới được kiểm soát, các thao tác chỉnh sửa và xóa, sau đó lưu giữ các tham chiếu thử nghiệm cùng mọi lỗi phát sinh. Phạm vi toàn tài khoản ghi lại các hoạt động mà tài khoản có thể nhìn thấy trong các cài đặt đã lưu, trong các cuộc trò chuyện mà tài khoản đã tham gia. Các Cuộc trò chuyện bí mật được ghi lại bởi [mô-đun Cuộc trò chuyện bí mật](https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/), và các cuộc trò chuyện hiện có được bổ sung thông qua [Lịch sử](https://phishdestroy.io/tgwitness/vi/docs/reference/history/). Xem [phạm vi thu thập](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account). ## 2. Lập danh mục tất cả các nguồn và thu thập bối cảnh lịch sử Quản lý sổ đăng ký nguồn với mỗi cuộc trò chuyện được ghi vào một hàng riêng biệt: | Lĩnh vực | Ghi lại | | --- | --- | | Thông tin nhận diện | Không gian làm việc, ID tài khoản, ID cuộc trò chuyện dạng số, tiêu đề và loại | | Khả năng hiển thị | Tư cách thành viên/vai trò, quyền truy cập đã được xác nhận hoặc chưa được xác nhận, các trường hợp loại trừ | | Ghi lại theo thời gian thực | Thời điểm bắt đầu, các loại sự kiện được chọn và những thay đổi về chính sách sau này | | Lịch sử nhật ký | Yêu cầu/hoàn tất bản chụp nhanh, giới hạn, thời gian và các tham chiếu bản ghi | | Lịch sử đầy đủ | Tên tệp xuất theo từng cuộc trò chuyện có chữ ký, phạm vi và trạng thái hoàn tất/thất bại | | Tệp đính kèm | Các thông tin về biên nhận phương tiện truyền thông đã hoàn tất, mã băm, kích thước cũng như các kết quả bị bỏ qua hoặc không thành công | | Phạm vi bao quát | Các sự cố ngừng hoạt động, dữ liệu thu thập không đầy đủ, FloodWait, tin nhắn không khả dụng và các lỗ hổng khác | Sử dụng phương thức thu thập phù hợp cho từng nguồn: - **Tải lịch sử đầy đủ** trong **More tools → Sources → Chats in scope** sẽ tải các tin nhắn trong quá khứ có sẵn từ các nguồn đã bật vào nhật ký không gian làm việc. Tính năng này hỗ trợ tạm dừng/tiếp tục và báo cáo tiến trình có chữ ký. Xem [phần thu thập lịch sử](https://phishdestroy.io/tgwitness/vi/docs/reference/history/). - **Bản chụp lịch sử** lưu các tin nhắn hiển thị gần đây vào nhật ký quan sát. Giá trị tối đa mặc định là 500; tại **Công cụ khác → Thông số → Bản chụp lịch sử lớn nhất,** bạn có thể tăng con số này lên 10,000. Đây là các quan sát lịch sử hiện tại, không phải các bản chỉnh sửa được tái tạo. - **Xuất → Ghi lại hoặc xuất một cuộc trò chuyện → Xuất toàn bộ cuộc trò chuyện**, hoặc **Cuộc trò chuyện → Xuất cuộc trò chuyện**, sẽ lấy lịch sử hiện đang hiển thị của một cuộc trò chuyện vào một gói riêng biệt đã được ký là `chat.json` / `chat.html`. Lặp lại quy trình này cho các nguồn của vụ việc và lưu giữ từng kết quả. - **Khi một cuộc trò chuyện hoặc bot mới xuất hiện,** hệ thống có thể lưu lại hồ sơ của nó cùng tối đa 1.000 tin nhắn gần đây; chế độ Điều tra sẽ chọn 200 tin nhắn. Các cuộc trò chuyện hiện có sẽ không được lưu lại các tin nhắn đó một cách hồi tố khi chế độ này được kích hoạt. - **Việc tải xuống các tệp đính kèm hiển thị** sẽ lưu giữ số byte theo chính sách đã cấu hình. Yêu cầu phải có biên nhận `media.saved` hoàn chỉnh kèm theo mã SHA-256 và số byte. Một tác vụ đang chờ xử lý, hình thu nhỏ hoặc tên tệp không được coi là tệp đính kèm được lưu giữ. Việc xuất toàn bộ cuộc trò chuyện sẽ **không** tự động điền vào sổ ghi chép hoặc hồ sơ người dùng tất cả các tin nhắn của cuộc trò chuyện đó. Hãy sử dụng **tính năng “Tải toàn bộ lịch sử”** hoặc các bản chụp nhanh có giới hạn của sổ ghi chép để lấy lịch sử bạn cần phân tích trong TgWitness. Kiểm tra danh sách nguồn đã kích hoạt trước khi bắt đầu quá trình xử lý lịch sử. Cả hai phương pháp này đều không khôi phục được nội dung mà Telegram không còn cung cấp nữa. ## 3. Lưu giữ diễn biến của vụ việc và các tương tác có chủ đích Đánh dấu các cuộc trò chuyện liên quan đến vụ việc đang diễn ra làm nguồn ưu tiên. Rà soát khoảng thời gian kiểm tra lại, quá trình bổ sung dữ liệu liên tục và kết quả liên quan đến phương tiện truyền thông. Duy trì hoạt động theo dõi của trình thu thập dữ liệu trong suốt quá trình sử dụng tài khoản. Sử dụng **Chats → Profile → Save profile now** để lưu giữ siêu dữ liệu nguồn như mô tả và lệnh bot. Thông tin này độc lập với hồ sơ cá nhân được trích xuất từ các tin nhắn đã lưu. Trong trường hợp liên quan đến việc theo dõi một nguồn tin hoặc tương tác với một bot: 1. **Mở liên kết Telegram → Lưu bản xem trước** sẽ ghi lại liên kết được cung cấp và bản xem trước hiển thị trước khi thực hiện hành động. 2. **Lệnh "Join / open and observe"** thực hiện thao tác tham gia/mở và gửi tham số khởi động của bot khi được cung cấp. Yêu cầu tham gia đang chờ phê duyệt sẽ được ghi lại với trạng thái "đang chờ xử lý". 3. Các phản hồi văn bản do bảng điều khiển phát ra và các thao tác nhấn nút được hỗ trợ sẽ giữ nguyên mã `interaction.requested` và `interaction.result`. Biên nhận phản hồi có thể lưu giữ văn bản cửa sổ bật lên được trả về, trạng thái cảnh báo và URL. Đó là các hành động thực tế trên tài khoản. Các thao tác nhấn nút gọi lại trong một ứng dụng Telegram khác sẽ không hiển thị với trình thu thập dữ liệu, mặc dù các tin nhắn hoặc thao tác chỉnh sửa phát sinh từ đó có thể được ghi lại. Ứng dụng khách thu nhỏ (mini-client) không thực hiện các quy trình liên quan đến ứng dụng web, thanh toán, điện thoại hoặc vị trí. Để biết chi tiết về cách thức hoạt động, vui lòng tham khảo [phần tương tác với bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#act-from-the-panel). ## 4. Liên kết các quan sát giữa các cuộc trò chuyện Trong mục **Journal**, hãy chọn **“Tất cả nguồn”** và tìm kiếm nội dung đã được ghi lại. Mở các bản ghi phù hợp và lưu lại không gian làm việc, cuộc trò chuyện, ID tin nhắn, thứ tự cũng như mã băm của bản ghi. Trong một cuộc trò chuyện liên quan, hãy mở **mục “Người dùng” → “Bật hồ sơ”** và kiểm tra thông tin của một người dùng: - Các tên/tên người dùng được ghi nhận theo thời gian và mã định danh số (ID) trên Telegram. - Các mối quan hệ phản hồi kèm theo tham chiếu đến bản ghi nguồn. - **Ngoài ra còn có…** các cuộc trò chuyện khác trong nhật ký không gian làm việc này mà ID đó đã tham gia. - Hoạt động, các thao tác chỉnh sửa/xóa cũng như các ví, số điện thoại, tên người dùng và liên kết được đề cập. - Dữ liệu siêu dữ liệu của ảnh đại diện đã lưu và các ảnh đại diện tương tự được lưu trong bộ nhớ đệm, kèm theo nguồn gốc riêng biệt của từng ảnh. Mở các bản ghi được trích dẫn trước khi sử dụng hồ sơ phái sinh trong một kết luận. Hồ sơ bao gồm những người có tin nhắn được lưu, không phải mọi thành viên trong nhóm. **Thêm công cụ → Thông số → Bản ghi được trích dẫn theo sự kiện** giới hạn danh sách tham chiếu, không phải số lượng hoạt động cơ bản. Các đề cập và độ tương đồng avatar là manh mối; quyền sở hữu và danh tính dựa trên ID số và người gửi được gán. Hồ sơ đã ký tách các gợi ý mã hóa khỏi các tệp được chuyển tiếp và tái sử dụng thành hai nhóm: ` `clients.forwarded`` và ``clients.reused``. Các tệp này không được tính vào ` `clients.observed`` hoặc danh sách ``media_timing.pre_existing``. Một tệp được tái sử dụng có nghĩa là cùng một ID tài liệu Telegram đã được phát hiện trong một tin nhắn khác trước đó trong nhật ký này, trong phạm vi các cuộc trò chuyện được phép của người đọc. Bản ghi đầu tiên được phát hiện sẽ được trích dẫn; việc phát hiện hoặc chỉnh sửa lần nữa cùng một tin nhắn đó không được coi là tái sử dụng. Phần `paid_reactions` của hồ sơ lưu giữ bảng xếp hạng Stars mới nhất hiện có cho từng tin nhắn được liệt kê, kèm theo các bản ghi nguồn và cờ đánh dấu ẩn danh. Đây là số liệu tại thời điểm chụp nhanh, không phải tổng số các khoản thanh toán bổ sung hay danh sách đầy đủ những người đã phản hồi. Một bản chụp nhanh không có bảng xếp hạng sẽ không cung cấp danh sách thay thế nào. Phần này sẽ thông báo về các tin nhắn bị bỏ qua khi đạt đến giới hạn hiển thị. Danh sách theo dõi và các tệp xuất chỉ báo sẽ kiểm tra nhãn nút, URL, văn bản sao chép, truy vấn nội tuyến và các byte callback được giải mã thành định dạng UTF-8 hợp lệ. Các mã hóa callback không hợp lệ hoặc vượt quá kích thước sẽ bị bỏ qua trong quá trình trích xuất văn bản; các byte gốc vẫn được giữ lại trong bản ghi đã lưu. Các danh sách theo dõi hiện có cần được quét lại để kiểm tra các bản ghi cũ với các trường bổ sung này. Quá trình kiểm tra không nhấn nút. Trong ví dụ minh họa: | Liên kết | Ghi lại | Quan sát được hỗ trợ | | --- | --- | --- | | Cùng một tài khoản người gửi | Nhóm #146 và cuộc thảo luận riêng tư tiếp theo #205 | Cả hai đều cung cấp ID người gửi Telegram là 71001 | | Cùng một đích đến | #146, bàn phím bot #173, chỉnh sửa kênh #188, tin nhắn riêng tư #205 | Tất cả đều chứa `pay.example.invalid/new`; một đích lặp lại liên kết đến tài liệu | | Tệp lưu trữ tương tự | Đã hoàn tất các biên nhận phương tiện truyền thông số #151 và #209 | Các giá trị SHA-256 đầy đủ trùng khớp với các byte được lưu giữ | | Nguồn thông tin kênh | #101 và #188 | Không được quy cho người dùng 71001 là tác giả của bài đăng trên kênh nếu không có thông tin xác định người gửi | So sánh các giá trị băm của tệp đính kèm và các tham chiếu tin nhắn liên quan, đồng thời sắp xếp dòng thời gian tài khoản theo các ID Telegram được cung cấp trong các bản ghi đó. Lưu giữ các ghi chú làm việc của nhóm trên [Case Board](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/): đánh dấu các bản ghi mà bạn dựa vào, chẳng hạn như #146, #188 và #205, đánh dấu chuỗi đích chính xác, và lưu một đoạn của mọi hành động được ghi lại giữa hai bản ghi hoặc trong một khoảng thời gian. Các ghi chú và trạng thái lưu giữ quá trình rà soát của nhóm trong lịch sử đã ký riêng biệt, có thể nhận diện độc lập với các quan sát từ nguồn. ## 5. Xây dựng dòng thời gian liên cuộc trò chuyện Sử dụng các phiên bản đã lưu trong **phần Trò chuyện** cùng các liên kết **bản ghi Nhật ký #…** tương ứng. Trong **Nhật ký**, kết hợp **Tất cả các nguồn** với **các thao tác Chỉnh sửa**, **Xóa bỏ** và **Phạm vi ghi nhận**. Giữ lại cả mã `source_at` (nếu có) và mã `observed_at`. | Thời gian quan sát minh họa | Tham khảo | Quan sát | | --- | --- | --- | | 09:00 | Kênh #101 | Địa chỉ đích ban đầu đã được ghi lại | | 09:12 | Nhóm #146; phương tiện truyền thông #151 | Đã đăng tải địa chỉ đích mới; quá trình tải xuống tệp đã hoàn tất | | 09:16 | Bot số 173 | Bàn phím chỉ đến đích mới | | 09:20 | Kênh #188 | Thông báo đã được chỉnh sửa; cả hai phiên bản đã lưu đều được giữ lại | | 09:24 | Tư nhân #205; phương tiện truyền thông #209 | ID người gửi trùng khớp với địa chỉ nhận; các byte của tệp được giữ nguyên | | 09:28 | Nhóm #231 | Đã nhận được thông báo xóa; người xóa và thời gian xóa chính xác hiện chưa được xác định | Các bản ghi khác có thể xuất hiện giữa các tham chiếu ví dụ này. Số thứ tự sắp xếp các quan sát; các bản chụp lịch sử có thể chứa ngày nguồn cũ hơn và được gửi đến muộn hơn so với các sự kiện đang diễn ra. Hãy phân biệt rõ các bản chụp, tin nhắn đã khôi phục, thông báo xóa và kết quả “không tìm thấy khi kiểm tra lại”. Đánh dấu các khoảng trống trong phạm vi ghi nhận là các khoảng thời gian chưa xác định. Việc thu thập lịch sử sau này không có nghĩa là xác lập được việc quan sát liên tục một cách hồi tố. ## 6. Thêm các góc nhìn từ tài khoản mà không làm mất nguồn gốc của chúng Hãy sử dụng một không gian làm việc riêng biệt cho từng tài khoản khác nhau và lặp lại quy trình kiểm kê đối với từng tài khoản đó. Lưu giữ ID tài khoản, vai trò, dấu vân tay khóa ký và các tham chiếu nguồn trong mỗi lần so sánh. Số tin nhắn không phải là mã định danh chung cho tất cả các cuộc trò chuyện/tài khoản. Case Board lưu giữ các ghi chú và bộ sưu tập được liên kết với nguồn trong mỗi không gian làm việc. Màn hình nhóm xem xét tình trạng tài khoản cùng nhau và có thể gộp các tệp xuất từ các không gian làm việc riêng biệt. Hãy liên kết các nguồn đó trong ghi chú vụ việc hoặc công cụ phân tích của bạn; mỗi nhật ký vẫn giữ nguyên nguồn gốc và khóa ký của riêng mình. Tìm kiếm toàn cầu hoặc dòng thời gian hợp nhất giữa các không gian làm việc sẽ không được tạo ra. Việc xuất dữ liệu nhiều tài khoản từ một kênh/siêu nhóm sẽ thu thập lịch sử trò chuyện đó bằng cách sử dụng các tài khoản đủ điều kiện. Đối với các công việc có quy mô lớn hơn, cần duy trì sự tách biệt với một [nhân chứng độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/). Sử dụng các kiểm tra giao nhận có kiểm soát để xác minh đường dẫn thu thập và phạm vi hiển thị của từng tài khoản. ## Tần suất xuất hiện trên phương tiện truyền thông và các nguồn chia sẻ lại Các báo cáo bằng chứng so sánh riêng biệt các ID tài liệu Telegram và các giá trị băm SHA-256 từ các bản ghi tệp đã lưu. Chúng hiển thị các tin nhắn, cuộc trò chuyện riêng biệt cùng với lần xuất hiện đầu tiên và cuối cùng được lưu giữ, kèm theo dòng thời gian quan sát có thể mở rộng dưới dạng HTML. Các bản chụp nhanh hoặc chỉnh sửa lặp lại của cùng một tin nhắn sẽ không làm tăng số lần xuất hiện cho cùng một khóa. Một tệp khác trong tin nhắn đã chỉnh sửa sẽ giữ nguyên số lần xuất hiện riêng của nó. "Lần đầu tiên được ghi nhận" tuân theo thứ tự trên tạp chí trong phạm vi lựa chọn báo cáo. Điều này không có nghĩa là đây là bài báo đầu tiên được công bố trên Telegram. Mã định danh tài liệu (Document ID) dùng để xác định các tài liệu trên Telegram; SHA-256 so sánh các byte đã lưu. Các giá trị dHash 64-bit trùng khớp của các hình ảnh đã lưu khác nhau được hiển thị dưới dạng manh mối trực quan; so sánh này sử dụng các giá trị băm bằng nhau, không phải phương pháp tìm kiếm láng giềng gần nhất. Các byte hình ảnh phải khớp với giá trị SHA-256 đã lưu của chúng trước khi tiến hành phân tích dHash; các tệp có dung lượng trên 64 MiB và hình ảnh có độ phân giải trên 40 triệu pixel sẽ bị bỏ qua. Các bản tóm tắt nguồn chuyển tiếp đếm các tin nhắn đích riêng biệt. ID đối tác trong tiêu đề, tên ẩn, chữ ký của tác giả bài đăng và bối cảnh của “Tin nhắn đã lưu” được giữ riêng biệt. JSON hồ sơ người dùng bao gồm các nguồn của từng người gửi; các bài đăng trên kênh cũng xuất hiện trong tóm tắt cấp độ cuộc trò chuyện. Một nguồn được đặt tên mà không có ID đối tác là một nhóm văn bản, không phải một người được xác định. Các tiêu đề của cuộc trò chuyện được nhập vẫn được đánh dấu là đã nhập. Các tệp ZIP chứa bằng chứng không nén bao gồm `media-repeats.json`, `forward-sources.json` và `observed-sources.gexf`, được bảo vệ bởi bản kê khai lưu trữ. Đồ thị GEXF 1.3 có các cạnh `forwarded_from` và `recommended` được định kiểu. Các mũi tên chạy từ cuộc trò chuyện được quan sát đến đối tác được tham chiếu. Trọng số đề xuất tính số lần quan sát đề xuất được lưu giữ; trọng số chuyển tiếp tính số tin nhắn riêng biệt. Tên ẩn và các tiêu đề được nhập vào không tạo ra các cạnh nhận dạng. Không có thao tác đồ thị nào giải quyết hồ sơ hoặc gọi Telegram. Siêu dữ liệu cạnh bao gồm các chuỗi nguồn và hàm băm. Các bản tóm tắt tuân theo phạm vi lựa chọn của báo cáo; tệp ZIP chứa bằng chứng vẫn chứa nhật ký đã ký đầy đủ. Phạm vi lựa chọn chỉ chứa các sự kiện tin nhắn sẽ so sánh ID tài liệu; việc so sánh byte đã lưu và hình ảnh yêu cầu các sự kiện tệp đã lưu trong luồng được chọn. Phạm vi lựa chọn tin nhắn đám mây hiện tại không bao gồm tệp ``media.saved``. Các giới hạn được nêu rõ: 200.000 lần xuất hiện khóa/tin nhắn được giữ lại cho mỗi phân tích, 100.000 khóa phương tiện, 20 nhóm báo cáo, 100 tham chiếu thời gian cho mỗi nhóm và 1.000 cạnh đồ thị được xuất. Khi đạt đến giới hạn so sánh, kết quả sẽ hiển thị các lần xuất hiện bị bỏ qua và số lượng trở thành giới hạn dưới. Giới hạn hiển thị trình tự thời gian và đồ thị được báo cáo riêng biệt. Các tệp ZIP nén sẽ bỏ qua các bản tóm tắt được suy ra này. Các bản ghi nguồn có chữ ký vẫn giữ nguyên. ## 7. Tổng hợp và xác minh việc chuyển giao hồ sơ vụ việc Vui lòng lưu giữ các tài liệu này cùng nhau trong một thư mục hồ sơ vụ việc do chuyên viên phân tích lập: | Nội dung | Mục đích | | --- | --- | | Ghi chú vụ việc và sổ đăng ký nguồn | Các câu hỏi, chính sách thu thập, quyền truy cập/vai trò, kết quả điều tra, các giải thích thay thế và những điểm còn thiếu sót | | Dòng thời gian | Các thông tin về thời gian cũng như tham chiếu đến không gian làm việc/cuộc trò chuyện/tin nhắn/chuỗi tin nhắn cho từng mục ghi chép | | Case Board xuất và các đoạn trích, nếu được sử dụng | Dấu trang liên kết với nguồn, trích dẫn, ghi chú nhóm, bộ sưu tập, lịch sử sửa đổi và các bản ghi được chọn đã được đối chiếu với tệp ZIP chứa bằng chứng | | Tệp ZIP chứa bằng chứng đã được ký số cho từng không gian làm việc | Bản ghi nhật ký hoàn chỉnh, bảng kê khai và các tệp phương tiện được lưu giữ kèm theo; các bộ lọc trên bảng điều khiển không làm thu hẹp phạm vi xuất nhật ký | | Các tệp hồ sơ cá nhân được ký xác thực riêng biệt | Các tài liệu tham khảo được trích dẫn đã được đối chiếu với bằng chứng tương ứng trong không gian làm việc | | Các bản xuất toàn bộ cuộc trò chuyện đã được ký xác thực | Việc thu thập lịch sử hiển thị hiện tại, tách biệt với sổ ghi chép quan sát | | Dấu vân tay đáng tin cậy, chứng chỉ gốc TSA và các điểm kiểm tra trước đó | ID khóa, thời gian bên ngoài của bản ghi cuối cùng và ranh giới nhật ký được lưu giữ | | Các bằng chứng từ Witness, nếu được cấu hình | Sổ nhật ký riêng biệt, các bài đăng có chữ ký và dấu vân tay chứng thực | | Kết quả xác minh và các giá trị băm của tệp đã được cung cấp | Những nội dung nào đã được kiểm tra, những byte nào đã được chuyển và chuyển cho ai | Từ một bản cài đặt đáng tin cậy, kèm theo tên tệp và dấu vân tay thực tế của từng không gian làm việc: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` `--require evidence` sẽ thoát với mã lỗi 2 trừ khi dấu vân tay khớp và thời gian bên ngoài từ bên thứ ba bao phủ bản ghi cuối cùng; điểm kiểm tra là một kiểm tra hỗ trợ. Giữ nguyên kết quả xác minh thực tế và các bằng chứng gốc. Xuất các ghi chú trong không gian làm việc từ Case Board cùng với tài liệu nguồn được trích dẫn. Tổng hợp các phát hiện xuyên không gian làm việc vào thư mục cấp cao nhất của vụ án; mỗi bằng chứng TgWitness đều có chữ ký và quy trình xác minh riêng. ## Thích ứng với quá trình điều tra | Trường hợp | Dấu vết | Gửi | | --- | --- | --- | | Tranh chấp về đơn hàng/thanh toán do bot xử lý | Thông báo đăng ký → xem trước liên kết đã lưu → tham số khởi động bot → phiên bản tin nhắn và bàn phím → biên nhận gọi lại trên bảng điều khiển → theo dõi tin nhắn riêng tư/nhóm | Dòng thời gian đề nghị/phản hồi được quan sát và các nguồn đã được xác minh; xác nhận thanh toán đến từ bản ghi thanh toán | | Các tin nhắn đã bị xóa sau khi xảy ra sự cố | Tất cả các cuộc trò chuyện bị ảnh hưởng → bản gốc/bản chỉnh sửa đã được lưu trữ → kết quả xóa hoặc không còn tồn tại khi kiểm tra lại → phương tiện truyền thông được bảo toàn → phạm vi bao quát và các góc nhìn khác từ tài khoản | Các phiên bản được lưu giữ và các khoảng thời gian không xác định được nêu rõ; không có đối tượng xóa tin nhắn nào được giả định | | Một người tham gia thay đổi tên trong các cuộc trò chuyện | ID người gửi dạng số → lịch sử tên/tên người dùng → các phản hồi → các cuộc trò chuyện khác được quan sát → các đích đến/tệp được trích dẫn | Dòng thời gian hoạt động của tài khoản Telegram kèm theo các liên kết đến các bản ghi nguồn tương ứng | [Tham chiếu bộ sưu tập](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/) · [Xác minh hồ sơ cá nhân](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#people-profiles) · [Việc chuyển giao bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#investigation-handoff) · [Đã hoàn tất quá trình xác thực](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/) --- # Telegram · Tính năng và phạm vi Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/features/ Mô hình thu thập hiện tại, quy trình làm việc với nhiều tài khoản, tính năng xuất dữ liệu và các giới hạn vận hành của TgWitness. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Mô hình thu thập hiện tại, quy trình làm việc với nhiều tài khoản, tính năng xuất dữ liệu và các giới hạn vận hành của TgWitness. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Tham chiếu dự án](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Tham chiếu dự án](https://phishdestroy.io/tgwitness/assets/chapter-project.svg?v=f8e31208f561) TgWitness lưu trữ các cuộc trò chuyện trên Telegram mà các tài khoản được kết nối có thể truy cập, ghi lại các thay đổi được quan sát và chuẩn bị các tệp xuất có thể xác minh. Tài liệu tham khảo này mô tả mô hình thu thập, các quy trình làm việc hiện tại và phạm vi áp dụng của chúng. **Trên trang này** - [Ứng dụng độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#standalone-application) - [Các cuộc điều tra chung](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#shared-investigations) - [Công cụ lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#archive-tools) - [Tính năng bổ sung tùy chọn](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#optional-extras) - [Giao thức và các nguồn riêng tư](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#protocol-and-private-sources) - [Nhiều tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#multiple-accounts) - [Ghi lại và xác định nguồn gốc](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#capture-and-attribution) - [Dung lượng và giới hạn của Telegram](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#capacity-and-telegram-limits) - [Độ tin cậy và khả năng phục hồi](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#reliability-and-recovery) - [Mô hình bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#evidence-model) - [Xuất, triển khai và bàn giao](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#export-deployment-and-handoff) - [Tiêu chí phát hành phiên bản ổn định](https://phishdestroy.io/tgwitness/vi/docs/reference/features/#stable-release-criteria) ## Ứng dụng độc lập TgWitness có quy trình cài đặt, thư mục dữ liệu và chu kỳ phát hành riêng. Giao diện web đi kèm giúp quản lý việc thiết lập và xem xét; các bản ghi đã xuất ra có thể được sử dụng độc lập. Người vận hành kết nối các tài khoản của mình, chọn các nguồn mà mỗi tài khoản có thể truy cập, và nhận được một sổ nhật ký quan sát đã được lưu trữ. Bảng điều khiển hiển thị nội dung, các thay đổi đã lưu, nguồn gốc của quan sát và các lỗ hổng đã biết. Một điều tra viên khác có thể xác minh tài liệu đã xuất ra. Bảng điều khiển phân biệt giữa ủy quyền tài khoản, quyền truy cập vào nguồn, hoạt động của trình thu thập và phạm vi ghi lại. Hãy xem xét các trạng thái này cùng nhau khi đánh giá một khoảng thời gian có ít tin nhắn hoặc gặp sự cố kết nối. ## Các cuộc điều tra chung Quản trị viên có thể cấp [mã thông báo truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/access/) trong phạm vi không gian làm việc và các cuộc trò chuyện riêng lẻ, với quyền truy cập theo từng hành động, hạn chế IP, thời hạn hiệu lực, giới hạn đăng nhập và kiểm soát phiên làm việc. Người đánh giá chỉ có quyền đọc có thể kiểm tra một vụ việc mà không cần xác thực Telegram hoặc khóa bảng điều khiển chính. Quyền truy cập giới hạn trong cuộc trò chuyện được tách biệt với các cài đặt toàn tài khoản và việc xuất toàn bộ nhật ký. MTProxy tự động duy trì các tuyến kết nối Telegram hoạt động từ bốn nguồn công khai hoặc danh mục của nhà điều hành. [Chế độ IP](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/#ip-modes) quyết định liệu trong trường hợp lỗi, hệ thống phải chờ proxy khác hay có thể sử dụng tuyến kết nối trực tiếp được cho phép rõ ràng. Các yêu cầu HTTP bên ngoài có tuyến kết nối riêng biệt và công tắc tắt. ## Công cụ lưu trữ [Việc thu thập lịch sử](https://phishdestroy.io/tgwitness/vi/docs/reference/history/), [tìm kiếm và phân tích kho lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/analysis/), [MCP chỉ đọc](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/), [OCR/phiên âm cục bộ](https://phishdestroy.io/tgwitness/vi/docs/reference/media-analysis/) và [webhook đi](https://phishdestroy.io/tgwitness/vi/docs/reference/webhooks/) đã được tích hợp kể từ phiên bản 0.7.1. Các báo cáo phân tích và văn bản được nhận dạng được tách biệt với các sự kiện đã thu thập. [Case Board](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/) cho phép thêm dấu trang liên kết với nguồn, trích dẫn, ghi chú và bộ sưu tập trong không gian làm việc. [Trình tạo](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) [báo](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) [cáo](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) cho phép chọn nội dung, các phần và một trong tám mẫu thiết kế để xuất sang định dạng HTML/PDF được hỗ trợ. ## Các tính năng bổ sung tùy chọn Cài đặt hàng ngày là tài khoản → nguồn → quan sát. **Công cụ khác → Tiện ích bổ sung** là một điểm đến riêng biệt dành cho việc thu thập, lưu trữ, mục tiêu và mức độ bảo vệ độc lập, thông báo, bằng chứng và bản sao lưu, máy chủ luôn hoạt động, bot chứng kiến Telegram và kiểm tra mã. Mỗi tính năng đều nêu rõ tính khả dụng và yêu cầu trước khi hiển thị cài đặt. Chọn một thẻ sẽ mở hướng dẫn; thao tác này không đăng ký hoặc khởi động dịch vụ. Việc thiết lập bot gồm ba bước: tạo quyền truy cập chỉ đọc, chọn cài đặt xuất bản và khởi chạy trên máy chủ chứng kiến. Các tùy chọn mạng và xuất bản, các kết nối hiện có và lệnh xác minh sẽ được hiển thị theo yêu cầu. Cấu hình đã tải xuống là riêng biệt so với một Witness đang chạy. Việc chuyển đổi các tùy chọn bổ sung sẽ giữ lại bản nháp; các thay đổi tài khoản và việc khóa sẽ xóa mã thông báo tạm thời và biểu mẫu. Hướng dẫn tích hợp sẵn bao gồm các hướng dẫn khởi chạy. [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md), được mở từ Exports, khởi chạy một Collector đã được ghim từ bản fork của bạn, ghi lại một cuộc trò chuyện và tạo ra một bản chuyển giao được mã hóa kèm theo nguồn gốc quy trình làm việc. ## Giao thức và các nguồn tin riêng tư **MTProto là giao thức của Telegram; Telethon là thư viện Python mà TgWitness sử dụng để giao tiếp qua MTProto.** Đây không phải là các phương thức kết nối thay thế. Quá trình thu thập dữ liệu sử dụng MTProto; tính năng chứng kiến tùy chọn sẽ công bố các bản kiểm tra đã được ký thông qua Bot API. Mỗi không gian làm việc đều có luồng cập nhật tài khoản và khách hàng được ủy quyền riêng. TgWitness lựa chọn các dữ liệu quan sát từ các nguồn đã được cấu hình và thực hiện các yêu cầu riêng biệt, rõ ràng đối với các chức năng như chụp nhanh lịch sử và tải xuống tệp đa phương tiện. Nguồn riêng tư không cần tên người dùng công khai. Loại kết nối ngang hàng trên Telegram và ID số là các thông tin nhận dạng; tiêu đề và tên người dùng có thể thay đổi. Quyền truy cập phụ thuộc vào tình trạng thành viên và quyền hạn hiện có. TgWitness không tự động tham gia vào các nguồn hoặc bỏ qua quy trình phê duyệt tham gia. Mã băm truy cập từ một tài khoản khác không phải là mã thông báo truy cập chung. Mô hình thu thập dữ liệu phải tính đến lịch sử ẩn trước khi tham gia, vai trò của người tham gia/quản trị viên, việc thu hồi phiên, xóa bỏ hoặc thay đổi quyền truy cập, quá trình chuyển đổi từ nhóm sang siêu nhóm, các chủ đề/diễn đàn, các cuộc thảo luận liên kết, danh tính kênh và các tệp đính kèm không khả dụng. Không phải mọi trường hợp kết hợp đều đã được kiểm chứng trong thực tế. Tính khả dụng của nguồn được kiểm tra khi trình thu thập bắt đầu hoạt động. Việc thiếu một nguồn trong kết quả cuộc đối thoại được giới hạn có nghĩa là **quyền truy cập chưa được xác nhận**, chứ không phải là bằng chứng cho thấy nguồn đó đã bị xóa. Việc một nguồn không khả dụng sẽ không cản trở việc quan sát các nguồn khác vẫn có thể truy cập được. Tuyệt đối không được đưa các liên kết mời hoặc phiên làm việc thực tế vào các tài liệu công khai. ## Nhiều tài khoản Bảng điều khiển này hỗ trợ bất kỳ số lượng không **gian làm việc** nào, mỗi không gian đều có: - Quyền truy cập, kho lưu trữ được mã hóa và đường dẫn kết nối. - Sổ nhật ký SQLite và danh tính ký số Ed25519. - Các nguồn được chọn, hàng đợi phương tiện và cài đặt ghi lại. - Trạng thái quan sát, lỗi, điểm kiểm tra và các bản xuất dữ liệu. Việc chuyển đổi không gian làm việc đang hiển thị sẽ không làm dừng hoạt động của bộ thu thập khác. Việc ủy quyền tài khoản trùng lặp giữa các không gian làm việc sẽ bị từ chối. Một sổ nhật ký đã được liên kết với một tài khoản Telegram không thể được gán lại cho tài khoản khác; tuy nhiên, việc kết nối lại cùng một tài khoản vẫn được phép. Điều này giúp duy trì danh tính tài khoản và phạm vi ID tin nhắn liên quan. Ứng dụng không giới hạn số lượng không gian làm việc. Mỗi không gian làm việc chạy các tác vụ thu thập dữ liệu riêng để giám sát kết nối, tải xuống phương tiện, kiểm tra lại và thu thập các cuộc trò chuyện mới trong một quy trình Python và vòng lặp sự kiện chung. Thông lượng phụ thuộc vào khối lượng công việc. Để cách ly quy trình, hãy sử dụng các bản cài đặt, cổng và thư mục dữ liệu riêng biệt. Gán cho mỗi tài khoản các nguồn mà tài khoản đó có thể truy cập. Các tài khoản khác nhau có thể quan sát cùng một nhóm, nhưng các quan sát của chúng vẫn tách biệt và giữ nguyên nguồn gốc. Hai tài khoản trên cùng một máy do người vận hành kiểm soát không phải là hai nhân chứng độc lập. **Tính năng xuất nhóm** sẽ gộp các tệp ZIP không gian làm việc được ký riêng lẻ với một danh sách tệp đã ký chứa ID không gian làm việc, băm và dấu vân tay khóa ký của chúng. Mỗi nhật ký giữ nguyên ranh giới riêng của mình. Xây dựng dòng thời gian kết hợp xuyên không gian làm việc trong ghi chú vụ việc hoặc công cụ phân tích, vẫn giữ nguyên các tham chiếu nguồn đó. ## Ghi lại và xác định nguồn gốc Tính năng Nguồn cung cấp các tùy chọn riêng cho từng tài khoản đối với tin nhắn mới, các thao tác chỉnh sửa, xóa, phản hồi và thông tin thành viên. Các cài đặt sẵn sẽ lưu giữ toàn bộ danh mục hoặc chỉ các tin nhắn/thao tác chỉnh sửa/xóa. Chính sách này áp dụng cho các nhóm được chọn trong không gian làm việc, vẫn duy trì sau khi khởi động lại và được ký kèm theo thông tin trước và sau khi thay đổi. Cài đặt mặc định sẽ lưu giữ toàn bộ danh mục. Việc tắt một danh mục sẽ không xóa các bản ghi cũ; việc bật lại danh mục đó cũng không khôi phục các sự kiện đã bỏ lỡ. Các bản ghi hoạt động, các sự kiện dịch vụ nhóm khác và các bản chụp lịch sử rõ ràng là riêng biệt. Các đối tượng Telegram được ghi lại có thể vẫn giữ lại siêu dữ liệu nhúng bất kể các tùy chọn cập nhật riêng biệt. Hiện tại vẫn chưa có tùy chọn ghi đè danh mục cho từng nhóm. | Nội dung | Đã ghi lại ngay lập tức | Phạm vi | | --- | --- | --- | | Thông điệp | Nội dung văn bản, ID người dùng/ID tin nhắn, siêu dữ liệu người gửi, các phản hồi và gói tin cập nhật gốc | Được lưu giữ dưới dạng một quan sát có thể xem được trong tài khoản và được người thu thập ký tên | | Chỉnh sửa | Phiên bản mới được quan sát, các phiên bản đã ghi lại trước đó, thời gian nhận và ngày chỉnh sửa được cung cấp | Các bản cập nhật tin nhắn và các mục nhật ký quản trị có sẵn vẫn giữ nguyên các trường thông tin nguồn tương ứng | | Việc xóa | Thông báo Telegram, thời gian nhận và nội dung đã được ghi lại trước đó | Thời gian thực hiện hành động của tác nhân và nguồn được giữ lại khi được cung cấp bởi một bản ghi nhật ký quản trị riêng biệt | | Thông báo xóa tài khoản | Thông báo gốc; các bản ghi đã được giải quyết bao gồm cuộc trò chuyện đã lưu và phương pháp tương quan | Yêu cầu chính xác một kết quả khớp từ cuộc trò chuyện riêng tư hoặc nhóm thông thường đã được lưu trước đó trong phạm vi; các ID khác sẽ được đánh dấu là “`deletion.unscoped`”. ID kênh và siêu nhóm bị loại trừ khỏi mối tương quan này | | Phản hồi | Số liệu thống kê và danh tính gần đây được hiển thị rõ ràng | Danh sách đầy đủ các máy chủ phản hồi hiện có cần phải thực hiện các truy vấn riêng biệt; các kênh có thể ẩn danh tính | | Thành viên | Thông báo dịch vụ và các bản cập nhật được gửi đến người tham gia | Quyền truy cập phụ thuộc vào vai trò và loại cuộc trò chuyện; thông tin thành viên được báo cáo từ các sự kiện đã được gửi. | | Các thao tác của quản trị viên | Các bản cập nhật liên quan đã được cung cấp và bản chụp nhanh nhật ký quản trị trong các tệp xuất từ cuộc trò chuyện kênh/siêu nhóm | Quá trình xuất dữ liệu sẽ đọc nhật ký khi có sẵn cho tài khoản quản trị viên thực hiện xuất | | Tệp đính kèm | Mô tả phiên bản gốc, số byte đã tải xuống/SHA-256 và kết quả các lần thử | Phiên bản gốc được giữ nguyên; phiên bản sau không bao giờ thay thế nó | | Lịch sử | Ảnh chụp màn hình chi tiết các tin nhắn hiện đang hiển thị | Ghi trực tiếp lưu các phiên bản trước và thông báo xóa | | Quy trình thu thập dữ liệu | Bắt đầu/dừng, tín hiệu hoạt động, lỗi, cài đặt, phạm vi và biên nhận chạy có chữ ký | Danh mục cục bộ; GitHub và TDX bổ sung [các kiểm tra môi trường độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) | Giao diện sẽ sử dụng tên tài khoản được cung cấp trong sự kiện nguồn và giữ nguyên các tên và tên người dùng đã quan sát được. Khi sự kiện không đề cập đến chủ thể, báo cáo sẽ để trống trường đó. ## Dung lượng và các giới hạn của Telegram Dung lượng được xác định theo từng lần triển khai. Nó phụ thuộc vào số sự kiện đỉnh mỗi giây, khối lượng và kích thước tệp đính kèm, các yêu cầu RPC bổ sung, tài khoản hoạt động, độ trễ đĩa/dung lượng trống, điều kiện mạng, giới hạn của Telegram, độ trễ chấp nhận được và độ sâu hàng đợi. Telegram phân biệt giữa việc phân phối thụ động và thăm dò ngắn chủ động. Tài liệu cập nhật của nó mô tả các cuộc gọi bổ sung `updates.getChannelDifference` cho các kênh mở và siêu nhóm, **đồng thời khuyến nghị tối đa mười nguồn được thăm dò ngắn đồng thời**. Điều này áp dụng cho việc thăm dò ngắn; số lượng nhóm được chọn được thiết lập riêng biệt. | Chế độ | Mục đích | Tình trạng | | --- | --- | --- | | Quan sát tiêu chuẩn | Ghi lại các bản cập nhật được gửi từ các nguồn đã chọn | Đã triển khai | | Kiểm tra lại các nội dung ưu tiên | Các nguồn được đánh dấu sao sử dụng khoảng thời gian có thể tùy chỉnh riêng và được ưu tiên trong mỗi lần kiểm tra lại có giới hạn | Được triển khai với các truy vấn lịch sử và tin nhắn | Biểu tượng sao ưu tiên kiểm soát các lần kiểm tra lại này. Các lần thăm dò ngắn bổ sung thông qua ``updates.getChannelDifference` ` không được hiển thị dưới dạng chế độ người dùng riêng biệt. Việc truy vấn tần suất cao tùy ý, bỏ qua FloodWait hoặc giả định dung lượng tuyến tính từ các tài khoản bổ sung không phải là mô hình định cỡ hợp lệ. Giới hạn mặc định là 1,000 cuộc hội thoại đầu tiên được liệt kê, tối đa 500 tin nhắn cho mỗi bản chụp lịch sử, 1–2,000 MiB cho mỗi tệp thu thập theo loại, và 4 GiB nội dung ZIP đã ký chưa nén; mỗi giới hạn được điều chỉnh theo không gian làm việc, kích thước tệp tại **More tools → Sources → Recording** và các mục khác tại **More tools → Parameters**. Việc xuất dữ liệu không có giới hạn cố định về số lượng sự kiện. Chế độ dự phòng trình duyệt bị giới hạn ở 128 MiB theo mặc định; CLI truyền trực tuyến có giới hạn truyền tải có thể cấu hình, mặc định là 5 GiB. ## Độ tin cậy và khả năng khôi phục Các tính năng đã triển khai bao gồm giao dịch đồng bộ SQLite WAL; ghi tin nhắn và tác vụ phương tiện theo kiểu nguyên tử; tác vụ liên tục và độ trễ thử lại; mô tả phiên bản gốc; số lần thử lại có giới hạn; FloodWait phương tiện được lưu trữ lâu dài; việc tải xuống phương tiện bên ngoài thời gian chờ mạng của sự kiện văn bản; xuất dữ liệu với tiền tố ổn định trong khi các thao tác ghi sau đó vẫn tiếp tục; cài đặt nguyên tử và hồ sơ kiểm toán; duy trì quyền truy cập đang hoạt động sau khi đăng nhập thay thế thất bại; cách ly không gian làm việc bổ sung bị hỏng; các nỗ lực kết nối lại rõ ràng; báo cáo mất quyền truy cập riêng biệt; và phát hiện thay đổi theo đồng hồ thực bằng cách sử dụng đồng hồ đơn điệu. Các thông số pts/qts/seq của tài khoản và kênh sẽ được lưu lại và khôi phục sau khi khởi động lại hệ thống, đồng thời các cuộc trò chuyện được theo dõi sẽ được kiểm tra lại định kỳ; xin tham khảo [định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#durable-collection-and-process-receipts-02). Việc lưu lại vị trí định kỳ không phải là một xác nhận nguyên tử, không mất mát về việc chấp nhận nhật ký. Mỗi lần bắt đầu quá trình đều ghi lại vị trí đầu của bản ghi trước đó và ranh giới ngoại tuyến. Lịch sử hiện tại không được coi là phương pháp khắc phục khoảng trống. Khả năng lưu giữ sự khác biệt của Telegram là hữu hạn; `differenceTooLong` không thể tái tạo toàn bộ nội dung đã biến mất. Các khoảng trống không thể phục hồi phải được ghi nhận rõ ràng ngay cả khi bản chụp lịch sử sau đó thành công. ## Mô hình bằng chứng Mỗi sự kiện ghi lại trình tự, thời gian quan sát theo múi giờ UTC địa phương, thời gian nguồn (nếu có), loại sự kiện, nguồn, tác nhân (nếu có), nội dung gốc, giá trị băm trước đó và chữ ký. Các quan sát tin nhắn cũng lưu giữ thông tin về tài khoản thu thập dữ liệu và bối cảnh thực thi. Biên bản quá trình có chữ ký chứa ID chạy ngẫu nhiên; các phiên bản phụ thuộc của TgWitness/Python/OS; giá trị SHA-256 của tệp nguồn và dấu vân tay tổng hợp; tài khoản ban đầu, phạm vi và cài đặt; các giá trị UTC/đơn điệu; cùng phần đầu của nhật ký trước đó. Các thay đổi về cài đặt, thao tác khởi động/dừng và các lỗi đều được ghi vào cùng một nhật ký. Các điểm kiểm tra được lưu giữ khi khởi động, cứ sau năm phút trong quá trình quan sát (có thể điều chỉnh) và khi dừng hoạt động theo đúng trình tự. Một điểm kiểm tra cục bộ được lưu giữ có thể phát hiện việc quay trở lại một tiền tố nhật ký trước đó. | Cơ chế | Những nội dung được xác lập | | --- | --- | | Mã SHA-256 của tệp | Số byte khớp với bản tóm tắt đã biết | | Chuỗi băm sự kiện | Ghi lại thứ tự/mối liên kết so với một ranh giới đã biết | | Ed25519 | Chữ ký được tạo bằng một khóa cụ thể | | Điểm kiểm tra được lưu giữ độc lập | Các nội dung sau đây tuân thủ ranh giới đã được duy trì | | Đo lường kích thước tệp chương trình | Báo cáo tự đánh giá của Collector về các tệp đã được đo lường | | Phản hồi độc lập hợp lệ từ TSA | Sự tồn tại của các byte cụ thể tại thời điểm TSA dựa trên các giả định tin cậy rõ ràng | Việc chuẩn bị yêu cầu RFC 3161 và xác minh phản hồi được triển khai không cần OpenSSL. Chế độ bằng chứng cũng gửi hàm băm của điểm kiểm tra tới các dịch vụ dấu thời gian đã cấu hình. Hãy lưu giữ và xác minh phản hồi của cơ quan cấp dấu để có mốc thời gian độc lập. Xem [TIMESTAMP.md](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/). Lưu giữ các điểm kiểm tra một cách độc lập, kiểm soát quyền truy cập vào khóa ký, lưu giữ hồ sơ chuyển giao và xác minh các tệp xuất bằng phần mềm đáng tin cậy. [Phạm vi](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) [xác](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) [minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) giải thích cách các kiểm tra này bổ sung cho nhau và các giả định về độ tin cậy nào được áp dụng. ## Xuất dữ liệu, triển khai và bàn giao Một tệp ZIP có chữ ký chứa các tệp JSONL, CSV, HTML gốc, các tệp đính kèm được bảo toàn, các giá trị băm, một bản kê khai có chữ ký và một công cụ xác minh tiện lợi. Tệp này bao gồm một không gian làm việc và một tiền tố nhật ký đầy đủ cố định. Các bộ lọc tìm kiếm trên bảng điều khiển sẽ không tự động xóa các bản ghi. Các khóa bí mật, mã thông báo và phiên Telegram sẽ bị loại trừ; tuy nhiên, các quan sát gốc vẫn có thể chứa thông tin cá nhân và siêu dữ liệu của Telegram. Vui lòng lưu giữ riêng biệt bản tóm tắt ZIP, dấu vân tay đáng tin cậy, điểm kiểm tra, biên nhận quá trình và bản ghi chuyển giao. Hãy sử dụng trình xác minh từ một bản cài đặt đáng tin cậy, thay vì chỉ tin tưởng vào mã thực thi chỉ vì nó xuất hiện trong tệp ZIP đang được kiểm tra. Giao diện trình duyệt được triển khai cục bộ mà không cần Node.js, CDN hay phông chữ bên ngoài. Một mã thông báo điều hành sẽ kiểm soát quá trình cài đặt. Việc truy cập từ xa yêu cầu HTTPS hoặc đường hầm SSH. Các định nghĩa Python gốc và container được cung cấp kèm theo, cùng với các ví dụ về dịch vụ trong [thư mục deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md); các kiểm tra nền tảng đã được thực thi được liệt kê riêng biệt. Không gian làm việc mặc định sử dụng thư mục gốc dữ liệu; các không gian làm việc bổ sung sử dụng `profiles//`. Việc sao lưu yêu cầu quá trình phải được dừng lại và có đầy đủ bộ dữ liệu/khóa. Các tệp ZIP chứa bằng chứng không phải là bản sao lưu ứng dụng. Các thông tin bí mật có thể sử dụng khóa chính bên ngoài cho một thư mục dữ liệu mới; việc mã hóa nhật ký/tệp đa phương tiện được thực hiện bởi đĩa/khối lượng lưu trữ của người vận hành. Xin tham khảo các tệp [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/vi/docs/reference/connection/) và [OPERATIONS.md](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/). ## Tiêu chí phát hành phiên bản ổn định Trước khi phát hành phiên bản ổn định, cần làm rõ: 1. Các nhóm riêng tư, siêu nhóm, diễn đàn và kênh thực tế với các vai trò thành viên/quản trị viên cùng lịch sử ẩn/hiển thị, bao gồm thông tin đăng nhập/xác thực hai yếu tố (2FA), việc thu hồi quyền truy cập và tình trạng mất quyền truy cập. 2. Các hành động chỉnh sửa, xóa, phản hồi, thông tin thành viên và phương tiện truyền thông được kiểm soát so với các hành động đã biết. 3. Sự cố hệ thống/máy chủ, lỗi đĩa/đĩa đầy, tham chiếu tệp đã hết hạn, FloodWait, mất kết nối mạng, tệp bị hỏng và khôi phục cơ sở dữ liệu về phiên bản trước. 4. Hỗ trợ sử dụng liên tục nhiều tài khoản với độ trễ được kiểm soát, hàng đợi, bộ nhớ và dung lượng đĩa, bao gồm cả các nguồn dữ liệu im lặng lẫn ồn ào. 5. Sự gián đoạn giữa quá trình chuyển đổi trạng thái MTProto và việc chấp nhận nhật ký. 6. Quá trình cài đặt sạch trên ma trận hệ điều hành/môi trường container mục tiêu và đã xác minh khả năng khôi phục từ bản sao lưu. 7. Đánh giá độc lập về các vấn đề an ninh, chữ ký điện tử cũng như các tuyên bố liên quan đến nguồn gốc và bằng chứng. Quyền truy cập bảng điều khiển có phạm vi được mô tả trong phần [Truy cập và quyền hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/access/). Kể từ phiên bản 0.6, TgWitness hỗ trợ việc nhập TData có giới hạn cho một tài khoản duy nhất và nhập tệp tài khoản như được mô tả trong [ACCOUNTS.md](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/). Xem lại các điều khoản API của Telegram trước khi xuất bản. Các tài liệu tham khảo nghiên cứu và kết quả nghiên cứu về nền tảng có trong [RESEARCH.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md). --- # Telegram · Tham chiếu Case Board Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/ Dấu trang, phần đánh dấu chính xác, các đoạn hành động, cuộc thảo luận, quyền truy cập có phạm vi và lịch sử chú thích đã ký được sử dụng bởi Case Board. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Dấu trang, phần đánh dấu chính xác, các đoạn hành động, cuộc thảo luận, quyền truy cập có phạm vi và lịch sử chú thích đã ký được sử dụng bởi Case Board. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Điều tra](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/) ![Điều tra](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Case Board cung cấp cho đội điều tra một giao diện làm việc chung về các tài liệu đã lưu. Đánh dấu một quan sát, làm nổi bật một đoạn văn bản cụ thể, lưu lại một chuỗi hành động và thảo luận với đồng nghiệp. Các thẻ (Cards) giữ nguyên tham chiếu nguồn và lịch sử sửa đổi đã ký. Các chú thích của đội vẫn nằm trong không gian làm việc, có thể phân biệt riêng biệt với các quan sát gốc trên Telegram. [Mô hình bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) · [Truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/access/) · [Báo cáo](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) ![Nguồn cấp dữ liệu điều tra tổng hợp](https://phishdestroy.io/tgwitness/assets/case-board.png?v=da27ef9c5b51) **Trên trang này** - [Làm việc với một trường hợp](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/#work-with-a-case) - [Quyền truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/#permissions) - [Hợp đồng được lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/#stored-contracts) - [API và các định dạng xuất](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/#api-and-exports) - [Giới hạn hoạt động](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/#operating-limits) ## Làm việc với một vụ việc Mở **thêm công cụ → Bảng trường hợp** ở chế độ Tiêu chuẩn hoặc Chuyên gia. Ngôn ngữ sẽ tự động điều chỉnh theo bảng điều khiển. Sử dụng **nút To board** bên cạnh một bản ghi nhật ký hoặc tin nhắn trò chuyện đã lưu, hoặc chọn nó và nhấn phím **B**. Dấu trang sẽ được thêm vào Hộp thư đến chỉ với một cú nhấp chuột. Chỉnh sửa tiêu đề, nhãn và ghi chú của nó, hoặc di chuyển nó vào một bộ sưu tập. Khi thẻ được chỉnh sửa, một bản sửa đổi có chữ ký sẽ được thêm vào; việc xóa thẻ sẽ giữ lại lịch sử. Đối với trường hợp đầu tiên, hãy chọn một bộ sưu tập và thêm các bản ghi trả lời một câu hỏi. Sử dụng phần bình luận để xem xét cách diễn giải, sau đó dùng **phần Trình bày** để xem xét các thẻ và bối cảnh nguồn. Chọn tài liệu Bảng vụ án riêng biệt trong [Report Studio](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) khi chuẩn bị bản báo cáo. Việc lưu một phần dữ liệu không tự động cấu hình các bộ lọc dữ liệu của báo cáo. Chọn văn bản bên trong một tin nhắn trò chuyện đã lưu để hiển thị **Highlight → board**. Chọn màu sắc và thêm ghi chú. Máy chủ kiểm tra trích dẫn chính xác và phiên bản đã lưu, bao gồm biểu tượng cảm xúc, văn bản RTL và dấu kết hợp. Giao diện không ánh xạ vùng chọn qua văn bản bị che khuất hoặc biến đổi. Nhấn Shift và nhấp vào hai bản ghi trong một cuộc trò chuyện để tạo **"Slice" giữa chúng**, sử dụng **"Slice" theo thời gian**, hoặc lưu các bộ lọc hiện tại của Journal về cuộc trò chuyện, khoảng thời gian và loại sự kiện. Một "Slice" đã lưu có điều kiện xác định riêng của nó: việc mở nó trong Journal cũng áp dụng các cuộc trò chuyện đa dạng, giới hạn số tin nhắn và bộ lọc người tham gia . **Tính năng “Hiển thị các bản ghi được thêm kể từ khi đánh dấu trang”** sẽ tách riêng các bản ghi được thêm sau đó. Việc thay đổi các bộ lọc trong Journal sẽ thoát khỏi phần cắt. Từ mục “Người dùng”, **tính năng “Cắt các hành động của người này”** sử dụng ID tác nhân đã được ghi lại; nó không giả định rằng tác giả tin nhắn đã chỉnh sửa, xóa hoặc phản hồi tin nhắn đó. Hộp thoại "Slice" hiển thị số lượng bản ghi trước khi cho phép tạo. "`all`" bao gồm mọi loại bản ghi, bao gồm ảnh chụp màn hình, chỉnh sửa, xóa, phản hồi, cập nhật thành viên/dịch vụ, hành động của chính người dùng, nút bấm, kết quả phương tiện, tin nhắn được khôi phục và các loại sự kiện trong tương lai. Lựa chọn này mô tả các quan sát đã lưu. Các thông báo xóa cuộc trò chuyện không xác định là bối cảnh riêng biệt, chỉ khả dụng đối với quyền truy cập toàn bộ không gian làm việc, không bao giờ được gán cho một trong các cuộc trò chuyện đã chọn. Các bộ sưu tập có phạm vi trò chuyện được khai báo. Phạm vi trống có nghĩa là toàn bộ không gian làm việc. Một bộ sưu tập không thể chứa các thẻ nằm ngoài phạm vi của nó; người tham gia bị giới hạn trong một cuộc trò chuyện không thể đọc một bộ sưu tập có phạm vi rộng hơn. Hộp thư đến là một bộ sưu tập ảo dành cho các thẻ chưa được phân công. Tính năng tìm kiếm và bộ lọc chỉ áp dụng cho các thẻ hiển thị; các chuỗi thảo luận và đề cập kế thừa quyền truy cập từ thẻ cha. Các bình luận đã xóa sẽ có biểu tượng "tombstone" trong cuộc thảo luận. Lịch sử xem không được ghi lại. **Chế độ trình bày** mở tất cả các thẻ trong bộ sưu tập đã chọn, với các chế độ xem Thẻ, Bối cảnh nguồn và Bình luận của nhóm cùng các phím điều hướng Trước/Tiếp theo trên bàn phím. Chế độ này không cung cấp các công cụ chỉnh sửa. Dòng tin thông thường được chia trang; chế độ trình bày tải danh sách theo từng trang và hiển thị chi tiết của một thẻ tại một thời điểm. ## Quyền truy cập Tất cả các thao tác đều yêu cầu quyền truy cập `view`, phạm vi không gian làm việc/trò chuyện và `board.read`. `board.write` cho phép thêm thẻ, bình luận, di chuyển và thay đổi trạng thái "mở"/"đang xem xét". `board.manage` cho phép quản lý bộ sưu tập, trạng thái "đã xác nhận"/"đã từ chối", cũng như chỉnh sửa hoặc xóa thẻ của người khác. Trạng thái là quyết định của nhóm, không phải kết quả xác minh mật mã. Cài đặt sẵn biểu mẫu truy cập: Người xem xét = chỉ đọc; Nhà phân tích = đọc/ghi; Người vận hành = đọc/ghi/quản lý, bên cạnh các quyền hiện có của họ. Các quyền hiện có không tự động mở rộng sang các quyền mới. Quản trị viên chính có tất cả các quyền và đăng bài với tư cách là **Quản trị viên chính**. Sử dụng các quyền được đặt tên để ghi nhận nguồn. Danh sách đề cập chỉ bao gồm các quyền truy cập hiện tại có thể đọc toàn bộ thẻ cha. Một quyền truy cập vào cuộc trò chuyện A không thể lấy được thẻ hoặc phần dữ liệu cho A+B, ngay cả khi đoán ID của nó hoặc cung cấp một `target.chat_id` sai. Siêu dữ liệu mục tiêu được xác định từ hàm băm sự kiện đã ký trên máy chủ. Các bộ sưu tập, số lượng thảo luận, thẻ liên quan và thông báo trực tiếp được lọc trước khi trả lời. Việc xuất dữ liệu yêu cầu quyền “`export`” cũng như “`board.read`”; một trình xuất hiện có sẵn nhưng không có quyền truy cập bảng sẽ nhận được kho lưu trữ bằng chứng thông thường mà không có ghi chú của nhóm. SSE sẽ kiểm tra lại các quyền hiện tại trước mỗi đợt xử lý. ## Hợp đồng được lưu trữ Giống như các quan sát, các chú thích được ghi theo từng giao dịch vào một bảng SQLite chỉ ghi thêm trong không gian làm việc. `annotations.jsonl` là tệp xuất chuẩn chính xác từ cùng một bản chụp đọc như `events.jsonl`. Không có kho lưu trữ chú thích thứ hai cạnh tranh và không có sự kiện nhật ký `board.activity`. Mỗi dòng phải chứa chính xác: ``` { "seq": 1, "at": "2026-11-02T14:00:00.000+00:00", "access_id": "admin", "access_label": "Main administrator", "kind": "board.bookmark", "payload": {"id": "32 lowercase hex digits", "target": {"event_hash": "64 lowercase hex digits"}}, "previous_hash": "64 zeroes for the first record", "hash": "SHA-256 described below", "signature": "base64 Ed25519 signature" } ``` Ví dụ viết tắt ở trên minh họa phần bao bì; các tải trọng thực tế bao gồm các giá trị mặc định của mô hình và các trường đích được máy chủ giải quyết. Các lược đồ yêu cầu API nằm trong thư mục [`tgwitness/schemas`](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/schemas/board-bookmark.json), được tạo ra từ các mô hình Pydantic thời gian chạy bằng công cụ `python tools/build_board_schemas.py`. Các trường yêu cầu bổ sung sẽ bị từ chối. Các ID được tạo ra phía máy chủ khi bị bỏ trống. Tác giả, thời gian, ảnh chụp nhanh và chữ ký không thể được cung cấp bởi người gọi. Các ID cấp quyền có tên tuân theo định dạng 16 ký tự hex hiện có của Access; ID thẻ là 32 ký tự hex. JSON chuẩn là UTF-8, các khóa đối tượng được sắp xếp theo thứ tự, không có khoảng trắng giữa các token, Unicode không được thoát, và không có NaN/vô cực. Băm chú thích là SHA-256 của đối tượng chuẩn chứa định dạng `format: "tgwitness-annotations-v1"` và tất cả bảy trường bao bọc cho đến `previous_hash`. Thẻ định dạng này tách miền băm của nó khỏi các quan sát. Chữ ký là Ed25519 trên 32 byte băm thô. Dãy bắt đầu từ 1. Các bản sửa đổi giữ nguyên ID thẻ và đặt tên cho băm chú thích trước đó trong trường "`supersedes`"; chúng không thể thay đổi phạm vi trò chuyện. Việc di chuyển, trạng thái và xóa là các bản ghi riêng biệt. Bảng SQLite từ chối các lệnh UPDATE và DELETE. `case-board.json` chứa `{statement, signature}`. Tuyên bố chuẩn được ký bởi khóa không gian làm việc và chứa `format: "tgwitness-case-board-v1"`, `public_key`, `created_at`, `journal_head`, `meaning` và `state`. Trạng thái là tái phát xác định: `annotations_head`, một mảng `items` được sắp xếp theo thứ tự (bộ sưu tập, thẻ, bình luận bao gồm các mục đã xóa) và `status_history`. Các mục giữ lại băm chú thích cuối cùng, thứ tự, tác giả và thời gian, cũng như người tạo ban đầu và thời gian tạo qua các phiên bản sửa đổi. Quá trình phát lại kiểm tra các phiên bản sửa đổi, các mục cha, tham chiếu bộ sưu tập và ID hành động trùng lặp. Tệp ``manifest.json`` và các điểm kiểm tra mới cũng liên kết ``annotations_head``. Giữ lại một điểm kiểm tra một cách độc lập để phát hiện việc cắt bớt hoặc viết lại bằng khóa ký đã sao chép. ### Phiên bản văn bản `range.start` là độ lệch điểm mã Unicode bắt đầu từ 0, `length` là số đếm điểm mã dương, và `quote` phải bằng chính xác chuỗi con của `payload.text` hoặc `payload.caption` tại sự kiện mục tiêu. Không áp dụng NFC/NFKC, chuyển đổi chữ hoa/thường hoặc chuẩn hóa grapheme. Các đoạn chuỗi trong Python và phương thức ``Array.from(text)`` trong JavaScript thực hiện cách lập chỉ mục tương tự. Việc kết hợp các ký hiệu và biểu tượng cảm xúc ZWJ có thể chiếm nhiều điểm mã. ``range.version`` là băm của sự kiện đích, không phải phiên bản tin nhắn hiện tại hoặc độ lệch thực thể UTF-16 của Telegram. Các chỉnh sửa sau này không bao giờ tự động di chuyển vị trí đánh dấu. ### Phân chia theo danh tính và thời gian Lệnh `query` chấp nhận chính xác một `chat_id` hoặc các `chat_ids` không rỗng, phạm vi `from`/`to` bao gồm (tùy chọn), phạm vi ID tin nhắn bao gồm (chỉ một cuộc trò chuyện), các loại (`kinds: "all"`) hoặc các loại ký tự đại diện chính xác/tiền tố, các `actors` được chỉ định rõ, `search`, `hide_system` và `include_unscoped`. Các nhóm loại nhật ký (journal kind groups) sẽ mở rộng thành các điều kiện chính xác của chúng. Tìm kiếm sử dụng tìm kiếm tải trọng NFC/case-folded của nhật ký mà không thay đổi văn bản nguồn đã ký. Ngày tháng yêu cầu múi giờ và được chuẩn hóa sang UTC. Ngày tháng lọc **`observed_at`**. ``source_at`` của Telegram được hiển thị riêng biệt. Một lần xóa không có dấu thời gian nguồn sẽ không có thời gian xóa được tạo ra. Một bản ghi muộn được quan sát bên ngoài khoảng thời gian sẽ không được đưa vào; một đoạn `message-ID` có thể bao gồm một lần xóa muộn hơn cho các `message-ID` đó. `snapshot` cố định thời gian tạo, ranh giới chuỗi/băm nhật ký, số lượng khớp, chuỗi đầu tiên/cuối cùng và `result_hash`. Giá trị sau là SHA-256 của mảng JSON chuẩn UTF-8 chứa các băm sự kiện khớp được sắp xếp theo thứ tự từ điển, bao gồm `[]` cho một lát cắt rỗng. Nó cũng chứa số lượng chính xác các loại và một bản thu nhỏ thời gian quan sát gồm 24 ô. Một lát (slice) lưu trữ một truy vấn, không phải các bản ghi nguồn trùng lặp . Khi xuất, `board/slices/.json` liệt kê các băm hiện tại và các chuỗi đã thêm/xóa. Trình xác minh tái tạo kết quả ban đầu tại ranh giới tạo, sau đó là kết quả hiện tại. Các bản ghi được thêm vào được báo cáo dưới dạng một sự kiện thay đổi. Việc xóa một sự kiện ban đầu sẽ phá vỡ chuỗi bằng chứng bất biến; hành động này không được chấp nhận một cách im lặng như một hành động xóa thông thường khỏi một lát cắt. Các ảnh chụp nhanh phản ứng có danh sách người tham gia gần đây không đầy đủ. Trình khám phá so sánh các ảnh chụp nhanh liền kề của cùng một cuộc trò chuyện/tin nhắn, bao gồm cả ảnh chụp nhanh tiền nhiệm nằm ngoài phạm vi cắt, và báo cáo sự chênh lệch tổng hợp về số lượng **giữa các quan sát**. Việc thiếu người tham gia gần đây không được coi là do họ đã xóa phản ứng. Bản chụp đầu tiên không có trạng thái trước đó được suy luận. Các quan sát về tác nhân vẫn được gán cho bản chụp mà chúng được cung cấp, chứ không phải cho một thời điểm hành động được giả định. ## API và xuất dữ liệu `GET /api/board`chấp nhận các tham số collection/chat/author/label/state/from/to/q/kind/comments, offset/limit và thứ tự mới nhất/cũ nhất. `GET /api/board/card/{id}`trả về một thẻ, bản xem trước nguồn, chuỗi tin nhắn, lịch sử trạng thái và các thẻ liên quan. Đường dẫn con participants trả về các lựa chọn đề cập đủ điều kiện. `POST /api/board/{bookmark|highlight|slice|collection|comment|status|move|remove}` thêm một bản ghi. `POST /api/board/slice-preview` tính toán một truy vấn. Các bản ghi lát cắt được phân trang tại `GET /api/board/slice/{id}/records`; việc tính toán lại luôn sử dụng bản chụp đọc ổn định hiện tại. `/api/stream` trực tiếp phát ra các thông báo `board` không chứa dữ liệu, tách biệt với các con trỏ nhật ký. `GET /api/board/export` trả về một tài liệu đã được ký. Quyền truy cập giới hạn vào cuộc trò chuyện sẽ nhận được một **bản tiết lộ** đã ký và được dán nhãn rõ ràng, không bao giờ là chú thích của cuộc trò chuyện khác hoặc toàn bộ chuỗi. Các tệp ZIP chứa bằng chứng đầy đủ chứa tệp `annotations.jsonl`, tệp `case-board.json` đã ký và các phụ lục JSON dạng slice. Cài đặt báo cáo HTML/PDF/JSON cho phép chọn không sử dụng bảng, dấu trang/phần trích xuất không kèm thảo luận, hoặc thẻ có bình luận. Phần này tách biệt rõ ràng ý kiến của nhóm khỏi các quan sát. Bộ lọc dữ liệu báo cáo cũng hạn chế các ghi chú có thể đọc được; các tệp nguồn đầy đủ đã được ký trong tệp ZIP bằng chứng vẫn được giữ nguyên vẹn. `GET /api/board/slice/{id}/export` trả về một đoạn trích JSON đã được ký tên `tgwitness-board-selection-v1`; `?format=csv` trả về một bảng dữ liệu tiện lợi mà không kèm theo chữ ký độc lập. Giữ nguyên định dạng JSON và ZIP: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_KEY_SHA256 --board python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 python -m tgwitness.verify case-board.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 ``` Kiểm tra lựa chọn xác thực tuyên bố đã ký, các bản ghi nguồn chính xác và tính đầy đủ của truy vấn tại ranh giới được chỉ định. Tệp ZIP chứa bằng chứng có thể mới hơn nhưng phải chứa tiền tố đó. Mục tiêu bị treo sẽ được báo cáo rõ ràng. Ảnh chụp lát cắt gốc khác, chú thích bị thay đổi , trạng thái phát lại không khớp hoặc nguồn bị thay đổi sẽ bị từ chối. Các kho lưu trữ cũ không có chú thích vẫn giữ nguyên hành vi xác minh hiện có. Mặc định của Handover là **Không bao gồm**. Việc bao gồm rõ ràng sẽ hiển thị các thẻ dự án thông qua các bản ghi đã được tối giản hóa, loại trừ các mục tiêu không thể truy cập hoặc bị bỏ qua, ẩn các phần nổi bật có văn bản nguồn đã được tối giản hóa, làm sạch văn bản nhóm theo các quy tắc đề cập/liên hệ tương tự, và tùy chọn thay thế các nhãn điều tra viên bằng R01, R02… trong siêu dữ liệu và các trường hợp đã biết trong ghi chú. Không tiết lộ tệp gốc `annotations.jsonl`. Tệp sidecar đã ký `tgwitness-case-board-handover-v1` và báo cáo chứa cùng nội dung đã được thu gọn. Số lượng lát cắt chỉ mô tả các bản ghi được tiết lộ, trong khi chi tiết người thực hiện chụp nhanh/truy vấn gốc bị ẩn. Các tên văn bản tự do mà công cụ thu gọn không nhận diện vẫn cần được xem xét, giống như trong các lần bàn giao thông thường. Bản sao có chữ ký riêng; các chú thích gốc giữ nguyên chữ ký của chúng trong kho lưu trữ đầy đủ. ## Giới hạn hoạt động Các thông số bao gồm giới hạn mềm là 10.000 thẻ và 50.000 bình luận, một trang trích đoạn tối đa 5.000 bản ghi, và điều khiển xem trước phương tiện. Giới hạn mềm sẽ cảnh báo mà không xóa lịch sử. Các trang nguồn cấp dữ liệu có tối đa 200 thẻ. Các đoạn trích JSON độc lập bị giới hạn ở mức 64 MiB; hãy thu hẹp truy vấn hoặc sử dụng tệp ZIP có chữ ký cho tài liệu có dung lượng lớn hơn. Trình xác minh độc lập giới hạn việc phát lại chú thích ở mức 256 MiB. Case Board không kích hoạt hoặc triển khai bất kỳ thông báo bình luận bên ngoài nào. Tính năng chấp nhận tự động sử dụng dữ liệu giả và một kênh truyền tải Telegram mô phỏng để kiểm tra lưu trữ, truy cập, hiển thị và xuất dữ liệu. Xem [phạm vi xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) để biết phạm vi kiểm tra bằng chứng. --- # Telegram · Phân tích kho lưu trữ Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/analysis/ Tìm kiếm các tin nhắn đã lưu, xem lại các đầu vào từ AI và lưu giữ các báo cáo phân tích kèm theo nguồn tham khảo. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Tìm kiếm các tin nhắn đã lưu, xem lại các đầu vào từ AI và lưu giữ các báo cáo phân tích kèm theo nguồn tham khảo. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Điều tra](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/) ![Điều tra](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Hướng dẫn quy trình làm việc](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Sử dụng **Journal** để tìm kiếm cục bộ mà không cần AI; [tìm kiếm toàn văn](https://phishdestroy.io/tgwitness/vi/docs/reference/search/) (bản xem trước) khớp với các dạng từ, cụm từ, miền và @tên người dùng. Để sử dụng**các công cụ khác → Hỏi kho lưu trữ**, trước tiên hãy kích hoạt và cấu hình nhà cung cấp trong **Các công cụ khác → Tích hợp**. Bộ chọn không gian làm việc chọn tài khoản; biểu mẫu chọn các cuộc trò chuyện và khoảng thời gian quan sát. Quá trình truy xuất diễn ra tại địa phương. Một cụm từ chính xác hoặc miền sẽ thu hẹp phạm vi truy xuất; ID tin nhắn yêu cầu các phiên bản đã lưu. Xem lại các đoạn trích và mở các bản ghi nhật ký hoặc bối cảnh của chúng. Không có cơ sở dữ liệu vectơ hoặc hành động tự động trên Telegram. ## Nhà cung cấp và sự đồng ý Tính năng AI được tắt mặc định trong mọi không gian làm việc. Chỉ quản trị viên chính mới có thể cấu hình mô hình, điểm cuối, khóa API được mã hóa, giới hạn bối cảnh/đầu ra, thời gian chờ và hạn mức yêu cầu hàng ngày. Khóa API sẽ không bao giờ được gửi trở lại trình duyệt. Để giữ nguyên khóa hiện tại, hãy để trống trường khóa hoặc xóa nó một cách rõ ràng. Ollama sử dụng [điểm cuối `/api/chat`](https://docs.ollama.com/api/chat) đã được ghi chép với đầu ra JSON không theo luồng. Địa chỉ mặc định của nó là `http://127.0.0.1:11434` trên máy chủ TgWitness. Người vận hành có thể thay đổi địa chỉ này bằng cách sử dụng `TGWITNESS_AI_LOCAL_ENDPOINT`; đây không phải là địa chỉ do mô hình kiểm soát. Hãy tự cài đặt mô hình đã chọn. TgWitness không tự động tải xuống mô hình này. Nhà cung cấp tương thích phải có URL cơ sở kết thúc bằng `/v1` và hỗ trợ [giao thức Chat Completions](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create): `messages` (chế độ phản hồi JSON), `max_completion_tokens` và `choices[0].message.content`. Các dịch vụ thiếu các trường này sẽ không được hỗ trợ. Việc kiểm tra kết nối sẽ gửi văn bản tổng hợp và được tính vào hạn mức yêu cầu. Mỗi yêu cầu đều sử dụng đường dẫn bên ngoài đã được cấu hình của không gian làm việc. Đường dẫn bị chặn hoặc MTProxy chỉ dành cho Telegram là lỗi; không có lần thử lại trực tiếp. Một địa chỉ Ollama cục bộ được cấu hình có chủ đích cho phép đích đến riêng tư. Một điểm cuối AI loopback yêu cầu tuyến đường bên ngoài Direct của không gian làm việc; các tuyến đường proxy sẽ bị từ chối trước khi truyền tải. Đối với các dịch vụ riêng tư khác, tùy chọn tham gia điểm đến riêng tư ở cấp máy chủ hiện có sẽ được áp dụng. Bản xem trước hiển thị điểm cuối và tuyến đường bên ngoài, bao gồm máy chủ proxy nếu có. Việc thay đổi tuyến đường đó yêu cầu một bản xem trước mới. Trước khi tạo, **dữ liệu gửi đến mô hình** hiển thị yêu cầu: câu hỏi, các đoạn trích đã kiểm tra, loại sự kiện, thời gian quan sát và các dấu hiệu phạm vi. Các phiên Telegram, các trường thô, khóa nhà cung cấp, byte tệp đính kèm và nhật ký đầy đủ không thuộc bối cảnh đó. Bỏ chọn các nguồn không mong muốn, sau đó chấp thuận rõ ràng việc xử lý. Các nhà cung cấp bên ngoài có thể lưu giữ nội dung đã gửi theo chính sách riêng của họ. Thực thi cục bộ có nghĩa là điểm cuối là cục bộ; một dịch vụ được cấu hình riêng biệt sẽ tuân theo cấu hình riêng của nó. Tối đa có hai yêu cầu đồng thời từ nhà cung cấp trên toàn cầu và một yêu cầu cho mỗi không gian làm việc. Bản xem trước hết hạn sau mười phút và chỉ có thể tạo ra một kết quả. Số lượng token được báo cáo của nhà cung cấp sẽ được hiển thị; ước tính chi phí chỉ xuất hiện khi cả biểu giá đầu vào và đầu ra đã được cấu hình. Các lần thử không thành công cũng tiêu tốn ngân sách yêu cầu hàng ngày. Các lần thử lại tự động không tiêu tốn thêm ngân sách. ## Nguồn và giới hạn Việc truy xuất sử dụng [chỉ mục](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#ask-the-archive-and-mcp) [toàn](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#ask-the-archive-and-mcp) [văn](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#ask-the-archive-and-mcp) khi nó đã hoàn tất: các kết quả phù hợp nhất trong các cuộc trò chuyện đã chọn, bao gồm các dạng từ. Các câu hỏi về những thay đổi gần đây hoặc các phiên bản của một tin nhắn, cũng như các tìm kiếm trong khi chỉ mục đang được xây dựng, sử dụng tìm kiếm từ vựng có giới hạn trên các bản ghi mới nhất. Bản xem trước nêu tên phương pháp. Truy xuất trả về tối đa 24 nguồn; các văn bản dài được cắt bớt xung quanh phần khớp. Các đoạn trích bị cắt ngắn và tập kết quả không đầy đủ sẽ được đánh dấu. Khoảng thời gian này đề cập đến **thời điểm quan sát**, không phải là khẳng định rằng lịch sử Telegram là hoàn chỉnh. Các sự kiện có phạm vi toàn không gian làm việc sẽ không được hiển thị khi truy cập trong phạm vi cuộc trò chuyện. Dữ liệu thiếu được mô tả là không tìm thấy trong kho lưu trữ hiện có. Mô hình không nhận bất kỳ công cụ nào. Các ID nguồn của nó được đối chiếu với các bản ghi đã chọn, các hàm băm được kiểm tra lại, và các chuỗi trích dẫn phải xuất hiện trong các bản ghi đó. Các ID chưa biết, trích dẫn bị thay đổi và các tuyên bố không được trích dẫn sẽ khiến câu trả lời bị từ chối. Ứng dụng tạo ra các liên kết; các URL do mô hình tạo ra không được sử dụng làm trích dẫn. Các kiểm tra này xác nhận sự tồn tại của nguồn và độ chính xác của trích dẫn. Hãy kiểm tra lại các suy luận dựa trên các bản ghi trước khi dựa vào chúng. ## Báo cáo Lưu câu trả lời đã được xem xét dưới dạng một báo cáo phân tích riêng biệt. Báo cáo này bao gồm tóm tắt mô hình, thứ tự thời gian quan sát được, các liên kết và handle được trích xuất, bản ghi chỉnh sửa/xóa, giới hạn phạm vi bao phủ và các giá trị băm sự kiện nguồn. Thông tin về nhà cung cấp, mô hình, điểm cuối, thời gian và phiên bản mẫu lời nhắc cũng được kèm theo. Không có thông tin nhận dạng nào được tự động hợp nhất. Các bản sửa đổi và ghi chú của nhà phân tích được lưu trữ riêng biệt với bản tóm tắt của mô hình. Các báo cáo được lưu trữ trong các tệp phái sinh được mã hóa, với chỉ mục nằm ngoài luồng sự kiện đã ký; các sự kiện và phương tiện gốc không bị thay đổi. Chỉ chủ sở hữu hoặc quản trị viên mới có thể mở báo cáo, và quyền truy cập nguồn sẽ được kiểm tra lại. Việc tải xuống cũng yêu cầu quyền xuất dữ liệu. Phiên bản 1 không ký số các báo cáo cũng như không ngụ ý rằng các kết luận của mô hình là bằng chứng đã được xác minh. Giới hạn: 100 báo cáo cho mỗi không gian làm việc và 100 bản sửa đổi của nhà phân tích cho mỗi báo cáo. Để biết thêm về OCR thủ công và bản chép lời, xem [phần xử lý phương tiện truyền thông](https://phishdestroy.io/tgwitness/vi/docs/reference/media-analysis/). Để biết thêm về quyền truy cập của khách hàng, xem [MCP](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/). --- # Telegram · Tìm kiếm toàn văn Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/search/ Tìm các tin nhắn đã lưu theo dạng từ, cụm từ chính xác, tên miền và @tên người dùng, hiển thị kết quả phù hợp nhất trước tiên, với chỉ mục được liên kết với nhật ký có chữ ký. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Tìm các tin nhắn đã lưu theo dạng từ, cụm từ chính xác, tên miền và @tên người dùng, hiển thị kết quả phù hợp nhất trước tiên, với chỉ mục được liên kết với nhật ký có chữ ký. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Điều tra](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/) ![Điều tra](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Phân tích kho lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/analysis/) · [OCR và chuyển đổi văn bản tại địa phương](https://phishdestroy.io/tgwitness/vi/docs/reference/media-analysis/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Xem trước.** Trong **Nhật ký**, chọn **"Kết quả phù hợp nhất · các dạng từ**" bên cạnh trường tìm kiếm. Kết quả được xếp hạng theo thuật toán BM25 và bao gồm các dạng khác của cùng một từ: *"перевод"* sẽ tìm thấy *"переводом"* và *"переводы"*, *"transfer"* sẽ tìm thấy *"transfers"*, một cụm từ tiếng Trung sẽ được tìm thấy mà không cần khoảng trắng. Chế độ "**Mới nhất trước · văn bản chính xác"** duy trì tìm kiếm chuỗi con trước đó trên toàn bộ bản ghi. Chỉ mục là dữ liệu được trích xuất. Nó được tái tạo từ nhật ký đã ký, bản thân nó không bao giờ được ký và không bao giờ được xuất ra. Các bản ghi gốc không bị thay đổi. **Trên trang này** - [Cú pháp tìm kiếm](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#search-syntax) - [Ngôn ngữ](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#languages) - [Vị trí của chỉ mục](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#where-the-index-lives) - [Kết quả và nhật ký đã ký](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#results-and-the-signed-journal) - [Văn bản đã được nhận diện](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#recognized-text) - [Truy cập](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#access) - [Hỏi kho lưu trữ và MCP](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#ask-the-archive-and-mcp) - [Các phụ thuộc](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#dependencies) - [Đánh giá hiệu năng](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#benchmark) ## Cú pháp tìm kiếm | Viết | Tìm kiếm | | --- | --- | | `перевод карта` | Các bản ghi chứa cả hai từ, dưới bất kỳ hình thức nào | | `"переводом на карту"` | Cụm từ chính xác, theo thứ tự này | | `бонус OR подарок` | Bất kỳ từ nào | | `перевод -казино` | Các bản ghi không chứa từ bị loại trừ | | `example.com` | Tên miền và các tên miền con của nó, bao gồm cả trong các liên kết ẩn và URL của các nút | | `@username`, `t.me/username` | Các đề cập và liên kết đến tài khoản, cùng các tin nhắn mà tài khoản đó đã gửi | | `#tag` | Thẻ hashtag | | `+79991234567`, một địa chỉ ví, một địa chỉ email | Giá trị tương tự dưới dạng văn bản hoặc liên kết | | `from:@username`, `from:123456` | Các tin nhắn từ người gửi đó | | `chat:-1001234567890` | Một cuộc trò chuyện; nó chỉ có thể hạn chế quyền truy cập của chính bạn | | `id:42` | Các phiên bản đã lưu của tin nhắn số 42 | | `since:2026-01-01 until:2026-01-31` | Thời gian quan sát; một ngày không kèm giờ sẽ bao gồm cả ngày | | `kind:edited` | Chỉ chỉnh sửa (`new`, `snapshot`, `edited`, `recovered`) | | `source:ocr`, `source:transcription`, `source:all` | Văn bản được nhận diện thay vì, hoặc cùng với, các tin nhắn | Các giới từ và từ chức năng khác sẽ bị bỏ qua khi có các từ khác xuất hiện. Các chữ cái trông giống nhau xen kẽ trong một từ (chữ *a* La-tinh nằm trong một từ Cyrillic), các ký tự Unicode có chiều rộng đầy đủ và trang trí, cũng như các ký tự vô hình sẽ được chuẩn hóa. ## Ngôn ngữ Ngôn ngữ được xác định cho từng bản ghi dựa trên kịch bản và các ký tự của nó: | Tập lệnh | Phù hợp | | --- | --- | | Chữ Cyrillic | Các từ gốc tiếng Nga và tiếng Ukraina với [pymorphy3](https://github.com/no-plagiarism/pymorphy3). Nếu không có từ điển tiếng Ukraina tùy chọn, công cụ sẽ sử dụng một bộ phân tích gốc tiếng Ukraina nhẹ. | | Tiếng Latinh | Bộ phân tích từ gốc Snowball tiếng Anh; các dấu phụ được bỏ qua | | Tiếng Trung, Tiếng Nhật, Tiếng Hàn, Tiếng Thái, Tiếng Lào, Tiếng Khmer, Tiếng Miến Điện | Các cặp ký tự trùng lặp: bất kỳ cụm từ nào cũng được tìm thấy mà không có khoảng trắng. Các truy vấn tiếng Trung được tách thành các từ bằng jieba | | Các tập lệnh khác | Các từ chính xác | Từ điển tiếng Ukraina (`pymorphy3-dicts-uk`) được phân phối theo giấy phép GPL-3.0, do đó nó không được cài đặt theo mặc định. Hãy cài đặt nó bằng lệnh `pip install "tgwitness[uk-dictionary]"`; chỉ mục sẽ nhận diện trình phân tích mới và tự động xây dựng lại. ## Vị trí lưu trữ chỉ mục | Chế độ | Lưu trữ | Cách sử dụng | | --- | --- | --- | | Trên đĩa (mặc định) | `search/fulltext.sqlite3` trong thư mục workspace | Các kho lưu trữ lớn; vẫn hoạt động bình thường sau khi khởi động lại | | Chỉ lưu trong bộ nhớ | Không lưu trữ dữ liệu trên đĩa; được xây dựng lại mỗi khi khởi động | Không lưu bản sao nội dung tin nhắn trên đĩa | | Tắt | Không có chỉ mục; Hiển thị **từ mới nhất trước ·** giữ nguyên **văn bản chính xác** | Cài đặt tối thiểu | Quản trị viên chính chọn chế độ trong **mục Nhật ký → Bộ lọc → Chỉ mục tìm kiếm** cho từng không gian làm việc. `TGWITNESS_FULLTEXT=disk|memory|off` thiết lập giá trị mặc định cho các không gian làm việc chưa có lựa chọn riêng. Chuyển sang chế độ lưu trữ trong bộ nhớ hoặc tắt sẽ xóa tệp. Tệp chỉ mục có mức độ bảo vệ tương tự như nhật ký: nó được lưu trữ trong thư mục dữ liệu riêng tư . Các bản sao lưu và bản sao ngoài hệ thống không bao gồm tệp này. Các bản ghi mới được lập chỉ mục ở chế độ nền trong vòng vài giây; khi tìm kiếm, hệ thống cũng ưu tiên lập chỉ mục các bản ghi tồn đọng gần đây nhất, do đó bản ghi vừa được lưu cách đây một lúc sẽ được tìm thấy. Một nhật ký hiện có sẽ được lập chỉ mục sau khi cập nhật mà không làm gián đoạn hoạt động của bảng điều khiển; cho đến lúc đó, kết quả tìm kiếm sẽ bao gồm các bản ghi đã được lập chỉ mục và nhật ký sẽ hiển thị tiến trình. **Quá trình xây dựng lại chỉ mục** sẽ bắt đầu lại từ bản ghi đầu tiên. ``` python -m tgwitness index status --data-dir data/live python -m tgwitness index rebuild --data-dir data/live --json ``` `rebuild` cần dừng bảng điều khiển (mã thoát là 3 nếu không). Với `--json`, đầu ra tiêu chuẩn chỉ hiển thị kết quả; tiến trình được ghi vào đầu ra lỗi tiêu chuẩn. ## Kết quả và nhật ký được ký điện tử Chỉ mục lưu trữ số thứ tự và giá trị băm của bản ghi nhật ký cuối cùng mà nó bao phủ và đối chiếu chúng với nhật ký khi mở. Một nhật ký bị thay thế, khôi phục hoặc chỉnh sửa sẽ gây ra quá trình xây dựng lại. Mỗi phản hồi báo cáo vị trí này, và mỗi kết quả khớp được đọc lại từ nhật ký có chữ ký thông qua số thứ tự của nó: chỉ mục quyết định những bản ghi nào sẽ hiển thị và theo thứ tự nào, chứ không bao giờ là nội dung của chúng. Quyền truy cập trò chuyện được áp dụng cho trường trò chuyện riêng của nhật ký, chứ không phải nội dung của chỉ mục. ## Văn bản được nhận diện Dữ liệu OCR và bản chép lời vẫn được lưu trữ trong các tệp mã hóa của chúng. Chỉ mục của chúng chỉ tồn tại trong bộ nhớ và được xây dựng lại khi một tác vụ nhận dạng hoàn tất. Một kết quả khớp sẽ xuất hiện trong `media.saved` bản ghi đó, được gắn nhãn là “nhận diện tự động” kèm theo công cụ, mô hình và một đoạn trích; nó không bao giờ được hiển thị dưới dạng văn bản đã gửi trên Telegram. Chỉ mục này cũng được sử dụng cho **tính năng Tìm kiếm văn bản đã nhận diện**, vốn vẫn hỗ trợ so khớp với các chuỗi con thuần túy. ## Truy cập Quyền truy cập trong phạm vi cuộc trò chuyện chỉ tìm thấy các bản ghi từ các cuộc trò chuyện đó, bao gồm cả văn bản được nhận diện từ các tệp đính kèm của chúng. `chat:` và các bộ lọc khác chỉ có thể thu hẹp tập dữ liệu đó. Trạng thái chỉ mục hiển thị cho quyền truy cập theo phạm vi không bao gồm tổng số bản ghi trong nhật ký. Chỉ quản trị viên chính mới có thể thay đổi chế độ hoặc xây dựng lại chỉ mục. ## Hỏi kho lưu trữ và MCP **Các công cụ khác → Ask the archive** truy xuất các nguồn từ chỉ mục này khi nó hoàn tất: các kết quả khớp tốt nhất trong các cuộc trò chuyện đã chọn, với mỗi đoạn văn bản được lưu chỉ được tính một lần. Tối đa 24 nguồn được gửi; các văn bản dài sẽ được cắt xung quanh phần khớp và được đánh dấu là bị cắt ngắn. Các câu hỏi về những thay đổi gần đây, các phiên bản đã lưu của một tin nhắn và các tìm kiếm trong khi chỉ mục vẫn đang được xây dựng sẽ sử dụng phương thức truy xuất theo thứ tự thời gian trước đó. Bản xem trước hiển thị phương pháp nào đã được sử dụng. Các khách hàng MCP có thể gọi `search_messages` với `ranked=true` và truy cập trang với `next_offset`. Các kết nối có phạm vi chỉ nhận được các cuộc trò chuyện của riêng họ. Chức năng phân trang theo thứ tự xếp hạng chỉ hiển thị tối đa các kết quả đầu tiên thuộc nhóm 1,000, bất kể kích thước trang. Hãy thu hẹp phạm vi truy vấn, cuộc trò chuyện hoặc khoảng thời gian để xem thêm các kết quả phù hợp. Chế độ tìm kiếm theo thứ tự từ mới nhất đến cũ nhất sẽ sắp xếp các tin nhắn, kết quả OCR và phiên âm trước khi chọn từng trang. ## Các thành phần phụ thuộc | Gói | Giấy phép | Tại sao | | --- | --- | --- | | pymorphy3, pymorphy3-dicts-ru, DAWG2-Python | MIT | Các từ gốc tiếng Nga và tiếng Ukraina; các từ điển được tải cục bộ | | snowballstemmer | Điều khoản BSD-3 | Các từ gốc tiếng Anh, Python thuần túy | | jieba | MIT | Phân đoạn truy vấn tiếng Trung, viết hoàn toàn bằng Python (chỉ phân phối mã nguồn) | | pymorphy3-dicts-uk (tùy chọn) | GPL-3.0 | Từ điển tiếng Ukraina đầy đủ | SQLite FTS5 yêu cầu có `unicode61` tokenizer; nó là một phần của SQLite trong các bản dựng Python hiện tại. Nếu thiếu nó, tính năng tìm kiếm kết quả phù hợp nhất sẽ báo lỗi rằng tính năng này không khả dụng. ## Đánh giá hiệu năng `python tools/bench_fulltext.py --messages 1000000 --work `tạo ra một nhật ký có chữ ký xác định trước chứa các tin nhắn hỗn hợp bằng tiếng Nga, tiếng Ukraina, tiếng Anh, tiếng Trung và tiếng Nhật kèm theo các liên kết và mã định danh trong 200 cuộc trò chuyện, xây dựng chỉ mục và đo thời gian thực hiện các tìm kiếm điển hình (50 kết quả, giá trị trung vị của 7 lần chạy). Được đo trên Windows 11, Intel Core i9-13900K, 128 GB RAM, Python 3.12.10, SQLite 3.49.1, dữ liệu trên ổ đĩa exFAT, trình phân tích `fulltext-v1+pymorphy3-ru+light-uk+snowball-en`: | Đo lường | Kết quả | | --- | --- | | Nhật ký được ký điện tử | 1.000.000 tin nhắn, 1,50 GiB, được ghi lại trong 19 phút | | Xây dựng chỉ mục từ nhật ký | 71 giây, khoảng 14.141 tin nhắn mỗi giây | | Tệp chỉ mục | 58 MiB, chiếm 3,8% dung lượng nhật ký | | Tìm kiếm ngay sau một bản ghi mới | Giá trị trung vị là 8 ms, p95 là 9 ms | | Tìm kiếm chuỗi con trước đó, cùng một nhật ký | `перевод` 3,2 giây, `银行转账` 2,6 giây, `verify-account.example` 2,6 giây | | Tìm kiếm | Các bản ghi khớp nhau | Kết quả phù hợp nhất, giá trị trung vị | trang 95 | Mới nhất trước, trung bình | | --- | --- | --- | --- | --- | | Từ thông dụng, các dạng từ: `перевод` | 134,403 | 82 ms | 85 ms | 7 ms | | Hai từ: `оплата карта` | 28,996 | 43 ms | 43 ms | 14 ms | | Từ hiếm: `розыгрыш подарок` | 28,881 | 42 ms | 47 ms | 13 ms | | Cụm từ chính xác: `"переказ коштів на картку"` | không được tính | 35 ms | 36 ms | 6 ms | | Tên miền cùng các tên miền con: `verify-account.example` | 12,435 | 17 ms | 17 ms | 3 ms | | @username: `@support_desk_bot` | 10,331 | 15 ms | 16 ms | 3 ms | | Tiếng Trung không có khoảng trắng: `银行转账` | 17,691 | 23 ms | 24 ms | 3 ms | | Tiếng Nhật: `リンク` | 16,603 | 23 ms | 25 ms | 3 ms | | Cơ sở tiếng Anh: `withdrawal` | 27,775 | 26 ms | 26 ms | 2 ms | | HOẶC và loại trừ: `бонус OR подарок -казино` | 268,034 | 190 ms | 193 ms | 19 ms | | Bộ lọc cuộc trò chuyện: `chat:-1000000000007 перевод` | 652 | 9 ms | 9 ms | 6 ms | | Bộ lọc theo khoảng thời gian: `since:2026-01-01 until:2026-01-31 выплата` | 115,732 | 155 ms | 156 ms | 81 ms | Một cụm từ chính xác sẽ được kiểm tra theo nghĩa đen trên các kết quả theo thứ tự xếp hạng cho đến khi trang đầy, do đó tổng số kết quả của nó không được tính. Thời gian xử lý tăng theo số lượng bản ghi khớp; hạn chế phạm vi cuộc trò chuyện hoặc khoảng thời gian sẽ giúp các tìm kiếm rộng diễn ra nhanh hơn. Bộ dữ liệu tổng hợp lặp lại một số từ vựng hạn chế, do đó các từ thông dụng sẽ khớp với nhiều bản ghi hơn so với trong các cuộc trò chuyện thực tế. --- # Telegram · MCP chỉ đọc Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/ Kết nối một máy khách MCP với các không gian làm việc và cuộc trò chuyện đã chọn bằng quyền truy cập có thời hạn và có thể thu hồi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Kết nối một máy khách MCP với các không gian làm việc và cuộc trò chuyện đã chọn bằng quyền truy cập có thời hạn và có thể thu hồi. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Tích hợp với các nền tảng lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/) ![Tích hợp với các nền tảng lưu trữ](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) Kết nối máy khách phân tích với các không gian làm việc và cuộc trò chuyện đã chọn. TgWitness cung cấp dịch **vụ Streamable HTTP tại `/mcp` trong quy trình bảng điều khiển**. Mỗi kết nối có mã thông báo, thời hạn và các công cụ được phép riêng. MCP không thể gửi tin nhắn Telegram, thay đổi cài đặt hoặc sửa đổi nhật ký có chữ ký. Các kết nối này cũng hoạt động với [dòng lệnh](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/). [Hướng dẫn quy trình làm việc](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Trên trang này** - [Cài đặt và kiểm tra](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/#install-and-check) - [Thiết lập kết nối](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/#issue-a-connection) - [Kết nối ứng dụng khách của bạn](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/#connect-your-client) - [Cloudflare Tunnel](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/#cloudflare-tunnel) - [Công cụ và giới hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/#tools-and-boundaries) ## Cài đặt và kiểm tra Sử dụng môi trường Python chạy bảng điều khiển. Từ bản mã nguồn đã tải về: ``` # Windows PowerShell & .\.venv\Scripts\python.exe -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' & .\.venv\Scripts\python.exe start.py --check ``` ``` # Linux / macOS .venv/bin/python -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' .venv/bin/python start.py --check ``` Khởi động lại bảng điều khiển với thư mục dữ liệu thông thường và các tham số khởi chạy sau khi cài đặt. Trạng thái sẵn sàng phải bao gồm `[PASS] mcp: streamable-http available`. **Chọn Công cụ khác → Tích hợp → MCP** để xem trạng thái thời gian chạy và lệnh cài đặt sử dụng tệp thực thi Python thực tế của máy chủ đó. **Chức năng Kiểm tra lại** sẽ làm mới trạng thái này mà không cần tải lại trang; chức năng này không cài đặt gói phần mềm hay khởi động lại máy chủ. Tiện ích MCP extra sử dụng [SDK Python chính thức của MCP](https://github.com/modelcontextprotocol/python-sdk). Tệp`deploy/constraints-mcp.txt` cố định phiên bản SDK và các phụ thuộc đã được kiểm thử. ## Cấp một kết nối 1. Nhập nhãn và chọn các không gian làm việc cũng như cuộc trò chuyện mà ứng dụng khách được phép đọc. 2. Chọn từng công cụ riêng lẻ hoặc sử dụng cấu hình đặt sẵn. Chỉ các công cụ đã được triển khai mới được cung cấp. 3. Chọn 1, 7, 30 hoặc 90 ngày, hoặc thời hạn tùy chỉnh từ một phút đến 90 ngày. 4. Nhấn **Create connection**. Mã thông báo sẽ xuất hiện một lần bên cạnh cấu hình ứng dụng khách. 5. Sao chép mã thông báo và cấu hình, sau đó chạy **Check connection**. Thao tác này sẽ khởi tạo MCP và liệt kê các công cụ được phép; **không có tin nhắn nào được đọc**. Kết quả hiển thị phiên bản giao thức, tên công cụ, số lượng và thời gian đã trôi qua. 6. Nhấn **Done** khi thông tin xác thực đã được lưu. Quá trình thăm dò sẽ giữ nguyên biểu mẫu và thẻ chỉ hiển thị một lần. Việc khóa bảng điều khiển sẽ xóa các thông tin bí mật đang hiển thị. Danh sách hiển thị lần sử dụng gần đây, công cụ cuối cùng, địa chỉ và các yêu cầu trong phút vừa qua. **Revoke** chấm dứt quyền truy cập. **Rotate token** thu hồi thông tin xác thực cũ và cấp một mã thay thế có cùng phạm vi, công cụ và thời hạn; hãy sao chép mã thay thế hiển thị một lần này. Mã thông báo đăng nhập bảng điều khiển và thông tin xác thực Telegram không hoạt động như mã thông báo MCP. ## Kết nối ứng dụng khách của bạn Chọn ứng dụng khách trong bảng điều khiển và sao chép cấu hình được tạo ra. Các cấu hình sử dụng tham chiếu bí mật hoặc trình giữ chỗ tường minh; mã thông báo được sao chép riêng. | Ứng dụng khách | Cấu hình | Kết nối | | --- | --- | --- | | Mã Claude | `.mcp.json` | HTTP, `type: "http"`, tiêu đề bearer | | Claude Desktop | `claude_desktop_config.json` | Cầu nối stdio cục bộ | | Cursor | `.cursor/mcp.json` | HTTP với tiêu đề biến môi trường | | VS Code Local | `.vscode/mcp.json` | HTTP với đầu vào mật khẩu `promptString` | | Windsurf | `mcp_config.json` | HTTP với trình giữ chỗ tiêu đề bearer | | Các ứng dụng khách khác | URL và tiêu đề Authorization | HTTP có thể truyền phát | TgWitness sử dụng mã thông báo bearer mà không cần khám phá OAuth. Sử dụng cầu nối stdio cục bộ cho các ứng dụng khách có trình kết nối từ xa yêu cầu OAuth. Đối với VS Code, các biến đầu vào áp dụng cho môi trường **Local** và không được chuyển tiếp tới các phiên Copilot. Tài liệu tham khảo cấu hình: [Claude Code](https://code.claude.com/docs/en/mcp), [Cursor](https://prod.cursor.com/docs/mcp), [VS Code](https://code.visualstudio.com/docs/agents/reference/mcp-configuration). Điểm nhập chuẩn cho cầu nối cục bộ là: ``` python -m tgwitness.mcp_server --url https://your-panel.example/mcp ``` Sử dụng Python cục bộ của ứng dụng khách đã cài đặt phần bổ sung MCP. Đặt `TGWITNESS_MCP_TOKEN` trong môi trường được bảo vệ của nó. Giữ thông tin xác thực ngoài các đối số lệnh và URL. `tgwitness-mcp` là cùng một điểm nhập. Mô-đun `tgwitness.mcp_bridge` cũ và tên `TGWITNESS_ARCHIVE_TOKEN` vẫn được giữ lại làm đường dẫn tương thích kèm theo cảnh báo; các cấu hình mới sử dụng `mcp_server` và `TGWITNESS_MCP_TOKEN`. ## Cloudflare Tunnel Chuyển tiếp tuyến đường `/mcp` của bảng điều khiển và giữ nguyên tiêu đề bearer. Việc mở cài đặt MCP với tư cách quản trị viên sẽ đăng ký nguồn (origin) hiện tại của bảng điều khiển cho lần chạy này. Để có một địa chỉ ổn định khả dụng ngay sau khi khởi động lại, hãy cấu hình `TGWITNESS_PUBLIC_URL` với nguồn HTTPS của bảng điều khiển trước khi khởi động bảng điều khiển. Các tiêu đề Host và tiêu đề được chuyển tiếp tùy ý không đăng ký một địa chỉ đáng tin cậy. Việc kiểm tra Host và Origin sẽ từ chối các nguồn trình duyệt không liên quan. Các phản hồi sử dụng `Cache-Control: no-store`; các giá trị ủy quyền không bao giờ được ghi vào nhật ký. Địa chỉ `*.trycloudflare.com` chỉ là tạm thời. Khi việc khởi động lại đường hầm làm thay đổi tên máy chủ (hostname), hãy cập nhật URL công khai đã cấu hình và URL MCP của từng ứng dụng khách. Sử dụng một tên máy chủ ổn định cho các cấu hình ứng dụng khách đã lưu. ## Công cụ và giới hạn | Công cụ | Dữ liệu đọc | | --- | --- | | `list_workspaces` | Các không gian làm việc được cấp quyền | | `list_chats` | Các cuộc trò chuyện được cấp quyền | | `search_messages` | Nội dung tin nhắn đã lưu trong khoảng thời gian đã chọn; `ranked=true` sử dụng [tính năng tìm kiếm toàn văn](https://phishdestroy.io/tgwitness/vi/docs/reference/search/) (các dạng từ, kết quả phù hợp nhất hiển thị trước, `next_offset` trang) | | `get_message_versions` | Các phiên bản đã thu thập và các ghi nhận xóa | | `get_message_context` | ID của các tin nhắn lân cận đã thu thập | | `get_journal_event` | Một bản ghi đã được làm sạch kèm theo tham chiếu nguồn của nó | | `get_capture_status` | Trạng thái thu thập, các bản ghi phạm vi được phép và `gap_summary`: số tin nhắn chưa từng được quan sát, theo từng kênh hoặc siêu nhóm và cho chuỗi tin nhắn toàn tài khoản ([chi tiết](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#missing-message-numbers-gap_summary)); chọn một cuộc trò chuyện để xem các khoảng trống được liệt kê trong đó | | `get_activity_stats` | Tin nhắn theo giờ UTC và ngày trong tuần, các ngày có lưu lượng cao nhất, tỷ lệ chỉnh sửa và xóa, người gửi, tên miền và `@handles`, kèm theo phạm vi bao phủ ([chi tiết](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/#activity-statistics)) | | `get_messages_by_date` | Các tin nhắn được lưu trữ trong một ngày dương lịch theo múi giờ IANA được đặt tên (`Europe/Kyiv`, `UTC`), theo thời gian mà Telegram báo cáo; `from_utc` và `until_utc` nêu rõ ngày đã tính toán, bao gồm cả giờ mùa hè | | `get_pinned_messages` | Các tin nhắn được ghim trong bản chụp nhanh trạng thái cuộc trò chuyện mới nhất cùng với các phiên bản đã lưu của chúng, cũng như các thông báo ghim và bỏ ghim được quan sát trực tiếp | | `get_chat_stats` | Số lượng bản ghi đã lưu với chi phí thấp cho một cuộc trò chuyện hoặc tất cả các cuộc trò chuyện trong phạm vi, quan sát đầu tiên và cuối cùng, và `gap_summary`; hãy sử dụng nó trước khi thực hiện thao tác đọc dữ liệu quy mô lớn | | `get_topics` | Các chủ đề diễn đàn từ tin nhắn dịch vụ chủ đề đã lưu: lịch sử tiêu đề, đã đóng hoặc ẩn, số lượng tin nhắn đã lưu | | `get_media` | Một hình ảnh được lưu giữ dưới dạng bản xem trước JPEG đã thu nhỏ (tối đa 36 KB), được trả về dưới dạng hình ảnh kèm theo mã SHA-256 và `media.saved` bản ghi; tệp này sẽ được kiểm tra so với giá trị băm đã ghi trước tiên, các tệp khác chỉ trả về siêu dữ liệu | | `export_messages` | Chỉ hỗ trợ dòng lệnh, không được chọn mặc định: lưu các quan sát dưới dạng JSON Lines ([chi tiết](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/#export)); không hỗ trợ qua MCP | Mỗi công cụ đều ở chế độ chỉ đọc (`readOnlyHint`) và khai báo một lược đồ đầu ra; các trường ngoài những trường đã khai báo sẽ được trả về nguyên trạng. `tools/list` chỉ trả về các công cụ được cấp quyền cho kết nối đó. Các yêu cầu đến các công cụ khác sẽ bị từ chối. Các công cụ bối cảnh nhóm, tập hợp sự kiện, thuật ngữ và chuỗi trả lời không được cung cấp trong bản dựng này; phần nền tảng gói bối cảnh riêng biệt của chúng không được bao gồm. Mọi thao tác đọc đều kiểm tra mã thông báo, công cụ và phạm vi không gian làm việc/cuộc trò chuyện, kể cả sau khi công việc của cơ sở dữ liệu hoàn tất. Giới hạn là 60 yêu cầu mỗi phút, 50 bản ghi mỗi trang, 64 KiB mỗi kết quả và thời hạn truy xuất kho lưu trữ là tám giây. Một lệnh gọi MCP hết thời gian chờ sẽ trả về lỗi công cụ yêu cầu khoảng thời gian hẹp hơn hoặc giới hạn thấp hơn. Kết quả tin nhắn chứa `untrusted_content: true`, ID không gian làm việc/cuộc trò chuyện/tin nhắn, chuỗi sự kiện, băm đã lưu và liên kết bảng điều khiển. Các đối tượng Telegram thô, băm truy cập, phiên làm việc và khóa được loại bỏ. Các đoạn văn bản bị cắt ngắn được đánh dấu. Các chỉnh sửa, thông báo xóa và `missing_on_recheck` là các quan sát riêng biệt. Phạm vi bao phủ cho thấy các khoảng thời gian mà kết quả đại diện. Xử lý các hướng dẫn bên trong các tin nhắn được thu thập như bằng chứng, không bao giờ coi đó là hướng dẫn dành cho khách hàng. Quyền truy cập chỉ đọc ngăn chặn việc thay đổi kho lưu trữ; khách hàng vẫn có thể lưu giữ nội dung mà họ được phép đọc. Các hàm băm xác định các bản ghi đã lưu và hỗ trợ kiểm tra tính toàn vẹn. Sử dụng các tài liệu tham khảo nguồn kèm theo và bản ghi phạm vi khi xem xét kết quả. --- # Telegram · Dòng lệnh Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/cli/ Tìm kiếm, đọc bối cảnh, đếm hoạt động và xuất các tin nhắn đã lưu từ các skript và tác nhân, với đầu ra --json, mã thoát ổn định và các token chỉ đọc có phạm vi giới hạn. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Translation coverage: this edition includes material from the English original. Tìm kiếm, đọc bối cảnh, đếm hoạt động và xuất các tin nhắn đã lưu từ các skript và tác nhân, với đầu ra --json, mã thoát ổn định và các token chỉ đọc có phạm vi giới hạn. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Tích hợp với các nền tảng lưu trữ](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [MCP chỉ đọc](https://phishdestroy.io/tgwitness/vi/docs/reference/mcp/) · [Tìm kiếm toàn văn](https://phishdestroy.io/tgwitness/vi/docs/reference/search/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Preview.** `tgwitness search`, `context`, `messages`, `stats` and `export` read saved observations for scripts and AI agents. They cannot send anything to Telegram, change settings or modify the signed journal. `tgwitness index` and `tgwitness backup` ([below](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/#index-and-backup)) work on a local data directory and need no token. Với `--json`, stdout chứa chính xác một tài liệu JSON (`export` viết dưới dạng JSON Lines). Tiến trình, gợi ý và lỗi được gửi đến stderr. Mã thoát là ổn định: | Mã nguồn | Ý nghĩa | | --- | --- | | `0` | Thành công, bao gồm cả kết quả trống | | `1` | Lỗi: không thể truy cập bảng điều khiển, dữ liệu không thể đọc được, quá trình xuất bị gián đoạn | | `2` | Lỗi sử dụng hoặc yêu cầu không hợp lệ: ngày tháng không đúng, tùy chọn không xác định, chỉ mục tìm kiếm bị tắt | | `3` | Hiện không khả dụng: không gian làm việc đang được mở trong một bảng điều khiển đang chạy, hoặc bảng điều khiển yêu cầu thử lại sau (giới hạn tốc độ, hết thời gian chờ) | | `4` | Truy cập bị từ chối: mã thông báo thiếu, đã hết hạn hoặc bị thu hồi, cuộc trò chuyện nằm ngoài phạm vi cho phép, hoặc công cụ không hỗ trợ | ## Hai cách để đọc **Thông qua bảng điều khiển (`--url`).** Lệnh này sử dụng cùng API lưu trữ có phạm vi như MCP. Tạo kết nối trong **More tools → Integrations → MCP**: chọn không gian làm việc và các cuộc trò chuyện, công cụ và thời hạn hết hiệu lực, sau đó sao chép mã thông báo một lần. Kết nối này chỉ dành cho đọc, giới hạn trong các cuộc trò chuyện đó, bị giới hạn tốc độ ở mức 60 yêu cầu mỗi phút và có thể bị thu hồi hoặc đổi mới bất cứ lúc nào. Mã thông báo đăng nhập bảng điều khiển và thông tin đăng nhập Telegram không hoạt động ở đây. ``` export TGWITNESS_URL=https://panel.example.org # default http://127.0.0.1:8787 export TGWITNESS_MCP_TOKEN=tgw_mcp_... # or --token-file path tgwitness search 'перевод карта' --json ``` Bảng điều khiển từ xa cần sử dụng HTTPS; HTTP thuần túy chỉ được chấp nhận cho `127.0.0.1`, `localhost` và `::1`. Các biến môi trường proxy sẽ bị bỏ qua và các chuyển hướng sẽ bị từ chối, do đó mã thông báo chỉ đến được địa chỉ mà bạn cung cấp. **Trực tiếp từ một không gian làm việc đã dừng (`--data-dir`).** Đọc thư mục dữ liệu với quyền truy cập cục bộ đầy đủ, không cần mã thông báo. Sử dụng trên bản sao của thư mục dữ liệu hoặc khi quá trình thu thập dữ liệu đã dừng. Các bản ghi được ký số không bao giờ bị thay đổi; giống như bảng điều khiển, việc mở một không gian làm việc có thể cập nhật các chỉ mục được tạo ra từ đó. Khi bảng điều khiển đang mở không gian làm việc, lệnh sẽ thoát với mã `3`; hãy đọc thông qua bảng điều khiển thay thế. Nếu không có `--data-dir`, `TGWITNESS_DATA`, `./data/live` hoặc thư mục dữ liệu của bản cài đặt đang chạy lệnh sẽ được sử dụng. `--workspace ID` chọn một không gian làm việc (mặc định `default`). `tgwitness messages --workspaces` hiển thị danh sách các không gian làm việc mà bạn có quyền truy cập. ## Lệnh | Lệnh | Kết quả | | --- | --- | | `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | Hiển thị kết quả phù hợp nhất trước tiên, bao gồm các dạng từ, cụm từ chính xác trong dấu ngoặc kép, tên miền và `@username` ([cú pháp](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#search-syntax)) | | `tgwitness search QUERY --exact [--before SEQ]` | Văn bản chính xác, mới nhất trước, không bao gồm chỉ mục | | `tgwitness context CHAT_ID MESSAGE_ID [--limit N] [--before SEQ]` | Các tin nhắn được lưu trữ trong phạm vi mười ID tin nhắn ở cả hai phía | | `tgwitness messages [--limit N] [--offset N]` | Các cuộc trò chuyện bạn có thể đọc | | `tgwitness messages CHAT_ID [--since] [--until] [--limit N] [--before SEQ]` | Các tin nhắn đã lưu trong cuộc trò chuyện, sắp xếp theo thứ tự từ mới nhất đến cũ nhất | | `tgwitness messages CHAT_ID --message ID` | Mọi phiên bản đã lưu và bản ghi xóa của một tin nhắn | | `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | Thống kê hoạt động, như sau | | `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | Các quan sát được lưu dưới dạng JSON Lines theo thứ tự trong nhật ký | Ngày tháng được tính theo `2026-10-01` (nửa đêm theo giờ UTC) hoặc theo định dạng giờ ISO kèm múi giờ, `2026-10-01T09:00+03:00`. Đối với `search`, `messages` và `export` họ chọn thời gian quan sát. Các trang chứa tối đa 50 bản ghi: làm theo `next_offset` (`--offset`) để tìm kiếm theo thứ hạng và `next_before` (`--before`) ở nơi khác. Ranked search stops at 1,000 results. The final page may be shorter than `--limit`. When more observations match, the last page says so (`truncated: true` with `--json`); narrow the query, chat or period. Mỗi kết quả tin nhắn đều chứa `untrusted_content: true` , ID không gian làm việc, ID cuộc trò chuyện và ID tin nhắn, chuỗi nhật ký, băm bản ghi đã lưu và liên kết bảng điều khiển. Các chỉnh sửa, thông báo xóa và `missing_on_recheck` là các bản ghi riêng biệt. Phạm vi bao phủ trong `stats` cho thấy các khoảng thời gian mà kết quả tìm kiếm đại diện. ### Thống kê hoạt động `stats` đếm số quan sát đã lưu cho một cuộc trò chuyện, một người gửi hoặc tất cả các cuộc trò chuyện trong phạm vi: - các tin nhắn theo giờ UTC và theo ngày trong tuần (bắt đầu từ thứ Hai), các khung giờ và ngày có lưu lượng cao nhất; - đã chỉnh sửa, đã xóa và `missing_on_recheck` chia sẻ; - người gửi kèm theo số lượng tin nhắn và thời gian gửi tin nhắn đầu tiên và cuối cùng; - các tên miền xuất hiện thường xuyên nhất và `@handles`, được tính một lần cho mỗi tin nhắn trên các phiên bản đã lưu của nó; - phạm vi: `coverage.gap` các bản ghi và, để truy cập toàn bộ không gian làm việc, các khoảng thời gian không có tín hiệu kiểm tra trạng thái từ bộ thu thập (`collector_liveness`). Khoảng thời gian này chọn **thời gian tin nhắn được Telegram báo cáo**. Số giờ và ngày trong tuần giúp ước tính múi giờ của người gửi. Các con số được tính toán theo yêu cầu từ nhật ký và không được lưu trữ. Mỗi kết quả chỉ định tiêu đề nhật ký mà nó bao phủ khi quyền truy cập của bạn trải dài qua không gian làm việc. Việc đọc sẽ dừng lại sau năm giây qua bảng điều khiển, hoặc sau `--timeout` giây trên máy cục bộ (mặc định là 30); sau đó `complete` sẽ là false và `partial` chỉ định bản ghi đầu tiên chưa được đọc. Trong trường hợp đó, chỉ các bản ghi mới nhất mới được tính. ### Xuất `export` Ghi một đối tượng JSON cho mỗi quan sát được lưu (tin nhắn mới, ảnh chụp màn hình, sửa đổi, tin nhắn khôi phục, thông báo xóa, `missing_on_recheck` và các bản ghi phương tiện được lưu) theo thứ tự trong nhật ký. Mỗi dòng có các trường giống như các kết quả khác, kèm theo toàn văn. Với `--output`, tệp được ghi dưới một `.partial` tên và chỉ được đổi tên sau khi bản ghi hoàn tất của bảng điều khiển; việc xuất bị gián đoạn sẽ không để lại tệp nào và thoát với mã `1`. `--output` không bao giờ ghi đè lên tệp hiện có. Với `--output` và `--json`, stdout hiển thị một bản tóm tắt: số lượng bản ghi, chuỗi nhật ký cuối cùng và, đối với quyền truy cập toàn bộ không gian làm việc, đầu nhật ký. Việc xuất dữ liệu qua bảng điều khiển yêu cầu kết nối cho phép gửi**tin nhắn Export (chỉ dành cho dòng lệnh)** ; tùy chọn này không được chọn mặc định. Tệp này là bản sao làm việc; để thực hiện việc chuyển giao có thể xác minh, hãy sử dụng tệp xuất đã ký trong **phần Exports** , được kiểm tra bằng lệnh `python -m tgwitness.verify` . Bảng điều khiển sẽ kiểm tra lại quyền truy cập trước khi xuất mỗi bản ghi, bao gồm cả bản ghi hoàn tất. Quyền truy cập bị thu hồi hoặc hết hạn sẽ dẫn đến việc xuất dữ liệu không đầy đủ. Các lần đọc trang theo cơ chế lười biếng chia sẻ giới hạn công việc lưu trữ với các truy vấn khác và có thời gian chờ giới hạn. ### Index and backup These two commands read the data directory directly and take no token or `--url`. | Lệnh | Kết quả | | --- | --- | | `tgwitness index status [--workspace ID] [--data-dir DIR] [--json]` | Search index state of one workspace or, by default, every workspace: mode, `ready`, `building` or `not built`, indexed and journal head sequence. Works while the panel runs | | `tgwitness index rebuild [--workspace ID] [--data-dir DIR] [--json]` | Rebuilds the index from the first journal record. Rewrites only the derived index, never the signed journal. Exits with code `3` while the panel has the workspace open. Nothing is built when the workspace keeps its index in memory or has search off | | `tgwitness backup FOLDER [--data-dir DIR] [--json]` | Copies the whole data directory into a new or empty folder outside it while the panel keeps running, and writes `backup-manifest.json` with every file's SHA-256 and the journal heads | `index` accepts `--workspace default` or a workspace ID; the default is `all`. The backup skips temporary exports, SQLite sidecar files and lock files. The folder holds the Telegram session and signing keys, so keep it as private as the data directory. [Backup, restore, and capacity](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/#backup-restore-and-capacity) describes restoring and what the next start records. ## Kỹ năng của Agent [`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) hướng dẫn người dùng cách sử dụng các lệnh này, cách trích dẫn các bản ghi và cách xử lý văn bản đã thu thập. Người dùng tải `.agents/skills` tải nó từ bản checkout của kho lưu trữ . Đối với Claude Code, hãy sao chép `tgwitness-cli` thư mục này vào `.claude/skills/` trong dự án của bạn hoặc `~/.claude/skills/`. ## MCP và dòng lệnh Cả hai đều sử dụng cùng các kết nối, kiểm tra phạm vi và giới hạn. Kết quả MCP bị giới hạn trong một trang 64 KiB, do đó MCP không hỗ trợ xuất dữ liệu hàng loạt; dòng lệnh sẽ truyền dữ liệu theo luồng. `get_activity_stats` có sẵn cho cả hai. --- # Telegram · Nhận dạng ký tự quang học (OCR) và chuyển đổi văn bản tại địa phương Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/media-analysis/ Nhận diện hình ảnh và âm thanh đã thu thập bằng một worker cục bộ; duy trì liên kết giữa văn bản được trích xuất và tệp nguồn tương ứng. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Nhận diện hình ảnh và âm thanh đã thu thập bằng một worker cục bộ; duy trì liên kết giữa văn bản được trích xuất và tệp nguồn tương ứng. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Điều tra](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/) ![Điều tra](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Hướng dẫn quy trình làm việc](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Mở bản ghi nhật ký `media.saved` , chọn **“Nhận diện tệp đính kèm** ”, sau đó chọn OCR hoặc chuyển văn bản trong **mục Công cụ khác → Hỏi kho lưu trữ** (được gọi là **Nhận diện tự động** khi AI của kho lưu trữ bị tắt). Quá trình xử lý được thực hiện thủ công và tại địa phương. Không có chế độ phương tiện đám mây hoặc tính năng tải lên tự động. Dữ liệu gốc của tệp đính kèm và `media_sha256` vẫn giữ nguyên; văn bản được nhận diện được đánh dấu rõ ràng là nhận diện bằng máy và được lưu trữ riêng biệt cùng với băm nguồn, phiên bản công cụ/mô hình, ngôn ngữ, tham số và thời gian hoàn thành. Bản chép lời giữ nguyên dấu thời gian được trả về. Tìm kiếm các kết quả này bằng cách sử dụng **tính năng "Tìm kiếm văn bản được nhận diện"** và bộ lọc OCR/bản chép, hoặc chọn văn bản được nhận diện làm nguồn cho tìm kiếm khớp tốt nhất trong **Nhật** **ký**. Cả hai đều khớp các dạng từ thông qua [chỉ mục](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#recognized-text) [trong](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#recognized-text) [bộ](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#recognized-text) [nhớ](https://phishdestroy.io/tgwitness/vi/docs/reference/search/#recognized-text). Đây là một tìm kiếm dữ liệu dẫn xuất riêng biệt; nó không tự động chuyển đổi kết quả nhận diện máy thành văn bản Telegram gốc hoặc thêm nó vào các sự kiện được ký. ## Cài đặt worker tùy chọn Phiên bản 1 yêu cầu máy chủ Linux có daemon Docker cục bộ. Đối với các hệ thống Windows, có thể chạy TgWitness trong môi trường máy ảo Linux (VM) hoặc WSL với daemon cục bộ riêng. Bảng điều khiển không bao giờ tự giải mã tệp đính kèm không đáng tin cậy. ``` docker build -f deploy/media-worker/Dockerfile -t tgwitness-media:local . export TGWITNESS_MEDIA_IMAGE=tgwitness-media:local ``` Đặt các biến này trong môi trường dịch vụ TgWitness và khởi động lại dịch vụ. Socket daemon mặc định là `/var/run/docker.sock`; các triển khai không cần quyền root có thể đặt là `TGWITNESS_DOCKER_SOCKET`. Worker sử dụng rõ ràng socket Unix đó thay vì một bối cảnh Docker từ xa. Không được tiết lộ API Docker cho người dùng bảng điều khiển hoặc gắn socket của nó vào bên trong container nhận dạng. Để chuyển đổi văn bản, hãy cài đặt riêng một mô hình Whisper tương thích với CTranslate2, sau đó đặt `TGWITNESS_WHISPER_MODEL_DIR` thành thư mục chứa mô hình đó. Công cụ sẽ tải mô hình này bằng `local_files_only=True`; mô hình đã chọn và dữ liệu đầu vào sẽ được gắn ở chế độ chỉ đọc. Xem [tài liệu hướng dẫn tải mô hình](https://github.com/SYSTRAN/faster-whisper) của công cụ. Hình ảnh OCR được cung cấp bao gồm dữ liệu huấn luyện bằng tiếng Anh và tiếng Nga. Tích hợp thêm một ngôn ngữ khác vào hình ảnh của bạn khi cần thiết; mã ngôn ngữ tuân theo [CLI của Tesseract](https://tesseract-ocr.github.io/tessdoc/Command-Line-Usage.html). Không có mô hình nào được tải về trong quá trình xử lý. Quá trình xây dựng/tải xuống có thể sử dụng mạng; mỗi container nhận dạng thực tế đều bị vô hiệu hóa kết nối mạng. Hãy cài đặt hình ảnh trước khi kích hoạt nó; môi trường chạy sử dụng `--pull=never`. ## Giới hạn và khôi phục Container chạy dưới quyền người dùng không có đặc quyền với quyền root chỉ đọc, các khả năng bị giới hạn, `no-new-privileges` , một CPU, 2 GiB bộ nhớ, giới hạn PID và hệ thống tệp tạm thời có giới hạn. Chỉ bản sao đã được xác minh của tệp đã chọn và thư mục mô hình tùy chọn mới được gắn vào. Cơ sở dữ liệu, kho lưu trữ và phiên làm việc của bộ thu thập không được gắn vào. Các [cờ thời gian chạy Docker](https://docs.docker.com/reference/cli/docker/container/run/) áp đặt các giới hạn này; đây vẫn là ranh giới của container, không phải là vùng an toàn phần cứng. Các tệp được giới hạn ở 50 MiB, hình ảnh ở 20 triệu pixel, âm thanh ở 30 phút với thời lượng đã biết và thời gian xử lý là năm phút. Mỗi lần chỉ có một công nhân chạy, với tối đa 20 công việc đang xếp hàng/đang chạy và 100 công việc được lưu giữ cho mỗi không gian làm việc. Lệnh "Cancel" sẽ dừng container; lệnh "retry" sẽ tạo một tác vụ mới liên kết với lần thử trước đó. Các tác vụ bị gián đoạn sẽ được đánh dấu sau khi khởi động lại. Quá trình xử lý có thể thất bại khi mô hình không phù hợp với các giới hạn đã cấu hình; nó sẽ không chạy âm thầm mà không có sự cách ly. --- # Telegram · Webhook đi Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/webhooks/ Gửi các sự kiện trong phạm vi đến các máy chủ nhận HTTPS kèm theo chữ ký HMAC, tính năng thử lại và trạng thái giao nhận. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Gửi các sự kiện trong phạm vi đến các máy chủ nhận HTTPS kèm theo chữ ký HMAC, tính năng thử lại và trạng thái giao nhận. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Tích hợp với các nền tảng lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/cli/) ![Tích hợp với các nền tảng lưu trữ](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [Hướng dẫn quy trình làm việc](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Mở **thêm công cụ → Tích hợp → Webhook đi** trong không gian làm việc đã chọn. Thêm một bộ thu HTTPS , chọn các sự kiện thu thập dữ liệu/phương tiện/xuất, và tùy chọn chọn các cuộc trò chuyện cho các quan sát mới và thay đổi. Văn bản tin nhắn bị tắt theo mặc định. Việc bật trích đoạn sẽ thêm tối đa 1,000 ký tự vào các sự kiện thay đổi tin nhắn; các trường Telegram thô và thông tin đăng nhập không bao giờ được gửi đi. Sao chép khóa bí mật HMAC một lần vào cấu hình được bảo vệ của máy nhận. Khóa này được mã hóa trong kho lưu trữ của TgWitness và không thể truy xuất từ bảng điều khiển. Xóa và tạo lại đích đến để luân phiên sử dụng. **Gửi** một thử nghiệm không chứa nội dung trò chuyện đến hàng đợi**thử nghiệm tổng hợp**; làm mới trạng thái gửi để xem kết quả. Chức năng gửi thông báo mở rộng vòng lặp thông báo hiện có cùng với Apprise. Nó sử dụng tuyến đường bên ngoài của không gian làm việc và các hạn chế về đích riêng tư hiện có. Không có cơ chế dự phòng trực tiếp hoặc chuyển hướng nào sau đó. Các URL không được chứa thông tin đăng nhập, chuỗi truy vấn hoặc đoạn URL; các địa chỉ riêng tư yêu cầu sự đồng ý ở cấp độ mạng máy chủ, không phải là cài đặt mà người dùng bảng điều khiển có thể bỏ qua. ## Dữ liệu và chữ ký Cấu trúc: [`tgwitness.webhook/1`](https://github.com/phishdestroy/TgWitness/blob/main/integrations/webhook.schema.json). Mỗi gói dữ liệu chứa `event_id`, `timestamp`, `workspace`, `type`, `synthetic` và các bộ đếm. Các sự kiện dựa trên nhật ký bao gồm thứ tự và giá trị băm của chúng. Việc hoàn tất xuất toàn bộ và các bài kiểm tra tổng hợp là các sự kiện giao nhận, không có tham chiếu nhật ký đã ký được tạo ra. Thông báo xóa trên Telegram và `missing_on_recheck` vẫn là các loại riêng biệt. Tiêu đề `X-TgWitness-Signature` là `t=UNIX_SECONDS,v1=HEX_HMAC_SHA256`. Tính toán HMAC trên các byte chính xác `timestamp + "." + raw_request_body`, sử dụng khóa bí mật được hiển thị dưới dạng byte UTF-8. So sánh chữ ký trong thời gian hằng số trước khi phân tích hoặc thực hiện thao tác trên nội dung. Từ chối các dấu thời gian cách xa hơn năm phút so với đồng hồ của bạn. Dấu thời gian được làm mới ở mỗi lần cố gắng gửi. Sử dụng `event_id` làm khóa idempotency trong bộ nhớ bền vững, kèm theo ràng buộc duy nhất nguyên tử trước khi xảy ra tác dụng phụ. Một chữ ký hợp lệ đơn thuần không ngăn chặn được việc một yêu cầu gần đây bị tái phát. Giữ lại các ID đã xử lý ít nhất trong toàn bộ khoảng thời gian thử lại; lưu giữ chúng lâu hơn nếu người nhận có thể xử lý lại các sự kiện đã lưu trữ. ## Thử lại Các lần gửi được xếp hàng bền vững trước các yêu cầu HTTP. Chúng sử dụng ngữ nghĩa ít nhất một lần : việc mất xác nhận hoặc khởi động lại có thể khiến một sự kiện được gửi lại với cùng ID. Có tám lần thử với cơ chế lùi thời gian theo cấp số nhân, bắt đầu từ 15 giây và giới hạn tối đa là một giờ. Thành công yêu cầu phản hồi 2xx. Một tác vụ đã hết số lần thử lại vẫn hiển thị cùng lỗi của nó để xem xét. Hàng đợi chứa 1.000 lần gửi. Khi đầy, quá trình quét các sự kiện trong nhật ký sẽ tạm dừng và tiếp tục sau khi có dung lượng trống. Việc hoàn tất xuất toàn bộ dữ liệu mà không thể xếp vào hàng đợi sẽ hiển thị lỗi hàng đợi. Mỗi lần thông báo sẽ thực hiện tối đa năm lần gửi và 100 bản ghi thử gửi gần nhất sẽ được lưu giữ. Việc xóa một đích đến cũng sẽ xóa các bản gửi đang chờ xử lý của đích đó. ## Ví dụ về n8n Nhập [quy trình làm việc mẫu](https://github.com/phishdestroy/TgWitness/blob/main/integrations/n8n-tgwitness.json). Quy trình này hiện không hoạt động và không chứa thông tin bí mật hay các hành động tiếp theo. Đặt `TGWITNESS_WEBHOOK_SECRET` trong môi trường n8n worker, cho phép truy cập vào môi trường đó và cho phép hàm tích hợp `crypto` cho nút Code. Ví dụ này sử dụng tùy chọn raw-body của nút Webhook, kiểm tra chữ ký/độ mới và xác nhận các sự kiện đã được xác thực. Điều này phù hợp với [cách triển khai được ghi trong tài liệu](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/Webhook/Webhook.node.ts) của nút. Trước khi thêm các lệnh ghi hoặc thông báo SIEM, hãy thêm bộ lưu trữ bền vững và idempotent được mã hóa bằng khóa `event_id`. Hạn chế việc chỉnh sửa quy trình làm việc n8n và thời gian lưu trữ nhật ký thực thi theo dữ liệu mà bạn đã chọn để gửi. TgWitness không thêm bất kỳ lệnh nào từ bên ngoài. --- # Telegram · Trưng bày công khai Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/showcase/ Xuất bản các tin nhắn đã lưu từ các kênh công khai được chọn và các bản chụp màn hình đã được ký thông qua các liên kết có thời hạn và có thể thu hồi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Xuất bản các tin nhắn đã lưu từ các kênh công khai được chọn và các bản chụp màn hình đã được ký thông qua các liên kết có thời hạn và có thể thu hồi. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Triển khai và khôi phục](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) ![Triển khai & khôi phục](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **Các công cụ khác → Truy cập → Trình diễn công khai** tạo ra một trang riêng biệt, chỉ đọc bằng cách sử dụng hệ thống access-token hiện có. Nó đọc các quan sát đã được lưu trữ của hệ thống cài đặt. Nó không khởi động bộ thu thập, đăng nhập vào Telegram hoặc tạo kênh cho người truy cập. ## Xuất bản một trang 1. Lưu một hồ sơ nguồn cho mỗi kênh công khai mà bạn muốn hiển thị. Một kênh phải có tên người dùng công khai trong hồ sơ được lưu gần nhất; các nhóm và cuộc trò chuyện riêng tư không đủ điều kiện. 2. Mở **thêm công cụ → Truy cập → Trưng bày công khai** (hoặc `/showcase-manage.html`) với tư cách quản trị viên. 3. Chọn các kênh từ tối đa 16 không gian làm việc, nhập tiêu đề trang công khai và chọn thời hạn tồn tại của liên kết là 1, 7 hoặc 30 ngày. Các nhãn nội bộ của không gian làm việc sẽ không được công khai. Có thể bao gồm tối đa 64 kênh. 4. Xem lại nội dung văn bản của các kênh đã chọn để xuất bản, sau đó nhấp vào **“Xem trước các bản ghi đã chọn**”. Bản xem trước sử dụng cùng một cách hiển thị phía máy chủ như trang dành cho khách truy cập. 5. Nhấp vào **liên kết “Tạo showcase**”. Sao chép liên kết khi nó còn hiển thị. Mở liên kết đó trong một trình duyệt riêng để xem trước trang của người nhận trước khi chia sẻ. Liên kết chứa mã thông báo truy cập trong phần URL fragment. Trang web sẽ loại bỏ phần fragment này trước khi thực hiện các yêu cầu API và đổi nó lấy một phiên trình duyệt. Bất kỳ ai có liên kết này đều có thể mở tài liệu đã chọn cho đến khi hết hạn hoặc bị thu hồi. Các liên kết mới cho phép 100 phiên truy cập đồng thời, mỗi phiên kéo dài tối đa một giờ. Các kiểm soát truy cập hiện có cũng có thể áp dụng các hạn chế về địa chỉ và giới hạn đăng nhập thông qua API cấp quyền. Quyền truy cập bình thường của người đánh giá là một chế độ khác và vẫn bao gồm các tin nhắn và tệp được phép ban đầu. ## Những gì người truy cập nhìn thấy | Hiển thị | Được giữ riêng tư | | --- | --- | | Các tiêu đề kênh công khai, tên người dùng và ngày quan sát hồ sơ được chọn lọc | Danh tính tài khoản, nhãn không gian làm việc nội bộ và các nguồn chưa được chọn | | Văn bản được ghi lại và mỗi lần chỉnh sửa đã lưu | ID người gửi, tên, tên người dùng, số điện thoại và các giá trị hồ sơ được cấu trúc | | Ghi lại các quan sát khi xóa kèm theo văn bản đã lưu trước đó (nếu có) | Tệp đính kèm, ảnh đại diện, hình thu nhỏ, tên tệp và nội dung gốc | | Các dấu hiệu cho biết tác giả/hồ sơ hoặc tệp đính kèm đã được ghi lại | Siêu dữ liệu chuyển tiếp và trả lời, các tuyến mạng, địa chỉ IP và thông tin đăng nhập | | Số lượng sự kiện trên các kênh đã chọn, trạng thái bật/tắt bộ sưu tập hiện tại, tín hiệu kiểm tra và khoảng thời gian kiểm tra định kỳ | Các điều khiển bộ sưu tập và các API xuất bằng chứng thông thường | | Dấu vân tay ký, điểm kiểm tra nhật ký và bằng chứng nhất quán | Khóa ký và phiên Telegram | **Nội dung tin nhắn công khai không được ẩn danh tự động.** Tên, đề cập, số điện thoại hoặc liên kết được ghi trong tin nhắn vẫn là một phần của nội dung đó. `Redacted`Áp dụng cho các trường tác giả/hồ sơ có cấu trúc. Hãy xem lại nội dung đã chọn thực tế trước khi đăng tải, bao gồm cả các chỉnh sửa và xóa đã được lưu lại. Tính đủ điều kiện phản ánh **hồ sơ nguồn được lưu gần nhất**, không phải kết quả tra cứu Telegram theo thời gian thực. Nếu hồ sơ tiếp theo không còn tên người dùng kênh công khai, các yêu cầu mới sẽ loại trừ kênh đó. Hãy làm mới hồ sơ nguồn khi tính năng hiển thị công khai thay đổi. Người đọc có thể đã lưu trữ các tài liệu mà họ đã nhận được trước đó. Các bản ghi có chữ ký gốc vẫn không thay đổi. Bản chiếu được hiển thị được ký riêng biệt và chứa các hàm băm tham chiếu đến các bản ghi gốc của nó. Chữ ký của bản chiếu xác thực tuyên bố được hiển thị, và các bản ghi gốc được tham chiếu vẫn giữ nguyên chữ ký của riêng chúng. ## Kiểm tra chữ ký và tính liên tục Mở rộng **"Dấu vân tay & điểm kiểm tra đã ký**" và tải xuống bản chụp nhanh. Sau khi trang được làm mới, tệp tải xuống sẽ bao gồm bản chụp nhanh trình duyệt trước đó và bằng chứng tính nhất quán Merkle giữa các ranh giới nhật ký của chúng. Tự động làm mới diễn ra mỗi phút một lần khi trang đang hiển thị và đang hiển thị trang quan sát đầu tiên. Sau khi cài đặt TgWitness, hãy xác minh tệp đã tải xuống ở chế độ ngoại tuyến: ``` python -m tgwitness.showcase_verify showcase.json --fingerprint TRUSTED_COLLECTOR_SHA256 ``` Dấu vân tay phải đến từ một nguồn tham chiếu đáng tin cậy riêng biệt. Để so sánh với bản chụp nhanh mà bạn đã tự lưu giữ, hãy sử dụng `--previous earlier.json`; điều này sẽ ghi đè lên bản chụp nhanh trước đó được chứa trong tệp tải xuống. Bằng chứng hiện tại phải bắt đầu từ ranh giới đã lưu giữ đó. Các khách hàng đã được xác thực có thể yêu cầu bằng chứng đó bằng cách sử dụng `GET /api/showcase/{workspace_id}?challenge=<32-hex-random>&from_count=`. Một nhật ký ngắn hơn sẽ trả về mã trạng thái HTTP 409 thay vì tự động đặt lại ranh giới mà không có thông báo. Điểm kiểm tra đã ký được ghi vào **toàn bộ nhật ký thu thập**, bao gồm cả số lượng bản ghi và hàm băm đầu mờ. Số lượng tin nhắn hiển thị chỉ áp dụng cho các kênh công khai đã chọn. Trang này không bao giờ liệt kê nội dung của các nhật ký khác. Đây là số lượng sự kiện, không phải số lượng tin nhắn duy nhất. Các cài đặt mô tả cấu hình hiện tại, không phải mọi khoảng thời gian ghi trước đó. Xác minh chữ ký và tính nhất quán có thể phát hiện các thay đổi so với một ranh giới được lưu giữ. Kiểm đếm lại các sự kiện được báo cáo từ kho lưu trữ tương ứng và xem xét các khoảng thời gian thu thập cùng với các điểm kiểm tra của nhân chứng được lưu giữ. Sử dụng [công cụ xác minh bằng chứng](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md), [nhân chứng độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/) và [bản ghi quy mô đã được kiểm thử](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/). Các cài đặt tổng hợp được dán nhãn rõ ràng là tổng hợp. ## Hủy quyền truy cập hoặc lưu trữ trang Sử dụng **tính năng “Revoke”** trong trình quản lý showcase hoặc phần **“Access**” hiện có để đóng liên kết và kết thúc tất cả các phiên của nó. Người truy cập sẽ xóa các bản ghi đang hiển thị khi yêu cầu phát hiện rằng quyền truy cập đã kết thúc. Thời hạn và quyền truy cập được kiểm tra trên mỗi yêu cầu. Quyền truy cập showcase không thể chuyển đổi trực tiếp thành quyền truy cập bảng điều khiển thông thường; hãy tạo một quyền truy cập mới để thay đổi chế độ. Trang web được phục vụ thông qua địa chỉ HTTPS hiện có của hệ thống cài đặt. Việc chia sẻ một liên kết sẽ không mở cổng mới, tạo đường hầm hoặc thay đổi DNS. Mã HTML và API vẫn được lưu trữ trên hệ thống cài đặt của người dùng. Người truy cập bản demo không thể sử dụng các API thông thường liên quan đến tin nhắn, hồ sơ, phương tiện, xuất dữ liệu hoặc quản lý với quyền truy cập này. --- # Telegram · Cách thức hoạt động của bằng chứng Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/how-it-works/ Các khái niệm về chuỗi băm, chữ ký, điểm kiểm tra và nhân chứng được giải thích kèm theo các công thức chính xác mà bên xác minh sử dụng. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Các khái niệm về chuỗi băm, chữ ký, điểm kiểm tra và nhân chứng được giải thích kèm theo các công thức chính xác mà bên xác minh sử dụng. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bằng chứng và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) ![Bằng chứng & xác minh](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness lưu giữ những gì tài khoản thu thập đã quan sát được, liên kết các quan sát đó vào một nhật ký được ký điện tử và cho phép người khác xác minh bản xuất dựa trên một khóa tin cậy, thời gian bên ngoài từ bên thứ ba và một điểm kiểm tra được lưu giữ trước đó. [Trang web tài liệu địa](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally) [phương](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally) bổ sung các ví dụ tương tác tại `/docs/concepts/`, công cụ khám phá quyết định tại `/docs/witness/`, và các hướng dẫn chi tiết về [Case Board](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/), [thiết kế báo cáo](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) và [trích xuất quá trình bàn giao](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#handover-extract). Tất cả các tin nhắn ví dụ, số lượng và thời gian trễ đều là hư cấu. Các giá trị băm trong môi trường thử nghiệm chuỗi được tính toán bằng SHA-256 trong trình duyệt. Không có dữ liệu nào được gửi đến Telegram. **Trên trang này** - [Tin nhắn thay đổi; các quan sát tích lũy](https://phishdestroy.io/tgwitness/vi/docs/reference/how-it-works/#a-message-changes-observations-accumulate) - [Phạm vi bao phủ của một hàm băm](https://phishdestroy.io/tgwitness/vi/docs/reference/how-it-works/#what-a-hash-covers) - [Điều mà một điểm kiểm tra trước đó bổ sung](https://phishdestroy.io/tgwitness/vi/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds) - [Vị trí của một nhân chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/how-it-works/#where-a-witness-belongs) - [Kiểm tra việc thực hiện so với các hành động đã biết](https://phishdestroy.io/tgwitness/vi/docs/reference/how-it-works/#test-delivery-against-known-actions) - [Chọn quy trình làm việc](https://phishdestroy.io/tgwitness/vi/docs/reference/how-it-works/#pick-a-workflow) ## Một tin nhắn thay đổi; các quan sát được tích lũy Sơ đồ trình tự · Telegram → Trình thu thập: Tin nhắn mới: Hẹn gặp lúc 10:00; Trình thu thập → Sổ nhật ký có chữ ký: Thêm tin nhắn.new; Telegram → Trình thu thập: Chỉnh sửa: Hẹn gặp lúc 11:00; Trình thu thập → Sổ nhật ký có chữ ký: Thêm tin nhắn.đã chỉnh sửa; Telegram → Trình thu thập: Thông báo về việc xóa nội dung; Trình thu thập → Sổ nhật ký có chữ ký: Thêm tin nhắn.đã xóa; Ghi chú về Sổ nhật ký có chữ ký: Các thông tin về nội dung gốc, nội dung đã chỉnh sửa và các thao tác xóa vẫn được lưu giữ · Telegram · Trình thu thập · Sổ nhật ký có chữ ký · Tin nhắn mới: Hẹn gặp lúc 10:00 · Thêm tin nhắn.new · Chỉnh sửa: Hẹn gặp lúc 11:00 · Thêm tin nhắn.đã chỉnh sửa · Thông báo về việc xóa nội dung · Thêm tin nhắn.đã xóa · Các thông tin về nội dung gốc, nội dung đã chỉnh sửavà các thao tác xóa vẫn được lưu giữ **Sơ đồ dưới dạng văn bản** 1. Telegram → Trình thu thập: Tin nhắn mới: Hẹn gặp lúc 10:00 2. Trình thu thập → Sổ nhật ký có chữ ký: Thêm tin nhắn.new 3. Telegram → Trình thu thập: Chỉnh sửa: Hẹn gặp lúc 11:00 4. Trình thu thập → Sổ nhật ký có chữ ký: Thêm tin nhắn.đã chỉnh sửa 5. Telegram → Trình thu thập: Thông báo về việc xóa nội dung 6. Trình thu thập → Sổ nhật ký có chữ ký: Thêm tin nhắn.đã xóa 7. Ghi chú về Sổ nhật ký có chữ ký: Các thông tin về nội dung gốc, nội dung đã chỉnh sửa và các thao tác xóa vẫn được lưu giữ Quy trình đơn giản hóa này giả định rằng Telegram đã gửi thành công mỗi bản cập nhật và tài khoản được chọn có thể xem được nội dung đó. Các sự kiện vận hành cũng được ghi lại trong sổ nhật ký. Thông báo xóa không cung cấp thông tin về người xóa hoặc thời gian xóa chính xác. Các lần gửi lặp lại được xem là các quan sát riêng biệt; không có cơ chế loại bỏ bản sao trùng lặp trên toàn bộ sổ nhật ký. ## Phạm vi bao phủ của một giá trị băm ![Quan sát, mã hóa, tính băm và ký số: mỗi sự kiện mới đều bao gồm giá trị băm của sự kiện trước đó.](https://phishdestroy.io/tgwitness/assets/evidence-chain-animated.svg?v=368c25a3be9c) Hãy đọc công thức từ trong ra ngoài: **C** chuyển chín trường dữ liệu thành các byte chính xác; **SHA-256** tạo ra giá trị băm của chúng; **hex** là định dạng lưu trữ giá trị băm đó. Giá trị băm trước đó đã có sẵn trong sự kiện. **unhex** chuyển giá trị băm đã lưu trữ trở lại thành 32 byte mà Ed25519 dùng để ký. [Sơ đồ chuỗi tĩnh](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg) Giả sử C(ei) là định dạng JSON chuẩn UTF-8 của chín trường sự kiện. Bản ghi đầu tiên `previous_hash` gồm 64 ký tự số 0. Mỗi bản ghi tiếp theo đều chứa mã băm thập lục phân của bản ghi trước đó: hi = hex(SHA256(C(ei))) σi = Ed25519.Sign(sk,unhex(hi)) Chữ ký bao phủ 32 byte băm thô. Dữ liệu đầu vào băm chứa chính xác các giá trị `seq`, `observed_at`, `source_at`, `kind`, `chat_id`, `message_id`, `actor_id`, `payload` và `previous_hash`. Các khóa đối tượng được sắp xếp theo thứ tự; khoảng trắng và ký tự ASCII được loại bỏ; các giá trị NaN và vô cực bị từ chối. Vui lòng tham khảo cách [mã hóa chính xác](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#event-canonicalization). Sơ đồ quy trình · 64 ký tự số 0 → Bản ghi 1 / băm h1; Bản ghi 1 / băm h1 → Bản ghi 2 bao gồm h1 / hash h2; Bản ghi 2 bao gồm h1 / hash h2 → Bản ghi số 3 bao gồm h2 / hash h3; Bản ghi số 3 bao gồm h2 / hash h3 → Điểm kiểm tra có chữ ký: số 3, tiêu đề h3 (lưu trữ ở nơi khác) · 64 ký tự số 0 · Bản ghi 1 / băm h1 · Bản ghi 2 bao gồm h1 /hash h2 · Bản ghi số 3 bao gồmh2 / hash h3 · Điểm kiểm tra có chữký: số 3, tiêu đề h3 · lưu trữ ở nơi khác **Sơ đồ dưới dạng văn bản** 1. 64 ký tự số 0 → Bản ghi 1 / băm h1 2. Bản ghi 1 / băm h1 → Bản ghi 2 bao gồm h1 / hash h2 3. Bản ghi 2 bao gồm h1 / hash h2 → Bản ghi số 3 bao gồm h2 / hash h3 4. Bản ghi số 3 bao gồm h2 / hash h3 → Điểm kiểm tra có chữ ký: số 3, tiêu đề h3 (lưu trữ ở nơi khác) | Thay đổi thành sổ nhật ký được cung cấp | Yếu tố nhận diện | | --- | --- | | Sửa đổi bản ghi số 2 trong khi vẫn giữ nguyên giá trị băm đã lưu trữ | Giá trị băm sự kiện được tính lại có sự khác biệt; chữ ký của nó không còn bao phủ sự kiện đã thay đổi nữa | | Phục hồi bản ghi đã bị thay đổi cùng mọi giá trị băm được tạo ra sau đó | Các chữ ký ban đầu không hợp lệ; một điểm kiểm tra được lưu giữ tại ranh giới bị ảnh hưởng cũng cho kết quả không khớp | | Loại bỏ phần đuôi nhưng giữ nguyên phần tiền tố còn lại | Một điểm kiểm tra được lưu giữ trước đó, nằm ngoài tiền tố được cung cấp, cho thấy tệp xuất ra quá ngắn | | Ký lại một sổ ghi chép thay thế bằng một khóa khác | Dấu vân tay khóa được xác thực độc lập sẽ từ chối danh tính thay thế | ![Việc thay đổi một trường dữ liệu đã lưu sẽ làm thay đổi giá trị băm của trường đó; việc tính toán lại các giá trị băm sẽ không khôi phục được các chữ ký ban đầu.](https://phishdestroy.io/tgwitness/assets/evidence-tamper-animated.svg?v=5ca92399bea5) **Hãy thử áp dụng logic này vào bản ghi số 2:** thay đổi `Meet at 11:00` thành `Meet at 12:00` trong sự kiện đã lưu. Giá trị băm được tính lại của nó sẽ không còn khớp nữa. Việc tính lại chuỗi sau đó có thể khôi phục các liên kết, nhưng không thể khiến các chữ ký ban đầu bao phủ các giá trị băm mới. Ngược lại, một thao tác chỉnh sửa được ghi nhận trên Telegram sẽ trở thành một bản ghi mới trong sổ nhật ký. [Sơ đồ thay đổi tĩnh](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg) Chỉ riêng các liên kết băm (hash links) không ngăn cản ai đó tính toán lại chuỗi thay thế. Sự tin cậy đến từ việc kiểm tra chữ ký dưới một khóa được tin cậy độc lập, thời gian bên ngoài từ một bên thứ ba xác định đầu nhật ký, và các tham chiếu được lưu giữ bên ngoài bộ thu thập. ## Những gì điểm kiểm tra trước đó bổ sung ![Giữ nguyên số đếm 3 và tiêu đề h3; việc xuất 4 bản ghi sau đó sẽ được kiểm tra tại vị trí số 3.](https://phishdestroy.io/tgwitness/assets/evidence-checkpoint-animated.svg?v=e68f4e7be4b9) **Điểm tham chiếu sẽ giữ nguyên trong khi nhật ký tiếp tục mở rộng.** Nếu điểm kiểm tra ghi là “3 bản ghi, tiêu đề h3”, thì việc xuất ra bốn bản ghi vẫn có thể thành công bằng cách khớp với h3 tại vị trí thứ 3. Tiêu đề mới nhất của nhật ký là h4, và dự kiến sẽ có sự khác biệt. Việc xuất ra chỉ hai bản ghi sẽ không thành công. [Sơ đồ điểm kiểm tra tĩnh](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg) Sau khi xác minh chữ ký tại điểm kiểm tra, yêu cầu: Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint Một bản xuất có thể vượt ra ngoài phạm vi của một điểm kiểm tra. Nó phải khớp tại ranh giới được giữ lại. Khóa của bộ thu thập ký vào điểm kiểm tra, do đó bộ thu thập có thể ký vào một điểm kiểm tra khác. Nó chỉ ràng buộc các bản ghi nếu người nhận đã nhận được nó trước khi lưu trữ, thông qua một kênh khác; yêu cầu tối thiểu cho bằng chứng cũng cần thời gian từ bên thứ ba. Người xác minh thực sự cũng kiểm tra trình tự, liên kết trước đó, hàm băm và chữ ký của mỗi sự kiện. Việc chỉ so sánh phần đầu cuối cùng được lưu trữ sẽ bỏ sót một bản ghi bên trong bị thay đổi mà hàm băm đã lưu của nó chưa được cập nhật. ## Vị trí thích hợp của một nhân chứng Sơ đồ quy trình · Trình thu thập / phiên tài khoản / khóa A → Điểm cuối kiểm tra chỉ đọc; Witness / khóa thu thập được ghim / khóa riêng B → Sổ nhật ký chứng cứ có chữ ký riêng biệt; Witness / khóa thu thập được ghim / khóa riêng B → Điểm cuối kiểm tra chỉ đọc (Yêu cầu kiểm tra); Điểm cuối kiểm tra chỉ đọc → Witness / khóa thu thập được ghim / khóa riêng B (Câu trả lời đã được ký xác nhận); Witness / khóa thu thập được ghim / khóa riêng B → Kênh với các bài đăng TGW1 đã được ký điện tử (API Bot / mã thông báo riêng) · Máy chủ A · Máy chủ B · Trình thu thập / phiên tàikhoản / khóa A · Điểm cuối kiểm tra chỉ đọc · Witness / khóa thu thậpđược ghim / khóa riêng B · Sổ nhật ký chứng cứ có chữký riêng biệt · Kênh với các bài đăng TGW1đã được ký điện tử · Yêu cầu kiểm tra · Câu trả lời đã được ký xác · nhận · API Bot / mã thông báo riêng **Sơ đồ dưới dạng văn bản** 1. Trình thu thập / phiên tài khoản / khóa A → Điểm cuối kiểm tra chỉ đọc 2. Witness / khóa thu thập được ghim / khóa riêng B → Sổ nhật ký chứng cứ có chữ ký riêng biệt 3. Witness / khóa thu thập được ghim / khóa riêng B → Điểm cuối kiểm tra chỉ đọc (Yêu cầu kiểm tra) 4. Điểm cuối kiểm tra chỉ đọc → Witness / khóa thu thập được ghim / khóa riêng B (Câu trả lời đã được ký xác nhận) 5. Witness / khóa thu thập được ghim / khóa riêng B → Kênh với các bài đăng TGW1 đã được ký điện tử (API Bot / mã thông báo riêng) Nhân chứng ghi nhận việc quay lui, một đầu khác ở cùng số đếm, khóa bị thay đổi, câu trả lời không hợp lệ và phản hồi bị thiếu. Để xác nhận mọi bản ghi trước đó không thay đổi, hãy so sánh bản xuất với các điểm kiểm tra đã lưu giữ. Nhân chứng trên máy chủ khác không chịu chung sự cố của máy chủ bộ thu thập; một nhà vận hành riêng mang lại thêm tính độc lập. Trình xác minh kiểm tra rằng khóa nhân chứng khác với khóa bộ thu thập; hồ sơ kiểm soát khóa của bên lưu giữ cho biết ai nắm giữ nó. Telegram ghi ngày cho mỗi bài đăng trong kênh công khai, và `verify.py --channel https://t.me/s/…` đọc các ngày đó làm thời gian bên ngoài. Witness xác nhận trạng thái nhật ký được báo cáo bởi Collector. Sử dụng kiểm tra giao hàng có kiểm soát để đo lường các hành động Telegram nào đã đến tài khoản thu thập. Xem [phần thiết lập Witness](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/). ## Kiểm tra khả năng xử lý các hành động đã biết Sử dụng một nhóm kiểm soát, các tài khoản thu thập riêng biệt và một dấu hiệu mới. Gửi, chỉnh sửa và xóa một cách có chủ đích, đồng thời kiểm tra việc ghi lại dữ liệu giữa các giai đoạn. Xác định các hành động dự kiến và thời điểm kết thúc trước khi kiểm tra kết quả. R = |observed∩expected| / |expected| Δ t = treceipt - taction Chỉ các hành động phù hợp với dự kiến mới được tính; các biên nhận trùng lặp sẽ không làm tăng tử số. Mẫu số phải khác không. Một biên nhận bị thiếu sẽ không có thời gian trễ được đo lường. Hãy ghi nhận độ không chắc chắn về thời gian; hãy sử dụng thời gian thực hiện hành động xóa có kiểm soát của riêng quý vị, vì Telegram không cung cấp thời gian xóa chính xác. Một kết quả như 5/6 (83,3%) mô tả các hành động thử nghiệm, chứ không phải mức độ đầy đủ của toàn bộ lưu lượng Telegram. ## Chọn quy trình làm việc [Quy trình điều tra đầy đủ](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/) được trình bày theo diễn biến của một sự cố xảy ra trên kênh, nhóm, bot và cuộc trò chuyện riêng tư: 1. Trên tài khoản thu thập chuyên dụng, hãy bật chế độ Điều tra toàn bộ tài khoản và lập danh sách các cuộc trò chuyện có thể truy cập. Sử dụng các cuộc trò chuyện đã chọn hoặc một thư mục cho tài khoản chính. 2. Lấy các bản chụp nhanh nhật ký, lịch sử đầy đủ theo từng cuộc trò chuyện và các tệp đính kèm được lưu giữ. 3. Lưu lại các thay đổi theo thời gian thực và mọi tương tác có chủ đích trên bảng điều khiển kèm theo biên nhận tương ứng. 4. Theo dõi các ID người gửi dạng số, mối quan hệ trả lời, các địa chỉ nhận lặp lại và băm tệp thông qua các bản ghi được trích dẫn và hồ sơ cá nhân. 5. Thêm ghi chú và bộ sưu tập được liên kết với nguồn trong Case Board. Tái tạo dòng thời gian xuyên các cuộc trò chuyện với cả dấu thời gian và các khoảng trống rõ ràng. 6. So sánh các không gian làm việc của các tài khoản khác nhau trong khi vẫn giữ nguyên nguồn gốc và khóa của từng tài khoản. 7. Tổng hợp và xác minh các nhật ký có chữ ký, hồ sơ người dùng cũng như các bản xuất lịch sử cùng với các ghi chú vụ việc. Hướng dẫn tại `/docs/cases/` trên trang web bao gồm bản đồ vụ việc tương tác và các biến thể cho các tranh chấp liên quan đến bot, tin nhắn bị xóa và người tham gia thay đổi tên. Case Board lưu trữ ghi chú và bộ sưu tập trong một không gian làm việc. Tính năng xuất theo nhóm thu thập các gói không gian làm việc riêng biệt; việc tương quan giữa các không gian làm việc và dòng thời gian tổng hợp vẫn thuộc phạm vi công việc của nhà phân tích. [Các công việc đã hoàn tất và các công việc còn lại](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/) · [Xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#investigation-handoff) · [Bắt đầu với một tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/quickstart/) --- # Telegram · Cấu hình và xác minh báo cáo Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/ Các bộ lọc báo cáo, tám mẫu thiết kế, cài đặt sẵn nội dung, lịch sử thay đổi đã lưu và phần đánh giá được bao gồm trong các tệp xuất có chữ ký. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Các bộ lọc báo cáo, tám mẫu thiết kế, cài đặt sẵn nội dung, lịch sử thay đổi đã lưu và phần đánh giá được bao gồm trong các tệp xuất có chữ ký. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Điều tra](https://phishdestroy.io/tgwitness/vi/docs/reference/investigation/) ![Điều tra](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Chuyển các quan sát đã chọn thành một bản tường trình dễ đọc về vụ việc: câu hỏi, phạm vi, các thay đổi đã lưu, biểu đồ, kết quả và tham chiếu nguồn. Mỗi báo cáo cung cấp cho người nhận một cách để kiểm tra tài liệu được giao và xem xét phạm vi thu thập của nó. Phần **“Cơ sở của sự tin cậy”** xuất hiện trong các báo cáo nhật ký, bàn giao, trò chuyện, tài khoản và chia sẻ. Các tệp PDF nhật ký và bàn giao sử dụng cùng bản đánh giá như tệp `report.json` đã ký của chúng. Danh sách nội dung ZIP chứa `case_assessment` trong danh sách nội dung đã ký. Bản đánh giá này đi kèm với tài liệu được xuất. Các quan sát ban đầu vẫn giữ nguyên chữ ký hiện có. ## Định dạng tài liệu và thứ tự đọc ### Studio báo cáo Mở **Exports → Cấu hình và xem trước**. Thực hiện theo trình tự **Data → Thiết kế & nội dung → Xem trước**: 1. Sử dụng toàn bộ không gian làm việc hoặc chọn các cuộc trò chuyện, tác giả, bao gồm cả ngày quan sát theo múi giờ UTC và các loại sự kiện. Tải danh mục để tìm kiếm các cuộc trò chuyện và tác giả, hoặc nhập ID Telegram của họ. Bộ lọc tác giả khớp với các ID người gửi đã được ghi lại; thông báo xóa không có người gửi sẽ không khớp với bộ lọc tác giả. 2. Chọn một thiết kế trang, sau đó chọn biểu đồ, nhãn người tham gia, bản ghi chép và kết luận bằng văn bản của bạn. Việc thay đổi thiết kế sẽ giữ nguyên các lựa chọn này. 3. Tạo bản xem trước. Bản xem trước hiển thị số liệu thực tế, hoạt động, người tham gia, các bản ghi mẫu, các thay đổi đã lưu và các khoảng số tin nhắn bị thiếu. Việc thay đổi lựa chọn sẽ khiến bản xem trước trở nên lỗi thời. Lưu lại trước khi tải xuống tệp HTML, PDF đã ký, JSON đã ký hoặc tệp ZIP chứa bằng chứng. Bản xem trước dữ liệu tính toán tiền tố nhật ký ổn định hoàn chỉnh, không phải mẫu ban đầu. Chỉ các hàng mẫu được hiển thị và các danh sách dài mới bị giới hạn; số lượng bị bỏ qua của chúng được hiển thị. Việc xuất dữ liệu sau này sẽ tạo ra một bản chụp ổn định mới, do đó việc thu thập đang diễn ra có thể làm tăng các con số này. Phạm vi, số lượng và danh tính nguồn được bao gồm trong báo cáo đã ký. Việc mở hoặc xem trước biểu mẫu sẽ không lưu lại biểu mẫu đó. **Hướng dẫn về thẩm quyền pháp lý.** Trong phần Chi tiết tài liệu, mở **Hướng dẫn về thẩm quyền pháp lý · tùy chọn** để chọn thẩm quyền pháp lý và thủ tục dân sự/thương mại hoặc hình sự. Phụ lục bao gồm cơ sở pháp lý, liên kết nguồn, ghi chú chuẩn bị và tình trạng nghiên cứu. Tóm tắt và giải thích bằng ngôn ngữ địa phương về các biện pháp bảo vệ dữ liệu thu thập là tùy chọn. Không có khu vực pháp lý nào được chọn theo mặc định. Các lựa chọn này thuộc về không gian làm việc và không được bao gồm trong các cấu hình bố cục đã lưu cũng như các thiết lập mặc định ngầm định về chia sẻ và sao chép. Xem [thiết lập mặc định, báo cáo được hỗ trợ và giới hạn nghiên cứu](https://github.com/phishdestroy/TgWitness/blob/main/docs/JURISDICTION_GUIDANCE.md) . **Chọn bản sao dành cho người nhận.** Các biểu đồ và bản ghi chép sử dụng các bản ghi đã chọn. Tính toàn vẹn, việc lưu giữ và phạm vi bao quát mô tả toàn bộ nhật ký nguồn. Tệp ZIP chứa bằng chứng chứa các bản ghi gốc và tệp đính kèm. Sử dụng [quy trình bàn giao tối thiểu](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#handover-extract) khi người nhận chỉ cần nhận dữ liệu đã chọn và được phép. ### Đọc các nội dung đã chỉnh sửa, đã xóa và các ID bị thiếu Một chỉnh sửa sẽ hiển thị văn bản **"Trước"** và **"Sau"** đã lưu và làm nổi bật các từ đã thay đổi. Một thao tác xóa sẽ hiển thị phiên bản cuối cùng được lưu trước thông báo. Nếu không có nội dung trước đó được ghi lại, báo cáo sẽ nêu rõ điều này. Khi bạn chỉ chọn các chỉnh sửa hoặc thao tác xóa, các phiên bản trước đó vẫn có sẵn dưới dạng bối cảnh được gắn nhãn rõ ràng bên ngoài các bộ lọc. Các thông báo không liên quan sẽ không được thêm vào các lịch sử này. **Các ID tin nhắn chưa được quan sát** là những khoảng trống giữa các số đã biết trong các cuộc trò chuyện được chọn và khoảng ID được xác định dựa trên ngày tháng. Mọi bản ghi nguồn đã biết đều được kiểm tra trước khi tuyên bố một số là chưa được quan sát: việc lọc ra một tác giả khác, một loại sự kiện hoặc một ngày tháng không thể tạo ra khoảng trống giả. Các tin nhắn đã lưu liền kề được gắn nhãn là bối cảnh. Một số bị thiếu đánh dấu một vị trí chưa được quan sát; các thông báo xóa và việc kiểm tra lại không thành công được báo cáo dưới dạng các loại sự kiện riêng biệt. ### Chọn một thiết kế Có chín mẫu trang cho báo cáo HTML của nhật ký và của một cuộc trò chuyện, cũng như báo cáo PDF có chữ ký. Các mẫu dùng cùng bản ghi và phép tính, chỉ khác bìa, kiểu chữ, tiêu đề chương, bảng và khoảng cách. | Thiết kế | Phong cách trình bày | | --- | --- | | Cổ điển | Một hồ sơ truyền thống với bìa màu tối và các phần được đánh số. | | Biên tập | Trang tiêu đề có khung viền serif, lề rộng và thanh phân chia chương hẹp. | | Tóm tắt | Bìa gọn gàng với lưng sách màu xanh hải quân, các tiêu đề ngắn gọn và bảng dữ liệu được sắp xếp sát nhau. | | Phân tích | Bìa theo phong cách bảng khảo sát, các bảng biểu mô-đun và hình minh họa sử dụng phông chữ cố định. | | Kỹ thuật | Một sổ đăng ký có kẻ ô, thanh tham chiếu được đánh số và các bảng so sánh chính xác. | | Tổng quan | Bìa toàn cảnh, khoảng cách rộng rãi và các số liệu tóm tắt nổi bật. | | Loạt bài đọc | Một thanh mục lục và các chương được nhóm lại cho các phần kết quả, phạm vi, thay đổi và nhật ký quan sát. | | Sổ cái & ký quỹ | Các chương được đánh số với lề rộng, bảng biểu chính xác và bản ghi tin nhắn riêng biệt. | | Tổng quan hồ sơ | Số liệu chính, hồ sơ được quan sát và các mục có thể tìm kiếm với liên kết đến bản ghi trò chuyện. | Thiết kế được lưu theo từng không gian làm việc và ghi lại trong bản kê khai xuất có chữ ký. HTML hoạt động ngoại tuyến, hỗ trợ chế độ sáng và tối, và thích ứng với màn hình hẹp cũng như các ngôn ngữ viết từ phải sang trái. Các tệp PDF gốc sử dụng phông chữ đi kèm; thiết kế Editorial bao gồm phông chữ Noto Serif theo Giấy phép Phông chữ Mở SIL đi kèm. Chế độ đọc theo chuỗi và Ledger & margin cũng áp dụng cho tổng quan tài khoản, cuộc trò chuyện tài khoản và chia sẻ bản sao. Các tệp PDF tiếng Trung, tiếng Nhật và tiếng Hàn cần có phông chữ phù hợp trên máy chủ, chẳng hạn như Noto Sans CJK, được cài đặt trên toàn hệ thống hoặc đặt trong thư mục `TGWITNESS_FONT_DIR`. Khi phông chữ này không có sẵn, tệp ZIP sẽ giữ lại các báo cáo HTML và JSON. Hai thiết kế này bao gồm một nhật ký dễ đọc mà không cần JavaScript. Đối với các tệp xuất có dung lượng lớn, chế độ xem này chứa tối đa 500 bản ghi hoàn chỉnh trong giới hạn đầu vào 8 MiB; báo cáo ghi rõ giới hạn này và cung cấp liên kết đến trình xem đầy đủ cũng như các bản ghi nguồn. Thư mục tài khoản và chỉ mục mối quan hệ mô tả cùng một mẫu đọc đó, chứ không phải tất cả những người tham gia. Các biểu đồ nhật ký đầy đủ giữ phạm vi được nêu riêng biệt của chúng. ### Chọn nội dung | Nội dung được định sẵn | Được bao gồm theo mặc định | | --- | --- | | Hồ sơ vụ việc (được khuyến nghị) | Hoạt động, thời gian quan sát, người tham gia, các cuộc trò chuyện và bản ghi chép cuộc trò chuyện. | | Tóm tắt | Tổng quan về hoạt động mà không bao gồm thứ hạng của người tham gia hoặc bản ghi chép. | | Xem xét hoạt động | Hoạt động, thời gian quan sát, người tham gia, các cuộc trò chuyện và nội dung, kèm theo nguồn tham chiếu và số liệu chính xác. | | Báo cáo tùy chỉnh | Bạn có thể tự kết hợp các biểu đồ, bản ghi chép và bản xem trước theo ý muốn. | Việc thay đổi cài đặt sẵn sẽ giữ nguyên thiết kế, chi tiết vụ việc và phân tích bằng văn bản của bạn. Các kiểm tra tính toàn vẹn, phạm vi bao phủ, ghi chú đọc hiểu và hướng dẫn xác minh vẫn được duy trì trong mọi thiết kế. Các bản ghi nguồn trong tệp ZIP không thay đổi khi biểu đồ hoặc bản ghi chép bị ẩn. Các **ghi chú kiểm tra** tùy chọn chứa câu hỏi, phương pháp, kết quả và kết luận do tác giả báo cáo viết. Trích dẫn tệp nguồn và số bản ghi trong phần kết quả. Chữ ký bảo toàn các tuyên bố do tác giả viết này cùng với báo cáo; các quan sát từ nguồn và cách diễn giải của tác giả vẫn có thể nhận diện được. Việc bàn giao được tối giản sẽ loại bỏ các ghi chú riêng tư này và các biểu đồ nhật ký đầy đủ. Các lựa chọn về biểu đồ và khám nghiệm áp dụng cho các báo cáo nhật ký. Chọn hoạt động theo thời gian, bản đồ nhiệt theo ngày trong tuần/giờ theo múi giờ UTC, bảng xếp hạng người tham gia, bảng xếp hạng cuộc trò chuyện và thành phần bản ghi. Chọn 5–30 nhóm được xếp hạng và các biệt danh hoặc ID tài khoản trung lập của người tham gia. Người gửi không xác định và những người tham gia còn lại được hiển thị trong các hàng riêng biệt. Biệt danh chỉ ảnh hưởng đến biểu đồ; các bản ghi nguồn vẫn chứa danh tính thực của họ. Bản xem trước thiết kế được cập nhật từ bản nháp chưa lưu bằng cách sử dụng các thành phần bìa, phần kiểm tra và biểu đồ sản xuất, giới hạn trong các kết quả khớp với 50.000 bản ghi nguồn đầu tiên. Bản xem trước dữ liệu bên dưới tính toán toàn bộ phần đã chọn. Bản xem trước này rõ ràng chưa được ký và không lưu lại các chỉnh sửa. Các nút Bìa và Biểu đồ chuyển đổi phần tương ứng. Đây không phải là bản xem trước PDF hoàn chỉnh. **Lưu cài đặt báo cáo** sẽ áp dụng các lựa chọn cho các lần xuất trong tương lai; các tệp đã ký hiện có là không thể thay đổi. PDF sử dụng trang bìa đã chọn, kiểu chữ, bố cục chương và các tổng hợp đã chọn giống như HTML và JSON đã ký. Đánh giá độ tin cậy, phạm vi bao phủ và hướng dẫn xác minh vẫn được giữ nguyên. Việc ẩn biểu đồ hoặc bản ghi chép dễ đọc không loại bỏ các hàng nguồn có thẩm quyền khỏi tệp ZIP. Các chuỗi biểu đồ bị tắt sẽ bị bỏ khỏi tệp JSON phân tích; hãy dùng bản xuất tối thiểu để hạn chế việc tiết lộ các bản ghi nguồn. Bộ lọc chọn dữ liệu áp dụng cho báo cáo nhật ký; bản xuất tài khoản và bản xuất để chia sẻ giữ phạm vi thu thập và công bố riêng. Một lựa chọn có thể gồm toàn bộ cuộc trò chuyện, tác giả, ngày UTC, loại bản ghi và từng tin nhắn. Tin nhắn được chọn trong cuộc trò chuyện bằng **Chọn** sẽ vào **Tin nhắn đã chọn**; khi đó báo cáo bao gồm bản ghi của các tin nhắn đó và của mọi cuộc trò chuyện được chọn toàn bộ, đồng thời liệt kê số tin nhắn đã chọn trong **Dữ liệu đã chọn**. Số tin nhắn bị thiếu và các bản ghi lân cận chỉ được báo cáo cho cuộc trò chuyện được chọn toàn bộ. **Thêm số tin nhắn** dưới danh sách cuộc trò chuyện thêm tin nhắn mà không cần mở cuộc trò chuyện: mỗi dòng một cuộc trò chuyện gồm ID cuộc trò chuyện, dấu hai chấm và các số tin nhắn, hoặc liên kết `t.me/c/…` tới từng tin nhắn. Các tùy chọn thiết kế/biểu đồ được chia sẻ được cố định trong các tệp xuất mới của cuộc trò chuyện/tài khoản và bản xem trước chia sẻ tài khoản. Cài đặt ngôn ngữ và quyền riêng tư của tài khoản/chia sẻ vẫn độc lập; các ghi chú riêng tư về vụ việc và kiểm tra không được sao chép vào các tệp xuất này. Các báo cáo về tài khoản và chia sẻ vẫn ở định dạng HTML được bảo vệ bởi bản kê khai lưu trữ đã ký. Nhật ký, bộ công cụ bàn giao nhật ký thu gọn và bộ công cụ trò chuyện đơn lẻ cũng cung cấp các tệp PDF đã ký. ### Các biểu đồ thể hiện những gì Hoạt động nhật ký và bản đồ nhiệt tính số lượng **các quan sát** mới, lịch sử, đã khôi phục, đã chỉnh sửa, đã xóa và thiếu khi kiểm tra lại, theo thời gian quan sát của bộ thu thập theo múi giờ UTC. Các tín hiệu kiểm tra kết nối và biên nhận tệp đính kèm bị loại trừ. Xếp hạng người tham gia chỉ tính các quan sát tin nhắn mới, lịch sử và đã khôi phục: người gửi không được coi là người chỉnh sửa hoặc người xóa. Các quan sát lặp lại có thể mô tả cùng một tin nhắn Telegram. Phân tích nhật ký lưu giữ số lượng theo loại, tham chiếu bản ghi đầu tiên/cuối cùng và tệp nguồn ` `events.jsonl`` với mã SHA-256. Các số liệu bao gồm giá trị chính xác trong HTML và PDF. Các khoảng thời gian hàng ngày sẽ chuyển sang đơn vị tháng sau khi vượt quá 366 ngày được ghi lại; các biểu đồ kết hợp các khoảng này thành tối đa 36 khoảng có độ rộng bằng nhau. Hơn 100.000 định danh riêng biệt hoặc 1.200 mốc tháng khiến biểu đồ liên quan không khả dụng, trong khi tổng số liệu chính xác vẫn có sẵn. Biểu đồ chụp nhanh và chia sẻ tài khoản chỉ tính các hàng tin nhắn không phải dịch vụ được bao gồm, dựa trên thời gian tin nhắn được ghi lại. Các số liệu tổng hợp về chia sẻ được tính toán sau khi che giấu thông tin và lọc dữ liệu. Các biểu đồ này sử dụng tối đa 90 khoảng thời gian ngày theo UTC có độ rộng bằng nhau và giữ lại tối đa 10.000 giá trị nhóm; các số liệu vượt quá được khai báo rõ ràng và đối chiếu. Khoảng thời gian cuối cùng có thể ngắn hơn. Các ngày tháng không xác định hoặc không chính xác sẽ không được đưa vào biểu đồ thời gian. Một khoảng trống có nghĩa là không có quan sát nào được bao gồm; tham khảo phạm vi bao phủ để xác định các khoảng trống. Các biểu đồ này mô tả hoạt động đã lưu. Người gửi không xác định vẫn là một danh mục riêng biệt, và mỗi lần kiểm tra được báo cáo riêng lẻ. Khi được bao gồm, tệp `analytics.json` được bảo vệ bởi các hàm băm tệp đã ký của kho lưu trữ. Tệp `report.json` của nhật ký nhúng cùng một tổng hợp đã chọn. Xác minh chữ ký phát hiện các byte bị thay đổi. Để kiểm tra các con số, hãy tính lại các tổng hợp nhật ký bằng `report_analytics.Analytics` và `selected`, hoặc các tổng hợp ảnh chụp nhanh bằng `snapshot_analytics.collect` và `project`. ### Các chỉ số bất thường **Xem trước.** Báo cáo bằng chứng bổ sung phần **Chỉ số bất thường** được tính toán bởi các bộ xử lý đã đăng ký (`tgwitness/metrics/`, một tệp cho mỗi chỉ số). Báo cáo liệt kê tên của mọi bộ xử lý đã chạy kèm theo phiên bản của nó, và hiển thị phương pháp tính toán dưới bảng dữ liệu của nó, để quá trình tính toán có thể được lặp lại từ `events.jsonl` với `tgwitness.metrics.run`. | Bộ xử lý | Nội dung hiển thị | | --- | --- | | `first_time_posters_over_time` v1 | Số người đăng bài lần đầu và số tin nhắn mỗi ngày theo giờ UTC. Một cờ cảnh báo yêu cầu ít nhất năm người đăng bài lần đầu và gấp ba lần giá trị trung vị của số người này, với khối lượng tin nhắn tối đa bằng 1.5 lần giá trị trung vị của khối lượng tin nhắn. Mức cơ sở sử dụng ít nhất bảy ngày quan sát trong vòng 14 ngày lịch trước đó, sau bảy ngày khởi động. | | `service_vs_message_ratio` v1 | Số tin nhắn đã lưu riêng biệt cho từng cuộc trò chuyện và phần được sử dụng bởi các tin nhắn dịch vụ. Tài liệu này mô tả hệ thống đánh số; nó không giải thích về một số cụ thể nào đó bị thiếu. | | `join_leave_per_month` v1 | Số lượt tham gia, rời khỏi, xóa hoặc cấm mỗi tháng, mỗi người, mỗi cuộc trò chuyện, mỗi thay đổi và mỗi ngày. | | `pinned_per_month` v1 | Số lượng tin nhắn dịch vụ được ghim, thông báo gỡ ghim, cũng như tin nhắn được ghim được thêm vào hoặc xóa đi giữa các bản chụp trạng thái cuộc trò chuyện, tính theo tháng. | **Các công cụ khác → Thông số → Chỉ số báo cáo** cho phép chọn bộ xử lý và số hàng hiển thị, kể cả trong các báo cáo đã lọc. Các bảng hàng ngày và hàng tháng hiển thị các hàng gần đây, các bảng chia sẻ dịch vụ xếp hạng các cuộc trò chuyện theo số lượng tin nhắn đã lưu. Tổng số bao gồm mọi hàng. Từ bản checkout mã nguồn, hãy dựng cả chín mẫu liệt kê ở trên từ cùng một nhật ký hư cấu: ``` python tools/build_report_styles.py --output test-results/report-styles ``` Mở tệp `index.html` kết quả để so sánh các báo cáo HTML đầy đủ, các tệp PDF đã ký và các tệp ZIP. Mỗi thiết kế đều sử dụng cùng một nhật ký nguồn. Sử dụng một thư mục đầu ra mới cho mỗi lần chạy để các ví dụ đã ký trước đó được bảo toàn. ![Hồ sơ HTML giả định](https://phishdestroy.io/tgwitness/assets/dossier-en.png?v=62db26820986) Trang HTML mở đầu bằng trang bìa vụ án và các số liệu chính. Bản đồ bằng chứng được đánh số liên kết đến từng phát hiện, các sự kiện hỗ trợ, giới hạn và đánh giá độc lập. Các bản ghi có thể tìm kiếm và các tham chiếu bản ghi ổn định vẫn có sẵn trong trình xem ngoại tuyến. Thiết kế thích ứng với màn hình hẹp, cả các chủ đề và trình duyệt không sử dụng JavaScript. Tệp PDF đã ký có trang bìa A4 riêng biệt, mã tham chiếu báo cáo và mã QR, phần tóm tắt chính, bản đồ bằng chứng, các kết luận được đánh số và dấu trang tài liệu. Các tiêu đề trên đầu và chân trang giúp nhận diện báo cáo. Mã QR xác định tài liệu; đây không phải là kết quả xác minh độc lập. Các bản in từ trình duyệt là riêng biệt so với tệp PDF đã được ký số này. Dòng thời gian quan sát hiển thị các khoảng thời gian quan sát được ghi lại và các sự gián đoạn trên cùng một trục UTC. Khoảng trống không được coi là phạm vi bao phủ; các bảng chi tiết giữ nguyên các khoảng thời gian chính xác. Tệp ZIP chứa các báo cáo có thể đọc được, tệp JSON đã ký, hồ sơ nguồn và hướng dẫn xác minh. Tạo một hồ sơ mới, hư cấu bằng tiếng Anh/tiếng Nga/tiếng Đức với môi trường phát triển đã được cài đặt: ``` python tools/build_dossier_example.py --output test-results/my-new-dossier ``` Mỗi thư mục ngôn ngữ chứa các tệp `report.html`, `report.pdf`, `report.json` và `dossier.zip`. Các thư mục mẫu hiện có sẽ không bao giờ bị ghi đè. Không sử dụng tài khoản Telegram, dịch vụ đóng dấu thời gian bên ngoài hoặc kết nối mạng để tạo ra nó. ![Ba trang đầu tiên của tệp PDF giả định đã được ký tên](https://phishdestroy.io/tgwitness/assets/dossier-pdf.png?v=30a8d283dcc2) ## Đọc một trường hợp cụ thể Đối với một nhật ký có 1,200 mục nhập với dấu thời gian đã được xác thực tại mục nhập thứ 1,000, báo cáo xác định có 200 mục nhập sau đó nằm ngoài giới hạn của dấu thời gian đó. Dấu thời gian xác định giới hạn trên về thời điểm điểm kiểm tra tồn tại; mỗi tin nhắn giữ nguyên thời gian gửi từ Telegram. Nếu ba tệp dấu thời gian khác không qua được quá trình xác thực hoặc không thể xác thực được, chúng sẽ được tính riêng và không thể đưa ra kết luận khẳng định. Một dấu thời gian có thể sử dụng phải đáp ứng tất cả các kiểm tra sau: dấu ấn của nó khớp với điểm kiểm tra, chữ ký của nó được liên kết với một gốc TSA đáng tin cậy tại thời điểm đóng dấu, và chữ ký, khóa, số lượng và đầu của điểm kiểm tra phải khớp chính xác với tiền tố nhật ký. Chỉ phân tích cú pháp dấu thời gian hoặc có biên nhận OTS là chưa đủ. Người đọc phải tự chọn gốc TSA đáng tin cậy và lặp lại quá trình xác minh. OTS cần có kiểm tra xác nhận Bitcoin riêng. | Trạng thái báo cáo | Ý nghĩa | | --- | --- | | Đã kiểm tra trong quá trình xuất | Trình xuất đã thực hiện kiểm tra như đã nêu; vẫn cần thực hiện lại một cách độc lập. | | Đã ghi lại; cần xem xét | Quan sát cơ bản hoặc tuyên bố của người vận hành được ghi lại; đây không phải là xác nhận độc lập. | | Không bao gồm trong bản dịch này | Nội dung này không có bằng chứng hỗ trợ cho tuyên bố này. Nó cũng không khẳng định rằng không có thông tin tương tự ở nơi khác. | | Chưa được kiểm tra độc lập | Báo cáo không cung cấp kết quả xác minh độc lập. | | Thiếu hoặc không có sẵn | Thiếu tài liệu hoặc bước kiểm tra bắt buộc, không đầy đủ hoặc không thành công. | Kiểm tra từng mục riêng biệt, cùng với phạm vi thu thập đã ghi lại. ## Những yếu tố nào một cấu hình mạnh mẽ phải bảo toàn 1. Trước khi dựa vào quá trình thu thập, hãy lưu giữ dấu vân tay khóa của người thu thập thông qua một kênh đáng tin cậy riêng biệt. So sánh tham chiếu đó với khóa ký của tệp xuất. 2. Giữ lại các điểm kiểm tra có dấu thời gian độc lập và, nếu có sử dụng, một nhật ký chứng kiến nằm ngoài sự kiểm soát hành chính của bộ thu thập. So sánh chúng với nhật ký đã xuất để kiểm tra các ranh giới trước đó của nó. 3. Phạm vi thu thập bản ghi, các khoảng trống, bộ lọc, giới hạn và các thay đổi trong quá trình thu thập. Giải thích các khoảng thời gian bị thiếu liên quan đến khiếu nại thực tế, đồng thời phân biệt rõ ràng các ID tin nhắn không được ghi nhận, thông báo xóa và các lần kiểm tra lại không thành công. 4. Giữ nguyên các tệp ZIP gốc và các giá trị băm của chúng. Ghi lại từng người nắm giữ, lần chuyển giao, ngày tháng và mục đích. Giữ lại các tuyên bố của người vận hành được ghi nhận và các ghi chú vụ việc kèm theo chúng. 5. Đối với các máy ảo (VM) bí mật, cần bảo toàn và xác minh độc lập các thông tin sau: trích dẫn, thách thức, chuỗi chứng chỉ Intel, các phép đo, nguồn chính xác và điều kiện xử lý khóa. Giữ lại kết quả xác minh chứng nhận cùng với các bằng chứng đã được xem xét. Xem [Phạm vi xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) để biết các kiểm tra về việc thu thập, tính toàn vẹn của kho lưu trữ, thời gian và phạm vi thu thập trong từng chế độ. ## Xem xét của người nhận Sử dụng bản cài đặt đáng tin cậy của TgWitness và dấu vân tay được thu thập độc lập: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca tsa-root.pem python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL --require-witness python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --check-drand ``` Lệnh thứ hai và thứ ba có thể đáp ứng yêu cầu tối thiểu về bằng chứng: một dấu thời gian đã được kiểm tra, hoặc các ngày mà Telegram đặt trên các bài đăng của nhân chứng, cung cấp thời gian bên ngoài cho bản ghi cuối cùng. Tệp ZIP của nhân chứng phải đến từ một nguồn đáng tin cậy độc lập; đồng thời phải bảo toàn khóa và nguồn gốc của nó. Lưu giữ các lệnh, phiên bản công cụ, kết quả đầu ra, các hàm băm đầu vào đã được kiểm tra và các câu hỏi chưa được giải quyết. Xác minh Beacon là một quá trình kiểm tra trực tuyến riêng biệt; trình hiển thị báo cáo không bao giờ liên hệ với bất kỳ dịch vụ nào chỉ để hiển thị báo cáo. Đối với tranh chấp về một tin nhắn cụ thể, hãy trích dẫn tham chiếu lưu trữ, tệp có thẩm quyền và tham chiếu bản ghi, sau đó mô tả khoảng thời gian liên quan, các khoảng trống trong phạm vi, việc lựa chọn và tài liệu chứng thực. Đối với bản sao chia sẻ, cũng cần xem xét quá trình chuyển đổi đã ghi lại và các tham chiếu của nó đến kho lưu trữ nguồn. Các bộ lọc riêng tư và bản đồ nhận dạng nằm ngoài phạm vi đánh giá công khai. Việc xác minh tệp PDF đã ký sẽ phát hiện các thay đổi đối với các byte được bảo vệ. Giữ lại tệp kỹ thuật số gốc và kết quả xác minh cùng với bất kỳ ảnh chụp màn hình hoặc bản in nào. --- # Telegram · Xuất tài khoản Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/account-export/ Xuất những nội dung mà tài khoản có thể truy cập hiện tại: phạm vi, các tác vụ có thể tiếp tục, tệp lưu trữ đã được ký và các bản sao chia sẻ đã được thu gọn. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Translation coverage: this edition includes material from the English original. Xuất những nội dung mà tài khoản có thể truy cập hiện tại: phạm vi, các tác vụ có thể tiếp tục, tệp lưu trữ đã được ký và các bản sao chia sẻ đã được thu gọn. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bằng chứng và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) ![Bằng chứng & xác minh](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) Việc xuất dữ liệu tài khoản sẽ giữ nguyên khe thu thập dữ liệu của tài khoản đó. Quá trình quan sát trực tiếp có thể tiếp tục trong khi tệp lưu trữ đang được tìm kiếm, tải xuống, xác minh và đóng gói. Hãy tạm dừng một tác vụ lịch sử hoặc xuất dữ liệu khác trước khi bắt đầu một tác vụ thu thập dữ liệu khác cùng lúc. Việc tạm dừng tác vụ lưu trữ sẽ giữ cho quá trình quan sát tiếp tục chạy, và việc tạm dừng quá trình quan sát sẽ giữ nguyên tác vụ lưu trữ. Các tác vụ xuất dữ liệu trên các tài khoản khác nhau có thể chạy đồng thời. Một tác vụ chỉ dành cho Takeout đang chờ phê duyệt sẽ giải phóng tài khoản của mình, do đó một tác vụ xuất dữ liệu thông thường khác có thể bắt đầu trong khi đang chờ phê duyệt. Một tác vụ thu thập dữ liệu đang hoạt động vẫn giữ tài khoản đó. Với tư cách là quản trị viên cài đặt, hãy chọn **Trang chủ → Xuất tài khoản của tôi**, hoặc **Xuất → Tài khoản Telegram → Cấu hình xuất tài khoản**. Đăng nhập nếu cần, xem lại phạm vi và bắt đầu xuất một cách rõ ràng. Không cần quan sát liên tục. **Quan sát đã lưu** là một bản xuất riêng biệt của nhật ký hiện có; tệp ZIP của nó bao gồm tất cả các nguồn bất kể bộ lọc nhật ký. Mỗi không gian làm việc có các tác vụ, danh tính ký và bộ lưu trữ riêng. Quyền truy cập bảng điều khiển đã cấp, bao gồm quyền xuất thông thường không hạn chế, không thể mở các đường dẫn trên toàn tài khoản này. Các bộ lọc người gửi và nội dung tin nhắn sẽ mở rộng khi chọn **“Lọc theo người gửi” hoặc “Lọc theo nội dung tin nhắn**”. **Phần “Dữ liệu tài khoản & phương thức kết nối**” chứa các danh mục tài khoản tùy chọn và tùy chọn “Takeout” hoặc “phiên làm việc thông thường”; phần tóm tắt của nó hiển thị các tùy chọn đang hoạt động ngay cả khi đã đóng. Việc đóng các phần này sẽ giữ nguyên cài đặt của chúng. Các bản nháp xuất và báo cáo vẫn tồn tại trong phiên làm việc hiện tại của bảng điều khiển khi chuyển đổi chế độ xem; chúng không được lưu khi tải lại trình duyệt. Các tác vụ hiện có vẫn có thể truy cập được từ cả hai tùy chọn xuất. Quy trình làm việc này xuất dữ liệu hiện có thể truy cập được từ tài khoản đã kết nối. Phương pháp **Tự động** mặc định bắt đầu bằng [Telegram Takeout](https://core.telegram.org/api/takeout), tính năng này trả về lịch sử có thể truy cập ở trạng thái hiện tại, bao gồm các kênh còn lại, danh bạ đã lưu và các dữ liệu tài khoản khác. Nếu Telegram áp đặt thời gian chờ trước khi Takeout bắt đầu, chế độ Tự động sẽ tiếp tục ngay lập tức với phiên làm việc thông thường; nhật ký sẽ ghi lại `account_export.transport` và danh sách kiểm kê có chữ ký sẽ nêu rõ phương thức được sử dụng và liệt kê sự thay đổi đó dưới dạng một mục bị bỏ sót. Ngược lại, **phiên Telegram Takeout chỉ** chờ sự chấp thuận, còn **phiên Thông thường thì hoàn toàn** không yêu cầu Takeout. Các Cuộc trò chuyện bí mật được ghi lại trực tiếp bởi [mô-đun Cuộc trò chuyện bí mật](https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/), và các chỉnh sửa được ghi lại thông qua quan sát trực tiếp. Phiên thông thường có phạm vi bao quát khác biệt và ghi lại các danh mục không được hỗ trợ. **Trang chủ → Xuất tất cả** sẽ bắt đầu quá trình xuất bao gồm mọi loại cuộc trò chuyện, mọi loại tệp đính kèm, hồ sơ, danh bạ, ảnh đại diện, câu chuyện, siêu dữ liệu phiên và các dữ liệu tài khoản khác, dưới mọi định dạng: tệp lưu trữ TgWitness đã được ký với các chế độ xem JSON và HTML của Telegram Desktop. **Tùy chọn Chọn nội dung cần xuất** sẽ mở biểu mẫu bên dưới với các thiết lập mặc định tương tự. Takeout là API xuất dữ liệu chính thức cũng được Telegram Desktop sử dụng. TgWitness có thể ghi dữ liệu JSON tương thích với Desktop trực tiếp từ dữ liệu thu thập của chính nó; không cần phải nhập kho lưu trữ của người khác. ID cuộc trò chuyện và ID tin nhắn đều có sẵn qua cả hai phương thức truyền tải. Tốc độ xuất và độ trễ phê duyệt của Takeout phụ thuộc vào giới hạn của Telegram đối với tài khoản, cũng như việc cuộc trò chuyện đó có công khai hay có thể chuyển tiếp hay không. Hãy đo lường cùng phạm vi và cài đặt phương tiện trước khi so sánh tốc độ. Đối với tối đa 20 ID cuộc trò chuyện được chọn rõ ràng, việc xuất qua API thông thường sẽ giải quyết các đối tác đó trực tiếp trước khi xem xét danh sách cuộc trò chuyện đầy đủ của tài khoản. Do đó, một kênh công khai có thể đọc được có thể được xuất mà không cần tham gia vào kênh đó, ngay cả khi kênh đó không có trong danh sách cuộc trò chuyện. Các đối tác không được lưu trong bộ nhớ đệm sẽ chuyển sang danh sách thông thường. Bộ lọc lưu trữ vẫn được áp dụng: nếu Telegram không trả về cuộc trò chuyện và các cuộc trò chuyện đã lưu trữ bị loại trừ, trạng thái lưu trữ không xác định sẽ được ghi nhận là thiếu sót. Takeout vẫn giữ quy trình danh sách phạm vi phân chia. Cả hai phương thức đều không tham gia vào các cuộc trò chuyện hoặc thay đổi quyền chuyển tiếp. Trong định dạng JSON tương thích với Desktop, các kênh mà Telegram đánh dấu là `left` sẽ xuất hiện dưới `left_chats`, bao gồm cả các kênh công khai có thể đọc được mà tài khoản chưa tham gia. Cả yêu cầu tạm dừng `FLOOD_WAIT` và `FLOOD_PREMIUM_WAIT` đều áp dụng cho toàn bộ khoảng thời gian do máy chủ yêu cầu. Hạn chót của tài khoản được duy trì qua các lần kết nối lại và khởi động lại; thời gian chờ ngắn hơn sau đó không thể rút ngắn hạn chót này. Số lần thử lại bị giới hạn, việc hủy bỏ sẽ giữ nguyên các trang đã niêm phong, và thông tin đăng nhập API không được xoay vòng để vượt qua giới hạn tốc độ. Không có giao dịch mua gói Premium nào được thực hiện. ## Chọn những gì cần thu thập | Bối cảnh | Ý nghĩa | | --- | --- | | Mục đích | Ghi lại lý do tại sao việc thu thập thông tin này là cần thiết. Không đưa các tên không cần thiết hoặc chi tiết nhạy cảm của vụ việc vào đây. | | Ngôn ngữ báo cáo | Chọn ngôn ngữ cho các nhãn trong báo cáo có thể đọc được. Nội dung tin nhắn gốc vẫn giữ nguyên; các nhãn mẫu chưa được dịch sẽ sử dụng tiếng Anh. Ngôn ngữ được cố định thông qua các tùy chọn công việc đã được ký. | | Các loại cuộc trò chuyện / ID cuộc trò chuyện | Tất cả các loại đã chọn hoặc chỉ các cuộc trò chuyện được liệt kê; "Tin nhắn đã lưu" thuộc về các cuộc trò chuyện riêng tư. Các cuộc trò chuyện đã lưu trữ có thể được chọn riêng biệt. | | Ngày tháng | UTC. Cả hai ngày bắt đầu và kết thúc trên lịch của bảng điều khiển đều được bao gồm. API sử dụng các khoảng thời gian bao gồm `from_utc` và loại trừ `to_utc`; bảng điều khiển sẽ gửi thời điểm bắt đầu của ngày tiếp theo sau ngày “Through”. Một giới hạn trống sẽ không áp dụng hạn chế cho phía đó. | | ID người gửi | Chỉ hiển thị tin nhắn từ những người gửi được liệt kê; danh sách trống bao gồm tất cả người gửi. | | Nội dung bao gồm | Các cụm từ văn bản không phân biệt chữ hoa chữ thường, được so khớp bằng toán tử OR. Các điều kiện người gửi/ngày/nội dung tin nhắn của chính người dùng được kết hợp bằng toán tử AND. | | Tin nhắn của chính mình | Chỉ lưu giữ các tin nhắn gửi đi. | | Các loại phương tiện | Chọn các danh mục tệp đính kèm hoặc xóa tất cả để tránh tải xuống các tệp tin trong tin nhắn. | | Giới hạn tệp / tổng dung lượng phương tiện | Dung lượng theo tệp (MiB) và tổng dung lượng phương tiện đã tải xuống (GiB). Văn bản, biên lai, báo cáo có thể đọc được và dung lượng phụZIP cần thêm dung lượng đĩa. | | Các danh mục tài khoản | Hồ sơ, danh bạ, ảnh đại diện, câu chuyện, siêu dữ liệu phiên và các dữ liệu Takeout khác có các tùy chọn điều khiển riêng biệt. | Cài đặt sẵn **bộ sưu tập “Minimize”** sẽ vô hiệu hóa các tệp và siêu dữ liệu tài khoản. Các bộ lọc người gửi/nội dung được áp dụng trước khi lưu giữ các trang tin nhắn và tải xuống phương tiện. Telegram vẫn truyền các trang lịch sử API chứa các tin nhắn cần thiết để đánh giá các bộ lọc đó: việc lọc không đảm bảo rằng các tin nhắn không được chọn sẽ không bao giờ vào bộ nhớ xử lý. Các hoạt động quan sát khác đang diễn ra trong không gian làm việc có phạm vi và cài đặt lưu giữ riêng. Lịch sử ảnh đại diện, các câu chuyện, siêu dữ liệu phiên và các dữ liệu tài khoản khác được chọn theo mặc định. Vui lòng tắt các mục này, cũng như hồ sơ và danh bạ, khi vụ việc chỉ cần các tin nhắn. Nếu các tệp đính kèm hoặc siêu dữ liệu là không cần thiết, việc loại trừ chúng trong quá trình thu thập sẽ giúp tránh lưu giữ một bản sao riêng tư khác trong tệp xuất này. Dữ liệu ảnh sử dụng biến thể hình ảnh tĩnh được xác định trong siêu dữ liệu và bản kê khai băm của chúng, bao gồm cả ảnh có biến thể hình đại diện động. Hình động đó không được thay thế cho hình ảnh tĩnh đã chọn. Dữ liệu tải có kích thước ngắn hơn hoặc dài hơn kích thước quan sát được sẽ được ghi nhận là tệp đính kèm không thành công, và biểu diễn bị thay đổi trong quá trình làm mới tham chiếu tệp sẽ bị từ chối. Những lỗi này khiến kho lưu trữ trở nên không đầy đủ trong khi vẫn giữ lại các bản ghi tin nhắn. Quá trình xác minh độc lập cũng từ chối các tệp đính kèm đã lưu trữ có độ dài đã ký mâu thuẫn với kích thước hoặc biểu diễn quan sát được, bao gồm cả trong các kho lưu trữ cũ hơn. Nếu kết nối phương tiện chuyên dụng tạm thời bị lỗi, các thao tác đọc tệp đính kèm sẽ sử dụng kết nối tệp tiêu chuẩn. Sau một phút, hệ thống sẽ thử lại kết nối chuyên dụng ở chế độ nền trong khi quá trình tải xuống vẫn tiếp tục. Quy trình khôi phục này vẫn duy trì giới hạn kết nối đã cấu hình và được áp dụng riêng biệt cho từng trung tâm dữ liệu. Các trường hợp chờ do lượng tin nhắn Telegram quá tải và lỗi xác thực vẫn được truyền tiếp. ## Số tin nhắn và bản đồ hoạt động Mỗi kho lưu trữ tài khoản đều chứa `message-gaps.json` và `map.html`. Các kênh và siêu nhóm đánh số tin nhắn theo từng cuộc trò chuyện, do đó mỗi số vắng mặt giữa tin nhắn đầu tiên và tin nhắn cuối cùng được xuất ra đều là một tin nhắn của cuộc trò chuyện đó. Các cuộc trò chuyện riêng tư, bot và nhóm cơ bản chia sẻ một dãy số duy nhất cho toàn bộ tài khoản: một số bị thiếu ở đó thuộc về một cuộc trò chuyện nào đó. Cuộc trò chuyện đó được xác định khi một phản hồi đã xuất hoặc một tin nhắn được ghim trỏ đến số đó; nếu không, nó sẽ được ước tính dựa trên các cuộc trò chuyện đang hoạt động trong khoảng thời gian giữa các tin nhắn liền kề, và phần còn lại được quy cho các cuộc trò chuyện không có trong bản xuất. Mỗi lần chạy đều kèm theo khoảng thời gian, các tin nhắn liền kề, số lượng chia sẻ cho mỗi cuộc trò chuyện và nhãn độ tin cậy. Phạm vi giới hạn (các bộ lọc, các cuộc trò chuyện không được chọn) được nêu rõ, bởi vì các số không có trong danh sách khi đó sẽ bao gồm các tin nhắn nằm ngoài phạm vi lựa chọn. `map.html` hiển thị lịch, các cuộc trò chuyện theo thời gian và lưới theo ngày trong tuần và theo giờ cho các tin nhắn cũng như các số điện thoại vắng mặt, kèm theo bảng liệt kê mọi cuộc trò chuyện và các chuỗi tin nhắn dài nhất. Các trang trò chuyện hiển thị lịch riêng, danh sách thành viên theo thời gian đối với các nhóm, cùng một dấu hiệu trong bản ghi nơi các tin nhắn bị thiếu. `verify.py` tính toán lại `message-gaps.json` từ các trang đã được ký và từ chối tệp đã bị thay đổi. Bản đồ hoạt động liệt kê các khoảng trống lớn nhất trên kênh và siêu nhóm, bao gồm phạm vi số và thời gian của các tin nhắn liền kề. Mở một phạm vi để chuyển đến vị trí được đánh dấu của phạm vi đó trong bản ghi được chia trang. Các dấu này ghi lại các số bị thiếu giữa các tin nhắn liền kề đã được lưu; các sự kiện xóa, thời gian và nội dung tin nhắn chỉ được lấy từ các bản ghi đã lưu. Các bảng rộng có thể cuộn trong các ô của chúng trên màn hình nhỏ. Các bản ghi dài bao gồm một chỉ mục trang với các khoảng thời gian của tin nhắn và một lịch. Chọn một tháng để mở bản ghi đầu tiên theo thứ tự các trang đã được ghi lại. Số thứ tự tháng dựa trên ngày tin nhắn được ghi lại theo múi giờ UTC; các bản ghi không có ngày vẫn được giữ lại trong bản ghi. Chức năng điều hướng trang bao gồm trang đầu tiên, trang cuối cùng và các trang lân cận, đồng thời mở trực tiếp phần tin nhắn. Chỉ mục hoạt động ngoại tuyến mà không cần JavaScript. ## Tóm tắt, phạm vi và xác minh Mỗi tác vụ sẽ khóa các tùy chọn và danh tính tài khoản của nó. Danh mục và các trang đã thu thập được ký xác thực; biên lai trang ghi lại các giá trị băm, vị trí con trỏ, thời gian, kết quả tệp đính kèm và biên lai trước đó. Chỉ các trang đã được cam kết mới được tính vào tiến độ. Khi khởi động lại hoặc tiếp tục, hệ thống sẽ kiểm tra các bản ghi này trước khi tiếp tục. Tài khoản bị thay đổi, trang đã ký bị thay đổi hoặc chuỗi biên lai không nhất quán sẽ bị từ chối. Không thể chỉnh sửa tùy chọn trong quá trình thu thập: hãy bắt đầu một tác vụ khác cho phạm vi khác. Nút "Pause" (Tạm dừng) sẽ tạm dừng hoạt động của tài khoản đang chạy. Khi khởi động lại ứng dụng, công việc chưa hoàn thành sẽ vẫn còn đó để bạn có thể tiếp tục một cách rõ ràng. Một phiên Takeout đã hết hạn yêu cầu phải tiếp tục một cách rõ ràng; việc thay đổi phạm vi phân chia Telegram có thể yêu cầu một quá trình thu thập mới. Chức năng "Resume" (Tiếp tục) giữ lại các quan sát trước đó, do đó, quá trình xuất dữ liệu kéo dài không phải là một bản chụp nhanh nguyên tử duy nhất. Các thao tác thay đổi tài khoản khác và các quá trình xuất dữ liệu xung đột sẽ bị chặn trong quá trình thu thập. Hãy đợi cho đến khi quá trình đóng gói hoàn tất trước khi xóa một không gian làm việc. Chức năng “Tiếp tục” sẽ hiển thị thông **báo Đang xác minh dữ liệu xuất đã lưu…** ngay lập tức và tiến hành kiểm tra nội dung đã lưu ở chế độ nền trước khi kết nối với Telegram. Bảng điều khiển vẫn có thể sử dụng được trong quá trình xác minh. Chức năng “Tạm dừng” sẽ chờ cho đến khi tiến trình xác minh hoàn tất một cách an toàn trước khi giải phóng tài khoản; chức năng này cũng hoạt động khi được nhấn ngay sau khi bắt đầu hoặc tiếp tục quá trình. Trên các thiết bị lưu trữ có tốc độ chậm, thời gian chờ này có thể kéo dài. Nếu kiểm tra tính toàn vẹn không thành công, hệ thống sẽ ghi lại tác vụ thất bại kèm theo lời giải thích và vẫn giữ lại các tệp tin liên quan. Nếu Telegram ngắt quyền truy cập tài khoản trong quá trình thu thập danh sách tin nhắn, lịch sử trò chuyện hoặc tệp đính kèm, tác vụ sẽ tạm dừng mà không đánh dấu trang chưa hoàn thành là đã hoàn tất. Hãy kết nối lại cùng tài khoản đó và nhấn “Tiếp tục” để tiếp tục từ trang cuối cùng đã được lưu. Các ký hiệu thay thế cho tin nhắn không khả dụng sẽ di chuyển con trỏ lịch sử trò chuyện nhưng không kết thúc quá trình đọc: các tin nhắn cũ hơn vẫn có sẵn sẽ tiếp tục được yêu cầu, và ký hiệu thay thế này không được hiển thị như một tin nhắn đã thu thập hoặc một tin nhắn đã được xác nhận xóa. The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed. Các tệp ZIP đã hoàn tất vẫn có sẵn để tải xuống nhiều lần và tải xuống theo phạm vi HTTP. Một kho lưu trữ tài khoản chứa các tệp `manifest.json`, `manifest.sig`, `job.json` đã ký, `inventory.json`, `receipts/`, `data/*.jsonl` có thẩm quyền, `media/` đã chọn, HTML có thể đọc được và một trình xác minh. Ghi lại dấu vân tay của bộ thu thập qua một kênh độc lập, sau đó xác minh bằng cách sử dụng một bản cài đặt đáng tin cậy. Bảng điều khiển lưu kho lưu trữ dưới dạng tệp `tgwitness-account-export-EXPORT_ID.zip`; một bản ghi được niêm phong sẽ chứa tệp này bên trong kho lưu trữ bằng chứng của nó dưới dạng tệp `account-export.zip`. Sử dụng tên tệp mà bạn có: ``` python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256 ``` Đối với các kho lưu trữ có dung lượng mở rộng vượt quá 4 GiB, hãy đặt một giới hạn dung lượng phù hợp một cách rõ ràng `--max-gib`. Bảng điều khiển xác minh các tệp lưu trữ cục bộ đã được xác thực và hoàn tất bằng cách sử dụng kích thước mở rộng đã khai báo và bản tóm tắt ZIP đã công bố; CLI bên ngoài duy trì giới hạn kích thước độc lập của riêng mình. Hãy xác minh trước khi mở tệp HTML có thể đọc được. Trình xác minh đi kèm trong tệp lưu trữ rất tiện lợi, nhưng việc sử dụng một trình xác minh được lấy độc lập sẽ giúp tránh phải tin tưởng vào mã thực thi được cung cấp cùng với bằng chứng. Chữ ký Ed25519 và hàm băm SHA-256 phát hiện các thay đổi sau khi bộ thu thập đã ghi lại các byte liên quan. Kiểm tra kết quả đó cùng với phạm vi thu thập đã ghi lại, khoảng thời gian thu thập, biên lai dấu thời gian bên ngoài và các kiểm tra nguồn gốc có sẵn cho triển khai đã chọn. Các quan sát sau này được ghi lại riêng biệt, đồng thời giữ nguyên các phiên bản đã thu thập trước đó. ## Chuẩn bị tài liệu tiết lộ thông tin cho luật sư hoặc người nhận khác Sau khi tải xuống tệp xuất hoàn chỉnh, hãy giữ lại tệp gốc ZIP và mở `index.html` từ bản sao đã giải nén. Báo cáo giải thích phạm vi, mức độ bao phủ có sẵn và các giới hạn của nó. Các tham chiếu bản ghi kết hợp tham chiếu kho lưu trữ, đường dẫn tài liệu và số bản ghi, để người nhận có thể tìm thấy mục tương ứng trong tệp HTML hoặc bản in. Để xem ví dụ minh họa, hãy truy cập [mở báo cáo hư cấu](https://phishdestroy.github.io/TgWitness/demo/report/). Từ tệp xuất tài khoản đã hoàn tất, hãy chọn **“Chuẩn bị bản sao để chia sẻ**”. Thao tác này sẽ tạo ra một bản sao có chữ ký riêng biệt. Nguồn ZIP vẫn giữ nguyên và ở chế độ riêng tư; không gửi nó cùng với bản sao đã được tối ưu hóa trừ khi người nhận được ủy quyền để nhận toàn bộ nội dung của nó. Hãy chọn ngôn ngữ báo cáo riêng biệt. Việc thay đổi ngôn ngữ hoặc bất kỳ cài đặt lựa chọn nào đều yêu cầu xem trước một lần nữa trước khi tạo. 1. Nhập mục đích tiết lộ và chọn các tiêu chí về ngày tháng, ID người gửi và văn bản chính xác. 2. Chọn giữa việc giữ nguyên danh tính, chỉ hiển thị những người tham gia được liệt kê, hoặc ẩn danh cho tất cả mọi người. Trong cả hai chế độ ẩn danh, ID/tiêu đề cuộc trò chuyện và ID tin nhắn cũng sẽ được thay thế. Các biệt danh sẽ ổn định trong một lần chia sẻ thông tin và thay đổi giữa các lần chia sẻ được chuẩn bị độc lập. 3. Giữ nguyên văn bản tin nhắn, bỏ qua hoàn toàn hoặc thêm tên/cụm từ chính xác vào danh sách che giấu. Ở chế độ riêng tư, công cụ này cũng che giấu tên người gửi ẩn đã biết và tên người dùng thay thế, ID người gửi toàn bộ token, tên trong cuộc trò chuyện trực tiếp, liên kết, địa chỉ email và các chuỗi ký tự giống số điện thoại. Việc khớp tên đã biết xử lý việc chuyển đổi chữ hoa/thường theo Unicode, bao gồm `Straße`/`STRASSE`. Các tiêu đề chung của nhóm/kênh sẽ không tự động bị loại bỏ khỏi nội dung tin nhắn. Nếu vượt quá giới hạn che giấu danh tính đã biết, hãy thu hẹp phạm vi xuất nguồn hoặc loại bỏ văn bản; công cụ sẽ không tự động bỏ qua các tên xuất hiện sau đó. Đây là các quy tắc được áp dụng theo khả năng tốt nhất, không phải là biện pháp ẩn danh toàn diện. 4. Không nên bao gồm các tệp trừ khi người nhận cần chúng. Các tệp gốc được bao gồm vẫn giữ nguyên độ phân giải, âm thanh, văn bản và siêu dữ liệu. Chúng **không** được công cụ này ẩn danh hóa. 5. Xem trước số lượng, cảnh báo và các mẫu tin nhắn đã được chuyển đổi, sau đó xác nhận rõ ràng việc tạo bản ghi. Mỗi mẫu được giới hạn ở 12 tin nhắn và 2.000 ký tự văn bản. Đây chỉ là mẫu, không phải là bản xem xét đầy đủ về kết quả. Việc thay đổi cài đặt yêu cầu phải xem trước lại. Bản xem trước sẽ hết hạn sau 15 phút và chỉ áp dụng cho phiên quản trị viên đó cùng với thẻ ZIP gốc chính xác; nó không thể được sử dụng lại sau khi tạo. Một bản xem trước mới sẽ làm mất hiệu lực bản xem trước trước đó cho cùng một tác vụ và phiên làm việc. 6. Xem toàn bộ kết quả `index.html` và `messages.jsonl` trên máy cục bộ trước khi chuyển giao. Nếu phát hiện thông tin không cần thiết, hãy tạo một bản công bố mới với các điều khoản loại trừ chặt chẽ hơn. Không chỉnh sửa trực tiếp thẻ ZIP đã được ký. ### Các tin nhắn bị loại trừ khỏi kết quả lọc **Xem trước.** Một thông báo tiết lộ sẽ không hiển thị đầy đủ nếu thông tin chưa hoàn chỉnh. Trong mỗi cuộc trò chuyện chứa ít nhất một tin nhắn đã được tiết lộ, các tin nhắn bị loại khỏi lựa chọn sẽ xuất hiện dưới dạng các dấu hiệu, `[withheld by selection — rule: sender]` (hoặc `text`, `period`). Chọn **“Các tin nhắn bị loại trừ bởi lựa chọn**”: một dấu hiệu cho mỗi chuỗi tin nhắn liên tiếp bị loại trừ (mặc định) hoặc một dấu hiệu cho mỗi tin nhắn. Các dấu hiệu chỉ chứa quy tắc và số lượng, không bao giờ chứa nội dung, người gửi, ngày tháng hoặc tệp đính kèm. Các cuộc trò chuyện không có tin nhắn nào được tiết lộ sẽ bị loại trừ hoàn toàn, do đó gói phần mềm này không tiết lộ sự tồn tại của chúng. Các phản hồi được tiết lộ cho biết nội dung mà chúng trả lời: một tin nhắn có trong bản sao này, một tin nhắn bị loại trừ khỏi lựa chọn, hoặc một tin nhắn không có trong bản xuất nguồn (đã bị xóa trước khi xuất hoặc chưa bao giờ được xuất; bản xuất không thể xác định được trường hợp nào). Một tin nhắn bị loại trừ mà câu trả lời được tiết lộ đề cập đến luôn có dấu hiệu riêng, do đó câu trả lời sẽ trỏ đến một bản ghi giải thích lý do tại sao nó trống. Ba trạng thái này khác biệt với các trường hợp xóa và khoảng trống trong bộ sưu tập, vốn thuộc về tệp xuất nguồn. Trong `messages.jsonl` (định dạng `tgwitness-account-disclosure-v2`) mỗi tin nhắn có `state`: `disclosed`, hoặc `withheld` với `rules` và `count`. Một phản hồi được tiết lộ có `reply_to` với mục tiêu `id` và `state` (`disclosed`, `withheld`, `not_in_source`). Danh sách này thống kê các tin nhắn, cuộc trò chuyện, phương tiện truyền thông và `withheld` tin nhắn. `verify.py` từ chối một dấu hiệu chứa nội dung và một phản hồi trỏ đến một bản ghi bị thiếu trong gói; các gói phiên bản 1 được xác minh như trước đây. Định dạng tối giản loại bỏ các hồ sơ tài khoản có cấu trúc, danh bạ, ảnh đại diện, phiên làm việc, câu chuyện, đối tượng Telegram thô, tiêu đề chuyển tiếp, trích dẫn trả lời, thẻ liên hệ và siêu dữ liệu vị trí. Nó loại trừ các tệp JSONL gốc, cài đặt bộ lọc riêng tư, khóa bí danh và bản đồ danh tính. Văn bản được chọn, danh tính được giữ lại rõ ràng và các tệp được bao gồm vẫn có thể chứa cùng tên, ID hoặc cụm từ được sử dụng trong các bộ lọc đó; chúng cần được xem xét riêng. Chính sách riêng tư và khóa bí danh được lưu giữ dưới dạng mã hóa trong kho lưu trữ cục bộ của tác vụ; việc xóa tác vụ sẽ xóa các bản ghi tiết lộ riêng tư liên quan. Các bản ghi chính sách công khai ghi lại số lượng bộ lọc thay vì giá trị bộ lọc. Mục đích được nêu rõ là công khai trong tệp manifest và HTML: các tiêu chí riêng tư rõ ràng và, trong các chế độ ẩn danh, các danh tính ẩn đã biết cũng được che giấu tại đó, kể cả khi nội dung tin nhắn bị bỏ qua. Hãy giữ cho mục đích không chứa các chi tiết cá nhân không cần thiết; bối cảnh nhận dạng chưa xác định có thể được giữ lại. Tệp manifest của nó liên kết các tệp phái sinh, chính sách công khai và giá trị băm của tệp ZIP gốc. Quá trình xác minh có thể xác định tính toàn vẹn và, nếu nguồn được cung cấp tại địa phương, xác nhận sự khớp nhau của các liên kết nguồn. Bảng điều khiển lưu bản sao chia sẻ dưới tên `tgwitness-disclosure-DISCLOSURE_ID.zip`: ``` python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip ``` Liên kết nguồn cho biết bản tiết lộ đến từ kho lưu trữ nào và khóa bộ thu thập nào. Bản tiết lộ chỉ chứa nội dung đã chọn; hãy đối chiếu việc chọn lọc và việc loại bỏ chi tiết nhận dạng với bản xuất gốc. ## Chia sẻ và lưu trữ dữ liệu ghi lại Chọn các tin nhắn và tệp mà người nhận cần, xem xét bản sao chia sẻ đầy đủ và lưu giữ bản gốc riêng biệt. Ghi lại giá trị băm (hash) của tệp ZIP đã gửi để người nhận có thể xác định và xác minh chính xác bản sao đó. Quá trình ẩn danh hóa sẽ thay thế các định danh đã chọn; văn bản và tệp gốc vẫn là một phần của quá trình xem xét. GitHub Actions hỗ trợ xuất toàn bộ tài khoản và các cuộc trò chuyện được chọn thông qua Takeout hoặc API thông thường, cùng với nhật ký sự kiện của một cuộc trò chuyện. Hướng dẫn sao lưu được lưu trữ giải thích việc xác minh cài đặt và giới hạn 120 phút. Để xác minh bản sao chia sẻ được tạo từ bản sao lưu được lưu trữ, hãy so sánh băm nguồn của nó với kho lưu trữ gốc và xác minh chứng nhận của kho lưu trữ đó bằng các kiểm tra [dành riêng cho chế độ](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope). [Định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) · [Báo cáo trường hợp](https://phishdestroy.io/tgwitness/vi/docs/reference/case-reports/) --- # Telegram · Định dạng bằng chứng Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/ Nội dung của tệp ZIP đã được ký, các loại bản ghi, biên nhận giao dịch, hồ sơ người dùng, bản sao lưu ngoài trang web và xác minh ngoại tuyến. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Translation coverage: this edition includes material from the English original. Nội dung của tệp ZIP đã được ký, các loại bản ghi, biên nhận giao dịch, hồ sơ người dùng, bản sao lưu ngoài trang web và xác minh ngoại tuyến. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Bằng chứng & xác minh](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness lưu trữ các quan sát Telegram có thể xem được từ tài khoản trong một nhật ký đã được ký. Người nhận có thể xác minh các bản ghi, tệp đính kèm và báo cáo đã lưu so với một khóa thu thập dữ liệu đáng tin cậy, kiểm tra thời gian bên ngoài từ bên thứ ba cho bản ghi cuối cùng, và so sánh nhật ký với một điểm kiểm tra mà họ đã lưu giữ trước đó. Trang này mô tả các định dạng, các bước kiểm tra và tài liệu cần lưu giữ để bàn giao. Người dùng có thể bắt đầu với **VERIFY.cmd** trên Windows: công cụ này yêu cầu tệp ZIP gốc và dấu vân tay khóa được thu thập độc lập, hiển thị kết quả kèm giải thích, và lưu bản ghi xác minh riêng biệt. Xem các trình khởi chạy xác minh [và môi trường chạy di động](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md) để biết thông tin về cài đặt và giới hạn tin cậy. **Trên trang này** - [Điều gì được ký](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#what-is-signed) - [So sánh các tệp xuất dữ liệu trò chuyện](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#comparing-chat-exports) - [Chuyển giao cuộc điều tra](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#investigation-handoff) - [Trích đoạn bàn giao](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#handover-extract) - [Báo cáo dễ đọc](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#readable-reports) - [Chuẩn hóa sự kiện](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#event-canonicalization) - [Ý nghĩa của Actor](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#actor-semantics) - [Phạm vi bao phủ: tính liên tục, khoảng trống và các ID chưa được quan sát](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids) - [Người sản xuất](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#producer) - [Hồ sơ người dùng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#people-profiles) - [Chứng nhân độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#independent-witness) - [Manifest và các điểm kiểm tra](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#manifest-and-checkpoints) - [Phạm vi xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) - [Tệp đính kèm](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#attachments) - [Thu thập và xử lý biên nhận một cách bền vững (0.2)](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#durable-collection-and-process-receipts-02) - [Chuẩn bị RFC 3161 và xác minh phản hồi (0.2)](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02) - [Các bản ghi tùy chọn trong chế độ bằng chứng: drand và các thiết bị Telegram](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices) ## “Được ký” là gì | Nội dung | Bảo vệ | Những nội dung cần lưu giữ | | --- | --- | --- | | Mọi ghi nhận trong nhật ký, bao gồm các sự kiện hoạt động | Chuỗi SHA-256 và chữ ký Ed25519 cho mỗi sự kiện | `events.jsonl` gốc, dấu vân tay khóa đáng tin cậy, và điểm kiểm tra được lưu giữ | | Nội dung tệp ZIP chứa bằng chứng | `manifest.sig` ký vào bản kê khai chuẩn, trong đó liệt kê các giá trị băm của các tệp nội dung | Tệp ZIP đầy đủ, bao gồm tệp manifest và chữ ký | | Tệp đính kèm được lưu giữ | Giá trị SHA-256 và số byte trong một sự kiện `media.saved` có chữ ký; băm tệp trong bản kê khai ZIP có chữ ký | Các byte gốc bên trong tệp ZIP đã được xác minh | | Điểm kiểm tra | Chữ ký Ed25519 trên độ dài sổ ghi chép, băm tiêu đề, khóa công khai và thời gian tạo | Một bản sao độc lập được lưu giữ trước khi có thay đổi gây tranh cãi | | Biên lai giao dịch | Bản ghi đã ký về phiên bản trình thu thập, băm tệp nguồn và cài đặt ban đầu, cũng được bao gồm trong `process.started` | Biên lai, sổ nhật ký liên quan và bằng chứng môi trường cho chế độ xác minh đã chọn | | Báo cáo dễ đọc: `report.html` và các phần của nó, `report.json`, `report.pdf`, `chat.pdf` | Mỗi tệp có một con dấu Ed25519 trên nội dung của nó; PDF cũng mang theo chữ ký tiêu chuẩn PDF (xem [Báo cáo có thể đọc được](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#readable-reports)) | Tệp nhận được và dấu vân tay khóa đáng tin cậy; tệp ZIP được mô tả trong đó | | CSV độc lập | Không có chữ ký mật mã độc lập; chỉ riêng các giá trị băm sự kiện là chưa đủ | Vui lòng sử dụng bản sao chính xác có trong tệp ZIP đã được xác minh để kiểm tra tính toàn vẹn | | Ảnh chụp màn hình, bản in hoặc tệp PDF được tạo ra từ trình duyệt | Không có chữ ký của TgWitness trên bản sao | Vui lòng giữ lại gói phần mềm gốc đã được xác minh và ghi chép lại quy trình tạo ra phiên bản phái sinh | Trình thu thập xác minh chữ ký nhật ký trước khi tạo mọi định dạng xuất. Các báo cáo HTML và PDF dễ đọc đều có con dấu riêng; tệp CSV độc lập được kiểm tra như một phần của tệp ZIP đã ký. Giữ lại tệp ZIP để bảo toàn các byte tệp đính kèm và bản kê khai, cùng một điểm kiểm tra riêng biệt để đối chiếu nhật ký với ranh giới trước đó. ## Các định dạng và đường dẫn xác minh Chế độ thu thập và định dạng đầu ra trả lời các câu hỏi khác nhau. Chế độ cung cấp bằng chứng về quá trình thu thập và môi trường; mỗi định dạng giữ nguyên hoặc trình bày một phần của bản ghi đó với các kiểm tra dưới đây. | Kết quả đầu ra | Xác minh và sử dụng | | --- | --- | | Bằng chứng ZIP | Các sự kiện chuẩn, bản kê khai có chữ ký, phạm vi bao phủ, mục lưu giữ, tệp đính kèm và biên nhận bên ngoài có sẵn; kiểm tra kho lưu trữ và chế độ thu thập đã chọn của nó. | | Container ASiC-E | Tệp ZIP chứa bằng chứng dưới dạng container ETSI ASiC-E (EN 319 162-1) với mục nhập loại MIME (`mimetype`) và tệp `META-INF/ASiCManifest.xml`, được ký bằng CAdES bằng chứng chỉ riêng của không gian làm việc ở mức B-B, hoặc B-T khi tính năng đóng dấu thời gian được bật. Các công cụ xác thực như EU DSS kiểm tra định dạng và tính toàn vẹn; do chứng chỉ được tự cấp, hệ thống báo cáo không có điểm neo tin cậy. EU DSS 6.3 với cài đặt mặc định sẽ từ chối tệp chứa có hơn 1.000 tệp ("Phát hiện quá nhiều tệp"). `verify.py` kiểm tra tệp manifest Ed25519 và mọi tệp được liệt kê, các giá trị SHA-256 trong tệp `META-INF/ASiCManifest.xml` cũng như trong tệp `ASiCManifestNNN.xml` hoặc `ASiCEvidenceRecordManifest.xml` được thêm vào, và sẽ báo lỗi nếu phát hiện mục trong `META-INF/` mà không có tệp nào trong số đó bao phủ. Công cụ này không kiểm tra chữ ký CAdES và sẽ thông báo điều này. | | Báo cáo HTML và JSON | Các bản xem được niêm phong riêng lẻ kèm theo tham chiếu nguồn, cũng được liệt kê trong bản kê khai ZIP. Số lượng được ghi lại của chúng tóm tắt các loại sự kiện trong nhật ký. | | Báo cáo PDF | Con dấu Ed25519 cùng với chữ ký PDF cơ sở PAdES trên phạm vi byte: B-B, hoặc B-T kèm theo dấu thời gian của chữ ký khi tính năng đóng dấu thời gian được bật. Trình xác minh TgWitness sử dụng khóa Ed25519 đáng tin cậy; việc hiển thị mức độ tin cậy của chứng chỉ trên trình xem là một bước kiểm tra riêng biệt. | | CSV | Chế độ xem bảng tính được bao phủ bởi bản kê khai ZIP. Cơ chế thoát công thức bảo vệ việc sử dụng bảng tính; văn bản gốc đã được ký vẫn được lưu giữ trong nhật ký. | | JSONL | Các bản ghi sự kiện được ký, bao gồm các tham chiếu tệp đính kèm. Tệp ZIP chứa bằng chứng cũng chứa các byte tệp đính kèm đã được bảo toàn. | | Xuất dữ liệu trò chuyện và các chế độ xem tương thích với máy tính để bàn | Việc thu thập lịch sử và các bản ghi nhật ký quản trị có sẵn, kèm theo bản hiển thị theo yêu cầu và kho lưu trữ đã ký. Các phiên bản đã lưu của giám sát trực tiếp là một đường dẫn thu thập riêng biệt. | | Bản ghi phương tiện và bản ghi chỉ chứa mã băm | Các byte đã lưu được kiểm tra dựa trên SHA-256 và tham chiếu tin nhắn của chúng. Việc thu thập chỉ băm (hash-only acquisition) giữ lại siêu dữ liệu băm có sẵn để so sánh sau này với các byte tệp. | | STIX/MISP và hồ sơ cá nhân | Các quan sát được trích xuất có liên kết nguồn, ID tài khoản và các kết quả khớp phân tích. Chữ ký hồ sơ và băm bản ghi có thể được đối chiếu với bằng chứng gốc; nguồn gốc bộ nhớ đệm ảnh đại diện được gắn nhãn riêng biệt. | | Trích đoạn bàn giao | Các quy tắc tiết lộ đã ký, các bản ghi không thay đổi và các bản ghi được đánh dấu là đã thu gọn vẫn giữ nguyên các hàm băm/chữ ký gốc. Sử dụng bản gốc được giữ lại để so sánh khi cần các trường bị ẩn. | | Bằng chứng và biên nhận thời gian | Các ranh giới nhật ký trước đó, tính liên tục và các tuyên bố thời gian đã được xác minh riêng lẻ. Chúng đi kèm với các kiểm tra thu thập và lưu trữ. | | Giao hàng được bảo vệ bằng mật khẩu | Bảo vệ gói dữ liệu bên trong trong quá trình truyền tải. `.tgwpw` sử dụng mã hóa có xác thực AES-GCM, bao gồm một bản ghi cuối cùng được xác thực; nhật ký bên trong vẫn giữ nguyên các chữ ký và biên lai thu thập của mình. | Bản in hoặc ảnh chụp màn hình là bản trình bày của tài liệu đã được ký. ID báo cáo, dấu vân tay khóa và mã QR tham chiếu của nó giúp xác định vị trí tệp gốc để xác minh. Các tuyên bố về quyền lưu giữ ghi lại thông tin về người kiểm tra được chỉ định và thông tin chuyển giao; kết quả xác minh và biên lai thu thập được lưu giữ như các bằng chứng riêng biệt. ### Chữ ký bên ngoài Một chữ ký cũng có thể xuất phát từ một khóa mà TgWitness không bao giờ lưu giữ, chẳng hạn như chữ ký điện tử đủ điều kiện của điều tra viên hoặc con dấu của tổ chức. Đối với **các tệp xuất**, **chữ ký bên ngoài**trên tệp xuất đã chuẩn bị mà không có mật khẩu sẽ cung cấp các byte cần ký: một danh sách mới `META-INF/ASiCManifestNNN.xml` liệt kê mọi tệp cùng với giá trị SHA-256 của chúng cho một container ASiC-E hoặc `manifest.json` đối với tệp ZIP. Người ký trả về một CMS (CAdES) `.p7s`, tách biệt hoặc có nội dung được nhúng vào. TgWitness kiểm tra xem chữ ký có bao phủ chính xác các byte đó hay không và xác thực bằng chứng chỉ của người ký (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). Chuỗi chỉ được kiểm tra dựa trên các chứng chỉ gốc do nhà điều hành cung cấp; việc thu hồi, danh sách đáng tin cậy và trạng thái đủ điều kiện không được kiểm tra. Bảng điều khiển hiển thị một trạng thái cho mỗi chữ ký: đang chờ chữ ký, đã đính kèm nhưng chưa được kiểm tra, đã được xác minh, thuật toán không được hỗ trợ, chữ ký không hợp lệ, các byte được ký không khớp, hoặc chứng chỉ không được liên kết với một chứng chỉ gốc được cung cấp. Việc thay đổi tệp xuất sau khi các byte đã được phân phối sẽ đặt tất cả các chữ ký của tệp đó thành "các byte được ký không khớp". **Tải xuống kèm chữ ký** sẽ thêm các chữ ký và bản kê khai của chúng vào `META-INF` trong một container ASiC-E. Đối với tệp ZIP, nó sẽ đặt tệp ZIP không thay đổi, các `.p7s` các tệp và `SIGNATURES.txt` vào một tệp ZIP bên ngoài. Các chữ ký không hợp lệ và các chữ ký chồng lên các byte khác sẽ bị loại bỏ. Một chữ ký sử dụng thuật toán mà TgWitness không thể kiểm tra vẫn được bao gồm; bảng điều khiển hiển thị trạng thái của nó, giống như `SIGNATURES.txt` đối với tệp ZIP. ### Hình ảnh trò chuyện có chữ ký **Tải xuống tệp ZIP đã ký** trong bản xem trước hình ảnh sẽ lưu các trang dưới dạng PNG, `pages.sig.json` và `README.txt`. Mỗi trang kết thúc bằng các số bản ghi nhật ký được hiển thị, nội dung trò chuyện, thời gian hiển thị, dấu vân tay khóa không gian làm việc và lệnh kiểm tra nó. Bảng điều khiển chỉ gửi mã SHA-256 và các số bản ghi của từng trang; máy chủ xác nhận rằng các bản ghi thuộc về cuộc trò chuyện, ký vào bản tuyên bố (`tgwitness-image-attestation-v1`) bằng khóa không gian làm việc và ghi lại quá trình ký vào nhật ký dưới dạng `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 ``` Bộ xác minh kiểm tra chữ ký, đối chiếu từng tệp PNG với một trang đã được ký và báo cáo dấu vân tay khóa. `--fingerprint` so sánh người ký với dấu vân tay được lấy từ người gửi một cách độc lập. `--evidence` đọc tệp ZIP bằng chứng đã ký của cùng một không gian làm việc và yêu cầu mọi bản ghi của các hình ảnh phải có mặt với cùng một giá trị băm. Một pixel bị thay đổi, một tuyên bố bị thay đổi hoặc một khóa khác sẽ khiến quá trình kiểm tra thất bại. Các hình ảnh hiển thị các bản ghi đã lưu theo bố cục riêng của TgWitness; chúng không hiển thị những gì Telegram đã hiển thị cho bất kỳ ai. ## So sánh các tệp xuất từ cuộc trò chuyện Xác minh và so sánh hai tệp ZIP xuất dữ liệu trò chuyện đã được ký với các dấu vân tay của người ký được lưu giữ độc lập: ``` python -m tgwitness.verify first.zip --compare second.zip \ --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256 ``` `--require` và `--require-tier` sẽ bị từ chối khi được sử dụng cùng với `--compare`; hãy kiểm tra cấu hình bắt buộc của từng tệp lưu trữ thông qua quá trình xác minh riêng của từng tệp. Khi cả hai kho lưu trữ đều ghi lại cùng một ID tài khoản và ID cuộc trò chuyện, các bản ghi sẽ được ghép đôi theo ID tin nhắn. **Không thay đổi** có nghĩa là bản ghi JSON được lưu trữ hoàn chỉnh là giống nhau: toàn văn, tác giả, ngày tháng, đối tượng trả lời, siêu dữ liệu lồng nhau và các trường chưa biết đều được bao gồm. Thứ tự khóa của đối tượng JSON không quan trọng; các trường thiếu, giá trị null, loại giá trị và thứ tự mảng thì có. Bản xem trước gồm 300 ký tự chỉ dành cho hiển thị. Các mục đã thay đổi được đánh dấu bằng `changed_fields` cấp cao nhất khác biệt, bao gồm cả những thay đổi không hiển thị trong bản xem trước đó. Các ID tin nhắn trùng lặp sẽ bị từ chối thay vì ghi đè lên nhau trong quá trình khớp. Sự khác biệt có thể là tên hiển thị đã thay đổi, số lượt xem, chú thích bộ sưu tập hoặc các siêu dữ liệu quan sát khác. Các chỉnh sửa trên Telegram xuất hiện dưới dạng các sự kiện chỉnh sửa riêng biệt, và mỗi quá trình xác minh lưu trữ sẽ cho biết liệu lưu trữ đó có còn nguyên vẹn hay không. Các bản ghi chưa được phân tích vẫn được giữ lại trong quá trình so sánh và được so sánh dựa trên biểu diễn đã lưu của chúng. Đối với các danh tính tài khoản/cuộc trò chuyện khác nhau hoặc thiếu, công cụ sẽ tìm các phù hợp tiềm năng dựa trên người gửi, văn bản đầy đủ, băm tệp, loại phương tiện và dung sai thời gian năm giây, và báo cáo chúng là **Matched** thay vì **Unchanged**. Các bản ghi chưa được phân tích vẫn không được khớp. Sự khác biệt trong các bản ghi được ghép đôi được liệt kê trong `changed`, bao gồm cả ở chế độ nội dung. Với `--json`, `matched` đếm các cặp ứng viên và `unchanged` đếm các cặp có bản ghi lưu trữ đầy đủ giống hệt nhau. Đầu ra hiện có `changed_fields` và số nguyên `unchanged` vẫn tương thích với các kết quả so sánh trước đó. Định dạng lưu trữ và xác minh chữ ký không thay đổi. ## Chuyển giao cuộc điều tra 1. Ghi lại mã tham chiếu vụ việc, người vận hành, ID tài khoản Telegram dạng số, các nguồn đã chọn, chính sách thu thập và khoảng thời gian thu thập vào ghi chú vụ việc của bạn. TgWitness bảo toàn các quan sát và hỗ trợ ghi chú liên kết với nguồn cũng như các bộ sưu tập trong [Case Board](https://phishdestroy.io/tgwitness/vi/docs/reference/case-board/). Lưu giữ hồ sơ chuyển giao và lưu giữ cùng với các tài liệu vụ việc của bạn. Kiểm tra cấu hình thu thập dự kiến thông qua quy [trình chấp nhận trực tiếp](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md). 2. Lưu lại dấu vân tay khóa công khai của không gian làm việc một cách độc lập trước khi dựa vào các giá trị xuất ra từ nó. Giữ chế độ bằng chứng ở trạng thái bật (mặc định) để các điểm kiểm tra nhận được biên lai theo RFC 3161 và OpenTimestamps. Lưu các điểm kiểm tra đã ký bên ngoài bộ thu thập trong quá trình thu thập. Ghi lại các sự gián đoạn và giới hạn về khả năng hiển thị của tài khoản. 3. Xuất tệp **ZIP đã được ký** và lưu giữ biên nhận thực thi đã được ký. Sử dụng điểm kiểm tra tại hoặc trước ranh giới nhật ký đã xuất. Một điểm kiểm tra sau đó có thể từ chối chính xác việc xuất trước đó do quá ngắn. Các tệp xuất bao gồm toàn bộ nhật ký không gian làm việc, bất kể các bộ lọc trên bảng điều khiển; vui lòng xem xét kỹ tài liệu trước khi chia sẻ. 4. Yêu cầu người nhận xác minh tệp ZIP bằng một bản sao đáng tin cậy của trình xác minh, dấu vân tay được cung cấp độc lập và chứng chỉ gốc của cơ quan cấp dấu thời gian được lấy riêng. Từ một môi trường Python đáng tin cậy đang hoạt động: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` Dấu vân tay và dấu thời gian đã được kiểm tra của bản ghi cuối cùng đáp ứng yêu cầu tối thiểu cho bằng chứng; nếu không, lệnh `--require evidence` sẽ thoát với mã lỗi 2. Điểm kiểm tra là một kiểm tra bổ trợ, vì nó được ký bằng khóa của bộ thu thập. Kết quả đầu ra thành công sẽ báo cáo `key_pinned: true` và `checkpoint_checked: true` khi cả hai đầu vào đều được cung cấp và chấp nhận. Giữ nguyên kết quả xác minh. ``` 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. Ghi lại giá trị SHA-256 của kho lưu trữ, ranh giới xuất, ngày chuyển, người gửi và người nhận vào hồ sơ lưu giữ của bạn. Giữ nguyên gói gốc và làm việc trên các bản sao. Chia sẻ các tệp bằng chứng thay vì thư mục dữ liệu riêng tư của ứng dụng, nơi cũng chứa các phiên tài khoản và khóa ký. Để chuyển giao, hãy chọn tệp ZIP được bảo vệ bằng mật khẩu theo tiêu chuẩn AES-256 hoặc container `.tgwpw` mạnh hơn. ZIP sử dụng thuật toán tạo mật khẩu chi phí thấp của WinZip; hãy sử dụng một cụm mật khẩu ngẫu nhiên dài. `.tgwpw` sử dụng scrypt và AES-256-GCM và được mở bằng lệnh `unseal-password` của trình xác minh độc lập. Mật khẩu không được lưu trữ và chỉ bảo vệ tính bảo mật; người nhận giải mã tập tin lưu trữ và xác minh tệp xuất đã ký bên trong, vốn không bị thay đổi. 2. Để gắn dấu thời gian cho một điểm kiểm tra ngoài chế độ bằng chứng, hãy tuân theo [quy trình RFC 3161](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/) và lưu giữ yêu cầu, điểm kiểm tra, thông tin CA đáng tin cậy và phản hồi đã được xác minh từ cơ quan có thẩm quyền. Chỉ việc chuẩn bị yêu cầu thôi thì không thể nhận được dấu thời gian. Đối với `.tgwpw`, hãy sử dụng trình xác minh được thu thập độc lập và chọn tệp đầu ra mới với phần mở rộng gốc: `python verify.py unseal-password export.tgwpw --out evidence.zip`. Lệnh sẽ yêu cầu nhập mật khẩu; `--password-stdin` đọc một dòng để tự động hóa. Nó không bao giờ ghi đè lên tệp hiện có và chỉ công bố văn bản thuần sau khi tất cả các bản ghi được xác thực. Sau đó, hãy thực hiện xác minh chữ ký thông thường trên tệp đã giải mã. Container sử dụng scrypt (`N=131072`, `r=8`, `p=1`, muối 16 byte; khoảng 128 MiB RAM) và AES-256-GCM với các bản ghi 1 MiB và một bản ghi cuối cùng đã được xác thực. Một bản ghi siêu dữ liệu được mã hóa lưu trữ tên tệp bên trong, do đó các container đã tải xuống có thể được đổi tên. Việc xác minh thành công chứng minh tính toàn vẹn so với khóa thu thập dữ liệu đáng tin cậy và ranh giới được duy trì. Xem [phạm vi xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope) để biết các giả định về độ tin cậy và [kết quả xác thực](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/) cho các kiểm tra đã thực hiện. ## Trích đoạn bàn giao Một tệp ZIP đã ký chứa toàn bộ nhật ký không gian làm việc. Khi tòa án, luật sư hoặc bộ phận xử lý lạm dụng chỉ cần một số cuộc trò chuyện, một khoảng thời gian hoặc những người cụ thể, tùy chọn **Xuất → Trích xuất bàn giao** sẽ chuẩn bị một bản sao được tối ưu hóa (`tgwitness-handover-v1`) theo các quy tắc tiết lộ đã chọn. Người vận hành nêu rõ mục đích và chọn các cuộc trò chuyện, khoảng thời gian tùy chọn (UTC), những người mà bản trích xuất liên quan đến, những gì sẽ xảy ra với những người khác (được hiển thị, được thay thế bằng bí danh P01, P02… hoặc bị loại bỏ), những nội dung tin nhắn nào được giữ lại, những tệp đính kèm và ảnh đại diện nào được bao gồm, và liệu số điện thoại và địa chỉ email trong nội dung tin nhắn có bị che giấu hay không. Mục đích và các quy tắc này được ghi trong bản kê khai đã ký và trong báo cáo; nhật ký ghi lại `handover.exported` cùng với quyền truy cập đã chuẩn bị nó và mã SHA-256 của tệp, chứ không phải nội dung. Tập lệnh `verify.py` kiểm tra một bản trích xuất theo hai cách. Một bản ghi được hiển thị là không thay đổi sẽ được xác minh toàn bộ: so sánh nội dung với giá trị băm, chữ ký Ed25519 và liên kết đến bản ghi tiền nhiệm đi kèm. Một bản ghi được rút gọn vẫn giữ nguyên giá trị băm và chữ ký gốc, do đó chữ ký vẫn được xác minh, nhưng các trường bị ẩn không thể tính toán lại từ đó; bản ghi nêu rõ những gì đã bị ẩn và báo cáo sẽ đánh dấu phần đó. Các bản ghi dịch vụ trên toàn tài khoản (bắt đầu và dừng, khoảng trống phạm vi phủ sóng, thông báo về kết nối, mạng và lưu trữ, thay đổi phạm vi và cài đặt) chỉ giữ lại các trường được liệt kê cho loại của chúng: danh sách trò chuyện trong đó được cắt theo và tổng số tin nhắn của chúng được tính lại; một khoảng trống do kiểm tra thời gian thực trong cuộc trò chuyện nằm ngoài lựa chọn sẽ làm mất cuộc trò chuyện đó, số tin nhắn của nó và tài khoản chứng kiến; trong một cuộc trò chuyện được chọn để kiểm tra, tài khoản chứng kiến sẽ được thay thế bằng biệt danh của nó trừ khi tất cả mọi người đều được hiển thị hoặc đó là một trong những người được chọn. Bản kê khai nêu rõ độ dài nhật ký và tiêu đề cùng chữ ký của người thu thập trên tiêu đề đó, đồng thời đếm số bản ghi bị loại trừ; tệp ``coverage.json`` mô tả các cuộc trò chuyện được chọn. Các bản trích xuất mới cũng kèm theo tệp ``proofs.jsonl``: đối với mỗi bản ghi được bao gồm và đối với tiêu đề nhật ký, đường dẫn Merkle từ băm gốc của bản ghi đến gốc nhật ký được nêu trong bản kê khai đã ký. `verify.py` kiểm tra từng đường dẫn, do đó mỗi bản ghi được xác nhận thuộc cùng một nhật ký có độ dài và tiêu đề đó, mà không cần toàn bộ nhật ký; một trích xuất gồm 100 tin nhắn sẽ hoàn tất kiểm tra trong khoảng một giây bất kể kích thước nhật ký là bao nhiêu. `--range=CHAT:FROM-TO` còn xác nhận thêm rằng các tin nhắn từ FROM đến TO của một cuộc trò chuyện có trong bản trích xuất và báo cáo số lượng bản ghi đã được kiểm tra cho các tin nhắn đó. Tên người dùng trong tên tệp không được phát hiện. Hãy xem lại các tệp cuối cùng trước khi chia sẻ: văn bản tự do, tên tệp và các tệp đính kèm đã chọn vẫn có thể tiết lộ danh tính của người dùng. Hãy giữ lại tệp ZIP đầy đủ đã được ký: bản trích xuất chỉ là một hình thức tiết lộ thông tin, không phải là bản thay thế. ## Báo cáo dễ đọc Bằng chứng đã ký, tệp ZIP bàn giao và tệp ZIP cuộc trò chuyện chứa các báo cáo HTML và JSON có thể đọc được, cùng với tệp PDF khi có sẵn các phông chữ cần thiết, bằng ngôn ngữ báo cáo đã chọn. Mỗi báo cáo được niêm phong bằng khóa Ed25519 của không gian làm việc và có thể được xác minh riêng biệt: ` `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]``. - `report.html` / `chat.html`: lệnh đóng tệp (`tgwitness-report-seal-v1`) sẽ đóng tệp và ký xác thực từng byte trước đó bằng SHA-256. Các nhật ký và cuộc trò chuyện dài sẽ được chia thành các phần có kích thước có thể cấu hình (Cài đặt báo cáo, từ 500 đến 100.000 bản ghi; mặc định là 5.000): `records/records-0001.html` hoặc `messages/messages-0001.html`, mỗi phần được đóng dấu với số thứ tự, phạm vi và tổng số, đồng thời được liệt kê cùng với tệp SHA-256 trong bản kê khai đã ký. Các chuỗi tín hiệu kiểm tra trạng thái của bộ thu thập được hiển thị dưới dạng một dòng trừ khi Cài đặt báo cáo liệt kê chúng từng cái một. - `report.json` (`tgwitness-report-json-v1`, các khóa `format`, `report`, `seal`): con dấu xác thực SHA-256 của bản chuẩn JSON thuộc `report`, do đó các hệ thống và kịch bản xử lý vụ án có thể đọc được các thông tin này và có thể thực hiện lựa chọn để bảo vệ dữ liệu từ đó trong khi tệp đã ký vẫn được giữ nguyên vẹn. - `report.pdf` / `chat.pdf`: một tài liệu chính thức dùng để in và lưu trữ, được ký hai lần trên cùng một dãy byte, bao gồm toàn bộ tệp ngoại trừ giá trị chữ ký (`/ByteRange`). Chữ ký PDF tiêu chuẩn là PAdES baseline (ETSI EN 319 142-1, `/SubFilter /ETSI.CAdES.detached`: CMS với SHA-256 và ECDSA P-256, chứng chỉ ký v2, không có thời gian ký CMS; thời gian được khai báo là `/M`) ở mức B-B, hoặc B-T với dấu thời gian chữ ký RFC 3161 trong CMS khi tính năng đóng dấu thời gian được bật và một cơ quan cấp dấu thời gian phản hồi qua đường dẫn đối với các yêu cầu bên ngoài Telegram. Nó sử dụng một chứng chỉ ký tài liệu tự cấp được lưu trữ trong kho lưu trữ không gian làm việc; số sê-ri chủ thể của nó là dấu vân tay khóa Ed25519. Con dấu Ed25519 được truyền bên trong CMS dưới dạng thuộc tính chưa được ký `2.25.240684792623320047764573196045913242332` và chỉ định SHA-256 của chứng chỉ bằng `"content": "pdf-byte-range"`, do đó khóa Ed25519 đảm bảo tính xác thực cho chứng chỉ. Chứng chỉ này không được chứng nhận: trình đọc PDF hiển thị chữ ký là hợp lệ và người ký là không xác định hoặc không đáng tin cậy cho đến khi chứng chỉ được tin cậy; thay vào đó, hãy so sánh dấu vân tay Ed25519. Các tệp PDF tiếng Trung, tiếng Nhật và tiếng Hàn cần có phông chữ trên máy chủ (hoặc trong `TGWITNESS_FONT_DIR`); nếu không có phông chữ này, tệp ZIP chỉ chứa các báo cáo HTML và JSON mà thôi. - `report.en.html`, `report.en.pdf` / `chat.en.html`, `chat.en.pdf`: bản gốc tiếng Anh của cùng báo cáo khi ngôn ngữ báo cáo không phải tiếng Anh, được niêm phong và ký theo cùng cách và được nêu trong manifest đã ký dưới `report.original`. Báo cáo bằng ngôn ngữ đã chọn mở đầu bằng khuyến nghị nộp bản gốc tiếng Anh kèm bản dịch có chứng thực hoặc tuyên thệ; xem [Dịch báo cáo để nộp tòa án](https://phishdestroy.io/tgwitness/vi/docs/reference/translation/). Trong một kênh hoặc siêu nhóm, Telegram đánh số các tin nhắn 1, 2, 3… theo thứ tự. Một bản xuất cuộc trò chuyện liệt kê số đầu tiên và số cuối cùng, số lượng tin nhắn hiện có và mọi dãy số bị thiếu trong `message-ids.json` , bản kê khai và tiêu đề `chat.json` , đồng thời đánh dấu từng khoảng trống ở vị trí tương ứng trong bản ghi. `verify.py` liệt kê lại chúng từ `chat.json` . Một số bị thiếu là tin nhắn mà Telegram không trả về (đã bị xóa trước khi xuất, hoặc không hiển thị với tài khoản); trong các cuộc trò chuyện riêng tư và nhóm cơ bản, các số được chia sẻ chung cho tất cả các cuộc trò chuyện của tài khoản và các khoảng trống không được tính. Sau khi đọc lịch sử, quá trình xuất dữ liệu sẽ yêu cầu Telegram cung cấp lại mọi số điện thoại còn thiếu, theo thứ tự số (`channels.getMessages`, tối đa 10.000 số bao gồm 1.000 số nằm dưới tin nhắn đầu tiên, được phân bổ đều trên tất cả các khoảng trống khi có nhiều hơn số đó). Kết quả được ghi trong `message-ids.json` và trong báo cáo. Một câu trả lời trống ghi nhận rằng số đó không khả dụng đối với tài khoản này tại thời điểm kiểm tra lại; nguyên nhân không được nêu rõ. Một tin nhắn được trả về khi kiểm tra lại sẽ được thêm vào tệp xuất và được đánh dấu `found_on_recheck`. Khi không gian làm việc quan sát phát hiện các tin nhắn trong cuộc trò chuyện bị xóa, không còn khi kiểm tra lại hoặc bị chỉnh sửa, quá trình xuất dữ liệu cuộc trò chuyện sẽ bổ sung `journal-changes.jsonl`: các bản ghi nhật ký đó, mọi phiên bản đã lưu và thông báo, mỗi mục đều kèm theo giá trị băm và chữ ký Ed25519 mà nó nhận được trong nhật ký. `verify.py` tính lại giá trị băm của từng bản ghi, đối chiếu chữ ký của nó với khóa xuất và so sánh số lượng với bản kê khai đã được ký; tệp xuất bằng chứng chứa chuỗi băm hoàn chỉnh. Báo cáo liệt kê các tin nhắn này trong mục **“Các tin nhắn đã bị xóa” và “Các phiên bản trước đó**”. Mỗi báo cáo bắt đầu bằng **Tóm tắt**: một đoạn văn, sau đó là những gì tài liệu thể hiện và những gì bản ghi bao gồm. Con dấu của trang sẽ chuyển sang màu hổ phách khi trình duyệt đã kiểm tra chữ ký của con dấu, chứ không phải trang: trình duyệt không cung cấp các byte riêng cho trang. Nó chỉ chuyển sang màu xanh lục khi người đọc kéo tệp vào phần kiểm tra ở cuối trang và mọi byte đều khớp, và chỉ khi trang được hiển thị chính là tệp đó; nếu không, nó sẽ chuyển sang màu đỏ. Mỗi báo cáo nêu tên chương trình chính xác: cam kết Git khi trình thu thập dữ liệu chạy từ một bản checkout hoặc trình cài đặt đặt `TGWITNESS_COMMIT`, và SHA-256 của các tệp nguồn của nó (`source_tree_sha256`, JSON chuẩn của đường dẫn → SHA-256 của mọi tệp `.py`, `.js`, `.css`, `.html` và `.svg` trong gói), mà một bản checkout của cam kết đó sẽ tái tạo trừ khi các tệp đã bị thay đổi. Telegram được đặt tên theo thư viện, lớp API và trung tâm dữ liệu của nó. Khi quá trình quan sát bắt đầu và khi việc xuất dữ liệu trò chuyện bắt đầu và kết thúc, bộ thu thập sẽ yêu cầu Telegram cung cấp thời gian của nó (`updates.getState`, tính theo giây nguyên) và ghi lại thời gian của Telegram trừ đi thời gian trên đồng hồ của bộ thu thập, kèm theo độ không chắc chắn do thời gian truyền đi và về; các báo cáo hiển thị các phép đo này trong phần Chuỗi lưu giữ. Việc xuất dữ liệu trò chuyện cũng ghi lại thời điểm nó đọc lịch sử, ngoài các ngày tháng của các tin nhắn. ### Hướng dẫn sử dụng trình xem báo cáo ngoại tuyến và lưu trữ Giải nén toàn bộ tệp ZIP trước khi mở `chat.html` hoặc `report.html`. Trình xem cung cấp các tính năng tìm kiếm, bộ lọc, danh sách người tham gia, chỉ báo, chi tiết bản ghi và lựa chọn JSON/CSV mà không cần máy chủ. Giữ `viewer/` và `media/` bên cạnh báo cáo. Các lựa chọn là các bản sao: sử dụng `verify.py SELECTION.json --evidence ARCHIVE.zip` để so sánh chúng với kho lưu trữ đã ký. Trình xác minh kiểm tra ID báo cáo, khóa ký, ranh giới tệp lưu trữ và mọi mục đã chọn; các mục bị chỉnh sửa, thiếu hoặc trùng lặp sẽ bị từ chối. Ghi chú lựa chọn và thời gian tạo vẫn là siêu dữ liệu chưa được ký. Khoảng trống giữa các số tin nhắn chỉ được hiển thị đối với luồng trò chuyện đầy đủ, chưa qua lọc và theo thứ tự tăng dần. Việc ẩn một danh mục hoặc không tải được một khối dữ liệu không được coi là bằng chứng cho việc thiếu tin nhắn. Tính năng đánh dấu tìm kiếm hoạt động trên văn bản thuần túy trước khi thực hiện mã hóa HTML, đồng thời giữ nguyên các thẻ đánh dấu nguyên văn. Trình duyệt kiểm tra chữ ký của tệp manifest, ID báo cáo và khóa, cũng như tất cả các giá trị băm tệp được liệt kê. Nó từ chối các cấu trúc ZIP không rõ ràng hoặc bị lỗi, tên trùng lặp và đường dẫn không an toàn, đồng thời giới hạn kích thước tệp tối đa 256 MiB và tổng dung lượng nội dung được khai báo là 4 GiB. Sử dụng công cụ xác minh độc lập cho các tệp lưu trữ lớn hơn. Việc kiểm tra bằng trình duyệt này bổ sung cho các kiểm tra của trình xác minh về chuỗi nhật ký và ngữ nghĩa dữ liệu. `README.txt` chứa hướng dẫn bắt đầu, danh mục tệp được sắp xếp theo thứ tự, hướng dẫn xác minh và ghi chú về định dạng dữ liệu bằng ngôn ngữ của báo cáo, tiếp theo là hướng dẫn đầy đủ bằng tiếng Anh. `SHA256SUMS` bao gồm các tệp được liệt kê trong đó, không bao gồm chính tệp này, `manifest.json` và `manifest.sig`; bản kê khai có chữ ký cũng bao gồm `SHA256SUMS`. Giữ nguyên tệp ZIP gốc và lưu các tệp làm việc bên ngoài thư mục đã giải nén. Các báo cáo PDF bao gồm các dấu trang phần và mã nhận dạng vụ việc/báo cáo ở các trang sau. ### Cuộc trò chuyện tại thời điểm xuất Một bản xuất cuộc trò chuyện ghi lại những gì Telegram đã nêu về cuộc trò chuyện khi quá trình xuất bắt đầu: các nhãn riêng của Telegram (`scam`, `fake`, `restricted` kèm lý do, `verified`), tên người dùng, mô tả, số lượng thành viên và quản trị viên, cuộc thảo luận liên kết, bảo vệ nội dung, liệu thành viên mới có thể xem các tin nhắn trước đó hay không và từ tin nhắn nào trở đi tài khoản này có thể xem lịch sử (`available_min_id`), ngày của tin nhắn 1 khi đó là thời điểm tạo cuộc trò chuyện, và SHA-256 của ảnh đại diện cuộc trò chuyện (được lưu trong `media/`). Nó ghi lại vị trí của tài khoản xuất dữ liệu trong cuộc trò chuyện: vai trò, ngày tham gia, người đã mời tài khoản đó và, đối với quản trị viên, các quyền hạn của họ. Một yêu cầu bị Telegram từ chối sẽ được nêu tên thay thế. Khi tài khoản xuất dữ liệu là quản trị viên, quá trình xuất sẽ đọc nhật ký quản trị của cuộc trò chuyện (Telegram lưu giữ khoảng 48 giờ) vào tệp `admin-log.json`: các thao tác xóa và chỉnh sửa kèm nội dung được cung cấp, tài khoản thực hiện và ngày thực hiện hành động. Các mục này bổ sung cho các phiên bản đã được ghi lại của nhật ký trực tiếp và các bản ghi xác nhận việc xóa. ### Các chỉ số Danh sách báo cáo và kho lưu trữ được đánh số là `indicators.csv` , `indicators.stix.json` (STIX 2.1 ) và `indicators.misp.json` (sự kiện MISP ), những thông tin mà bộ phận xử lý vi phạm có thể can thiệp trong các tin nhắn đã ghi lại: liên kết và tên miền (kể cả những liên kết ẩn sau văn bản, trong các nút bấm và trong bản xem trước liên kết), địa chỉ tiền điện tử, tên người dùng và liên kết mời Telegram , số điện thoại, địa chỉ email và hình ảnh đã lưu. Các địa chỉ Bitcoin, Litecoin, Dogecoin và TRON chỉ được liệt kê khi tổng kiểm tra base58 của chúng hợp lệ, các địa chỉ SegWit khi tổng kiểm tra bech32 hoặc bech32m của chúng hợp lệ và các địa chỉ TON khi tổng kiểm tra CRC của chúng hợp lệ; các địa chỉ EVM và Solana được đánh dấu là chưa được kiểm tra. Hình ảnh chứa SHA-256 và một hàm băm nhận thức (dHash, 64 bit) mà các bản sao được nén lại hoặc thay đổi kích thước vẫn giữ gần như nguyên vẹn. Các báo cáo ghi các chỉ báo để chúng không bị mở ngẫu nhiên (`hxxps[://]example[.]com` ); các tệp vẫn giữ nguyên các giá trị như ban đầu. Mỗi chỉ báo được đánh dấu là “không xác định” và “không dành cho phát hiện tự động” (STIX , `indicator_types: unknown` , MISP , `to_ids: false` , phân phối cho tổ chức của chính mình): việc được liệt kê chỉ cho biết tin nhắn chứa chỉ báo đó, chứ không phải nó là độc hại. Một liên kết có văn bản hiển thị địa chỉ khác với địa chỉ thực tế khi mở sẽ được đánh dấu trong báo cáo. Các báo cáo PDF kết thúc bằng tuyên bố của người kiểm tra để ký tay, danh sách kiểm tra dành cho công chứng viên hoặc chuyên gia tòa án, và mã QR (cũng có trên trang đầu tiên) chứa ID báo cáo, dấu vân tay khóa và SHA-256 của dữ liệu chính thức, để bản in có thể truy xuất trở lại kho lưu trữ của nó. ## Tiêu chuẩn hóa sự kiện Dữ liệu đầu vào cho hàm băm bao gồm chính xác các trường sau: ``` seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash ``` Hãy chuyển đổi dữ liệu sang định dạng JSON tương thích với Python, sử dụng mã hóa UTF-8, các khóa đối tượng được sắp xếp theo thứ tự, không sử dụng ký tự thoát ASCII, không chứa khoảng trắng không cần thiết và không chứa các giá trị NaN/vô cực: ``` json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"), allow_nan=False).encode("utf-8") ``` Giá trị SHA-256 của các byte đó sẽ trở thành hàm băm sự kiện. Chữ ký được tạo bằng thuật toán Ed25519 trên 32 byte hàm băm thô, sau đó được mã hóa theo chuẩn base64. Giá trị previous_hash đầu tiên là 64 số 0. Số thứ tự bắt đầu từ 1 và tăng dần từng đơn vị 1. Tất cả các sự kiện, bao gồm cả các sự kiện vận hành, đều chia sẻ chung một chuỗi. Không có cơ chế loại bỏ các bản ghi trùng lặp: các quan sát lặp lại được coi là các biên nhận riêng biệt, chứ không phải là khẳng định về các hành động riêng biệt trên Telegram. Dữ liệu Telegram thô là các chuỗi ISO; các trường nhị phân trở thành các đối tượng chứa bytes_base64. Nội dung tin nhắn, các thực thể, mô tả phương tiện, siêu dữ liệu phản hồi, phản ứng, và các hành động dịch vụ được giữ lại trong siêu dữ liệu tin nhắn thô khi được cung cấp. Một tin nhắn trực tiếp cũng lưu giữ bản cập nhật Telegram đã gửi tin nhắn đó trong `transport_update`; khi bản cập nhật đó chứa cùng một tin nhắn như `raw`, trường `message` trường đó là `{"same_as": "raw"}` thay vì một bản sao thứ hai. `observed_at` là thời gian UTC tại thời điểm người thu thập ghi lại bản ghi; `source_at` là ngày được cung cấp bởi sự kiện Telegram đó. Các bản ghi được ghi trong quá trình xử lý cập nhật trực tiếp sẽ thêm `payload.received_at`thêm thời gian UTC khi bản cập nhật đến bộ thu thập, và `payload.processing_delay_ms`. Các chỉnh sửa trực tiếp giữ nguyên ngày chỉnh sửa được cung cấp, các bản chụp lịch sử giữ nguyên ngày tin nhắn kèm theo thời gian quan sát hiện tại, và một thông báo xóa thông thường ghi lại thời gian nhận với ngày nguồn là null. Các mục nhật ký quản trị giữ riêng ngày hành động được cung cấp. Thứ tự nhận và thứ tự sự kiện nguồn là hai dòng thời gian riêng biệt, với các quan sát thời gian và biên nhận bên ngoài có sẵn để so sánh. ## Ngữ nghĩa về các chủ thể Nguồn gốc sự kiện được ghi nhận theo nguồn phát sinh. `message.new.actor_id` và `message.edited.payload.sender_id` giữ lại thông tin người gửi tin nhắn. Các thông báo thông thường `message.deleted` chứa ID tin nhắn và có trường actor là null; các mục nhật ký quản trị có sẵn chứa hành động, actor và ngày tháng được cung cấp. Các tin nhắn của dịch vụ thành viên giữ lại thông tin người gửi và loại hành động; các bản cập nhật thô của người tham gia giữ lại `actor_id` được cung cấp; và các bản chụp phản ứng giữ lại số lượng và danh tính hiển thị được cung cấp. Hãy đọc các bản ghi này cùng với các phiên bản được ghi lại và [biên lai tương tác trên bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#own-actions). Thông báo xóa cho các cuộc trò chuyện riêng tư và nhóm thông thường chỉ chứa ID tin nhắn. Các cuộc trò chuyện này chia sẻ một dãy ID chung cho toàn tài khoản, do đó một ID xác định một tin nhắn duy nhất của tài khoản này. Khi một tin nhắn có ID đó đã được lưu trước đó trong nhật ký này, việc xóa sẽ được ghi lại trong cuộc trò chuyện đó dưới dạng `message.deleted` với `payload.chat_resolution` để chỉ định phương thức. Các ID chưa từng được lưu sẽ được giữ lại dưới dạng `deletion.unscoped`: một thông báo xóa thực tế mà cuộc trò chuyện liên quan chưa được xác định. Điều này khác biệt so với `message.missing_on_recheck`, vốn ghi lại kết quả truy vấn không khả dụng, và so với khoảng trống trong các ID tin nhắn đã lưu. Các kênh và siêu nhóm đánh số tin nhắn theo từng cuộc trò chuyện và không bao giờ được khớp theo cách này. Khi tin nhắn bị xóa được gửi bởi tài khoản được quan sát, payload.deleted_message_was_outgoing có giá trị true; người xóa vẫn chưa được xác định. Một thông báo không có phạm vi sẽ giữ nhãn riêng của nó vì cuộc trò chuyện khớp có thể nằm ngoài phạm vi quan sát hiện tại hoặc không có kết quả khớp duy nhất. Việc kiểm tra lại sự vắng mặt vẫn là một quan sát riêng biệt so với thông báo xóa trong số liệu báo cáo, bộ lọc và nhãn. Việc khôi phục sau đó sẽ xóa trạng thái thiếu hiện tại trong khi vẫn giữ lại lần kiểm tra không thành công trước đó trong lịch sử đã ký; các thông báo xóa vẫn là một loại sự kiện riêng biệt. Các ID khác nhau được xác định thuộc cùng một cuộc trò chuyện từ một thông báo sẽ được nhóm lại dưới dạng `deletion.batch`, bất kể số lượng là bao nhiêu, với các ID tin nhắn chính xác như Telegram đã gửi và số lượng tin nhắn mà tài khoản này đã gửi. Thông báo của Telegram liệt kê các tin nhắn; nhật ký quản trị của cuộc trò chuyện ghi rõ tên người quản trị đang thực hiện hành động, nơi tài khoản có thể xem thông tin này. Liên kết (`message.deletion_attributed`) được tạo dựa trên thời điểm nào đến trước: một cuộc thăm dò đã ghi nhận mục nhật ký quản trị trước thông báo xóa sẽ được khớp khi thông báo được ghi lại. ## Phạm vi bao quát: tính liên tục, các khoảng trống và các ID không được ghi nhận Mỗi tệp ZIP được ký số đều chứa tệp `coverage.json`; báo cáo HTML mở đầu bằng cùng một bản tóm tắt; và tệp `verify.py` sẽ tính toán lại bản tóm tắt này dựa trên tệp `events.jsonl` thay vì tin tưởng vào nội dung của tệp: - **Quan sát liên tục từ X đến Y.** Một khoảng thời gian bắt đầu bằng `observation.started` và kết thúc khi có tạm dừng, dừng hẳn, mất kết nối Telegram, đăng xuất, quá trình khởi động mà không có dừng đúng quy trình, hoặc hơn ba phút không có bản ghi nào trong quá trình quan sát (các tín hiệu kiểm tra được ghi mỗi phút, do đó sự im lặng có nghĩa là quá trình đã dừng, bị treo hoặc máy tính đang ở chế độ ngủ). Khi khoảng thời gian giữa các tín hiệu kiểm tra được thay đổi trong **More tools → Parameters**, mỗi tín hiệu kiểm tra sẽ ghi lại điều này và khoảng thời gian im lặng cho phép sẽ là ba khoảng thời gian, không bao giờ ít hơn ba phút. - **Danh sách các khoảng trống** liệt kê khoảng thời gian giữa các giai đoạn kèm theo lý do. Một khoảng trống vẫn còn tồn tại tại bản ghi cuối cùng sẽ được đánh dấu là `not_resumed_by_last_record`. - **ID tin nhắn không được ghi nhận.** Đối với các kênh và siêu nhóm, nơi số tin nhắn được tính theo cuộc trò chuyện, các ID bị thiếu giữa các ID đã ghi nhận sẽ được liệt kê dưới dạng khoảng. Chúng được báo cáo là không*được ghi nhận* — đã bị xóa, chưa bao giờ được gửi hoặc nằm ngoài lịch sử đã lưu — chứ không bao giờ được ghi là đã bị xóa. Các cuộc trò chuyện riêng tư và nhóm thông thường chia sẻ một chuỗi ID chung cho toàn tài khoản, do đó các khoảng trống bên trong một cuộc trò chuyện như vậy không có ý nghĩa gì và không được liệt kê ở đó. - Các thông báo về khoảng trống ở cấp độ cuộc trò chuyện (ví dụ: Telegram yêu cầu khôi phục dữ liệu bị thiếu trong một kênh) được tính là các ghi chú; chúng không làm gián đoạn phạm vi ghi lại toàn bộ. - **Bản ghi phiên.** Các trường hợp mà bộ đếm cập nhật của Telegram tăng lên trong khi không có bản cập nhật nào đến phiên này (`updates_diverted`), phiên này bị loại khỏi danh sách phiên của Telegram trong khi kết nối của nó vẫn hoạt động (`session_revoked_externally`), hoặc câu trả lời của yêu cầu kiểm tra chứng kiến chỉ đến từ lịch sử (`probe_ack_missed_live`) được liệt kê riêng biệt. Trình xác minh cũng báo cáo nguồn gốc của khóa phiên Telegram, các phiên khác đã đăng nhập khi quá trình quan sát bắt đầu, các phiên được thêm vào trong quá trình quan sát, thông báo bảo mật của Telegram (777000), các phiên khác đã kết thúc từ không gian làm việc, các khoảng thời gian chỉ có phiên, số lượng yêu cầu kiểm tra chứng nhân và các cập nhật cuộc gọi điện thoại. Xem [tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/#witness-probe). Khi chế độ [chọn lọc cuộc trò chuyện nghiêm ngặt](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#strict-chosen-chats) được bật (`scope.strict` trong `observation.started`), danh sách phiên (trừ khi đây là phiên duy nhất hoặc khi tính năng **Thiết bị Telegram** đang bật), thông báo bảo mật và cập nhật cuộc gọi điện thoại sẽ không được thu thập; do đó, sự vắng mặt của chúng không có ý nghĩa gì, và việc xóa chỉ được khớp với phiên chỉ khi có phiên đó diễn ra trong vòng 10 phút trước đó. ### Trình tự cập nhật (`pts`) Telegram cập nhật thông tin liên quan đến tin nhắn với `pts`: một chuỗi cho tài khoản (bao gồm cả các cuộc trò chuyện riêng tư và các nhóm cơ bản) và một chuỗi cho mỗi kênh hoặc siêu nhóm. Bộ thu thập ghi lại mỗi đoạn tin nhắn nhận được mà không có khoảng trống nào dưới dạng một `coverage.sequence` bản ghi: số đầu tiên và số cuối cùng `pts`, số lượng cập nhật của từng loại, và liệu chúng được đẩy trực tiếp hay trả về bởi `getDifference` hoặc `getChannelDifference`. Một khoảng trống được ghi nhận là một `coverage.gap` bản ghi, và `coverage.gap_closed` đặt tên cho `pts` từ đó chuỗi lại trở nên hoàn chỉnh. Một chuỗi liên tục cho thấy rằng mọi bản cập nhật Telegram được đánh số trong chuỗi đó, từ bản đầu tiên đến bản cuối cùng `pts` đều đã đến được ứng dụng Telegram của người thu thập này. Điều này không đề cập gì đến nội dung mà Telegram chưa bao giờ gửi đến tài khoản này, về khoảng thời gian trước bản ghi đầu tiên `pts`, hay về các đoạn liên tục mà người thu thập dữ liệu không ghi lại. Một `pts` khoảng trống mà không có khoảng liên tục hoặc sự chênh lệch nào ghi lại được sẽ được hiển thị dưới dạng một khoảng ngắt quãng. `GET /api/continuity` các đáp án cho một khoảng thời gian (`since`, `until`, `chat_id`) xem liệu mỗi dãy có liên tục hay không và liệt kê các điểm đứt gãy cùng với lý do của chúng. `verify.py` in ra kết quả tương tự từ các bản ghi của một kho lưu trữ trong phần **“Tính liên tục của dãy**”. ### Số tin nhắn bị thiếu (`gap_summary`) For a reader's guide to this section and to observation periods and gaps, see [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). **Xem trước.** `coverage.json` → `gap_summary` đo lường các số mà Telegram đã gán và công cụ thu thập này chưa từng ghi nhận. Telegram đánh số tin nhắn một lần cho mỗi kênh hoặc siêu nhóm, và một lần cho mỗi tài khoản trên các cuộc trò chuyện riêng tư, bot và nhóm thông thường. Một số nằm giữa hai tin nhắn được quan sát có thể đã được quan sát hoặc bị thiếu; một khoảng liên tục là một khẳng định chắc chắn rằng mọi tin nhắn được đánh số trong khoảng đó đều đã được quan sát. Một khoảng trống không chỉ ra bất kỳ đối tượng nào cũng như không nêu lý do. | Lĩnh vực | Ý nghĩa | | --- | --- | | `status` | `on` hoặc `off` khi tắt trong **Công cụ khác → Tham số → Phân tích khoảng trống** | | `parameters` | Các tham số đã tạo ra kết quả, để có thể lặp lại quá trình này | | `chats[]` | Mỗi kênh hoặc siêu nhóm tương ứng với một mục, mỗi mục được đánh số riêng biệt | | `account` | Danh sách các cuộc trò chuyện riêng tư, bot và nhóm thông thường trên toàn tài khoản | | `status` (theo từng chuỗi) | `applicable`, hoặc `not_applicable` với `reason` | | `observed_from`, `observed_to`, `span` | Số đầu tiên và số cuối cùng được quan sát cùng với kích thước của phạm vi | | `observed`, `observed_without_content` | Các số liệu quan sát được; những số liệu chỉ được biết thông qua bản ghi xóa hoặc kiểm tra lại | | `missing`, `density`, `gap_ranges`, `largest_gap` | Số lần chưa từng được quan sát, tỷ lệ phần trăm của chúng trong phạm vi, số lần chạy, lần chạy dài nhất | | `clusters[]` | Các lỗ hổng được liệt kê: `low`, `high`, `missing`, cùng với các số quan sát liền kề `after` / `before` cùng với thời gian quan sát của chúng | | `service_estimate` | Chỉ khi được kích hoạt: số lượng số điện thoại thiếu sẽ là tin nhắn dịch vụ theo tỷ lệ quan sát được. Không bao giờ trừ đi từ `missing` | Tính hợp lệ được xác định dựa trên nhật ký, không bao giờ được giả định: - **Các kênh và siêu nhóm** được đo lường theo từng cuộc trò chuyện, bao gồm cả khi xuất dữ liệu từ các cuộc trò chuyện đã chọn. Các bản ghi được người gửi chọn sẽ được sử dụng để thực hiện phép đo `not_applicable`. - **Dãy tin nhắn trên toàn tài khoản** chỉ được tính từ tin nhắn đầu tiên đến tin nhắn cuối cùng được nhận trong thời gian chế độ thu thập toàn bộ tài khoản đang hoạt động và bao gồm các cuộc trò chuyện riêng tư, bot, nhóm thông thường và các tin nhắn của chính tài khoản đó, không loại trừ bất kỳ cuộc trò chuyện nào (`scope.changed`). Các số được chỉ định bởi `deletion.unscoped` được tính là đã quan sát được mà không bao gồm nội dung. Việc xuất hoặc chuyển giao các cuộc trò chuyện được chọn không thể đo lường được điều này. Nếu chế độ thu thập toàn bộ tài khoản đã được tắt và bật lại, một ghi chú sẽ cho biết rằng các số được sử dụng trong khoảng thời gian đó sẽ xuất hiện dưới dạng khoảng trống. - Các tin nhắn dịch vụ là các bản ghi nhật ký có số thứ tự riêng, do đó chúng tự động lấp đầy các khoảng trống của chính mình; ước tính tùy chọn chỉ mang tính chất bối cảnh. `verify.py` tính toán lại `gap_summary` từ `events.jsonl` với các tham số trong `coverage.json` (giá trị mặc định cho các kho lưu trữ cũ hơn) và in dòng toàn tài khoản trong bản tóm tắt phạm vi phủ sóng của nó. `get_capture_status`(MCP và dòng lệnh) trả về cùng một kết quả đo lường cho các cuộc trò chuyện mà một quyền truy cập có thể đọc; dãy dữ liệu toàn tài khoản chỉ áp dụng cho quyền truy cập bao phủ toàn bộ không gian làm việc. Các quan sát lặp lại của một tin nhắn dịch vụ chỉ được tính một lần, và ước tính dịch vụ tài khoản chỉ sử dụng các số nằm trong phạm vi đo lường. Phạm vi áp dụng phải bảo toàn rõ ràng các tin nhắn riêng của tài khoản trước khi kích hoạt đo lường trên toàn tài khoản; quá trình đo lường bắt đầu từ các bản ghi chứa thông tin đó. Phạm vi đo lường bao gồm quá trình quan sát đang diễn ra và việc tiếp tục quan sát sẽ được ghi nhận. Truy vấn kho lưu trữ trực tiếp có ngân sách thời gian, bao gồm quá trình quét cơ sở dữ liệu, và đánh dấu phép đo chưa hoàn thành là một phần. Telegram ghi lại các [chuỗi ID tin nhắn riêng biệt](https://core.telegram.org/api/updates#message-id-sequences). Các số này mô tả các quan sát; thông báo xóa, kiểm tra lại và bản ghi nhật ký quản trị giải thích lý do tại sao một số lại thiếu ở nơi Telegram báo cáo nó. Khi Telegram ngừng chấp nhận tài khoản, bản ghi `coverage.gap` kết thúc quá trình giám sát sẽ chứa `cause` (`account_banned`, `account_frozen`, `account_deleted`, `session_duplicated`, `session_revoked`, `session_expired`, `session_ended` hoặc `not_authorized`) và lỗi Telegram; `verify.py` chỉ ra nguyên nhân khiến giai đoạn này kết thúc. Phạm vi bao phủ kết hợp các khoảng thời gian quan sát được ghi lại, các sự gián đoạn và kết quả tin nhắn. Đánh giá kết quả này cùng với các cuộc trò chuyện đã chọn, khoảng thời gian và chính sách đính kèm; kiểm tra lại kết quả và các khoảng trống được ghi lại sẽ cho thấy mức độ đầy đủ của việc quan sát các cập nhật trên tài khoản. ## Người sản xuất Bản kê khai đã ký của các tệp ZIP bằng chứng, bản xuất cuộc trò chuyện, nhật ký của người chứng kiến và tuyên bố trong các tệp hồ sơ người dùng chứa `producer`: phần mềm, phiên bản, dự án (PhishDestroy), trang chủ và kho lưu trữ nguồn. Báo cáo HTML và trình xác minh hiển thị bản ghi producer đã ký này. Các giá trị băm của tệp nguồn xác định cây nguồn được ghi lại để so sánh với bản sao lưu đáng tin cậy. Nguồn gốc thực thi được kiểm tra riêng biệt thông qua [chứng nhận thu thập từ GitHub](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) hoặc [các phép đo Intel TDX](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/), nếu được kích hoạt. Các tệp lưu trữ được tạo trước khi trường nhà sản xuất tồn tại vẫn được hỗ trợ và được xác định là các bản ghi cũ. Mỗi bản ghi `observation.started` cũng nêu tên máy khách Telegram đã thực hiện việc giám sát: mã `api_id` (không bao giờ là giá trị băm), cho dù đó là cặp công khai tích hợp sẵn hay ứng dụng riêng của nhà điều hành, mô tả máy khách được gửi trong yêu cầu kết nối của Telegram, và loại đường dẫn kết nối cùng chế độ IP (không có địa chỉ proxy hoặc khóa bí mật). Báo cáo và `custody.json` liệt kê mọi máy khách và tuyến đường riêng biệt cùng thời điểm chúng được ghi lại, cũng như các thời điểm không có proxy nào trong danh sách trả lời và Telegram đã phát hiện địa chỉ máy chủ. Các nhật ký được ghi lại trước đó đã nêu rõ điều này. ## Hồ sơ cá nhân Một tệp hồ sơ (`tgwitness-dossier-v1`, JSON) được tạo theo yêu cầu từ các bản ghi đã có sẵn trong sổ nhật ký cho một cuộc trò chuyện; không có dữ liệu nào được lấy từ Telegram và nội dung hồ sơ không bao giờ được ghi vào sổ nhật ký (việc bật và tắt hồ sơ được ghi lại dưới dạng `dossier.changed`). Đối với mỗi người dùng có tin nhắn được lưu, công cụ sẽ liệt kê tên và lịch sử tên người dùng, các cờ cảnh báo của Telegram (bot, lừa đảo, giả mạo, tài khoản cao cấp, đã xác minh, bị hạn chế, đã xóa) như được hiển thị tại thời điểm lưu trữ, thẻ nhận dạng ảnh, mã băm SHA-256 và mã băm nhận thức (pHash, tương thích với `imagehash.phash`) của hình đại diện từ bộ nhớ đệm hình đại diện cục bộ cùng các hình đại diện tương tự, hoạt động (tin nhắn đầu tiên và cuối cùng, số lượng, các bài chia sẻ đã chỉnh sửa và xóa, tin nhắn theo giờ UTC), ai trả lời ai, các cuộc trò chuyện khác trong nhật ký này mà người đó đã viết, cùng các ví được đề cập (BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; các địa chỉ Base58Check đã được xác thực tổng kiểm tra), số điện thoại, tên người dùng và các liên kết, bao gồm cả các liên kết ẩn sau văn bản. Mỗi sự kiện đều liệt kê các bản ghi trong sổ nhật ký (`seq`) mà nó xuất phát, và `record_hashes` chứa giá trị băm của từng bản ghi được tham chiếu. Tuyên bố này được ký bằng khóa không gian làm việc: ``` python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip ``` kiểm tra chữ ký, xác minh chính bản xuất bằng chứng (chữ ký, chuỗi băm và các tệp) cũng như đảm bảo mọi bản ghi được tham chiếu đều tồn tại nguyên vẹn trong bản xuất đó của cùng một không gian làm việc. Các giá trị băm của ảnh đại diện được ghi chú là lấy từ bộ nhớ đệm cục bộ (không phải bản ghi trong sổ nhật ký). Các đề cập là kết quả khớp mẫu và là manh mối cần kiểm tra. Các hồ sơ được kích hoạt theo từng cuộc trò chuyện, có thể được xuất dưới dạng tệp ZIP mã hóa AES-256 kèm mật khẩu, và sẽ bị xóa khi bị tắt hoặc khi cuộc trò chuyện bị xóa khỏi các nguồn. ## Nhân chứng độc lập Nhật ký nhân chứng (`tgwitness-witness-v1`) và các bài đăng trên kênh của nó được kiểm tra so với bản xuất bằng chứng bằng lệnh `verify.py --witness … --channel …`; xem [nhân chứng độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/). Với địa chỉ công khai `https://t.me/s/…` hoặc `https://telegram.me/s/…`, trình xác minh sẽ đọc ngày của từng bài đăng từ Telegram, và ngày sớm nhất của một bài đăng tại đầu bản xuất sẽ là thời gian bên ngoài cho bản ghi cuối cùng. Các ngày từ bất kỳ nguồn nào khác đều là siêu dữ liệu được cung cấp. ## Bản kê khai và các điểm kiểm tra manifest.json bao gồm định dạng, thời gian xuất, khóa công khai, dấu vân tay, độ dài nhật ký, băm đầu, phạm vi, nhà sản xuất, hạn chế và SHA-256 của mọi thành viên nội dung khác ngoài chính `manifest.json` và `manifest.sig`. manifest.sig là chữ ký base64 Ed25519 trên JSON manifest chuẩn. Trình xác minh sẽ từ chối các thành phần bất thường/thiếu, tên trùng lặp, tệp bị hỏng, chuỗi/dãy bị gián đoạn, chữ ký không hợp lệ và sự không khớp với điểm kiểm tra được cung cấp. Nó không bao giờ trích xuất đường dẫn lưu trữ. Nó giới hạn tổng kích thước không nén được khai báo ở mức 4 GiB; `--max-gib N` cho phép tạo các tệp lưu trữ lớn hơn bằng cách tăng giới hạn trong phần**Công cụ khác → Thông số**. Một kho lưu trữ lớn được kiểm tra bởi nhiều tiến trình cùng lúc: các thành viên được tính băm song song, và sau 5.000 bản ghi đầu tiên, băm nội dung và chữ ký của từng bản ghi sẽ được kiểm tra bởi các tiến trình con trong khi tiến trình chính lần lượt theo dõi chuỗi, phạm vi bao phủ và các liên kết theo thứ tự. `--jobs N` thiết lập số lượng tiến trình; mặc định `auto` sử dụng một tiến trình cho mỗi CPU, tối đa 16, và `--jobs 1` giữ mọi thứ trong một tiến trình. Kết quả là như nhau trong cả hai trường hợp, và việc thay đổi sẽ bị từ chối với cùng một thông báo. Các giá trị băm tại các vị trí được chỉ định bởi các điểm kiểm tra được lưu giữ và các mốc thời gian được giữ lại trong lần quét duy nhất đó, do đó mỗi mốc được so sánh mà không cần đọc lại nhật ký. Trên một máy tính 32 luồng, một tệp lưu trữ 10,8 GB với 400.000 bản ghi mất 58,9 giây trong một tiến trình, 15,2 giây với 4 tiến trình và 8,4 giây với 16 tiến trình; một lần quét qua các bản ghi theo thứ tự sau đó sẽ xác định giới hạn. Chạy quá trình xác minh từ phiên bản TgWitness đã cài đặt của bạn hoặc từ một bản checkout đã được kiểm duyệt. Bản sao được bao gồm trong tệp lưu trữ hỗ trợ sử dụng di động; hãy so sánh bản sao đó với bản cài đặt đáng tin cậy của bạn trước khi thực thi nó. Một điểm kiểm tra ký một tuyên bố chứa khóa công khai, độ dài nhật ký, băm đầu (head hash) và thời gian tạo. Nó cũng chứa vòng drand mới nhất mà không gian làm việc đã lấy về (`drand_anchor` ): bộ thu thập yêu cầu một trạm trung chuyển drand qua tuyến ngoài của không gian làm việc trước mỗi điểm kiểm tra định kỳ, do đó các dịch vụ ẩn IP, proxy và tuyến ngoài bị tắt đều được áp dụng, và việc tạo điểm kiểm tra bản thân không bao giờ kết nối ra ngoài. Người xác minh có thể kiểm tra xem một bản lưu trữ sau này có chứa cùng tiền tố hay không. Với `--checkpoint` và `--check-drand` , nó xác nhận vòng đó với các trạm trung chuyển drand và báo cáo rằng điểm kiểm tra đã được ký không sớm hơn thời gian của vòng đó; vòng này không thay đổi cấp độ đảm bảo. Lưu giữ điểm kiểm tra bên ngoài bộ thu thập, để quá trình xác minh sau này so sánh bản lưu trữ với một bản tham chiếu được lưu giữ riêng biệt. Khóa của bộ thu thập ký vào bản lưu trữ này, do đó nó chỉ liên kết các bản ghi với bộ thu thập nếu người nhận đã có được bản lưu trữ trước khi nhận được bản lưu trữ, thông qua một kênh khác; bản thân nó không đáp ứng tiêu chuẩn tối thiểu về bằng chứng. ## Đọc kết quả xác minh Trình xác minh báo cáo về tính toàn vẹn của kho lưu trữ, việc xác định người ký và các kiểm tra đảm bảo một cách riêng biệt. Một chữ ký hợp lệ cho thấy các byte chưa bị thay đổi kể từ khi chúng được ký. Người vận hành cung cấp dấu vân tay khóa cho người nhận qua một kênh riêng biệt. Nếu không có `--fingerprint`, một tệp lưu trữ nguyên vẹn sẽ vượt qua các kiểm tra chữ ký và định dạng với `signer_pinned: false`, và dòng cuối cùng bắt đầu bằng `EVIDENCE: minimum not met · missing: confirmed signer key`. Đối với chính sách lưu trữ cục bộ tự động yêu cầu người ký được ghim và mức tối thiểu cho bằng chứng: ``` python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence ``` Sử dụng dấu vân tay được lưu giữ qua kênh đáng tin cậy của người nhận. Một nhân chứng đáng tin cậy cũng có thể ghim bộ thu thập thông qua một nhật ký được chứng kiến nhất quán; cung cấp các tham số `--witness`, `--witness-fingerprint` và `--require-witness`. `--strict` sẽ thoát với trạng thái 2 nếu người ký không được ghim; việc không đáp ứng `--require-tier` hoặc `--require evidence` cũng sẽ thoát với trạng thái 2. `--require evidence` yêu cầu `--fingerprint` và thời gian từ bên thứ ba bao phủ bản ghi cuối cùng. Hãy đọc `signer_pinned`, `requirements_met` và kết quả đảm bảo, chứ không chỉ mã thoát. Thay vào đó, [quá trình thu thập được niêm phong](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) sử dụng trình xác minh chứng thực và chính sách đã được phê duyệt để xác thực bản tóm tắt thu thập. ## Phạm vi xác minh Quá trình xác minh kiểm tra tệp lưu trữ và chế độ thu thập được sử dụng để tạo ra nó. Chọn chế độ có ranh giới tin cậy phù hợp với trường hợp cụ thể, sau đó giữ nguyên các đầu vào xác minh của chế độ đó. | Chế độ thu thập | Những gì trình xác minh kiểm tra | Dữ liệu đầu vào xác minh và ranh giới tin cậy | | --- | --- | --- | | Không gian làm việc cục bộ | Chữ ký bản ghi, chuỗi băm, tệp manifest và các byte tệp đính kèm | Dấu vân tay của bộ thu thập được người nhận lưu giữ cùng với thời gian bên ngoài từ bên thứ ba: biên nhận đã được xác minh theo RFC 3161 hoặc OpenTimestamps, hoặc các bài đăng của nhân chứng được đọc từ t.me. Các điểm kiểm tra và bản ghi của nhân chứng được lưu giữ là các kiểm tra hỗ trợ | | Không gian làm việc cục bộ với một nhân chứng độc lập | Việc kiểm tra kho lưu trữ cùng với sự nhất quán với tiền tố nhật ký trước đó được người làm chứng lưu giữ | Dấu vân tay và bản ghi của nhân chứng; hồ sơ kiểm soát khóa của bên lưu giữ cho biết ai nắm giữ khóa nhân chứng. Với `--channel https://t.me/s/…`, ngày Telegram gắn cho các bài đăng cung cấp thời gian bên ngoài | | [GitHub Actions ghi lại](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | Chứng nhận trên GitHub về băm tệp lưu trữ, quy trình làm việc được phê duyệt và các bản cam kết của trình thu thập, trình chạy được lưu trữ, nguồn phiên/khóa mới và tính toàn vẹn nội bộ của tệp lưu trữ | Chính sách xác minh đáng tin cậy, kho lưu trữ người gọi và gói chứng thực GitHub; quá trình thu thập dữ liệu được thực hiện theo quy trình làm việc được ghim | | [Triển khai trên đám mây](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/) | Hồ sơ vòng đời và quyền truy cập của nhà cung cấp, trạng thái tường lửa và Cloudflare, cùng với bản ghi hoạt động đã ký của bộ thu thập | Các truy vấn chỉ đọc đến nhà cung cấp và Cloudflare; tính khả dụng của từng kiểm tra phụ thuộc vào nhà cung cấp | | [Máy ảo (VM) bảo mật Intel TDX](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | Trích dẫn chữ ký và trạng thái nền tảng, liên kết với tuyên bố của bộ thu thập, các phép đo thành phần và hệ điều hành | Chuỗi tin cậy của Intel và các chỉ số triển khai dự kiến; giữ nguyên kết quả của mọi kiểm tra TDX bắt buộc | Trong quá trình thu thập được niêm phong, người thu thập được phê duyệt sẽ nhận dữ liệu thông qua một kết nối Telegram đã được xác thực bên trong môi trường đã được xác minh. Chứng thực liên kết kho lưu trữ với lần thực thi đó, do đó quá trình xác minh bao gồm cả quá trình thu thập cũng như tính toàn vẹn của tệp sau này. Điều này dựa trên mã nguồn được phê duyệt và chuỗi tin cậy của nền tảng được liệt kê ở trên. Việc xác minh thu thập trên GitHub yêu cầu một phiên được tạo bên trong quá trình chạy và từ chối các bản thu thập từ phiên được nhập vào. Biên bản chạy ghi lại phiên bản trình thu thập, băm tệp và cài đặt khởi động. Nguồn gốc trên GitHub và các phép đo TDX cung cấp các kiểm tra môi trường; bản ghi xác thực xác định các cấu hình đã được kiểm thử. ### Nguồn gốc của các tin nhắn Telegram gửi tin nhắn đến mọi ứng dụng khách, bao gồm cả các ứng dụng chính thức, trong một phiên MTProto. Khóa ủy quyền của phiên được thương lượng dựa trên khóa máy chủ cố định của Telegram, và mọi bản cập nhật đều được mã hóa và kiểm tra tính toàn vẹn dưới khóa đó. Bộ thu nhận tin nhắn thông qua phiên đã được xác thực của tài khoản và ký xác nhận từng sự kiện vào nhật ký ngay khi nó đến, kèm theo các thông tin nhận dạng cuộc trò chuyện, tin nhắn và người gửi, cùng với ngày tháng mà Telegram đã đặt cho từng tin nhắn. Trên GitHub Actions và triển khai Intel TDX, quá trình chứng thực cũng liên kết phiên làm việc đó và khóa ký với quá trình thực thi của bộ thu được phê duyệt. Nhật ký ghi lại nguồn gốc của khóa ủy quyền. Đăng nhập qua điện thoại hoặc mã QR, hoặc đăng nhập độc lập từ tệp phiên, sẽ ghi `account.authorized` với `key_origin: "created"`; việc thu thập dựa trên khóa `.session`, TData hoặc JSON đã nhập sẽ ghi `imported`. Khóa đã nhập cũng tồn tại ở bất kỳ nguồn nào nó đến từ. Các triển khai được xác thực sẽ từ chối các khóa đã nhập. Nguồn gốc của một bản ghi trên Telegram dựa trên kết nối đã được xác thực của tài khoản, các bản ghi kết nối và ghi lại trong nhật ký, các khung MTProto được ghi lại khớp với các mục trong nhật ký ([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/tgwitness/forensics)), ngày trên Telegram của từng tin nhắn và, đối với việc ghi lại được chứng thực, môi trường thực thi đã được xác minh. Các chữ ký lưu trữ giữ lại bản ghi đó để kiểm tra sau này. Các điểm kiểm tra được lưu giữ xác định ranh giới trước đó của nhật ký, các bản ghi phạm vi bao phủ thể hiện kết quả thu thập, và các dấu thời gian bên ngoài đã được xác minh xác định thời điểm các byte được ghi vào hệ thống. Đối với không gian làm việc cục bộ, người nhận cung cấp các đầu vào đáng tin cậy từ bộ thu thập hoặc nhân chứng. Đối với việc thu thập được niêm phong, chính sách đáng tin cậy và chứng thực liên kết bản tóm tắt lưu trữ với quá trình thực thi của bộ thu thập đã được phê duyệt. Đây là các đường dẫn xác minh khác nhau; báo cáo các kiểm tra đã hoàn thành cho đường dẫn đã chọn. ## Tệp đính kèm Các tệp được định danh bằng mã băm SHA-256 trong thư mục media/. Một sự kiện media.saved liên kết mã băm và độ dài byte với một sự kiện tin nhắn cụ thể. Tên tệp gốc là siêu dữ liệu, không bao giờ là đường dẫn cục bộ. Các byte phương tiện được tải xuống theo cơ chế không đồng bộ, do đó việc xóa ngay lập tức có thể ngăn cản quá trình ghi lại. Các trường hợp như việc thu thập bị vô hiệu hóa, tệp quá lớn/không xác định kích thước, lỗi tải xuống, và quá trình tải xuống bị gián đoạn đều được hiển thị dưới dạng kết quả. Sự cố sập hệ thống có thể để lại các tệp không hoàn chỉnh không có tham chiếu; những tệp này sẽ không được bao gồm trong các bản xuất. Trình xuất ZIP sẽ xác minh các tệp phương tiện được lưu trữ dựa trên tên của chúng. Các định dạng xuất JSONL, CSV và HTML sẽ xác minh chữ ký sự kiện nhưng không chứa dữ liệu phương tiện. Các báo cáo phái sinh chỉ mang tính tiện lợi; tệp events.jsonl mới là bản ghi sự kiện chính thức. Việc xuất toàn bộ cuộc trò chuyện sẽ lưu các tệp đính kèm theo cài đặt tệp đính kèm của không gian làm việc vào thư mục media/, được đặt tên theo định dạng SHA-256. Mỗi bản ghi tin nhắn trong chat.json sẽ ghi tên tệp của nó (`file`, `file_sha256`) hoặc lý do tại sao nó vắng mặt (`file_status`), cùng với những gì người đọc đã thấy xung quanh văn bản: các liên kết phía sau văn bản, nguồn gốc chuyển tiếp, các nút bot, chữ ký, lượt xem và bộ đếm thời gian tự động xóa. `verify.py` kiểm tra xem mọi tệp được đặt tên có nằm trong bản kê khai đã ký dưới mã băm đó hay không. ## Thu thập và xử lý bằng chứng bền vững (0.2) Một tác vụ phương tiện và sự kiện tin nhắn tương ứng được ghi lại trong một giao dịch duy nhất. Tác vụ này lưu trữ mô tả tin nhắn TL gốc; quan sát có chữ ký liên kết mã SHA-256, tài khoản và chính sách kích thước của nó. Quá trình khôi phục sẽ xác minh liên kết đó trước khi tải xuống. Hệ thống không bao giờ truy xuất tin nhắn hiện tại mà sẽ âm thầm thay thế bằng tệp đính kèm mới hơn. Các tác vụ bị gián đoạn sẽ được thử lại, trong khi lỗi vĩnh viễn vẫn là một kết quả rõ ràng. Mỗi không gian làm việc có nhật ký và danh tính ký riêng. Sự kiện `process.started` bao gồm ID phiên chạy, đồng hồ cục bộ, phiên bản phụ thuộc, băm tệp nguồn, tài khoản/phạm vi ban đầu, và cài đặt ghi lại. Các tín hiệu kiểm tra (heartbeats) bao gồm ID phiên chạy, thời gian đơn điệu và trạng thái hàng đợi. Biên nhận chạy cũng có thể được tải xuống dưới dạng một tuyên bố được ký riêng biệt. Để xác minh môi trường thực thi, hãy kết hợp nó với chứng nhận GitHub hoặc các kiểm tra TDX được mô tả trong [Phạm vi xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope). Các điểm kiểm tra tự động được lưu giữ cục bộ khi khởi động, cứ sau năm phút trong quá trình quan sát (**Công cụ khác → Thông số → Điểm kiểm tra có chữ ký mỗi**), và khi dừng hoạt động theo đúng trình tự. Quá trình xác minh khi khởi động và xuất dữ liệu so sánh nhật ký với điểm kiểm tra cục bộ mới nhất được lưu giữ. Điều này có thể phát hiện việc khôi phục cơ sở dữ liệu khi điểm kiểm tra vẫn còn tồn tại. Cơ chế lưu giữ độc lập giúp duy trì tham chiếu đó bên ngoài không gian làm việc; một dấu thời gian bên ngoài đã được xác minh sẽ cố định nó vào thời điểm cụ thể. Sau khi khởi động lại, vị trí cập nhật Telegram đã lưu sẽ được khôi phục (`catch_up_from` trong `observation.started`) và các bản cập nhật bị bỏ lỡ sẽ được yêu cầu tải về. Vị trí đã lưu chỉ bao gồm các bản cập nhật đã được xử lý xong, do đó các bản cập nhật vẫn đang chờ xử lý khi kết nối bị ngắt hoặc quá trình bị dừng sẽ được yêu cầu tải về lại. Quá trình kiểm tra lại định kỳ sẽ ghi nhận `message.recovered` các tin nhắn bị bỏ lỡ và `message.missing_on_recheck` khi Telegram không còn trả về tin nhắn đã lưu; trường hợp sau không phải là thông báo xóa và không nêu tên người xóa hay thời gian. ### Sao lưu và khôi phục ngoài trang web (S3) Bản sao ngoài trang web (**Cài đặt → Thông báo và bản sao ngoài trang web → Bản sao ngoài trang web**, hoặc **Công cụ khác → Tiện ích → Bằng chứng & bản sao lưu**; tắt theo mặc định) tải lên các phân đoạn nhật ký, tệp được lưu giữ, các điểm kiểm tra cùng với dấu thời gian của chúng và các bản xuất cuộc trò chuyện đã hoàn tất lên bộ lưu trữ tương thích với S3, được mã hóa bằng AES-256-GCM trước khi tải lên bằng khóa được lưu trữ trong kho lưu trữ của không gian làm việc; tính năng lưu giữ Object Lock được áp dụng khi bucket hỗ trợ tính năng này. Nếu không có khóa đã tải xuống, bản sao này không thể được đọc. Khôi phục và xác minh bằng lệnh `python -m tgwitness.replica restore --key-file KEY.json --out DIR`. Quá trình khôi phục yêu cầu một thư mục thông thường trống. Các tệp tải xuống và các đối tượng đã được giải mã sẽ được lưu giữ trong bộ nhớ tạm thời riêng tư cho đến khi toàn bộ nhật ký và mọi điểm kiểm tra được lưu giữ đều được xác minh. Các đường dẫn đối tượng không an toàn, phạm vi phân đoạn không nhất quán và các nhật ký ngắn hơn một điểm kiểm tra sẽ bị từ chối; nếu xác minh thất bại, hệ thống sẽ không công bố bất kỳ tệp nào đã được khôi phục. Các kiểm tra thời hạn lưu giữ sẽ so sánh chế độ Object Lock và ngày tháng được trả về với thời hạn được gửi khi tải lên (dung sai làm tròn là một giây). Thời hạn đã hết hạn, không hợp lệ hoặc bị rút ngắn sẽ không được coi là đã được xác minh. Trạng thái báo cáo đối tượng được lấy mẫu mà thời hạn lưu giữ của nó đã được đọc lại cho lần tải lên đó. Các tệp phương tiện cục bộ bị thiếu hoặc bị hỏng sẽ được báo cáo là lỗi của lần xử lý và con trỏ phương tiện sẽ được giữ lại trước vị trí đó, để tệp này được thử lại trong lần xử lý tiếp theo; các tệp, điểm kiểm tra và tệp xuất sau đó vẫn được sao chép. Quá trình khôi phục sẽ kiểm tra tất cả các tham chiếu đến phương tiện được lưu giữ so với các hàm băm đã được giải mã và kích thước đã ghi lại. Các phân đoạn nhật ký trùng lặp giống hệt nhau từ các lần tải lên bị gián đoạn sẽ được loại bỏ trùng lặp; các phần trùng lặp mâu thuẫn sẽ bị từ chối. Các điểm kiểm tra được tạo ra trong quá trình tải lên sẽ được hoãn lại cho đến khi các bản ghi nhật ký liên quan đã được sao chép, do đó một lần quét hoàn tất sẽ không công bố điểm kiểm tra trước khi nhật ký tương ứng được hoàn tất. ### Xuất các bản chụp nhanh theo thời gian thực Việc xuất dữ liệu theo thời gian thực sử dụng một bản chụp nhanh đọc ổn định từ cơ sở dữ liệu SQLite. Phần đầu của bản chụp nhanh này có thể cũ hơn so với sổ nhật ký trực tiếp hiện tại khi quá trình tải xuống hoàn tất. Một điểm kiểm tra được tạo ra sau bản chụp nhanh đó có thể báo cáo chính xác rằng kho lưu trữ ngắn hơn; hãy so sánh với một điểm kiểm tra tại hoặc trước tiền tố đã xuất, chứ không phải một điểm kiểm tra ngẫu nhiên nào đó sau đó. ## Chuẩn bị theo RFC 3161 và xác minh phản hồi (0.2) Chế độ bằng chứng chỉ gửi giá trị SHA-256 của từng điểm kiểm tra đã ký đến các cơ quan được liệt kê trong RFC 3161 và các lịch OpenTimestamps, qua tuyến không gian làm việc và tuyệt đối không qua MTProxy. Chức năng đóng dấu thời gian được bật theo mặc định trong mọi mục tiêu thiết lập; **Bằng chứng cho một trường hợp** cũng ghi lại drand. Các câu trả lời được lưu trữ trong `checkpoints/anchors/`, được xuất dưới dạng `.tsr` và `.ots` tệp trong thư mục `anchors/`, và được kiểm tra bởi `verify.py` (`--tsa-ca` kiểm tra chữ ký TSA; xác nhận bằng chứng OpenTimestamps bằng `ots upgrade` và `ots verify`). Một thực thể RFC 3161 thất bại hai lần liên tiếp sẽ chờ trước khi thử lại: một khoảng thời gian, sau đó hai, bốn và tiếp tục như vậy lên đến sáu giờ, hoặc trong thời gian mà `Retry-After` yêu cầu, tối đa một ngày. Một lần kiểm tra chỉ tìm thấy các thực thể đang chờ sẽ không ghi lại bản ghi nào; ngược lại, `anchor.completed` liệt kê chúng dưới `deferred` kèm theo `retry_at`. Cho đến khi chúng trả lời lại, bảng điều khiển hiển thị dấu thời gian ở trạng **thái Degraded**. Bảng điều khiển chuẩn bị một kho lưu trữ yêu cầu chứa các byte chuẩn của tệp checkpoint.json, dấu ấn tin nhắn SHA-256 và giá trị ngẫu nhiên (nonce) trong tệp timestamp.tsq, các tổng kiểm tra và hướng dẫn. Không có yêu cầu mạng nào được thực hiện; token mà cơ quan có thẩm quyền trả về cho yêu cầu này chính là dấu thời gian. `python -m tgwitness.anchor verify` đối chiếu phản hồi với các byte của điểm kiểm tra và yêu cầu gốc mà không cần OpenSSL. Phải chỉ định rõ tệp CA tin cậy; các chứng chỉ đi kèm không tự động được tin cậy. Trong CLI, việc kiểm tra yêu cầu là tùy chọn, vì vậy hãy lưu giữ yêu cầu và truyền --request để kiểm tra nonce. Kết quả cho biết nó đã được kiểm tra hay chưa. Chữ ký điểm kiểm tra của bộ thu thập và nhật ký vẫn phải được xác minh riêng bằng dấu vân tay tin cậy của bộ thu thập. Quá trình xác minh kiểm tra chữ ký phản hồi, các byte của điểm kiểm tra và, nếu được cung cấp, yêu cầu gốc dưới sự tin cậy của CA được chỉ định. Đối với các dấu thời gian thu được ở chế độ bằng chứng, `verify.py` cũng kiểm tra bằng chứng OCSP hoặc CRL ([danh sách thu hồi chứng chỉ ký](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/#signing-certificate-revocation)) được lưu trữ. Xem [quy trình](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/) và [kết quả xác thực](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/). ## Các bản ghi tùy chọn trong chế độ bằng chứng: drand và các thiết bị Telegram Có thêm hai bản ghi có thể chạy trên cùng các lần quét với các dấu thời gian. Cả hai chỉ có hiệu lực khi chế độ bằng chứng được bật. **Bằng chứng cho một vụ án** sẽ kích hoạt drand; ngược lại, cả hai đều bắt đầu từ đầu. Chuyển đổi chúng tại More tools → Extras → Evidence & backups → **More witnesses · tùy chọn**, hoặc `"drand": true` và `"devices": true` trong `POST /api/evidence`. Một lỗi không làm gián đoạn các bản ghi còn lại hoặc các dấu thời gian; bảng điều khiển hiển thị kết quả mới nhất của từng bản ghi dưới biểu mẫu. **drand** (`beacon.drand` ). Mỗi lần chạy sẽ ghi vòng drand quicknet mới nhất, tức là sự ngẫu nhiên công khai của League of Entropy (một vòng mỗi 3 giây), vào nhật ký: `chain` , `round` , `randomness` , `signature` , `round_time` và `relay` đã phản hồi. Một vòng được xác minh và không thể dự đoán trước cung cấp mốc thời gian tham chiếu thấp hơn cho tài liệu được liên kết bằng hàm băm tiếp theo. Dấu thời gian đã được xác minh tại một điểm kiểm tra sau đó cung cấp mốc thời gian trên. Các kiểm tra này giới hạn phạm vi của dữ liệu được liên kết. Trình thu thập sẽ truy vấn `drand.cloudflare.com` trước tiên, sau đó là các trạm trung chuyển của Protocol Labs, thông qua tuyến đường không gian làm việc, mỗi lượt thực hiện một yêu cầu. `verify.py` kiểm tra xem mỗi giá trị ngẫu nhiên có phải là SHA-256 của chữ ký của nó hay không và liệu thời gian vòng lặp có chính xác hay không, đồng thời báo cáo số vòng lặp, khoảng thời gian dài nhất không có vòng lặp và độ trễ giữa drand và đồng hồ của bộ thu thập. `--check-drand` so sánh các vòng với một trạm trung chuyển Cloudflare và một trạm trung chuyển Protocol Labs, tất cả các trạm hoặc một mẫu ngẫu nhiên gồm 100 trạm trong một nhật ký dài; một vòng có sự khác biệt sẽ không qua được quá trình xác minh. **, Telegram,** (`account.devices`). Mỗi lần quét sẽ đọc các phiên của tài khoản bằng `account.getAuthorizations`, danh sách Telegram hiển thị trong Cài đặt → Thiết bị, và ghi lại: toàn bộ khi có thay đổi so với lần quét trước, kèm theo các mã băm phiên `added` và `removed`, nếu không thì chỉ ghi lại số lượng và SHA-256. Mẫu thiết bị, nền tảng, ứng dụng và phiên bản, thời gian tạo và hoạt động gần nhất, quốc gia và khu vực được lưu giữ; địa chỉ IP thì không, vì việc xuất bằng chứng nằm ngoài tầm kiểm soát của bạn. Phiên làm việc của chính bộ thu thập luôn hoạt động, do đó chỉ hoạt động của các phiên khác mới được tính là sự thay đổi. `verify.py` báo cáo tần suất danh sách được ghi lại cũng như mỗi phiên mới và phiên đã kết thúc. Nó chỉ đọc danh sách khi quá trình quan sát đang diễn ra. Những gì chúng thể hiện: drand sắp xếp các bản ghi theo thứ tự thời gian công khai, và danh sách thiết bị là tuyên bố của Telegram thông qua bộ thu thập, được bộ thu thập ký tên giống như mọi bản ghi khác. **Nhật ký Cloudflare Gateway** (`cloudflare.gateway_dns`). Đối với máy chủ giải quyết qua Cloudflare Gateway ([Gateway DNS](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)), mỗi lần sao chép sẽ sao chép những gì Gateway đã ghi lại kể từ lần sao chép trước: một bản ghi cho mỗi khoảng thời gian tối đa ba giờ với `from`, `until`, `location_id`, `address` của máy chủ khi có thiết lập, và `queries` dưới dạng `[at, name, type, rcode, decision, colo]`, ngay cả khi không có bản ghi nào. Thiết lập trong **(Nhật ký Cloudflare Gateway)**: tài khoản, vị trí, địa chỉ tùy chọn và mã thông báo chỉ đọc (Đọc phân tích; Đọc PII Zero Trust để lưu một địa chỉ của vị trí chia sẻ). Bảng điều khiển kiểm tra Analytics Read; Zero Trust PII Read để lưu một địa chỉ của vị trí chia sẻ). Bảng điều khiển kiểm tra chúng bằng một yêu cầu trước khi lưu; mã thông báo vẫn được mã hóa và không bao giờ xuất hiện trong nhật ký. `verify.py` liệt kê các cửa sổ, các tên được tra cứu nhiều nhất và bất kỳ khoảng thời gian nào không có bản sao nào bao phủ; một bản ghi có số lượng không khớp với các truy vấn của nó sẽ bị lỗi. Một cửa sổ chứa hơn một trang truy vấn trong một giây sẽ giữ lại trang đó và báo rằng phần còn lại bị thiếu. Bản sao là phản hồi của Cloudflare thông qua bộ thu thập, được bộ thu thập ký tên; trong vòng 24 giờ, bất kỳ ai có mã thông báo chỉ đọc đều có thể so sánh nó với Cloudflare. --- # Telegram · Dịch báo cáo để nộp tòa án Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/translation/ Tệp nào là bản gốc, cần nộp gì kèm bản dịch có chứng thực và những thuật ngữ người dịch giữ nguyên. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Tệp nào là bản gốc, cần nộp gì kèm bản dịch có chứng thực và những thuật ngữ người dịch giữ nguyên. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bằng chứng và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) ![Bằng chứng & xác minh](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness soạn thảo báo cáo bằng 25 ngôn ngữ. Tiếng Anh là bản gốc. Các ngôn ngữ còn lại là bản dịch tự động; một số trong số đó đã được rà soát thuật ngữ; chúng giúp người vận hành đọc báo cáo và không phải là bản dịch được chứng nhận. ## Nộp những giấy tờ nào Nộp bản gốc tiếng Anh kèm theo bản dịch được chứng nhận hoặc bản dịch có tuyên thệ sang ngôn ngữ của tòa án. Một dịch giả có tuyên thệ phải am hiểu thuật ngữ địa phương và các yêu cầu về hình thức đối với các tài liệu tòa án. Khi ngôn ngữ của báo cáo không phải là tiếng Anh, các tệp ZIP chứa bằng chứng, nội dung trò chuyện và tài liệu bàn giao cũng bao gồm bản gốc tiếng Anh của chính báo cáo đó: `report.en.html` và `report.en.pdf`, hoặc `chat.en.html` và `chat.en.pdf` đối với tệp xuất cuộc trò chuyện. Chúng được mã hóa và ký bằng cùng một khóa với báo cáo bằng ngôn ngữ đã chọn và được liệt kê kèm theo giá trị SHA-256 trong bản kê khai đã ký, trong đó chúng được liệt kê dưới mục `report.original`. Một báo cáo được xuất sang tiếng Anh chính là bản gốc. Báo cáo bằng ngôn ngữ đã chọn sẽ mở ra với cùng lời khuyên và đề cập đến tệp tiếng Anh. Trước khi dịch, hãy đối chiếu bản gốc với bản lưu trữ: ``` python -m tgwitness.verify report.en.html --fingerprint KEY --evidence tgwitness-evidence.zip ``` `README.txt` trong mỗi tệp lưu trữ đều kết thúc bằng một **Dành cho các dịch giả** phần liệt kê tên các tệp gốc và lặp lại các thuật ngữ dưới đây. Phần [phương pháp kể chuyện và quy trình chuyên môn](https://github.com/phishdestroy/TgWitness/blob/main/docs/NARRATIVE.md) in ra lời khuyên tương tự. ## Điều gì được giữ nguyên theo nghĩa đen - Tên tệp, lệnh, mã băm, dấu vân tay khóa, ID Telegram, số tin nhắn và URL. - Thời gian: UTC theo tiêu chuẩn ISO 8601, như đã ghi. Không chuyển đổi sang múi giờ địa phương. - Các tin nhắn đã thu thập: hãy trích dẫn chúng bằng ngôn ngữ gốc và đưa ra bản dịch riêng biệt, được ghi chú rõ là bản dịch. ## Điều khoản | Thuật ngữ | Ý nghĩa | Không được dịch thành | | --- | --- | --- | | tạp chí | Dãy các bản ghi được ký tên và liên kết bằng hàm băm do bộ thu thập lưu giữ | Nhật ký, ấn phẩm định kỳ, tạp chí | | bản ghi | Một mục đã ký trong nhật ký; hãy dùng một từ duy nhất để chỉ mục đó trong suốt bài viết | Lưu ý, bài báo | | quan sát | Những gì người sưu tập đã nhận được vào thời điểm được ghi lại | Một kết luận về tính xác thực của nội dung | | người sưu tập | Quá trình TgWitness đã theo dõi thông qua tài khoản Telegram của chính người vận hành | Bộ sưu tập các mặt hàng | | thu thập dữ liệu | Nhận và ghi lại các bản cập nhật từ Telegram | Bộ sưu tập, bộ, tuyển tập | | thông báo xóa | Thông báo của Telegram về việc một tin nhắn đã bị xóa; thông báo này không hiển thị ai là người đã xóa tin nhắn đó | Một sự xóa bỏ đã được xác nhận do một cá nhân cụ thể thực hiện | | không tìm thấy khi kiểm tra lại | Khi kiểm tra lại, Telegram không còn hiển thị thông báo đó nữa: đã bị xóa hoặc không còn hiển thị đối với tài khoản này | Đã xóa | | số tin nhắn không có | Một số không có thông báo trong bản xuất: đã bị xóa trước đó hoặc chưa bao giờ hiển thị cho tài khoản này | Tin nhắn bị mất, tin nhắn bị thất lạc | | khoảng cách | Một khoảng thời gian không được theo dõi | Bằng chứng cho thấy không có chuyện gì xảy ra | | phiên bản trước đó | Nội dung trước khi chỉnh sửa; cả hai phiên bản đều được giữ lại | Sửa chữa, làm sai lệch | | điểm kiểm tra | Bản tóm tắt có chữ ký của tạp chí cho đến số kỷ lục | Điểm kiểm soát theo nghĩa vật lý | | Dịch vụ đóng dấu thời gian (TSA) | Một dịch vụ đóng dấu thời gian độc lập theo tiêu chuẩn RFC 3161 | Cơ quan có thẩm quyền, cơ quan nhà nước, cơ quan cấp chứng chỉ | | biên lai có dấu thời gian | Phản hồi từ dịch vụ dấu thời gian, hoặc biên nhận OpenTimestamps, cho thấy điểm kiểm tra đã tồn tại vào một thời điểm nào đó | Bằng chứng, chứng cứ về các sự kiện | | con dấu | Chữ ký Ed25519 được nhúng trong tệp báo cáo | Con dấu của một quan chức | | dấu vân tay khóa ký | Giá trị SHA-256 của khóa công khai, được thu được thông qua một kênh đáng tin cậy riêng biệt | Dấu vân tay sinh trắc học | | nhân chứng | Một bên hoặc dịch vụ độc lập có nhiệm vụ duy trì hoặc xác nhận các điểm kiểm soát | Một người làm chứng tại tòa án | | trích đoạn bàn giao | Một phần của cuốn nhật ký được lập cho một bên khác, trong đó dữ liệu của những người khác đã được giảm thiểu | Xuất toàn bộ | | bản ghi được thu gọn | Một bản ghi trong đó các trường bị ẩn được đặt tên và thay thế bằng mã băm của chúng | Hồ sơ đã bị xóa hoặc bị che giấu | --- # Telegram · Nhân chứng độc lập Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/witness/ Vui lòng chạy một bản sao TgWitness với khóa và bot riêng, đăng các điểm kiểm tra đã được ký lên một kênh và đối chiếu các tệp xuất với các điểm kiểm tra đó. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Vui lòng chạy một bản sao TgWitness với khóa và bot riêng, đăng các điểm kiểm tra đã được ký lên một kênh và đối chiếu các tệp xuất với các điểm kiểm tra đó. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bằng chứng và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) ![Bằng chứng & xác minh](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) [Xuất và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) · [Độ tin cậy cao](https://phishdestroy.io/tgwitness/vi/docs/reference/high-assurance/) · [Hướng dẫn sử dụng bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/reference/panel/#extras) Một nhân chứng lưu trữ các điểm kiểm tra đã ký riêng biệt với bộ thu thập. Nó kiểm tra chữ ký và tính liên tục của nhật ký của bộ thu thập, ký kết quả bằng khóa riêng của mình, và đăng tải lên một kênh Telegram. Chạy công cụ này trên một máy chủ riêng biệt với quyền truy cập chỉ đọc vào điểm cuối nhân chứng của bộ thu thập. Kết quả kỹ thuật bao gồm các tiền tố nhật ký được lưu giữ, phản hồi thử thách, kiểm tra chữ ký, kiểm tra bao hàm/nhất quán Merkle và kết quả liên tục có chữ ký. Với nhân chứng do một bên lưu giữ khác vận hành, hãy giữ thông tin bên lưu giữ và hồ sơ kiểm soát khóa cùng dấu vân tay của nó. Khóa riêng và lưu giữ riêng mô tả những phần khác nhau của cấu hình. Trình xác minh báo cáo rằng một khóa thứ hai đã lưu giữ đầu nhật ký và đến bản ghi nào; hồ sơ kiểm soát khóa của bên lưu giữ cho biết ai nắm giữ khóa đó. Nhật ký nhân chứng là một kiểm tra hỗ trợ; mức tối thiểu cho chứng cứ là thời gian từ bên thứ ba. Các bài đăng trong kênh bổ sung thời gian bên ngoài: Telegram ghi ngày cho mỗi bài đăng công khai, và trình xác minh tự đọc các ngày đó. Sơ đồ quy trình · Trình thu thập → Witness (điểm kiểm tra có chữ ký: số lượng bản ghi + băm tiêu đề); Witness → Sổ nhật ký chứng cứ, khóa riêng; Witness → Kênh Telegram (bài đăng có chữ ký được gửi qua bot riêng của nền tảng này); Tệp ZIP chứa bằng chứng → verify.py; Sổ nhật ký chứng cứ, khóa riêng → verify.py; Kênh Telegram → verify.py (Trang t.me/s: xem trực tiếp hoặc xuất sang máy tính để bàn) · Trình thu thập · Witness · Sổ nhật ký chứng cứ, khóariêng · Kênh Telegram · Tệp ZIP chứa bằng chứng · verify.py · điểm kiểm tra có chữ ký: số · lượng bản ghi + băm tiêu đề · bài đăng có chữ ký được gửi · qua bot riêng của nền tảng · này · Trang t.me/s: xem trực tiếp · hoặc xuất sang máy tính để · bàn **Sơ đồ dưới dạng văn bản** 1. Trình thu thập → Witness (điểm kiểm tra có chữ ký: số lượng bản ghi + băm tiêu đề) 2. Witness → Sổ nhật ký chứng cứ, khóa riêng 3. Witness → Kênh Telegram (bài đăng có chữ ký được gửi qua bot riêng của nền tảng này) 4. Tệp ZIP chứa bằng chứng → verify.py 5. Sổ nhật ký chứng cứ, khóa riêng → verify.py 6. Kênh Telegram → verify.py (Trang t.me/s: xem trực tiếp hoặc xuất sang máy tính để bàn) **Trên trang này** - [Những gì nhân chứng lưu giữ](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/#what-the-witness-holds) - [Những gì công cụ này kiểm tra và ghi lại](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/#what-it-checks-and-records) - [Chạy một witness](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/#run-a-witness) - [Trang bằng chứng công khai cho một số không gian làm việc](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/#public-proof-page-for-several-workspaces) - [Xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/#verify) ## Những gì nhân chứng lưu giữ | Người làm chứng đã | Người làm chứng chưa bao giờ | | --- | --- | | Một **mã thông báo chứng thực** chỉ đọc dành cho một không gian làm việc | Phiên làm việc Telegram hoặc thông tin đăng nhập API của người thu thập dữ liệu | | Sử dụng khóa Ed25519 và sổ nhật ký riêng | Kho lưu trữ của bộ thu thập, khóa ký hoặc mã thông báo bảng điều khiển | | Mã thông báo bot Telegram riêng của nền tảng này | Nội dung tin nhắn: phần đầu bao gồm số lượng bản ghi và mã băm | Token được tạo trong **Công cụ khác → Tiện ích → Nhân chứng độc lập**, chỉ hiển thị một lần và chỉ được lưu trữ dưới dạng SHA-256. Nó mở chính xác một điểm cuối, `GET /api/witness/head`, trả về một điểm kiểm tra vừa được ký cùng với các bộ đếm bộ sưu tập không chứa nội dung đã được ký và tình trạng hoạt động. Token này không thể mở bảng điều khiển, đọc nội dung tin nhắn hoặc thay đổi cài đặt, và token bảng điều khiển không được chấp nhận tại đó. Hủy bỏ token trên cùng trang này. Bộ thu thập ghi lại thời điểm khóa chứng nhân mới bắt đầu kiểm tra (`witness.seen`) và hiển thị lần kiểm tra cuối cùng cho mỗi token; một chứng nhân chưa kiểm tra trong vòng 2.5 khoảng thời gian sẽ được đánh dấu là quá hạn. Các nhân chứng mới sẽ gửi một thách thức ngẫu nhiên trong mỗi cuộc thăm dò; tuyên bố ghi lại sẽ lặp lại thách thức đó dưới chữ ký của bộ thu thập. Các bộ đếm được gắn với điểm kiểm tra chính xác và được bao gồm trong các bài đăng có chữ ký của nhân chứng. Các tiêu đề cũ vẫn được nhân chứng độc lập chấp nhận. Việc tăng dung lượng nhật ký đơn thuần không bao giờ được tính là một tin nhắn mới. ## Những nội dung mà công cụ này kiểm tra và ghi lại Cứ sau mỗi khoảng thời gian (mặc định là 10 phút), công cụ TgWitness sẽ: 1. tự động lấy phần đầu (bộ thu thập không thể đẩy hoặc bỏ qua phần này); 2. xác minh chữ ký của người thu thập, khóa người thu thập được ghim (`--collector-fingerprint`, hoặc khóa đầu tiên được phát hiện), một số đếm không giảm và một đầu không thay đổi tại một số đếm không thay đổi. Các bằng chứng bao gồm và nhất quán Merkle xác minh rằng một nhật ký đang mở rộng nối tiếp với điểm kiểm tra được lưu giữ. Một khi các bằng chứng liên tục đã được sử dụng, việc xóa chúng sẽ bị từ chối; 3. ghi thêm một bản ghi đã được ký vào nhật ký của chính nó: `witness.anchor` với trạng thái `ok`, `key_changed`, `rollback` (số lượng bản ghi ít hơn trước), `fork` (độ dài tương tự, tiêu đề khác ) hoặc `invalid` (câu trả lời không qua được quá trình xác minh), hoặc `witness.no_response` khi bộ thu thập không phản hồi; 4. đăng kết quả lên kênh, kèm chữ ký, bao gồm cả trường hợp “không có phản hồi” trong khi TgWitness đang hoạt động và có thể kết nối với Bot API. ID bài đăng được ghi lại (`witness.posted`), kể cả khi việc đăng không thành công (`witness.post_failed`). Một bài đăng trông như sau; dòng cuối cùng chứa tuyên bố đã được ký xác nhận: ``` TgWitness witness #42 · journal head Collector 3fa9c2d1e0b4a7f6: 18234 records Head 9b1f…c07e 2026-10-28T19:40:00.123+00:00 TGW1.eyJhdCI6…. ``` ## Chạy công cụ Witness Quý vị cần một bot Telegram (tạo bot bằng @BotFather), một kênh mà bot đó là quản trị viên, và địa chỉ của bộ thu thập phải có thể truy cập được từ phía người làm chứng — qua HTTPS bên ngoài mạng riêng (xem cấu hình HTTPS trong [phần triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/)). Mở **Thêm công cụ → Tiện ích → Nhân chứng độc lập → Cấu hình** trong bảng điều khiển. Ba bước bao gồm quyền truy cập chỉ đọc, kênh và khoảng thời gian của bạn, sau đó khởi chạy nhân chứng. Chính sách xuất bản, proxy HTTP/SOCKS5 tùy chọn và địa chỉ API Bot tùy chỉnh nằm trong **Cài đặt nâng cao** . Biểu mẫu tải xuống tệp `witness.json` với khóa bộ thu của không gian làm việc này được ghim sẵn. Tải xuống mã thông báo chỉ đọc vừa tạo với tùy chọn **“Lưu tệp truy cập** dưới dạng” `witness-token.txt` ; đặt tệp này cùng với tệp `bot-token.txt` được tạo trên máy chủ chứng nhân bên cạnh tệp JSON đó. Bộ thu thập không bao giờ nhận được mã thông báo bot. Việc tải xuống không khởi chạy dịch vụ hoặc đăng tải tin nhắn. Không có chứng nhân dự án được lưu trữ nào được đăng ký ngầm. ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json python -m tgwitness.witness fingerprint --config witness.json ``` Lệnh đầu tiên kiểm tra các tệp cấu hình và tệp bí mật mà không cần thực hiện yêu cầu mạng hay tạo khóa . Các đường dẫn trong JSON là đường dẫn tương đối so với tệp đó; các đường dẫn CLI/môi trường là đường dẫn tương đối so với thư mục làm việc. Lưu giữ dấu vân tay của chứng nhân bên ngoài máy chủ của nó. Chỉ báo lần lấy mẫu cuối cùng của bộ thu thập chỉ xác nhận yêu cầu; việc công bố được báo cáo bởi Proof hoặc được kiểm tra trong nhật ký chứng nhân và kênh. Nếu bảng điều khiển nằm phía sau một đường hầm SSH, vui lòng chỉ công khai điểm cuối chứng cứ trong phạm vi trên một tên miền HTTPS riêng biệt theo [ví dụ về Caddy này](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example). Không gian làm việc mặc định sẽ sử dụng `https://witness.example.org`, các không gian làm việc khác sử dụng `https://witness.example.org/profiles/ID`. Vẫn cần có mã thông báo; bảng điều khiển và các đường dẫn API khác của nó sẽ không được chuyển tiếp qua máy chủ ảo đó. Vui lòng chọn `all` để nhận các điểm kiểm tra được công bố định kỳ. Khoảng thời gian năm phút tương đương với khoảng 288 bài đăng mỗi không gian làm việc mỗi ngày. `changes`/`problems` cố ý không công bố một số điểm kiểm tra. MTProxy dành cho ứng dụng Telegram của người thu thập dữ liệu. Việc thăm dò HTTP của Witness và API Bot HTTPS của Telegram sử dụng các tuyến đường riêng biệt: trực tiếp/HTTP/SOCKS5 ([API Bot](https://core.telegram.org/bots/api)). **Bên cạnh trình thu thập dữ liệu, khi sử dụng Docker** (cùng một máy chủ — quy trình và khóa độc lập, nhưng cùng một người vận hành): hãy nhập các giá trị vào `.env` và khởi động cấu hình. ``` TGWITNESS_WITNESS_TOKEN=tgww_... TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC... TGWITNESS_WITNESS_CHANNEL=@your_witness_channel # another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/ docker compose --profile witness up -d docker compose logs witness # prints the witness key fingerprint ``` Khi sử dụng hình ảnh đã được công bố, vui lòng ghi rõ mã `docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d`. **Trên máy chủ của bên thứ ba** (quản lý riêng biệt): sao chép kho lưu trữ vào đó, thiết lập `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` cùng với ba giá trị trên trong tệp `.env`, sau đó ``` docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d ``` hoặc không sử dụng Docker: ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel ``` ### Đăng lên Discord Một nhân chứng có thể đăng lên kênh Discord thay vì Telegram. Trong Discord, mở **Chỉnh sửa kênh → Tích hợp → Webhooks**, tạo một webhook và sao chép URL của nó. Trong bảng điều khiển, chọn **webhook Discord · kênh của bạn** ở bước 2. Trên máy chủ của nhân chứng, lưu URL này dưới tên `discord-webhook.txt` bên cạnh `witness.json`; nó sẽ không bao giờ đến được bộ thu thập. ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --discord-webhook-file discord-webhook.txt ``` Một witness chỉ có một publisher: một kênh Telegram hoặc một webhook Discord, không phải cả hai. Các bài đăng chứa cùng một tuyên bố đã ký và không thể gửi thông báo đến bất kỳ ai. Bài đăng dài hơn 2,000 ký tự của Discord sẽ được thay thế bằng một dòng ngắn kèm theo bản kiểm tra đầy đủ được đính kèm dưới dạng `witness-check.txt` . Mỗi ID bài đăng được ghi lại dưới dạng `witness.posted` . `verify.py --channel` chỉ đọc các kênh Telegram, do đó đối với Discord, hãy giữ nhật ký witness: nó chứa mọi bản kiểm tra. Các bài đăng trên Discord không cung cấp thông tin thời gian bên ngoài cho người xác minh. ### Các tùy chọn | Tùy chọn | Môi trường | Mặc định | Ý nghĩa | | --- | --- | --- | --- | | `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | Khoảng thời gian giữa các lần kiểm tra: 1–1.440 | | `--timeout` | `_TIMEOUT` | 30 | Thời gian chờ cho trình thu thập dữ liệu và Bot API: từ 5 đến 600 giây | | `--post` | `_POST` | `all` | `all`: mọi kiểm tra; `changes`: một hướng đi mới hoặc một vấn đề; `problems`: chỉ có vấn đề và những câu trả lời còn thiếu | | `--title` | `_TITLE` | `TgWitness witness` | Những từ đầu tiên trong mỗi bài đăng trên kênh | | `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | Hãy lưu lại khóa thu thập thay vì tin tưởng vào câu trả lời đầu tiên | | `--proxy` | `_PROXY` | trực tiếp | `socks5://host:port` hoặc `http://host:port` | | `--bot-api` | `_BOT_API` | `https://api.telegram.org` | Địa chỉ API Bot, ví dụ: một máy chủ API Bot cục bộ | | `--data-dir` | `_DATA` | `witness-data` | Khóa chứng thực và nhật ký | | `--config` | `_CONFIG` | – | Tệp JSON với bất kỳ tùy chọn nào nêu trên | Địa chỉ bộ thu thập, mã thông báo và kênh đến từ `--collector`, `--token` hoặc `--token-file`, `--bot-token` hoặc `--bot-token-file`, `--discord-webhook-file` và `--channel`, hoặc `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` và `_CHANNEL`, giúp giữ các bí mật khỏi danh sách quy trình. Một tệp cấu hình sử dụng các tên tùy chọn có dấu gạch dưới, kèm theo chuỗi ký tự `texts` để thay thế các từ trong các bài đăng trên kênh: ``` {"collector": "https://your-collector.example.org", "token_file": "witness-token.txt", "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel", "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness", "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}} ``` Các khóa `texts`: `ok`, `key_changed`, `rollback`, `fork`, `invalid`, `no_response`, `collector`, `records`, `head`. Dòng lệnh có ưu tiên cao hơn biến môi trường, và biến môi trường có ưu tiên cao hơn tệp cấu hình. Các tùy chọn hoặc khóa văn bản không được hỗ trợ sẽ khiến Witness dừng lại với một thông báo thay vì bị bỏ qua. Cách diễn đạt không bao giờ ảnh hưởng đến quá trình xác minh: verify.py kiểm tra token đã ký ở cuối mỗi bài đăng. Với `--post changes` hoặc `problems`, các kiểm tra chưa được đăng vẫn nằm trong sổ nhật ký chứng nhân và `verify.py` liệt kê chúng là chưa từng được đăng; bản ghi đầu tiên ghi rõ chính sách. Mọi kiểm tra vẫn xuất hiện trong sổ nhật ký, do đó ít bài đăng hơn có nghĩa là ít lần được Telegram ghi ngày hơn, chứ không phải ít kiểm tra hơn. Ngay cả khi không có kênh, TgWitness vẫn duy trì nhật ký của mình. Vui lòng lưu giữ dấu vân tay khóa của TgWitness (`python -m tgwitness.witness fingerprint`) ở một nơi khác. ## Trang chứng minh công khai cho một số không gian làm việc `python -m tgwitness.proof` TgWitness hỗ trợ tối đa 32 không gian làm việc cùng lúc và cung cấp một trang chỉ đọc với bản kiểm tra đã ký mới nhất của từng không gian. Mỗi không gian làm việc có khóa chứng thực riêng và sổ nhật ký trong thư mục dữ liệu, cùng với một khóa thu thập được ghim; việc đăng lên kênh Telegram là tùy chọn cho từng không gian làm việc. Bắt đầu từ [proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example): | Lĩnh vực | Ý nghĩa | | --- | --- | | `title` | Tiêu đề trang, 1–100 ký tự | | `data_dir` | Khóa và nhật ký Witness, liên quan đến tệp; mặc định `proof-data` | | `interval`, `timeout` | Số phút giữa các lần kiểm tra (1–1440, mặc định là 5); số giây chờ (5–600, mặc định là 20) | | `workspaces[].id`, `label` | Biệt danh viết thường ngắn và tên hiển thị | | `workspaces[].collector` | Địa chỉ Collector; các không gian làm việc khác kết thúc bằng `/profiles/` | | `workspaces[].collector_fingerprint` | Bắt buộc, khác nhau tùy theo từng không gian làm việc | | `workspaces[].token_file` | Tệp chứa mã chứng thực chỉ đọc của không gian làm việc đó | | `workspaces[].channel`, `bot_token_file` | Tùy chọn, kết hợp: đăng mỗi lần kiểm tra lên một kênh | | `workspaces[].proxy`, `bot_api` | Đường dẫn tùy chọn và địa chỉ API Bot | ``` python -m tgwitness.proof --config proof.json --check-config python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790 ``` Lệnh đầu tiên xác thực tệp và các tệp token mà không cần thiết lập kết nối. Trang này chỉ phản hồi các yêu cầu GET và HEAD: - `/` hiển thị tất cả các không gian làm việc; một không gian làm việc không được kiểm tra trong 2,5 khoảng thời gian sẽ được đánh dấu là đã hết hạn. - `/api/proof` trả về kết quả giống như JSON. - `/api/proof/` tải xuống bản tuyên bố đã ký mới nhất (`tgwitness-public-proof-v1`): số bản ghi chứng thực và mã băm, trạng thái, khóa thu thập được ghim, điểm kiểm tra, số lần thu thập và liệu bài đăng trên kênh có thành công hay không, được ký bằng khóa chứng thực của không gian làm việc đó. - `/healthz` Trả về mã lỗi 503 khi trình giám sát của không gian làm việc đã ngừng hoạt động. Đặt tên máy chủ riêng cho trang, ví dụ như [Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example). Để xác minh, hãy xuất sổ nhật ký chứng thực của không gian làm việc bằng `python -m tgwitness.witness export --data-dir proof-data/ --out witness.zip` và sử dụng nó theo hướng dẫn dưới đây. ## Xác minh Về phía người làm chứng, hãy xuất nhật ký của họ: ``` python -m tgwitness.witness export --out witness.zip # Docker (add -f deploy/compose/compose.witness.yaml on a witness server): docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip docker compose cp witness:/witness/witness.zip . ``` Sau đó, ở bất kỳ đâu, với tệp ZIP đã được ký bởi bộ thu thập và địa chỉ của kênh công khai: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel ``` `--channel` cũng chấp nhận tệp xuất từ Telegram Desktop (*Xuất lịch sử trò chuyện* → JSON sẽ tạo ra `result.json`) hoặc bản sao trang đã lưu; các tệp này kiểm tra nội dung bài đăng nhưng không cung cấp thời gian bên ngoài. `verify.py` kiểm tra nhật ký của nhân chứng (chuỗi khối và chữ ký), sau đó đảm bảo rằng **mọi head mà nhân chứng đã quan sát đều là một phần của nhật ký đã xuất**: bản ghi tại vị trí đếm đó phải có chính xác băm đó. Một đầu (head) không khớp sẽ không qua được quá trình xác minh — nhật ký đã bị thay đổi sau khi nhân chứng quan sát nó. Công cụ này cũng báo cáo các đầu được quan sát sau khi xuất, các bất thường mà nhân chứng đã ghi lại, các câu trả lời thất bại, các khoảng thời gian có các điểm kiểm tra khớp hiện diện trong bản xuất này ("Được chứng kiến từ X đến Y") và các khoảng trống. Các điểm kiểm tra sau đó không mở rộng các khoảng thời gian đó. Kết quả bao gồm số bản ghi khớp cuối cùng và số lượng bản ghi còn lại không có điểm kiểm tra khớp. Chỉ các câu trả lời được ký bằng chính khóa của bản xuất mới được tính: một bản xuất được ký bằng một khóa mà nhân chứng chưa từng thấy sẽ được báo cáo là chưa được chứng kiến, và nếu không có `--fingerprint`, người ký sẽ không được xác định. Với `--channel`, mỗi bài đăng được ký phải khớp với nhật ký của nhân chứng theo từng bản ghi: các bài đăng bị thay đổi sẽ không qua được quá trình xác minh, các bài đăng bị thiếu sẽ được liệt kê. Việc khớp token xác thực nội dung; ngày tháng nằm ngoài phạm vi của token đã ký. Với địa chỉ trực tiếp `https://t.me/s/…` hoặc `https://telegram.me/s/…`, người xác minh sẽ đọc ngày của từng bài đăng từ trang web tại thời điểm xác minh. Telegram thiết lập ngày đó; ngày của các bài đăng đã chỉnh sửa sẽ không được sử dụng. Ngày sớm nhất của một bài đăng tại đầu xuất là thời gian bên ngoài của bản ghi cuối cùng, đáp ứng điều kiện tối thiểu về bằng chứng. Ngày từ bất kỳ nguồn nào khác, chẳng hạn như tệp `result.json` được cung cấp, một trang đã lưu hoặc một địa chỉ web khác, đều là siêu dữ liệu được cung cấp, không phải là thời gian độc lập; kết quả nêu rõ nguồn gốc của ngày đăng (`post_date_verification`). ### Yêu cầu giới hạn xuất dữ liệu có chứng thực Đối với các trường hợp bàn giao bắt buộc phải kèm theo bản ghi cuối cùng có chứng kiến, vui lòng thêm mã `--require-witness`: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness ``` Điều này yêu cầu dấu vân tay của người làm chứng được lưu giữ độc lập, một khóa khác với khóa của bộ thu thập, và một điểm kiểm tra khớp chính xác tại cuối cùng của bản xuất này. Một điểm kiểm tra chỉ bao phủ một tiền tố sớm hơn là không đủ. Tạm dừng việc thu thập, để người làm chứng quan sát trạng thái cuối cùng, và xuất trước khi có các ghi nhật ký tiếp theo; nếu nhật ký thay đổi, hãy lưu giữ một điểm kiểm tra khác và xuất trạng thái đó. Một điểm kiểm tra sau này đơn lẻ không thể xác minh băm cuối cùng của một bản xuất ngắn hơn. Khi cũng cung cấp `--channel`, việc thiếu các bài đăng được tuyên bố hoặc tập hợp khớp trống sẽ khiến quá trình kiểm tra nghiêm ngặt này thất bại. Nếu không có cờ này, các kiểm tra tính toàn vẹn thông thường vẫn báo cáo các bản ghi không có chứng nhân mà không từ chối một kho lưu trữ vốn vẫn nguyên vẹn. Giữ nhật ký chứng nhân và khóa được ghim của nó riêng biệt. Kiểm tra trực tuyến xác minh tính liên tục giữa các điểm kiểm tra; xác minh ngoại tuyến so sánh từng điểm kiểm tra được lưu giữ với bản xuất. Các đầu máy cũ không có bằng chứng tính liên tục vẫn giữ lại so sánh ngoại tuyến và được báo cáo mà không cần xác minh tính liên tục trực tuyến. Báo cáo liệt kê thời gian ngừng hoạt động của chứng nhân và các lần xuất bản thất bại theo khoảng thời gian. ### Con dấu hàng ngày và lịch dấu thời gian không khả dụng Witness đóng dấu ranh giới nhật ký của ngày UTC trước đó và gửi hàm băm của con dấu đã ký đó đến OpenTimestamps. Một bản gửi lịch là bằng chứng đang chờ xử lý; chỉ các cam kết Bitcoin đã được kiểm tra độc lập mới nhận được xác nhận trong trình xác minh. Nếu tất cả các lịch đều thất bại, con dấu đã ký và nỗ lực không thành công vẫn được lưu lại trong nhật ký. Quy trình bảo trì hàng giờ sẽ thử lại bản ghi gốc đó, kể cả sau khi khởi động lại hoặc thay đổi ngày. Nó quét tối đa 32 con dấu, gửi tối đa hai bản nộp còn thiếu và dành tối đa 60 giây cho các lần thử lại mỗi lần quét. Một con trỏ liên tục luân phiên qua các con dấu cũ hơn. Các bản nộp được giữ lại tuân theo quy trình nâng cấp bằng chứng hiện có. Việc thử lại không ghi đè lên con dấu, không thay đổi ngày ban đầu của nó hoặc khẳng định rằng lịch đã nhận được nó sớm hơn. Một cam kết Bitcoin muộn hơn vẫn là một xác nhận bên ngoài muộn hơn. Các bằng chứng còn thiếu vẫn là `none`; các bằng chứng đang chờ xử lý vẫn là `pending` cho đến khi người xác minh kiểm tra chúng một cách độc lập. --- # Telegram · Dấu thời gian Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/ Dấu thời gian theo tiêu chuẩn RFC 3161 cho các điểm kiểm tra có chữ ký: những thông tin nào được gửi đến cơ quan có thẩm quyền và cách thức xác minh phản hồi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/vi/llms.txt) Dấu thời gian theo tiêu chuẩn RFC 3161 cho các điểm kiểm tra có chữ ký: những thông tin nào được gửi đến cơ quan có thẩm quyền và cách thức xác minh phản hồi. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bằng chứng và xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/) ![Bằng chứng & xác minh](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness chuẩn bị các yêu cầu theo tiêu chuẩn RFC 3161 và xác minh các phản hồi từ Cơ quan Chứng thực Dấu thời gian (TSA). Quy trình thủ công này không thực hiện việc lựa chọn TSA cũng như không gửi dữ liệu; chế độ bằng chứng sẽ thực hiện cả hai tác vụ này theo lịch trình ([định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)). Một yêu cầu đã được chuẩn bị **vẫn chưa** phải **là bằng chứng dấu thời gian**. ## Những gì bằng chứng này ghi nhận Sơ đồ quy trình · Nhận định về tài khoản → Chuỗi SHA-256 và chữ ký Ed25519; Chuỗi SHA-256 và chữ ký Ed25519 → Điểm kiểm tra có chữ ký; Điểm kiểm tra có chữ ký → Hàm băm chính xác đến từng byte và giá trị ngẫu nhiên (nonce); Hàm băm chính xác đến từng byte và giá trị ngẫu nhiên (nonce) → Yêu cầu theo RFC 3161; Yêu cầu theo RFC 3161 → TSA độc lập; TSA độc lập → Phản hồi có chữ ký của TSA; Điểm kiểm tra có chữ ký → Xác minh dữ liệu, mã ngẫu nhiên (nonce) và sự tin cậy rõ ràng đối với CA; Phản hồi có chữ ký của TSA → Xác minh dữ liệu, mã ngẫu nhiên (nonce) và sự tin cậy rõ ràng đối với CA · Nhận định về tài khoản · Chuỗi SHA-256 và chữký Ed25519 · Điểm kiểm tra có chữký · Hàm băm chính xác đếntừng byte và giá trịngẫu nhiên (nonce) · Yêu cầu theo RFC 3161 · TSA độc lập · Phản hồi có chữ ký củaTSA · Xác minh dữ liệu, mãngẫu nhiên (nonce) vàsự tin cậy rõ ràng đốivới CA **Sơ đồ dưới dạng văn bản** 1. Nhận định về tài khoản → Chuỗi SHA-256 và chữ ký Ed25519 2. Chuỗi SHA-256 và chữ ký Ed25519 → Điểm kiểm tra có chữ ký 3. Điểm kiểm tra có chữ ký → Hàm băm chính xác đến từng byte và giá trị ngẫu nhiên (nonce) 4. Hàm băm chính xác đến từng byte và giá trị ngẫu nhiên (nonce) → Yêu cầu theo RFC 3161 5. Yêu cầu theo RFC 3161 → TSA độc lập 6. TSA độc lập → Phản hồi có chữ ký của TSA 7. Điểm kiểm tra có chữ ký → Xác minh dữ liệu, mã ngẫu nhiên (nonce) và sự tin cậy rõ ràng đối với CA 8. Phản hồi có chữ ký của TSA → Xác minh dữ liệu, mã ngẫu nhiên (nonce) và sự tin cậy rõ ràng đối với CA Chữ ký của bộ thu thập liên kết các bản ghi với khóa của nó. Phản hồi đáng tin cậy từ TSA có thể xác nhận rằng một điểm kiểm tra cụ thể đã tồn tại vào thời điểm do TSA công bố. Điểm kiểm tra đó sau đó có thể liên kết tiền tố nhật ký. Giới hạn thời gian trên áp dụng cho tiền tố đã được cam kết đó; các hành động Telegram riêng lẻ vẫn giữ nguyên thời gian sự kiện đã ghi lại. ## Quy trình Trình xác minh nhật ký báo cáo các bước lùi và các giá trị `observed_at` không thể phân tích cú pháp trong `chronology` khi có, đồng thời bao gồm một cảnh báo trong đầu ra lệnh của nó. Nó giữ nguyên các dấu thời gian đã ký và vẫn kiểm tra chữ ký của chúng. Một bước lùi có thể xuất phát từ việc điều chỉnh đồng hồ, do đó hãy kiểm tra lại với các bản ghi đồng hồ của máy chủ. Thời gian độc lập được lấy từ các dấu thời gian bên ngoài đã được xác minh, các bài đăng của nhân chứng được đọc từ trang t.me công khai của họ và các vòng drand; `--strict`quy định việc ghim người ký và các định dạng được hỗ trợ. Các giá trị drand đã ghi lại được kiểm tra tính nhất quán về cấu trúc và băm ngoại tuyến. `--check-drand` so sánh các vòng đã ghi lại được chọn với các phản hồi từ bộ chuyển tiếp HTTPS; kết quả cho biết có bao nhiêu vòng đã được so sánh và bộ chuyển tiếp nào đã trả lời, đồng thời các vòng đã so sánh cung cấp giới hạn thời gian dưới đã được xác thực. 1. Giữ lại dấu vân tay khóa của bộ thu thập thông qua một kênh đáng tin cậy riêng biệt; nó xác định bộ thu thập một cách độc lập với tệp ZIP đang được kiểm tra. 2. Trong **phần Xuất → Chuẩn bị yêu cầu dấu thời gian**, hãy tải xuống tệp ZIP yêu cầu của không gian làm việc đã chọn. Giải nén các tệp `checkpoint.json`, `timestamp.tsq`, `SHA256SUMS` và `README.txt`. Không được thay đổi các byte điểm kiểm tra. 3. Vui lòng chọn TSA phù hợp với cuộc điều tra. Gửi yêu cầu `timestamp.tsq` theo phương pháp đã được ghi chép, kèm theo `application/timestamp-query` cho dịch vụ HTTP. Lưu phản hồi nhị phân gốc dưới dạng `timestamp.tsr`, cùng với điểm cuối, thời gian truy xuất và kết quả yêu cầu. Yêu cầu này chứa mã băm và giá trị ngẫu nhiên (nonce) thay vì nội dung tin nhắn; dữ liệu siêu dữ liệu mạng vẫn tiết lộ thông tin về yêu cầu. 4. Hãy lấy chứng chỉ gốc đáng tin cậy một cách độc lập với nội dung phản hồi, cùng với bất kỳ chứng chỉ trung gian nào cần thiết. Một chứng chỉ có trong phản hồi sẽ không tự động trở thành chứng chỉ đáng tin cậy chỉ vì nó được bao gồm trong đó. 5. Từ một bản cài đặt TgWitness đáng tin cậy, hãy xác minh: ``` python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem ``` Thêm `--intermediates tsa-intermediates.pem` nếu cần. Không cần OpenSSL: chữ ký, tham chiếu chứng chỉ ký và chuỗi được kiểm tra bằng Python với thư viện `cryptography`, cùng mã mà `verify.py --tsa-ca` sử dụng. `openssl ts -verify` vẫn là lần kiểm tra thứ hai độc lập cho chuyên gia muốn dùng. 1. Xuất tệp ZIP chứa nhật ký đã được ký sau điểm kiểm tra để tệp này bao gồm tiền tố đó. Xác minh bằng cách sử dụng dấu vân tay đã được xác nhận độc lập: ``` python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json ``` Điều này cho thấy tệp xuất chứa tiền tố có dấu thời gian. `verify.py` chỉ đọc các biên lai dấu thời gian từ tệp ZIP, nơi chế độ bằng chứng lưu trữ chúng; phản hồi thủ công được kiểm tra ở bước 5 và bao gồm các bản ghi cho đến điểm kiểm tra này. 1. Bảo toàn tệp ZIP, điểm kiểm tra, yêu cầu, phản hồi, chuỗi chứng chỉ, kết quả xác minh và bản ghi chuyển giao bên ngoài bộ thu thập. Tiến hành xác minh lại khi nhận được. Để chuẩn bị một yêu cầu từ điểm kiểm tra đã lưu: ``` python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip ``` Quá trình chuẩn bị sẽ chuẩn hóa định dạng JSON và bao gồm điểm kiểm tra tương ứng trong tệp lưu trữ. Vui lòng sử dụng các **byte điểm kiểm tra từ tệp lưu trữ đó** để xác minh TSA, ngay cả khi tệp đầu vào có các khoảng trắng khác nhau. ## Phạm vi xác minh | Kiểm tra | Hành vi hiện tại | | --- | --- | | Dữ liệu | Giá trị SHA-256 của các byte điểm kiểm tra chính xác phải trùng khớp với giá trị trả về | | Yêu cầu | Với `--request`, truy vấn gốc và giá trị ngẫu nhiên (nonce) sẽ được xác minh | | Chữ ký TSA | Chữ ký, chứng chỉ ký và chuỗi của nó tới CA được chỉ định được kiểm tra tại thời điểm đóng dấu | | Chữ ký của bộ thu thập | Được xác minh độc lập bởi đơn vị xác minh nhật ký thông qua khóa được ghim | | Việc thu hồi | Chế độ bằng chứng lưu trữ bằng chứng OCSP/CRL mà `verify.py` kiểm tra | | Lịch trình gửi bài | Chế độ bằng chứng, được kích hoạt bởi mọi mục tiêu thiết lập | `--request` về mặt kỹ thuật là tùy chọn, nhưng bỏ qua nó thì không thể xác minh nonce gốc. Với quy trình đầy đủ này, `request_checked` trong kết quả phải là true. Mỗi chứng chỉ trong chuỗi phải còn hiệu lực tại thời điểm đóng dấu, và chứng chỉ ký chỉ được dùng cho dấu thời gian. Phản hồi TSA gắn các byte điểm kiểm tra đã gửi với thời gian đã nêu. Kiểm tra kết quả đó với các bản ghi thu thập và xác minh môi trường cho chế độ đã chọn. Chế độ bằng chứng bao gồm TSA được chứng nhận của chính phủ Bỉ `http://tsa.belgium.be/connect`; các phản hồi RFC 3161 được ký, do đó HTTP thuần túy không làm suy yếu chúng). Khi gốc chứng chỉ của nhà cung cấp đó được truyền vào `--tsa-ca`, `verify.py` sẽ báo cáo một dấu thời gian eIDAS được chứng nhận và đơn vị đánh dấu thời gian của nó; Quy định (EU) số 910/2014, điều 41(2), giả định tính chính xác của thời gian và tính toàn vẹn của dữ liệu được liên kết. ### Thu hồi chứng chỉ ký Ngay sau mỗi phản hồi, chế độ bằng chứng sẽ lấy bằng chứng thu hồi cho chứng chỉ ký TSA: phản hồi OCSP từ địa chỉ OCSP AIA của chứng chỉ, nếu không thì CRL từ điểm phân phối của nó (tối đa 4 MiB). Nó được lưu trữ bên cạnh phản hồi dưới dạng `checkpoint-N..ocsp` hoặc `.crl` và được xuất cùng với phản hồi đó. Việc lấy dữ liệu thất bại không bao giờ làm trì hoãn dấu thời gian; bản ghi `anchor.completed` liệt kê nó là `unavailable` kèm theo lý do. `verify.py` kiểm tra chữ ký phản hồi OCSP (do nhà phát hành hoặc chứng chỉ người trả lời mà nhà phát hành cấp cho mục đích ký OCSP), ID chứng chỉ và trạng thái, đồng thời đảm bảo rằng phản hồi được cấp vào hoặc sau thời điểm genTime hoặc vẫn còn hiệu lực vào thời điểm đó (nextUpdate). Đối với CRL, nó kiểm tra chữ ký của nhà phát hành, cùng khoảng thời gian và đảm bảo rằng số sê-ri không nằm trong danh sách. Sau đó, nó báo cáo `signing certificate not revoked as of