Configure an outbound proxy for use in Jira server
この記事はアトラシアンのサーバーおよびデータセンター製品にのみ適用されます。クラウドとサーバー製品の違いについてはこちらをご確認ください。
このページの内容は、Jira アプリケーションでサポートされていないプラットフォームに関連しています。したがって、アトラシアンは、そのためのサポートの提供を保証できません 。この資料は情報提供のみを目的としているため、お客様自身の責任でご使用ください。
このアウトバウンド プロキシ構成は HTTP および HTTPS リクエストでのみ動作します。Jira をメール サーバー (Gmail や Office 365) や LDAP サーバーに接続しようとしている場合、この設定は動作しません。
目的
このページでは、Jira アプリケーションを設定し、アウトバウンド プロキシを経由して外部とやり取りできるようにします。これは Atlassian Marketplace などの、サーバーがホストされているネットワークの外部にあるサーバーにアクセスするために必要です。Jira アプリケーションをリバース プロキシ (またはインバウンド プロキシ) の背後でホストしたい場合、「Jira を Apache と連携する」または「SSL を使用して Jira を Apache と連携する」をご参照ください。
構成
プロキシのサポートは、Jira アプリケーションの起動時に特定のシステム プロパティを Java 仮想マシンに渡すことで設定されます。これらのプロパティは Oracle で定義された規則に従います。
http.proxyHosthttp.proxyPort(既定: 80)http.nonProxyHosts(既定: <none>)https.proxyHosthttps.proxyPort
HTTP プロキシを設定する場合は http.proxyHost プロパティ、HTTPS プロキシの場合は https.proxyHost を定義する必要があります。システム プロパティの設定の詳細については、「起動時にプロパティおよびオプションを設定する」ドキュメントをご参照ください。
http.proxyHost および http.proxyPort プロパティは、HTTP プロトコル ハンドラが使用するプロキシ サーバーとポートを示します。例:
-Dhttp.proxyHost=proxy.example.org -Dhttp.proxyPort=8080 -Dhttps.proxyHost=proxy.example.org -Dhttps.proxyPort=8080 -Dhttp.nonProxyHosts=localhost
http.nonProxyHosts プロパティは、プロキシ サーバーを経由しない、直接接続されるホストを示します。値は、"|" で区切られたホストの一覧です。ワイルドカード "*" を照合に使用できます。例:
-Dhttp.nonProxyHosts=*.foo.com|localhost|confluence|crowdLinux の場合はパイプ文字 "|" のエスケープが必要な場合があります。
最新の Windows アップデートを適用済みの Windows の最新バージョンではパイプ文字 "|" が動作しない可能性があります。
Please refer to JAVA Option '-Dhttp.nonProxyHosts' Does Not Work KB article for more details.
http.nonProxyHosts プロパティが設定されていない場合、すべての web リクエストがプロキシを経由します。たとえば、アプリケーション リンクを使用して Confluence と Jira アプリケーションを接続している場合、このプロパティを使用してプロキシをバイパスし、内部ネットワークで通信するようにすることをおすすめします。リンクの IP 検証を考慮した場合、プロキシ経由での転送では、トラフィックの転送形式によってはサーバーのソース IP が変更されてしまい、予期せぬ結果となる可能性があります。
http.nonProxyHosts には、少なくとも localhost と Jira のベース URL を含める必要があります。これらが含まれていない場合、特定の機能が適切に動作しない可能性があります (Jira が自身に接続しようとして HTTP リクエストがタイムアウトしたりプロキシでブロックされたりする)。例:
-Dhttp.nonProxyHosts=localhost|jira.atlassian.comアプリケーション リンク
Jira アプリケーションをほかのアプリケーションに接続する場合、nonProxyHosts 引数にアプリケーションの URL を追加します。これを行わない場合、Jira アプリケーションがほかのアトラシアン アプリケーションに通信しようとした際に、HTTP リクエストがタイムアウトしたり、解決されない可能性があります。このため、アプリケーションがリンクされません。Jira アプリケーションを confluence.atlassian.com に配置された Confluence に接続する場合の例:
-Dhttp.nonProxyHosts=localhost|*.atlassian.com認証の設定
プロキシ認証は、次のプロパティを Java に渡すことで設定します。詳細については「起動時にプロパティおよびオプションを設定する」ドキュメントをご参照ください。
http.proxyUser– ユーザー名http.proxyPassword– 秘密https.proxyUserhttps.proxyPassword
例:
-Dhttp.proxyUser=atlaspirate -Dhttp.proxyPassword=yarrrrr -Dhttps.proxyUser=atlaspirate -Dhttps.proxyPassword=yarrrrrMicrosoft ISA NTLM 認証
「Jira で NTLM 認証を使用できない」ナレッジベース記事にあるように、Jira アプリケーションでは現在、NTLM 認証のすべての構成はサポートされません。ただし、これを JVM で設定する場合、次のプロパティを使用できます。
-Dhttp.auth.ntlm.domain=DOMAIN認証順の設定
ntlm、digest、basic の 3 つの認証メカニズムが、既定ではこの順で提供されます。この順序を変更したり、1 つ以上の方法をまとめて除外したりできます。これは次のプロパティで行います。
-Dhttp.proxyAuth=basic,ntlmこの例では、認証の順序は basic、ntlm のみとなり、digest は使用されません。