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

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

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

Telegram · Ghi lại các hành động trên GitHub Actions

Chọn Takeout, xuất qua API thông thường hoặc nhật ký trò chuyện trên runner GitHub tạm thời.

Tham khảo đầy đủ

TgWitness / Tài liệu · Quay phim độc lập

Quay phim độc lập

Có thể xem trước từ trang main. Một nhánh (fork) sẽ khởi chạy quy trình làm việc có thể tái sử dụng đã được ghim từ phishdestroy/TgWitness. Quy trình làm việc này xuất một tài khoản, các cuộc trò chuyện đã chọn hoặc nhật ký sự kiện của một cuộc trò chuyện bằng cách sử dụng một phiên Telegram mới được tạo, xác thực bằng chứng dưới dạng tệp ZIP hoặc bản kê khai đa phần, và chỉ tải lên các gói dữ liệu được mã hóa bởi người nhận. Bảng điều khiển quản trị thông thường không được hiển thị.

Chọn client=official_web để chạy trình chứng kiến client chính thức với các điều khiển Telegram Web được bảo vệ và video. Tính năng này yêu cầu bạn phải có proxy upstream riêng và chỉ theo dõi một cuộc trò chuyện đã được hiển thị. Mặc định client=api sẽ giữ nguyên các chế độ xuất toàn bộ tài khoản được mô tả bên dưới.

Người xác minh sẽ đối chiếu tệp lưu trữ với chứng nhận trên GitHub, quy trình làm việc đã được phê duyệt và các bản cam kết của bộ thu thập, cũng như nhật ký đã ký và các hàm băm tệp đính kèm. Quá trình thu thập sử dụng mã nguồn từ nguồn chính đã được cố định và không gian lưu trữ mới. Người đánh giá có thể kiểm tra mã nguồn đó và xác minh tệp lưu trữ đã được cung cấp dựa trên bản ghi quá trình thực thi tương ứng.

Trên trang này

Quy trình người dùng#

Trợ lý sẽ giải thích năm giai đoạn và cho phép bạn thử tính năng thay thế tin nhắn hoặc bộ thu thập trên dữ liệu mẫu. Nhấn Bắt đầu ghi lại để mở trình hướng dẫn.

  1. Chọn GitHub Actions capture (bản xem trước) trên trang chủ dự án, màn hình đăng nhập không gian làm việc hoặc tại mục Xuất → Mở trình hỗ trợ capture. Bạn cũng có thể mở trình hỗ trợ chính thức hoặc tệp `tgwitness/static/capture.html` từ một bản checkout đáng tin cậy trong trình duyệt hiện đại. Trình trợ giúp không thực hiện bất kỳ yêu cầu mạng nào để xử lý khóa hoặc tệp. Trình trợ giúp hỗ trợ các ngôn ngữ giao diện của trang web; bảng thu thập tạm thời hỗ trợ tiếng Anh và tiếng Nga và sẽ mở bằng ngôn ngữ của trình duyệt nếu đó là một trong hai ngôn ngữ trên.
  2. Tạo khóa và lưu tệp sealed-key.json. Đây là khóa riêng tư duy nhất dùng để giải mã. Sao chép giá trị khóa công khai của người nhận. Nếu mất khóa riêng tư, bạn sẽ mất quyền truy cập vào cả kết nối lẫn tệp lưu trữ. Xác nhận rằng bạn đã lưu tệp này để mở khóa bước tiếp theo. Nếu bạn đã có tệp giao hàng, hãy tải khóa đã lưu và chọn Tôi đã có tệp lưu trữ.
  3. Tạo nhánh (fork) từ TgWitness, kích hoạt tính năng Actions trong nhánh đó và chạy tính năng ghi lại cuộc trò chuyện được mã hóa (Sealed chat capture). Dán địa chỉ người nhận công khai và chọn 30, 60 hoặc 120 phút. Tuyệt đối không được đưa số điện thoại, mã đăng nhập, mật khẩu Telegram, khóa riêng tư hoặc phiên làm việc vào các trường đầu vào của quy trình làm việc, các bản cam kết (commits), các vấn đề (issues) hoặc nhật ký (logs).
  4. Trong quá trình chạy, hãy tải xuống tệp sealed-connection từ Artifacts và giải nén nó. Tải connection.tgwsealed trong trình trợ giúp, sử dụng khóa riêng đã lưu. Liên kết kết quả chứa một khóa truy cập ngẫu nhiên trong phần URL fragment. Hãy giữ liên kết này bí mật. Bảng điều khiển sẽ loại bỏ phần fragment và lưu trữ khóa truy cập trong bộ nhớ phiên của tab này; nó không được ghi vào nhật ký truy cập HTTP.
  5. Mở liên kết kết nối. Đăng nhập bằng mã QR hoặc bằng số điện thoại và mã đăng nhập. Nhập mật khẩu xác minh hai bước nếu Telegram yêu cầu. Theo mặc định, hệ thống sẽ sử dụng kho thông tin đăng nhập API tích hợp sẵn, giống như trong không gian làm việc thông thường. Bạn có thể mở rộng phần thông tin đăng nhập tùy chỉnh (tùy chọn) và nhập cả hai api_id và api_hash từ my.telegram.org/apps. Để trống cả hai trường để sử dụng kho thông tin đăng nhập tích hợp sẵn; cặp thông tin không đầy đủ hoặc sai định dạng sẽ bị từ chối. Không cho phép nhập phiên làm việc. Chọn chế độ xuất và phạm vi. Liên kết kết nối chứa một khóa truy cập bí mật: hãy giữ bí mật thông tin này.
  6. Chọn Telegram Takeout, API Telegram thông thường hoặc Nhật ký sự kiện trò chuyện. Để xuất dữ liệu tài khoản, hãy chọn tất cả các cuộc trò chuyện có thể truy cập hoặc tải và chọn một hoặc nhiều cuộc trò chuyện, sau đó thiết lập ngày tháng, loại cuộc trò chuyện, danh mục tài khoản và quy tắc tệp đính kèm. Kiểm tra cài đặt và kích thước, tùy chọn lưu tệp JSON cài đặt cho người kiểm tra độc lập, sau đó nhấn Bắt đầu thu thập. Cài đặt sẽ được cố định sau khi bắt đầu. Chức năng Tiếp tục chỉ hoạt động khi trình chạy này còn tồn tại; việc kết thúc sớm sẽ giữ lại dữ liệu đã thu thập và ghi lại các khoảng trống. Hết hạn sau khi bắt đầu sẽ tạo ra một tập tin lưu trữ không đầy đủ; hết hạn trước khi bắt đầu hoặc hủy bỏ sẽ không tạo ra tập tin lưu trữ nào.
  7. Hãy đợi kết quả được niêm phong, tải xuống và giải nén, sau đó giải mã delivery.tgwsealed trong tệp trợ giúp. Bạn sẽ nhận được delivery.zip, chứa evidence.zip, attestation.jsonl, cùng với hướng dẫn. Việc giải mã bằng trình duyệt bị giới hạn ở 256 MiB; các gói dữ liệu lớn hơn hãy sử dụng lệnh truyền trực tiếp cục bộ bên dưới. Các kết quả có dung lượng lớn cũng bao gồm delivery-NNNNNN.tgwsealed các phần; phần chính delivery.tgwsealed sau đó chứa evidence.parts.json và chứng nhận. Tải xuống từng phần và ghép lại tại địa phương theo hướng dẫn dưới đây.
  8. Hãy kết thúc phiên làm việc tạm thời trong phần Cài đặt Telegram → Thiết bị nếu việc thu hồi quyền truy cập chưa được xác nhận hoặc quá trình chạy đã bị ngắt. Khi hoàn tất bình thường, hệ thống sẽ yêu cầu đăng xuất và quá trình chạy sẽ ghi lại liệu việc thu hồi quyền truy cập đã được xác nhận hay chưa.

Kho lưu trữ phải chứa các bản cam kết đã được xuất bản của nguồn được ghim và quy trình làm việc có thể tái sử dụng. Một nhánh cục bộ đơn lẻ không thể được gọi bởi một kho lưu trữ GitHub khác.

Thời lượng dự kiến của phiên#

Trước khi thu hồi, Tính toán thời gian và dung lượng ước tính lịch sử và các tệp đã chọn dựa trên số lượng tin nhắn và một mẫu có giới hạn. Màn hình hiển thị bao gồm thời gian đã dành cho việc đăng nhập, thời gian thu thập ước tính và thời gian dự phòng để đóng gói. Đối với các tệp, ước tính ban đầu dựa trên tốc độ 1 MiB/s và biên độ thời gian gấp đôi; khi quá trình tiến hành, giả định này sẽ được thay thế bằng tốc độ thực tế đã đo được. Sử dụng Chỉ tin nhắn hoặc chọn ít cuộc trò chuyện hơn khi thời gian ước tính vượt quá thời gian còn lại.

Thời gian chờ Takeout được báo cáo của Telegram được tính vào ngân sách. Trình thu thập sẽ ngừng quá trình thu thập khi thời gian còn lại cần dành cho việc đóng gói, lưu giữ dữ liệu đã thu thập và đánh dấu kết quả bán phần. Do đó, một phiên 120 phút sẽ sử dụng khoảng thời gian thu thập còn lại thay vì chờ đến hạn chót mới bắt đầu chuẩn bị kho lưu trữ. Màn hình hiển thị các mục đã chọn mà không thể lấy mẫu ở kích thước đầy đủ.

Chọn chế độ này hoặc một không gian làm việc cố định#

Chế độ chụp Phạm vi có thể tùy chỉnh Sự khác biệt
Telegram Takeout, tùy chọn mặc định Tất cả các cuộc trò chuyện trên đám mây có thể truy cập hoặc các cuộc trò chuyện đã chọn, ngày tháng, danh mục tài khoản, chính sách phương tiện truyền thông và chế độ xem JSON/HTML Sử dụng cơ chế xuất dữ liệu chính thức của Telegram; có thể cần phải được phê duyệt hoặc phải chờ đợi. Takeout có thể liệt kê các kênh/nhóm còn lại trong trường hợp Telegram cho phép và yêu cầu thêm dữ liệu cá nhân.
API Telegram thông thường Phạm vi tài khoản và các tùy chọn đầu ra tương tự, tùy thuộc vào các phương thức có sẵn thông qua API thông thường Không khởi tạo Takeout; không thể liệt kê các kênh bên trái/siêu nhóm hoặc truy xuất dữ liệu cá nhân chỉ có trên Takeout. Danh bạ chỉ bao gồm người dùng Telegram chứ không phải toàn bộ danh sách liên hệ đã lưu trên điện thoại. Giới hạn tốc độ vẫn được áp dụng.
Nhật ký sự kiện trò chuyện Một cuộc trò chuyện được chọn, các chính sách về tệp đính kèm và hình đại diện tùy chọn Ghi lại lịch sử và những thay đổi được quan sát thấy trong quá trình chạy này. Các danh mục tài khoản, bộ lọc theo ngày và chế độ xem tương thích với máy tính để bàn không áp dụng.

Cả ba chế độ này đều có cùng chứng nhận GitHub và tính năng truyền tải được mã hóa. Takeout chọn phương thức thu thập dữ liệu và không bao giờ bị thay thế một cách âm thầm bằng việc truy cập API thông thường. TgWitness tạo các bản xem JSON/HTML từ các bản ghi đã thu thập và giữ nguyên phương thức thu thập dữ liệu đã chọn trong tệp xuất. Xem API chính thức của Takeout.

Mặc định sẽ sử dụng Takeout, bao gồm tất cả các loại cuộc trò chuyện có thể truy cập (kể cả các cuộc trò chuyện đã lưu trữ), tất cả ngày tháng, hồ sơ tài khoản và danh bạ, các định dạng JSON và HTML tương thích, cũng như các tệp tải xuống. Dung lượng lưu trữ phương tiện ban đầu là 4 GiB, với các giới hạn tệp theo từng loại được hiển thị rõ ràng; đối với các tệp có dung lượng lớn hơn hoặc khi đã hết dung lượng tải xuống, hệ thống sẽ sử dụng các giá trị băm (hash) từ máy chủ nếu có sẵn. Vui lòng kiểm tra các giới hạn này trước khi tiến hành thu thập. Các giá trị băm không thể khôi phục lại tệp gốc. Các tùy chọn như ảnh, câu chuyện, siêu dữ liệu phiên và dữ liệu cá nhân bổ sung vẫn là các lựa chọn riêng biệt.

Việc lấy dữ liệu có thể cần được phê duyệt trong một phiên Telegram đã thiết lập sẵn. Telegram quy định thời gian chờ; việc đăng nhập mới hoặc trình chạy mới sẽ không thể bỏ qua thời gian này. Khoảng thời gian ghi lại tối đa là 120 phút, bao gồm cả quá trình đăng nhập và phê duyệt, do đó, đối với tài khoản có dung lượng lớn hoặc thời gian chờ phê duyệt kéo dài, quá trình này có thể không hoàn tất. Việc xuất dữ liệu cục bộ liên tục có thể tiếp tục cùng một phiên, nhưng không kế thừa chứng nhận từ GitHub.

Đồng ý và xác nhận các cài đặt#

Sau khi kiểm tra cài đặt và kích thước, hãy nhấn Lưu cài đặt để xác minh. Thống nhất kết quả sealed-export-settings.json với người đánh giá trước khi thu thập. Các thay đổi sẽ làm mất hiệu lực của bản đánh giá đã lưu. Người thu thập ký xác nhận các cài đặt có hiệu lực và mã SHA-256 của chúng, đồng thời các biên lai xuất tài khoản cũng ràng buộc các tùy chọn tương ứng. Người xác minh báo cáo chế độ thực tế, lựa chọn và tính đầy đủ, và từ chối bất kỳ sự không nhất quán nào giữa nhật ký và bản xuất tài khoản lồng nhau.

python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete

--expected-selection từ chối các phương thức truyền tải, phạm vi trò chuyện, bộ lọc hoặc chính sách tệp đính kèm khác. --require-complete chỉ chấp nhận các bản xuất tài khoản và nhật ký trò chuyện được ghi nhận là đã hoàn tất. Nếu không có các cờ này, quá trình xác minh vẫn kiểm tra nguồn gốc và tính toàn vẹn đồng thời báo cáo các cài đặt đã ghi lại và các lỗ hổng. Thống nhất lựa chọn dự kiến trước khi chạy và lưu trữ riêng biệt với kho lưu trữ. Phạm vi và khoảng thời gian thu thập xác định tài liệu được thu thập trong quá trình chạy; sử dụng các quan sát trước đó đã được lưu giữ khi so sánh với các phiên bản trước.

Yêu cầu Chế độ
Xuất dữ liệu tài khoản có thể truy cập hoặc các cuộc trò chuyện đã chọn trong một phiên làm việc có thời hạn và cung cấp cho người kiểm tra một bản lưu trữ đã được xác nhận bởi bên thứ ba GitHub Actions: Bản ghi lại (bản xem trước)
Theo dõi liên tục nhiều cuộc trò chuyện, quản lý tài khoản, tìm kiếm và đọc kho lưu trữ ngày càng mở rộng Không gian làm việc cục bộ hoặc Docker

Thao tác này sẽ bắt đầu một quá trình thu thập dữ liệu riêng biệt với thông tin đăng nhập mới. Quá trình này sẽ không tải lên nhật ký cục bộ hiện có của bạn, không xuất không gian làm việc đang mở, cũng như không tái sử dụng phiên Telegram của nó. Một quá trình thu thập dữ liệu trên đám mây chưa hoàn tất sẽ không thể tiếp tục sau khi trình chạy của nó bị hủy; một quy trình làm việc mới sẽ bắt đầu một quá trình thu thập dữ liệu mới.

Tính năng Exports → Open capture helper trong không gian làm việc sẽ mở trình hướng dẫn đầy đủ ngay trong bảng điều khiển. Trang độc lập cũng sử dụng cùng một trình hướng dẫn, các điều khiển và chủ đề. Cả hai đều lưu trữ khóa và quá trình giải mã trong trình duyệt của bạn. Quá trình khởi động quy trình làm việc GitHub và bảng điều khiển Telegram tạm thời sẽ mở trong các tab riêng biệt; trình hướng dẫn sẽ thông báo cho bạn biết khi nào cần quay lại. Việc khóa không gian làm việc sẽ xóa khóa đang được lưu trong bộ nhớ của trình hướng dẫn. Tệp khóa đã lưu của bạn vẫn được giữ lại trên thiết bị của bạn.

Điều gì là công khai, và điều gì phải được giữ riêng tư#

Quá trình thu thập dữ liệu được thực hiện trên một trình chạy tiêu chuẩn do GitHub lưu trữ. GitHub, trình thu thập dữ liệu đã được phê duyệt cùng các phụ thuộc, trang trợ giúp, trình duyệt và đường hầm HTTPS là những thành phần đáng tin cậy trong cấu hình này. Máy chủ tạm thời xử lý phiên Telegram và các tin nhắn dạng văn bản thuần túy; các sản phẩm được chuyển giao sẽ được mã hóa dành cho người nhận.

Việc tạo nhánh sẽ sao chép mã nguồn dự án vào kho lưu trữ của bạn. Quá trình này không xuất tài khoản Telegram của bạn. Dữ liệu đầu vào cho quy trình làm việc của người nhận là một khóa mã hóa công khai. Giữ sealed-key.json, thông tin đăng nhập Telegram, mã đăng nhập, mật khẩu 2FA và URL kết nối đã được giải mã khỏi các commit, đầu vào quy trình làm việc và nhật ký công khai.

Quy trình làm việc này sẽ công bố các thành phần kết nối/kết quả đã được mã hóa trong vòng một ngày. Hãy tải cả hai xuống kịp thời; các điều kiện về tính khả dụng của GitHub Actions, giới hạn tài khoản và thanh toán sẽ được áp dụng. Việc tạo bản phân nhánh công khai không đồng nghĩa với việc được đảm bảo sử dụng tài nguyên tính toán miễn phí không giới hạn. Không có khoản thanh toán nào hoặc mã thông báo truy cập GitHub nào được nhập vào công cụ hỗ trợ.

Khóa giải mã riêng tư được lưu trữ trong trình duyệt/tệp của bạn. Dữ liệu phiên Telegram và các quan sát dưới dạng văn bản thuần túy nhất thiết phải tồn tại bên trong bộ thu thập tạm thời. GitHub và đường hầm HTTPS vẫn là cơ sở hạ tầng đáng tin cậy. Chứng thực có thể công khai bản tóm tắt lưu trữ và danh tính quy trình làm việc; nội dung lưu trữ không được đưa vào chứng thực. Dấu thời gian của chứng thực không phải là dấu thời gian của tin nhắn.

Khắc phục sự cố#

Triệu chứng Bước tiếp theo
Không Chạy quy trình công việc nút Hãy tạo nhánh riêng của bạn, kích hoạt tính năng Actions và đồng bộ hóa nó với nhánh nguồn main. Không được chỉnh sửa các pin đã được phê duyệt từ nguồn chính để vượt qua lỗi.
Không sealed-connection vật phẩm Kiểm tra xem tác vụ đã bắt đầu và hoàn tất bước khởi động/tải lên hay chưa. Các sự cố liên quan đến hàng đợi, trình chạy, tải xuống hình ảnh, đường hầm hoặc chính sách kho lưu trữ có thể khiến quá trình khởi động bị gián đoạn.
Không thể thiết lập kết nối Tải khóa đã lưu cho lần chạy này, giải nén tệp đã tải xuống và chọn connection.tgwsealed. Trình chạy vẫn phải đang hoạt động.
Lịch sử đang tạm dừng Kiểm tra trạng thái của bảng điều khiển và sử dụng tính năng “Tiếp tục” khi phiên làm việc vẫn còn hoạt động, hoặc kết thúc với dữ liệu đã thu thập được. Các giới hạn của Telegram và nội dung không thể truy cập có thể gây ra những khoảng trống.
Không sealed-result Việc hủy bỏ hoặc hết hạn trước khi bắt đầu thu thập sẽ không tạo ra tệp lưu trữ; quá trình đó sẽ kết thúc với thông báo Không có tệp lưu trữ. Một bước thu thập, xác nhận hoặc đóng gói không thành công cũng sẽ ngăn cản việc giao hàng; bước không thành công sẽ nêu rõ lý do của người giám sát mà không bao gồm dữ liệu cá nhân. Kiểm tra thông tin này mà không cần đăng nhập bằng thông tin xác thực.
Trình duyệt không thể giải mã một tệp lưu trữ có dung lượng lớn Hãy sử dụng CLI streaming dưới đây cho các gói có dung lượng lớn hơn 256 MiB. Nếu khóa riêng bị sai hoặc bị mất, kết quả sẽ không thể được giải mã.
Quá trình xác minh từ chối người ký Hãy sử dụng một bản cài đặt TgWitness đáng tin cậy và mới nhất cùng với tệp caller chính xác OWNER/REPOSITORY. Không chấp nhận chính sách thay thế đi kèm với tệp lưu trữ.
Telegram vẫn hiển thị phiên làm việc tạm thời Hãy kết thúc quá trình này tại Cài đặt → Thiết bị. Quá trình đăng xuất có thể không thành công và quy trình làm việc bị buộc dừng có thể không thực hiện được việc dọn dẹp.

Trước khi dựa vào bản xem trước này, hãy thử một cuộc trò chuyện nhỏ do bạn kiểm soát: tạo một tin nhắn và tệp đính kèm, thu thập chúng, giải mã kết quả, chạy trình xác minh, kiểm tra kết quả về phạm vi bảo mật/phương tiện truyền thông và xác nhận việc thu hồi phiên Telegram. Các kiểm tra tự động sử dụng một ứng dụng Telegram mô phỏng cùng với một bài kiểm tra chứng chỉ GitHub thực tế riêng biệt; chưa có bất kỳ lần chạy nào trên tài khoản thực với phiên bản hiện tại được ghi nhận.

Giải mã và xác minh tại chỗ#

Hãy sử dụng các công cụ từ một nguồn cài đặt đáng tin cậy và độc lập, chứ không phải các tệp thực thi được cung cấp từ một kho lưu trữ bằng chứng không rõ nguồn gốc:

python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip
# Unzip delivery.zip using your archive manager, then:
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness

Đối với việc phân phối nhiều phần, hãy giải mã gói chính trước tiên và giữ tệp manifest đã giải nén của gói đó bên cạnh mỗi phần được mã hóa, sau đó chạy lệnh:

python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip
python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness

Bản kê khai là đối tượng được xác thực và liên kết mọi phần cũng như tệp ZIP đã nén. Sử dụng --max-gib để đặt giới hạn xác minh sau khi giải nén phù hợp cho một tập tin lưu trữ lớn; giá trị mặc định là 4 GiB. Các kiểm tra "expected-selection" và "complete-scope" cũng hoạt động với việc truyền tải nhiều phần.

Python 3.11 trở lên, các phụ thuộc của dự án và phiên bản GitHub CLI mới nhất hỗ trợ --signer-digest và --deny-self-hosted-runners là bắt buộc. Một công cụ tạo khóa CLI cũng có sẵn: python -m tgwitness.sealed_crypto keygen sealed-key.json.

Trình xác minh sử dụng tgwitness/sealed_policy.json từ bản cài đặt đáng tin cậy. Nó kiểm tra kho lưu trữ của người gọi, quy trình ký của bên nguồn, cam kết của người ký được phê duyệt, yêu cầu về trình chạy được lưu trữ, bản tóm tắt ZIP đầy đủ, nhật ký nội bộ và tính toàn vẹn của tệp đính kèm, nguồn khóa tài khoản mới nhất, và cam kết của bộ thu thập như dự kiến. Nó hiển thị lịch sử và kết quả phương tiện thay vì ngụ ý rằng tất cả dữ liệu đã được lưu trữ. Danh sách bản phát hành được phê duyệt trống sẽ bị từ chối. Việc cập nhật chính sách là một quyết định tin cậy rõ ràng; tuyệt đối không tự động chấp nhận chính sách do chính kho lưu trữ đề xuất.

Để sử dụng ngoại tuyến, hãy lấy các khóa gốc đáng tin cậy từ trước từ một môi trường đáng tin cậy:

gh attestation trusted-root > trusted_root.jsonl
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl

Dấu thời gian của chứng nhận liên quan đến cam kết của kho lưu trữ. Nó không xác thực dấu thời gian của tin nhắn hay đồng hồ thực tế của người thu thập. Xem các tùy chọn xác minh của GitHub.

Cách giữ fork nằm ngoài quá trình capture#

Lệnh gọi chứa một tham chiếu cấp công việc đến quy trình làm việc có thể tái sử dụng ở phía thượng nguồn tại một SHA cam kết đầy đủ. Quy trình làm việc đó thực hiện việc kiểm tra mã nguồn từ kho lưu trữ phía thượng nguồn tại một SHA cố định của bộ thu thập. Một quy trình làm việc mặc định actions/checkout trong quy trình làm việc có thể tái sử dụng sẽ kiểm tra mã nguồn của đối tượng gọi và được thiết kế để không được sử dụng.

Quy trình làm việc này không khôi phục bộ nhớ đệm của bên gọi, không sử dụng các thành phần của bên gọi, không thực thi các tệp của bên gọi, cũng như không chấp nhận các URL nguồn/hình ảnh, lệnh shell, tệp ZIP đã chuẩn bị sẵn, hoặc các giá trị băm để ký. Quy trình này chỉ chấp nhận người nhận công khai được giới hạn và thời lượng phiên làm việc. Các hành động, hình ảnh cơ sở Python và các thành phần được Cloudflare tùy chỉnh được cố định bằng các giá trị băm bất biến; các phụ thuộc Python sử dụng các yêu cầu đã được khóa bằng băm sẵn có. Hình ảnh được xây dựng từ nguồn đáng tin cậy mà không sử dụng bộ nhớ đệm.

Trình thu thập chạy với tư cách người dùng không phải root, sử dụng hình ảnh chỉ đọc, đã vô hiệu hóa các khả năng của Linux, có giới hạn tài nguyên và không có môi trường socket Docker hay token GitHub. Các thư mục được gắn duy nhất của nó là thư mục cấu hình mới, thư mục không gian làm việc và thư mục đầu ra. Ứng dụng FastAPI bị hạn chế này cung cấp các chức năng đăng nhập, hộp thoại, tài khoản có thể cấu hình hoặc thu thập tin nhắn trò chuyện, trạng thái, tiếp tục, hoàn tất và hủy bỏ. Không có đường dẫn tải xuống dưới dạng văn bản thuần túy, đường dẫn quản trị chung, đường dẫn nhập dữ liệu hoặc điểm cuối ký tên.

Người giám sát dừng các container kết nối mạng trước khi thao tác xác nhận đọc bản sửa lỗi cuối cùng evidence.zip hoặc evidence.parts.json. Container đóng gói không có kết nối mạng. Các bước tải lên chỉ có tên connection.tgwsealed và delivery*.tgwsealed; cả bằng chứng văn bản thuần túy lẫn thông tin đăng nhập Telegram đều không được tải lên dưới dạng sản phẩm. Quá trình dọn dẹp sẽ xóa các thư mục và container riêng tư, và GitHub sẽ loại bỏ máy ảo runner được lưu trữ sau khi công việc hoàn tất. Thời gian lưu giữ sản phẩm là một ngày; hãy tải xuống trước khi hết hạn.

Chủ sở hữu nhánh có thể thay thế người gọi hoặc tạo một tệp đã ký khác. Hệ thống kiểm tra nghiêm ngặt phải từ chối quy trình làm việc/bản tóm tắt của người ký khác thu được. Cơ chế này vẫn phụ thuộc vào việc không có lỗ hổng có thể bị khai thác trong mã nguồn đã được phê duyệt cũng như vào tính toàn vẹn của trình chạy và cơ sở hạ tầng ký của GitHub.

Chuyển giao mật mã#

Mỗi khóa người nhận là RSA-3072 (cũng chấp nhận các khóa RSA-4096 được nhập vào), số mũ 65537. Mỗi lớp bọc có một khóa AES-256 ngẫu nhiên mới và giá trị nonce 96 bit. RSA-OAEP với SHA-256/MGF1-SHA256 bao bọc khóa AES. AES-GCM với thẻ 128-bit xác thực toàn bộ tiền tố và tải trọng. Khóa công khai của người nhận là DER SPKI ở định dạng base64; tệp khóa riêng chứa DER PKCS8 ở định dạng base64.

Các byte của phần bao gồm TGWSEAL1\n, độ dài tiêu đề JSON dạng uint32 theo định dạng big-endian, tiêu đề, văn bản mã hóa và thẻ GCM 16 byte. Tiêu đề có chính xác algorithm, key, và nonce; thuật toán là RSA-OAEP-256+A256GCM. Tiền tố hoàn chỉnh trong tiêu đề là dữ liệu xác thực bổ sung của GCM. Kích thước tiêu đề được giới hạn ở 8192 byte. CLI truyền tải dữ liệu có dung lượng lên đến 8 GiB và thực hiện xác thực trước khi ghi kết quả được yêu cầu; nó từ chối ghi đè lên đích đã tồn tại. Đây là một lớp bao bọc dành riêng cho dự án xung quanh các nguyên thủy mật mã tiêu chuẩn: RSA-OAEP với SHA-256 và AES-256-GCM, có sẵn trong OpenSSL và mọi thư viện mật mã chính.

Các byte bằng chứng gốc được xác thực trước khi đưa bằng chứng và chứng nhận vào gói bên ngoài đã được mã hóa. Điều này giúp tránh sự phụ thuộc tuần hoàn giữa hàm băm của kho lưu trữ và chứng chỉ được bao gồm bên trong chính kho lưu trữ đó. Đối với các kho lưu trữ công khai, siêu dữ liệu xác thực (kho lưu trữ, quy trình làm việc, lần cam kết, tên thành phẩm và bản tóm tắt) là công khai. Tuyệt đối không được đưa tên người dùng vào siêu dữ liệu công khai.

Phạm vi và việc xác thực#

Chế độ này sử dụng nhật ký có chữ ký và bộ máy xuất dữ liệu tài khoản. Các cuộc trò chuyện bí mật, lịch sử đã xóa trước thời điểm thu thập và dữ liệu mà tài khoản không thể truy cập được sẽ bị loại trừ. Các cuộc trò chuyện trên đám mây riêng sẽ được tính vào nếu được chọn. Trình chọn cuộc trò chuyện được giới hạn ở 20.000 cuộc đối thoại; quá trình xuất tài khoản sẽ tự động xác định khối lượng dữ liệu của chính nó. Dữ liệu thiếu, tệp bị lỗi và các tác vụ chưa hoàn thành sẽ được ghi lại. Các giới hạn về tệp đính kèm cũng như giới hạn dung lượng đĩa và thời gian của trình chạy vẫn được áp dụng. Việc gửi dữ liệu lớn sử dụng các phần được mã hóa thay vì giới hạn gửi cố định 4 GiB. Hoàn thành có nghĩa là các tác vụ đã chọn bị đóng băng đã kết thúc, không phải là mọi bản ghi lịch sử của Telegram đều tồn tại trong kho lưu trữ. Nhật ký trò chuyện cũng có thể theo dõi các cập nhật trực tiếp; không có chế độ nào là bản chụp nhanh nguyên tử. Ảnh chụp màn hình và bản ghi màn hình được tạo ra không thuộc phạm vi của chế độ này.

Các bài kiểm tra bao gồm đăng nhập mới mô phỏng, cách ly phạm vi, phương tiện truyền thông, hủy bỏ, hoàn thành một phần hạn chót, đăng xuất thất bại, các đường dẫn và trường API bị cấm, từ chối không gian làm việc được tải sẵn, từ chối do khóa sai và can thiệp, các cờ xác thực bắt buộc, và khả năng tương tác mã hóa giữa trình duyệt và Python. Bài kiểm tra chấp nhận trình duyệt sử dụng một chứng nhận giả được ghi nhãn rõ ràng; đây không phải là bài kiểm tra Sigstore thực tế. Các bài kiểm tra thực tế trên máy chủ lưu trữ, Docker, chứng thực GitHub và kiểm tra chấp nhận Telegram trực tiếp phải được báo cáo riêng biệt với các kiểm tra tổng hợp cục bộ.

Các điều khoản của GitHub Actions giới hạn việc sử dụng các runner được lưu trữ trong phạm vi vòng đời của dự án phần mềm. Việc tạo nhánh (fork) không loại bỏ các hạn chế này; bản xem trước này không được quảng bá là dịch vụ lưu trữ sản xuất miễn phí không giới hạn. Cloudflare Quick Tunnels cũng được thiết kế dành cho mục đích thử nghiệm và phát triển. Các tệp helper/workflow phù hợp để đánh giá tính năng này; việc đáp ứng các điều kiện cho dịch vụ sản xuất vẫn là một yêu cầu triển khai riêng biệt.

Quy trình phát hành của người duy trì#

  1. Ghi lại và kiểm tra các thành phần thu thập dữ liệu, trình giám sát, định nghĩa vùng chứa và các bài kiểm thử.
  2. Ghim bản cam kết của bộ thu thập vào sealed-collector.yml, sau đó thực hiện commit/kiểm duyệt quy trình làm việc có thể tái sử dụng. Không bao giờ tự động lấy mã nguồn từ SHA của người gọi một cách im lặng.
  3. Ghim bản cam kết quy trình làm việc có thể tái sử dụng vào sealed-witness.yml và thêm cặp SHA của workflow/collector vào sealed_policy.json trong một bản phát hành đáng tin cậy.
  4. Xuất bản tất cả các commit được tham chiếu và hàm trợ giúp, sau đó kiểm thử một nhánh fork độc lập và chứng chỉ GitHub thực tế. Không được gộp các commit được tham chiếu bởi các điểm neo này trừ khi các tham chiếu đó được tạo lại và xuất bản lần nữa.

Xem các quy trình làm việc có thể tái sử dụng và các xác nhận để hiểu rõ sự khác biệt giữa kho lưu trữ của bên gọi và bên ký ở phía thượng nguồn.