13.3.5 Webサーバ定義ファイル（httpsd.conf）の設定項目の詳細
Webサーバ定義ファイル（httpsd.conf）の記述形式や設定項目の詳細について説明します。
(1) ファイルの格納場所
httpsd.confの格納場所を次に示します。
/opt/jp1ajs3web/uCPSB/httpsd/conf
(2) ファイルの編集手順
httpsd.confの編集手順を次に示します。クラスタ運用時は，編集手順に従い，実行系と同じ定義内容を待機系で設定してください。
-
次のコマンドを実行して，HTTPサーバを停止する。
/etc/opt/jp1ajs3web/jajs_web_stop -t http
-
httpsd.confを任意のディレクトリにバックアップする。
-
httpsd.confをviなどのエディターで開く。
-
定義内容を変更する。
-
文字コードUTF-8でファイルを保存する。
-
次のコマンドを実行して，HTTPサーバを起動する。
/etc/opt/jp1ajs3web/jajs_web -t http
(3) 設定が有効になるタイミング
JP1/AJS3 HTTP Serverサービス起動時
(4) 記述形式
httpsd.confの記述形式を次に示します。
（省略） ServerRoot "/opt/jp1ajs3web/uCPSB/httpsd" ServerName Web Consoleサーバのホスト名 DocumentRoot "/opt/jp1ajs3web/uCPSB/httpsd/htdocs" （省略） ProxyPass /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/ timeout=3600 connectiontimeout=30 ProxyPassReverse /ajs/ http://localhost:HTTPサーバとJ2EEサーバが通信する際に使用するポート番号/ajs/ （省略） Listen Webブラウザーからの接続要求を受け付けるポート番号 #Listen [::]:Webブラウザーからの接続要求を受け付けるポート番号 #Listen SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号 #Listen [::]:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号 #<VirtualHost *:SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号> # ServerName Web Consoleサーバのホスト名 # SSLEngine On # SSLCertificateFile "/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server/サーバ証明書ファイル名" # SSLCertificateKeyFile "/opt/jp1ajs3web/uCPSB/httpsd/conf/ssl/server/秘密鍵ファイル名" # SSLProtocol SSL通信で使用するTLSのバージョン # SSLCipherSuite TLSv1.3 TLSv1.3で使用可能な暗号種別の一覧 # SSLCipherSuite TLSv1.2で使用可能な暗号種別の一覧 # AllowEncodedSlashes On #</VirtualHost>
なお，「#」から始まる行はコメント行です。
(5) 設定項目
設定項目について説明します。
(a) Web Consoleサーバのホスト名
Web Consoleサーバのホスト名が自動で設定されます。
Web Consoleサーバのホスト名を変更した際に，手動で変更します。
(b) HTTPサーバとJ2EEサーバが通信する際に使用するポート番号
Web Consoleサーバ内で，HTTPサーバとJ2EEサーバが通信する際に使用するポート番号を指定します。デフォルトでは，「22254」が指定されています。
ポート番号をデフォルトから変更したい場合，環境に合わせてポート番号を変更します。ProxyPassおよびProxyPassReverseの設定値は，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）のwebserver.connector.nio_http.portの設定値と一致させてください。詳細については，「13.3.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」を参照してください。
(c) Webブラウザーからの接続要求を受け付けるポート番号
SSL通信を使用しない場合に，Web ConsoleサーバがWebブラウザーからの接続要求を受け付けるポート番号を指定します。デフォルトでは，「22252」が指定されます。
Webブラウザーからの接続要求を受け付けるポート番号をデフォルトから変更した場合，ポート番号を変更します。
(d) SSL通信でのWebブラウザーからの接続要求を受け付けるポート番号
Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，Web ConsoleサーバがWebブラウザーからの接続要求を受け付けるポート番号を指定します。デフォルトでは，「22253」が指定されています。
SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除します。また，WebブラウザーからのSSL通信を受け付けるポート番号をデフォルトから変更した場合，ポート番号を変更します。
詳細については，「21.4 SSLを利用した通信の設定」を参照してください。
(e) サーバ証明書ファイル名
Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，CAから取得したサーバ証明書のファイル名を指定します。デフォルトでは，「httpsd.pem」が指定されています。
SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，サーバ証明書のファイル名に合わせて変更してください。
詳細については，「21.4 SSLを利用した通信の設定」を参照してください。
(f) 秘密鍵ファイル名
Web ConsoleサーバとWebブラウザーの通信にSSLを使用する場合に，秘密鍵のファイル名を指定します。デフォルトでは，「httpsdkey.pem」が指定されています。
SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，秘密鍵のファイル名に合わせて変更してください。
詳細については，「21.4 SSLを利用した通信の設定」を参照してください。
(g) SSL通信で使用するTLSのバージョン
SSL通信で使用するTLSのバージョンを，「+TLSv1.2」または「+TLSv1.3」で指定します。指定したバージョンのTLSだけが，SSL通信で有効になります。複数のバージョンを指定する場合，区切り文字には半角スペースを使用します。
- （例）
-
△は，半角スペースを表します。
-
TLSv1.2だけ有効にする場合
「SSLProtocol△+TLSv1.2」
-
TLSv1.3だけ有効にする場合
「SSLProtocol△+TLSv1.3」
-
TLSv1.2とTLSv1.3を有効にする場合
「SSLProtocol△+TLSv1.2△+TLSv1.3」
-
デフォルトでは，「+TLSv1.2」が指定されています。
SSL通信を有効にする場合，行の先頭の「#」（シャープ）を削除し，使用するTLSのバージョンに合わせて変更してください。
(h) TLSv1.3で使用可能な暗号種別の一覧
TLSv1.3で使用できる暗号種別の一覧を，「SSLCipherSuite TLSv1.3 暗号種別1:暗号種別2:暗号種別3...」の形式で指定します。
指定できる値を次に示します。
-
TLS_AES_128_GCM_SHA256
-
TLS_AES_256_GCM_SHA384
デフォルトでは，指定できるすべての値が指定されています。
SSL通信を有効にする場合，TLSv1.3を使用しなくても行の先頭の「#」（シャープ）を削除します。TLSv1.3を使用する場合は，使用する暗号種別に合わせて変更してください。
(i) TLSv1.2で使用可能な暗号種別の一覧
TLSv1.2で使用できる暗号種別の一覧を，「SSLCipherSuite 暗号種別1:暗号種別2:暗号種別3...」の形式で指定します。
指定できる値を次に示します。
-
AES128-GCM-SHA256
-
AES256-GCM-SHA384
-
ECDHE-RSA-AES128-SHA256
-
ECDHE-RSA-AES256-SHA384
-
ECDHE-RSA-AES128-GCM-SHA256
-
ECDHE-RSA-AES256-GCM-SHA384
-
ECDHE-ECDSA-AES128-SHA256
-
ECDHE-ECDSA-AES256-SHA384
-
ECDHE-ECDSA-AES128-GCM-SHA256
-
ECDHE-ECDSA-AES256-GCM-SHA384
デフォルトでは，指定できるすべての値が指定されています。
SSL通信を有効にする場合，TLSv1.2を使用しなくても行の先頭の「#」（シャープ）を削除します。TLSv1.2を使用する場合は，使用する暗号種別に合わせて変更してください。
(6) 注意事項
設定が不正な場合，JP1/AJS3 HTTP Server サービスが起動しません。