シークレットファイルについて
概要
シークレットファイル(SecretFile)は、シークレットにファイルを添付し、認証情報や設定情報と同じ共有権限で管理する機能です。
ファイルは暗号化して保存されます。追加、表示名の変更、再アップロード、削除はシークレット履歴に反映され、過去のファイル状態を含めてシークレットを復元できます。
利用できるユーザー
- 閲覧権限があるユーザーは、ファイルのダウンロードと対応形式のプレビューを利用できます。
- 編集権限がある管理ユーザー・社内ユーザーは、一般モードでファイルの追加、表示名編集、再アップロード、削除を行えます。
- 外部ユーザーは、共有されたシークレットのファイルを閲覧できますが、追加・変更・削除・履歴からの復元はできません。
- 共有されていないユーザーは、ファイルを閲覧できません。管理ユーザーであることだけでは閲覧権限は付きません。
権限は、直接共有と所属グループからの共有を合わせて決まります。ファイル単位で別の共有先を設定するのではなく、シークレット全体の共有設定を使用します。管理モードはファイル内容を閲覧するための画面ではありません。
詳しくはシークレットの共有設定と権限とユーザー種別を参照してください。
対応形式とサイズ
| 種類 | 対応する拡張子 |
|---|---|
| テキスト・表形式 | TXT、CSV |
| 文書 | PDF、DOCX、XLSX、PPTX |
| 画像 | PNG、JPG、JPEG、GIF、WebP |
| 鍵・証明書 | PEM、KEY、CRT、CER |
| 環境設定 | ENV(.env、.env.stagingなど、対応する環境名付きのファイル名を含む) |
1ファイルの最大サイズは 50MiB(52,428,800バイト) です。空のファイルは追加できません。
拡張子だけでなくファイルの内容も検証されるため、対応形式であっても、ファイルの内容によっては登録できない場合があります。
ファイルを追加する
- 編集権限のあるシークレットを開きます。
- シークレット情報タブのシークレットファイルで、ファイル追加を押します。
- ファイルを1件選び、一覧に表示する表示名を入力します。
- アップロードを押し、検証・確定が終わるまで待ちます。
- 完了後、ファイル一覧に追加されたことを確認します。
表示名は前後の空白を除いて1〜100文字です。同じシークレット内で、一覧にある別のファイルと同じ表示名は使えません。
表示名と元のファイル名
- 表示名:Auth-Shareの一覧で使う名前です。
- 元のファイル名:選択したファイルの名前です。ダウンロード時の名前に使われます。
表示名の変更だけでは、ダウンロード時の元のファイル名や内容は変わりません。
アップロードの確定処理に失敗したとき
ファイルの送信後、検証・確定処理でエラーが発生する場合があります。この場合、ファイルはまだ正常に登録されていません。
「確定処理を再試行」 が表示された場合は、ボタンを押すことで、ファイルを選び直さずに処理を再試行できます。
画面を閉じようとすると、確認画面が表示されます。
- 戻る:アップロード画面に戻り、再試行を続けられます。
- 破棄して閉じる:再試行を中止し、画面を閉じます。
「破棄して閉じる」を選択した場合や、ページを再読み込みした場合は、同じアップロードの確定処理を再試行できなくなります。
なお、画面を閉じても、サーバーに送信済みのファイルが直ちに削除されるわけではありません。
表示名を変更する
- 対象ファイルの**…メニューから表示名編集**を選びます。
- 新しい表示名を入力し、保存を押します。
新規追加と同じ1〜100文字・重複不可の制限があります。表示名の変更では、新しいファイルバージョンは作成されません。
ファイルを再アップロードする
- 対象ファイルの**…メニューから再アップロード**を選びます。
- 現在と同じ形式の新しいファイルを選択します。
- アップロードを押します。
- 元のファイル名が異なる場合は、追加の確認画面で内容を確認し、再アップロードするを押します。
- 検証・確定が完了したことを確認します。
再アップロードでは、既存の保存データを直接上書きせず、新しいバージョンを作成します。JPGとJPEGは同じ形式として扱い、拡張子の大文字・小文字は区別しません。TXTからPDFなど、異なる形式への変更はできません。
成功すると新しい内容が現在のファイルになり、表示名は維持されます。元のファイル名は新しく選択したファイルの名前になります。確定待ちや検証エラーの場合は、以前の確定済みファイルが引き続き利用できます。
ダウンロードとプレビュー
ダウンロード
対象ファイルの**…メニューからダウンロード**を選び、確認画面で承認します。現在のファイルを、元のファイル名で端末へ保存します。
プレビュー
一覧のプレビュー操作から確認画面を開き、承認するとブラウザー内に内容を表示します。プレビュー画面内からダウンロードすることもできます。
| 形式 | プレビュー |
|---|---|
| PDF、PNG、JPG・JPEG、GIF、WebP | 対応 |
| TXT、ENV、PEM、KEY | テキスト表示 |
| CRT、CER | テキスト形式として判定された場合のみ対応。DERなどのバイナリ形式は非対応 |
| CSV | 表形式で表示。サイズ上限は既定で1MiB(1,048,576バイト) |
| DOCX、XLSX、PPTX | 非対応。ダウンロードして対応アプリで開いてください |
プレビュー非対応でも、閲覧権限があればダウンロードできます。CSVのプレビュー上限は環境設定によって異なる場合があります。
ダウンロード・プレビューの要求はアクセス履歴に記録されます。取得用の一時的なURLには期限があり、期限切れの場合は一覧から操作し直してください。URLを知っているだけでは閲覧できず、ログインと共有権限が必要です。
ファイルを削除する
対象ファイルの**…メニューから削除**を選び、確認画面で承認すると通常の一覧から消えます。
これは保存データの即時・完全消去ではありません。確定済みファイルのデータと履歴は保持され、シークレット履歴からの復元に使用されます。ダウンロード済みの端末上のコピーも削除されません。
履歴からファイル状態を復元する
ファイルの追加・表示名変更・再アップロード・削除は、シークレットの履歴に記録されます。
以前の状態へ戻す場合は、履歴を見るから復元できる履歴を開き、この状態に復元を選びます。操作の詳細はシークレット履歴を確認するを参照してください。
復元対象はファイル単体ではなく、シークレット全体です。 シークレット名、シークレット情報、ファイルの表示名・内容・存在状態が、その時点の状態へ戻ります。対象時点に存在しなかったファイルは一覧から消えるため、実行前に確認してください。共有設定を過去へ戻す操作ではありません。
独立したファイル履歴画面や、任意の過去バージョンを直接ダウンロードする機能はありません。過去のファイル内容を取得するには、その状態へシークレットを復元してからダウンロードします。
シークレット自体を削除している間は、ファイルにも通常アクセスできません。シークレットの復元後は、現在の共有権限に従って利用します。
ファイルのセキュリティ
- アップロードするファイルはブラウザー内で暗号化され、暗号化された状態で保存されます。
- ファイルの再アップロードでは、新しいバージョンを作成し、それぞれ独立した暗号鍵で保護します。
- ダウンロード・プレビュー時には、ログイン状態とシークレットの共有権限を確認し、権限のあるユーザーにのみファイルを提供します。
- ファイルの閲覧権限はシークレットの共有設定に連動します。ファイルを追加する際は、共有先を確認してください。
詳しくはセキュリティ対策についてを参照してください。
