Encrypt (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / Encryption/compression functions

Binary format of an encrypted string
Encrypting and decrypting an external file
Encryption in PHP
Encryption in Android/Java and decryption by a WINDEV application (or conversely)

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Encrypt (Function)

In french: Crypte

Warning
From version 24, Crypt is kept for backward compatibility. This function has been replaced with Encrypt.

Encrypts a character string in binary format or in ASCII format.

Remarks:

This character string can be decrypted by Decrypt.
If the encryption and the decryption are performed on different platforms (encryption in Android and decryption in Windows for example), use EncryptStandard and DecryptStandard. For more details, refer to the "Remarks" paragraph.

Example

See additional examples

// Encrypt a string
Res = Encrypt("My credit card number is 52327453829011", "Password")

// Encode a string in base 64
bufBase64 is Buffer = Encrypt(bufToEncode, "", compressNone + cryptNone, encodeBASE64)

Syntax

<Result> = Encrypt(<String to encrypt> , <Password> [, <Type of encryption> [, <Format of encrypted string>]])

<Result>: Character string

Encrypted character string,
Empty string ("") if an error occurred. To get more details on the error, use ErrorInfo.

<String to encrypt>: Character string

Text to encrypt.

<Password>: Character string

Password used to encrypt the character string. This password will be used to decrypt the encrypted string (Decrypt). A long password optimizes the encryption security.

<Type of encryption>: Optional constant (or combination of constants)

Indicates the type of encryption and/or compression:
Type of encryption:
cryptAnsi The encryption is identical to the one performed in a WINDEV or WEBDEV application. Useful for the applications that encrypt in WINDEV Mobile and that decrypt in WINDEV for example.
To use this constant, <Format of encrypted string> must correspond to the encodePCS constant.
Remark: If the cryptAnsi constant is not combined with another constant that specifies the type of encryption, the <Password> parameter is ignored.
This constant can only be used in WINDEV Mobile for Windows CE.
This constant has no effect.
cryptFast
(Default value) Priority is given to the encryption speed (algorithm on 128 bits).
The algorithm used will be a Blowfish algorithm.
This constant is not available.
The algorithm used will be a Blowfish algorithm with 16 rounds.
cryptNone No encryption is performed
cryptRC516 Priority is given to the encryption security (RC5 algorithm on 16 rounds).
This constant has no effect.
cryptSecure Priority is given to the encryption security (RC5 algorithm on 128 bits).
The algorithm used will be a PBE algorithm (Password Based Encryption).
The algorithm used will be a 128-bit RINJDAEL algorithm.
Type of compression:
compressLZW The string will be compressed before it is encrypted.
This constant has no effect.
compressNone
(Default value) No compression is performed.
This constant has no effect.
compressShortString The string will be compressed via an algorithm optimized for the short character strings. This compression will be effective only if the cryptNone constant is selected and if <Format of encrypted string> corresponds to the encodeNone constant.
This constant has no effect.

<Format of encrypted string>: Optional Integer constant

Indicates the format of encrypted string:
encodeBASE64 BASE 64 format. The file is encrypted with the BASE64 algorithm. The encrypted file will be larger (about 30%) than the initial file.
To perform an encoding in base 64, you also have the ability to use Encode associated with the encodeBASE64 or encodeBASE64URL constant.
The base64 format can be used to insert an encrypted file into the email body for example.
encodeNone Binary format. The encrypted file may contain non-printable characters. The file will be larger (about 4 bytes) than the initial file.
encodePCS
(Default value) ASCII format. The encrypted file will contain printable characters only. The encrypted file will be larger (about 30%) than the initial file.
This format can be used to insert an encrypted file into the email body for example.
encodeUUEncode UUEncode format. The file is encrypted with the UUEncode algorithm. The encrypted file will be larger (about 30%) than the initial file.
This format can be used to insert an encrypted file into the email body for example.
This parameter is ignored. The encrypted string will be in BASE 64 format.

Remarks

Binary format of an encrypted string

The encrypted string must be handled properly when <Format of encrypted string> corresponds to the encodeNone constant. Indeed, this encrypted string may contain end of string characters. In this case, the string will be truncated by the display operations.

Part of the encrypted information will be lost if:

The encrypted string is displayed in a control.
The value of this control is used for the decryption.

However, no information will be lost if the encrypted string is handled as a string variable.

Encrypting and decrypting an external file

To encrypt/decrypt an external file, use fEncrypt and fDecrypt.

Encryption in PHP

In PHP, the BlowFish encryption (cryptFast constant) and the RINJDAEL encryption (cryptSecure constant) are based on the MCrypt library. This library is commonly used by the PHP hosting companies and therefore it is always enabled. This library can be downloaded from the PHP site.

To enable (if necessary) this library locally, the following elements are required:

PHP installed.
the PHP.INI file found in the Windows directory must include the "extension=php_mcrypt.dll" line.
the php_mcrypt.dll file must exist in the directory of PHP extensions. This directory is defined in the PHP.INI file by the "extension_dir" variable.

Encryption in Android/Java and decryption by a WINDEV application (or conversely)

Caution: the encryption/decryption algorithms used in Java and Android differ from the ones used by WINDEV. Therefore, you cannot encrypt a character string in Java or Android and decrypt it with WINDEV (and conversely).

To encrypt a character string in Java or Android and to decrypt it with WINDEV (or conversely), use EncryptStandard and DecryptStandard.

Related Examples:

Unit examples (WEBDEV): The encryption functions

[ + ] This example explains how to use the encryption/decryption functions of WEBDEV. This example allows you to:
- Encrypt a character string
- Decrypt a character string

Unit examples (WINDEV): The encryption functions

[ + ] Using the encryption/decryption functions of WINDEV.
This example is used to:
- Encrypt a character string
- Decrypt a character string

Unit examples (WINDEV Mobile): The encryption functions

[ + ] Using the WLanguage encryption and decryption functions.
This example is used to:
- Encrypt a character string
- Decrypt a character string

Training (WINDEV): WD Evaluation period

[ + ] This example explains how to limit the use of an application to a given period (evaluation period).
The following topics are presented in this example:
1/ the protection of an application for a given duration
2/ the management of the registry

Summary of the example supplied with WINDEV:
When this example is started for the first time, it is activated for an evaluation period set to 5 days.
The information regarding the date when it was first started is stored in the registry and a control key is used to check whether this date was not modified by the end user. At the end of the evaluation period, the application is locked, unless the end user provides the code for unlocking the application

Component: wd300std.dll