mirror of https://github.com/wolfSSL/wolfssl.git
90 lines
3.8 KiB
C
90 lines
3.8 KiB
C
/*!
|
||
\ingroup CryptoCb
|
||
\brief この関数は、Crypto Operationsをキーストア、Secure Element、HSM、PKCS11またはTPMなどの外部ハードウェアにオフロードするための固有のデバイス識別子（DEVID）とコールバック関数を登録します。CryptoコールバックのSTSAFEの場合は、wolfcrypt / src / port / st / stsafe.cとwolfssl_stsafe_cryptodevcb関数を参照してください。TPMベースのCryptoコールバックの例では、wolftpm src / tpm2_wrap.cのwolftpm2_cryptodevcb関数を参照してください。
|
||
\return CRYPTOCB_UNAVAILABLE ソフトウェア暗号を使用するためにフォールバックする
|
||
\return 0 成功のために
|
||
\return negative 失敗の値
|
||
\param devId -2（invalid_devid）ではなく、一意の値ではありません。
|
||
_Example_
|
||
\code
|
||
#include <wolfssl/wolfcrypt/settings.h>
|
||
#include <wolfssl/wolfcrypt/cryptocb.h>
|
||
static int myCryptoCb_Func(int devId, wc_CryptoInfo* info, void* ctx)
|
||
{
|
||
int ret = CRYPTOCB_UNAVAILABLE;
|
||
|
||
if (info->algo_type == WC_ALGO_TYPE_PK) {
|
||
#ifndef NO_RSA
|
||
if (info->pk.type == WC_PK_TYPE_RSA) {
|
||
switch (info->pk.rsa.type) {
|
||
case RSA_PUBLIC_ENCRYPT:
|
||
case RSA_PUBLIC_DECRYPT:
|
||
// RSA public op
|
||
ret = wc_RsaFunction(
|
||
info->pk.rsa.in, info->pk.rsa.inLen,
|
||
info->pk.rsa.out, info->pk.rsa.outLen,
|
||
info->pk.rsa.type, info->pk.rsa.key,
|
||
info->pk.rsa.rng);
|
||
break;
|
||
case RSA_PRIVATE_ENCRYPT:
|
||
case RSA_PRIVATE_DECRYPT:
|
||
// RSA private op
|
||
ret = wc_RsaFunction(
|
||
info->pk.rsa.in, info->pk.rsa.inLen,
|
||
info->pk.rsa.out, info->pk.rsa.outLen,
|
||
info->pk.rsa.type, info->pk.rsa.key,
|
||
info->pk.rsa.rng);
|
||
break;
|
||
}
|
||
}
|
||
#endif
|
||
#ifdef HAVE_ECC
|
||
if (info->pk.type == WC_PK_TYPE_ECDSA_SIGN) {
|
||
// ECDSA
|
||
ret = wc_ecc_sign_hash(
|
||
info->pk.eccsign.in, info->pk.eccsign.inlen,
|
||
info->pk.eccsign.out, info->pk.eccsign.outlen,
|
||
info->pk.eccsign.rng, info->pk.eccsign.key);
|
||
}
|
||
#endif
|
||
#ifdef HAVE_ED25519
|
||
if (info->pk.type == WC_PK_TYPE_ED25519_SIGN) {
|
||
// ED25519 sign
|
||
ret = wc_ed25519_sign_msg_ex(
|
||
info->pk.ed25519sign.in, info->pk.ed25519sign.inLen,
|
||
info->pk.ed25519sign.out, info->pk.ed25519sign.outLen,
|
||
info->pk.ed25519sign.key, info->pk.ed25519sign.type,
|
||
info->pk.ed25519sign.context,
|
||
info->pk.ed25519sign.contextLen);
|
||
}
|
||
#endif
|
||
}
|
||
return ret;
|
||
}
|
||
|
||
int devId = 1;
|
||
wc_CryptoCb_RegisterDevice(devId, myCryptoCb_Func, &myCtx);
|
||
wolfSSL_CTX_SetDevId(ctx, devId);
|
||
\endcode
|
||
\sa wc_CryptoCb_UnRegisterDevice
|
||
\sa wolfSSL_SetDevId
|
||
\sa wolfSSL_CTX_SetDevId
|
||
*/
|
||
int wc_CryptoCb_RegisterDevice(int devId, CryptoDevCallbackFunc cb, void* ctx);
|
||
|
||
/*!
|
||
\ingroup CryptoCb
|
||
\brief この関数は、固有のデバイス識別子（devid）コールバック関数を除外します。
|
||
\return none いいえ返します。
|
||
_Example_
|
||
\code
|
||
wc_CryptoCb_UnRegisterDevice(devId);
|
||
devId = INVALID_DEVID;
|
||
wolfSSL_CTX_SetDevId(ctx, devId);
|
||
\endcode
|
||
\sa wc_CryptoCb_RegisterDevice
|
||
\sa wolfSSL_SetDevId
|
||
\sa wolfSSL_CTX_SetDevId
|
||
*/
|
||
void wc_CryptoCb_UnRegisterDevice(int devId);
|