EVP_MAC-HMAC
名稱
EVP_MAC-HMAC - HMAC EVP_MAC 實作
說明
透過 EVP_MAC API 支援運算 HMAC MAC。
此實作使用 EVP_MD 函式取得底層摘要。
身分
此實作以這個名稱和屬性識別，可與 EVP_MAC_fetch() 搭配使用
- "HMAC", "provider=default" 或 "provider=fips"
支援的參數
這些參數的一般說明可以在 EVP_MAC(3) 中的「參數」 找到。
下列參數可以使用 EVP_MAC_CTX_set_params() 設定
- "key" (OSSL_MAC_PARAM_KEY) <八位元組字串>
-
設定 MAC 金鑰。設定此參數等同於將 key 傳遞給 EVP_MAC_init(3)。
- "digest" (OSSL_MAC_PARAM_DIGEST) <UTF8 字串>
-
設定要使用的底層摘要名稱。
- "properties" (OSSL_MAC_PARAM_PROPERTIES) <UTF8 字串>
-
設定嘗試擷取底層摘要時要查詢的屬性。這必須與摘要命名參數（「摘要」或 OSSL_MAC_PARAM_DIGEST）一起提供，才算有效。
- "digest-noinit" (OSSL_MAC_PARAM_DIGEST_NOINIT) <整數>
-
一個旗標，用於設定 MAC 摘要，以不初始化實作特定資料。預期值為 0 或 1。此選項已過時，將在未來版本中移除。它可以設定，但目前會被忽略
- "digest-oneshot" (OSSL_MAC_PARAM_DIGEST_ONESHOT) <整數>
-
一個旗標，用於設定 MAC 摘要為一次性操作。預期值為 0 或 1。此選項已過時，將在未來版本中移除。它可以設定，但目前會被忽略。
- "tls-data-size" (OSSL_MAC_PARAM_TLS_DATA_SIZE) <無符號整數>
下列參數可以使用 EVP_MAC_CTX_get_params() 擷取
- "size" (OSSL_MAC_PARAM_SIZE) <無符號整數>
-
"size" 參數也可以使用 EVP_MAC_CTX_get_mac_size() 擷取。unsigned int 的長度等於 "size" 參數的長度。
- "block-size" (OSSL_MAC_PARAM_BLOCK_SIZE) <無符號整數>
-
取得 MAC 區塊大小。"block-size" 參數也可以使用 EVP_MAC_CTX_get_block_size() 擷取。
另請參閱
EVP_MAC_CTX_get_params(3)、EVP_MAC_CTX_set_params(3)、EVP_MAC(3) 中的「參數」、OSSL_PARAM(3)、HMAC(3)
版權
版權所有 2018-2021 The OpenSSL Project Authors。保留所有權利。
根據 Apache License 2.0（「授權」）授權。您不得在不遵守授權的情況下使用此檔案。您可以在原始程式碼散佈中的 LICENSE 檔案中取得副本，或在 https://www.openssl.org/source/license.html 取得副本。