EncryptAsymmetricEnvelopped (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

New WINDEV, WEBDEV, WINDEV Mobile 24 feature!

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.

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

Notes:

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

Component : wd240com.dll