Respaldo NoSQL en Firestore: cifrar, verificar y recuperar documentos
Autor: Antony Piero Solorzano Zegarra
Equipo: Antony Piero Solorzano Zegarra y Adriana Rafaela Laos Gonzales.
Guardar un archivo no demuestra que podamos recuperar una aplicación. Para estudiar esa diferencia preparamos una estrategia de respaldo de Campus Tareas, una aplicación de tareas con Cloud Firestore Standard.
Código público: https://github.com/AntonyS3010/nosql-backup-firestore
Qué respaldamos
La aplicación almacena documentos en users/{uid}/tasks/{id}. Cada tarea contiene título, curso, estado y fecha del servidor. El respaldo conserva esas rutas y los valores tipados de Firestore; así una fecha no termina convertida en texto común durante la recuperación.
La herramienta consulta el grupo de colecciones tasks y valida las rutas. Su límite educativo es de mil documentos. Si encuentra más, falla: una exportación parcial no se presenta como copia completa.
Proteger la copia
Antes de guardar el archivo se serializan los documentos y se calcula su SHA-256. Después se cifra el contenido con AES-256-GCM, una clave de 32 bytes y un vector aleatorio por respaldo. La autenticación del cifrado permite detectar alteraciones; el checksum permite comparar el contenido recuperado.
La clave no aparece en Git. Se conserva como secreto de Actions y debe tener una copia independiente bajo control del equipo. Perder la clave significa perder la posibilidad de descifrar los respaldos.
Recuperar sin arriesgar el origen
La restauración primero valida formato, cifrado y checksum. Sin --apply solamente informa cuántos documentos recuperaría. Para escribir exige un emulador local, otro proyecto demo-... y un destino vacío. No hay una operación que sobrescriba producción.
El ensayo real creó una tarea, generó una copia cifrada y la recuperó en otro proyecto del emulador. La comparación de campos e identificadores coincidió. También comprobó el rechazo de una copia alterada, un destino ocupado y el mismo proyecto de origen. La prueba pasó; no equivale a una recuperación verificada en nube.
Alcance real
Es un respaldo lógico de tareas, no una copia integral de Firestore. No incluye Authentication, reglas, índices ni configuración. Las reglas permanecen versionadas; recuperar documentos tampoco recupera una identidad anónima perdida.
Para una base grande o una recuperación de producción deben evaluarse las funciones administradas, sus requisitos y costos. Nuestro ejemplo permite comprender el recorrido completo con un emulador antes de conceder permisos reales.
Aplicación existente: https://antonys3010.github.io/campus-tareas-nosql/ . Código de la app: https://github.com/AntonyS3010/campus-tareas-nosql . Despliegue automatizado: https://github.com/AntonyS3010/campus-tareas-nosql/actions/workflows/deploy.yml .
Ejecución real
El respaldo en GitHub Actions terminó correctamente el 19 de noviembre de 2026. La base devolvió cero tareas. Descargamos el artefacto cifrado de 434 bytes y verificamos su descifrado y checksum en un proyecto diferente del emulador. Esa copia vacía no acredita recuperación de datos no vacíos; esa comprobación corresponde al ensayo con una tarea ficticia, también aprobado.
Video de la demostración
Ver la construcción y las pruebas en YouTube — 4:01.
Fuentes: Firestore REST y exportación administrada.