pwdbased.h

Functions

	Name
int	wc_PBKDF1(byte * output, const byte * passwd, int pLen, const byte * salt, int sLen, int iterations, int kLen, int hashType) この関数は、パスワードベース鍵導出関数1(PBKDF1)を実装し、連結されたソルトを持つ入力パスワードをより安全な鍵に変換し、それをoutputに格納します。ユーザーはハッシュ関数としてSHAとMD5のいずれかを選択できます。
int	wc_PBKDF2(byte * output, const byte * passwd, int pLen, const byte * salt, int sLen, int iterations, int kLen, int hashType) この関数は、パスワードベース鍵導出関数2(PBKDF2)を実装し、連結されたソルトを持つ入力パスワードをより安全な鍵に変換し、それをoutputに格納します。ユーザーは、WC_MD5、WC_SHA、WC_SHA256、WC_SHA384、WC_SHA512、WC_SHA3_224、WC_SHA3_256、WC_SHA3_384、またはWC_SHA3_512を含む、サポートされているHMACハッシュ関数のいずれかを選択できます。
int	wc_PKCS12_PBKDF(byte * output, const byte * passwd, int passLen, const byte * salt, int saltLen, int iterations, int kLen, int hashType, int id) この関数は、RFC 7292付録Bに記述されているパスワードベース鍵導出関数(PBKDF)を実装します。この関数は、連結されたソルトを持つ入力パスワードをより安全な鍵に変換し、それをoutputに格納します。ユーザーは、WC_MD5、WC_SHA、WC_SHA256、WC_SHA384、WC_SHA512、WC_SHA3_224、WC_SHA3_256、WC_SHA3_384、またはWC_SHA3_512を含む、サポートされているHMACハッシュ関数のいずれかを選択できます。

Functions Documentation

function wc_PBKDF1

int wc_PBKDF1(
    byte * output,
    const byte * passwd,
    int pLen,
    const byte * salt,
    int sLen,
    int iterations,
    int kLen,
    int hashType
)

この関数は、パスワードベース鍵導出関数1(PBKDF1)を実装し、連結されたソルトを持つ入力パスワードをより安全な鍵に変換し、それをoutputに格納します。ユーザーはハッシュ関数としてSHAとMD5のいずれかを選択できます。

Parameters:

• output 生成された鍵を格納するバッファへのポインタ。少なくともkLenの長さである必要があります
• passwd 鍵導出に使用するパスワードを含むバッファへのポインタ
• pLen 鍵導出に使用するパスワードの長さ
• salt 鍵導出に使用するソルトを含むバッファへのポインタ
• sLen ソルトの長さ
• iterations ハッシュを処理する回数
• kLen 導出される鍵の希望の長さ。選択されたハッシュのダイジェストサイズより長くしないでください
• hashType 使用するハッシュアルゴリズム。有効な選択肢はWC_MD5とWC_SHAです

See:

• wc_PBKDF2
• wc_PKCS12_PBKDF

Return:

• 0 入力パスワードから鍵の導出に成功した場合に返されます
• BAD_FUNC_ARG 無効なハッシュタイプが指定された場合(有効なタイプはMD5とSHA)、iterationsが1未満の場合、または要求された鍵の長さ(kLen)が提供されたハッシュのハッシュ長より大きい場合に返されます
• MEMORY_E SHAまたはMD5オブジェクトのメモリ割り当て中にエラーが発生した場合に返されます

Example

int ret;
byte key[WC_MD5_DIGEST_SIZE];
byte pass[] = { }; // パスワードで初期化
byte salt[] = { }; // ソルトで初期化

ret = wc_PBKDF1(key, pass, sizeof(pass), salt, sizeof(salt), 1000,
sizeof(key), WC_MD5);
if ( ret != 0 ) {
    // パスワードからの鍵導出エラー
}

function wc_PBKDF2

int wc_PBKDF2(
    byte * output,
    const byte * passwd,
    int pLen,
    const byte * salt,
    int sLen,
    int iterations,
    int kLen,
    int hashType
)

この関数は、パスワードベース鍵導出関数2(PBKDF2)を実装し、連結されたソルトを持つ入力パスワードをより安全な鍵に変換し、それをoutputに格納します。ユーザーは、WC_MD5、WC_SHA、WC_SHA256、WC_SHA384、WC_SHA512、WC_SHA3_224、WC_SHA3_256、WC_SHA3_384、またはWC_SHA3_512を含む、サポートされているHMACハッシュ関数のいずれかを選択できます。

Parameters:

• output 生成された鍵を格納するバッファへのポインタ。kLenの長さである必要があります
• passwd 鍵導出に使用するパスワードを含むバッファへのポインタ
• pLen 鍵導出に使用するパスワードの長さ
• salt 鍵導出に使用するソルトを含むバッファへのポインタ
• sLen ソルトの長さ
• iterations ハッシュを処理する回数
• kLen 導出される鍵の希望の長さ
• hashType 使用するハッシュアルゴリズム。有効な選択肢は、WC_MD5、WC_SHA、WC_SHA256、WC_SHA384、WC_SHA512、WC_SHA3_224、WC_SHA3_256、WC_SHA3_384、またはWC_SHA3_512です

See:

• wc_PBKDF1
• wc_PKCS12_PBKDF

Return:

• 0 入力パスワードから鍵の導出に成功した場合に返されます
• BAD_FUNC_ARG 無効なハッシュタイプが指定された場合、またはiterationsが1未満の場合に返されます
• MEMORY_E HMACオブジェクトのメモリ割り当て中にエラーが発生した場合に返されます

Example

int ret;
byte key[64];
byte pass[] = { }; // パスワードで初期化
byte salt[] = { }; // ソルトで初期化

ret = wc_PBKDF2(key, pass, sizeof(pass), salt, sizeof(salt), 2048, sizeof(key),
WC_SHA512);
if ( ret != 0 ) {
    // パスワードからの鍵導出エラー
}

function wc_PKCS12_PBKDF

int wc_PKCS12_PBKDF(
    byte * output,
    const byte * passwd,
    int passLen,
    const byte * salt,
    int saltLen,
    int iterations,
    int kLen,
    int hashType,
    int id
)

この関数は、RFC 7292付録Bに記述されているパスワードベース鍵導出関数(PBKDF)を実装します。この関数は、連結されたソルトを持つ入力パスワードをより安全な鍵に変換し、それをoutputに格納します。ユーザーは、WC_MD5、WC_SHA、WC_SHA256、WC_SHA384、WC_SHA512、WC_SHA3_224、WC_SHA3_256、WC_SHA3_384、またはWC_SHA3_512を含む、サポートされているHMACハッシュ関数のいずれかを選択できます。

Parameters:

• output 生成された鍵を格納するバッファへのポインタ。kLenの長さである必要があります
• passwd 鍵導出に使用するパスワードを含むバッファへのポインタ
• passLen 鍵導出に使用するパスワードの長さ
• salt 鍵導出に使用するソルトを含むバッファへのポインタ
• saltLen ソルトの長さ
• iterations ハッシュを処理する回数
• kLen 導出される鍵の希望の長さ
• hashType 使用するハッシュアルゴリズム。有効な選択肢は、WC_MD5、WC_SHA、WC_SHA256、WC_SHA384、WC_SHA512、WC_SHA3_224、WC_SHA3_256、WC_SHA3_384、またはWC_SHA3_512です
• id 鍵生成の目的を示すバイト識別子。鍵出力を多様化するために使用され、次のように割り当てる必要があります。ID=1: 疑似乱数ビットは、暗号化または復号を実行するための鍵材料として使用されます。ID=2: 疑似乱数ビットは、暗号化または復号のためのIV(初期値)として使用されます。ID=3: 疑似乱数ビットは、MAC処理のための完全性鍵として使用されます。

See:

• wc_PBKDF1
• wc_PBKDF2

Return:

• 0 入力パスワードから鍵の導出に成功した場合に返されます
• BAD_FUNC_ARG 無効なハッシュタイプが指定された場合、iterationsが1未満の場合、または要求された鍵の長さ(kLen)が提供されたハッシュのハッシュ長より大きい場合に返されます
• MEMORY_E メモリ割り当て中にエラーが発生した場合に返されます
• MP_INIT_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_READ_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_CMP_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_INVMOD_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_EXPTMOD_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_MOD_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_MUL_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_ADD_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_MULMOD_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_TO_E 鍵生成中にエラーが発生した場合に返される可能性があります
• MP_MEM 鍵生成中にエラーが発生した場合に返される可能性があります

Example

int ret;
byte key[64];
byte pass[] = { }; // パスワードで初期化
byte salt[] = { }; // ソルトで初期化

ret = wc_PKCS12_PBKDF(key, pass, sizeof(pass), salt, sizeof(salt), 2048,
sizeof(key), SHA512, 1);
if ( ret != 0 ) {
    // パスワードからの鍵導出エラー
}

Source code

int wc_PBKDF1(byte* output, const byte* passwd, int pLen,
                      const byte* salt, int sLen, int iterations, int kLen,
                      int hashType);

int wc_PBKDF2(byte* output, const byte* passwd, int pLen,
                      const byte* salt, int sLen, int iterations, int kLen,
                      int hashType);

int wc_PKCS12_PBKDF(byte* output, const byte* passwd, int passLen,
                            const byte* salt, int saltLen, int iterations,
                            int kLen, int hashType, int id);

---

Updated on 2025-12-12 at 03:08:17 +0000