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

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

Tham khảo / Bằng chứng

Telegram · Cách thức hoạt động của bằng chứng

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 / Tài liệu · Bằng chứng và xác minh

Bằng chứng & xác minh

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 phương 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, thiết kế báo cáo và trích xuất quá trình bàn giao. 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

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ữTelegramTrình thu thậpSổ nhật ký có chữ kýTin nhắn mới: Hẹn gặp lúc 10:00Thêm tin nhắn.newChỉnh sửa: Hẹn gặp lúc 11:00Thêm tin nhắn.đã chỉnh sửaThông báo về việc xóa nội dungThêm tin nhắn.đã xóaCá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 đó.

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

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.

Sơ đồ quy trình64 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ố 0Bản ghi 1 / băm h1Bản ghi 2 bao gồm h1 /hash h2Bản ghi số 3 bao gồmh2 / hash h3Điểm kiểm tra có chữký: số 3, tiêu đề h3lư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.

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

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.

Đ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

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ìnhTrì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ủ AMáy chủ BTrình thu thập / phiên tàikhoản / khóa AĐiểm cuối kiểm tra chỉ đọcWitness / khóa thu thậpđược ghim / khóa riêng BSổ nhật ký chứng cứ có chữký riêng biệtKênh với các bài đăng TGW1đã được ký điện tửYêu cầu kiểm traCâu trả lời đã được ký xácnhậnAPI 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.

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 đủ đượ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 · Xuất và xác minh · Bắt đầu với một tài khoản