EncryptAsymmetric (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

New WINDEV, WEBDEV, WINDEV Mobile 24 feature!

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

EncryptAsymmetric (Function)

In french: CrypteAsymétrique

Encrypts a character string or buffer using an asymmetric encryption algorithm (RSA) that requires a public key and a private key.

This encrypted message can be decrypted:

with DecryptAsymmetric.
with third-party software (using the same filling options).

Example

// Encrypting a character string
//---------------------------------------
bufToEncrypt is Buffer = "Message to encrypt"
bufEncryptedMessage is Buffer
sPublicKeyFile is string = fExeDir() + "\PublicKey.pem"
sPublicKeyPassword is string = "xxx"

bufEncryptedMessage = EncryptAsymmetric(bufToEncrypt, sPublicKeyFile, ...
sPublicKeyPassword, cryptPaddingPKCS1)

// Decryption
// -------------
bufEncryptedMessage is Buffer
bufDecryptedMessage is Buffer
sPrivateKeyFile is string = fExeDir() + "\PrivateKey.pem"
sPrivateKeyPassword is string = "xxx"

bufDecryptedMessage = DecryptAsymmetric(bufEncryptedMessage, sPrivateKeyFile, ...
sPrivateKeyPassword, cryptPaddingPKCS1)

Syntax

<Result> = EncryptAsymmetric(<Content to encrypt> , <Public key file> [, <Password> [, <Filling>]])

<Result>: Character string or Buffer

Result of encryption for the specified message.

<Content to encrypt>: Character string or Buffer

Character string or buffer to encrypt.
Caution: The size of the message to be encrypted must be smaller than the size of the key minus the minimum padding size (11 bytes for PKCS1 and 41 for OAEP).
For example, for a 4096-bit key and OAEP padding, the message cannot exceed 471 bytes.

<Public key file>: Character string (with quotes)

Name and path of the file corresponding to the public key that will be used to encrypt. pem, der and p12 key formats are supported.

<Password>: Optional character string (with quotes)

Key file password (if required).

<Filling>: Optional Integer constant

Mode for filling the encrypted data in order to be compatible with the size required by the encryption algorithms by blocks:
cryptPaddingPKCS1
(Default value) Filling according to the PKCS 1 algorithm (Public Key Cryptographic Standards).
cryptPaddingOAEP Filling according to the OAEP algorithm (Optimal Asymmetric Encryption Padding).

Component : wd240com.dll