El cifrado de próxima generación

temcrypt SDK

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.

Conocimiento

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.

Compatibilidad

temcrypt es compatible tanto con Node.js v18 o superior, como con navegadores web modernos, lo que te permite usarlo en varios entornos.

Primeros pasos

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>

Uso

ENCRIPTAR Y DESENCRIPTAR

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

• Si tiene éxito:
  • 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.
• Si se proporciona dataString:
  • hash (string): El hash único generado para la verificación de legitimidad de los datos cifrados.
  • (): La clave principal (privada) utilizada para el cifrado.

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:

Encriptar una cadena

const dataToEncrypt = "Sensitive data";
const mainKey = "your_secret_key"; // Insert your custom key

const encryptedData = temcrypt.encrypt({
  dataString: dataToEncrypt,
  mainKey: mainKey
});

console.log(encryptedData);

Descifrar una cadena

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.

UTILIDADES

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.

Lista de funciones:

1. changeKey: Cambiar tu clave principal de cifrado
2. check: Verificar si el cifrado pertenece a temcrypt
3. verify: Comprueba si un hash coincide con la legitimidad de la salida cifrada.

A continuación, puedes ver los detalles y cómo implementar sus usos.

Actualizar clave principal:

La función de utilidad changeKey te permite cambiar la clave principal utilizada para cifrar los datos manteniendo intactos los datos cifrados. Esto es útil cuando deseas mejorar la seguridad de tus datos cifrados o actualizar la clave principal periódicamente.

Parámetros

• dataFiles (opcional): La ruta al archivo que fue encriptado usando temcrypt.
• dataString (opcional): La cadena cifrada que fue generada usando temcrypt.
• mainKey (string): La clave principal actual utilizada para cifrar los datos.
• newKey(string): La nueva clave principal que reemplazará a la clave principal actual.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const currentMainKey = "my_recent_secret_key";
const newMainKey = "new_recent_secret_key";

// Update mainKey for the encrypted file
const result = temcrypt.utils({
  changeKey: {
    dataFiles: filePath,
    mainKey: currentMainKey,
    newKey: newMainKey
  }
});

console.log(result.message);

Verificar integridad de datos:

La función de utilidad check te permite verificar la integridad de los datos cifrados usando temcrypt. Comprueba si un archivo o una cadena es un dato cifrado válido de temcrypt.

Parámetros

• dataFiles (opcional): La ruta al archivo que deseas verificar.
• dataString (opcional): La cadena cifrada que deseas verificar.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const encryptedString = "..."; // Encrypted string generated by temcrypt

// Check the integrity of the encrypted File
const result = temcrypt.utils({
  check: {
    dataFiles: filePath
  }
});

console.log(result.message);

// Check the integrity of the encrypted String
const result2 = temcrypt.utils({
  check: {
    dataString: encryptedString
  }
});

console.log(result2.message);

Verificar hash:

La función de utilidad verify te permite verificar la integridad de los datos cifrados utilizando su valor hash. Comprueba si la salida de datos cifrados coincide con el valor hash proporcionado.

Parámetros

• hash (string): El valor hash contra el que verificar.
• dataFiles (opcional): La ruta al archivo cuyo hash deseas verificar.
• dataString (opcional): La cadena cifrada cuyo hash deseas verificar.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const hashToVerify = "..."; // The hash value to verify

// Verify the hash of the encrypted File
const result = temcrypt.utils({
  verify: {
    hash: hashToVerify,
    dataFiles: filePath
  }
});

console.log(result.message);

// Verify the hash of the encrypted String
const result2 = temcrypt.utils({
  verify: {
    hash: hashToVerify,
    dataString: encryptedString
  }
});

console.log(result2.message);

Códigos de error

La siguiente tabla presenta los códigos de error importantes y sus mensajes de error correspondientes utilizados por temcrypt para indicar varios escenarios de error.

Ejemplos

Consulta el directorio examples para obtener ejemplos de uso más detallados.

⚠️ RECOMENDACIÓN

El tamaño de cifrado de una cadena o archivo debe ser menor a 16 KB (kilobytes). Si es más grande, debes tener suficiente potencia computacional para descifrarlo. De lo contrario, tu computadora personal excederá el tiempo requerido para encontrar la combinación correcta de clave principal y la formación de cifrado adecuada, y no podrá descifrar la información.

ℹ️ CONSEJOS

1. Con temcrypt solo puedes descifrar tu información en días posteriores con la clave que ingresaste a la misma hora y minuto que encriptaste.
2. Concéntrate en el tiempo; se recomienda iniciar el descifrado entre los primeros 2 a 10 segundos, así tendrás una ventaja para generar la formación de clave correcta.

Licencia

El contenido de este proyecto está licenciado bajo la licencia Creative Commons Attribution 3.0, y el código fuente subyacente utilizado para formatear y mostrar ese contenido está licenciado bajo la licencia MIT.

Copyright (c) 2023 por Jose Pino