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

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

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

Telegram · Часові мітки

Часові мітки RFC 3161 для підписаних контрольних точок: що надсилається до центру авторизації та як перевіряється відповідь.

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

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

TgWitness формує запити за стандартом RFC 3161 та перевіряє відповіді служб міток часу (TSA). Ця ручна процедура не передбачає ні вибору TSA, ні надсилання даних; режим доказового збору виконує обидві ці дії за графіком (формат доказового збору). Підготовлений запит ще не є міткою часу.

Що фіксує цей журнал доказів#

Блок-схемаСпостереження за акаунтами → Ланцюжок SHA-256 та підписи Ed25519; Ланцюжок SHA-256 та підписи Ed25519 → Підписаний контрольний пункт; Підписаний контрольний пункт → Хеш з точністю до байта та випадковий нонс; Хеш з точністю до байта та випадковий нонс → Запит RFC 3161; Запит RFC 3161 → Незалежна TSA; Незалежна TSA → Підписана відповідь TSA; Підписаний контрольний пункт → Перевірка даних, одноразового коду та явного довірчого сертифіката; Підписана відповідь TSA → Перевірка даних, одноразового коду та явного довірчого сертифікатаСпостереження заакаунтамиЛанцюжок SHA-256 тапідписи Ed25519Підписаний контрольнийпунктХеш з точністю добайта та випадковийнонсЗапит RFC 3161Незалежна TSAПідписана відповідьTSAПеревірка даних,одноразового коду таявного довірчогосертифіката
Діаграма у вигляді тексту
  1. Спостереження за акаунтами → Ланцюжок SHA-256 та підписи Ed25519
  2. Ланцюжок SHA-256 та підписи Ed25519 → Підписаний контрольний пункт
  3. Підписаний контрольний пункт → Хеш з точністю до байта та випадковий нонс
  4. Хеш з точністю до байта та випадковий нонс → Запит RFC 3161
  5. Запит RFC 3161 → Незалежна TSA
  6. Незалежна TSA → Підписана відповідь TSA
  7. Підписаний контрольний пункт → Перевірка даних, одноразового коду та явного довірчого сертифіката
  8. Підписана відповідь TSA → Перевірка даних, одноразового коду та явного довірчого сертифіката

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

Процедура#

Верифікатор журналу повідомляє про кроки назад та значення observed_at, які неможливо проаналізувати, у chronology, якщо такі є, та включає попередження у вихідні дані команди. Він зберігає підписані часові мітки та все одно перевіряє їхні підписи. Крок назад може бути наслідком корекції годинника, тому перевірте його за допомогою записів годинника хоста. Незалежний час отримується з перевірених зовнішніх міток часу, повідомлень свідків, зчитаних з їхньої публічної сторінки t.me, та раундів drand; параметр --strict регулює фіксацію підписувачів та підтримувані формати.

Записані значення drand проходять офлайн-перевірку на структурну та хеш-самоузгодженість. Команда --check-drand порівнює вибрані записані раунди з відповідями ретрансляторів HTTPS; результат вказує, скільки раундів було порівняно та які ретранслятори відповіли, а порівняні раунди забезпечують автентифіковану нижню часову межу.

  1. Збережіть відбиток ключа колектора через окремий надійний канал; він ідентифікує колектор незалежно від перевіреного ZIP-файлу.
  2. У розділі «Експорт» → «Підготувати запит на часові мітки» завантажте ZIP-файл із запитом для обраної робочої області. Розпакуйте файли checkpoint.json, timestamp.tsq, SHA256SUMS та README.txt. Не змінюйте байти контрольних точок.
  3. Оберіть TSA, що відповідає вимогам розслідування. Надішліть timestamp.tsq, використовуючи задокументований метод, а також application/timestamp-query для HTTP-сервісу. Збережіть оригінальну бінарну відповідь як timestamp.tsr, кінцеву точку, час отримання та результат запиту. Запит містить хеш та нонс, а не повідомлення; метадані мережі все одно розкривають зміст запиту.
  4. Отримайте довірений кореневий сертифікат незалежно від відповіді, а також усі необхідні проміжні сертифікати. Сертифікат у відповіді не стає довіреним лише тому, що він там міститься.
  5. З надійної інсталяції TgWitness перевірте:
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem

За потреби додайте --intermediates tsa-intermediates.pem. OpenSSL не потрібен: підпис, посилання на сертифікат підпису та ланцюжок перевіряються в Python бібліотекою cryptography — тим самим кодом, що використовує verify.py --tsa-ca. openssl ts -verify лишається незалежною другою перевіркою для експерта, якому вона потрібна.

  1. Експортуйте ZIP-файл із підписаним журналом після контрольної точки, щоб він містив цей префікс. Перевірте за допомогою незалежно відомого відбитка:
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json

Це свідчить про те, що експорт містить префікс із часовим штампом. Скрипт verify.py зчитує квитанції з часовими штампами лише з архіву ZIP, де їх зберігає режим доказів; ручна відповідь перевіряється на кроці 5 і охоплює записи аж до цього контрольного пункту.

  1. Зберігайте ZIP-архів, контрольну точку, запит, відповідь, ланцюжок сертифікатів, результати перевірки та запис про передачу поза межами колектора. Повторіть перевірку після отримання.

Щоб підготувати запит із збереженої контрольної точки:

python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip

Під час підготовки JSON канонізується, а відповідний контрольний пункт включається до архіву. Для перевірки TSA використовуйте байти контрольного пункту з цього архіву, навіть якщо вхідний файл містив інші пробіли.

Межі верифікації#

Перевірити Поточна поведінка
Дані SHA-256 точних байтів контрольної точки має збігатися з відповіддю
Запит За допомогою --request перевіряються оригінальний запит та нонс
Підпис TSA Підпис, сертифікат підпису та його ланцюжок до явно вказаного CA перевіряються на момент мітки часу
Підпис колектора Окремо перевірено верифікатором журналу за допомогою закріпленого ключа
Скасування Режим доказів зберігає докази OCSP/CRL, які перевіряє verify.py
Заплановане подання Режим «Докази», що вмикається при кожному завданні налаштування

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

Відповідь TSA прив’язує надіслані байти контрольної точки до зазначеного часу. Перевірте цей результат, зіставивши його із записами збору даних та верифікацією середовища для обраного режиму. Режим доказів включає кваліфікований TSA уряду Бельгії (http://tsa.belgium.be/connect; відповіді RFC 3161 підписані, тому звичайний HTTP не послаблює їх). Якщо кореневий сертифікат цього постачальника передати до --tsa-ca, verify.py повідомляє про кваліфіковану мітку часу eIDAS та її одиницю виміру часу; Регламент (ЄС) № 910/2014, стаття 41(2), передбачає точність часу та цілісність пов’язаних даних.

Відкликання сертифіката підпису#

Відразу після кожної відповіді режим доказів отримує докази скасування для сертифіката підпису TSA: відповідь OCSP з адреси AIA OCSP сертифіката, або ж CRL з його точки розповсюдження (не більше 4 МіБ). Він зберігається поруч із відповіддю як checkpoint-N.<service>.ocsp або .crl та експортується разом із нею. Невдале отримання ніколи не затримує мітку часу; запис anchor.completed вказує її як unavailable із зазначенням причини.

verify.py перевіряє підпис відповіді OCSP (підпис емітента або сертифікат відповідача, який емітент надав для підписання OCSP), ідентифікатор сертифіката та статус, а також те, що відповідь була видана не раніше genTime або була на той момент ще чинною (nextUpdate). Для CRL перевіряється підпис емітента, те саме часове вікно та відсутність серійного номера у списку. Потім він повідомляє: signing certificate not revoked as of <time> (OCSP|CRL), про невдалу перевірку, або revocation not checked (no OCSP/CRL in the archive). Сертифікат підпису, скасований у момент genTime або раніше, не проходить перевірку; пізніша скасування відображається як попередження.

Реєстрація доказів та поновлення (RFC 4998)#

Часова мітка за стандартом RFC 3161 зберігає свою чинність лише доти, доки діють її алгоритм хешування, ключ підпису та сертифікат TSA; при цьому справа може тривати довше, ніж термін їхньої дії. Режим доказів також зберігає запис доказів за стандартом RFC 4998 (ERS) для кожної збереженої контрольної точки та оновлює його.

Під час кожного проходу перевірки контрольні точки, для яких ще немає запису, додаються до хеш-дерева, а налаштовані TSA по черзі запитуються щодо однієї мітки часу, що відповідає кореню дерева. Кожна контрольна точка отримує checkpoints/anchors/checkpoint-N.ers: EvidenceRecord у якому ArchiveTimeStampSequence містить одну ArchiveTimeStampChain з ArchiveTimeStamp , що містить скорочене хеш-дерево для цієї контрольної точки та маркер TSA. Запис може містити хеші сусідніх контрольних точок; валідатори, такі як EU DSS, попереджають про це. Експорт ASiC-E також містить META-INF/evidencerecord.ers з META-INF/ASiCEvidenceRecordManifest.xmlзапис доказів для об’єктів даних контейнера (ETSI EN 319 162-1). Експорт у форматі ZIP містить записи контрольних точок у anchors/.

Оновлення здійснюється відповідно до розділу 5 стандарту RFC 4998, при цьому додається лише:

Поновлення Коли Що нанесено штампом
Поновлення часової мітки Термін дії сертифіката підпису найновішого токена закінчується через N місяців (за замовчуванням — 6), хеш його підпису позначено як слабкий або за запитом Хеш попереднього токена, той самий алгоритм; мітка додається до останнього ланцюга
Оновлення хеш-дерева Алгоритм хешування ланцюга позначено як слабкий або за запитом H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) завдяки більш надійному алгоритму (за замовчуванням — SHA-512); додається новий ланцюг

Кожне оновлення зберігається у новому файлі, checkpoint-N.renewal-K.ers; попередні файли та ланцюги залишаються байт за байтом незмінними. Доказ сягає аж до першого часового штампу лише в тому випадку, якщо кожне ланка перевіряється послідовно, тому слід здійснювати оновлення, поки найновіший токен ще є дійсним: до того, як закінчиться термін дії його сертифіката підпису, зникне інформація про його скасування або буде зламано його хеш-або алгоритм підпису. Пізніше оновлення додає штамп, але не подовжує попередній доказ.

Цикл фонової перевірки в режимі підтвердження перевіряє політику щодня та за запитом (evidence_record.demand_renewal). Кожна спроба реєструється у журналі як evidence_record.created або evidence_record.renewed з зазначенням служби, часу, алгоритму хешування, кореня дерева, діапазону контрольних точок, ok та помилками; нечитабельні записи надходять до evidence_record.check_failed. У разі невдачі TSA повторюється з відстрочкою, що залежить від маркування контрольних точок, яка обліковується окремо, тоді як виконується спроба для наступного TSA у списку. Політика (months_before_expiry, weak_algorithms, algorithm, stronger_algorithm) — це параметр профілю evidence_record_policy; панель поки що не має засобів керування цим параметром.

Перед записом колектор перевіряє кожен новий запис на відповідність його контрольному пункту та підпису TSA. verify.py перевіряє кожен запис в експорті: хеш-дерева, токени, порядок ланцюгів та поновлення, а також повідомляє найраніший підтверджений час та стан найновішого штампа. EU DSS зчитує ті самі записи з контрольною точкою як відокремлені дані.

Регламент (ЄС) № 2024/1183 (eIDAS 2.0) доповнив Регламент (ЄС) № 910/2014 положеннями щодо кваліфікованого електронного архівування та кваліфікованих електронних реєстрів. TgWitness записує записи у стандартних форматах, але не є довірчою службою; його архів та журнал не мають кваліфікованого статусу. Кваліфікований постачальник послуг повинен, серед іншого:

  • Архівування (статті 45i та 45j): кваліфікований постачальник довірчих послуг зберігає дані протягом встановленого законом або договором строку зберігання, у формі, що забезпечує їх довговічність та читабельність після закінчення строку технологічної придатності та захист від втрати й зміни, із автоматизованим звітом про цілісність для уповноважених сторін, що покладаються на дані, від початку зберігання до моменту їх отримання. Стаття 45i(2) передбачає гарантію цілісності та походження для такої послуги.
  • Реєстри (статті 45k та 45l): реєстр, створений та керований одним або кількома кваліфікованими постачальниками трастових послуг, який встановлює походження записів, упорядковує їх у унікальному та хронологічному порядку, а також забезпечує миттєве виявлення будь-яких подальших змін. Журнал TgWitness має хеш-ланцюг і підписаний власним ключем збирача, що саме по собі не є кваліфікованим реєстром.
  • Обидва: статус кваліфікованого суб’єкта, наданий наглядовим органом, та внесення до списку довірених суб’єктів (статті 21 та 22), зобов’язання, передбачені статтею 24, оцінка відповідності щонайменше раз на 24 місяці (стаття 20) та еталонні стандарти, визначені в імплементаційних актах відповідно до статей 45j(2) та 45l(2).

Кваліфіковані часові мітки від кваліфікованого TSA (статті 41 та 42) зберігають власну презумпцію щодо кожного токена; поновлення не створює такої презумпції для запису в цілому.

Запис про передачу#

Зафіксуйте ідентифікатор справи, відправника та одержувача, час передачі за UTC та її джерело, мету, імена файлів/значення SHA-256, відбиток колектора, діапазон послідовностей, відомі пропуски, версію верифікатора та результат верифікації. Підпишіть та зберігайте цей запис незалежно у рамках процедур вашої організації. Система зберігання записів для декількох користувачів у TgWitness не реалізована.

Перевірка служби в режимі реального часу, 9 листопада 2026 року#

До кожної служби за замовчуванням було надіслано один запит RFC 3161. Обидві служби задовольнили його.

Сервіс Відповісти Одиниця підписання Результат перевірки
http://tsa.belgium.be/connect Згода, політика 2.16.56.13.6.3.1.1000 Одиниця часової мітки 202301 Кваліфікований часовий штамп eIDAS
https://freetsa.org/tsr Згода FreeTSA Часова мітка RFC 3161

Бельгійський сертифікат підпису містить заяву про відповідність qcStatements та відповідає одиниці, записаній у верифікаторі. Локальні тести також використовують синтетичний CA/TSA для перевірки відхилення змінених даних, зміненого нонсу та неправильного CA.

10 листопада 2026 року бельгійський OCSP-респондер, сертифікат делегованого респондера, відповів «good» для одиниці часової мітки 202301. OCSP-адреса FreeTSA (порт 2560) не відповіла протягом 40 секунд від тестового хосту; замість цього було використано її CRL (PEM, 1 КБ).