EncryptAsymmetric (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

EncryptAsymmetric (Function)

In french: CrypteAsymétrique

Encrypts a 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 padding options).

Versions 25 and later

This function is now available in Android Widget mode.

This function is now available for Android applications.

New in version 25

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available in Android Widget mode.

This function is now available for Android applications.

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> [, <Padding>]])

<Result>: Character string or Buffer

Result of encryption for the specified message.

<Content to encrypt>: Buffer

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).

<Padding>: Optional Integer constant

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

Related Examples:

Unit examples (WINDEV): Asymmetric encryption

[ + ] Using the asymmetric encryption functions (EncryptAsymmetric, DecryptAsymmetric)

Business / UI classification: Business Logic

Component: wd260com.dll