La crittografia di nuova generazione

SDK temcrypt

Concentrato sulla protezione di dati estremamente sensibili, temcrypt è un meccanismo avanzato di crittografia evolutiva a più strati che offre complessità scalabile nel tempo ed è resistente ai comuni attacchi a forza bruta.

Puoi creare le tue applicazioni, script e automazioni quando lo distribuisci.

Conoscenza

Scopri cosa significa temcrypt, le funzionalità e l'ispirazione che mi hanno portato a crearlo e molto altro. LEGGI IL DOCUMENTO DI CONOSCENZA. Questo è molto importante per te.

Compatibilità

temcrypt è compatibile sia con Node.js v18 o superiore, sia con browser web moderni, permettendoti di utilizzarlo in vari ambienti.

Per Iniziare

Le uniche dipendenze utilizzate da temcrypt sono crypto-js per la gestione di algoritmi di crittografia come AES-256, SHA-256 e alcuni codificatori, e fs viene utilizzato per la gestione dei file con Node.js

Per utilizzare temcrypt, devi avere Node.js installato. Successivamente, puoi installare temcrypt usando npm:

npm install temcrypt

dopodiché, importalo nel tuo codice come segue:

const temcrypt = require("temcrypt");

Include una funzionalità di installazione automatica per le sue dipendenze, in modo che tu non debba preoccuparti di installarle manualmente. Basta eseguire la libreria temcrypt.js e le dipendenze verranno installate automaticamente, quindi chiamarla nel tuo codice; questo è stato fatto per essere portatile:

node temcrypt.js

In alternativa, puoi utilizzare temcrypt direttamente nel browser includendo il seguente tag script:

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

o minificato:

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

Puoi anche chiamare la libreria sul tuo sito web o applicazione web da un CDN:

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

Utilizzo

CRITTOGRAFARE E DECRITTOGRAFARE

temcrypt fornisce funzioni come encrypt e decrypt per proteggere e rivelare in modo sicuro le tue informazioni.

Parametri

• dataString (stringa): I dati stringa da crittografare.
• dataFiles (stringa): Il percorso del file da crittografare. Fornisci dataString o dataFiles.
• mainKey (stringa): La chiave principale (privata) per la crittografia.
• extraBytes (numero, opzionale): Byte aggiuntivi da aggiungere alla crittografia. È un parametro opzionale utilizzato nel processo di crittografia temcrypt. Permette di aggiungere byte extra ai dati crittografati, aumentando la complessità della crittografia, che richiede più potenza di calcolo per decrittografare. Serve anche a far perdere gli schemi modificando il peso della crittografia.

Restituisce

• Se ha successo:
  • status (booleano): true per indicare la decifrazione riuscita.
  • hash (stringa): L'hash univoco generato per la verifica della legittimità dei dati crittografati.
  • dataString (stringa) o dataFiles: La stringa decifrata o il percorso del file decifrato, a seconda dell'input.
  • updatedEncryptedData (stringa): I dati crittografati aggiornati dopo la decifrazione. I dati crittografati aggiornati dopo la decifrazione. Ogni volta che la crittografia viene decifrata, l'output viene aggiornato, perché mainKey cambia il suo ordine e viene salvata la nuova data dell'ultima decifrazione.
  • creationDate (stringa): La data di creazione dei dati crittografati.
  • lastDecryptionDate (stringa): La data dell'ultima decifrazione riuscita dei dati.
• Se viene fornito dataString:
  • hash (stringa): L'hash univoco generato per la verifica della legittimità dei dati crittografati.

Ecco alcuni esempi di come utilizzare temcrypt. Tieni presente che durante la crittografia, devi inserire una chiave e salvare l'ora e il minuto in cui hai crittografato le informazioni. Per decifrare le informazioni, devi utilizzare la stessa chiave principale alla stessa ora e minuto nei giorni successivi:

Crittografare una Stringa

const dataToEncrypt = "Dati sensibili";
const mainKey = "tua_chiave_segreta"; // Inserisci la tua chiave personalizzata

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

console.log(encryptedData);

Decifrare una Stringa

const encryptedData = "..."; // Dati crittografati ottenuti dal processo di crittografia
const mainKey = "tua_chiave_segreta";

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

console.log(decryptedData);

Crittografare un File:

Per crittografare un file usando temcrypt, puoi utilizzare la funzione encrypt con il parametro dataFiles. Ecco un esempio di come crittografare un file e ottenere il risultato della crittografia:

const temcrypt = require("temcrypt");

const filePath = "path/test.txt";
const mainKey = "tua_chiave_segreta";

const result = temcrypt.encrypt({
  dataFiles: filePath,
  mainKey: mainKey,
  extraBytes: 128 // Opzionale: Aggiungi 128 byte extra
});

console.log(result);

In questo esempio, sostituisci 'test.txt' con il percorso effettivo del file che desideri crittografare e imposta 'tua_chiave_segreta' come chiave principale per la crittografia. L'oggetto result conterrà i dettagli della crittografia, inclusi l'hash univoco, la chiave principale, la chiave temporale e il percorso del file crittografato.

Decifrare un File:

Per decifrare un file che è stato precedentemente crittografato con temcrypt, puoi utilizzare la funzione decrypt con il parametro dataFiles. Ecco un esempio di come decifrare un file e ottenere il risultato della decifrazione:

const temcrypt = require("temcrypt");

const filePath = "path/test.txt.trypt";
const mainKey = "tua_chiave_segreta";

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

console.log(result);

In questo esempio, sostituisci 'path/test.txt.trypt' con il percorso effettivo del file crittografato e imposta 'tua_chiave_segreta' come chiave principale per la decifrazione. L'oggetto result conterrà lo stato della decifrazione e i dati decifrati, se riuscita.

Ricorda di fornire la chiave principale corretta utilizzata durante la crittografia per decifrare con successo il file, alla stessa ora e minuto esatti in cui è stato crittografato. Se la chiave principale è errata, il file è stato manomesso o l'ora è sbagliata, lo stato della decifrazione sarà false e i dati decifrati non saranno disponibili.

UTILITY

temcrypt fornisce funzioni utils per eseguire operazioni aggiuntive oltre alla crittografia e decifrazione. Queste funzioni di utilità sono progettate per migliorare la funzionalità e l'usabilità.

Elenco Funzioni:

1. changeKey: Cambia la tua chiave principale di crittografia
2. check: Verifica se la crittografia appartiene a temcrypt
3. verify: Controlla se un hash corrisponde alla legittimità dell'output crittografato.

Di seguito puoi vedere i dettagli e come implementarne gli usi.

Aggiornare la Chiave Principale:

La funzione di utilità changeKey ti permette di cambiare la mainKey utilizzata per crittografare i dati mantenendo intatti i dati crittografati. Questo è utile quando vuoi aumentare la sicurezza dei tuoi dati crittografati o aggiornare la mainKey periodicamente.

Parametri

• dataFiles (opzionale): Il percorso del file che è stato crittografato usando temcrypt.
• dataString (opzionale): La stringa crittografata che è stata generata usando temcrypt.
• mainKey (stringa): La mainKey corrente utilizzata per crittografare i dati.
• newKey(stringa): La nuova mainKey che sostituirà quella corrente.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const currentMainKey = "mia_chiave_segreta_recente";
const newMainKey = "nuova_chiave_segreta_recente";

// Aggiorna mainKey per il file crittografato
const result = temcrypt.utils({
  changeKey: {
    dataFiles: filePath,
    mainKey: currentMainKey,
    newKey: newMainKey
  }
});

console.log(result.message);

Controllare l'Integrità dei Dati:

La funzione di utilità check ti permette di verificare l'integrità dei dati crittografati usando temcrypt. Controlla se un file o una stringa è un dato crittografato temcrypt valido.

Parametri

• dataFiles (opzionale): Il percorso del file che vuoi controllare.
• dataString (opzionale): La stringa crittografata che vuoi controllare.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const encryptedString = "..."; // Stringa crittografata generata da temcrypt

// Controlla l'integrità del File crittografato
const result = temcrypt.utils({
  check: {
    dataFiles: filePath
  }
});

console.log(result.message);

// Controlla l'integrità della Stringa crittografata
const result2 = temcrypt.utils({
  check: {
    dataString: encryptedString
  }
});

console.log(result2.message);

Verificare l'Hash:

La funzione di utilità verify ti permette di verificare l'integrità dei dati crittografati usando il suo valore hash. Controlla se l'output dei dati crittografati corrisponde al valore hash fornito.

Parametri

• hash (stringa): Il valore hash da verificare.
• dataFiles (opzionale): Il percorso del file di cui vuoi verificare l'hash.
• dataString (opzionale): La stringa crittografata di cui vuoi verificare l'hash.

const temcrypt = require("temcrypt");

const filePath = "test.txt.trypt";
const hashToVerify = "..."; // Il valore hash da verificare

// Verifica l'hash del File crittografato
const result = temcrypt.utils({
  verify: {
    hash: hashToVerify,
    dataFiles: filePath
  }
});

console.log(result.message);

// Verifica l'hash della Stringa crittografata
const result2 = temcrypt.utils({
  verify: {
    hash: hashToVerify,
    dataString: encryptedString
  }
});

console.log(result2.message);

Codici di Errore

La tabella seguente presenta i codici di errore importanti e i corrispondenti messaggi di errore utilizzati da temcrypt per indicare vari scenari di errore.

Esempi

Dai un'occhiata alla directory examples per esempi di utilizzo più dettagliati.

⚠️ RACCOMANDAZIONE

La dimensione di crittografia di una stringa o di un file dovrebbe essere inferiore a 16 KB (kilobyte). Se è più grande, devi avere abbastanza potenza di calcolo per decifrarlo. Altrimenti, il tuo computer personale supererà il tempo necessario per trovare la corretta combinazione di chiave principale e la corretta formazione di crittografia, e non sarà in grado di decifrare le informazioni.

ℹ️ SUGGERIMENTI

1. Con temcrypt puoi decifrare le tue informazioni solo nei giorni successivi con la chiave che hai inserito alla stessa ora e minuto in cui hai crittografato.
2. Concentrati sul tempo, si consiglia di iniziare la decifrazione tra i primi 2 e 10 secondi, in modo da avere un vantaggio per generare la corretta formazione della chiave.

Licenza

Il contenuto di questo progetto stesso è concesso in licenza con Creative Commons Attribution 3.0 license, e il codice sorgente sottostante utilizzato per formattare e visualizzare tale contenuto è concesso in licenza con MIT license.

Copyright (c) 2023 by Jose Pino