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() 生成一个新的随机 salt 字符串。 salt 字符串还告诉 crypt() 使用哪种算法。

参数 type 指定哈希算法。可接受的类型有：des、xdes、md5、bf、sha256crypt 和 sha512crypt。后两种 sha256crypt 和 sha512crypt 是基于 SHA-2 的现代密码哈希。

参数 iter_count 允许用户指定迭代次数（对于具有该参数的算法）。计数越高，哈希密码所需的时间就越长，因此破解密码所需的时间也越长。尽管计数过高可能需要数年时间才能计算出哈希值 — 这不太实用。如果省略 iter_count 参数，则使用默认的迭代次数。 iter_count 的允许值取决于算法，并在 表 F.19 中显示。

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

为了选择合适的迭代次数，请注意，原始 DES crypt 被设计成在当时硬件上每秒能进行 4 次哈希。每秒慢于 4 次哈希可能会影响可用性。每秒快于 100 次哈希可能太快了。

表 F.20 概述了不同哈希算法的相对速度。该表显示了尝试 8 个字符密码的所有字符组合所需的时间，假设密码只包含小写字母，或者包含大写字母、小写字母和数字。在 crypt-bf 条目中，斜杠后的数字是 gen_salt 的 iter_count 参数。

sha256crypt 和 sha512crypt 的默认 iter_count 为 5000，这对于现代硬件来说太低了，但可以调整以生成更强的密码哈希。否则，这两种哈希 sha256crypt 和 sha512crypt 都被认为是安全的。

注释

请注意，“尝试所有组合” 并不是一个现实的练习。通常密码破解是借助字典进行的，这些字典包含常规单词和它们的各种变体。因此，即使是看起来像单词的密码，破解速度也可能比上述数字快得多，而一个 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 数组，则会在 armor 格式中为每个键/值对添加一个 armor 头。两个数组都必须是单维的，并且必须具有相同的长度。键和值都不能包含任何非 ASCII 字符。

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

pgp_armor_headers() 从 data 中提取 armor 头。返回值是一组行，包含两列：键和值。如果键或值包含任何非 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、The GNU Privacy Handbook 以及 https://www.gnupg.org/ 上的其他文档。

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

当使用 zlib 编译时，PGP 加密函数能够先压缩数据再加密。

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

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

按照 SQL 的标准，如果任何参数为 NULL，则所有函数都返回 NULL。这可能在粗心使用时产生安全风险。

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

如果不能，则最好在客户端应用程序内部进行加密。

该实现不能抵抗侧信道攻击。例如，pgcrypto 解密函数完成所需的时间因给定大小的密文而异。