driveFS

Plugin FacturaScripts

driveFS guarda copias de seguridad en el Google Drive autorizado por el usuario.

driveFS es un plugin para FacturaScripts. Permite generar copias SQL, copias de archivos o copias completas y subirlas a una carpeta de Google Drive mediante un broker OAuth central en https://auth.drivefs.site.

Qué hace

El plugin se instala dentro de FacturaScripts y permite crear respaldos manuales o programados. Según la configuración, puede generar una copia de la base de datos, una copia ZIP de archivos o ambas.

Los archivos temporales se generan localmente en la instalación de FacturaScripts, se suben a Google Drive y luego se eliminan del almacenamiento temporal local cuando finaliza el proceso.

Copia SQL

Genera un archivo .sql de la base de datos MySQL/MariaDB de FacturaScripts.

Copia de archivos

Genera un archivo .zip de la instalación, excluyendo carpetas temporales y de caché definidas por el plugin.

Restauración

Permite restaurar desde archivos subidos manualmente o desde el historial reconstruido con archivos existentes en Drive.

Cómo funciona el flujo

La instalación de FacturaScripts inicia un emparejamiento con el broker OAuth. El broker redirige al usuario a Google, valida el parámetro state y guarda el refresh_token cifrado en el broker.

Cuando driveFS necesita subir, listar, descargar o eliminar copias, solicita al broker un access token temporal mediante una petición firmada con HMAC. El sitio principal drivefs.site no participa en ese flujo y no contiene secretos OAuth.

Conectar Google Drive
Desde la pantalla privada del plugin en FacturaScripts, el administrador pulsa conectar y completa la autorización en Google.
Desconectar Google Drive
Desde el plugin, la acción de desconexión llama al broker para eliminar la conexión OAuth asociada a esa instalación. El usuario también puede revocar el acceso desde su cuenta de Google.
Carpeta de destino
Si no se configura una carpeta existente por ID, driveFS busca o crea una carpeta llamada Copias driveFS.

Permiso de Google Drive

El código inspeccionado solicita este scope OAuth:

https://www.googleapis.com/auth/drive

El README del broker indica que se usa el permiso completo de Drive porque el flujo de recuperación debe poder leer copias existentes en una carpeta de Google Drive tras pérdida o migración del servidor. El scope drive.file no garantiza recuperar archivos ya existentes que no fueron creados o abiertos por la aplicación.

Alcance real del permiso

El permiso completo de Drive puede permitir acceso amplio a los archivos del Drive autorizado. La funcionalidad implementada por driveFS se centra en buscar o crear la carpeta de copias, listar archivos de esa carpeta, subir respaldos, descargar respaldos por ID y eliminar archivos registrados para retención.

Requisitos de uso

  • Una instalación funcional de FacturaScripts.
  • Acceso de administrador al plugin driveFS.
  • Una cuenta de Google desde la que se autoriza Google Drive.
  • HTTPS público correcto en la instalación de FacturaScripts para iniciar el emparejamiento.
  • MySQL/MariaDB para las copias y restauraciones SQL implementadas.
  • Extensión PHP ZipArchive para copias y restauraciones ZIP.

Documentación y soporte

La documentación técnica disponible en el repositorio se encuentra en el README del plugin y en el protocolo del broker OAuth.

Canal de soporte público: support@drivefs.site.

Estado del producto confirmado por el código: plugin funcional con emparejamiento OAuth, copias manuales, programación, historial, retención opcional, notificaciones y restauración.