# Формат архива доказательств Telegram и проверка

Canonical page: https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/

Содержимое подписанного ZIP-архива, типы записей, подтверждения обработки, профили пользователей, внешние копии и офлайн-проверка.

[Project context and measured scale](https://phishdestroy.io/tgwitness/ru/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/ru/llms.txt)

Translation coverage: this edition includes material from the English original.

Содержимое подписанного ZIP-архива, типы записей, подтверждения обработки, профили пользователей, внешние копии и офлайн-проверка.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документация](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Доказательства и верификация](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

TgWitness сохраняет видимые для учетной записи наблюдения Telegram в подписанном журнале. Получатели могут проверить сохраненные записи, вложения и отчеты по доверенному ключу сборщика, проверить внешнее время от третьей стороны для последней записи и сравнить журнал с контрольной точкой, которую они сохранили ранее. На этой странице описаны форматы, проверки и материалы, которые необходимо сохранить для передачи.

Пользователи могут начать с запуска **VERIFY.cmd** в Windows: программа запросит исходный архив ZIP и независимо полученный отпечаток ключа, отобразит результат с пояснениями и сохранит отдельный отчёт о проверке. См. программы запуска [verification и портативную среду выполнения](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md) для настройки и ограничений доверия.

**На этой странице**

- [Что подписано](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#what-is-signed)
- [Сравнение экспортов чатов](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#comparing-chat-exports)
- [Передача дела на расследование](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#investigation-handoff)
- [Выдержка из передачи](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#handover-extract)
- [Удобные для чтения отчёты](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#readable-reports)
- [Канонизация событий](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#event-canonicalization)
- [Семантика акторов](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#actor-semantics)
- [Охват: непрерывность, пробелы и ненаблюдаемые идентификаторы](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)
- [Производитель](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#producer)
- [Профили людей](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#people-profiles)
- [Независимый свидетель](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#independent-witness)
- [Манифест и контрольные точки](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#manifest-and-checkpoints)
- [Область применения верификации](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#verification-scope)
- [Вложения](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#attachments)
- [Надежный сбор и обработка квитанций (0.2)](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#durable-collection-and-process-receipts-02)
- [Подготовка RFC 3161 и проверка ответов (0.2)](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)
- [Дополнительные записи в режиме сбора доказательств: drand и устройства Telegram](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)

## Что подлежит подписанию

| Материалы | Защита | Что следует сохранять |
| --- | --- | --- |
| Каждая запись в журнале, включая оперативные события | Цепочка SHA-256 и подпись Ed25519 для каждого события | Исходный `events.jsonl` — отпечаток доверенного ключа — и сохраненная контрольная точка |
| Содержимое ZIP-архива с доказательствами | `manifest.sig` подписывает канонический манифест, в котором перечислены хэши файлов с содержимым | Полный ZIP-архив, включая манифест и подпись |
| Сохраненные вложения | SHA-256 и количество байтов в подписанном событии `media.saved`; хеш файла в подписанном манифесте ZIP | Исходные байты внутри проверенного ZIP-архива |
| Контрольная точка | Подпись Ed25519, охватывающая длину журнала, хеш заголовка, открытый ключ и время создания | Независимая копия, сохраненная до внесения спорного изменения |
| Квитанция об отправке | Подписанная запись о версии сборщика, хешах исходных файлов и начальных настройках, также включенная в `process.started` | Квитанция, соответствующая журнальная запись и доказательства состояния среды для выбранного режима проверки |
| Удобные для чтения отчеты: `report.html` и его части: `report.json`, `report.pdf`, `chat.pdf` | Печать Ed25519 на каждом файле, подтверждающая его содержание; файл PDF также содержит стандартную подпись PDF (см. [Readable reports](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#readable-reports)) | Полученный файл и отпечаток доверенного ключа; ZIP-архив, описанный в документе |
| Автономный CSV | Отсутствие автономной криптографической подписи; одних только хешей событий недостаточно | Для проверки целостности используйте точную копию, содержащуюся в проверенном ZIP-файле |
| Скриншоты, распечатки или PDF-файлы, сгенерированные браузером | В производном материале не должно быть упоминания о TgWitness | Сохраните исходный проверенный пакет и задокументируйте процесс создания производного файла |

Коллектор проверяет подписи журнала перед генерацией каждого формата экспорта. Удобные для чтения отчеты в форматах HTML и PDF имеют собственные печати; автономный файл CSV проверяется как часть подписанного ZIP-архива. Сохраните ZIP-архив, чтобы сохранить байты вложений и манифест, а также отдельную контрольную точку для сверки журнала с более ранней границей.

## Форматы и пути верификации

Режим сбора и формат вывода отвечают на разные вопросы. Режим предоставляет доказательства сбора и окружающей среды; каждый формат сохраняет или представляет часть этой записи с учётом приведённых ниже проверок.

| Результат | Верификация и использование |
| --- | --- |
| Доказательства ZIP | Канонические события, подписанный манифест, охват, записи о хранении, вложения и доступные внешние квитанции; проверьте архив и выбранный режим его получения. |
| Контейнер ASiC-E | Архив ZIP с доказательствами в виде контейнера ETSI ASiC-E (EN 319 162-1) с записью о типе MIME (`mimetype`) и файлом `META-INF/ASiCManifest.xml`, подписанный с помощью CAdES собственным сертификатом рабочей среды на уровне B-B или B-T, если включена функция временной маркировки. Такие валидаторы, как EU DSS, проверяют формат и целостность и, поскольку сертификат выдан самостоятельно, сообщают об отсутствии опорного пункта доверия. EU DSS 6.3 с настройками по умолчанию отклоняет контейнер, содержащий более 1000 файлов («Обнаружено слишком много файлов»). `verify.py` проверяет манифест Ed25519 и каждый указанный в нём файл, значения SHA-256 в файле `META-INF/ASiCManifest.xml`, а также в добавленном файле `ASiCManifestNNN.xml` или `ASiCEvidenceRecordManifest.xml`, и выдает ошибку при обнаружении записи в `META-INF/`, не охваченной ни одним из них. Он не проверяет подписи CAdES и сообщает об этом. |
| Отчёты в форматах HTML и JSON | Отдельно запечатанные представления со ссылками на источники, также перечисленные в манифесте ZIP. Их зарегистрированные подсчёты обобщают типы событий журнала. |
| Отчёты в формате PDF | Печать Ed25519 плюс базовая PDF-подпись PAdES для диапазона байтов: B-B или B-T с временной меткой подписи, если функция временной метки включена. Программа проверки TgWitness использует доверенный ключ Ed25519; отображение доверия к сертификату в программе просмотра представляет собой отдельную проверку. |
| CSV | Представление в виде электронной таблицы, охватываемое манифестом ZIP. Экранирование формул обеспечивает безопасность использования электронной таблицы; исходный подписанный текст остается в журнале. |
| JSONL | Подписанные записи событий, включая ссылки на вложения. ZIP-архив с доказательствами дополнительно содержит сохраненные байты вложений. |
| Экспорт чатов и представления, совместимые с Desktop | Сбор истории и доступных записей журнала администратора с требуемым отображением и подписанным архивом. Сохраненные версии мониторинга в реальном времени представляют собой отдельный путь сбора данных. |
| Медиафайлы и записи, содержащие только хэши | Сохраненные байты сверяются с их SHA-256 и ссылкой на сообщение. Сбор только хешей позволяет сохранить доступные метаданные хешей для последующего сравнения с байтами файла. |
| STIX/MISP и профили людей | Извлечённые наблюдения со ссылками на источники, идентификаторы учётных записей и аналитические совпадения. Сигнатуры профилей и хеши записей можно сверять с исходными доказательствами; происхождение кэша аватаров маркируется отдельно. |
| Выдержка из протокола передачи дел | Подписанные правила раскрытия, неизменённые записи и помеченные минимизированные записи, сохраняющие исходные хэши/подписи. Используйте сохраненный оригинал для сравнения, требующего скрытых полей. |
| Свидетель и временные квитанции | Ранние границы журнала, непрерывность и отдельные проверенные временные заявки. Они сопровождают проверки сбора данных и архива. |
| Доставка с защитой паролем | Обеспечивает защиту вложенного пакета во время передачи. `.tgwpw` использует шифрование с аутентификацией по алгоритму AES-GCM, включая аутентифицированную заключительную запись; вложенный журнал сохраняет свои подписи и квитанции о получении. |

Распечатка или снимок экрана — это представление подписанного материала. Его идентификатор отчета, отпечаток ключа и QR-ссылка помогают найти исходный файл для проверки. Декларации о хранении фиксируют информацию о назначенном эксперте и передаче данных; результаты проверки и квитанции о получении хранятся в качестве отдельных доказательств.

### Внешние подписи

Подпись также может быть получена с помощью ключа, которым TgWitness никогда не располагает, например, квалифицированной электронной подписи следователя или печати организации. На **Экспорт**, **Внешняя подпись** при подготовленном экспорте без пароля выдает байты для подписи: новый `META-INF/ASiCManifestNNN.xml` перечисление всех файлов с указанием их SHA-256 для контейнера ASiC-E или экспорта `manifest.json` для ZIP-архива. Подписывающий возвращает CMS (CAdES) `.p7s`, отдельно или с встроенным содержимым.

TgWitness проверяет, что подпись охватывает именно эти байты, и проводит верификацию с помощью сертификата подписавшего лица (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). Цепочка проверяется только по корневым сертификатам, предоставленным оператором; отзыв, списки доверенных сертификатов и квалифицированный статус не проверяются. На панели отображается одно состояние для каждой подписи: ожидание подписи, прикреплена и не проверена, проверена, алгоритм не поддерживается, подпись недействительна, подписанные байты не совпадают или сертификат не входит в цепочку, ведущую к предоставленному корневому сертификату. Изменение экспорта после выдачи байтов приводит к установке для всех его подписей состояния «подписанные байты не совпадают».

**При загрузке с подписями** подписи и их манифесты добавляются в папку `META-INF` в контейнер ASiC-E. В случае ZIP-архива он помещает неизменённый ZIP-архив, `.p7s` файлы и `SIGNATURES.txt` в внешний ZIP-файл. Недопустимые подписи и подписи, наложенные на другие байты, исключаются. Подпись с алгоритмом, который TgWitness не может проверить, включается; панель отображает её состояние, как и `SIGNATURES.txt` в случае ZIP-архива.

### Изображения из чата с подписями

**Скачивание ZIP-файла с подписью** в окне предварительного просмотра изображения позволяет сохранить страницы в формате PNG, `pages.sig.json` и `README.txt`. Каждая страница заканчивается номерами записей журнала, которые на ней отображаются, текстом чата, временем рендеринга, отпечатком ключа рабочей области и командой, которая его проверяет. Панель отправляет только SHA-256 и номера записей каждой страницы; сервер подтверждает, что записи относятся к данному чату, подписывает заявление (`tgwitness-image-attestation-v1`) с помощью ключа рабочей области и фиксирует подписание в журнале как `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
```

Верификатор проверяет подпись, сопоставляет каждый файл PNG с подписанной страницей и выводит отпечаток ключа. `--fingerprint` Сравнивает подписавшего с отпечатком ключа, полученным от отправителя независимо. `--evidence` считывает ZIP-архив подписанных доказательств из той же рабочей области и требует, чтобы каждая запись изображений присутствовала с тем же хешем. Измененный пиксель, измененное утверждение или другой ключ приводят к сбою проверки. Изображения показывают сохраненные записи в собственном формате TgWitness; они не отображают то, что Telegram показывал кому-либо.

## Сравнение экспортов чатов

Проверить и сравнить два подписанных ZIP-файла с экспортом чата с независимо сохраненными отпечатками подписывающих:

```
python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256
```

Параметры `--require` и `--require-tier` не допускаются к использованию вместе с `--compare`; проверьте требуемый профиль каждого архива с помощью соответствующей проверки.

Если в обоих архивах зафиксированы одинаковые числовые идентификаторы аккаунта и чата, записи сопоставляются по идентификатору сообщения. **Unchanged** означает совпадение полной сохраненной записи JSON: полный текст, автор, даты, адресат ответа, вложенные метаданные и неизвестные поля — всё это включено. Порядок ключей в объекте JSON не имеет значения; значение имеют отсутствующие поля, нулевые значения, типы значений и порядок массивов. Предварительный просмотр из 300 символов предназначен только для отображения. Изменённые записи указывают отличающиеся элементы верхнего уровня `changed_fields`, включая изменения, невидимые в этом предварительном просмотре. Дубликаты идентификаторов сообщений отбрасываются, а не перезаписывают друг друга при сопоставлении.

Разница может заключаться в изменении отображаемого имени, количества просмотров, аннотации коллекции или других метаданных наблюдения. Редактирования в Telegram отображаются как отдельные события редактирования, а проверка каждого архива показывает, является ли данный архив целостным. Непроанализированные записи остаются в сравнении и сравниваются по их сохраненному представлению.

В случае несовпадения или отсутствия идентификаторов учётной записи/чата инструмент находит возможные соответствия, используя отправителя, полный текст, хеш файла, тип медиафайла и пятисекундный допуск по времени, и отмечает их как **Совпавшие (Matched),** а не как **Неизменённые (Unchanged)**. Непроанализированные записи остаются без сопоставления. Различия в сопоставленных записях перечисляются в `changed`, в том числе в режиме содержимого. При использовании `--json` `matched` подсчитывает потенциальные пары, а `unchanged` — пары, полные сохраненные записи которых совпадают. Существующий вывод `changed_fields` и целочисленный `unchanged` остаются совместимыми с ранее полученными результатами сравнения. Формат архива и проверка подписи остаются без изменений.

## Передача расследования

1. Запишите номер дела, имя оператора, цифровой идентификатор аккаунта Telegram, выбранные источники, политику сбора данных и период сбора в заметках по делу. TgWitness сохраняет наблюдения и поддерживает привязанные к источникам заметки и сбор данных в [Case Board](https://phishdestroy.io/tgwitness/ru/docs/reference/case-board/). Храните записи о передаче и хранении вместе с материалами по делу . Проверьте настройки сбора данных с помощью [процедуры приёма в режиме реального времени](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md).
2. Перед тем как полагаться на экспортированные данные, независимо сохраните отпечаток открытого ключа рабочей области. Оставьте режим подтверждения включенным (по умолчанию), чтобы контрольные точки получали квитанции в соответствии с RFC 3161 и OpenTimestamps. Во время сбора данных сохраняйте подписанные контрольные точки вне коллектора. Регистрируйте прерывания и ограничения видимости учетной записи.
3. Экспортируйте **подписанный ZIP**-файл и сохраните подписанную квитанцию о запуске. Используйте контрольную точку, расположенную на границе экспортируемого журнала или перед ней. Более поздняя контрольная точка может правильно отклонить более ранний экспорт как слишком короткий. Экспорт включает полный журнал рабочей области, независимо от фильтров панели; ознакомьтесь с материалом перед его передачей.
4. Попросите получателя проверить ZIP-архив с помощью доверенной копии верификатора, независимо предоставленного отпечатка и корневого сертификата службы меток времени, полученного отдельно. Из доверенной среды с активной средой Python :

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence
   ```

   Отпечаток и проверенная временная метка последней записи соответствуют минимальным требованиям к доказательствам; в противном случае при использовании параметра `--require evidence` программа завершает работу с кодом 2. Контрольная точка является подтверждающей проверкой, поскольку она подписана ключом сборщика. Успешный вывод сообщает `key_pinned: true` и `checkpoint_checked: true`, если оба входных параметра заданы и приняты. Сохраните результат проверки.

   ```
   For a handover requiring the final exported record to be witnessed, use
   `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
   This refuses an export with an unwitnessed tail. Add
   `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
   witness posts as external time. See the
   [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
   ```

   1. Запишите SHA-256 архива, границу экспорта, дату передачи, отправителя и получателя в вашу запись о хранении. Сохраняйте исходный пакет в неизменном виде и работайте с копиями. Делитесь файлами доказательств, а не каталогом личных данных приложения, который также содержит сессии учетных записей и секретные ключи подписи. Для передачи выберите защищенный паролем ZIP-архив с шифрованием AES-256 или более надежный контейнер `.tgwpw` . ZIP использует недорогую схему вычисления пароля WinZip; используйте длинную случайную парольную фразу. `.tgwpw` использует scrypt и AES-256-GCM и открывается с помощью автономной команды верификатора `unseal-password`. Пароль не сохраняется и служит только для защиты конфиденциальности; получатель расшифровывает архив и проверяет подписанный экспорт внутри, который остаётся неизменным.
   2. Чтобы проставить временную метку на контрольной точке вне режима доказательств, следуйте [процедуре RFC 3161](https://phishdestroy.io/tgwitness/ru/docs/reference/timestamp/) и сохраните запрос, контрольную точку, информацию о доверенном ЦС и проверенный ответ службы меток времени. Сама по себе подготовка запроса не обеспечивает получение временной метки.

Для файла `.tgwpw` используйте независимо полученный верификатор и выберите новый выходной файл с исходным расширением: `python verify.py unseal-password export.tgwpw --out evidence.zip`. Команда запрашивает пароль; параметр `--password-stdin` считывает одну строку для автоматизации. Она никогда не перезаписывает существующий файл и публикует открытый текст только после аутентификации всех записей. После этого выполните обычную проверку подписи на расшифрованном файле. Контейнер использует scrypt (`N=131072`, `r=8`, `p=1`, соль длиной 16 байт; около 128 MiB ОЗУ) и AES-256-GCM с записями размером 1 MiB и аутентифицированной конечной записью. Зашифрованная запись метаданных хранит внутреннее имя файла, поэтому загруженные контейнеры можно переименовывать.

Успешная верификация подтверждает целостность относительно доверенного ключа сборщика и сохраненных границ. См. [раздел «Объем верификации»](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#verification-scope) для ознакомления с допущениями о доверии и [результатами проверки](https://phishdestroy.io/tgwitness/ru/docs/reference/verification/) выполненных тестов.

## Выдержка из протокола передачи дел

Подписанный ZIP-файл содержит полный журнал рабочей области. Если суду, адвокату или службе по борьбе со злоупотреблениями требуются только отдельные чаты, определенный период или конкретные участники, **функция «Экспорт → Выдача выдержки»** подготавливает сокращенную копию (`tgwitness-handover-v1`) в соответствии с выбранными правилами раскрытия информации. Оператор указывает цель и выбирает чаты, опциональный период (UTC), участников, к которым относится выдержка, а также определяет, что происходит с остальными участниками (отображаются, заменяются псевдонимами P01, P02… или исключены из отчета), какие тексты сообщений сохраняются, какие вложения и фотографии профилей включаются, а также маскируются ли номера телефонов и адреса электронной почты в текстах. Цель и эти правила указаны в подписанном манифесте и в отчёте; в журнале регистрируется запись «`handover.exported`» с указанием доступа, который её подготовил, и SHA-256 файла, а не его содержимого.

Скрипт `verify.py` проверяет выдержку двумя способами. Запись, обозначенная как неизменённая, проверяется полностью: её содержимое сравнивается с хешем, проверяется подпись Ed25519 и ссылка на включённую предшествующую запись. В сокращённой записи сохраняются исходный хеш и подпись, поэтому подпись по-прежнему проходит проверку, но утаенные поля не могут быть пересчитаны на её основе; в записи указывается, что именно было утаено, и в отчёте это отмечается. Записи об обслуживании всего аккаунта (запуски и остановки, пробелы в охвате, уведомления о подключении, сети и хранилище, изменения области действия и настроек) сохраняют только поля, указанные для их типа: списки чатов в них сокращаются до выбранных чатов, а их итоговые значения пересчитываются; при пропуске в результате проверки в реальном времени чата, не входящего в выборку, этот чат, номера его сообщений и учетная запись свидетеля теряются; в выбранном для проверки чате учетная запись свидетеля заменяется его псевдонимом, если только не отображаются все участники или он не является одним из выбранных лиц. Манифест указывает длину журнала и его начало с подписью сборщика над этим началом, а также подсчитывает количество пропущенных записей; файл ``coverage.json`` описывает выбранные чаты. Новые выдержки также содержат файл ``proofs.jsonl``: для каждой включённой записи и для начала журнала — путь Меркла от исходного хеша записи до корня журнала, указанного в подписанном манифесте. Скрипт `verify.py` проверяет каждый путь, благодаря чему подтверждается, что каждая запись принадлежит одному и тому же журналу данной длины и с указанным заголовком, без необходимости проверки полного журнала; проверка выдержки из 100 сообщений занимает около секунды независимо от размера журнала. `--range=CHAT:FROM-TO` дополнительно подтверждает, что сообщения от FROM до TO в чате присутствуют в выдержке, и сообщает, сколько записей было проверено для них. Имена внутри имен файлов не обнаруживаются. Проверьте окончательные файлы перед публикацией: свободный текст, имена файлов и выбранные вложения по-прежнему могут идентифицировать людей. Сохраните полный подписанный ZIP-архив: выдержка является раскрытием информации, а не заменой.

## Удобные для чтения отчеты

Подписанные доказательства, передаваемые материалы и ZIP-архивы чатов содержат читаемые отчеты в форматах HTML и JSON, а также PDF (при наличии необходимых шрифтов) на выбранном языке отчета. Каждый отчет запечатан ключом Ed25519 рабочей среды и может быть проверен отдельно: ` `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]``.

- `report.html` / `chat.html`: оператор запечатывания (`tgwitness-report-seal-v1`) закрывает файл и подписывает SHA-256 каждого предыдущего байта. Длинные журналы и чаты разбиваются на части настраиваемого размера (настройки отчёта, от 500 до 100 000 записей; по умолчанию — 5 000): `records/records-0001.html` или `messages/messages-0001.html`, каждая из которых запечатана своим номером, диапазоном и общим количеством, и указана вместе со своим файлом SHA-256 в подписанном манифесте. Серии сигналов о работоспособности коллектора отображаются одной строкой, если в настройках отчёта не указано их поочерёдное отображение.
- `report.json` (`tgwitness-report-json-v1`, ключи `format`, `report`, `seal`): печать подписывает SHA-256 канонического JSON из `report`, благодаря чему факты могут быть прочитаны системами обработки дел и скриптами, а также на их основе может быть сделан выбор для защиты данных, при этом подписанный файл остаётся целым.
- `report.pdf` / `chat.pdf`: официальный документ для печати и архивирования, подписанный дважды на одних и тех же байтах, весь файл, за исключением значения подписи (`/ByteRange`). Стандартной подписью PDF является PAdES baseline (ETSI EN 319 142-1, `/SubFilter /ETSI.CAdES.detached`: CMS с SHA-256 и ECDSA P-256, signing-certificate-v2, без времени подписания CMS; заявленное время составляет `/M`) на уровне B-B или B-T с отметкой времени подписи по RFC 3161 в блоке CMS, если функция временной маркировки включена и центр временных отметок отвечает по маршруту на запросы за пределами Telegram. Используется самовыданный сертификат для подписи документов, хранящийся в хранилище рабочего пространства; его серийный номер субъекта является отпечатком ключа Ed25519. Печать Ed25519 передаётся внутри CMS в качестве неподписанного атрибута `2.25.240684792623320047764573196045913242332` и указывает SHA-256 сертификата с `"content": "pdf-byte-range"`, так что ключ Ed25519 подтверждает подлинность сертификата. Сертификат не является квалифицированным: программа просмотра PDF показывает подпись как действительную, а подписавшего — как неизвестного или недоверенного, пока сертификат не будет признан доверенным; вместо этого сравнивайте отпечаток ключа Ed25519. Для PDF-файлов на китайском, японском и корейском языках требуется шрифт на сервере (или в `TGWITNESS_FONT_DIR`); без него ZIP-архив содержит только отчёты в форматах HTML и JSON .
- `report.en.html`, `report.en.pdf` / `chat.en.html`, `chat.en.pdf`: английский оригинал того же отчёта, если язык отчёта не английский; он запечатан и подписан так же и указан в подписанном манифесте под `report.original`. Отчёт на выбранном языке начинается с рекомендации подать английский оригинал вместе с заверенным или присяжным переводом; см. [Перевод отчётов для суда](https://phishdestroy.io/tgwitness/ru/docs/reference/translation/).

В канале или супергруппе Telegram нумерует сообщения 1, 2, 3… по порядку. Экспорт чата содержит список первого и последнего номера, количество присутствующих сообщений и каждый диапазон отсутствующих номеров в `message-ids.json` , манифесте и заголовке `chat.json` , а также отмечает каждый пробел там, где он встречается в транскрипте. `verify.py` перечисляет их, начиная с `chat.json` . Отсутствующий номер — это сообщение, которое Telegram не вернул (удалено до экспорта или невидимо для аккаунта); в личных чатах и обычных группах номера используются во всех чатах аккаунта, и пропуски не учитываются.

После считывания истории экспорт заново запрашивает у Telegram все отсутствующие номера по порядку (`channels.getMessages`, до 10 000 номеров, включая 1 000 номеров, расположенных ниже первого сообщения, равномерно распределённых по всем пробелам, если их количество превышает указанное). Результат содержится в `message-ids.json` и в отчёте. Пустой ответ фиксирует, что номер недоступен для данной учётной записи на момент повторной проверки; причина не указывается. Сообщение, возвращённое при повторной проверке, добавляется в экспорт и помечается `found_on_recheck`.

Когда в рабочей области наблюдения обнаруживалось, что сообщения в чате были удалены, отсутствовали при повторной проверке или были отредактированы, при экспорте чата добавляются `journal-changes.jsonl`: эти записи журнала, каждую сохраненную версию и соответствующее уведомление, каждая из которых сопровождается хешем и подписью Ed25519, полученными в журнале. `verify.py` проводит повторный расчёт хеша каждой записи, сверяет её подпись с ключом экспорта и сравнивает количество записей с подписанным манифестом; экспорт доказательств содержит полную цепочку хешей. В отчёте эти сообщения перечислены в разделах **«Удаления» и «Ранее версии**».

Каждый отчёт начинается с раздела **Кратко о материалах**: один абзац, затем — что показывает материал и что входит в запись. Собственная печать страницы становится янтарной, когда браузер проверил подпись печати, а не саму страницу: браузер не присваивает странице свои собственные байты. Он становится зелёным только тогда, когда читатель перетаскивает файл в поле проверки в конце страницы и все байты совпадают, и только если отображаемая страница является именно этим файлом; в противном случае он становится красным.

В каждом отчёте точно указывается название программы: коммит в Git, когда сборщик запускается из чек-аута или установщик устанавливает `TGWITNESS_COMMIT`, а также SHA-256 исходных файлов (`source_tree_sha256`, канонический JSON пути → SHA-256 каждого файла `.py`, `.js`, `.css`, `.html` и `.svg` в пакете), которые воспроизводятся при чек-ауте этого коммита, если файлы не были изменены. Клиент Telegram называется по имени своей библиотеки, уровня API и центра обработки данных. Когда начинается наблюдение, а также когда начинается и заканчивается экспорт чата, коллектор запрашивает у Telegram его время (`updates.getState`, целые секунды) и записывает время Telegram за вычетом времени по часам коллектора с погрешностью, обусловленной временем прохождения сигнала в обоих направлениях; эти измерения отображаются в отчетах в разделе «Цепочка контроля». При экспорте чата также фиксируется момент считывания истории, помимо дат сообщений.

### Руководство по автономному просмотру отчетов и архивированию

Перед открытием файлов `chat.html` или `report.html` необходимо полностью распаковать ZIP-архив. Программа просмотра предоставляет функции поиска, фильтров, просмотра участников, индикаторов, сведений о записях, а также выборку файлов JSON и CSV без подключения к серверу. Сохраните файлы `viewer/` и `media/` рядом с отчётом. Выбранные элементы являются производными: используйте файл `verify.py SELECTION.json
--evidence ARCHIVE.zip` для их сравнения с подписанным архивом. Программа проверки проверяет идентификатор отчёта, ключ подписи, границы архива и каждый выбранный элемент; отредактированные, отсутствующие и дублирующиеся элементы не проходят проверку. Примечания к выбору и время создания остаются неподписанными метаданными.

Пробелы в номерах сообщений отображаются только для полной, нефильтрованной ленты чата в порядке возрастания. Скрытие категории или сбой при загрузке блока данных не должны превращать пропущенную строку в доказательство отсутствия сообщения. Подсветка результатов поиска осуществляется в виде простого текста до экранирования HTML, с сохранением буквальной разметки.

Браузер проверяет подписи манифеста, идентификатор отчёта и ключ, а также все указанные хэши файлов. Он отклоняет неоднозначные или некорректно сформированные ZIP-структуры, дубликаты имён и небезопасные пути, а также ограничивает размер файлов 256 MiB и объявлённый общий объём содержимого 4 GiB. Для архивов большего размера используйте автономный верификатор. Эта проверка браузером дополняет проверки верификатора, касающиеся цепочек журналов и семантики данных.

Файл `README.txt` содержит руководство по началу работы, согласованный перечень файлов, инструкции по проверке и примечания по формату данных на языке отчёта, за которыми следует полное руководство на английском языке. `SHA256SUMS` охватывает перечисленные в нём файлы, за исключением самого этого файла, `manifest.json` и `manifest.sig`; подписанный манифест также охватывает `SHA256SUMS`. Оставьте исходный ZIP-архив без изменений и сохраняйте рабочие файлы вне распакованной папки. Отчёты PDF содержат закладки разделов и идентификаторы дел/отчётов на последующих страницах.

### Чат на момент экспорта

Экспорт чата фиксирует информацию, указанную Telegram о чате на момент начала экспорта: собственные метки Telegram (`scam`, `fake`, `restricted` с обоснованиями, `verified`), имена пользователей, описание, количество участников и администраторов, связанное обсуждение, защиту контента, информацию о том, видят ли новые участники предыдущие сообщения и с какого сообщения этот аккаунт видит историю (`available_min_id`), дату сообщения № 1, если это дата создания чата, и SHA-256 — фотографию чата (сохраненную в `media/`). Здесь фиксируется место аккаунта, осуществляющего экспорт, в чате: роль, дата присоединения, кто его пригласил, а для администратора — его права. Вместо этого указывается запрос, отклоненный Telegram.

Если аккаунт, осуществляющий экспорт, является администратором, экспорт считывает журнал администратора чата (Telegram хранит его около 48 часов) в файл `admin-log.json`: удаления и правки с указанным содержанием, действующим аккаунтом и датой исходного действия. Эти записи дополняют зафиксированные версии активного журнала и записи о получении удалений.

### Показатели

Список отчетов и архив содержат такие записи, как `indicators.csv` , `indicators.stix.json` (STIX 2.1 ) и `indicators.misp.json` (событие MISP ), на основании которых служба по борьбе со злоупотреблениями может принимать меры в отношении записанных сообщений: ссылки и домены (в том числе скрытые за текстом, в кнопках и в предварительном просмотре ссылок), адреса криптовалют, имена пользователей и ссылки для приглашения (Telegram ), номера телефонов, адреса электронной почты и сохраненные изображения. Адреса Bitcoin, Litecoin, Dogecoin и TRON указываются только в том случае, если их контрольная сумма base58 верна, адреса segwit — если верна их контрольная сумма bech32 или bech32m, а адреса TON — если верна их CRC; адреса EVM и Solana помечаются как непроверенные. Изображения содержат SHA-256 и перцептивный хэш (dHash, 64 бита), который при повторном сжатии или изменении размера копий остаётся практически неизменным. Отчёты записывают индикаторы таким образом, чтобы они не открывались случайно (`hxxps[://]example[.]com` ); файлы сохраняют значения в том виде, в каком они были. Каждый индикатор помечается как неизвестный и не подлежащий автоматическому обнаружению (STIX , `indicator_types: unknown` , MISP , `to_ids: false` , рассылка собственной организации): наличие в списке означает, что он содержался в сообщении, а не то, что он является вредоносным. Ссылка, текст которой указывает на адрес, отличный от того, на который она ведет, помечается в отчете.

Отчёты формата PDF заканчиваются заявлением эксперта, которое необходимо подписать от руки, контрольным списком для нотариуса или судебного эксперта, а также QR-кодом (также расположенным на первой странице) с идентификатором отчёта, отпечатком ключа и SHA-256 авторитетных данных, чтобы распечатка позволяла отследить их происхождение из архива.

## Канонизация событий

Входные данные хеша состоят именно из следующих полей:

```
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
```

Сериализация должна осуществляться с использованием JSON, совместимого с Python, в кодировке UTF-8, с отсортированными ключами объектов, без ASCII-эскейпинга, без незначительных пробелов и без значений NaN/бесконечности:

```
json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")
```

Хеш события формируется на основе SHA-256 этих байтов. Подпись создается с помощью алгоритма Ed25519 над 32 исходными байтами хеша, а затем кодируется в Base64. Первый предыдущий хеш (previous_hash) состоит из 64 нулей. Порядковые номера начинаются с 1 и увеличиваются на 1. Все события, включая операционные, составляют одну цепочку. Подавление дубликатов доставки отсутствует: повторные наблюдения представляют собой отдельные подтверждения получения, а не утверждение о различных действиях в Telegram.

Исходные данные Telegram представляют собой строки в формате ISO; двоичные поля преобразуются в объекты, содержащие bytes_base64. Текст сообщения, сущности, дескрипторы мультимедиа, метаданные ответа, реакции и действия сервиса сохраняются в исходных метаданных сообщения, если они были предоставлены. Активное сообщение также сохраняет обновление Telegram, с помощью которого оно было доставлено, в `transport_update`; если это обновление содержит то же сообщение, что и `raw`, его `message` поле `{"same_as": "raw"}` вместо второй копии.

`observed_at` — время записи записи в формате UTC, указанное коллектором; `source_at` — это дата, указанная в данном событии Telegram. К записям, созданным в процессе обработки оперативного обновления, добавляется `payload.received_at`время UTC, когда обновление поступило в коллектор, и `payload.processing_delay_ms`. При редактировании в режиме реального времени сохраняется предоставленная дата редактирования, в моментальных снимках истории сохраняется дата сообщения с текущим временем наблюдения, а в обычном уведомлении об удалении фиксируется время получения с нулевой датой источника. Записи в журнале администратора сохраняют предоставленную дату действия отдельно. Порядок получения и порядок событий источника представляют собой отдельные временные шкалы, при этом для сравнения доступны данные наблюдений по часам и внешние подтверждения получения.

## Семантика участников

Атрибуция следует источнику события. `message.new.actor_id` и `message.edited.payload.sender_id` сохраняют отправителя сообщения. Обычные уведомления `message.deleted` содержат идентификаторы сообщений и имеют поле actor с нулевым значением; доступные записи журнала администратора содержат указанные действие, участника и дату. Сообщения службы членства сохраняют отправителя и тип действия, необработанные обновления участников сохраняют указанный `actor_id`, а моментальные снимки реакций сохраняют указанные подсчёты и видимые идентификаторы. Читайте эти записи вместе с захваченными версиями и [квитанциями взаимодействия с панелью](https://phishdestroy.io/tgwitness/ru/docs/reference/collection/#own-actions).

Уведомления об удалении для личных чатов и обычных групп содержат только идентификаторы сообщений. Эти чаты используют одну общую для всей учётной записи последовательность идентификаторов, поэтому идентификатор определяет одно-единственное сообщение этой учётной записи. Если сообщение с этим идентификатором было ранее сохранено в данном журнале, удаление фиксируется в этом чате как `message.deleted` с `payload.chat_resolution`, обозначающим метод. Идентификаторы, которые никогда не сохранялись, хранятся как `deletion.unscoped`: это фактическое уведомление об удалении, чат которого не был соотнесён. Это отличается от `message.missing_on_recheck`, которое фиксирует недоступный результат запроса, а также от пробела в сохраненных идентификаторах сообщений. Каналы и супергруппы нумеруют сообщения по чату и никогда не сопоставляются таким образом. Если удалённое сообщение было отправлено наблюдаемой учётной записью, payload.deleted_message_was_outgoing принимает значение true; информация об удаляющем пользователе по-прежнему не предоставляется.

Уведомление без области действия сохраняет собственную метку, поскольку соответствующий чат может находиться за пределами текущей области наблюдения или не иметь однозначного соответствия. Отсутствие при повторной проверке остаётся отдельным наблюдением, отличным от уведомления об удалении, в подсчётах отчётов, фильтрах и метках. Позднее восстановление сбрасывает текущее состояние отсутствия, сохраняя при этом ранее неудачную проверку в подписанной истории; уведомления об удалении остаются отдельным типом события.

Несколько идентификаторов, относящихся к одному и тому же чату из одного уведомления, группируются как `deletion.batch` независимо от их количества, с идентификаторами сообщений в том виде, в каком их отправил Telegram, а также с указанием количества сообщений, отправленных этим аккаунтом. В уведомлении Telegram перечислены сообщения; в журнале администратора чата указан действующий администратор, где аккаунт может прочитать эту информацию. Связь (`message.deletion_attributed`) устанавливается в зависимости от того, что поступило первым: запрос, в котором запись в журнале администратора была обнаружена до уведомления об удалении, сопоставляется при регистрации уведомления.

## Объём охвата: непрерывность, пробелы и незафиксированные идентификаторы

Каждый подписанный ZIP-файл содержит файл `coverage.json`, HTML-отчёт открывается с той же сводкой, а файл `verify.py` пересчитывает её на основе файла `events.jsonl`, а не доверяет исходному файлу:

- **Непрерывное наблюдение от X до Y.** Период начинается с `observation.started` и заканчивается при паузе, остановке, потере соединения с Telegram, выходе из системы, запуске процесса без упорядоченной остановки или при отсутствии записей в течение более трёх минут во время наблюдения (сигналы пульса записываются каждую минуту, поэтому отсутствие сигналов означает, что процесс остановился, завис или компьютер перешёл в спящий режим). Когда интервал сигналов heartbeat изменяется в разделе **Дополнительные инструменты → Параметры**, каждый сигнал фиксирует это, и допустимое время отсутствия записей становится равным трём интервалам, но никогда не меньше трёх минут.
- **В списке пробелов** указывается временной интервал между периодами с указанием причины. Пробел, остающийся незаполненным на момент последней записи, обозначается как `not_resumed_by_last_record`.
- **Идентификаторы сообщений не фиксируются.** Для каналов и супергрупп, в которых сообщения нумеруются по чату, пропущенные идентификаторы между зафиксированными указываются в виде диапазонов. Они отмечаются как «не*зафиксированы*» — удаленные, никогда не доставленные или выходящие за пределы сохраненной истории — но никогда как «удаленные». Личные чаты и обычные группы используют общую для всей учетной записи нумерацию, поэтому пробелы внутри одного такого чата ничего не значат и там не указываются.
- Уведомления о пропусках на уровне чата (например, запрос Telegram о восстановлении разницы в одном канале) учитываются как заметки; они не прерывают общее охват.
- **Записи сеансов.** Отдельно перечисляются сеансы, в которых счетчик обновлений Telegram увеличивался, хотя никаких обновлений в этот сеанс не поступало (`updates_diverted`), сеанс был удален из списка сеансов Telegram, хотя его соединение продолжало работать (`session_revoked_externally`), или ответ на запрос свидетеля поступил только из истории (`probe_ack_missed_live`). Верификатор также сообщает, откуда был получен сессионный ключ Telegram, какие другие сессии были авторизованы на момент начала наблюдения, какие сессии были добавлены во время наблюдения, уведомления Telegram о безопасности (777000), какие другие сессии были завершены из рабочей области, периоды, когда активна была только одна сессия, количество запросов к свидетелю и обновления телефонных звонков. См. [учетные записи](https://phishdestroy.io/tgwitness/ru/docs/reference/accounts/#witness-probe). При включенном режиме [Строгий выбор чатов](https://phishdestroy.io/tgwitness/ru/docs/reference/collection/#strict-chosen-chats) (`scope.strict` в `observation.started`) список сеансов (за исключением случаев, когда это единственный сеанс или когда включена функция **Устройства Telegram**), уведомления о безопасности и обновления о телефонных звонках не собираются, поэтому их отсутствие ничего не означает, а удаление сопоставляется с сеансом только в том случае, если он проходил в течение 10 минут до этого.

### Последовательность обновлений (`pts`)

Telegram выделяет обновления, связанные с сообщениями, с помощью `pts`: одна последовательность для аккаунта (личные чаты и базовые группы вместе) и по одной для каждого канала или супергруппы. Коллектор записывает каждый полученный им отрезок без пропусков в виде `coverage.sequence` запись: первый и последний `pts`, количество обновлений каждого типа, а также информацию о том, были ли они отправлены в режиме реального времени или возвращены `getDifference` или `getChannelDifference`. Пропуск — это `coverage.gap` запись, и `coverage.gap_closed` обозначает `pts` , начиная с которой последовательность снова становится целой.

Непрерывный ряд показывает, что каждое обновление Telegram, пронумерованное в этой последовательности между первым и последним `pts` достигло клиентского приложения Telegram данного сборщика. Это ничего не говорит о содержании, которое Telegram никогда не отправлял на этот аккаунт, о времени до первого зарегистрированного `pts`, а также о последовательностях, которые сборщик не зафиксировал. Любой `pts` Сдвиг, который не охватывается ни одним из зафиксированных отрезков или разниц, отображается как разрыв.

`GET /api/continuity` ответы для интервала (`since`, `until`, `chat_id`), является ли каждая последовательность непрерывной, и перечисляет разрывы с указанием их причин. `verify.py` выводит те же данные из записей архива в разделе **«Непрерывность последовательности**».

### Отсутствующие номера сообщений (`gap_summary`)

For a reader's guide to this section and to observation periods and gaps, see [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md).

**Предварительный просмотр.** `coverage.json` → `gap_summary` Измеряет номера, присвоенные Telegram, которые этот коллектор никогда не видел. Telegram нумерует сообщения один раз на канал или супергруппу и один раз на аккаунт во всех приватных чатах, ботах и обычных группах. Номер, находящийся между двумя наблюдаемыми сообщениями, либо наблюдается, либо отсутствует; непрерывный диапазон является утверждением о том, что каждое сообщение, пронумерованное в нём, было наблюдаемо. Пробел не указывает ни на какого участника, ни на причину.

| Область применения | Значение |
| --- | --- |
| `status` | `on` или `off`, если отключено в **Дополнительные инструменты → Параметры → Анализ пробелов** |
| `parameters` | Параметры, которые привели к получению результата, чтобы его можно было повторить |
| `chats[]` | По одной записи на канал или супергруппу, каждая из которых пронумерована отдельно |
| `account` | Последовательность личных чатов, ботов и обычных групп для всего аккаунта |
| `status` (для каждой последовательности) | `applicable`, или `not_applicable` с `reason` |
| `observed_from`, `observed_to`, `span` | Первый и последний наблюдаемый номер, а также размер диапазона |
| `observed`, `observed_without_content` | Наблюдаемые номера; те, которые известны только по записям об удалении или повторной проверке |
| `missing`, `density`, `gap_ranges`, `largest_gap` | Число, которое никогда не наблюдалось, его доля в диапазоне, количество прогонов, самый длинный прогон |
| `clusters[]` | Перечисленные пробелы: `low`, `high`, `missing`, а также соседние наблюдаемые числа `after` / `before` с указанием времени наблюдения |
| `service_estimate` | Только при включенной функции: количество отсутствующих номеров, которые были бы служебными сообщениями с учетом их доли в общем количестве наблюдений. Никогда не вычитается из `missing` |

Достоверность определяется на основе журнала, она никогда не принимается как данность:

- **Каналы и супергруппы** учитываются по каждому чату, в том числе при экспорте выбранных чатов. В расчёт включаются записи, выбранные по отправителю `not_applicable`.
- **Последовательность по всему аккаунту** измеряется только от первого до последнего сообщения, поступившего в период, когда был включен сбор данных по всему аккаунту, и включает приватные чаты, ботов, обычные группы и собственные сообщения аккаунта, при этом ни один из таких чатов не исключается (`scope.changed`). Числа, обозначенные `deletion.unscoped` считаются наблюдаемыми без учета содержания. Экспорт или передача выбранных чатов не позволяют измерить эту последовательность. Если сбор данных по всему аккаунту был выключен, а затем включен, в примечании указывается, что номера, использованные в промежуточный период, отображаются как пробелы.
- Сервисные сообщения представляют собой записи журнала с собственными номерами, поэтому они сами заполняют пробелы; необязательная оценка служит лишь для контекста.

`verify.py` пересчитывает `gap_summary` по `events.jsonl` с настройками из подписанного `coverage.json`, для старых архивов используются значения по умолчанию. В сводке выводится результат по аккаунту. Команда `get_capture_status` в MCP и командной строке возвращает расчёт для разрешённых чатов; общая нумерация аккаунта доступна только при доступе ко всему рабочему пространству.

Повторные наблюдения одного сообщения службы учитываются один раз, а оценка службы учёта использует только числа, находящиеся в пределах измеряемого диапазона. Применяемая область действия должна явно сохранять собственные сообщения учётной записи до включения измерения на уровне всей учётной записи; измерение начинается с записей, содержащих эту информацию. Измеряемый диапазон охватывает текущее наблюдение, и его возобновление фиксируется. Запрос к архиву в режиме реального времени имеет временной лимит, включая сканирование базы данных, и помечает незавершённое измерение как частичное.

Telegram документирует [отдельные последовательности идентификаторов сообщений](https://core.telegram.org/api/updates#message-id-sequences). Эти номера описывают наблюдения; уведомления об удалении, повторные проверки и записи в журнале администратора, объясняющие, почему номер отсутствует там, где Telegram его указывает.

Когда Telegram перестает принимать учётную запись, запись `coverage.gap`, завершающая наблюдение, содержит `cause` (`account_banned`, `account_frozen`, `account_deleted`, `session_duplicated`, `session_revoked`, `session_expired`, `session_ended` или `not_authorized`) и ошибку Telegram; `verify.py` указывает причину, по которой период заканчивается.

Покрытие объединяет зафиксированные периоды наблюдения, перерывы и результаты сообщений. Оценивайте его с учётом выбранных чатов, периода и политики вложений; повторная проверка результатов и зафиксированных пробелов показывает, насколько полно отслеживались обновления аккаунта.

## Продюсер

Подписанный манифест ZIP-архивов с доказательствами, экспортов чатов, журналов свидетелей и файлов с профилями пользователей содержит `producer`: программное обеспечение, версию, проект (PhishDestroy), домашнюю страницу и репозиторий исходного кода. HTML-отчет и верификатор отображают эту подписанную запись производителя. Хэши исходных файлов идентифицируют записанное дерево исходного кода для сравнения с доверенной версией. Происхождение выполнения проверяется отдельно с помощью [аттестации получения данных из GitHub](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) или [измерений Intel TDX](https://phishdestroy.io/tgwitness/ru/docs/reference/high-assurance/), если они включены. Архивы, созданные до появления поля производитель, по-прежнему поддерживаются и идентифицируются как устаревшие записи.

Каждая запись `observation.started` также указывает клиент Telegram, который осуществлял наблюдение: его `api_id` (ни в коем случае не хеш), независимо от того, является ли это встроенной публичной парой или собственным приложением оператора, описание клиента, отправленное в запросе на соединение Telegram, а также тип маршрута соединения с режимом IP (без адреса прокси или секрета). В отчете и записи `custody.json` перечислены все уникальные клиенты и маршруты с указанием времени их регистрации, а также случаи, когда ни один из перечисленных прокси не ответил, и запись Telegram зафиксировала адрес сервера. Об этом свидетельствуют журналы, записанные до этого.

## Профили пользователей

Файл профиля (`tgwitness-dossier-v1`, JSON) формируется по запросу на основе записей, уже имеющихся в журнале для одного чата; никакие данные из Telegram не извлекаются, а содержимое профиля никогда не записывается в журнал (включение и выключение профилей фиксируется как `dossier.changed`). Для каждого пользователя, у которого сохранено сообщение, указываются имя и история имений, флаги Telegram (бот, мошенничество, фейк, премиум, подтверждённый, ограниченный доступ, удалённый) на момент сохранения, идентификаторы фотографий, SHA-256 и перцептивный хеш (pHash, совместимый с `imagehash.phash`) аватара из локального кэша аватаров с похожими аватарами, активность (первое и последнее сообщение, количество сообщений, отредактированные и удалённые публикации, сообщения по часам UTC), кто кому отвечает, другие чаты в этом журнале, в которых данный пользователь писал, а также упомянутые кошельки (BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; адреса в формате Base58Check проходят проверку контрольной суммы), номера телефонов, имена пользователей и ссылки, включая ссылки, скрытые за текстом.

Каждый факт сопровождается указанием записей журнала (`seq`), из которых он взят, а `record_hashes` содержит хэш каждой упомянутой записи. Заявление подписано ключом рабочей области:

```
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
```

Проверяет подпись, верифицирует сам экспорт доказательств (подпись, цепочку хешей и файлы) а также наличие каждой упомянутой записи в неизменённом виде в данном экспорте того же рабочего пространства. Хеши аватаров помечаются как полученные из локального кэша (а не из записей журнала). Упоминания представляют собой совпадения по шаблону и подсказки для проверки. Профили включаются для каждого чата, могут экспортироваться в виде ZIP-архива с шифрованием AES-256 и паролем, а также удаляются при отключении или при удалении чата из источников.

## Независимый свидетель

Журнал свидетеля (`tgwitness-witness-v1`) и его сообщения в канале проверяются по сравнению с экспортом доказательств с помощью `verify.py --witness … --channel …`; см. [независимый свидетель](https://phishdestroy.io/tgwitness/ru/docs/reference/witness/). Имея публичный адрес `https://t.me/s/…` или `https://telegram.me/s/…`, верификатор считывает дату каждого сообщения из Telegram, и самая ранняя такая дата сообщения в начале экспорта является внешним временем для последней записи. Даты из любого другого источника являются предоставленными метаданными.

## Манифест и контрольные точки

Файл manifest.json содержит формат, время экспорта, открытый ключ, отпечаток, длину журнала, хэш заголовка, область действия, производителя, ограничения и SHA-256 каждого элемента содержимого, кроме самих файлов `manifest.json` и `manifest.sig`. manifest.sig — это подпись в кодировке base64 по алгоритму Ed25519 над каноническим JSON-манифестом. Проверяющий отклоняет неожиданные/отсутствующие элементы, дубликаты имен, повреждённые файлы, нарушенную последовательность/цепочку, недействительные подписи и несоответствие предоставленной контрольной точке. Он никогда не извлекает пути к архивам. Он ограничивает общий заявленный размер в несжатом виде до 4 ГиБ; `--max-gib N` позволяет создавать более объёмные архивы с помощью повышенного предела, установленного в разделе **Дополнительные инструменты → Параметры**.

Проверка большого архива осуществляется несколькими процессами одновременно: элементы архива хешируются параллельно, а после первых 5 000 записей хеш содержимого и подпись каждой записи проверяются рабочими процессами, в то время как главный процесс последовательно отслеживает цепочку, степень охвата и привязки. `--jobs N` задаёт количество процессов; по умолчанию `auto` — по одному на каждый процессор, не более 16, а `--jobs 1` сохраняет всё в одном процессе. Результат одинаков в обоих случаях, а изменение отклоняется с одинаковым сообщением. Хэши в позициях, указанных сохранёнными контрольными точками и анкерами временных меток, сохраняются в течение этого единственного прохода, поэтому каждый анкер сравнивается без повторного чтения журнала. На компьютере с 32 потоками обработка архива объёмом 10,8 ГБ с 400 000 записей заняла 58,9 с в одном процессе, 15,2 с при использовании 4 процессов и 8,4 с при использовании 16; один проход по записям по порядку затем устанавливает предел.

Запустите проверку из установленной версии TgWitness или из проверенной версии репозитория. Копия, включённая в архив, поддерживает переносимое использование; сверьте эту копию с вашей надежной установкой перед её запуском.

Контрольная точка подписывает заявление, содержащее открытый ключ, длину журнала, хеш заголовка и время создания. Она также несет самый новый раунд drand, который рабочая область получила (`drand_anchor` ): сборщик запрашивает ретранслятор drand через внешний маршрут рабочей области перед каждой периодической контрольной точкой, поэтому Hide IP, прокси и отключенный внешний маршрут применяются, и при создании самой контрольной точки никогда не происходит подключения к внешнему миру. Верификатор может проверить, содержит ли более поздний архив тот же префикс. С помощью `--checkpoint` и `--check-drand` он подтверждает этот раунд с помощью ретрансляторов drand и сообщает, что контрольная точка была подписана не раньше времени данного раунда; раунд не изменяет уровень гарантии. Храните контрольную точку вне коллектора, чтобы при последующей верификации архив сравнивался с эталоном, хранящимся отдельно от него. Ключ коллектора подписывает его, поэтому он связывает записи с ним только в том случае, если получатель получил его до архива через другой канал; сам по себе он не соответствует минимальным требованиям к доказательству.

## Чтение результата проверки

Верификатор отдельно сообщает о целостности архива, привязке подписавшего лица и результатах проверок достоверности. Достоверная подпись свидетельствует о том, что байты не изменились с момента подписи. Оператор передает отпечаток ключа получателю по отдельному каналу. Без `--fingerprint`, неповрежденный архив проходит проверки подписи и формата с `signer_pinned: false`, а последняя строка начинается со `EVIDENCE: minimum not met · missing: confirmed signer key`.

Для автоматизированной политики локального архивирования, требующей закреплённого подписанта и минимального объёма доказательств:

```
python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence
```

Используйте отпечаток, сохраненный через доверенный канал получателя. Доверенный свидетель также может закрепить сборщик через согласованный журнал с подтверждением; укажите параметры `--witness`, `--witness-fingerprint` и `--require-witness`. Параметр `--strict` завершает работу со статусом 2 в случае незакрепленного подписанта; невыполнение требований `--require-tier` или `--require evidence` также приводит к завершению работы со статусом 2. Для параметра `--require evidence` требуются `--fingerprint` и внешнее время от стороннего источника, охватывающее последнюю запись. Следует учитывать значения `signer_pinned`, `requirements_met` и результаты проверки достоверности, а не только код завершения. Вместо этого [Sealed Acquisition](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) использует свой верификатор аттестации и утвержденную политику для аутентификации дайджеста получения.

## Объем проверки

Верификация проверяет архив и режим сбора, использованный для его создания. Выберите режим, граница доверия которого соответствует данному случаю, а затем сохраните его входные данные для верификации.

| Режим сбора | Что проверяется | Материалы и условия проверки |
| --- | --- | --- |
| Локальное рабочее пространство | Запишите подписи, цепочку хешей, манифест и байты вложений | Отпечаток коллектора, сохраняемый получателем, и внешнее время от третьей стороны: проверенные квитанции по стандарту RFC 3161 или OpenTimestamps, либо сообщения свидетеля, прочитанные с t.me. Сохраненные контрольные точки и записи свидетеля служат в качестве подтверждающих данных. |
| Локальное рабочее пространство с независимым свидетелем | Проверка архива и совпадения его начального участка с ранее сохранённой записью свидетеля | Отпечаток и записи свидетеля; запись хранителя о контроле над ключом показывает, у кого находится ключ свидетеля. С `--channel https://t.me/s/…` даты, проставленные Telegram на публикациях, дают внешнее время |
| [Сбор через GitHub Actions](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | Подтверждение на GitHub дайджеста архива, утвержденного рабочего процесса и коммитов сборщика, размещенного запуска, нового источника сессии/ключа и целостности внутреннего архива | Политика доверенного верификатора, репозиторий вызывающих сторон и пакет аттестации GitHub; сбор данных выполняется в рамках закреплённого рабочего процесса |
| [Облачное развёртывание](https://phishdestroy.io/tgwitness/ru/docs/reference/high-assurance/) | Записи о жизненном цикле провайдера и доступе, состоянии брандмауэра и Cloudflare, а также подписанная запись о работе сборщика данных | Запросы к провайдеру и Cloudflare только для чтения; доступность отдельных проверок зависит от провайдера |
| [Конфиденциальная ВМ Intel TDX](https://phishdestroy.io/tgwitness/ru/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | Укажите подпись и статус платформы, привязку к заявлению сборщика, состав и измерения ОС | Цепочка доверия Intel и ожидаемые показатели развертывания; сохранить результаты каждой обязательной проверки TDX |

При запечатанном сборе данных утвержденный сборщик получает данные через аутентифицированное соединение Telegram внутри проверенной среды. Аттестация привязывает архив к данному запуску, поэтому проверка охватывает как сам процесс сбора, так и последующую целостность файлов. Это основано на утвержденном коде и цепочке доверия платформы, перечисленной выше. Верификация сбора данных на GitHub требует сеанса, созданного в рамках данного запуска, и отклоняет сбор данных с использованием импортированных сеансов.

В квитанции запуска фиксируются версия сборщика, хеши файлов и настройки запуска. Происхождение из GitHub и измерения TDX обеспечивают проверку среды; запись валидации  идентифицирует протестированные конфигурации.

### Откуда поступают сообщения

Telegram доставляет сообщения каждому клиенту, включая официальные приложения, в рамках сеанса MTProto. Ключ авторизации сеанса согласовывается с закреплённым серверным ключом Telegram, и каждое обновление поступает в зашифрованном виде с проверкой целостности с использованием этого ключа. Коллектор получает сообщения через аутентифицированный сеанс учётной записи и подписывает каждую запись в журнале по мере её поступления, указывая идентификаторы чата, сообщения и отправителя, а также дату, установленную Telegram для каждого сообщения. В GitHub Actions и развёртываниях Intel TDX аттестация также связывает эту сессию и ключ подписи с утверждённым запуском сборщика.

Журнал фиксирует, откуда поступил ключ авторизации. Вход с помощью телефона или QR-кода, либо независимый вход из файла сеанса записывает `account.authorized` с `key_origin: "created"`; сбор данных по импортированному ключу `.session`, TData или JSON записывает `imported`. Импортированный ключ также существует независимо от источника его происхождения. Аттестованные развертывания отклоняют импортированные ключи.

Происхождение записи в Telegram подтверждается аутентифицированным подключением учетной записи, записями о подключении и перехвате в журнале, перехваченными кадрами MTProto, сопоставленными с записями журнала ([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/tgwitness/forensics)), датой Telegram каждого сообщения, а также — в случае заверенного перехвата — проверенной средой выполнения. Подписи архива сохраняют эту запись для последующей проверки. Сохраненные контрольные точки фиксируют пределы предыдущих журналов, записи об охвате показывают результаты сбора, а проверенные внешние временные метки определяют временную привязку зафиксированных байтов.

Для локальной рабочей области получатель предоставляет входные данные от доверенного сборщика или свидетеля. При запечатанном сборе данных доверенная политика и аттестация связывают дайджест архива с утвержденным выполнением сборщика. Это разные пути верификации; сообщите о проведенных проверках для выбранного пути.

## Вложения

Файлы идентифицируются по хешу SHA-256 в каталоге media/. Событие media.saved связывает хеш и длину в байтах с конкретным событием сообщения. Исходные имена файлов являются метаданными, а не локальными путями. Байты мультимедиа загружаются асинхронно, поэтому немедленное удаление может помешать их фиксации. В качестве результатов отображаются: отключенный сбор данных, файлы чрезмерного или неизвестного размера, сбои при загрузке и прерванные загрузки. Сбой процесса может привести к появлению неимеющих ссылок неполных файлов; они не включаются в экспортируемые данные.

Экспортер в формате ZIP сверяет сохраненные медиафайлы с их именами. Экспорт в форматы JSONL, CSV и HTML проверяет сигнатуры событий, но не передаёт байты медиафайлов. Производные отчёты предназначены для удобства; файл events.jsonl является авторитетным представлением событий.

При полном экспорте чата вложения сохраняются в соответствии с настройками вложений рабочего пространства в папке media/ с именами в формате SHA-256. Каждая запись сообщения в файле chat.json указывает название файла (`file`, `file_sha256`) или причину его отсутствия (`file_status`), а также то, что видел читатель вокруг текста: ссылки за текстом, источник пересылки, кнопки ботов, подпись, просмотры и таймер автоматического удаления. Файл `verify.py` проверяет, что каждый указанный файл находится в подписанном манифесте под этим хешем.

## Надежный сбор и обработка подтверждений (0.2)

Обработка медиафайла и фиксация события сообщения осуществляются в рамках одной транзакции. Задание сохраняет исходный дескриптор сообщения Telegram; подписанное наблюдение связывает его SHA-256, учётную запись и политику размера. При восстановлении эта привязка проверяется перед загрузкой. Система никогда не извлекает текущее сообщение и незаметно заменяет его более новым вложением. Прерванные задания повторяются, в то время как постоянный сбой остаётся явным результатом.

Каждая рабочая область имеет собственный журнал и идентификатор подписи. Событие process.started включает идентификатор запуска, время по локальным часам, версии зависимостей, хеши исходных файлов, исходную учетную запись/область действия, а также настройки сбора данных. Сигналы пульсации включают идентификатор запуска, монотонное время и состояние очереди. Квитанцию о запуске также можно загрузить в виде отдельно подписанного заявления. Для проверки среды выполнения сопоставьте её с аттестатом GitHub или проверками TDX, описанными в [Область проверки](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#verification-scope).

Автоматические контрольные точки сохраняются локально при запуске, каждые пять минут во время наблюдения (**Дополнительные инструменты → Параметры → Подписанная контрольная точка каждые**) и при упорядоченной остановке. Проверка при запуске и экспорт сравнивают журнал с последней сохраненной локальной контрольной точкой. Это позволяет обнаружить откат базы данных, если контрольная точка сохранилась. Независимое хранение обеспечивает доступность этой ссылки за пределами рабочей области; проверенная внешняя временная метка дополнительно закрепляет её во времени.

После перезапуска сохраненная позиция обновления Telegram восстанавливается (`catch_up_from` в `observation.started`) и запрашиваются пропущенные обновления. Сохраненная позиция охватывает только те обновления, обработка которых завершилась, поэтому обновления, которые все ещё находились в очереди на момент разрыва соединения или остановки процесса, запрашиваются повторно. Периодическая повторная проверка фиксирует `message.recovered` пропущенные сообщения и `message.missing_on_recheck` в случае, если Telegram больше не возвращает сохраненное сообщение; последнее не является уведомлением об удалении и не содержит информации ни об удаляющем пользователе, ни о времени.

### Внешнее копирование и восстановление (S3)

Внешняя копия (**Настройки → Уведомления и внешняя копия → Внешняя копия** или **Дополнительные инструменты → Дополнительные функции → Доказательства и резервные копии**; по умолчанию отключена) загружает сегменты журнала, сохраненные файлы, контрольные точки с их временными метками и готовые экспорты чатов в хранилище, совместимое с S3, зашифрованные с помощью AES-256-GCM перед загрузкой с использованием ключа, хранящегося в хранилище рабочей области; применяется функция Object Lock , если корзина это поддерживает. Без загруженного ключа копию невозможно прочитать. Восстановите и проверьте с помощью команды `python -m tgwitness.replica restore --key-file KEY.json --out DIR`.

Для восстановления требуется пустой обычный каталог. Загруженные и расшифрованные объекты остаются в частном временном хранилище до тех пор, пока не будет проверен весь журнал и каждая сохраненная контрольная точка. Небезопасные пути к объектам, несогласованные диапазоны сегментов и журналы, длина которых меньше контрольной точки, отклоняются; в случае неудачной проверки восстановленные файлы не публикуются. Проверки срока хранения сравнивают возвращённый режим Object Lock и дату с крайним сроком, отправленным при загрузке (допуск на округление составляет одну секунду). Истекший, недействительный или сокращённый крайний срок не считается проверенным. Статус указывает на выбранный объект, срок хранения которого был считан обратно для данного цикла загрузки.

Отсутствие или повреждение локальных медиафайлов фиксируется как ошибка текущего прохода, при этом курсор медиафайлов остаётся перед этим местом, чтобы файл был повторно обработан в следующем проходе; файлы, контрольные точки и экспортированные данные, следующие за ним, по-прежнему копируются. При восстановлении все ссылки на сохраненные медиафайлы сверяются с расшифрованными хешами и зафиксированными размерами. Идентичные перекрывающиеся сегменты журнала от прерванных загрузок дедуплицируются; конфликтующие перекрытия отбрасываются. Контрольные точки, созданные во время загрузки, откладываются до тех пор, пока охватываемые ими записи журнала не будут скопированы, поэтому завершённый проход не публикует контрольную точку раньше, чем соответствующая запись в журнале.

### Потоковый экспорт моментальных снимков

При потоковом экспорте используется стабильный снимковый файл чтения SQLite. Его начало может оказаться более старым, чем текущий активный журнал к моменту завершения загрузки. Контрольная точка, созданная после этого снимка, может правильно показывать, что архив короче; сравнивайте с контрольной точкой, расположенной на уровне экспортируемого префикса или перед ним, а не с произвольной более поздней контрольной точкой.

## Подготовка RFC 3161 и проверка ответов (0.2)

В режиме «Evidence» в перечисленные авторитетные центры по стандарту RFC 3161 и календари OpenTimestamps отправляется только хеш SHA-256 каждой подписанной контрольной точки по маршруту рабочей области, но никогда через MTProxy. Функция временных меток включена по умолчанию в каждой цели настройки; **доказательства по делу** также включают запись drand. Ответы хранятся в `checkpoints/anchors/`, экспортируются в формате `.tsr` и `.ots` файлах в папке `anchors/`, и проверяются с помощью `verify.py` (`--tsa-ca` проверяет подпись TSA; подтверждает доказательства OpenTimestamps с помощью `ots upgrade` и `ots verify`).

Служба меток времени RFC 3161, дважды подряд не ответившая, ждёт перед следующей попыткой: один интервал, затем два, четыре и так далее до шести часов либо столько, сколько просит её `Retry-After`, но не больше суток. Проход, в котором остались только ожидающие службы, записи не создаёт; иначе `anchor.completed` перечисляет их в `deferred` с `retry_at`. Пока они снова не ответят, панель показывает метки времени в состоянии **Работает с ограничениями**.

Панель подготавливает архив запросов, содержащий канонические байты checkpoint.json, отпечаток сообщения SHA-256 и случайный нонс в файле timestamp.tsq, контрольные суммы и инструкции. Сетевые запросы не отправляются; меткой времени является токен, который служба меток времени вернёт на этот запрос.

`python -m tgwitness.anchor verify` сверяет ответ с байтами контрольной точки и исходным запросом без OpenSSL. Файл доверенного CA нужно указать явно; вложенные сертификаты автоматически доверенными не считаются. В CLI проверка запроса необязательна, поэтому сохраните запрос и передайте --request, чтобы проверить nonce. В результате указано, выполнялась ли эта проверка. Подпись контрольной точки коллектора и журнал всё равно нужно отдельно проверить по доверенному отпечатку коллектора.

Верификация проверяет подпись ответа, байты контрольной точки и, при наличии, исходный запрос в рамках указанного доверия к ЦС. Для временных меток, полученных в режиме сбора доказательств, `verify.py` также проверяет сохраненные данные OCSP или CRL (список [отзывов сертификатов подписи](https://phishdestroy.io/tgwitness/ru/docs/reference/timestamp/#signing-certificate-revocation)). См. [процедуру](https://phishdestroy.io/tgwitness/ru/docs/reference/timestamp/) и [результаты проверки](https://phishdestroy.io/tgwitness/ru/docs/reference/verification/).

## Дополнительные записи в режиме сбора доказательств: устройства drand и Telegram

Еще две записи могут выполняться в тех же циклах, что и временные метки. Обе вступают в силу только при включенном режиме «Доказательства». **Наличие доказательств по делу** включает drand; в противном случае обе записи по умолчанию отключены. Переключите их в разделе «Дополнительные инструменты» → «Дополнительные функции» → «Доказательства и резервные копии» → **Дополнительные свидетели · опционально**, или `"drand": true` и `"devices": true` в `POST /api/evidence`. Сбой одного из них не останавливает работу другого или временных меток; панель отображает последние результаты каждого из них под формой.

**drand** (`beacon.drand` ). При каждом проходе в журнал записывается новейший раунд drand quicknet — общедоступная случайная величина от League of Entropy (один раунд каждые 3 секунды): `chain` , `round` , `randomness` , `signature` , `round_time` и `relay` , ответивший на запрос. Проверенный непредсказуемый раунд служит нижней временной отметкой для последующих материалов, связанных хэш-ссылками. Проверенная временная метка на более поздней контрольной точке служит верхней временной отметкой. Эти проверки ограничивают связанный материал. Сборщик сначала обращается к `drand.cloudflare.com` , затем к ретрансляторам Protocol Labs через маршрут рабочей области, по одному запросу за каждый проход.

`verify.py` проверяет, что каждый случайный номер является SHA-256 своей подписи и что время раунда верно, а также сообщает о раундах, самом длинном отрезке без раунда и о том, насколько часы сборщика отставали от drand. `--check-drand` сравнивает раунды с ретранслятором Cloudflare и ретранслятором Protocol Labs — либо со всеми из них, либо со случайной выборкой из 100 записей в длинном журнале; раунд, который отличается, не проходит проверку.

Устройства **, Telegram,**, `account.devices`. При каждом проходе считываются сессии аккаунта с `account.getAuthorizations`, список Telegram отображается в «Настройки» → «Устройства», и записывается: полностью, если он изменился с момента предыдущего прохода, с хешами сеансов `added` и `removed`, в противном случае — только его количество и SHA-256. Сохраняются модель устройства, платформа, приложение и версия, дата создания и последней активности, страна и регион; IP-адреса не сохраняются, поскольку экспорт доказательств выходит из-под вашего контроля. Собственная сессия сборщика активна постоянно, поэтому только активность других сессий считается изменением. `verify.py` сообщает, как часто список записывался, а также о каждой новой и завершённой сессии. Он считывает список только во время работы наблюдения.

Что они показывают: drand упорядочивает записи по общедоступному времени, а список устройств — это заявление Telegram, переданное через сборщик и подписанное им, как и любая другая запись.

**Журнал Cloudflare Gateway** (`cloudflare.gateway_dns`). Для сервера, который осуществляет разрешение через Cloudflare Gateway ([Gateway DNS](https://phishdestroy.io/tgwitness/ru/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)), каждый цикл копирует то, что Gateway зарегистрировал с момента предыдущего копирования: по одной записи за интервал не более трёх часов с указанием `from`, `until`, `location_id`, `address` сервера (если он задан) и `queries` в качестве `[at, name, type, rcode, decision, colo]`, в том числе в случае их отсутствия. Установите это в **«Журнал шлюза Cloudflare»**: учётная запись, местоположение, опциональный адрес и токен только для чтения (Account Analytics Read; Zero Trust PII Read для сохранения одного адреса общего местоположения). Панель проверяет их с помощью одного запроса перед сохранением; токен остается зашифрованным и никогда не попадает в журнал. В `verify.py` перечислены окна, наиболее часто искомые имена и время, не охваченное копией; запись, количество запросов которой не совпадает с количеством запросов, считается неудачной. Окно, содержащее более одной страницы запросов за одну секунду, сохраняет эту страницу и указывает, что остальная часть отсутствует. Копия представляет собой ответ Cloudflare, полученный через коллектор и подписанный им; в течение 24 часов любой, у кого есть токен только для чтения, может сравнить её с данными Cloudflare.
