Public 画像などの添付ファイルのアクセス権やアップロード先を設定する

esaでは画像や動画など、様々な形式のファイルが記事に添付できますが、ファイルのアクセス権やアップロード先を設定する3種類のオプションがあります。

## 設定方法

設定は、左側の __"SETTINGS"__ > "__詳細設定__" > "__添付ファイルに関するセキュアオプション__" の欄から行えます。


<img width="1738" alt="image.png (271.1 kB)" src="https://img.esa.io/uploads/production/attachments/105/2024/03/19/2/505e3294-e4c6-44da-8293-faeb31aa8467.png">


## 添付ファイルのセキュアオプション（比較表）

それぞれのオプションの特徴を下記に表にまとめました。
どの選択肢にもそれぞれメリット・デメリットがあります。利便性やセキュリティ面などを考慮し、ご利用目的やチームに合わせて検討いただければ幸いです。


| オプション | 最大サイズ <span class="small">※</span>  | 閲覧権限 | 記事の外部公開 | Webhook連携時の画像展開 |
| --- | --- | --- | --- | --- |
| __[デフォルト設定](#%E3%83%87%E3%83%95%E3%82%A9%E3%83%AB%E3%83%88%E8%A8%AD%E5%AE%9A)__ | 10MB | URLを知っている人 | :o: 使える | :o: 展開される |
| __[添付ファイルを独自のS3 bucketに保存](#%E6%B7%BB%E4%BB%98%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E7%8B%AC%E8%87%AA%E3%81%AES3%20bucket%E3%81%AB%E4%BF%9D%E5%AD%98)__ | 50MB | URLを知っている人 | :o: 使える | :o: 展開される |
| __[esaにログイン中のみ添付ファイルへのアクセスを許可](#esa%E3%81%AB%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E4%B8%AD%E3%81%AE%E3%81%BF%E6%B7%BB%E4%BB%98%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E3%82%92%E8%A8%B1%E5%8F%AF)__ | 50MB | チームにログインしている人のみ | :x: 使えない | :x: 展開されない |

<span class="small">※ 最大サイズ: 1ファイルあたりのアップロード可能な最大サイズです</small>

### 注意点

-  __オプションを変更しても、過去にアップロード済みのファイルには影響しません__。
    - 過去にアップロード済みのファイルの設定を変えたい場合には、再度アップロードが必要です。
    - 過去にアップロード済みのファイルにも新たな設定を反映したい場合は、左下の「？」より問い合わせ下さい。
- 「esaにログイン中のみ添付ファイルへのアクセスを可能にする」に設定した場合、以後[記事・スライドの外部公開機能](/posts/110)が利用できなくなりますので、ご注意ください。
   - __設定前に外部公開したものは、そのまま利用可能__ です。

以下にそれぞれのオプション設定について詳しく記載します。

## 各オプションについて

### デフォルト設定

記事の外部共有機能や、外部アプリ連携時の画像展開等が可能で、利便性を最も確保できる方法です。

- 推測不能なURLを知っている人だけが、添付ファイルにアクセスできます。
    - `https://img.esa.io/uploads/production/attachments/105/2015/10/03/1/41016bd4-5bce-4cf3-9f66-e57c62671e1e.jpg` のようなURLが発行されますが、このURLを知っていれば esa にログインしていないアプリやブラウザでも画像やファイルにアクセスをすることが可能です。
    - UUID（URL中の `41016bd4-5bce-4cf3-9f66-e57c62671e1e` の部分）を用いて多くの場合で必要十分なセキュリティ強度を確保している方法です。
    - URLは `https://img.esa.io/...` もしくは `https://esa-storage-tokyo.s3-ap-northeast-1.amazonaws.com/...` で始まるものになります。
- 最大10MBまでのファイルがアップロード可能です。
- 記事の外部共有機能や、Slack Webhook などの外部アプリ連携での画像の展開が有効になります。

### 添付ファイルを独自のS3 bucketに保存

添付ファイルのアップロード先を独自のS3 Bucketに設定することができます。
詳しい設定方法などについてはこちらをご覧ください。
 [#81:  help/ファイルアップロード先に独自のS3 Bucketを設定する](/posts/81) 

- 推測不能なURLを知っている人だけが、添付ファイルにアクセスできます。
    - 添付ファイルのURLは `https://[S3 Bucket Endpoint]/...` で始まるものになります。
- 添付ファイルはチーム独自に設定したS3 bucket上に保存されます。
    - 複数チームで同じ設定にすることで、同じS3 Bucketを共有可能です。
- 最大50MBまでのファイルがアップロード可能です。
- 記事の外部共有機能や、Slack Webhook等外部連携アプリでの画像の展開が有効になります。


### esaにログイン中のみ添付ファイルへのアクセスを許可

esaにログインしているアプリやブラウザのみが添付ファイルにアクセス可能な設定です。esaと同様のアクセス制限が可能になります。
最も安全な設定ですが、利便性の面でデメリットもありますのでご注意ください。

- 添付ファイルをアップロードしたチームにログイン中のメンバーだけがファイルにアクセスできます。
    - 添付ファイルのURLは `https://files.esa.io/...` もしくは `https://dl.esa.io/...` で始まるものになります。
    - 添付ファイルのURLに直接アクセスした場合、1分後にアクセスできなくなります。
- 最大50MBまでのファイルがアップロード可能です。
- __新たに記事を外部公開できなくなります__（設定変更前に公開済の記事は公開されたままですが、記事詳細画面から個別に公開を止めることができます）。
- Slack Webhook など、__esaにログインできないアプリやブラウザでの画像の展開ができません__ 。