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

生成一个新的随机 salt 字符串，以在 crypt() 中使用。salt 字符串还告诉 crypt() 要使用哪种算法。

type 参数指定哈希算法。可接受的类型有： des、xdes、md5 和 bf。

对于具有一个 iteration 的算法，iter_count 参数允许用户指定 iteration 数。iteration 数越高，哈希化密码所花费的时间以及破解密码所需的时间就越长。虽然 iteration 数太高，计算哈希值可能需要几年时间 — 这有点不切实际。如果省略 iter_count 参数，将使用默认的 iteration 数。 iter_count 的允许值取决于算法，并显示在 crypt() 的 iteration 数">表 F.18 中。

对于 xdes，还有一个附加限制，即 iteration 数必须是奇数。

要选取合适的 iteration 数，请考虑最初的 DES crypt 设计为每秒有 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 铠甲格式中，该格式基本上是带有 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 解密函数完成给定大小密文所需的时间是不同的。