File privati
Ogni file in Fóir è pubblico o privato, e l'impostazione appartiene al file. Un file pubblico viene servito da un URL semplice, e uno privato tramite un link firmato che scade.
Come viene servito ogni tipo
Un file pubblico ha un URL diretto che la CDN può mettere in cache e che chiunque abbia il link può scaricare. L'URL di un file privato porta un token firmato, e la CDN rifiuta una richiesta senza un token valido. Un token apre un solo file e scade, per impostazione predefinita dopo un'ora. Conserva l'id del file e rileggi il suo URL quando ti serve, perché un URL più vecchio smette di funzionare.
Un file ha un proprio proprietario e una propria visibilità
Entrambi sono impostati sul file, e referenziarlo da un record non cambia nessuno dei due. Un file pubblico resta scaricabile dal suo URL qualunque sia la visibilità del record che lo referenzia.
Quando viene letto un record che referenzia un file privato, Fóir firma l'URL del file solo se il chiamante può accedere al file stesso. Altrimenti l'URL esce senza firma e la CDN lo rifiuta.
Impostazioni predefinite
Il valore predefinito segue la proprietà. Un file di proprietà di uno dei tuoi utenti viene memorizzato come privato, sia che l'abbia caricato lui sia che sia stato creato da una operazione da lui attivata. Un file che nessun utente possiede viene memorizzato come pubblico, il che comprende i caricamenti del tuo team, con una chiave segreta o da parte di una organizzazione. Indicare una visibilità al caricamento sostituisce il valore predefinito.
Cambiare la visibilità ed elencare
setFileVisibility sposta un file memorizzato tra pubblico e privato. Richiede lo scope files:write e funziona solo per un chiamante autorizzato a modificare quel file.
L'elencazione è decisa separatamente dal servizio. Un utente autenticato elenca i propri file e la libreria condivisa, e il file privato di un altro utente risulta null. Per elencare i file di tutti gli utenti serve, in una chiave segreta, files:list.all come scope.
Video privato
Un video privato è protetto da un capo all'altro. La miniatura, l'anteprima e il manifest HLS sono firmati, e il token viene portato su ogni rendition e segmento.
Leggi i dettagli
La documentazione di riferimento sui file tratta visibilità, impostazione predefinita per ogni tipo di caricamento, URL firmati e chi può elencare quali file.