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 the DecryptAsymmetric function.
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

// Cryptage d'une chaîne de caractères
//---------------------------------------
bufACrypter is Buffer = "Message à crypter"
bufMessageCrypté is Buffer
sFichierCléPublique is string = fExeDir() + "\ClePublique.pem"
sMotDePasseCléPublique is string = "xxx"

bufMessageCrypté = EncryptAsymmetric(bufACrypter, sFichierCléPublique, ...
sMotDePasseCléPublique, cryptPaddingPKCS1)

// Décryptage
// -------------
bufMessageCrypté is Buffer
bufMessageDécrypté is Buffer
sFichierCléPrivée is string = fExeDir() + "\ClePrivee.pem"
sMotDePasseCléPrivée is string = "xxx"

bufMessageDécrypté = DecryptAsymmetric(bufMessageCrypté, sFichierCléPrivée, ...
sMotDePasseCléPrivée, 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

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

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: wd270com.dll