mirror of https://github.com/acidanthera/audk.git
122 lines
3.1 KiB
C
122 lines
3.1 KiB
C
|
/** @file
|
||
|
|
RSA Asymmetric Cipher Wrapper Null Implementation.
|
||
|
|
|
||
|
|
This file implements following APIs which provide basic capabilities for RSA:
|
||
|
|
1) RsaNew
|
||
|
|
2) RsaFree
|
||
|
|
3) RsaSetKey
|
||
|
|
4) RsaPkcs1Verify
|
||
|
|
|
||
|
|
Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.<BR>
|
||
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
||
|
|
|
||
|
|
**/
|
||
|
|
|
||
|
|
#include "InternalCryptLib.h"
|
||
|
|
|
||
|
|
/**
|
||
|
|
Allocates and initializes one RSA context for subsequent use.
|
||
|
|
|
||
|
|
@return Pointer to the RSA context that has been initialized.
|
||
|
|
If the allocations fails, RsaNew() returns NULL.
|
||
|
|
|
||
|
|
**/
|
||
|
|
VOID *
|
||
|
|
EFIAPI
|
||
|
|
RsaNew (
|
||
|
|
VOID
|
||
|
|
)
|
||
|
|
{
|
||
|
|
//
|
||
|
|
// Allocates & Initializes RSA Context
|
||
|
|
//
|
||
|
|
ASSERT (FALSE);
|
||
|
|
return NULL;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
Release the specified RSA context.
|
||
|
|
|
||
|
|
@param[in] RsaContext Pointer to the RSA context to be released.
|
||
|
|
|
||
|
|
**/
|
||
|
|
VOID
|
||
|
|
EFIAPI
|
||
|
|
RsaFree (
|
||
|
|
IN VOID *RsaContext
|
||
|
|
)
|
||
|
|
{
|
||
|
|
//
|
||
|
|
// Free RSA Context
|
||
|
|
//
|
||
|
|
ASSERT (FALSE);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
Sets the tag-designated key component into the established RSA context.
|
||
|
|
|
||
|
|
This function sets the tag-designated RSA key component into the established
|
||
|
|
RSA context from the user-specified non-negative integer (octet string format
|
||
|
|
represented in RSA PKCS#1).
|
||
|
|
If BigNumber is NULL, then the specified key component in RSA context is cleared.
|
||
|
|
|
||
|
|
If RsaContext is NULL, then return FALSE.
|
||
|
|
|
||
|
|
@param[in, out] RsaContext Pointer to RSA context being set.
|
||
|
|
@param[in] KeyTag Tag of RSA key component being set.
|
||
|
|
@param[in] BigNumber Pointer to octet integer buffer.
|
||
|
|
If NULL, then the specified key component in RSA
|
||
|
|
context is cleared.
|
||
|
|
@param[in] BnSize Size of big number buffer in bytes.
|
||
|
|
If BigNumber is NULL, then it is ignored.
|
||
|
|
|
||
|
|
@retval TRUE RSA key component was set successfully.
|
||
|
|
@retval FALSE Invalid RSA key component tag.
|
||
|
|
|
||
|
|
**/
|
||
|
|
BOOLEAN
|
||
|
|
EFIAPI
|
||
|
|
RsaSetKey (
|
||
|
|
IN OUT VOID *RsaContext,
|
||
|
|
IN RSA_KEY_TAG KeyTag,
|
||
|
|
IN CONST UINT8 *BigNumber,
|
||
|
|
IN UINTN BnSize
|
||
|
|
)
|
||
|
|
{
|
||
|
|
ASSERT (FALSE);
|
||
|
|
return FALSE;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
Verifies the RSA-SSA signature with EMSA-PKCS1-v1_5 encoding scheme defined in
|
||
|
|
RSA PKCS#1.
|
||
|
|
|
||
|
|
If RsaContext is NULL, then return FALSE.
|
||
|
|
If MessageHash is NULL, then return FALSE.
|
||
|
|
If Signature is NULL, then return FALSE.
|
||
|
|
If HashSize is not equal to the size of MD5, SHA-1 or SHA-256 digest, then return FALSE.
|
||
|
|
|
||
|
|
@param[in] RsaContext Pointer to RSA context for signature verification.
|
||
|
|
@param[in] MessageHash Pointer to octet message hash to be checked.
|
||
|
|
@param[in] HashSize Size of the message hash in bytes.
|
||
|
|
@param[in] Signature Pointer to RSA PKCS1-v1_5 signature to be verified.
|
||
|
|
@param[in] SigSize Size of signature in bytes.
|
||
|
|
|
||
|
|
@retval TRUE Valid signature encoded in PKCS1-v1_5.
|
||
|
|
@retval FALSE Invalid signature or invalid RSA context.
|
||
|
|
|
||
|
|
**/
|
||
|
|
BOOLEAN
|
||
|
|
EFIAPI
|
||
|
|
RsaPkcs1Verify (
|
||
|
|
IN VOID *RsaContext,
|
||
|
|
IN CONST UINT8 *MessageHash,
|
||
|
|
IN UINTN HashSize,
|
||
|
|
IN CONST UINT8 *Signature,
|
||
|
|
IN UINTN SigSize
|
||
|
|
)
|
||
|
|
{
|
||
|
|
ASSERT (FALSE);
|
||
|
|
return FALSE;
|
||
|
|
}
|