postgres_escape

Директива `postgres_escape` в NGINX используется для управления поведением экранирования строк запроса при взаимодействии с PostgreSQL.

Синтаксисpostgres_escape on | off;
По умолчаниюon
Контекстhttp, server, location
Аргументы1-2

Описание

Директива postgres_escape позволяет указать, следует ли экранировать определённые символы в SQL-строках запроса, что имеет решающее значение для обеспечения безопасности и корректного форматирования данных при отправке на сервер PostgreSQL. Используя эту директиву, пользователи могут настроить поведение экранирования — включить или отключить его, что может предотвращать SQL injection и обеспечивать целостность запросов к базе данных.

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

Директива postgres_escape применима в различных контекстах, включая блоки http, server и location, что даёт гибкость в конфигурации в зависимости от требуемого уровня контроля. Это делает её важной частью модулей, обеспечивающих безопасное взаимодействие с базой данных в конфигурациях NGINX, позволяя веб-разработчикам управлять запросами к базе данных с повышенной безопасностью и эффективностью.

Пример конфига

location /api {
    postgres_pass my_postgres;
    postgres_escape on;
    postgres_query SELECT * FROM users WHERE name = :name;
}

Отключение экранирования может подвергнуть ваше приложение уязвимостям SQL-инъекций, если вводимые пользователями данные не очищаются должным образом.

Убедитесь, что директива postgres_escape настроена корректно в зависимости от характера входных данных, чтобы избежать неожиданных результатов запросов.

← Ко всем директивам