digest(data text, type text) returns bytea
digest(data bytea, type text) returns bytea

Вычисляет двоичный хеш заданных данных data. type - это алгоритм, который будет использоваться. Стандартные алгоритмы: md5, sha1, sha224, sha256, sha384 и sha512. Кроме того, автоматически выбирается любой алгоритм хеширования, поддерживаемый OpenSSL.

Если нужно получить дайджест в виде шестнадцатеричной строки, используйте функцию encode() для полученного результата. Например:

CREATE OR REPLACE FUNCTION sha1(bytea) returns text AS $$
    SELECT encode(digest($1, 'sha1'), 'hex')
$$ LANGUAGE SQL STRICT IMMUTABLE;

hmac(data text, key text, type text) returns bytea
hmac(data bytea, key bytea, type text) returns bytea

Вычисляет хешированный MAC для data с ключом key. type такой же, как в digest().

Это похоже на функцию digest(), но хеш можно пересчитать только зная ключ. Это предотвращает ситуацию, когда кто-то изменяет данные и также изменяет хеш, чтобы он совпадал.

Если ключ больше размера блока хеша, он будет сначала хеширован, а затем результат будет использоваться в качестве ключа.

crypt(password text, salt text) returns text

Вычисляет хеш в стиле crypt(3) для password. При сохранении нового пароля необходимо использовать функцию gen_salt() для генерации нового значения salt. Для проверки пароля передайте сохраненное значение хеша в качестве salt и проверьте, совпадает ли результат с сохраненным значением.

Пример установки нового пароля:

UPDATE ... SET pswhash = crypt('new password', gen_salt('md5'));

Пример аутентификации:

SELECT (pswhash = crypt('entered password', pswhash)) AS pswmatch FROM ... ;

Это возвращает true, если введенный пароль правильный.

gen_salt(type text [, iter_count integer ]) returns text

Генерирует новую случайную строку соли для использования в функции crypt(). Строка соли также сообщает функции crypt(), какой алгоритм использовать.

Параметр type определяет алгоритм хеширования. Принимаемые типы: des, xdes, md5 и bf.

Параметр iter_count позволяет пользователю указать количество итераций для алгоритмов, которые его используют. Чем выше значение, тем больше времени требуется для хеширования пароля и, следовательно, больше времени для его взлома. Однако слишком большое значение может привести к тому, что время вычисления хеша составит несколько лет, что является несколько неудобным. Если параметр iter_count не указан, используется значение итераций по умолчанию. Допустимые значения для параметра iter_count зависят от алгоритма и указаны в таблице Таблица F.19.

Для xdes существует дополнительное ограничение: количество итераций должно быть нечетным числом.

Для выбора подходящего количества итераций рассмотрите, что исходный DES crypt был разработан для обеспечения скорости выполнения 4 хешей в секунду на аппаратуре того времени. Скорость медленнее 4 хешей в секунду, вероятно, снизит удобство использования. Скорость быстрее 100 хешей в секунду, вероятно, слишком высока.

Таблица F.20 дает обзор относительной медлительности различных алгоритмов хеширования. Таблица показывает, сколько времени потребуется для попытки всех комбинаций символов в пароле из 8 символов, предполагая, что пароль содержит либо только строчные буквы, либо строчные и заглавные буквы и цифры. В записях crypt-bf, число после слэша - параметр iter_count функции gen_salt.

Примечания:

Обратите внимание, что “попробовать все комбинации” не является реалистичным упражнением. Обычно взлом паролей выполняется с помощью словарей, которые содержат как обычные слова, так и различные их мутации. Таким образом, даже пароли, напоминающие слова, могут быть взломаны намного быстрее, чем указанные выше числа, в то время как 6-символьный пароль, не похожий на слово, может остаться невзломанным. Или нет.

pgp_sym_encrypt(data text, psw text [, options text ]) returns bytea
pgp_sym_encrypt_bytea(data bytea, psw text [, options text ]) returns bytea

Зашифруйте data симметричным PGP ключом psw. Параметр options может содержать настройки параметров, как описано ниже.

pgp_sym_decrypt(msg bytea, psw text [, options text ]) returns text
pgp_sym_decrypt_bytea(msg bytea, psw text [, options text ]) returns bytea

Расшифровать симметрично-зашифрованное PGP-сообщение.

Расшифровка данных типа bytea с использованием функции pgp_sym_decrypt запрещена. Это сделано для предотвращения вывода недопустимых символьных данных. Расшифровка исходно текстовых данных с использованием функции pgp_sym_decrypt_bytea допустима.

Параметр options может содержать настройки опций, как описано ниже.

pgp_pub_encrypt(data text, key bytea [, options text ]) returns bytea
pgp_pub_encrypt_bytea(data bytea, key bytea [, options text ]) returns bytea

Шифрование data с использованием открытого PGP-ключа key. Если передать этой функции секретный ключ, будет сгенерирована ошибка.

Параметр options может содержать настройки опций, как описано ниже.

pgp_pub_decrypt(msg bytea, key bytea [, psw text [, options text ]]) returns text
pgp_pub_decrypt_bytea(msg bytea, key bytea [, psw text [, options text ]]) returns bytea

Расшифровать сообщение, зашифрованное с использованием открытого ключа. Параметр key должен быть секретным ключом, соответствующим открытому ключу, использованному для шифрования. Если секретный ключ защищен паролем, вы должны указать пароль в psw. Если пароля нет, но нужно указать параметры, вам нужно указать пустой пароль.

Расшифровка данных типа bytea с использованием функции pgp_pub_decrypt запрещена. Это сделано для предотвращения вывода недопустимых символьных данных. Расшифровка исходно текстовых данных с использованием функции pgp_pub_decrypt_bytea допустима.

Параметр options может содержать настройки опций, как описано ниже.

pgp_key_id(bytea) returns text

pgp_key_id извлекает идентификатор ключа открытого или секретного ключа PGP. Или он дает идентификатор ключа, который был использован для шифрования данных, если дано зашифрованное сообщение.

Он может возвращать 2 специальных идентификатора ключей:

Обратите внимание, что разным ключам может быть присвоен один и тот же идентификатор. Это редкое, но нормальное событие. Клиентское приложение должно попытаться расшифровать каждый ключ, чтобы узнать, какой подходит - подобно обработке ANYKEY.

armor(data bytea [ , keys text[], values text[] ]) returns text
dearmor(data text) returns bytea

Эти функции оборачивают/распаковывают двоичные данные в формат PGP ASCII-armor, который в основном представляет собой Base64 с контрольной суммой CRC и дополнительным форматированием.

Если указаны массивы keys и values, к каждой паре ключ/значение в зашифрованном формате добавляется заголовок брони. Оба массива должны быть одномерными и иметь одинаковую длину. Ключи и значения не могут содержать не-ASCII символы.

pgp_armor_headers(data text, key out text, value out text) returns setof record

pgp_armor_headers() извлекает заголовки брони из data. Возвращаемое значение - набор строк с двумя столбцами, ключ и значение. Если ключи или значения содержат любые не-ASCII символы, они рассматриваются как UTF-8.

Опции названы так, чтобы быть похожими на GnuPG. Значение опции должно быть указано после знака равенства; разделяйте опции друг от друга запятыми. Например:

pgp_sym_encrypt(data, psw, 'compress-algo=1, cipher-algo=aes256')

Все параметры, кроме convert-crlf, применяются только к функциям шифрования. Функции дешифрования получают параметры из данных PGP.

Самые интересные параметры, вероятно, это compress-algo и unicode-mode. Остальные должны иметь разумные значения по умолчанию.

Для генерации нового ключа:

gpg --gen-key

Предпочтительный тип ключа - “DSA и Elgamal”.

Для шифрования RSA необходимо создать ключ DSA или RSA только для подписи в качестве основного, а затем добавить подключ RSA для шифрования с помощью gpg --edit-key.

Для перечисления ключей:

gpg --list-secret-keys

Для экспорта открытого ключа в формате ASCII-armor:

gpg -a --export KEYID > public.key

Чтобы экспортировать секретный ключ в формате ASCII-armor:

gpg -a --export-secret-keys KEYID > secret.key

Вам нужно использовать dearmor() для этих ключей перед передачей их функциям PGP. Или, если вы можете работать с двоичными данными, вы можете опустить -a из команды.

Для получения более подробной информации см. man gpg, Руководство по безопасности GNU и другую документацию на https://www.gnupg.org/.

pgcrypto настраивается в соответствии с результатами выполнения основного сценария configure в PostgreSQL. Опции, которые на него влияют, - это --with-zlib и --with-ssl=openssl.

Когда компилируется с zlib, функции шифрования PGP могут сжимать данные перед шифрованием.

pgcrypto требует OpenSSL. В противном случае, он не будет собран или установлен.

При компиляции с использованием OpenSSL версии 3.0.0 и выше, для использования устаревших шифров, таких как DES или Blowfish, необходимо активировать устаревший провайдер в файле конфигурации openssl.cnf.

Как и в стандартном SQL, все функции возвращают NULL, если хотя бы один из аргументов является NULL. Это может создавать уязвимости безопасности при небрежном использовании.

Все функции pgcrypto выполняются внутри сервера базы данных. Это означает, что все данные и пароли передаются между pgcrypto и клиентскими приложениями в открытом виде. Поэтому необходимо:

Если вы не можете, то лучше выполнять криптографию внутри клиентского приложения.

Реализация не устойчива к атакам через боковые каналы. Например, время, необходимое для завершения функции расшифровки pgcrypto, может варьироваться в зависимости от размера шифротекста.