Formato dei backup

Ultimo aggiornamento: 14 settembre 2026

1. Decifrare un backup su un computer

1. Installa Python 3.
2. Installa la libreria di crittografia: pip install cryptography
3. Scarica il programma sigbak_decrypt.py.
4. Avvialo con il tuo archivio e una cartella di destinazione:

python sigbak_decrypt.py backup.sigbak miei-documenti

Il programma ti chiede la chiave di backup da tastiera (non compare a schermo), poi estrae ogni documento nella cartella. Ne verifica l'integrità: un documento danneggiato viene segnalato e saltato, gli altri vengono estratti. Il programma legge l'archivio e non invia nulla su Internet.

Codice di uscita: 0 se l'archivio è integro, 1 se mancano documenti o se l'archivio è incompleto, 2 in caso di errore (chiave errata, file non valido).

2. Specifica del formato, versione 1

Questa sezione è rivolta a chi vuole verificare il formato o scrivere un proprio lettore.

2.1 Chiave di backup

• 16 byte casuali (128 bit), generati dall'app.
• Mostrata come 28 simboli dell'alfabeto base32 di Crockford 0123456789ABCDEFGHJKMNPQRSTVWXYZ, raggruppati a 4: i 128 bit seguiti da 2 bit nulli danno 26 simboli (bit più significativo per primo), poi 2 simboli di controllo.
• Controllo: c = (Σ (i+1) × s[i]) mod 1021 per i da 0 a 25, scritto su 10 bit (c >> 5, poi c & 31).
• All'inserimento: ignorare spazi e trattini, convertire in maiuscole, leggere O come 0 e I, L come 1; rifiutare se la lunghezza, un carattere, il controllo o i 2 bit di riempimento sono errati.

2.2 Derivazione

okm              = HKDF-SHA256(chiave, sale dell'intestazione, "Sigillarium archive v1", 64)   (RFC 5869)
chiave_cifratura = okm[0..32]
chiave_controllo = okm[32..64]

2.3 Intestazione (56 byte, in chiaro)

Byte	Contenuto
0–5	SIGBAK (ASCII)
6	versione del formato: 1
7	derivazione: 1 = HKDF-SHA256
8–39	salt casuale (32 byte)
40–55	controllo della chiave: HMAC-SHA256(chiave_controllo, byte 0–39), troncato a 16 byte

2.4 Record

Dopo l'intestazione, fino alla fine del file: tipo (1 byte) · lunghezza L del testo cifrato, tag incluso (4 byte, big-endian) · nonce (12 byte) · AES-256-GCM (chiave_cifratura), testo cifrato seguito dal tag di 16 byte.

Dati associati del record di posizione n (0 per il primo): intestazione (56) ‖ n (4, big-endian) ‖ tipo (1) ‖ L (4, big-endian). Un record spostato, rimosso o preso da un altro archivio non supera quindi l'autenticazione.

Tipo	Nome	Contenuto decifrato
0x01	INFO	JSON: {"createdAt": "<ISO 8601 UTC>"}
0x02	META	JSON: metadati del documento
0x03	DATA	byte del documento
0x7F	END	JSON: {"entries": <numero di documenti>}

Sequenza: INFO, poi (META, DATA) per ogni documento, poi END.

2.5 Metadati (META)

name, fileType (tipo MIME), createdAt, modifiedAt (o null), description (o null), tags, sha256 (dei byte di DATA), size e metadata (facoltativo). Un lettore ignora i campi sconosciuti e non deve mai usare name così com'è come percorso di file.

2.6 Archivio danneggiato

• Un record che non supera l'autenticazione fa perdere solo il proprio documento; un documento viene restituito solo se la sua META e la sua DATA sono state autenticate, al loro posto.
• Se una lunghezza supera ciò che resta del file, la lettura si interrompe.
• L'archivio è completo se END viene autenticato e nulla lo segue.

2.7 Vettore di test

archive_v1_sample.sigbak — 1.078 byte, SHA-256 01b1eb4ac4aca12d32f0a482d76ec5dc5ec1b2f90e64ad64fcc16b1b8c478dbb. Chiave: 000G-40R4-0M30-E209-185G-R38E-1W73 (byte da 00 a 0F). Contiene photo.jpg (300 byte) e un documento chiamato ../note.txt, un nome volutamente insidioso che un lettore corretto non deve usare come percorso.

2.8 Limiti della versione 1

• Un documento non può superare 4 GiB.
• Ogni documento viene cifrato in un unico blocco: la memoria necessaria è quella del documento più grande.