Client Browser -> HTTPS -> Apache Proxy -> HTTP -> Tomcat (JIRA)

これは、複数の SSL 証明書および／あるいは Webアプリケーションを抱えたネットワーク等、全て一つのロケーション(Apache) 内で管理する場合の一般的な設定です。

さらに複雑なソリューションが要求された場合は、「Apache HTTP サーバーのバージョンドキュメント」をご参照または、勤務先のApache SME にご相談下さい。必要な場合は、「アトラシアン回答コーナー」へご質問、または「アトラシアンエキスパート」にご相談下さい。

はじめる前に

 It is expected that the SSL certificate has been signed by a CA and is in the PEM format prior to configuring Apache. For assistance preparing and generating SSL certificates, please consult with a SSL Vendor (for example, GoDaddy, Verisign, RapidSSL).

ドメイン、サブドメインあるいはコンテキストパスを利用するかの決定は、主として提供される SSL 証明書の種類、およびウェブサイト設定にまつわるあらゆる業務規定によって左右されます。SSL がエラー無く機能するには、ドメインが証明書の Common Name (CN) と一致しなくてはいけません。

FQDN が証明書の CN と一致するよう構成する場合の展開

この表は、どの URL が証明書 CN と動作するかを示し、また使用するべき URL の推奨を行います。

Jira FQDN	コモンネーム	有効性	推奨される JIRA FQDN
https://jira.atlassian.com	jira.atlassian.com		https://jira.atlassian.com
https://jira.atlassian.com	*.atlassian.com		https://jira.atlassian.com
https://jira.atlassian.com	atlassian.com		https://atlassian.com/jira
https://atlassian.com	atlassian.com		https://atlassian.com/jira
https://atlassian.com	jira.atlassian.com		https://jira.atlassian.com

アスタリスク(*) を有する CN を持つ証明書は ワイルドカード証明書 であり、そのドメインのあらゆるサブドメインをサポートできます。どの URL を使用するべきか分からない場合は、その証明書を提供した担当のシステムアドミニストレーターと SSL ベンダーに問い合わせて下さい。

ステップ 1: Tomcat を設定する

1. Jira を停止します。

2. (オプション: Jira にコンテキスト パスが不要な場合、このステップを飛ばします)

   Tomcat の server.xml を編集して必要な Jira コンテキスト パスを追加します。以下の例では、path="jira" を使用しています。これは、既定の Jira ポートが使用されている場合、Jira に http://jiraserver:8080/jira でアクセスできることを意味します。

           <Engine defaultHost="localhost" name="Catalina">
               <Host appBase="webapps" autoDeploy="true" name="localhost" unpackWARs="true">
                   <Context docBase="${catalina.home}/atlassian-jira" path="/jira" reloadable="false" useHttpOnly="true">
   
                       <!--
                        ====================================================================================
                        Note, you no longer configure your database driver or connection parameters here.
                        These are configured through the UI during application setup.
                        ====================================================================================
                       -->
                       <Resource auth="Container" factory="org.objectweb.jotm.UserTransactionFactory" jotm.timeout="60" name="UserTransaction" type="javax.transaction.UserTransaction"/>
                       <Manager pathname=""/>
                   </Context>
               </Host>

    Ensure the path value is set with a prepending forward slash (/) . For example, path="/jira" rather than path="jira".

3. Tomcat の server.xml ファイルを編集して、リクエストをプロキシするための別のコネクタを含めます。これには scheme 属性、proxyName 属性、および proxyPort 属性が必要です。以下の例のように、これらをプロキシの適切なドメインおよびポートで置き替えます。

   <Service name="Catalina">
    
   	<!-- Apache Proxy Connector with values for scheme, proxyName and proxyPort -->
           <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8080" protocol="HTTP/1.1"
   relaxedQueryChars="[]|{}^&#5c;&#x60;&quot;&lt;&gt;" redirectPort="8443" useBodyEncodingForURI="true" 
               scheme="https" proxyName="jira.atlassian.com" proxyPort="443"/> 
   
   	<!-- Standard HTTP Connector -->
           <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8081" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true"/>

4. Tomcat から HTTPS へのリダイレクトが有効になっている場合、すべて無効にします。例えば、「SSL または HTTPS を通じて Jira を実行する」における WEB-INF/web.xml への変更は、Apache を使用する際にエラーを発生させます。
5. Jira を起動します。
6. 必要に応じてコンテキスト パスを使用して、Jira に通常のコネクタ上でアクセス可能かどうかをテストします。例: http://jiraserver:8081/jira。
7. 適切なプロキシ コネクタ上で Jira にアクセスして、新しいコネクタの有効性をテストします。コネクタの動作は、コンテキスト パスによって異なります。
   1. コンテキスト パスが空またはルート (/) の場合、プロキシ コネクタ (例: http://jiraserver:8080/) 経由で Jira にアクセスすると画面に警告が表示されます。
      
   2. コンテキスト パスが空もしくはルート (/) 以外の場合 (例: /jira)、プロキシ コネクタ (例: http://jiraserver:8080/jira) 経由で Jira にアクセスすると、設定されたプロキシ (例: https://jira.atlassian.com/jira) にリダイレクトされます。 

2 つの異なる Tomcat コネクタを利用して、Jira でのテストを可能にしました。必要に応じたプロキシのバイパスは、トラブルシューティングの際に便利です。標準コネクタは、ネットワーク外からの外部アクセスが認められない (ファイアウォールはポートへの転送を行わない) 事を想定しています。

ステップ 2: Apache HTTP サーバを設定する

Apache のインストールおよび DNS の構成に関しては、本ドキュメントでは扱っていません。また、Apache 2.2 がインストール済みであり、DNS エントリが Jira ドメイン向けに設定されているものと想定しています。Apache の設定は利用する OS によって異なるため、現在、一部のディストリビューションやそこでの設定のみドキュメントが用意されています。

2.1 プロキシモジュールを有効化する

Debian/Ubuntu

Windows/その他の OS

2.2 これらのモジュールを使用するように、Apacheを設定します

Debian/Ubuntu

Windows/その他の OS

2.3 HTTP を HTTPS にリダイレクトします

これは、以下のいずれかの方法で行えます:

• HTTP VirtualHost を、同じ Tomcat コネクタに転送するようにセットアップします。Tomcat は scheme、proxyName、proxyPort パラメータを利用して HTTPS にリダイレクトします。これは、アトラシアンの「Jira を Apache に統合する」ドキュメントに従って行えます。

• mod_rewrite (このモジュールを有効にする必要がある場合があります) を利用して、以下を HTTP VirtualHost に追加します。

  RewriteEngine On
  RewriteCond %{HTTPS} off
  RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}

ステップ 3: Jira を構成する

1. 「Jira オプション設定」の通りに、「gzip ファイル圧縮を利用する」設定をオフにします。 GZIP ファイル圧縮は、特にプロキシによるトラフィック圧縮を行う等のリバースプロキシを使った場合に、性能問題を起こすことで知られています。
2. Set the Base URL to be the FQDN that Jira will be accessed on, for example https://jira.atlassian.com. This is also located in Configuring Jira options.
    Jira can only be configured to respond to a single URL and the Base URL (as in Configuring Jira options) must match the URL end-users are accessing. Misconfiguration of this may cause significant problems within Jira such as the Activity Stream and Dashboard Gadgets failing to function correctly.
3. Test by accessing Jira on the FQDN (e.g.: https://jira.atlassian.com), ensuring that Jira is accessible and all dashboard gadgets correctly display.

トラブルシューティング

参考情報

• Jira と Apache の統合
• AJP プロトコルを利用して Apache リバースプロキシを構成する
• より高度な mod_webapp 設定 (例: SSL) については、この mod_proxy ガイドを参照してください。
• Apache 仮想ホストドキュメント