RFC: https://bugzilla.tianocore.org/show_bug.cgi?id=3853 This is the Cryptographic library instance for SEC. The motivation of this library is to support SHA384 in SEC phase for Td guest. So only Hash/CryptSha512.c is included which supports SHA384 and SHA512. Other cryptographics are added with the null version, such as CryptMd5Null.c. Cc: Jiewen Yao <jiewen.yao@intel.com> Cc: Jian J Wang <jian.j.wang@intel.com> Cc: Xiaoyu Lu <xiaoyu1.lu@intel.com> Cc: Guomin Jiang <guomin.jiang@intel.com> Cc: Gerd Hoffmann <kraxel@redhat.com> Reviewed-by: Jiewen Yao <jiewen.yao@intel.com> Signed-off-by: Min Xu <min.m.xu@intel.com>
		
			
				
	
	
		
			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;
 | 
						|
}
 |