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.18 中显示。

对于 xdes，还有一个额外的限制，即迭代次数必须是奇数。

要选择合适的迭代次数，请考虑原始 DES 加密设计为在当时的硬件上每秒有 4 个哈希值的速度。低于每秒 4 个哈希值的速度可能会降低可用性。高于每秒 100 个哈希值的速度可能太快。

表 F.19 概述了不同哈希算法的相对速度。该表显示了尝试 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 数组，则为每个键/值对向 armored 格式添加一个armor 标头。 两个数组都必须是一维的，并且它们的长度必须相同。 键和值不能包含任何非 ASCII 字符。

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

pgp_armor_headers() 从 data 中提取 armor 标头。 返回值是具有两列（key 和 value）的行集。 如果键或值包含任何非 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 解密函数完成所需的时间会因给定大小的密文而异。