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, отображается только скрытая версия кода. Однако если во время выполнения обфусцированного объекта возникает ошибка, сообщение об ошибке включает ошибочную строку в открытом виде. Это необходимо для отладки.

Пример использования

  1. Подготовьте текстовый файл в кодировке UTF‑8, содержащий функцию или процедуру PL/pgSQL.

  2. Обработайте исходный файл утилитой pgpro_wrap:

    pgpro_wrap исходный_файл

    Утилита создаёт в текущем каталоге выходной файл с именем исходный_файл.wrap. Если файл с таким именем уже существует, pgpro_wrap завершает работу с ошибкой, предотвращая случайную перезапись.

  3. Загрузите полученный файл в базу данных с помощью psql:

    psql -d имя_базы_данных -f исходный_файл.wrap

    Сервер базы данных автоматически обрабатывает код и создаёт соответствующий хранимый объект.

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

Попробуйте просмотреть исходный код созданного объекта, например, с помощью команды \df+ в psql. Вместо исходного текста отобразится только обфусцированная версия.

Параметры

pgpro_wrap принимает следующие аргументы командной строки:

-V
--version

Вывести версию pgpro_wrap и завершить работу.

-?
--help

Показать справку по pgpro_wrap и завершить работу.

Примечания

Учтите, что скрытый код PL/pgSQL отображается в виде обычного текста в следующих компонентах системы:

Таким образом, pgpro_wrap эффективно предотвращает случайный просмотр и прямое редактирование исходного кода PL/pgSQL через системные каталоги и клиентские инструменты. Однако в указанных выше диагностических контекстах исходный код всё ещё может появляться в открытом виде. Это важное свойство средств мониторинга и отладки, а не ограничение утилиты.

FAQ