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 解密函式完成所需的時間因給定大小的密文而異。