Confluence 用に Web プロキシサポートを設定する

このページの内容はサポート対象外のプラットフォームに関連しています。したがって、アトラシアンサポートではこのページの記載内容のサポートの提供は保証されません。この資料は情報提供のみを目的として提供されています。内容はお客様自身の責任でご利用ください。

{rss} や {jiraissues} など、Confluence のマクロの一部はデータを取得するために、リモートサーバーあてに Web リクエストを送信する必要があります。Confluence がデータセンターまたは DMZ 内に配置されている場合、直接インターネットにアクセスして、こうしたリクエストを送信できない可能性があります。{rss} マクロが動作しないことがわかった場合、Confluence がインターネットにアクセスするには web プロキシを経由する必要があるかどうか、ネットワーク管理者に問い合わせてください。

Confluence でのアウトバウンド HTTP プロキシの設定

Proxy support is configured by passing certain system properties to the Java Virtual Machine on startup.

http.proxyHost
http.proxyPort (default: 80)
http.nonProxyHosts (default: <none>)
https.proxyHost
https.proxyPort

At a minimum, you need to define http.proxyHost to configure an HTTP proxy, and https.proxyHost to configure an HTTPS proxy. System property configuration is described in the Configuring System Properties.

プロパティ http.proxyHost と http.proxyPort は http プロトコルハンドラーが使用するプロキシサーバーとポートを示し、https.proxyHost と https.proxyPort は https プロトコルハンドラーについて同様に示します。

-Dhttp.proxyHost=proxy.example.org -Dhttp.proxyPort=8080 -Dhttps.proxyHost=proxy.example.org -Dhttps.proxyPort=8080

http.nonProxyHosts プロパティは、プロキシサーバーを介さずに直接接続されるホストを示します。値にはホストの一覧を設定でき、それぞれのホストをパイプ文字で区切ります。また、ワイルドカード文字 (アスタリスク) * を使用してデータの一致可否を確認できます。例:

-Dhttp.nonProxyHosts=*.foo.com|localhost

If you're using Confluence 6.0 or later with Synchrony, you'll need to pass the following to ensure Confluence can connect directly to Synchrony. Replace localhost|127.0.0.1 with your Synchrony IP if you have used the synchrony.host system property to change the IP Synchrony uses.

-Dhttp.nonProxyHosts=localhost|127.0.0.1
-Dhttps.nonProxyHosts=localhost|127.0.0.1

注意：一部のコマンドライン環境では、パイプ文字 | をエスケープする必要が生じる場合があります。

http.nonProxyHosts プロパティが設定されていない場合、すべての Web 要求がプロキシに送信されます。

プロセス一覧では一連のすべてのコマンドラインパラメータが表示されるため、プロセス一覧の適切な表示権限を持つすべてのユーザーがプロキシ情報をプレーンテキストで表示できることにご注意ください。これを回避するには、confluence-install/conf/ にある catalina.properties ファイルにプロパティを追加します。次の内容をファイルの最後に追加します。

http.proxyHost=yourProxyURL
http.proxyPort=yourProxyPort
http.proxyUser=yourUserName
http.proxyPassword=yourPassword
https.proxyHost=yourProxyURL
https.proxyPort=yourProxyPort
https.proxyUser=yourUserName
https.proxyPassword=yourPassword

HTTPプロキシ認証の設定

プロキシ認証についても、アプリケーションサーバーの設定ファイルで、Java にシステムプロパティを加えることによって設定できます。具体的には、次の 2 つのプロパティです。

http.proxyUser – username
http.proxyPassword – secret

HTTP プロキシ（Microsoft ISA）NTLM 認証

Confluence を Windows サーバー上で実行している場合、Confluence はアウトバウンド HTTP プロキシの NTLM 認証をサポートします。

つまり、リクエストが Windows 認証を必要とするプロキシを通過する必要がある場合、{rss} と {jiraissues} マクロは外部のウェブサイトに接続可能であることを意味します。このサポートは NTLM を使用して自動的に Confluence にログインするユーザーには関係がありません。というのは、ユーザー提供のオーセンティケーターを利用できるためです。

To configure NTLM authentication for your HTTP proxy, you need to define a domain system property, http.auth.ntlm.domain, in addition to the properties for host, port and username mentioned above:

-Dhttp.auth.ntlm.domain=MYDOMAIN

認証順序の設定

HTTP プロキシが複数の認証メカニズムを提供している場合があります。プロキシ認証失敗メッセージを受け取った場合、最初にユーザー名とパスワードを確認する必要があり、次いで Confluence サーバーのパケットスニファを使用して、プロキシ認証に失敗した HTTP ヘッダーを調べることによって、この問題を確認できます。（これについては、このドキュメントの対象範囲外です。）

To set the order for multiple authentication methods, you can set the system property http.proxyAuth to a comma-separated list of authentication methods. The available methods are: ntlm, digest and basic; this is also the default order for these methods.

たとえば、NTLM 認証の前に基本認証を試み、ダイジェスト認証を完全に回避するには、http.proxyAuth プロパティを次の値に設定します。

-Dhttp.proxyAuth=basic,ntlm -Dhttps.proxyAuth=basic,ntlm

トラブルシューティング

接続パラメーターを評価するには、CONF-9719 に診断 JSP ファイルがあります。
「ステータスコード[ 407 ] 」エラーの説明は APR-160 にあります。
Autoproxies are not supported. See CONFSERVER-16941 - Getting issue details... STATUS .

ページツリー