Kontur
О Kontur 4.0

Защита SQL-запросов

В документации v2 обозначает версию API Kontur 4.0. Внешний сайт можно подключить по заявке.

Этот слой защищает SQL-запросы сервера, который использует адаптер. На нашем сайте он подключён к основной базе и сервису Kontur. Ввод передаётся в PostgreSQL параметрами, а не вставляется в текст команды.

// Серверный модуль в этом репозитории:
import { createRuntimeSql } from '@kontur/core/postgres';
const sql = createRuntimeSql(process.env.DATABASE_URL!);
const [user] = await sql`SELECT id FROM users WHERE login = ${login}`;

Адаптер запрещает unsafe и выполнение SQL-файлов на рабочем соединении, включая транзакции, вложенные savepoint и выделенные соединения. Миграции выполняются отдельно. Правила ESLint запрещают raw SQL и прямое создание другого драйвера в рабочем коде; CI запускает эти правила.

Динамические таблицы и колонки задавайте через безопасный построитель sql(identifier) и список разрешённых имён. Направление сортировки выбирайте из фиксированных SQL-фрагментов. Пользователь не должен выбирать произвольную таблицу или поле.

const order = direction === 'desc' ? sql`DESC` : sql`ASC`;
const rows = await sql`SELECT id, title FROM posts ORDER BY id ${order}`;

Что проверено

Тесты настоящих обработчиков входа и поиска на отдельной PostgreSQL проверяют boolean/UNION payload, комментарии, составные команды, DROP TABLE и pg_sleep. Они остаются данными; вход не обходится, таблицы сохраняются. Проверены также обычные апострофы, SQL-слова, символы LIKE, JSON, сохранённые значения и вложенные транзакции.

Границы

Браузерный виджет и verify не анализируют SQL другого приложения. Для внешнего подключения нужен такой же безопасный доступ к БД на сервере интегратора. Адаптер не заменяет проверку прав, ограничения роли БД и аудит хранимых процедур. Если сервер сам склеивает SQL или исполняет динамическую строку внутри функции PostgreSQL, этот код нужно исправить отдельно.

Слова SELECT и UNION, кавычки и SQL-примеры в сообщениях не запрещаются. Защита разделяет команды и данные, а не фильтрует текст человека.