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 · Dấu thời gian

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

Bằng chứng & xác minh

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). 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ìnhNhậ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 CANhận định về tài khoảnChuỗ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 3161TSA độc lậpPhản hồi có chữ ký củaTSAXá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; --strictquy đị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.<service>.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 <time> (OCSP|CRL), kiểm tra không thành công, hoặc revocation not checked (no OCSP/CRL in the archive). Chứng chỉ ký bị thu hồi vào hoặc trước thời điểm genTime sẽ không qua được quá trình xác minh; việc thu hồi sau thời điểm đó sẽ được hiển thị dưới dạng cảnh báo.

Hồ sơ bằng chứng và gia hạn (RFC 4998)#

Dấu thời gian RFC 3161 chỉ có giá trị trong thời gian mà thuật toán băm, khóa ký và chứng chỉ của TSA còn hiệu lực; tuy nhiên, một vụ việc có thể kéo dài hơn thời hạn đó. Chế độ bằng chứng cũng lưu giữ một Bản ghi bằng chứng RFC 4998 (ERS) cho mỗi điểm kiểm tra được lưu giữ và gia hạn bản ghi này.

Trong mỗi lần xử lý bằng chứng, các điểm kiểm tra chưa có bản ghi sẽ được đưa vào một cây băm, và các TSA đã được cấu hình sẽ được truy vấn theo thứ tự để lấy một dấu thời gian trên nút gốc của cây. Mỗi điểm kiểm tra sẽ nhận được checkpoints/anchors/checkpoint-N.ers: một EvidenceRecord trong đó ArchiveTimeStampSequence chứa một ArchiveTimeStampChain với một ArchiveTimeStamp chứa cây băm đã được thu gọn cho điểm kiểm tra đó và mã thông báo TSA. Một bản ghi có thể liệt kê các giá trị băm của các điểm kiểm tra lân cận; các công cụ xác thực như EU DSS sẽ cảnh báo về điều này. Một tệp xuất ASiC-E cũng chứa META-INF/evidencerecord.ers cùng META-INF/ASiCEvidenceRecordManifest.xml, bản ghi bằng chứng cho các đối tượng dữ liệu của container (ETSI EN 319 162-1). Một tệp xuất ZIP chứa các bản ghi điểm kiểm tra dưới anchors/.

Việc gia hạn tuân theo Mục 5 của RFC 4998 và chỉ bổ sung:

Gia hạn Khi nào Điều gì được đóng dấu
Gia hạn dấu thời gian Chứng chỉ ký của token mới nhất sẽ hết hạn trong vòng N tháng (mặc định là 6), băm chữ ký của nó được đánh dấu là yếu, hoặc theo yêu cầu Giá trị băm của token trước đó, sử dụng cùng một thuật toán; dấu thời gian được thêm vào chuỗi cuối cùng
Cập nhật cây băm Thuật toán băm của chuỗi này được đánh giá là yếu, hoặc theo yêu cầu H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) với thuật toán mạnh hơn (mặc định là SHA-512); một chuỗi mới được thêm vào

Mỗi lần gia hạn sẽ được lưu vào một tệp mới, checkpoint-N.renewal-K.ers; các tệp và chuỗi trước đó vẫn giữ nguyên từng byte. Bằng chứng chỉ có thể truy ngược lại đến dấu thời gian đầu tiên nếu mọi liên kết đều được kiểm tra theo thứ tự, do đó hãy gia hạn khi token mới nhất vẫn còn hiệu lực: trước khi chứng chỉ ký của nó hết hạn, thông tin thu hồi của nó biến mất hoặc thuật toán băm hoặc thuật toán ký của nó bị phá vỡ. Một lần gia hạn sau đó sẽ thêm một dấu thời gian nhưng không mở rộng bằng chứng trước đó.

Vòng lặp nền ở chế độ bằng chứng sẽ kiểm tra chính sách hàng ngày và theo yêu cầu (evidence_record.demand_renewal). Mỗi lần thử sẽ được ghi vào nhật ký dưới dạng evidence_record.created hoặc evidence_record.renewed cùng với dịch vụ, thời gian, thuật toán băm, gốc cây, phạm vi điểm kiểm tra, ok và các lỗi; các bản ghi không đọc được sẽ được chuyển đến evidence_record.check_failed. Một TSA không thành công sẽ được thử lại với thời gian chờ đóng dấu điểm kiểm tra, được tính riêng, trong khi TSA tiếp theo trong danh sách sẽ được thử. Chính sách (months_before_expiry, weak_algorithms, algorithm, stronger_algorithm) là cài đặt cấu hình evidence_record_policy; bảng điều khiển hiện chưa có tùy chọn điều khiển nào cho thiết lập này.

Bộ thu thập sẽ đối chiếu từng bản ghi mới với điểm kiểm tra và chữ ký của TSA trước khi ghi nó. verify.py kiểm tra mọi bản ghi trong quá trình xuất: cây băm, mã thông báo, thứ tự của các chuỗi và các lần gia hạn, và báo cáo thời gian sớm nhất đã được xác minh cùng trạng thái của dấu thời gian mới nhất. EU DSS đọc các bản ghi cùng với điểm kiểm tra dưới dạng dữ liệu tách rời.

Quy định (EU) 2024/1183 (eIDAS 2.0) đã bổ sung lưu trữ điện tử đủ điều kiện và sổ cái điện tử đủ điều kiện vào Quy định (EU) số 910/2014. TgWitness ghi lại các bản ghi theo các định dạng tiêu chuẩn nhưng không phải là dịch vụ đáng tin cậy; kho lưu trữ và sổ cái của nó không có trạng thái đủ điều kiện. Một nhà cung cấp đủ điều kiện sẽ cần, trong số những yêu cầu khác:

  • Lưu trữ (Điều 45i và 45j): một nhà cung cấp dịch vụ tin cậy đủ điều kiện phải lưu giữ dữ liệu trong thời hạn lưu trữ theo quy định pháp luật hoặc hợp đồng, đảm bảo dữ liệu vẫn bền vững và có thể đọc được sau khi hết thời hạn hiệu lực công nghệ, đồng thời được bảo vệ khỏi mất mát và thay đổi, kèm theo báo cáo tính toàn vẹn tự động dành cho các bên tin cậy được ủy quyền từ khi bắt đầu lưu trữ cho đến khi truy xuất. Điều 45i(2) giả định tính toàn vẹn và nguồn gốc đối với dịch vụ này.
  • Sổ cái (Điều 45k và 45l): một sổ cái được tạo ra và quản lý bởi một hoặc nhiều nhà cung cấp dịch vụ ủy thác đủ điều kiện, có chức năng xác định nguồn gốc của các bản ghi, sắp xếp chúng theo thứ tự duy nhất và theo trình tự thời gian, đồng thời giúp phát hiện ngay lập tức các thay đổi được thực hiện sau này. Sổ nhật ký TgWitness được liên kết bằng hàm băm và được ký bằng khóa riêng của người thu thập; bản thân sổ nhật ký này không phải là một sổ cái đủ điều kiện.
  • Cả hai: tư cách đủ điều kiện do cơ quan giám sát cấp và việc được đưa vào danh sách đáng tin cậy (Điều 21 và Điều 22), các nghĩa vụ quy định tại Điều 24, việc đánh giá sự phù hợp ít nhất mỗi 24 tháng một lần (Điều 20) và các tiêu chuẩn tham chiếu của các văn bản thi hành theo Điều 45j(2) và Điều 45l(2).

Các dấu thời gian được chứng nhận từ một TSA được chứng nhận (Điều 41 và 42) duy trì giả định riêng của mình cho mỗi mã thông báo; việc gia hạn không tạo ra giả định nào cho toàn bộ hồ sơ.

Bản ghi chuyển giao#

Ghi lại mã định danh vụ việc, người gửi và người nhận, thời gian chuyển tiếp theo múi giờ UTC cùng nguồn gốc của nó, mục đích, tên tệp/giá trị SHA-256, dấu vân tay của bộ thu thập, phạm vi chuỗi, các khoảng trống đã biết, phiên bản trình xác minh và kết quả xác minh. Hãy ký tên và lưu giữ độc lập bản ghi này theo quy trình của tổ chức quý vị. Hệ thống lưu giữ bản ghi đa người dùng không được triển khai trong TgWitness.

Kiểm tra dịch vụ trực tiếp, ngày 9 tháng 11 năm 2026#

Một yêu cầu RFC 3161 đã được gửi đến mỗi dịch vụ mặc định. Cả hai đều chấp thuận yêu cầu này.

Dịch vụ Trả lời Đơn vị ký Kết quả của trình xác minh
http://tsa.belgium.be/connect Được cấp phép, chính sách 2.16.56.13.6.3.1.1000 Đơn vị dấu thời gian 202301 Dấu thời gian eIDAS được chứng nhận
https://freetsa.org/tsr Được chấp thuận FreeTSA Dấu thời gian RFC3161

Chứng chỉ ký của Bỉ mang tuyên bố tuân thủ qcStatements và trùng khớp với đơn vị được ghi lại trong trình xác minh. Các thử nghiệm cục bộ cũng sử dụng một CA/TSA tổng hợp để kiểm tra việc từ chối dữ liệu bị thay đổi, nonce bị thay đổi và CA sai.

Vào ngày 10 tháng 11 năm 2026, máy chủ phản hồi OCSP của Bỉ, một chứng chỉ máy chủ phản hồi được ủy quyền, đã trả lời "good" cho Đơn vị Dấu thời gian 202301. Địa chỉ OCSP của FreeTSA (cổng 2560) không trả lời trong vòng 40 giây kể từ máy chủ thử nghiệm; thay vào đó, danh sách CRL (PEM, 1 KB) của nó đã được sử dụng.