WhatsApp Crypt Tools

Decrittografa e crittografa facilmente i file .crypt12, .crypt14 e .crypt15 di WhatsApp e WA Business!
Per la decrittazione, ti serve il file della chiave o la chiave di 64 caratteri.
Il file della chiave si chiama "key" se il backup è crypt14 o
"encrypted_backup.key" se il backup è crypt15 (backup E2E crittografati).
Chi cerca una suite più completa per l'analisi forense di WhatsApp, dia un'occhiata a whapa.

Installazione rapida

Cloud - Google Colab

Se non vuoi installare programmi sul tuo computer, puoi eseguire questo programma in Google Colab .

Locale - Jupyter

Se hai familiarità con Jupyter (leggi qui se non lo hai), puoi usare la versione notebook del programma.

Locale - pip

Puoi installare questo script come pacchetto tramite pip. Basta eseguire:

python -m pip install wa-crypt-tools

per la versione stabile e

python -m pip install git+https://github.com/ElDavoo/wa-crypt-tools

per la versione di sviluppo.

Potrebbe essere necessario creare un ambiente virtuale per evitare conflitti con altri pacchetti.

Avvio rapido

Decrittare un file con wadecrypt

usage: wadecrypt [-h] [-nm] [-bs BUFFER_SIZE] [-nd] [-v] [-f] [keyfile] [encrypted] [decrypted]

Quindi, per decrittare un crypt12/14/15, diamo al programma il file della chiave, il file crittografato e il nome del file di output.

Esempio

$ wadecrypt encrypted_backup.key msgstore.db.crypt15 msgstore.db
key15.py:51     : [I] Crypt15 / Raw key loaded
wadecrypt.py:271        : [I] Done

Crittografare un file con waencrypt (BETA)

usage: waencrypt [-h] [-f] [-v] [--enable-features [ENABLE_FEATURES ...]] [--max-feature MAX_FEATURE]
                 [--multi-file] [--type {12,14,15}] [--iv IV] [--reference REFERENCE] [--noparse]
                 [--wa-version WA_VERSION] [--jid JID] [--backup-version BACKUP_VERSION] [--no-compress]
                 [keyfile] [decrypted] [encrypted]

La crittografia è più complessa e non testata: si consiglia di usare un altro file crittografato dello stesso account, che chiameremo "reference".

Con un file di riferimento (testato solo database crypt15)

waencrypt --reference msgstore.db.crypt15 encrypted_backup.key msgstore.db msgstore-new.db.crypt15
waencrypt.py:57         : [W] This script is in beta stage
waencrypt.py:89         : [I] Done!

Senza un file di riferimento

Devi fornire i seguenti parametri:

1. L'elenco delle feature: solo per database del 2019+. Un elenco di proprietà booleane numerate relative al tuo database. Al momento non c'è modo di dedurle da un file di database. Nell'esempio useremo semplicemente l'elenco delle feature del mio backup, ma non aspettarti che funzioni per te.
2. Il numero massimo di feature, che al momento della scrittura è 39
3. La versione dell'app che ha crittografato il file: usa un valore ragionevole, tipo 2.24.8.6 o simile.
4. Jid: le ultime 2 cifre del tuo numero di telefono
5. Versione del backup: usa 1.

Se i parametri vengono omessi, verranno usati i valori predefiniti.

Per riassumere:

$ waencrypt --enable-features 5 6 7 8 9 10 11 12 13 14 15 16
 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 39 --type 15 --wa-version 2.26.1.2 --jid 00 --backup
-version 1 encrypted_backup.key msgstore.db msgstore-new.db.crypt15 
waencrypt.py:57         : [W] This script is in beta stage
waencrypt.py:89         : [I] Done!

Puoi ottenere informazioni su un file di backup con lo strumento wainfo.

Elenco degli strumenti

Per l'utilizzo, esegui lo strumento con l'opzione -h.

1. wacreatekey - Crea file di chiavi
2. wadecrypt - Decritta i backup
3. waencrypt - Critta i backup
4. waguess - Metodo approssimativo per provare a decrittare i backup
5. wainfo - Ottieni informazioni su un backup

FAQ

Posso decrittare un backup senza un file della chiave?

NO! Quale sarebbe il senso di crittografare un file altrimenti?

Ho dimenticato la password / la chiave di 64 lettere, puoi aiutarmi?

Vedi sopra.

Il programma non decritta i miei backup e dice che i backup sono corrotti

I tuoi backup sono corrotti. Puoi provare a disabilitare tutti i controlli con il flag -f, ma aspettati crash e/o output illeggibile.

Il programma non decritta e dice che la chiave è sbagliata

La chiave è sbagliata. Puoi provare a disabilitare tutti i controlli con il flag -f, ma aspettati crash e/o output illeggibile.

Qual è la configurazione migliore per decrittare i propri database?

1. Abilita i backup end-to-end e NON usare una password, usa l'opzione della chiave di 64 lettere.
2. Usa wacreatekey per creare un file encrypted_backup.key
3. Conserva il tuo file della chiave in modo sicuro e usa wadecrypt per decrittare i tuoi backup.

In questo modo gestirai la tua chiave root - altrimenti WhatsApp potrebbe cambiare la tua chiave quando opportuno.

Posso usare la password per decrittare il database?

No! La password viene usata solo per comunicare con i server WhatsApp e recuperare la chiave di 64 lettere.
In altre parole, la password serve a proteggere la chiave, non viene usata per crittografare i backup.

Posso decrittare i file .mcrypt1 scaricati da Google Drive?

Sì, ma il codice non è documentato, quindi per ora leggi il codice.

Sono convinto che il programma sia rotto, che i miei backup siano intatti e che la chiave sia giusta

Inviami i file necessari su Telegram e darò un'occhiata.

Se (comprensibilmente) hai problemi di privacy, apri una issue e allega:

1. Output del programma (sia con che senza --force)
2. Hexdump del file della chiave
3. Hexdump dei primi 512 byte del DB crittografato

Ma sarà più difficile aiutarti.

Dove trovo il file della chiave?

Su un dispositivo Android con root, puoi semplicemente copiare /data/data/com.whatsapp/files/key (o /data/data/com.whatsapp/files/encrypted_backup.key se i backup sono crypt15).
Se hai abilitato i backup E2E e non hai usato una password (hai una copia della chiave di 64 cifre, ad esempio uno screenshot), puoi semplicemente trascriverla e usarla al posto del parametro del file della chiave.
Ci sono altri modi, ma non è compito di questo progetto dirtelo.
Le issue che lo chiedono verranno chiuse come non valide.

Come posso citare questo software?

Non è stato scritto alcun articolo o tesi su questo software, ma puoi citare questo repository online. Per favore non dire "et al." perché (per ora) c'è un solo autore.

CITATION.cff

Vedi il file CITATION.cff per le informazioni sulla citazione.

BibTeX

@misc{wa-crypt-tools,
  author = {ElDavoo},
  title = {WhatsApp Crypt Tools},
  year = {2022},
  month = {06},
  howpublished = {\url{https://github.com/ElDavoo/wa-crypt-tools}
}

BibLaTeX

@online{wa-crypt-tools,
  author = {ElDavoo},
  title = {WhatsApp Crypt Tools},
  year = {2022},
  month = {06},
  url = {https://github.com/ElDavoo/wa-crypt-tools}
}

Accetto volentieri pull request per le issue attualmente aperte. :)

Ultima versione testata (non aspettarti che venga aggiornata)

Stabile: 2.24.16.76
Beta: 2.24.26.11

Business

Stabile:
2.24.23.78

Correzione automatica dei protobuf