WebOTX Manual V10.3 (第4版) 目次を表示

---

3. HTTPサーバ

WebOTX では、Javaベースの内蔵Webサーバのほかに、Apache HTTP ServerベースのWebサーバ (以降「WebOTX Webサーバ」と記載します)をバンドルしています。

WebOTXでは、その他に利用可能なWebサーバとして、IIS / Apache HTTP Server の外部Webサーバをサポートしています。

WebOTX AS インストール時に、利用するWebサーバを正しく指定していればインストール後に設定する項目は、特にありません。 利用中のドメインで別のWebサーバに変更する必要が生じた場合には、「初期設定ツール」を起動し、外部Webサーバとの連携設定を行う必要があります。

3.1. Javaベース内蔵Webサーバ設定方法

3.1.1. 項目の設定

Javaベースの内蔵Webサーバの設定方法については、次の２通りがあります。

Webコンテナ管理コンソールによる設定

Webコンテナの運用管理コンソールの「network-listener」項目で、Javaベースの内蔵Webサーバの設定ができます。リスナの名称が"HTTPリスナ〜"と表示されているものが内蔵Webサーバです。詳細は「Webコンテナ」を参照してください。

MOによる参照と設定

Javaベースの内蔵Webサーバの設定は、WebコンテナのMOを介してもアクセス可能です。対象となる MO の Dottedname は「server.network-config.network-listeners.network-listener.リスナ名」です。 「server.network-config.network-listeners.network-listener.リスナ名.protocol」に紐付いた 「server.network-config.protocols.protocol.protocol名.type」の値が"nio"となっているものが内蔵Webサーバです。詳細は[ Webコンテナ ]を参照してください。

3.1.2. SSL通信の設定方法

3.2. WebOTX Webサーバ設定方法

ここでは、WebOTXで利用するWebサーバとして、「WebOTX Webサーバ」を利用する場合の設定方法について記載します。その他の外部Webサーバの設定については、[ 外部Webサーバ設定方法 ] を、Javaベースの内蔵Webサーバの設定については、[ Webコンテナ ] を参照してください。

WebOTXの運用管理コマンド / 統合運用管理ツールでは、WebOTX Webサーバの一部の定義情報の変更と参照、および、Webサーバの起動と停止ができます。また、定義情報ファイル (httpd.conf / ssl.conf) をエディタで編集して、定義情報の更新することが可能です。

3.2.1. MOによる参照と設定

運用管理コマンド / 統合運用管理ツールで変更 / 参照可能な項目と、その方法については、[ Webサーバガイド > 定義情報の参照, 定義情報の更新, 定義情報の追加 ] を参照してください。

3.2.2. 定義情報ファイル

WebOTX Webサーバの定義情報は、定義情報ファイル (httpd.conf / ssl.conf) に格納され、WebOTX Webサーバ起動時に読み込まれます。 定義情報ファイルは、WebOTX のドメイン毎に格納されるため、ドメイン毎に定義情報を変更する必要があります。

また、定義情報を更新した場合には、WebOTX Webサーバの再起動が必要です。

格納場所

• ${INSTANCE_ROOT}/config/WebServer/httpd.conf
• ${INSTANCE_ROOT}/config/WebServer/ssl.conf

SSL設定に関する定義情報は、ssl.confファイルに格納されます。 SSL通信で利用するポート番号や証明書／秘密鍵ファイルを設定／変更する場合、このファイルに定義された情報を変更する必要があります。

3.2.3. 基本定義

ここでは、WebOTX Webサーバが動作するために必要となる定義情報について 説明します。
定義情報ファイルには、最低限、次の定義を含める必要があります。

• ServerRoot
• Listen
• User / Group
• DocumentRoot
• ErrorLog
• LoadModule

3.2.3.1. ServerRoot

3.2.3.2. Listen

3.2.3.3. User / Group

3.2.3.4. DocumentRoot

3.2.3.5. ErrorLog

定義情報は、[ ログ出力 > ErrorLog ] を参照してください。

3.2.3.6. LoadModule

3.2.4. サーバ動作に関する設定

ここでは、WebOTX Webサーバの動作プロセス数に関する設定を説明します。

Windows 版は、１つの子プロセス上で複数スレッドが動作し、各スレッド上で クライアントからのリクエストを受け付けます。つまり、１リクエストに対して、 １スレッドが割り当てられます。

上記のような動作の違いにより、Windows 版と UNIX 版では、定義内容が 異なります。 動作プロセスに関連する主なディレクティブは、次の通りです。

• MaxClients
• ThreadsPerChild
• MinSpareThreads / MaxSpareThreads
• StartServers
• ServerLimit / ThreadLimit
• MaxRequestsPerChild

3.2.4.1. MaxClients

3.2.4.2. ThreadsPerChild

3.2.4.3. MinSpareThreads / MaxSpareThreads

3.2.4.4. StartServers

3.2.4.5. ServerLimit / ThreadLimit

3.2.4.6. MaxRequestsPerChild

3.2.5. SSL 定義

ここでは SSL通信を行う場合、定義情報ファイルに定義する 主な設定を説明します。
SSLに関する設定は、ssl.confファイルに格納されています。

• SSLEngine
• SSLCertificateFile
• SSLCertificateKeyFile
• SSLCACertificateFile
• SSLVerifyClient
• SSLOptions
• SSLCipherSuite
• SSLProtocol
• SSLPassPhraseDialog
• SSLRequireSSL

3.2.5.1. SSLEngine

3.2.5.2. SSLCertificateFile

    -----BEGIN CERTIFICATE-----
          <サーバ証明書>
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
          <中間CA証明書>
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
          <クロスルート証明書>
    -----END CERTIFICATE-----

3.2.5.3. SSLCertificateKeyFile

3.2.5.4. SSLCACertificateFile

    -----BEGIN CERTIFICATE-----
          <ルート証明書>
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
          <中間CA証明書>
    -----END CERTIFICATE-----

3.2.5.5. SSLVerifyClient

3.2.5.6. SSLOptions

3.2.5.7. SSLCipherSuite

3.2.5.8. SSLProtocol

3.2.5.9. SSLPassPhraseDialog

3.2.5.10. SSLRequireSSL

3.2.6. ユーザ認証、アクセス制御

ここでは WebOTX Webサーバがサポートするユーザ認証機能と、 クライアントのアクセス制御に関する設定を記述します。

• AuthType
• AuthName
• AuthUserFile
• Require
• Order
• Allow / Deny

3.2.6.1. AuthType

3.2.6.2. AuthName

3.2.6.3. AuthUserFile

3.2.6.4. Require

3.2.6.5. Order

3.2.6.6. Allow / Deny

3.2.7. LDAP 連携

LDAP連携する場合に必要となる定義情報を記載します。

• AuthLDAPUrl

3.2.7.1. AuthLDAPUrl

3.2.8. ログ出力

WebOTX Webサーバが出力するログに関する定義情報について説明します。

• ErrorLog
• CustomLog
• LogFormat
• LogLevel
• ErrorLogFormat

3.2.8.1. ErrorLog

3.2.8.2. CustomLog

3.2.8.3. LogFormat

3.2.8.4. LogLevel

3.2.8.5. ErrorLogFormat

3.2.9. 通信関連

WebOTX Webサーバとの通信で利用する定義情報について記載します。

• KeepAlive
• MaxKeepAliveRequests
• KeepAliveTimeout
• SoKeepAlive
• ReceiveBufferSize
• SendBufferSize
• SoLinger
• SoReuseAddr
• TcpNodelay

3.2.9.1. KeepAlive

3.2.9.2. MaxKeepAliveRequests

3.2.9.3. KeepAliveTimeout

3.2.9.4. SoKeepAlive

3.2.9.5. ReceiveBufferSize

3.2.9.6. SendBufferSize

3.2.9.7. SoLinger

3.2.9.8. SoReuseAddr

3.2.9.9. TcpNodelay

なお、KeepAliveディレクティブと、SoKeepAliveディレクティブの関係は、次の通りです。

ユーザ数が限られている場合や、必要に応じてブラウザを落とす前提で良ければ、 HTTPレベルのキープアライブを無効 (KeepAlive Off) にして、 TCPレベルのキープアライブを有効 (SoKeepAlive On) にすることで、 コネクション再利用が最大化され、性能的なメリットを受けることができます。

3.2.10. ブラウザキャッシュ関連

ブラウザキャッシュの制御で利用する定義情報について記載します。

• FileEtag
• ExpiresActive
• ExpiresDefault
• ExpiresByType

3.2.10.1. FileEtag

3.2.10.2. ExpiresActive

3.2.10.3. ExpiresDefault

3.2.10.4. ExpiresByType

3.2.10.5. ブラウザキャッシュ利用に関する設定

mod_headersモジュールを使用して、キャッシュに関するヘッダを設定することで、ブラウザキャッシュの無効化や、ブラウザキャッシュを利用するときに有効性確認を行うようにすることができます。 WebOTX Webサーバの定義情報ファイル (httpd.confファイル) において、次の設定を追加します。

定義例 1) ブラウザキャッシュを利用しない

LoadModule headers_module /opt/WebOTX/WebServer24/modules/mod_headers.so
    :
FileEtag None
RequestHeader unset If-Modified-Since
Header set Cache-Control "no-store"

定義例 2) ブラウザキャッシュの有効性確認を行う

LoadModule headers_module /opt/WebOTX/WebServer24/modules/mod_headers.so
    :
Header set Cache-Control "no-cache"

設定変更後は、動作への反映のため、WebOTX Webサーバを再起動してください。

3.2.10.6. ブラウザキャッシュの有効期限設定

mod_expiresモジュールにより、コンテンツの有効期限を設定することができます。 WebOTX Webサーバの定義情報ファイル (httpd.confファイル) において、次の設定を追加します。

定義例 1) すべてのドキュメントについてデフォルトの有効期限をアクセス時刻から86400秒(1日)とする

LoadModule expires_module /opt/WebOTX/WebServer24/modules/mod_expires.so
    :
ExpiresActive On
ExpiresDefault A86400

定義例 2) GIF形式の画像ファイルの有効期限を最終更新時刻から5時間+3分とする

LoadModule expires_module /opt/WebOTX/WebServer24/modules/mod_expires.so
    :
ExpiresActive On
ExpiresByType image/gif "modification plus 5 hours 3 minutes"

設定変更後は、動作への反映のため、WebOTX Webサーバを再起動してください。

3.2.11. プロキシ関連

WebOTX Webサーバで提供するプロキシ関連モジュールの定義情報について記載します。

• ProxyRequests
• ProxyPass
• ProxyPassReverse
• ProxyVia
• <Proxy>
• AllowCONNECT

3.2.11.1. ProxyRequests

3.2.11.2. ProxyPass

3.2.11.3. ProxyPassReverse

3.2.11.4. ProxyVia

3.2.11.5. <Proxy>

3.2.11.6. AllowCONNECT

3.2.11.7. プロキシサーバの構築

mod_proxyモジュール等を利用することで、WebOTX Webサーバをプロキシサーバとして設定することができます。 WebOTX Webサーバは、フォワードプロキシとしても、リバースプロキシとしても設定することが可能です。

リバースプロキシの設定

WebOTX Webサーバの定義情報ファイル (httpd.confファイル、あるいは、ssl.confファイル) において、次の定義を行います。

定義例) /foo/ へのアクセスを、別のホスト(backend.example.com)へ転送する場合

LoadModule proxy_module /opt/WebOTX/WebServer24/modules/mod_proxy.so
LoadModule proxy_http_module /opt/WebOTX/WebServer24/modules/mod_proxy_http.so
    :
ProxyRequests Off
ProxyPass /foo/ http://backend.example.com/
ProxyPassReverse /foo/ http://backend.example.com/

設定変更後は、動作への反映のため、WebOTX Webサーバを再起動してください。

フォワードプロキシの設定

WebOTX Webサーバの定義情報ファイル (httpd.confファイル、あるいは、ssl.confファイル) において、次の定義を行います。

定義例) 指定されたIPアドレスからのリクエストのみオリジンサーバに送信する

LoadModule proxy_module /opt/WebOTX/WebServer24/modules/mod_proxy.so
LoadModule proxy_connect_module /opt/WebOTX/WebServer24/modules/mod_proxy_connect.so
    :
ProxyRequests On
ProxyVia On

AllowCONNECT 443

<Proxy *>
  Require ip xx.xx.xx.xx
    :
</Proxy>

設定変更後は、動作への反映のため、WebOTX Webサーバを再起動してください。

3.2.12. エラーページ設定

HTTPステータスに応じた応答内容を設定する定義情報について記載します。

• ErrorDocument

3.2.12.1. ErrorDocument

3.2.12.2. エラーページのカスタマイズ

WebOTX Webサーバ内でエラーが発生した場合、次のうち一つの動作を設定することができます。

1. WebOTX Webサーバ標準の簡単なエラーメッセージを表示 (デフォルト)
2. 指定したメッセージを表示
3. 問題やエラーの処理をするために、指定したURLへリダイレクト

デフォルトの動作を変更する場合は、WebOTX Webサーバの定義情報ファイル (httpd.confファイル) において、ErrorDocumentディレクティブにより設定を行います。

定義例 1) HTTPステータス403の場合に、独自のメッセージを表示する場合

ErrorDocument 403 "Sorry can't allow you access today" 

定義例 2) HTTPステータス404の場合に、独自のエラーページを表示する場合

ErrorDocument 404 /error.html

設定変更後は、動作への反映のため、WebOTX Webサーバを再起動してください。

3.2.13. ディレクトリ一覧表示機能の無効化

WebOTX Webサーバの定義情報ファイル (httpd.conf) において、 ディレクトリ一覧表示機能を「無効」 (ディレクトリリスティングを禁止) に 設定しています。
そのため、ブラウザからWebOTX Webサーバの DocumentRootディレクトリ (つまり http://localhost/) や、DirectoryIndexディレクティブで設定しているファイル (index.html) が 存在しないディレクトリにアクセスすると、以下の Forbidden メッセージ (HTTPステータスコード 403) が 返却されます。
WebOTX Webサーバは正常起動していますので、本メッセージが出力されることに 問題はありません。

なお、WebOTX Webサーバへのアクセスに対して正常終了 (HTTPステータス 200) が 返却されること確認する場合には、ブラウザから次のURLを指定し、 WebOTX Webサーバのマニュアルページが表示されることを確認してください。

  http://localhost/manual/

WebOTX Webサーバのディレクトリ一覧表示機能を有効にするには、 WebOTX Webサーバの定義情報ファイル (httpd.confファイル) において、 <Directory>ディレクティブ内で設定されている Options ディレクティブに Indexes オプションを追加します。
<Directory>ディレクティブは複数存在しますので、それぞれに 設定する必要があります。

<Directory "/opt/WebOTX/domains/domain1/docroot">
  Optios Indexes FollowSymLinks MultiView
  …
</Directory>

ただし、ディレクトリ一覧表示機能を有効に設定することは、 WebOTX Webサーバのセキュリティ対策上、問題となる場合があります。 本設定を有効に変更する場合には、十分な注意が必要です。

3.2.14. リダイレクト関連

3.2.14.1. HTTP通信のHTTPS通信へのリダイレクト

mod_rewriteモジュールを利用して、HTTP通信でのアクセスの場合に、HTTPS通信にリダイレクトすることで、強制的にHTTPS通信を行うようにすることが可能です。
WebOTX Webサーバの定義情報ファイル (httpd.confファイル) において、次の設定を追加します。

定義例) アクセスポートが443(SSL通信ポート)以外のすべてのアクセスをHTTPSにリダイレクトする場合

LoadModule rewrite_module /opt/WebOTX/WebServer24/modules/mod_rewrite.so
    :
RewriteEngine On
RewriteCond %{SERVER_PORT} !^443$
RewriteRule ^/(.*)?$ https://%{HTTP_HOST}/$1 [L,R]

設定変更後は、動作への反映のため、WebOTX Webサーバを再起動してください。

3.2.14.2. URL変換

mod_rewriteモジュールを利用して、URL変換を行った上でリダイレクトすることができます。 WebOTX Webサーバの定義情報ファイル (httpd.confファイル) において、次の設定を追加します。

定義例) /foo/bar.htmlへのアクセスでページ名をパラメータにしてリクエストを送信する場合

LoadModule rewrite_module /opt/WebOTX/WebServer24/modules/mod_rewrite.so
    :
RewriteEngine On
RewriteRule ^/foo/(.*)$ http://%{HTTP_HOST}/HelloSample/hello.html?param=$1 [L,R]

設定変更後は、動作への反映のため、WebOTX Webサーバを再起動してください。

3.2.15. レスポンスデータの圧縮

通信量削減のため、mod_deflateモジュールを使用して、レスポンスデータを圧縮することができます。 WebOTX Webサーバの定義情報ファイル (httpd.confファイル) において、次の設定を追加します。

定義例 1) "/HelloSample"アプリケーションのレスポンスを圧縮する場合

LoadModule deflate_module /opt/WebOTX/WebServer24/modules/mod_deflate.so
    :
<Location "/HelloSample/">
  SetOutputFilter DEFLATE
</Location>

定義例 2) MIMEタイプ text/html、text/plain のみを圧縮する場合

LoadModule deflate_module /opt/WebOTX/WebServer24/modules/mod_deflate.so
LoadModule filter_module /opt/WebOTX/WebServer24/modules/mod_filter.so
    :
AddOutputFilterByType DEFLATE text/html text/plain

設定変更後は、動作への反映のため、WebOTX Webサーバを再起動してください。

3.2.16. その他の定義情報

その他の定義情報の詳細については、次のURLを参照してください。

• Apache HTTP Server Version 2.4 - Module Index

  http://httpd.apache.org/docs/2.4/mod/

3.3. Javaベース内蔵WebサーバとWebOTX Webサーバの設定対応表

3.3.1. Webサーバに関する設定

3.3.2. SSLに関する設定

3.4. 外部Webサーバ設定方法

3.4.1. 項目の設定

環境構築ツールを使ってのドメイン作成時に、利用するWebサーバを指定することでWebコンテナとの連携設定が自動で行われます。 内蔵Webサーバを利用している環境から外部Webサーバに連携する環境に変更する場合には初期設定ツールを使って連携のための設定が必要です。設定方法は、 [ Webコンテナ > Webコンテナと連携するWebサーバを切り替える方法 > Javaベースの内蔵Webサーバから外部Webサーバへ切り替える場合 ] を参照してください。

外部Webサーバの設定方法については次の２通りがあります。なお、下記は外部Webサーバと連携するためのリスナに関する設定です。Webサーバ自体の設定については、それぞれのマニュアルを参照してください。

Webコンテナ管理コンソールによる設定

Webコンテナの運用管理コンソールの「network-listener」項目で、外部のWebサーバと連携するためのリスナの設定ができます。リスナの名称が"AJPリスナ(〜)"と表示されているものが外部Webサーバ連携用のリスナです。詳細は「Webコンテナ」を参照してください。

MOによる参照と設定

外部Webサーバ連携用リスナの設定は、WebコンテナのMOを介してもアクセス可能です。対象となる MO の Dottedname は「server.network-config.network-listeners.network-listener.リスナ名」です。
「server.network-config.network-listeners.network-listener.リスナ名.protocol」に紐付いた 「server.network-config.protocols.protocol.protocol名.type」の値が"ajp"となっているものがエージェントプロセス用外部Webサーバ連携用リスナ設定です。詳細は「Webコンテナ」を参照してください。

「server.network-config.network-listeners.network-listener.リスナ名.protocol」に紐付いた 「server.network-config.protocols.protocol.protocol名.type」の値が"tpm"となっているものがTPシステム用外部Webサーバ連携用リスナ設定(プロトコル用の設定※1)です。詳細は「Webコンテナ」を参照してください。

※1 通信に関する設定は「TPシステム」の「WebOTX　AJPリスナ」を参照してください。