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

Що було протестовано →

Деякі частини цієї сторінки досі залишаються англійською мовою: англійський оригінал зазнав змін після перекладу.

Довідка / Докази

Telegram · Експорт облікового запису

Експортуйте те, що обліковий запис може переглянути зараз: обсяг даних, завдання, які можна відновити, підписаний архів та мінімізовані копії для спільного доступу.

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

Докази та верифікація

Експорт даних з облікового запису резервує слот збору даних для цього облікового запису. Спостереження в режимі реального часу може продовжуватися під час пошуку, завантаження, перевірки та пакетування архіву. Перед початком іншого збору даних, що перекривається, слід призупинити інше завдання з історії або експорту. Призупинення архівування не зупиняє спостереження, а призупинення спостереження зберігає завдання архівування.

Експорт даних з різних облікових записів може виконуватися одночасно. Завдання, призначене виключно для вивантаження даних, яке очікує на затвердження, звільняє відповідний обліковий запис, тому окремий експорт у режимі звичайної сесії може розпочатися ще до завершення процесу затвердження. Активна операція збору даних все ще резервує цей обліковий запис.

Як адміністратор установки, виберіть Головна → Експортувати мій обліковий запис або Експорт → Обліковий запис Telegram → Налаштувати експорт облікового запису. У разі потреби увійдіть у систему, перегляньте обсяг даних та явно запустіть експорт. Постійне спостереження не є обов’язковим. Збережені спостереження — це окремий експорт існуючого журналу; його ZIP-архів містить усі джерела незалежно від фільтрів журналу. Кожна робоча область має власні завдання, ідентифікатор підпису та сховище. Наданий доступ до панелі, включаючи необмежений дозвіл на звичайний експорт, не дозволяє відкривати ці маршрути на рівні всього облікового запису.

Фільтри за відправником та текстом повідомлення розгортаються в розділі «Фільтрувати за відправником або текстом повідомлення». Розділ «Дані облікового запису та спосіб підключення» містить опціональні категорії облікових записів та вибір між режимами «Takeout» і «звичайна сесія»; у його зведенні відображаються активні параметри навіть у закритому стані. Закриття цих розділів не призводить до втрати їхніх налаштувань. Чернетки експорту та звітів залишаються у поточній сесії панелі під час зміни переглядів; вони не зберігаються після перезавантаження браузера. До існуючих завдань можна отримати доступ з будь-якого варіанту експорту.

Цей робочий процес експортує дані, до яких наразі має доступ підключений обліковий запис. Метод Автоматично за замовчуванням починається з Telegram Takeout, який повертає доступну історію в її поточному стані, включаючи залишені канали, збережені контакти та інші дані облікового запису. Якщо Telegram встановлює період очікування перед початком Takeout, «Автоматично» одразу продовжує роботу зі звичайною сесією; журнал фіксує account_export.transport , а підписаний інвентар вказує на використаний метод і зазначає цю зміну як пропуск. Сесія Telegram Takeout лише очікує на затвердження, а Звичайна сесія взагалі ніколи не запитує про Takeout. Таємні чати записуються в режимі реального часу модулем «Таємний чат», а редагування — шляхом спостереження в режимі реального часу. Звичайна сесія має інший обсяг охоплення та фіксує категорії, що не підтримуються.

Головна → Експортувати все запускає експорт усіх типів чатів, усіх типів вкладень, профілю, контактів, фотографій профілю, історій, метаданих сеансів та інших даних облікового запису у всіх форматах: підписаний архів TgWitness із JSON- та HTML-переглядами Telegram Desktop. Вибрати, що експортувати відкриває форму нижче з тими самими значеннями за замовчуванням.

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 не оновлюються для обходу обмеження частоти запитів. Придбання преміум-доступу не здійснюється.

Виберіть, що збирати#

Налаштування Значення
Мета Зафіксуйте, чому це придбання є необхідним. Не вказуйте тут зайвих імен або конфіденційних деталей справи.
Мова звіту Оберіть мову міток у звіті для читання. Текст оригінального повідомлення залишається незмінним; неперекладені мітки шаблону використовують англійську мову. Мова фіксується за допомогою параметрів підписаного завдання.
Типи чатів / ідентифікатори чатів Усі вибрані типи або лише перелічені чати; «Збережені повідомлення» належать до приватних чатів. Архівні чати можна вибирати окремо.
Дати UTC. У календарі панелі вказано як дату початку, так і дату закінчення. API використовує дати з включенням from_utc та виключні to_utc; панель надсилає початок дня, що настає після дати «До». Порожня межа залишає цю сторону необмеженою.
Ідентифікатори відправників Тільки повідомлення від зазначених відправників; порожній список включає всіх відправників.
Текст містить Літеральні фрази, що не враховують регістр, поєднуються за допомогою оператора «АБО». Умови «відправник», «дата» та «власне повідомлення» поєднуються за допомогою оператора «І».
Власні повідомлення Зберігайте лише вихідні повідомлення.
Типи медіа Виберіть категорії вкладень або очистіть усі, щоб уникнути завантаження файлів повідомлень.
Обмеження на файли / загальний обсяг медіафайлів Обсяг завантажених медіафайлів у GiB та обсяг кожного файлу в MiB. Текст, квитанції, звіти для читання та накладні витрати ZIP вимагають додаткового дискового простору.
Категорії облікових записів Профіль, контакти, фото профілю, історії, метадані сеансів та інші дані Takeout мають окремі елементи керування.

Пресет колекції «Minimize» вимикає файли та метадані облікових записів. Фільтри відправників та вмісту застосовуються до збережених сторінок повідомлень та завантажених медіафайлів. Telegram все ще передає сторінки історії API, що містять повідомлення, необхідні для оцінки цих фільтрів: фільтрування не гарантує, що відфільтровані повідомлення ніколи не потраплять до оперативної пам’яті. Інші поточні спостереження у робочому просторі мають власні параметри обсягу та зберігання.

Історія фотографій профілю, історії, метадані сеансів та інші дані облікового запису вибираються за замовчуванням. Вимкніть їх, а також профіль і контакти, якщо у справі потрібні лише повідомлення. Якщо вкладення або метадані не потрібні, їх виключення під час збору даних дозволить уникнути збереження ще однієї приватної копії в цьому експорті.

Корисні дані фотографій використовують варіант нерухомого зображення, визначений у їхніх метаданих та хеш-маніфестах, включаючи фотографії з анімованим варіантом аватара. Ця анімація не замінює вибране нерухоме зображення. Дані, розмір яких менший або більший за спостережуваний, реєструються як невдале вкладення, а змінене представлення під час оновлення посилання на файл відхиляється. Ці помилки залишають архів неповним, зберігаючи при цьому записи повідомлень. Незалежна верифікація також відхиляє збережені вкладення, довжина яких із підписом суперечить їхньому спостережуваному розміру або представленню, у тому числі в старих архівах.

Якщо виділене медіа-з’єднання тимчасово виходить з ладу, для читання вкладень використовується стандартне файлове з’єднання. Через хвилину у фоновому режимі відбувається повторна спроба встановити виділене з’єднання, при цьому завантаження продовжуються. Цей механізм відновлення зберігає налаштований ліміт з’єднань і застосовується окремо для кожного центру обробки даних. Повідомлення про спам у Telegram та помилки авторизації все одно передаються далі.

Номери повідомлень та карта активності#

Кожен архів облікового запису містить message-gaps.json та map.html. Канали та супергрупи нумерують свої повідомлення за кожним чатом, тому кожен відсутній номер між першим і останнім експортованим повідомленням є повідомленням цього чату. Приватні чати, боти та звичайні групи використовують одну послідовність номерів для всього облікового запису: відсутній номер у цьому випадку належав якомусь чату. Його чат підтверджується, коли експортована відповідь або позначка вказує на цей номер; в іншому випадку визначається, які чати були активними в проміжку часу між сусідніми повідомленнями, а решта приписується чатам, що не входять до експорту. Кожен прогін містить своє часове вікно, сусідні повідомлення, кількість повідомлень у кожному чаті та позначку достовірності. Вказується обмежений обсяг (фільтри, невибрані чати), оскільки у такому разі відсутні номери включають повідомлення, що не входять до вибраного набору.

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

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

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

Підсумок, охоплення та перевірка#

Кожне завдання фіксує свої параметри та ідентифікацію облікового запису. Інвентар та збережені сторінки підписуються; у квитанціях сторінок фіксуються хеші, курсори, час, результати обробки вкладень та попередні квитанції. Лише зафіксовані сторінки враховуються у прогресі. При перезапуску/відновленні ці записи перевіряються перед продовженням роботи. Змінений обліковий запис, змінена підписана сторінка або невідповідний ланцюжок квитанцій відхиляються. Параметри не можна редагувати в процесі збору даних: для іншого обсягу даних слід запустити нове завдання.

Функція «Pause» призупиняє поточну операцію з обліковим записом. Перезапуск програми залишає незавершену роботу доступною для явного відновлення. Сесія Takeout, термін дії якої закінчився, вимагає явного відновлення; зміна діапазонів фрагментів Telegram може вимагати нового збору даних. Функція «Resume» зберігає попередні спостереження, тому тривалий експорт не є одним атомарним знімком. Інші операції зі зміною облікових записів та конфліктуючі експорти блокуються під час збору даних. Перед видаленням робочого простору дочекайтеся завершення пакування.

Функція «Продовжити» відображає повідомлення Перевірка збережених даних експорту… одразу ж і перевіряє збережений вміст у фоновому режимі перед зв’язуванням із 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-range. Архів облікового запису містить файли 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 хвилин. Щоб перевірити копію для спільного доступу, отриману з хостингового збору даних, порівняйте її вихідний хеш із оригінальним архівом та перевірте засвідчення цього архіву за допомогою перевірок , специфічних для режиму .

Формат доказів · Звіти про справи