1 /* 2 * This file is part of the openHiTLS project. 3 * 4 * openHiTLS is licensed under the Mulan PSL v2. 5 * You can use this software according to the terms and conditions of the Mulan PSL v2. 6 * You may obtain a copy of Mulan PSL v2 at: 7 * 8 * http://license.coscl.org.cn/MulanPSL2 9 * 10 * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, 11 * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, 12 * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE. 13 * See the Mulan PSL v2 for more details. 14 */ 15 16 #ifndef PBKDF2_LOCAL_H 17 #define PBKDF2_LOCAL_H 18 19 #include "hitls_build.h" 20 #ifdef HITLS_CRYPTO_PBKDF2 21 22 #include <stdint.h> 23 #include "crypt_local_types.h" 24 25 #ifdef __cplusplus 26 extern "C" { 27 #endif // __cplusplus 28 29 /** 30 * @brief PBKDF Password-based key derivation function 31 * 32 * @param macMeth [IN] Pointer to the HMAC algorithm method 33 * @param mdMeth [IN] MD algorithm method pointer 34 * @param key [IN] Password, a string entered by the user. 35 * @param keyLen [IN] Password length, which can be any length, including 0. 36 * @param salt [IN] Salt value, a string entered by the user. 37 * @param saltLen [IN] Salt value length, which can be any length, including 0. 38 * @param iterCnt [IN] Iteration times. The value can be any positive integer that is not 0. 39 * The value can be 1000 in special performance cases. The default value is 10000, 40 * 10000000 is recommended in cases where performance is insensitive or security requirements are high. 41 * @param out [OUT] Derived key. 42 * @param len [IN] Length of the derived key. The value range is [1, 0xFFFFFFFF]. 43 * 44 * @return Success: CRYPT_SUCCESS 45 * For other error codes, see crypt_errno.h 46 */ 47 int32_t CRYPT_PBKDF2_HMAC(const EAL_MacMethod *macMeth, CRYPT_MAC_AlgId macId, const EAL_MdMethod *mdMeth, 48 const uint8_t *key, uint32_t keyLen, 49 const uint8_t *salt, uint32_t saltLen, 50 uint32_t iterCnt, uint8_t *out, uint32_t len); 51 52 53 #ifdef __cplusplus 54 } 55 #endif // __cplusplus 56 57 #endif // HITLS_CRYPTO_PBKDF2 58 59 #endif // PBKDF2_LOCAL_H 60