diff options
| author | haturatu <taro@eyes4you.org> | 2025-10-13 07:01:46 +0900 |
|---|---|---|
| committer | haturatu <taro@eyes4you.org> | 2025-10-13 07:01:46 +0900 |
| commit | af646a893e3b66b2b868d2d0f4216362477a4fba (patch) | |
| tree | 4be49ae0140cb5b9849831333cbdccb0fdd279cc /README.ja.md | |
| parent | 18991704b375db4e8d22785bb47f3e2e12cd016f (diff) | |
support: xsrf
Diffstat (limited to 'README.ja.md')
| -rw-r--r-- | README.ja.md | 24 |
1 files changed, 12 insertions, 12 deletions
diff --git a/README.ja.md b/README.ja.md index faf8d3c..1dbe892 100644 --- a/README.ja.md +++ b/README.ja.md @@ -7,7 +7,7 @@ - [おためし](#%E3%81%8A%E3%81%9F%E3%82%81%E3%81%97) - [主な機能](#%E4%B8%BB%E3%81%AA%E6%A9%9F%E8%83%BD) - [セキュリティと認証の詳細](#%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3%E3%81%A8%E8%AA%8D%E8%A8%BC%E3%81%AE%E8%A9%B3%E7%B4%B0) - - [CSRF保護](#csrf%E4%BF%9D%E8%AD%B7) + - [XSRF保護](#xsrf%E4%BF%9D%E8%AD%B7) - [パスワードの暗号化](#%E3%83%91%E3%82%B9%E3%83%AF%E3%83%BC%E3%83%89%E3%81%AE%E6%9A%97%E5%8F%B7%E5%8C%96) - [認証フロー](#%E8%AA%8D%E8%A8%BC%E3%83%95%E3%83%AD%E3%83%BC) - [1. Web UI(セッションベース)](#1-web-ui%E3%82%BB%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E3%83%99%E3%83%BC%E3%82%B9) @@ -77,17 +77,17 @@ bash run-demo.sh ## セキュリティと認証の詳細 -### CSRF保護 +### XSRF保護 -このプロキシには、悪意のある攻撃を防ぐためのCSRF(クロスサイトリクエストフォージェリ)保護が含まれています。これは`gorilla/csrf`ライブラリを使用して実装されています。 +このプロキシには、悪意のある攻撃を防ぐためのXSRF(クロスサイトリクエストフォージェリ)保護が含まれています。これは`golang.org/x/net/xsrftoken`ライブラリを使用して実装されています。 -ユーザーがフォームのあるページにアクセスすると、一意のCSRFトークンが生成され、フォームに埋め込まれます。フォームが送信されると、サーバーはトークンがユーザーのセッションに保存されているものと一致するかどうかを確認します。一致しない場合、リクエストは拒否されます。 +ユーザーがフォームのあるページにアクセスすると、一意のXSRFトークンが生成され、フォームに埋め込まれます。フォームが送信されると、サーバーはトークンがユーザーのセッションに保存されているものと一致するかどうかを確認します。一致しない場合、リクエストは拒否されます。 この保護はデフォルトで有効になっています。以下の環境変数を使用して設定できます。 -- `CSRF_SECRET_KEY`: CSRFトークンの署名に使用される、長くてランダムな秘密鍵。 -- `CSRF_TRUSTED_ORIGINS`: 信頼できるオリジンのカンマ区切りリスト。フロントエンドがプロキシと異なるドメインでホストされている場合は、フロントエンドのオリジンをこのリストに追加する必要があります。 -- `CSRF_SAME_SITE`: CSRFクッキーの`SameSite`属性。`lax`(デフォルト)、`strict`、または`none`に設定できます。`none`に設定した場合は、`ENV=production`も設定してセキュアなクッキーを有効にする必要があります。 +- `XSRF_SECRET_KEY`: XSRFトークンの署名に使用される、長くてランダムな秘密鍵。 +- `XSRF_TRUSTED_ORIGINS`: 信頼できるオリジンのカンマ区切りリスト。フロントエンドがプロキシと異なるドメインでホストされている場合は、フロントエンドのオリジンをこのリストに追加する必要があります。 +- `XSRF_SAME_SITE`: XSRFクッキーの`SameSite`属性。`lax`(デフォルト)、`strict`、または`none`に設定できます。`none`に設定した場合は、`ENV=production`も設定してセキュアなクッキーを有効にする必要があります。 ### パスワードの暗号化 @@ -181,9 +181,9 @@ TARGET_URL=http://localhost:8081 # 本番環境では、openssl rand -base64 45 を使って新しいキーを生成してください SESSION_SECRET=my-super-secret-key -# (必須) CSRF保護のための32バイトのランダムなキー。 +# (必須) XSRF保護のための32バイトのランダムなキー。 # 生成コマンド: openssl rand -base64 32 -CSRF_SECRET_KEY= +XSRF_SECRET_KEY= # --- データベース --- # 以下のいずれかのオプションを使用してください: @@ -538,6 +538,6 @@ curl -H "Authorization: Bearer $ACCESS_TOKEN" http://localhost:8080/api/config | `AUTH_PATH_*` | ログイン、管理者ページなどの内部URLをカスタマイズするための変数セット。 | 様々、例: `/login`| | `AUTH_ASSETS_PATH` | 内部静的アセット(CSS, JS)を提供するためのURLパス。 | `/assets` | | `ENV` | ランタイム環境。セキュアなクッキーを有効にするには`production`に設定します。 | - | -| `CSRF_SECRET_KEY` | **(必須)** CSRF保護のための32バイトのランダムなキー。`openssl rand -base64 32` で生成します。 | - | -| `CSRF_TRUSTED_ORIGINS` | CSRF保護のための信頼できるオリジンのカンマ区切りリスト。 | - | -| `CSRF_SAME_SITE` | CSRFクッキーのSameSite属性。`lax`、`strict`、または`none`にすることができます。 | `lax` | +| `XSRF_SECRET_KEY` | **(必須)** XSRF保護のための32バイトのランダムなキー。`openssl rand -base64 32` で生成します。 | - | +| `XSRF_TRUSTED_ORIGINS` | XSRF保護のための信頼できるオリジンのカンマ区切りリスト。 | - | +| `XSRF_SAME_SITE` | XSRFクッキーのSameSite属性。`lax`、`strict`、または`none`にすることができます。 | `lax` | |
