jofpin/temcryptMarco de cifrado evolutivo basado en complejidad escalable a lo largo del tiempo
Enfocado en proteger datos altamente sensibles, temcrypt es un mecanismo avanzado de cifrado evolutivo de múltiples capas que ofrece complejidad escalable con el tiempo y es resistente a los ataques comunes de fuerza bruta.
Puedes crear tus propias aplicaciones, scripts y automatizaciones al implementarlo.
Descubre lo que significa temcrypt, las características y la inspiración que me llevaron a crearlo y mucho más. LEE EL DOCUMENTO DE CONOCIMIENTO. Esto es muy importante para ti.
temcrypt es compatible tanto con Node.js v18 o superior, como con navegadores web modernos, lo que te permite usarlo en varios entornos.
Las únicas dependencias que utiliza temcrypt son crypto-js para manejar algoritmos de cifrado como AES-256, SHA-256 y algunos codificadores, y fs se utiliza para el manejo de archivos con Node.js.
Para usar temcrypt, necesitas tener Node.js instalado. Luego, puedes instalar temcrypt usando npm:
npm install temcrypt
después de eso, impórtalo en tu código de la siguiente manera:
const temcrypt = require("temcrypt");
Incluye una función de autoinstalación para sus dependencias, por lo que no tienes que preocuparte por instalarlas manualmente. Simplemente ejecuta la librería temcrypt.js y las dependencias se instalarán automáticamente, luego llámalo en tu código. Esto se hizo para que sea portátil:
node temcrypt.js
Alternativamente, puedes usar temcrypt directamente en el navegador incluyendo la siguiente etiqueta script:
<script src="temcrypt.js"></script>
o minificado:
<script src="temcrypt.min.js"></script>
También puedes llamar a la librería en tu sitio web o aplicación web desde una CDN:
<script src="https://cdn.jsdelivr.net/gh/jofpin/temcrypt/temcrypt.min.js"></script>
temcrypt proporciona funciones como encrypt y decrypt para proteger y revelar tu información de forma segura.
Parámetros
dataString (string): Los datos de cadena a encriptar.dataFiles (string): La ruta del archivo a encriptar. Proporciona dataString o dataFiles.mainKey (string): La clave principal (privada) para el cifrado.extraBytes (number, opcional): Bytes adicionales para agregar al cifrado. Es un parámetro opcional utilizado en el proceso de cifrado de temcrypt. Permite agregar bytes extra a los datos cifrados, aumentando la complejidad del cifrado, lo que requiere más potencia de procesamiento para descifrar. También sirve para hacer que los patrones se pierdan al cambiar el peso del cifrado.Devuelve
status (boolean): true para indicar descifrado exitoso.hash (string): El hash único generado para la verificación de legitimidad de los datos cifrados.dataString (string) o dataFiles: La cadena descifrada o la ruta del archivo descifrado, según la entrada.updatedEncryptedData (string): Los datos cifrados actualizados después del descifrado. Cada vez que se descifra el cifrado, la salida se actualiza, porque la mainKey cambia su orden y se guarda la nueva fecha del último descifrado.creationDate (string): La fecha de creación de los datos cifrados.lastDecryptionDate (string): La fecha del último descifrado exitoso de los datos.dataString:
hash (string): El hash único generado para la verificación de legitimidad de los datos cifrados.mainKey (string): La clave principal (privada) utilizada para el cifrado.timeKey (string): La clave temporal (privada) del cifrado.dataString (string): La cadena cifrada.extraBytes (number, opcional): Los bytes extra utilizados para el cifrado.dataFiles:
hash (string): El hash único generado para la verificación de legitimidad de los datos cifrados.mainKey (string): La clave principal utilizada para el cifrado.timeKey (string): La clave temporal del cifrado.dataFiles (string): La ruta del archivo cifrado.extraBytes (number, opcional): Los bytes extra utilizados para el cifrado.status (boolean): false para indicar fallo en el descifrado.error_code (number): Un código de error que indica la razón del fallo del descifrado.message (string): Un mensaje de error descriptivo que explica el fallo del descifrado.Aquí hay algunos ejemplos de cómo usar temcrypt. Ten en cuenta que al encriptar, debes ingresar una clave y guardar la hora y minuto en que encriptaste la información. Para descifrar la información, debes usar la misma clave principal a la misma hora y minuto en días posteriores:
const dataToEncrypt = "Sensitive data";
const mainKey = "your_secret_key"; // Insert your custom key
const encryptedData = temcrypt.encrypt({
dataString: dataToEncrypt,
mainKey: mainKey
});
console.log(encryptedData);
const encryptedData = "..."; // Encrypted data obtained from the encryption process
const mainKey = "your_secret_key";
const decryptedData = temcrypt.decrypt({
dataString: encryptedData,
mainKey: mainKey
});
console.log(decryptedData);
Encriptar un archivo:
Para encriptar un archivo usando temcrypt, puedes usar la función encrypt con el parámetro dataFiles. Aquí hay un ejemplo de cómo encriptar un archivo y obtener el resultado del cifrado:
const temcrypt = require("temcrypt");
const filePath = "path/test.txt";
const mainKey = "your_secret_key";
const result = temcrypt.encrypt({
dataFiles: filePath,
mainKey: mainKey,
extraBytes: 128 // Optional: Add 128 extra bytes
});
console.log(result);
En este ejemplo, reemplaza 'test.txt' con la ruta real del archivo que deseas encriptar y establece 'your_secret_key' como la clave principal para el cifrado. El objeto result contendrá los detalles del cifrado, incluyendo el hash único, la clave principal, la clave temporal y la ruta del archivo cifrado.
Descifrar un archivo:
Para descifrar un archivo que fue previamente encriptado con temcrypt, puedes usar la función decrypt con el parámetro dataFiles. Aquí hay un ejemplo de cómo descifrar un archivo y obtener el resultado del descifrado:
const temcrypt = require("temcrypt");
const filePath = "path/test.txt.trypt";
const mainKey = "your_secret_key";
const result = temcrypt.decrypt({
dataFiles: filePath,
mainKey: mainKey
});
console.log(result);
En este ejemplo, reemplaza 'path/test.txt.trypt' con la ruta real del archivo cifrado, y establece 'your_secret_key' como la clave principal para el descifrado. El objeto result contendrá el estado del descifrado y los datos descifrados, si tiene éxito.
Recuerda proporcionar la clave principal correcta utilizada durante el cifrado para descifrar el archivo con éxito, en la misma hora y minuto exactos en que fue encriptado. Si la clave principal es incorrecta o el archivo fue alterado o la hora es incorrecta, el estado del descifrado será false y los datos descifrados no estarán disponibles.
temcrypt proporciona funciones utils para realizar operaciones adicionales más allá del cifrado y descifrado. Estas funciones de utilidad están diseñadas para mejorar la funcionalidad y usabilidad.