La cryptographie de nouvelle génération

SDK temcrypt

Conçu pour protéger les données hautement sensibles, temcrypt est un mécanisme avancé de chiffrement évolutif multicouche qui offre une complexité évolutive dans le temps et résiste aux attaques par force brute courantes.

Vous pouvez créer vos propres applications, scripts et automatismes en le déployant.

Connaissances

Découvrez ce que signifie temcrypt, les fonctionnalités et l'inspiration qui m'ont poussé à le créer, et bien plus encore. LISEZ LE DOCUMENT DE CONNAISSANCES. Ceci est très important pour vous.

Compatibilité

temcrypt est compatible avec Node.js v18 ou supérieur, ainsi qu'avec les navigateurs web modernes, vous permettant de l'utiliser dans divers environnements.

Pour commencer

Les seules dépendances utilisées par temcrypt sont crypto-js pour gérer les algorithmes de chiffrement comme AES-256, SHA-256 et certains encodeurs, et fs est utilisé pour la gestion des fichiers avec Node.js.

Pour utiliser temcrypt, vous devez avoir Node.js installé. Ensuite, vous pouvez installer temcrypt via npm :

npm install temcrypt

après cela, importez-le dans votre code comme suit :

const temcrypt = require("temcrypt");

Il inclut une fonctionnalité d'installation automatique pour ses dépendances, vous n'avez donc pas à vous soucier de les installer manuellement. Exécutez simplement la bibliothèque temcrypt.js et les dépendances seront installées automatiquement, puis appelez-la dans votre code. Cela a été fait pour être portable :

node temcrypt.js

Alternativement, vous pouvez utiliser temcrypt directement dans le navigateur en incluant la balise script suivante :

<script src="temcrypt.js"></script>

ou sa version minifiée :

<script src="temcrypt.min.js"></script>

Vous pouvez également appeler la bibliothèque sur votre site web ou application web depuis un CDN :

<script src="https://cdn.jsdelivr.net/gh/jofpin/temcrypt/temcrypt.min.js"></script>

Utilisation

CHIFFRER & DÉCHIFFRER

temcrypt fournit des fonctions telles que encrypt et decrypt pour protéger et divulguer vos informations de manière sécurisée.

Paramètres

• dataString (string): Les données sous forme de chaîne à chiffrer.
• dataFiles (string): Le chemin du fichier à chiffrer. Fournissez soit dataString soit dataFiles.
• mainKey (string): La clé principale (privée) pour le chiffrement.
• extraBytes (number, optionnel): Octets supplémentaires à ajouter au chiffrement. Il s'agit d'un paramètre optionnel utilisé dans le processus de chiffrement temcrypt. Il permet d'ajouter des octets supplémentaires aux données chiffrées, augmentant ainsi la complexité du chiffrement, ce qui nécessite plus de puissance de calcul pour déchiffrer. Il sert également à perdre les motifs en modifiant le poids du chiffrement.

Retourne

• En cas de succès :
  • status (boolean) : true pour indiquer un déchiffrement réussi.
  • hash (string) : Le hachage unique généré pour vérifier la légitimité des données chiffrées.
  • dataString (string) ou dataFiles : La chaîne déchiffrée ou le chemin du fichier déchiffré, selon l'entrée.
  • updatedEncryptedData (string) : Les données chiffrées mises à jour après déchiffrement. Chaque fois que le chiffrement est déchiffré, la sortie est mise à jour, car la mainKey change d'ordre et la nouvelle date du dernier déchiffrement est enregistrée.
  • creationDate (string) : La date de création des données chiffrées.
  • lastDecryptionDate (string) : La date du dernier déchiffrement réussi des données.
• Si dataString est fourni :
  • hash (string) : Le hachage unique généré pour vérifier la légitimité des données chiffrées.

Voici quelques exemples d'utilisation de temcrypt. Veuillez noter que lors du chiffrement, vous devez entrer une clé et enregistrer l'heure et la minute auxquelles vous avez chiffré les informations. Pour déchiffrer les informations, vous devez utiliser la même clé principale à la même heure et minute les jours suivants :

Chiffrer une chaîne

const dataToEncrypt = "Données sensibles";
const mainKey = "votre_clé_secrète"; // Insérez votre clé personnalisée

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

console.log(encryptedData);

Déchiffrer une chaîne

const encryptedData = "..."; // Données chiffrées obtenues lors du processus de chiffrement
const mainKey = "votre_clé_secrète";

const decryptedData = temcrypt.decrypt({
  dataString: encryptedData,
  mainKey: mainKey
});

console.log(decryptedData);

Chiffrer un fichier :

Pour chiffrer un fichier avec temcrypt, vous pouvez utiliser la fonction encrypt avec le paramètre dataFiles. Voici un exemple de chiffrement d'un fichier et d'obtention du résultat :

const temcrypt = require("temcrypt");

const filePath = "chemin/test.txt";
const mainKey = "votre_clé_secrète";

const result = temcrypt.encrypt({
  dataFiles: filePath,
  mainKey: mainKey,
  extraBytes: 128 // Optionnel : Ajouter 128 octets supplémentaires
});

console.log(result);

Dans cet exemple, remplacez 'test.txt' par le chemin réel du fichier à chiffrer et définissez 'votre_clé_secrète' comme clé principale du chiffrement. L'objet result contiendra les détails du chiffrement, y compris le hachage unique, la clé principale, la clé temporelle et le chemin du fichier chiffré.

Déchiffrer un fichier :

Pour déchiffrer un fichier préalablement chiffré avec temcrypt, vous pouvez utiliser la fonction decrypt avec le paramètre dataFiles. Voici un exemple de déchiffrement d'un fichier et d'obtention du résultat :

const temcrypt = require("temcrypt");

const filePath = "chemin/test.txt.trypt";
const mainKey = "votre_clé_secrète";

const result = temcrypt.decrypt({
  dataFiles: filePath,
  mainKey: mainKey
});

console.log(result);

Dans cet exemple, remplacez 'chemin/test.txt.trypt' par le chemin réel du fichier chiffré et définissez 'votre_clé_secrète' comme clé principale pour le déchiffrement. L'objet result contiendra l'état du déchiffrement et les données déchiffrées, en cas de succès.

N'oubliez pas de fournir la clé principale correcte utilisée lors du chiffrement pour déchiffrer le fichier avec succès, à la même heure et minute exactes que lors du chiffrement. Si la clé principale est incorrecte, si le fichier a été modifié ou si l'heure est erronée, l'état du déchiffrement sera false et les données déchiffrées ne seront pas disponibles.

UTILITAIRES

temcrypt fournit des fonctions utils pour effectuer des opérations supplémentaires au-delà du chiffrement et du déchiffrement. Ces fonctions utilitaires sont conçues pour améliorer les fonctionnalités et la facilité d'utilisation.

Liste des fonctions :

1. changeKey: Changer votre clé principale de chiffrement
2. check: Vérifier si le chiffrement appartient à temcrypt
3. verify: Vérifie si un hachage correspond à la légitimité de la sortie chiffrée.

Ci-dessous, vous pouvez voir les détails et comment implémenter leurs utilisations.

Mettre à jour la clé principale :

La fonction utilitaire changeKey vous permet de changer la mainKey utilisée pour chiffrer les données tout en conservant les données chiffrées intactes. Cela est utile lorsque vous souhaitez renforcer la sécurité de vos données chiffrées ou mettre à jour périodiquement la mainKey.

Paramètres

• dataFiles (optionnel) : Le chemin du fichier chiffré avec temcrypt.
• dataString (optionnel) : La chaîne chiffrée générée par temcrypt.
• mainKey (string) : La mainKey actuelle utilisée pour chiffrer les données.
• newKey (string) : La nouvelle mainKey qui remplacera la mainKey actuelle.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const currentMainKey = "ma_clé_secrète_récente";
const newMainKey = "nouvelle_clé_secrète_récente";

// Mettre à jour la mainKey pour le fichier chiffré
const result = temcrypt.utils({
  changeKey: {
    dataFiles: filePath,
    mainKey: currentMainKey,
    newKey: newMainKey
  }
});

console.log(result.message);

Vérifier l'intégrité des données :

La fonction utilitaire check vous permet de vérifier l'intégrité des données chiffrées avec temcrypt. Elle vérifie si un fichier ou une chaîne est une donnée chiffrée temcrypt valide.

Paramètres

• dataFiles (optionnel) : Le chemin du fichier à vérifier.
• dataString (optionnel) : La chaîne chiffrée à vérifier.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const encryptedString = "..."; // Chaîne chiffrée générée par temcrypt

// Vérifier l'intégrité du fichier chiffré
const result = temcrypt.utils({
  check: {
    dataFiles: filePath
  }
});

console.log(result.message);

// Vérifier l'intégrité de la chaîne chiffrée
const result2 = temcrypt.utils({
  check: {
    dataString: encryptedString
  }
});

console.log(result2.message);

Vérifier le hachage :

La fonction utilitaire verify vous permet de vérifier l'intégrité des données chiffrées à l'aide de leur valeur de hachage. Elle vérifie si la sortie des données chiffrées correspond à la valeur de hachage fournie.

Paramètres

• hash (string) : La valeur de hachage à vérifier.
• dataFiles (optionnel) : Le chemin du fichier dont vous souhaitez vérifier le hachage.
• dataString (optionnel) : La chaîne chiffrée dont vous souhaitez vérifier le hachage.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const hashToVerify = "..."; // La valeur de hachage à vérifier

// Vérifier le hachage du fichier chiffré
const result = temcrypt.utils({
  verify: {
    hash: hashToVerify,
    dataFiles: filePath
  }
});

console.log(result.message);

// Vérifier le hachage de la chaîne chiffrée
const result2 = temcrypt.utils({
  verify: {
    hash: hashToVerify,
    dataString: encryptedString
  }
});

console.log(result2.message);

Codes d'erreur

Le tableau suivant présente les codes d'erreur importants et leurs messages d'erreur correspondants utilisés par temcrypt pour indiquer différents scénarios d'erreur.

Exemples

Consultez le répertoire examples pour des exemples d'utilisation plus détaillés.

⚠️ RECOMMANDATION

La taille de chiffrement d'une chaîne ou d'un fichier doit être inférieure à 16 Ko (kilooctets). Si elle est plus grande, vous devez disposer d'une puissance de calcul suffisante pour la déchiffrer. Sinon, votre ordinateur personnel dépassera le temps nécessaire pour trouver la bonne combinaison de clé principale et la formation de chiffrement appropriée, et ne pourra pas déchiffrer les informations.

ℹ️ CONSEILS

1. Avec temcrypt, vous ne pouvez déchiffrer vos informations que les jours suivants avec la clé que vous avez entrée à la même heure et minute que lors du chiffrement.
2. Concentrez-vous sur le temps : il est recommandé de commencer le déchiffrement entre les 2 à 10 premières secondes, afin d'avoir un avantage pour générer la formation correcte de la clé.

Licence

Le contenu de ce projet lui-même est sous licence Creative Commons Attribution 3.0, et le code source sous-jacent utilisé pour formater et afficher ce contenu est sous licence MIT.

Copyright (c) 2023 par Jose Pino