EVP_MAC-BLAKE2
名稱
EVP_MAC-BLAKE2、EVP_MAC-BLAKE2BMAC、EVP_MAC-BLAKE2SMAC - BLAKE2 EVP_MAC 實作
說明
透過 EVP_MAC API 支援計算 BLAKE2 MAC。
識別
這些實作會以其中一個名稱和屬性識別,並與 EVP_MAC_fetch() 搭配使用
- "BLAKE2BMAC", "provider=default"
- "BLAKE2SMAC", "provider=default"
支援的參數
這些參數的一般說明可以在 EVP_MAC(3) 中的「參數」 找到。
所有這些參數(「區塊大小」除外)都可以使用 EVP_MAC_CTX_set_params() 設定。此外,「大小」參數可以使用 EVP_MAC_CTX_get_params() 或 EVP_MAC_CTX_get_mac_size() 擷取。 「大小」參數的長度不應超過 size_t。同樣地,「區塊大小」參數可以使用 EVP_MAC_CTX_get_params() 或 EVP_MAC_CTX_get_block_size() 擷取。
- "金鑰" (OSSL_MAC_PARAM_KEY) <八位元組字串>
-
設定 MAC 金鑰。對於 BLAKE2BMAC,它最多可以是 64 個位元組,對於 BLAKE2SMAC,它最多可以是 32 個位元組,兩者至少需要 1 個位元組。設定此參數等同於將 金鑰 傳遞給 EVP_MAC_init(3)。
- "自訂" (OSSL_MAC_PARAM_CUSTOM) <八位元組字串>
-
設定自訂/個人化字串。它是 BLAKE2BMAC 最多 16 個位元組或 BLAKE2SMAC 最多 8 個位元組的選用值,且預設為空白。
- "鹽" (OSSL_MAC_PARAM_SALT) <八位元組字串>
-
設定鹽。它是 BLAKE2BMAC 最多 16 個位元組或 BLAKE2SMAC 最多 8 個位元組的選用值,且預設為空白。
- "大小" (OSSL_MAC_PARAM_SIZE) <無符號整數>
-
設定 MAC 大小。對於 EVP_MAC_BLAKE2S,它可以是 1 到 32 之間的任何數字,對於 EVP_MAC_BLAKE2B,它可以是 1 到 64 之間的任何數字。預設值分別為 32 和 64。
- "區塊大小" (OSSL_MAC_PARAM_BLOCK_SIZE) <無符號整數>
-
取得 MAC 區塊大小。對於 EVP_MAC_BLAKE2S,它是 64,對於 EVP_MAC_BLAKE2B,它是 128。
另請參閱
EVP_MAC_CTX_get_params(3)、EVP_MAC_CTX_set_params(3)、EVP_MAC(3) 中的「參數」、OSSL_PARAM(3)
歷史
此處描述的巨集和函式已新增至 OpenSSL 3.0。
版權
版權所有 2018-2021 OpenSSL 專案作者。保留所有權利。
根據 Apache 授權條款 2.0(「授權條款」)授權。您只能在遵守授權條款的情況下使用此檔案。您可以在原始程式碼散佈中的 LICENSE 檔案中取得副本,或至 https://www.openssl.org/source/license.html 取得副本。