信頼済みリバースプロキシ認証
## 概要
信頼済みリバースプロキシが付与するHTTPヘッダーからユーザ名を取得し、自動ログインする機能について説明します。
## 注意事項
1. 本機能は、クライアントが当該ヘッダーを直接偽装できない構成（リバースプロキシが必ずヘッダーを上書きする構成）でのみ使用してください。
1. <span style="color:red;font-weight:bold;">[Authentication.json](/ja/manual/authentication-json)のTrustedProxyParametersをtrueに設定する場合、[Security.json](/ja/manual/security-json)の ForwardedHeaders.KnownNetworksまたはForwardedHeaders.KnownProxiesのどちらかに値を設定する必要があります。どちらも未設定の場合、無条件で認証に失敗し、"[TrustedProxy] KnownNetworks/KnownProxies are empty."というメッセージが[システムログ](/ja/manual/syslog)へ記録されます。</span>
## パラメータTrustedProxyParametersの設定
以下を参考に、設定ファイル[Authentication.json](/ja/manual/authentication-json)のパラメータTrustedProxyParametersを設定してください。
|パラメータ名|設定例|説明|
|:--|:--|:--|
|Enabled|true|trueを指定すると機能を有効化します。<br>環境変数TRUSTED_PROXY_AUTH_ENABLEDが設定されている場合、その値が優先されます。|
|Header|"X-Forwarded-User"|ユーザ名が格納されているHTTPヘッダー名を指定します。<br>環境変数TRUSTED_PROXY_AUTH_HEADERが設定されている場合、その値が優先されます。|
##### Authentication.jsonの 設定例
```json
{
: 省略
"TrustedProxyParameters": {
"Enabled": true,
"Header": "X-Forwarded-User"
}
}
```
## 環境変数による設定と優先順位
以下の環境変数が設定されている場合は、[Authentication.json](/ja/manual/authentication-json)の値より優先されます。
|環境変数名|対応<br>パラメータ|動作|
|:--|:--|:--|
|TRUSTED_PROXY_AUTH_ENABLED|Enabled|**空文字以外の値**<br>機能が有効になります。true以外の値（例えば1など）でも有効化されます。|
|TRUSTED_PROXY_AUTH_HEADER|Header|**空でない場合**<br>この環境変数の値を使用します。<br><br>**空の場合**<br>[Authentication.json](/ja/manual/authentication-json)のパラメータHeaderの値を使用します。|
## 送信元IPによる制限について
<span style="font-weight:bold; color:red;">特定の送信元からのリクエストのみを自動ログインの対象とするには、必ず[Security.json](/ja/manual/security-json)のパラメータForwardedHeaders.KnownNetworksまたはForwardedHeaders.KnownProxiesを設定してください。詳細は[Security.json](/ja/manual/security-json)を参照してください。</span>
## 対応バージョン
|対応バージョン|内容|
|---|---|
|バージョン 1.5.3.0 以降|機能追加|
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/authentication-json">パラメータ設定：Authentication.json</a><span>2026/04/15 up</span></li>
<li><a href="/ja/manual/security-json">パラメータ設定：Security.json</a><span>2026/08/12 up</span></li></ul></article>
<ul><li><a href="/ja/manual/syslog">システムログ管理機能</a><span>2024/06/21 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />
