mbx_rsa_public
mbx_rsa_public
Performs the public key RSA encryption operation.
Syntax
mbx_status mbx_rsa_public_mb8(const int8u* const
from_pa[8]
,int8u* const
to_pa[8]
,const int64u* const
n_pa[8]
, int
rsaBitlen
, const mbx_RSA_Method*
m
, int8u*
pBuffer
);
mbx_status mbx_rsa_public_ssl_mb8(const int8u* const
from_pa[8]
,int8u* const
to_pa[8]
,const BIGNUM* const
e_pa[8]
, const BIGNUM* const
n_pa[8]
, int
rsaBitlen
);
Include Files
crypto_mb/rsa.h
Parameters
- from_pa
- Array of pointers to the plaintext data vectors.
- to_pa
- Array of pointers to the ciphertext data vectors.
- n_pa
- Array of pointers to the RSAs modulus vectors.
- rsaBitLen
- Size of RSAs moduli in bits.
- m
- Pointer to the pre-defined data structure specified by the RSA encryption operation.
- pBuffer
- Pointer to the work buffer.
Description
The
mbx_rsa_public()
function performs independent RSA public key operations using RSA moduli passed though the n_pa
parameter. The public exponent e
is fixed and equals to 65537. The size of RSAs moduli must be the same and equal to rsaBitlen
bits. The function encrypts plaintexts specified by the from_pa
parameter in parallel, and stores ciphertexts in the memory locations specified by the to_pa
parameter. Memory buffers of the plain- and ciphertext must be ceil(rsaBitlen
/8) bytes length. At the moment, RSA-10024, RSA-2048, RSA-3072
and RSA-4096 are supported only. If
m
is NULL
, the function
uses mbx_RSA_pub65537_Method
(rsaBitsize
). If m
is not NULL
, it must be assigned to
either mbx_RSA1K_pub65537_Method()
, mbx_RSA2K_pub65537_Method()
, mbx_RSA3K_pub65537_Method()
or mbx_RSA4K_pub65537_Method()
and match to rsaBitlen
value. If
pBuffer
is NULL
, then the function allocated a work buffer of suitable size dynamically. An
allocated buffer will be released before the function return. If the work
buffer is allocated in the application, it affects performance
positively. The
mbx_RSA_Method_BufSize
() function returns the size of the work buffer required
for the operation. The function itself does not support any kind of padding. The application is responsible for the padding if it is required.
The
mbx_rsa_public_ssl()
function is the "twin" of mbx_rsa_public()
one.
It
acts the same. The basic difference in comparison with
mbx_rsa_public()
is the representation of RSA key stuff. mbx_rsa_public_ssl
uses BIGNUM datatype instead
of vector.Return Values
The
mbx_rsa_public()
function returns the status that indicates whether the operation completed successfully or not. The status value of 0 indicates that all operations completed successfully. The error condition can be analyzed by the MBX_GET_STS()
call.