Skip to content

Commit e0d894a

Browse files
authored
docs: update security warnings around server.cors and server.allowedHosts (#1847)
1 parent b8bc4a0 commit e0d894a

File tree

1 file changed

+18
-5
lines changed

1 file changed

+18
-5
lines changed

config/server-options.md

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -51,10 +51,23 @@ Vite が応答することを許可するホスト名。
5151
`localhost``.localhost` 以下のドメインとすべての IP アドレスはデフォルトで許可されます。
5252
HTTPS を使用する場合は、このチェックはスキップされます。
5353

54-
文字列が `.` で始まる場合、`.` なしのホスト名とそのホスト名配下のすべてのサブドメインを許可します。たとえば、`.example.com``example.com``foo.example.com``foo.bar.example.com` を許可します。
54+
文字列が `.` で始まる場合、`.` なしのホスト名とそのホスト名配下のすべてのサブドメインを許可します。たとえば、`.example.com``example.com``foo.example.com``foo.bar.example.com` を許可します。`true` に設定した場合、サーバーが任意のホストのリクエストに応答することを許可します。
5555

56-
`true` に設定した場合、サーバーが任意のホストのリクエストに応答することを許可します。
57-
DNS リバインディング攻撃に脆弱になってしまうため、この設定は推奨されません。
56+
::: details 安全に追加できるホストは何ですか?
57+
58+
解決先の IP アドレスを制御できるホストは、許可されたホストのリストに追加しても安全です。
59+
60+
例えば、`vite.dev` というドメインを所有している場合は、`vite.dev``.vite.dev` をリストに追加できます。そのドメインを所有しておらず、そのドメインの所有者を信頼できない場合は、追加しないでください。
61+
62+
特に、`.com` のようなトップレベルドメインは絶対にリストへ追加しないでください。これは、誰でも `example.com` のようなドメインを購入し、それが解決する IP アドレスを制御できるためです。
63+
64+
:::
65+
66+
::: danger
67+
68+
`server.allowedHosts``true` に設定すると、任意のウェブサイトが DNS リバインド攻撃により開発サーバーにリクエストを送信できるようになり、ソースコードやコンテンツをダウンロードできるようになります。許可するホストの明示的なリストを常に使用することをお勧めします。詳細は [GHSA-vg6x-rcgg-rjx6](https://github.com/vitejs/vite/security/advisories/GHSA-vg6x-rcgg-rjx6) を参照してください。
69+
70+
:::
5871

5972
::: details 環境変数による設定
6073
環境変数 `__VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS` を設定することで、許可するホストを追加できます。
@@ -169,9 +182,9 @@ export default defineConfig({
169182

170183
開発サーバーの CORS を設定します。[オプションオブジェクト](https://github.com/expressjs/cors#configuration-options)を渡して微調整するか、`true` で任意のオリジンを許可します。
171184

172-
:::warning
185+
:::danger
173186

174-
信頼できないオリジンにソースコードを公開するのを避けるため、`true` ではなく特定の値をすることを推奨します
187+
`server.cors``true` に設定すると、任意のウェブサイトから開発サーバーにリクエストを送信し、ソースコードやコンテンツをダウンロードできるようになります。許可するオリジンを明示的に常に指定することを推奨します
175188
:::
176189

177190

0 commit comments

Comments
 (0)