Archivos privados
Cada archivo en Fóir es público o privado, y el ajuste pertenece al archivo. Un archivo público se sirve desde una URL simple, y uno privado mediante un enlace firmado que caduca.
Cómo se sirve cada tipo
Un archivo público tiene una URL directa que la CDN puede almacenar en caché y que puede obtener cualquiera que tenga el enlace. La URL de un archivo privado lleva un token firmado, y la CDN rechaza una solicitud sin uno válido. Un token abre un solo archivo y caduca, por defecto al cabo de una hora. Guarda el id del archivo y vuelve a leer su URL cuando la necesites, porque una URL anterior deja de funcionar.
Un archivo tiene su propio propietario y visibilidad
Ambos se fijan en el archivo, y referenciarlo desde un registro no cambia ninguno de los dos. Un archivo público sigue pudiendo obtenerse por su URL sea cual sea la visibilidad del registro que apunta a él.
Cuando se lee un registro que referencia un archivo privado, Fóir firma la URL del archivo solo si quien llama puede acceder al propio archivo. En caso contrario la URL sale sin firmar y la CDN la rechaza.
Valores predeterminados
El valor predeterminado sigue a la propiedad. Un archivo propiedad de uno de tus usuarios se almacena como privado, tanto si lo subió él como si lo creó una operación que él activó. Un archivo que no pertenece a ningún usuario se almacena como público, lo que incluye las subidas de tu equipo, con una clave secreta o por una organización. Indicar una visibilidad al subir anula el valor predeterminado.
Cambiar la visibilidad y listar
setFileVisibility mueve un archivo almacenado entre público y privado. Necesita el alcance files:write y funciona solo para quien llama si tiene permiso para editar ese archivo.
El listado se decide por separado del servicio. Un usuario con sesión iniciada lista sus propios archivos y la biblioteca compartida, y el archivo privado de otro usuario se lee como null. Listar los archivos de todos los usuarios requiere una clave secreta con files:list.all como alcance.
Vídeo privado
Un video privado queda cubierto de extremo a extremo. Su miniatura, su vista previa y su manifiesto HLS están firmados, y el token se traslada a cada representación y segmento.
Lee el detalle
La referencia de archivos cubre la visibilidad, el valor predeterminado para cada tipo de subida, las URL firmadas y quién puede listar qué archivos.