TgWitness / Документация

Что проверено →

Часть страницы пока на английском: английский оригинал изменился после перевода.

Справочник / Доказательства

Экспорт аккаунта Telegram в подписанный архив

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

TgWitness / Документация · Доказательства и верификация

Доказательства и верификация

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

Экспорт данных с разных учетных записей может выполняться одновременно. Задание, предназначенное исключительно для экспорта (Takeout), ожидающее утверждения, освобождает соответствующую учетную запись, поэтому отдельный экспорт в режиме обычной сессии может начаться еще до завершения процесса утверждения. Активный процесс сбора данных по-прежнему резервирует эту учетную запись.

Как администратор установки выберите Главная → Экспорт моей учётной записи или Экспорт → Учётная запись Telegram → Настроить экспорт учётной записи. При необходимости войдите в систему, проверьте область действия и явно запустите экспорт. Непрерывное наблюдение не требуется. Сохраненные наблюдения — это отдельный экспорт существующего журнала; его ZIP-архив включает все источники независимо от фильтров журнала. Каждая рабочая область имеет свои собственные задания, идентификатор подписи и хранилище. Предоставленный доступ к панели, включая неограниченное разрешение на обычный экспорт, не позволяет открывать эти маршруты, действующие на уровне всей учетной записи.

Фильтры по отправителю и тексту раскрываются в разделе «Фильтр по отправителю или тексту сообщения». Раздел «Данные аккаунта и способ подключения» содержит дополнительные категории аккаунтов и выбор между Takeout и обычной сессией; в его сводке отображаются активные настройки даже в закрытом состоянии. При закрытии этих разделов их настройки сохраняются. Черновики экспорта и отчетов остаются в текущей сессии панели при смене представлений; они не сохраняются при перезагрузке браузера. Доступ к существующим заданиям сохраняется при выборе любого из вариантов экспорта.

Данный рабочий процесс экспортирует данные, доступные в данный момент для подключённой учётной записи. Метод Автоматический по умолчанию начинается с Telegram Takeout, который возвращает доступную историю в её текущем состоянии, включая покинутые каналы, сохраненные контакты и другие данные учётной записи. Если Telegram устанавливает период ожидания перед запуском Takeout, режим «Автоматический» сразу же переходит к обычному сеансу; в журнале фиксируется account_export.transport , а в подписанном журнале указывается использованный метод и изменение фиксируется как пропуск. Сессия Telegram Takeout вместо этого ожидает только подтверждения, а Обычная сессия никогда не запрашивает данные через Takeout. Секретные чаты фиксируются в режиме реального времени модулем «Secret Chat», а изменения — посредством наблюдения в реальном времени. Обычная сессия имеет иной охват и фиксирует неподдерживаемые категории.

Главная → Экспорт всего запускает экспорт всех типов чатов, всех типов вложений, профиля, контактов, фотографий профиля, историй, метаданных сеансов и других данных учётной записи во всех форматах: подписанный архив TgWitness с представлениями Telegram Desktop в форматах JSON и HTML. Выбор пункта Что экспортировать открывает форму, приведённую ниже, с теми же настройками по умолчанию.

Takeout — это официальный API экспорта, который также используется Telegram Desktop. TgWitness может записывать JSON, совместимый с Desktop, напрямую из собственного набора данных; импорт чужого архива не требуется. Идентификаторы чатов и сообщений доступны через оба канала передачи данных. Скорость экспорта и задержка одобрения Takeout зависят от ограничений Telegram для аккаунта, а также от того, является ли чат публичным или доступным для пересылки. Перед сравнением скорости измерьте одинаковый объем данных и настройки мультимедиа.

Для до 20 явно выбранных идентификаторов чатов экспорт через стандартный API определяет этих участников непосредственно перед рассмотрением полного списка диалогов учетной записи. Таким образом, читаемый открытый канал можно экспортировать, не присоединяясь к нему, даже если он отсутствует в списке диалогов. Для некешированных участников используется обычный список диалогов. Фильтр архива по-прежнему применяется: если Telegram не возвращает диалог, а заархивированные чаты исключены, неизвестный статус архива фиксируется как пропуск. Takeout сохраняет свою процедуру разделения диалогов по диапазонам. Ни один из способов не присоединяет пользователя к чатам и не изменяет разрешения на пересылку. В формате JSON, совместимом с Desktop, каналы, которые Telegram помечает как left, отображаются под left_chats, включая общедоступные каналы с правом чтения, к которым аккаунт не присоединился.

Как запросы FLOOD_WAIT, так и FLOOD_PREMIUM_WAIT приостанавливают работу на весь период, запрошенный сервером. Срок действия учетной записи сохраняется при повторных подключениях и перезапусках; более короткое последующее ожидание не может сократить его. Количество повторных попыток ограничено, отмена сохраняет запечатанные страницы, а учетные данные API не меняются для обхода ограничения по частоте запросов. Покупка Premium не производится.

Выберите, что собирать#

Настройки Значение
Цель Опишите, почему необходимо данное приобретение. Не указывайте здесь ненужные имена или конфиденциальные детали дела.
Язык отчёта Выберите язык меток в отчёте для чтения. Текст исходного сообщения остаётся неизменным; непереведённые метки шаблона используют английский язык. Язык фиксируется с помощью параметров подписанного задания.
Типы чатов / идентификаторы чатов Все выбранные типы или только перечисленные чаты; «Сохраненные сообщения» относятся к личным чатам. Архивированные чаты можно выбирать отдельно.
Даты UTC. В панели указаны даты «С» и «По» по календарю, включая оба дня. API использует включительные from_utc и исключительные to_utc; панель отправляет начало дня, следующего за датой «До». Пустой предел оставляет эту сторону неограниченной.
Идентификаторы отправителей Только сообщения от указанных отправителей; пустой список включает всех отправителей.
Текст содержит Литеральные фразы, нечувствительные к регистру, сопоставляются с помощью оператора OR. Условия «отправитель/дата/собственное сообщение» комбинируются с помощью оператора AND.
Собственные сообщения Сохраняйте только исходящие сообщения.
Типы медиафайлов Выберите категории вложений или сбросьте все, чтобы избежать загрузки файлов из сообщений.
Ограничения на файлы / общее количество медиафайлов Объём в MiB для каждого файла и общий объём загруженных медиафайлов в GiB. Текст, квитанции, читаемые отчёты и накладные расходы, связанные с ZIP, требуют дополнительного дискового пространства.
Категории аккаунтов Для профиля, контактов, фотографий профиля, историй, метаданных сеансов и других данных Takeout предусмотрены отдельные элементы управления.

Предустановка «Minimize» отключает файлы и метаданные аккаунтов. Фильтры отправителей и контента применяются до сохранения страниц сообщений и загрузки медиафайлов. Telegram по-прежнему передаёт страницы истории API, содержащие сообщения, необходимые для оценки этих фильтров: фильтрация не гарантирует, что неотборные сообщения никогда не поступят в оперативную память. Другие текущие наблюдения в рабочей области имеют собственные настройки области действия и срока хранения.

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

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

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

Номера сообщений и карта активности#

Каждый архив учётной записи содержит message-gaps.json и map.html. Каналы и супергруппы нумеруют свои сообщения по чатам, поэтому каждый отсутствующий номер между первым и последним экспортированным сообщением соответствует сообщению данного чата. Личные чаты, боты и базовые группы используют одну последовательность номеров для всей учётной записи: отсутствующий номер в этом случае принадлежал какому-либо чату. Принадлежность к конкретному чату подтверждается, если экспортированный ответ или закреплённое сообщение указывает на этот номер; в противном случае определяется, какие чаты были активны в промежутке между соседними сообщениями, а остальные сообщения относятся к чатам, не включённым в экспорт. Каждый прогон содержит своё временное окно, соседние сообщения, доли по каждому чату и метку достоверности. Указывается ограниченная область (фильтры, невыбранные чаты), поскольку в таком случае отсутствующие номера включают сообщения, не входящие в выбранный набор.

map.html Отображает календарь, чаты в динамике во времени, а также сетку по дням недели и часам для сообщений и отсутствующих номеров, включая таблицы по каждому чату и самым длинным сериям сообщений. Страницы чатов отображают собственный календарь, динамику участников в группах во времени, а также отметку в транскрипте в местах отсутствия сообщений. verify.py пересчитывает message-gaps.json на основе подписанных страниц и отклоняет измененный файл.

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

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

Отчёт, охват и проверка#

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

Команда «Pause» приостанавливает текущую операцию с аккаунтом. При перезапуске приложения незавершённая работа остаётся доступной для явного возобновления. Сессия Takeout, срок действия которой истек, требует явного возобновления; изменение диапазонов фрагментов Telegram может потребовать нового сбора данных. При возобновлении сохраняются предыдущие наблюдения, поэтому длительный экспорт не представляет собой единый атомарный снимок. Другие операции по смене аккаунта и конфликтующие экспорты блокируются во время сбора данных. Перед удалением рабочего пространства дождитесь завершения упаковки.

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

Если Telegram прервет авторизацию аккаунта во время инвентаризации, сбора истории или вложений, задание приостанавливается, не помечая незавершённую страницу как завершённую. Подключитесь к тому же аккаунту заново и возобновите задание, чтобы продолжить с последней сохраненной страницы. Заполнители недоступных сообщений перемещают курсор по истории, но не завершают чтение: более старые доступные сообщения по-прежнему запрашиваются, а заполнитель не отображается как сохраненное сообщение или подтверждённое удаление.

The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: Coverage and missing material. Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed.

Готовые ZIP-архивы остаются доступными для повторной загрузки и загрузки по HTTP-диапазону. Архив учетной записи содержит файлы manifest.json, manifest.sig, подписанный файл job.json, inventory.json, папку receipts/, авторитетные файлы data/*.jsonl, выбранные файлы media/, читаемый HTML-файл и верификатор. Закрепите отпечаток сборщика через независимый канал, а затем проведите верификацию с помощью доверенной установки. Панель сохраняет архив под именем tgwitness-account-export-EXPORT_ID.zip; запечатанный снимок включает его в свой архив доказательств как account-export.zip. Используйте имя имеющегося у вас файла:

python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256

Для архивов, расширенный объём которых превышает 4 ГиБ, необходимо явно задать соответствующий --max-gib. Панель проверяет свои аутентифицированные, завершенные локальные архивы, используя их заявленный размер в развернутом виде и опубликованный дайджест ZIP; внешний CLI сохраняет свой независимый лимит размера. Проверьте перед открытием читаемого HTML. Встроенный в архив верификатор удобен, но верификатор, полученный независимо, позволяет избежать доверия к исполняемому коду, поставляемому вместе с доказательством.

Подпись Ed25519 и хеши SHA-256 позволяют обнаруживать изменения после фиксации соответствующих байтов сборщиком. Проанализируйте этот результат вместе с зафиксированной областью сбора, интервалами сбора, внешними квитанциями с временными метками и проверками происхождения, доступными для выбранного развертывания. Более поздние наблюдения записываются отдельно с сохранением ранее зафиксированных версий.

Подготовьте раскрытие информации для юриста или другого получателя#

После загрузки готового экспорта сохраните исходный файл ZIP и откройте index.html из извлечённой копии. В отчёте объясняются его объем, доступный охват и ограничения. Ссылки на записи в отчёте объединяют ссылку на архив, путь к документу и номер записи, чтобы получатель мог найти ту же запись в HTML-файле или на распечатке. Пример с решением см. по ссылке открыть вымышленный отчёт.

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

  1. Укажите цель раскрытия информации и выберите даты, идентификаторы отправителей и критерии по тексту.
  2. Выберите, сохранять ли идентификационные данные, раскрывать только указанных участников или использовать псевдонимы для всех. В любом режиме с использованием псевдонимов также заменяются идентификаторы/названия чатов и идентификаторы сообщений. Псевдонимы остаются неизменными в пределах одного раскрытия информации и меняются между независимо подготовленными раскрытиями.
  3. Можно сохранить текст сообщения, полностью его опустить или добавить конкретные имена/фразы для маскировки. В приватных режимах инструмент также маскирует известные скрытые имена отправителей и альтернативные имена пользователей, идентификаторы отправителей в виде целых токенов, имена в прямых чатах, ссылки, адреса электронной почты и строки, похожие на номера телефонов. Сопоставление по известным именам учитывает преобразование регистра символов в Unicode, включая Straße/STRASSE. Общие названия групп/каналов не удаляются автоматически из текста сообщения. Если превышен лимит маскировки известных идентификаторов, сузьте исходный экспорт или опустите текст; инструмент не будет молча пропускать последующие имена. Это правила, действующие в рамках разумных возможностей, а не общая анонимизация.
  4. Не включайте файлы, если они не нужны получателю. Включенные исходные файлы сохраняют свои пиксели, аудио, текст и метаданные. Инструмент не анонимизирует их.
  5. Просмотрите предварительный просмотр с подсчётом, предупреждениями и образцами преобразованных сообщений, а затем явно подтвердите создание. Образцы ограничены 12 сообщениями и 2 000 текстовых символов в каждом. Это пример, а не полный обзор результата. Изменение настроек требует повторного предварительного просмотра. Срок действия предварительного просмотра истекает через 15 минут и привязан к данной сессии администратора и точному исходному ZIP; его нельзя повторно использовать после создания. Новый предварительный просмотр аннулирует предыдущий для той же задачи и сессии.
  6. Ознакомьтесь с полным результатом index.html и messages.jsonl локально перед передачей. Если в нём обнаружится ненужная информация, создайте новое раскрытие с более строгими исключениями. Не редактируйте подписанный ZIP на месте.

Сообщения, не включённые в выборку#

Предварительный просмотр. Раскрытие информации не выглядит полным, если оно таковым не является. Внутри каждого чата, в котором сохранено хотя бы одно раскрытое сообщение, сообщения, не вошедшие в выделенный фрагмент, отображаются в виде маркеров, [withheld by selection — rule: sender] (или text, period). Выберите «Сообщения, не включённые в выделение»: по одному маркеру для каждой серии последовательных нераскрытых сообщений (по умолчанию) или по одному для каждого сообщения. Маркеры содержат только правило и счётчик, но никогда не содержат текст, отправителя, дату или файлы. Чаты, в которых нет раскрытых сообщений, полностью исключаются, поэтому пакет не показывает их существование.

Раскрытые ответы указывают, на что они отвечают: на сообщение, включённое в эту копию, на сообщение, исключённое при отборе, или на сообщение, которого нет в исходном экспорте (удалённое до экспорта или никогда не экспортированное; экспорт не может определить, что именно). Удержанное сообщение, на которое отвечает раскрытый ответ, всегда получает собственный маркер, поэтому ответ указывает на запись, объясняющую, почему оно пустое. Эти три состояния отличаются от удалений и пробелов в наборе данных, которые относятся к исходному экспорту.

В messages.jsonl (формат tgwitness-account-disclosure-v2) каждое сообщение имеет state: disclosed, либо withheld с rules и count. Открытый ответ содержит reply_to с целью id и state (disclosed, withheld, not_in_source). Манифест учитывает раскрытые сообщения, чаты, мультимедиа и withheld сообщения. verify.py Отклоняет маркер, несущий содержимое, и ответ, указывающий на запись, отсутствующую в пакете; пакеты версии 1 проверяются как и ранее.

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

В его манифесте указаны производные файлы, общедоступная политика и хеш исходного ZIP-архива. Проверка позволяет убедиться в целостности файлов, а также — при наличии локального исходного кода — в соответствии ссылок исходного кода. Панель сохраняет копию для обмена под именем tgwitness-disclosure-DISCLOSURE_ID.zip:

python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256
python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip

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

Передача копии и облачный сбор#

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

GitHub Actions поддерживает экспорт данных всей учётной записи и выбранных чатов через Takeout или стандартный API, а также журнал событий одного чата. Руководство по хостируемому сбору данных объясняет проверку настроек и ограничение по длительности 120 минут. Чтобы проверить копию для обмена, полученную из хостируемого сбора данных, сравните хэш источника с исходным архивом и проверьте аттестацию этого архива с помощью проверок , специфичных для режима .

Формат доказательств · Отчёты по делам