Auth-Share ロゴDOCS

シークレットファイルについて

概要

シークレットファイル(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. 編集権限のあるシークレットを開きます。
  2. シークレット情報タブのシークレットファイルで、ファイル追加を押します。
  3. ファイルを1件選び、一覧に表示する表示名を入力します。
  4. アップロードを押し、検証・確定が終わるまで待ちます。
  5. 完了後、ファイル一覧に追加されたことを確認します。

表示名は前後の空白を除いて1〜100文字です。同じシークレット内で、一覧にある別のファイルと同じ表示名は使えません。

表示名と元のファイル名

  • 表示名:Auth-Shareの一覧で使う名前です。
  • 元のファイル名:選択したファイルの名前です。ダウンロード時の名前に使われます。

表示名の変更だけでは、ダウンロード時の元のファイル名や内容は変わりません。

アップロードの確定処理に失敗したとき

ファイルの送信後、検証・確定処理でエラーが発生する場合があります。この場合、ファイルはまだ正常に登録されていません。

「確定処理を再試行」 が表示された場合は、ボタンを押すことで、ファイルを選び直さずに処理を再試行できます。

画面を閉じようとすると、確認画面が表示されます。

  • 戻る:アップロード画面に戻り、再試行を続けられます。
  • 破棄して閉じる:再試行を中止し、画面を閉じます。

「破棄して閉じる」を選択した場合や、ページを再読み込みした場合は、同じアップロードの確定処理を再試行できなくなります。

なお、画面を閉じても、サーバーに送信済みのファイルが直ちに削除されるわけではありません。

表示名を変更する

  1. 対象ファイルの**…メニューから表示名編集**を選びます。
  2. 新しい表示名を入力し、保存を押します。

新規追加と同じ1〜100文字・重複不可の制限があります。表示名の変更では、新しいファイルバージョンは作成されません。

ファイルを再アップロードする

  1. 対象ファイルの**…メニューから再アップロード**を選びます。
  2. 現在と同じ形式の新しいファイルを選択します。
  3. アップロードを押します。
  4. 元のファイル名が異なる場合は、追加の確認画面で内容を確認し、再アップロードするを押します。
  5. 検証・確定が完了したことを確認します。

再アップロードでは、既存の保存データを直接上書きせず、新しいバージョンを作成します。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を知っているだけでは閲覧できず、ログインと共有権限が必要です。

ファイルを削除する

対象ファイルの**…メニューから削除**を選び、確認画面で承認すると通常の一覧から消えます。

これは保存データの即時・完全消去ではありません。確定済みファイルのデータと履歴は保持され、シークレット履歴からの復元に使用されます。ダウンロード済みの端末上のコピーも削除されません。

履歴からファイル状態を復元する

ファイルの追加・表示名変更・再アップロード・削除は、シークレットの履歴に記録されます。

以前の状態へ戻す場合は、履歴を見るから復元できる履歴を開き、この状態に復元を選びます。操作の詳細はシークレット履歴を確認するを参照してください。

復元対象はファイル単体ではなく、シークレット全体です。 シークレット名、シークレット情報、ファイルの表示名・内容・存在状態が、その時点の状態へ戻ります。対象時点に存在しなかったファイルは一覧から消えるため、実行前に確認してください。共有設定を過去へ戻す操作ではありません。

独立したファイル履歴画面や、任意の過去バージョンを直接ダウンロードする機能はありません。過去のファイル内容を取得するには、その状態へシークレットを復元してからダウンロードします。

シークレット自体を削除している間は、ファイルにも通常アクセスできません。シークレットの復元後は、現在の共有権限に従って利用します。

ファイルのセキュリティ

  • アップロードするファイルはブラウザー内で暗号化され、暗号化された状態で保存されます。
  • ファイルの再アップロードでは、新しいバージョンを作成し、それぞれ独立した暗号鍵で保護します。
  • ダウンロード・プレビュー時には、ログイン状態とシークレットの共有権限を確認し、権限のあるユーザーにのみファイルを提供します。
  • ファイルの閲覧権限はシークレットの共有設定に連動します。ファイルを追加する際は、共有先を確認してください。

詳しくはセキュリティ対策についてを参照してください。

関連ページ