非公開ファイル

種類ごとの配信方法

公開ファイルには、CDNがキャッシュできる直接のURLがあり、リンクを持つ人なら誰でも取得できます。非公開ファイルのURLには署名付きトークンが含まれ、CDNは有効なトークンのないリクエストを拒否します。トークンは1つのファイルだけを開き、既定では1時間で期限が切れます。古いURLは使えなくなるため、ファイルのIDを保持し、必要なときにURLを読み直してください。

ファイル自身が所有者と可視性を持つ

どちらもファイルに設定され、レコードから参照しても変わりません。公開ファイルは、それを指すレコードの可視性に関係なく、URLで取得できます。

非公開ファイルを参照するレコードが読み取られると、Fóirは呼び出し元がファイル自体にアクセスできる場合にだけ、ファイルのURLに署名します。そうでない場合、URLは署名なしで返り、CDNに拒否されます。

既定値

既定は所有権に従います。エンドユーザーが所有するファイルは、本人がアップロードした場合も、本人が起動したオペレーションが作成した場合も、非公開で保存されます。ユーザーが所有しないファイルは公開で保存されます。これには、チームによるアップロード、シークレットキーによるアップロード、組織によるアップロードが含まれます。アップロード時に可視性を指定すると、既定より優先されます。

可視性の変更と一覧

setFileVisibilityは、保存済みのファイルを公開と非公開の間で移します。必要なのはfiles:writeスコープで、そのファイルを編集できる呼び出し元に限って動作します。

一覧の取得は配信とは別に判定されます。サインイン済みのユーザーは、自分のファイルと共有ライブラリを一覧でき、他のユーザーの非公開ファイルはnullとして返ります。すべてのユーザーを横断した一覧の取得には、files:list.allスコープを持つシークレットキーが必要です。

非公開の動画

非公開の動画は、最初から最後まで保護されます。サムネイル、プレビュー、HLSマニフェストには署名が付き、トークンはすべてのレンディションとセグメントに引き継がれます。