Перейти к содержанию
9 минут чтения
Тема: Практика Telegram · Токены · Безопасность

Что делать, если токен Telegram-бота попал в Git или логи

Для примера разработчик обнаружил Telegram-токен в опубликованном коммите или журнале ошибок. Бот уже обслуживает клиентов, поэтому нужно одновременно прекратить использование старого секрета и восстановить рабочие подключения. Ниже порядок действий без публикации токена в командах и отчётах.

Сначала отзываем доступ по старому токену

Считайте токен скомпрометированным, если он оказался в доступном посторонним месте. Не ждите доказательств использования и не начинайте с удаления одной строки из последнего коммита. Копия могла уже попасть в клон, CI-артефакт, уведомление или индекс поиска.

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

От владельца бота откройте официальный @BotFather. Выберите нужного бота и выполните отзыв действующего API-токена с выпуском нового через управление API Token. В официальной документации для генерации нового токена указан /token; убедитесь, что старый секрет именно отозван, а не просто скопирован повторно из переписки. Не удаляйте самого бота.

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

Обновляем все потребители секрета

Составьте список мест, где токен действительно используется: веб-приложение, длительно работающие workers, планировщик, CI, отдельные интеграции, BotGate и сервер Mini App, проверяющий initData. Поиск должен учитывать конфигурацию процессов, а не только файл .env в одном checkout.

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

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

Проверяем новый токен без отправки сообщений

Выполните getMe и сравните полученный ID с ожидаемым ботом. Следующий CLI-пример для PHP 8.3+ с cURL допускает только два read-only метода. Он не печатает URL запроса, полный ответ и текст ошибки, которые могут попасть в журнал. Сохраните файл вне публичного каталога, задайте BOT_TOKEN через безопасное окружение.

PHP · check-bot.php
<?php
declare(strict_types=1);
if (PHP_SAPI !== 'cli') {
    http_response_code(404);
    exit;
}
function inspectBot(string $token, string $method): array
{
    if (!in_array($method, ['getMe', 'getWebhookInfo'], true)) {
        throw new InvalidArgumentException('Read-only method required');
    }
    $curl = curl_init('https://api.telegram.org/bot'.$token.'/'.$method);
    curl_setopt_array($curl, [CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 5, CURLOPT_TIMEOUT => 15]);
    try {
        $raw = curl_exec($curl);
        if ($raw === false) throw new RuntimeException('Transport error');
        $data = json_decode($raw, true, 32, JSON_THROW_ON_ERROR);
        if (curl_getinfo($curl, CURLINFO_HTTP_CODE) !== 200
            || !is_array($data) || ($data['ok'] ?? false) !== true
            || !is_array($data['result'] ?? null)) {
            throw new RuntimeException('API check failed');
        }
        return $data['result'];
    } finally {
        unset($curl);
    }
}
try {
    $token = getenv('BOT_TOKEN');
    if (!is_string($token) || $token === '') throw new RuntimeException('Missing token');
    $bot = inspectBot($token, 'getMe');
    $hook = inspectBot($token, 'getWebhookInfo');
    echo json_encode([
        'bot_id' => $bot['id'], 'username' => $bot['username'] ?? null,
        'webhook_configured' => ($hook['url'] ?? '') !== '',
        'pending_updates' => $hook['pending_update_count'] ?? null,
        'last_error_date' => $hook['last_error_date'] ?? null,
    ], JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT).PHP_EOL;
} catch (Throwable) {
    fwrite(STDERR, "Check failed; inspect private diagnostics without printing credentials.\n");
    exit(1);
}
Bash · Запуск проверки
php check-bot.php

Правильные bot_id и username подтверждают, что новый токен относится к нужному боту. Ошибка требует различить неверный секрет и недоступность сети в закрытой диагностике. Убедитесь также, что старый токен больше не авторизуется, используя изолированный read-only запрос без сохранения его в коде или журнале; один таймаут не подтверждает отзыв.

Сверяем webhook и следы изменения настроек

С новым токеном прочитайте getWebhookInfo и в закрытой среде сравните полный URL с вашей ожидаемой настройкой. Пример выше намеренно выводит только факт наличия адреса: это не проверка его правильности. Проверьте также allowed_updates, накопившиеся события и время последней ошибки.

Не предполагайте, что смена токена автоматически восстановила корректный webhook. Владелец утёкшего секрета мог изменить адрес. При необходимости зарегистрируйте известный правильный URL штатным механизмом приложения, сохранив нужные параметры и явную проверку входящих событий. Для прямого webhook используйте secret_token и проверку соответствующего заголовка; если этот секрет тоже раскрыт, замените его согласованно с приёмником.

Не передавайте drop_pending_updates=true ради «чистого старта»: это может удалить ожидающие события. Старые события проверяйте через обычную дедупликацию и бизнес-логику. После смены настройки убедитесь, что свежий тестовый update действительно дошёл и был обработан.

Просмотрите изменения меню, описания, прав и подозрительные отправки в доступных журналах. Отсутствие найденных следов не доказывает отсутствия доступа: Bot API не предоставляет универсальный полный аудит действий злоумышленника. Отдельно оцените, какие входящие данные могли уходить на чужой webhook.

Устраняем место утечки после отзыва

В Git удаление токена из текущего файла не удаляет его из старых коммитов. Сначала отзовите секрет, затем оцените необходимость очистки истории и согласуйте её с командой: переписывание меняет хеши коммитов, затрагивает ветки и клоны. Не запускайте случайный force push, пока другие продолжают работу со старой историей.

Следуйте инструкции хостинга по удалению чувствительных данных из истории, pull request, кэшей и связанных представлений. Учитывайте форки, локальные клоны и артефакты CI. Даже выполненная очистка не делает старый токен пригодным для повторного использования.

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

Исправьте первопричину: логирование полного URL api.telegram.org/bot<TOKEN>/..., заголовков Authorization, конфигурации или дампа объекта клиента. Добавьте маскирование до записи, исключите секреты из Git и проверьте secret scanning. .gitignore не прекращает отслеживание файла, который уже был закоммичен.

Если бот подключён через BotGate

Обновите токен у существующего бота через редактирование его настроек. Не создавайте второго бота ради замены секрета: приложения используют public ID существующей записи. После сохранения отдельно проверьте состояние Telegram webhook и его повторную регистрацию через предусмотренное управление сервисом, если она требуется.

Telegram-токен, API-ключ BotGate и webhook_secret — разные секреты. Меняйте также те, которые действительно попали в утечку; замена одного не отзывает остальные. Не подставляйте новый Telegram-токен вместо Bearer API-ключа в вызовах BotGate.

При утечке Telegram-токена злоумышленник мог подделывать подписанные им данные Mini App. После ротации проверьте серверную проверку initData и рассмотрите отзыв ранее выданных сессий за затронутый период. Простая замена токена не аннулирует собственные cookie-сессии приложения автоматически.

Подтверждаем восстановление работы

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

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