Revisar las subidas

Antes de que suba

Con lo que la página dice de él: nombre, tipo, tamaño y adónde va. Aún no se ha enviado nada.

import { Refused, createDriveHandler } from '@rebofiles/server';

createDriveHandler({
  // …
  beforeUpload: (upload) => {
    if (upload.type.startsWith('video/')) throw new Refused(415, 'no-videos', 'Videos go to the media library.');
    if (upload.parent === null && upload.purpose === 'file') return false; // nothing loose at the top
  },
});

Un Refused se responde con su estado, código y mensaje; false es un 403. Se pregunta por cada archivo nuevo y cada versión nueva, no por las imágenes pequeñas que hace la página. El tipo y el tamaño son los que dice la página: para lo que de verdad son, inspect.

Cuando llegaron sus bytes

Se pregunta antes de guardar el archivo o la versión, con una lectura de los bytes del almacenamiento. Los dos almacenamientos del servidor pueden leer.

import { checkType, clamav, createDriveHandler, inspectAll } from '@rebofiles/server';

createDriveHandler({
  // …
  // A program called photo.png, a PDF called .docx: refused. Then ClamAV, on its TCP socket.
  inspect: inspectAll(checkType(), clamav({ host: '127.0.0.1', port: 3310 })),
});

• checkType() lee los primeros 4 KB. Rechaza un programa (un .exe, un binario de Linux o de Mac) salvo con programs: true, y un archivo cuyos bytes no son los de su extensión: un PNG que no lo es, un .docx que no es un zip. only limita a algunos tipos.
• clamav() envía los bytes a clamd, un megabyte cada vez, con su comando INSTREAM. Un archivo mayor de lo que acepta clamd (25 MB si no se dice) se rechaza, no se deja pasar sin revisar.
• inspectAll(…) pregunta a varios en orden: el primero que rechaza, rechaza.

Un archivo sin revisar no entra. Cuando inspect lanza algo que no es un Refused (clamd caído, un tiempo agotado), la subida se rechaza con un 503 y se quitan sus bytes. La página lo dice, y la persona lo vuelve a subir.

ClamAV en el servidor

# Ubuntu: the daemon, its signatures kept fresh, and a socket the server reaches
sudo apt install clamav-daemon
echo 'TCPSocket 3310' | sudo tee -a /etc/clamav/clamd.conf
echo 'TCPAddr 127.0.0.1' | sudo tee -a /etc/clamav/clamd.conf
sudo systemctl restart clamav-daemon

# Or in Docker
docker run -d -p 3310:3310 clamav/clamav

Un inspect propio

Cualquier función: un escáner de tu proveedor, una regla propia sobre lo que se puede guardar.

inspect: async (upload, drive) => {
  if (upload.purpose === 'rendition') return;     // a smaller picture the page made
  const head = await upload.read({ from: 0, to: 4100 });
  const verdict = await myScanner(upload.key, head);
  if (verdict === 'reject') throw new Refused(422, 'rejected', `${upload.name} was not kept.`);
},

Lo que lee la gente

El drive dice cada uno en el idioma de la persona, por su código.