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

Налаштування бота-свідка

Нехай окремий процес перевіряє журнал і публікує підписані контрольні точки у вашому каналі.

Два хости, два ключі підпису

ХОСТИНГ / КОЛЕКТОРАкаунт + журнал

Ключ підпису колектора сеансів Telegram

Кінцева точка контрольної точки, доступна лише для читання

← запит на підписану відповідь →

HOST B / WITNESSПеревіряти + зберігати

Зафіксований відбиток колектора; окремий ключ підпису свідка

Власний журнал + токен бота

Witness → API бота Telegram →Ваш канал · підписані публікації TGW1

Witness самостійно здійснює перевірки. Доступ колектора обмежений лише читанням. Публікація через бота використовує з’єднання та токен Witness; сесія облікового запису не надається Witness.

03 / РІШЕННЯ ЩОДО КОНТРОЛЬНИХ ПУНКТІВПриклади відповідей

ОСТАННЄ ПРИЙНЯТЕ120 записівhead 9c7d…

НАСТУПНА ВІДПОВІДЬ128 записівhead a4f2…

Прийнято: кількість зростає, підпис перевірено, а ключ збігається. Свідок зберігає цю нову межу.

Усі приклади відповідей базуються на припущенні про наявність дійсного підпису та закріпленого ключа. Хеші тут наведено у скороченому вигляді. Сам по собі більший лічильник не може довести, що весь старий префікс залишився незмінним; порівняйте експорт із збереженими контрольними точками.

Підготуйте бота та канал

Створіть бота за допомогою BotFather і надайте йому дозвіл публікувати повідомлення у каналі, яким ви керуєте. Оберіть комп’ютер або сервер для роботи TgWitness. Окремий хост та оператор забезпечують більшу незалежність, ніж запуск другого процесу на сервері збирача даних.

Три кроки в розділі «Додаткові функції»

Доступ тільки для читання. Відкрийте «Додаткові налаштування» → «Бот у вашому каналі», створіть токен свідка та збережіть файл доступу. Це дозволяє читати контрольні точки та стан системи, але не розмови чи налаштування колектора.
Канал та інтервал. Введіть канал та адресу колектора, доступну для свідка. Збережіть файл налаштувань.
Запуск. Помістіть разом файли witness.json, witness-token.txt та bot-token.txt, створені на хості Witness. Виконайте наведені нижче команди в середовищі встановленого проєкту.

python -m tgwitness.witness run --config witness.json --check-config
python -m tgwitness.witness run --config witness.json

Завантаження файлів не запускає роботу TgWitness. Переконайтеся, що у каналі з’явився перший підписаний допис, а потім окремо збережіть відбиток відкритого ключа TgWitness.

Виберіть, як часто публікувати

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

Що саме підтверджує цей бот?

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

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

Перегляньте докази пізніше

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