EncryptAsymmetricEnvelopped (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Asymmetric encryption of an envelope

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

EncryptAsymmetricEnvelopped (Function)

In french: CrypteAsymétriqueEnveloppé

Performs an asymmetric encryption of an envelope.

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 = EncryptAsymmetricEnvelopped(bufToEncrypt, sPublicKeyFile, ...
sPublicKeyPassword)

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

bufDecryptedMessage = DecryptAsymmetricEnvelopped(bufEncryptedMessage, sPrivateKeyFile, ...
sPasswordPrivateKey)

Syntax

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

<Result>: Buffer

All the information necessary for decryption (algorithms used, encrypted key, initialization vector and encrypted buffer).

<Content to encrypt>: Character string or Buffer

Character string or buffer to encrypt.

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

Name and path of the file corresponding to the public key that will be used to encrypt.

<Password>: Optional character string (with quotes)

Key file password (if required).

Remarks

Asymmetric encryption of an envelope

EncryptAsymmetricEnvelopped generates a random encryption key that will be used to to encrypt <Content to encrypt> with a symmetric algorithm.

The key is encrypted with the public key of <Public key file>.

<Result> contains a buffer that concatenates all the necessary information for the decryption (algorithms used, encrypted key, initialization buffer and encrypted buffer).

Remarks:

The private key is encrypted using OAEP padding.
The message is encrypted using AES 256 in CBC with PKCS padding.

Component : wd250com.dll