私有文件

每种文件如何提供

公开文件有一个直接的 URL，CDN 可以缓存，持有链接的任何人都可以获取。私有文件的 URL 带有签名令牌，没有有效令牌的请求会被 CDN 拒绝。一个令牌只能打开一个文件，并会过期，默认一小时后过期。请保留文件的 id，需要时再读取它的 URL，因为旧的 URL 会失效。

文件有自己的所有者和可见性

两者都设置在文件上，从记录中引用文件不会改变其中任何一个。无论指向它的记录可见性如何，公开文件始终可以通过它的 URL 获取。

读取引用了私有文件的记录时，只有调用方本身有权访问该文件，Fóir 才会为文件的 URL 签名。否则 URL 以未签名形式返回，CDN 会拒绝它。

默认值

默认值遵循所有权。由你的某个用户拥有的文件以私有方式存储，无论是他们上传的，还是他们触发的操作创建的。没有用户拥有的文件以公开方式存储，包括你的团队上传的文件、使用机密密钥上传的文件，以及由组织上传的文件。上传时指定可见性会覆盖默认值。

更改可见性与列出

setFileVisibility 在公开与私有之间切换已存储的文件。它需要 files:write 作用域，并且只对有权编辑该文件的调用方有效。

列出由单独的规则决定，与提供文件无关。已登录用户可以列出自己的文件和共享库，另一个用户的私有文件读取结果为 null。要跨所有用户列出，需要带有 files:list.all 作用域的机密密钥。

私有视频

私有视频全程受到保护。它的缩略图、预览和 HLS 清单都经过签名，令牌会带到每个转码版本和每个分片上。