pgpro_wrap
pgpro_wrap — скрыть код PL/pgSQL
Синтаксис
pgpro_wrap [-V | --version] [-? | --help]
Описание
pgpro_wrap — утилита командной строки, предназначенная для защиты кода PL/pgSQL от несанкционированного просмотра и изменений. Она преобразует хранимые процедуры и функции в скрытую (обфусцированную) форму. Сервер баз данных может по-прежнему выполнять эти процедуры и функции, но их код нельзя просмотреть напрямую в системных каталогах.
Возможность создания и выполнения обфусцированных объектов управляется параметром конфигурации pgpro_wrap.
Использование
Обычно работа с утилитой включает несколько этапов. Сначала функция или процедура PL/pgSQL должна быть записана в обычный текстовый файл с кодировкой UTF-8. Затем pgpro_wrap обрабатывает этот файл и создаёт файл с суффиксом .wrap. Полученный файл загружается в базу данных с помощью утилиты psql. Сервер базы данных автоматически обрабатывает код и создаёт соответствующий хранимый объект. В результате функция или процедура выполняется обычным образом без дополнительных действий.
При попытке просмотреть или изменить исходный код таких объектов напрямую с помощью клиентских инструментов, например pgAdmin, либо через системный каталог pg_proc, отображается только скрытая версия кода. Однако если во время выполнения обфусцированного объекта возникает ошибка, сообщение об ошибке включает ошибочную строку в открытом виде. Это необходимо для отладки.
Пример использования
Подготовьте текстовый файл в кодировке UTF‑8, содержащий функцию или процедуру PL/pgSQL.
Обработайте исходный файл утилитой pgpro_wrap:
pgpro_wrap
исходный_файлУтилита создаёт в текущем каталоге выходной файл с именем
. Если файл с таким именем уже существует, pgpro_wrap завершает работу с ошибкой, предотвращая случайную перезапись.исходный_файл.wrapЗагрузите полученный файл в базу данных с помощью psql:
psql -d
имя_базы_данных-fисходный_файл.wrapСервер базы данных автоматически обрабатывает код и создаёт соответствующий хранимый объект.
Убедитесь, что хранимый объект работает ожидаемым образом, например, выполнив его.
Попробуйте просмотреть исходный код созданного объекта, например, с помощью команды \df+ в psql. Вместо исходного текста отобразится только обфусцированная версия.
Параметры
pgpro_wrap принимает следующие аргументы командной строки:
-V--versionВывести версию pgpro_wrap и завершить работу.
-?--helpПоказать справку по pgpro_wrap и завершить работу.
Примечания
Учтите, что скрытый код PL/pgSQL отображается в виде обычного текста в следующих компонентах системы:
файлы журналов сервера
журналы pg_proaudit
статистика, собранная с помощью pg_stat_statements и pgpro_stats
данные, предоставляемые модулем auto_explain
Таким образом, pgpro_wrap эффективно предотвращает случайный просмотр и прямое редактирование исходного кода PL/pgSQL через системные каталоги и клиентские инструменты. Однако в указанных выше диагностических контекстах исходный код всё ещё может появляться в открытом виде. Это важное свойство средств мониторинга и отладки, а не ограничение утилиты.