Một số phần của trang này vẫn còn bằng tiếng Anh: bản gốc tiếng Anh đã được sửa đổi sau khi được dịch.
Tham khảo / Bằng chứng
Telegram · Định dạng bằng chứng
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 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 để 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ý
- So sánh các tệp xuất dữ liệu trò chuyện
- Chuyển giao cuộc điều tra
- Trích đoạn bàn giao
- Báo cáo dễ đọc
- Chuẩn hóa sự kiện
- Ý nghĩa của Actor
- 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
- Người sản xuất
- Hồ sơ người dùng
- Chứng nhân độc lập
- Manifest và các điểm kiểm tra
- Phạm vi xác minh
- Tệp đính kèm
- Thu thập và xử lý biên nhận một cách bền vững (0.2)
- Chuẩn bị RFC 3161 và xác minh phản hồi (0.2)
- Các bản ghi tùy chọn trong chế độ bằng chứng: drand và các thiết bị Telegram
“Đượ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 ) | 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#
- 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. 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.
- 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.
- 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ẻ.
-
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 evidenceDấ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 evidencesẽ 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áokey_pinned: truevàcheckpoint_checked: truekhi 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).- 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
.tgwpwmạ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..tgwpwsử dụng scrypt và AES-256-GCM và được mở bằng lệnhunseal-passwordcủ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. - Để 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 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.
- 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
Đố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 để biết các giả định về độ tin cậy và kết quả xác thực 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.htmlhoặcmessages/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óaformat,report,seal): con dấu xác thực SHA-256 của bản chuẩn JSON thuộcreport, 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.240684792623320047764573196045913242332và 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 trongTGWITNESS_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ướireport.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.
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_atthê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.
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.startedvà 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. Khi chế độ chọn lọc cuộc trò chuyện nghiêm ngặt được bật (scope.stricttrongobservation.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.
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ởideletion.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. 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 hoặc
các phép đo Intel TDX, 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.
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 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 | 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 | 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 | 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/), 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.
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ý) được lưu trữ.
Xem quy trình và kết quả xác thực.
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 ), 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.