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。

iter_count 参数允许用户为具有迭代次数的算法指定迭代次数。次数越高，哈希密码所需的时间越长，因此破解密码所需的时间也越长。尽管迭代次数过高，计算哈希值的时间可能需要数年——这在某种程度上是不切实际的。如果省略 iter_count 参数，则使用默认迭代次数。iter_count 的允许值取决于算法，并在 表 F.18 中显示。

对于 xdes，还有一个限制，即迭代次数必须为奇数。

要选择合适的迭代次数，请考虑原始 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 字符。