Инъекция в SQLite: как защитить Telegram-бота
Взлом Telegram-бота через инъекцию в SQLite обычно начинается с некорректного формирования SQL-запроса. Пользовательский ввод из команды, callback-кнопки или webhook-обработчика добавляется к тексту запроса и начинает влиять на его логику. Если база данных содержит токен бота, сообщения или учётные данные, последствия могут выходить далеко за пределы одной неудачной операции.
Уязвимость относится к уровню приложения, а не к самому Telegram. Бот получает управление через доверенный токен, но его внутренняя логика может раскрыть этот секрет или изменить данные. Основная защита заключается в параметризации запросов, изоляции секретов, ограничении доступа и своевременном выявлении подозрительных запросов.
Как опасные данные попадают в SQL-запрос
Telegram-боты часто работают с локальной базой SQLite: хранят пользователей, диалоги, настройки, очереди задач и историю действий. Источниками ввода служат команды, анкеты, файлы,deep-link-ссылки, запросы кнопок и данные, переданные через webhook. Разработчик принимает эти значения за обычные строки и передаёт их драйверу базы данных.
Опасность возникает при конкатенации: текст запроса и пользовательское значение соединяются в одну SQL-команду. Значение, предназначенное для поиска записи, может изменить условие, добавить нежелательную операцию или вызвать ошибку. Экранирование кавычек снижает риск, но не заменяет правильную параметризацию.
Надёжный подход отделяет структуру запроса от его данных. В Python это реализуется через заполнители ? или именованные параметры драйвера sqlite3. Тогда ввод передаётся отдельно от SQL и обрабатывается как значение, даже если содержит специальные символы.
Последствия для данных и функций бота
При успешной SQL-инъекции нарушитель может читать таблицы, недоступные обычной команде, изменять записи или обходить проверки авторизации. Если бот хранит состояние диалогов, возможна подмена ответов, удаление очередей и искажение бизнес-логики. Массовый некорректный ввод способен также вызвать отказ в обслуживании из-за блокировок и повреждения базы.
Особую опасность представляет токен бота. Получив его, злоумышленник может отправлять сообщения от его имени, получать обновления и вмешиваться в работу интеграций. Если токен сохранён рядом с пользовательскими данными, одна уязвимость превращается в компрометацию всего сервиса. Токен webhook и учётные данные внешних API требуют такого же уровня защиты.
Степень риска зависит от прав пользователя базы, наличия секретов, чувствительности хранимых данных и доступности журналов. SQLite сам по себе не является небезопасным: проблема возникает из-за небезопасного способа обращения с базой и недостаточной изоляции приложения.
Безопасная проверка уязвимости
Проверку проводят только с письменного разрешения владельца и на копии приложения или в отдельном тестовом окружении. Используют синтетические записи, тестовый токен и локальную базу. Боевой контур, реальные учётные записи и рабочие интеграции не должны становиться частью эксперимента.
Сначала анализируют места, где внешние данные переходят в запросы. Особое внимание уделяют строкам с execute, executemany, динамическими условиями, сортировкой и выбором таблиц. Затем проверяют поведение бота на специальных символах и пустых значениях, сравнивая ответы и состояние тестовой базы. Результаты сохраняют без токенов и персональных данных.
Признаком проблемы может быть неожиданное изменение результата, синтаксическая ошибка, обход проверки прав или доступ к записи, которой не должно быть в выдаче. Тестирование не должно превращаться в разрушительную атаку: простые контролируемые проверки позволяют установить наличие дефекта без эксплуатационных полезных нагрузок.
Параметризация и безопасная обработка ввода
Параметризованный запрос должен быть стандартом для любого значения, полученного от пользователя. Например, поиск выполняется через execute("SELECT id FROM users WHERE external_id = ?", (value,)). Такой вызов сохраняет структуру SQL неизменной, а ввод передаётся драйвером как отдельное значение.
Некоторые части запроса нельзя передать как параметр: имя таблицы, столбца, направление сортировки или режим сравнения. Для них применяют заранее определённый список допустимых вариантов и сопоставляют пользовательский выбор с конкретным значением. Произвольное имя из ввода в такой запрос не включается.
Проверка типов и длины строк остаётся полезной, но выполняется до запроса и не заменяет параметризацию. ORM также может создавать уязвимость, если сырые фрагменты SQL допускают пользовательские выражения. Безопасность зависит от способа построения каждого запроса, а не только от наличия библиотеки или абстракции базы данных.
Изоляция базы и защита секретов
Файл SQLite следует хранить вне публичного каталога и доступовать только процессу бота. Права на файл и каталог ограничивают по принципу наименьших привилегий: учётная запись приложения не должна получать лишние системные полномочия. Резервные копии также должны быть защищены, поскольку нередко содержат больше информации, чем текущая база.
Токен бота лучше получать из менеджера секретов или переменной окружения и хранить в памяти только на время работы. Если секрет всё же записан в SQLite, его необходимо шифровать, отделить от пользовательских таблиц и ограничить доступ. Значение токена не должно попадать в логи, сообщения об ошибках, тестовые отчёты и системы аналитики.
При подозрении на утечку токен немедленно перевыпускают через официальный интерфейс Telegram. После этого проверяют отправленные сообщения, настроенные webhook-адреса, права интеграций и активные сессии. Ротация секрета прекращает использование старого значения, но не заменяет устранение самой уязвимости.
Журналирование и признаки аномалий
Журналы помогают заметить SQL-инъекцию до серьёзного инцидента. Полезны события изменения схемы и данных, неожиданные ошибки базы, попытки доступа к закрытым таблицам, резкий рост невалидного ввода и запросы от необычных пользователей или IP-адресов. Сами введённые строки лучше сохранять в обезличенном или ограниченном виде.
Учётная запись бота не должна обладать правами на изменение всей файловой системы. Для журналов, резервных копий и мониторинга применяют отдельные ограниченные права. Это снижает вероятность удаления следов и не позволяет обычной ошибке обработки запроса затронуть соседние компоненты.
При подтверждённой атаке сначала изолируют процесс, затем сохраняют состояние и доступные журналы. После этого перевыпускают секреты, проверяют целостность таблиц и восстанавливают базу из заведомо чистой копии. Объём затронутых данных оценивают по журналам и резервным копиям, а пользователям сообщают только о фактически произошедших событиях.
Профилактика на всех этапах разработки
Уязвимость проще предотвратить, чем обнаружить по последствиям. В проекте следует задать правило: пользовательские данные не включаются в SQL через конкатенацию. Статический анализ, автоматические тесты и проверка зависимостей помогают находить опасные конструкции до развёртывания. Отдельно проверяются новые миграции, обработчики webhook и код, написанный с использованием сырых запросов.
Зависимостям нужны фиксированные версии, контроль источников и регулярные обновления. Сборку следует защищать от подмены пакетов, а секреты — от попадания в репозиторий. Тестовые данные не должны содержать реальные токены, а права тестового окружения — повторять модель ограничений боевого контура.
Рабочий процесс безопасности объединяет ревью изменений, регулярное восстановление из резервных копий и проверку журналов. Каждая новая команда или точка ввода рассматривается как потенциальный источник инъекции. В результате защита перестаёт зависеть от памяти одного разработчика и становится контролируемым свойством приложения.