nRF5 SDK v13.0.0
Macros | Functions
crys_rsa_prim

This module defines the API that implements the [PKCS1_2.1] primitive functions. More...

Macros

#define CRYS_RSA_PRIM_Sign   CRYS_RSA_PRIM_Decrypt
 Implements the RSASP1 algorithm, as defined in [PKCS1_2.1] - 6.2.1, as a call to CRYS_RSA_PRIM_Decrypt, since the signature primitive is identical to the decryption primitive.
 
#define CRYS_RSA_PRIM_Verify   CRYS_RSA_PRIM_Encrypt
 Implements the RSAVP1 algorithm, as defined in [PKCS1_2.1] - 6.2.2, as a call to CRYS_RSA_PRIM_Encrypt.
 

Functions

CRYSError_t CRYS_RSA_PRIM_Encrypt (CRYS_RSAUserPubKey_t *UserPubKey_ptr, CRYS_RSAPrimeData_t *PrimeData_ptr, uint8_t *Data_ptr, uint16_t DataSize, uint8_t *Output_ptr)
 Implements the RSAEP algorithm, as defined in [PKCS1_2.1] - 6.1.1. More...
 
CRYSError_t CRYS_RSA_PRIM_Decrypt (CRYS_RSAUserPrivKey_t *UserPrivKey_ptr, CRYS_RSAPrimeData_t *PrimeData_ptr, uint8_t *Data_ptr, uint16_t DataSize, uint8_t *Output_ptr)
 Implements the RSADP algorithm, as defined in [PKCS1_2.1] - 6.1.2. More...
 

Detailed Description

This module defines the API that implements the [PKCS1_2.1] primitive functions.

Note
Direct use of primitive functions, rather than schemes to protect data, is strongly discouraged as primitive functions are susceptible to well-known attacks.

Function Documentation

CRYSError_t CRYS_RSA_PRIM_Decrypt ( CRYS_RSAUserPrivKey_t UserPrivKey_ptr,
CRYS_RSAPrimeData_t PrimeData_ptr,
uint8_t *  Data_ptr,
uint16_t  DataSize,
uint8_t *  Output_ptr 
)

Implements the RSADP algorithm, as defined in [PKCS1_2.1] - 6.1.2.

Returns
CRYS_OK on success.
A non-zero value from crys_rsa_error.h on failure.
Parameters
[in]UserPrivKey_ptrPointer to the private key data structure. The representation (pair or quintuple) and hence the algorithm (CRT or not-CRT) is determined by the Private Key data structure - using CRYS_RSA_Build_PrivKey or CRYS_RSA_Build_PrivKeyCRT to determine which algorithm is used.
[in]PrimeData_ptrPointer to a temporary structure containing internal buffers required for the RSA operation.
[in]Data_ptrPointer to the data to be decrypted.
[in]DataSizeThe size (in bytes) of the data to decrypt. Must be equal to the modulus size.
[out]Output_ptrPointer to the decrypted data. The buffer size must be ≤ the modulus size.
CRYSError_t CRYS_RSA_PRIM_Encrypt ( CRYS_RSAUserPubKey_t UserPubKey_ptr,
CRYS_RSAPrimeData_t PrimeData_ptr,
uint8_t *  Data_ptr,
uint16_t  DataSize,
uint8_t *  Output_ptr 
)

Implements the RSAEP algorithm, as defined in [PKCS1_2.1] - 6.1.1.

Returns
CRYS_OK on success.
A non-zero value from crys_rsa_error.h on failure.
Parameters
[in]UserPubKey_ptrPointer to the public key data structure.
[in]PrimeData_ptrPointer to a temporary structure containing internal buffers.
[in]Data_ptrPointer to the data to encrypt.
[in]DataSizeThe size (in bytes) of the data to encrypt. Data size must be ≤ Modulus size. It can be smaller than the modulus size but it is not recommended. If smaller, the data is zero-padded up to the modulus size. Since the result of decryption is always the size of the modulus, this will cause the size of the decrypted data to be larger than the originally encrypted data.
[out]Output_ptrPointer to the encrypted data. The buffer size must be ≥ the modulus size.

Documentation feedback | Developer Zone | Subscribe | Updated