Private Dateien
Jede Datei in Fóir ist öffentlich oder privat, und die Einstellung gehört zur Datei. Eine öffentliche Datei wird über eine einfache URL ausgeliefert, eine private über einen signierten Link, der abläuft.
Wie jede Art ausgeliefert wird
Eine öffentliche Datei hat eine direkte URL, die das CDN cachen kann und die jeder mit dem Link abrufen kann. Die URL einer privaten Datei trägt ein signiertes Token, und das CDN weist eine Anfrage ohne gültiges Token ab. Ein Token öffnet eine Datei und läuft ab, standardmäßig nach einer Stunde. Behalten Sie die ID der Datei und lesen Sie ihre URL erneut aus, wenn Sie sie brauchen, denn eine ältere URL funktioniert nicht mehr.
Eine Datei hat eigenen Eigentümer und eigene Sichtbarkeit
Beides wird an der Datei festgelegt, und der Verweis aus einem Datensatz ändert keines von beidem. Eine öffentliche Datei bleibt über ihre URL abrufbar, unabhängig von der Sichtbarkeit des Datensatzes, der auf sie verweist.
Wenn ein Datensatz gelesen wird, der auf eine private Datei verweist, signiert Fóir die URL der Datei nur, wenn der Aufrufer die Datei selbst erreichen darf. Andernfalls geht die URL unsigniert hinaus, und das CDN weist sie ab.
Voreinstellungen
Die Voreinstellung folgt dem Eigentum. Eine Datei, die einem Ihrer Nutzer gehört, wird privat gespeichert, ob er sie hochgeladen hat oder eine von ihm ausgelöste Operation sie erzeugt hat. Eine Datei, die keinem Nutzer gehört, wird öffentlich gespeichert, das gilt für Uploads Ihres Teams, mit einem geheimen Schlüssel oder durch eine Organisation. Wird beim Upload eine Sichtbarkeit angegeben, überschreibt sie die Voreinstellung.
Sichtbarkeit ändern und auflisten
setFileVisibility verschiebt eine gespeicherte Datei zwischen öffentlich und privat. Es erfordert den Scope files:write und funktioniert nur für einen Aufrufer, der diese Datei bearbeiten darf.
Das Auflisten wird getrennt vom Ausliefern entschieden. Ein angemeldeter Nutzer listet seine eigenen Dateien und die gemeinsame Bibliothek auf, und die private Datei eines anderen Nutzers wird als null gelesen. Das Auflisten über alle Nutzer hinweg erfordert einen geheimen Schlüssel mit dem files:list.all Scope.
Privates Video
Ein privates Video ist durchgängig abgedeckt. Sein Thumbnail, die Vorschau und das HLS-Manifest sind signiert, und das Token wird an jede Rendition und jedes Segment weitergegeben.
Details nachlesen
Die Dateireferenz behandelt Sichtbarkeit, die Voreinstellung für jede Art von Upload, signierte URLs und wer welche Dateien auflisten darf.