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

使用密钥 key 为 data 计算哈希 MAC。 type 与 digest() 中的相同。

这类似于 digest()，但只有知道密钥才能重新计算哈希。这可以防止有人更改数据并更改哈希以匹配的情况。

如果密钥大于哈希块大小，它将首先被哈希，结果将用作密钥。

crypt(password text, salt text) returns text

计算 password 的 crypt(3) 样式哈希。存储新密码时，您需要使用 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 条目中，斜杠后的数字是 gen_salt 的 iter_count 参数。

注释

请注意，“尝试所有组合”并不是一项现实的练习。通常，密码破解借助字典完成，其中包含常规单词及其各种变体。因此，即使是有点像单词的密码也可以比上述数字所建议的更快破解，而 6 个字符的非单词式密码可能会逃脱破解。或者不会。

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

使用对称 PGP 密钥 psw 加密 data。 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 消息。

禁止使用 pgp_sym_decrypt 解密 bytea 数据。这是为了避免输出无效的字符数据。使用 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

使用公用 PGP 密钥 key 加密 data。向此函数提供一个私钥将产生一个错误。

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 中提供密码。如果没有密码，但要指定选项，则需要提供一个空密码。

禁止使用 pgp_pub_decrypt 解密 bytea 数据。这是为了避免输出无效的字符数据。使用 pgp_pub_decrypt_bytea 解密原始文本数据是可以的。

options 参数可以包含选项设置，如下所述。

pgp_key_id(bytea) returns text

pgp_key_id 提取 PGP 公钥或私钥的密钥 ID。或者，如果给定加密消息，则给出用于加密数据的密钥 ID。

它可以返回 2 个特殊密钥 ID

请注意，不同的密钥可能具有相同的 ID。这种情况很少见，但属于正常情况。然后，客户端应用程序应尝试使用每个密钥进行解密，以查看哪个密钥合适——就像处理 ANYKEY 一样。

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

这些函数将二进制数据包装/解包到 PGP ASCII-armor 格式中，该格式基本上是带有 CRC 和附加格式的 Base64。

如果指定了 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 仅签名密钥作为主密钥，然后使用 gpg --edit-key 添加 RSA 加密子密钥。

列出密钥

gpg --list-secret-keys

以 ASCII-armor 格式导出公钥

gpg -a --export KEYID > public.key

以 ASCII-armor 格式导出私钥

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

在将这些密钥提供给 PGP 函数之前，您需要对这些密钥使用 dearmor()。或者，如果您能处理二进制数据，则可以从命令中删除 -a。

有关更多详细信息，请参阅 man gpg、GNU 隐私手册 和 https://www.gnupg.org/ 上的其他文档。

pgcrypto 根据主 PostgreSQL configure 脚本的发现结果进行自身配置。影响它的选项为 --with-zlib 和 --with-ssl=openssl。

使用 zlib 编译时，PGP 加密函数能够在加密之前压缩数据。

pgcrypto 需要OpenSSL。否则，它将不会被构建或安装。

针对 OpenSSL 3.0.0 及更高版本编译时，必须在 openssl.cnf 配置文件中激活旧版提供程序，才能使用 DES 或 Blowfish 等较旧的密码。

与 SQL 中的标准一样，如果任何参数为 NULL，则所有函数都返回 NULL。这可能会在使用不当时造成安全风险。

所有 pgcrypto 函数都在数据库服务器内运行。这意味着所有数据和密码都在 pgcrypto 和客户端应用程序之间以明文形式传输。因此，您必须

如果您无法做到，那么最好在客户端应用程序内进行加密。

该实现无法抵御 旁路攻击。例如，pgcrypto 解密函数完成所需的时间因给定大小的密码文本而异。