Formato de las copias de seguridad

Última actualización: 14 de septiembre de 2026

1. Descifrar una copia en un ordenador

1. Instala Python 3.
2. Instala la biblioteca de cifrado: pip install cryptography
3. Descarga el programa sigbak_decrypt.py.
4. Ejecútalo con tu archivo y una carpeta de salida:

python sigbak_decrypt.py copia.sigbak mis-documentos

El programa te pide la clave de copia por teclado (no aparece en pantalla) y extrae cada documento en la carpeta. Comprueba la integridad de cada uno: un documento dañado se indica y se omite, los demás se extraen. El programa solo lee el archivo y no envía nada por Internet.

Código de salida: 0 si el archivo está intacto, 1 si faltan documentos o el archivo está incompleto, 2 en caso de error (clave incorrecta, archivo no válido).

2. Especificación del formato, versión 1

Esta sección está dirigida a quienes deseen verificar el formato o escribir su propio lector.

2.1 Clave de copia

• 16 bytes aleatorios (128 bits), generados por la aplicación.
• Se muestra en 28 símbolos del alfabeto base32 de Crockford 0123456789ABCDEFGHJKMNPQRSTVWXYZ, agrupados de 4 en 4: los 128 bits seguidos de 2 bits a cero dan 26 símbolos (bit más significativo primero), y luego 2 símbolos de control.
• Control: c = (Σ (i+1) × s[i]) mod 1021 para i de 0 a 25, escrito en 10 bits (c >> 5, y luego c & 31).
• Al introducirla: ignorar espacios y guiones, pasar a mayúsculas, leer O como 0 e I, L como 1; rechazar si la longitud, un carácter, el control o los 2 bits de relleno son incorrectos.

2.2 Derivación

okm           = HKDF-SHA256(clave, sal de la cabecera, "Sigillarium archive v1", 64)   (RFC 5869)
clave_cifrado = okm[0..32]
clave_control = okm[32..64]

2.3 Cabecera (56 bytes, en claro)

Bytes	Contenido
0–5	SIGBAK (ASCII)
6	versión del formato: 1
7	derivación: 1 = HKDF-SHA256
8–39	sal aleatoria (32 bytes)
40–55	control de clave: HMAC-SHA256(clave_control, bytes 0–39), truncado a 16 bytes

2.4 Registros

Tras la cabecera, hasta el final del archivo: tipo (1 byte) · longitud L del cifrado, etiqueta incluida (4 bytes, big-endian) · nonce (12 bytes) · AES-256-GCM (clave_cifrado), cifrado seguido de la etiqueta de 16 bytes.

Datos asociados del registro de índice n (0 para el primero): cabecera (56) ‖ n (4, big-endian) ‖ tipo (1) ‖ L (4, big-endian). Un registro desplazado, eliminado o tomado de otro archivo falla por tanto la autenticación.

Tipo	Nombre	Contenido descifrado
0x01	INFO	JSON: {"createdAt": "<ISO 8601 UTC>"}
0x02	META	JSON: metadatos del documento
0x03	DATA	bytes del documento
0x7F	END	JSON: {"entries": <número de documentos>}

Secuencia: INFO, luego (META, DATA) para cada documento, luego END.

2.5 Metadatos (META)

name, fileType (tipo MIME), createdAt, modifiedAt (o null), description (o null), tags, sha256 (de los bytes de DATA), size y metadata (opcional). Un lector ignora los campos desconocidos y nunca debe usar name tal cual como ruta de archivo.

2.6 Archivo dañado

• Un registro que falla la autenticación hace perder solo su documento; un documento solo se entrega si su META y su DATA se han autenticado, en su lugar.
• Si una longitud supera lo que queda del archivo, la lectura se detiene.
• El archivo está completo si END se autentica y no le sigue nada.

2.7 Vector de prueba

archive_v1_sample.sigbak — 1078 bytes, SHA-256 01b1eb4ac4aca12d32f0a482d76ec5dc5ec1b2f90e64ad64fcc16b1b8c478dbb. Clave: 000G-40R4-0M30-E209-185G-R38E-1W73 (bytes 00 a 0F). Contiene photo.jpg (300 bytes) y un documento llamado ../note.txt, un nombre deliberadamente malicioso que un lector correcto no debe usar como ruta.

2.8 Límites de la versión 1

• Un documento no puede superar 4 GiB.
• Cada documento se cifra de una sola vez: la memoria necesaria es la del documento más grande.