MQLArticles/Utils/Encrypt/README.md

Encrypt

Este modulo integra una clase CEncryptor, clase warppers con funciones utiles para encryptar y desencriptar archivos y texto se basa en las funciones nativas que proporciona MQL5 (CryptEncode / CryptDecode).

Métodos soportados

Método	Key requerida
CRYPT_AES128	16 chars
CRYPT_AES256	32 chars
CRYPT_DES	7 chars

Los métodos de hash (CRYPT_HASH_SHA1, CRYPT_HASH_SHA256, CRYPT_HASH_MD5) y CRYPT_BASE64 no son métodos de encriptación y no están soportados por esta clase.

---

Funcion EncryptFile

Firma:

bool EncryptFile(const string& file_name, bool common_flag, ENUM_CRYPT_METHOD method, bool delete_prev_file, string ext_encrypt = "")

Parametros

Parámetro	Descripción
file_name	Ruta del archivo encriptado
common_flag	true = carpeta Common, false = MQL5\Files del terminal
method	Método usado al encriptar (ver tabla de métodos)
delete_prev_file	true = elimina el archivo encriptado original tras encriptar
ext_encrypt	true = Extension para el archivo encryptado por defecto nada ("")

Ejemplos

 enc.EncryptFile("file.txt", false, CRYPT_AES256, false, ".enc");

---

Funcion DecryptFile

Firma

// Versión 1 — resultado en archivo
bool DecryptFile(const string& file_name, bool common_flag, ENUM_CRYPT_METHOD method, bool delete_prev_file, string ext_decrypt = "")

// Versión 2 — resultado en memoria
bool DecryptFile(const string& file_name, bool common_flag, ENUM_CRYPT_METHOD method, bool delete_prev_file, uchar& res_data[])

Parámetros comunes

Parámetro	Descripción
file_name	Ruta del archivo encriptado
common_flag	true = carpeta Common, false = MQL5\Files del terminal
method	Método usado al encriptar (ver tabla de métodos)
delete_prev_file	true = elimina el archivo encriptado original tras desencriptar

Parámetro ext_decrypt (Versión 1)

Controla el nombre del archivo de salida:

Valor	Comportamiento	Ejemplo
""	Sobreescribe el mismo archivo	file.enc a file.enc
".ext"	Agrega extensión al nombre	file.enc a file.enc.ext
"-"	Quita la última extensión	file.enc a file
".ext-"	Reemplaza la última extensión	file.enc a file.ext

Nota: Si delete_prev_file = false y ext_decrypt = "", el archivo encriptado (solo si este no tiene extension, si tiene eg .enc el archivo original no sera sobreescrito solo el encriptado) es sobreescrito con el contenido desencriptado.

Ejemplos

// Versión 1 — quitar extensión .enc
enc.DecryptFile("data.csv.enc", true, CRYPT_AES256, true, "-");
// Resultado: data.csv  (data.csv.enc eliminado)

// Versión 1 — reemplazar extensión
enc.DecryptFile("data.csv.enc", true, CRYPT_AES256, false, ".csv-");
// Resultado: data.csv  (data.csv.enc conservado)

// Versión 2 — resultado en memoria
uchar buffer[];
enc.DecryptFile("data.csv.enc", true, CRYPT_AES256, false, buffer);
// buffer contiene el contenido desencriptado

---

SetAleatoryKey

Firma

bool SetAleatoryKey(ENUM_CRYPT_METHOD method, FuncGenerateRandomUchar f_generate_char, void* ptr = NULL, uchar chart_start = 32, uchar chart_stop = 255)

Parámetros

Parámetro	Descripción
method	Método de encriptación (determina el largo de la key)
f_generate_char	Función que genera un uchar aleatorio
ptr	Puntero al generador (se pasa a f_generate_char, esto es opcional solo si la funcion trabaja con clases)
chart_start	Valor mínimo del carácter generado (default: 32)
chart_stop	Valor máximo del carácter generado (default: 255)

Nota: El largo de la key se determina automáticamente según el método: AES128 = 16, AES256 = 32, DES = 7. La key generada queda almacenada internamente y puede recuperarse con Key().

Ejemplo

CRandomSimple random;
enc.SetAleatoryKey(CRYPT_AES256, RandomSimpleGenerateRandomUchar, &random);
Print(enc.Key()); // key de 32 chars generada

---

EncryptText / DecryptText

Firma

bool EncryptText(const string& initial_text, ENUM_CRYPT_METHOD method, string& encrypted_text)
bool DecryptText(const string& encrypted_text, ENUM_CRYPT_METHOD method, string& decrypted_text)

Parámetros

Parámetro	Descripción
initial_text	Texto plano a encriptar
encrypted_text	String encriptado en BASE64 (entrada en Decrypt, salida en Encrypt)
decrypted_text	Texto plano recuperado (salida en Decrypt)
method	Método de encriptación (ver tabla de métodos)

Nota: El texto encriptado se convierte automáticamente a BASE64 para poder almacenarse como string. Al desencriptar se revierte el proceso: BASE64 → bytes → texto original.

Ejemplo

string encrypted, decrypted;

enc.EncryptText("texto secreto", CRYPT_AES256, encrypted);
// encrypted contiene el texto en BASE64

enc.DecryptText(encrypted, CRYPT_AES256, decrypted);
// decrypted == "texto secreto"