IISのWebサーバー・プラグインを構成するために使用するパラメータを説明します。各Webサーバー・プラグインのパラメータは、専用の構成ファイルに入力します。この構成ファイルは各Webサーバーで別々の名前を持ち、ファイルの形式にはそれぞれの規則があります。詳細は、各プラグインの次の項を参照してください。IISプラグインのインストールと構成」Webサーバー・プラグインの一般的なパラメータWebサーバー・プラグインの一般的なパラメータを表7-1に示します。パラメータでは大文字/小文字が区別されます。Serverにプロキシする場合は必須。Serverで定義されたものと同じ仮想ホスト名)を示します。WebLogicクラスタを使用している場合、WebLogicHostのかわりにWebLogicClusterパラメータを使用します。Serverにプロキシする場合は必須。Serverホストがリスニングするポート。Serverの間にSSLを使用している場合、このパラメータにSSLのリスニング・ポートを設定し(「SSLの構成」を参照)、SecureProxyパラメータをONに設定します。Clusterを使用している場合は、WebLogicPortのかわりにWebLogicClusterパラメータを使用します。Serverのクラスタまたは複数の非クラスタ・サーバーにプロキシする場合は必須。)なしクラスタリングされたバックエンド・サーバーのリストにプロキシするため、またはクラスタリングされていない管理対象サーバー・インスタンスのロード・バランシングを実行するため、WebLogicClusterパラメータが必要です。Serverのリスト。サーバーまたはクラスタのリストは、「ホスト:ポート」エントリのリストです。複数のクラスタと単一サーバーの組合せを指定すると、このパラメータに戻される動的リストは、クラスタリングされたサーバーのみを戻します。パラメータの指定方法と必要な形式はプラグインによって異なります。次に含まれる例を参照してください。Serverの間にSSLを使用している場合は、ポート番号をSSLリスニング・ポートに設定して(「SSLの構成」を参照)、SecureProxyパラメータをONに設定します。プラグインは、使用可能なサーバー間で単純なラウンド・ロビンを行います。このプロパティで指定するサーバー・リストは、サーバーおよびプラグインが保持する動的サーバー・リストの起点です。Serverとプラグインは連携して自動的にサーバー・リストを更新します。動的クラスタ・リストを無効化するには、DynamicServerListパラメータをOFFに設定します。プラグインは、Cookie、URLエンコードされたセッション、またはPOSTデータに格納されたセッションを含むHTTPリクエストを、最初にCookieを作成したクラスタ内のサーバーに転送します。ISAPI、ApacheとNSAPIプラグインおよびHttpClusterServletPathTrimnullRFC仕様に従ったURLの一般的な構文は次のとおりです。Serverに転送される前に、元のURLの{PATH}/{FILENAME}の部分からプラグインによって取り除かれる文字列を指定します。Serverに転送されるURLは次になります。Serverにリクエストをプロキシする場合、/fooへのアプリケーション・パスを変更してweblogic/fooを含むようにする必要があります。PathTrimおよびPathPrependを組み合わせて使用すると、このパスを変更できます。ISAPI、ApacheとNSAPIプラグイン、HttpClusterServletおよびHttpProxyServletPathPrependnullRFC仕様に従ったURLの一般的な構文は次のとおりです。Serverに転送される前に、プラグインによって元のURLの{PATH}の部分の先頭に付加されるパスを指定します。ファイル名を追加する必要がある場合は、PathPrependではなく、DefaultFileNameプラグイン・パラメータを使用する点に注意してください。Serverホストへの接続を試行する最大時間(秒)。この値はConnectRetrySecsより大きくします。Unavailable」のレスポンスがクライアントに送られます。エラー・レスポンスはErrorPageパラメータを使用してカスタマイズできます。Serverホスト(またはクラスタ内のすべてのサーバー)への接続試行の間にプラグインがスリープする間隔(秒)。この値はConnectTimeoutSecsより小さくします。Unavailable」のレスポンスをクライアントに戻す前にプラグインが接続を試行する回数は、ConnectTimeoutSecsをConnectRetrySecsで除算することで算出されます。再試行しないようにするには、ConnectRetrySecsをConnectTimeoutSecsと同じ値に設定します。プラグインは最低2回接続を試みます。エラー・レスポンスはErrorPageパラメータを使用してカスタマイズできます。NSAPI、ISAPIとApacheプラグインおよびHttpClusterServletDebugOFFデバッグ操作用に実行されるロギングのタイプを設定します。NT/2000システムの場合は、c:\TEMP\wlproxy.logに書き込まれます。WLLogFileパラメータを別のディレクトリとファイルに設定して、この場所とファイル名をオーバーライドします。(この場所を変更する他の方法については、「WLTempDir」パラメータを参照してください。)サーバーにログインするユーザーに対してtmpまたはTEMPディレクトリへの書込み権限が割り当てられていることを確認してください。次のいずれかのロギング・オプションを設定します(HFC、HTW、HFWおよびHTCのオプションを組み合わせて、「HFC,HTW」のようにカンマで区切って設定することもできます)。プラグインは、情報メッセージおよびエラー・メッセージを記録します。デバッグ情報は記録されません。プラグインは、クライアントからのヘッダー、情報メッセージおよびエラー・メッセージを記録します。Serverに送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。Serverから送信されたヘッダー、情報メッセージ、およびエラー・メッセージを記録します。プラグインは、クライアントに送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。プラグインのエラー・メッセージのみを出力します。Serverから送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。NSAPI、ISAPIとApacheプラグインおよびHttpClusterServletとHttpProxyServlet。HttpClusterServletおよびHttpProxyServletの場合、可能な値はONとOFFのみです。WLLogFileDebugパラメータを参照DebugパラメータがONに設定されている場合に生成されるログ・ファイルのパスとファイル名を指定します。このディレクトリはこのパラメータの設定前に作成する必要があります。(起動時に1回のみルックアップ)NSAPIおよびApacheにのみ適用されます。ServerがサーバーのDNS名からIPへのマッピングをリフレッシュする間隔を秒単位で指定します。Serverインスタンスを別のIPアドレスに移行する場合に使用できますが、そのサーバーのIPのDNS名は変更されません。この場合、指定したリフレッシュ間隔でDNS<->IPのマッピングが更新されます。NSAPIおよびApacheプラグインWLTempDirDebugパラメータを参照wlproxy.logを作成するディレクトリを指定します。場所が見つからない場合、Windowsの場合はC:/tempに、Unixの場合はすべてのプラットフォームで/tmpにログ・ファイルが作成されます。POSTデータ・ファイルの_wl_proxyディレクトリの場所も指定します。WLTempDirおよびWLLogFileの両方を設定した場合、wlproxy.logの場所についてはWLLogFileが優先します。_wl_proxyディレクトリの場所は、依然としてWLTempDirによって決まります。NSAPI、ISAPIおよびApacheプラグインDebugConfigInfoOFF特殊な問合せパラメータ「__WebLogicBridgeConfig」を有効にします。このパラメータは、プラグインから構成パラメータに関する詳細を取得するために使用します。DebugConfigInfoを設定して「__WebLogicBridgeConfig」を有効にし、問合せ文字列「?__WebLogicBridgeConfig」を含むリクエストを送信すると、構成情報と実行時統計が収集され、その情報がブラウザに戻されます。Serverに接続しません。このパラメータはデバッグにのみ使用するもので、出力メッセージの形式はリリースによって異なります。セキュリティのため、本番システムではこのパラメータをOFFにしてください。Serverに転送する前に、リクエストの変換されたパス(Proxy-Path-Translated)の有無と権限がチェックされます。Found」のレスポンスがクライアントに戻されます。403/Forbidden」のレスポンスがクライアントに戻されます。どちらの場合も、Webサーバーのデフォルトのメカニズムがこれらのレスポンスを処理します。Webアプリケーションのドキュメント・ルートとWebサーバーのドキュメント・ルートが同じである場合に役立ちます。エラー・レスポンスはErrorPageパラメータを使用してカスタマイズできます。Serverに転送できなかった場合に表示されるユーザー独自のエラー・ページを作成できます。(0より大きな値)接続中のソケットのタイムアウトを秒単位で設定します。Serverからのリクエストへのレスポンスに対するプラグインの待機時間を定義します。プラグインは、サーバーがレスポンスするまでWLIOTimeoutSecsで指定した秒数だけ待機してから、サーバーのレスポンスなしを宣言して、次のサーバーにフェイルオーバーします。この値は、大きな値にしておく必要があります。サーブレットの処理時間より短くした場合は、予期しない結果が発生する場合があります。制限なしNSAPI、ISAPIおよびApacheプラグインIdempotentON「ON」に設定されている状態で、サーバーが「WLIOTimeoutSecs」(HungServerRecoverSecsの新しい名称)の時間内に応答しない場合、プラグインはフェイルオーバーします。Idempotentを「ON」に設定している場合も、プラグインはフェイルオーバーされ、サーバーがREAD_ERROR_FROM_SERVERなどのエラーを戻します。「OFF」に設定した場合、プラグインはフェイルオーバーしません。Serverを使用している場合は、複数のURLまたはMIMEタイプに対してこのパラメータを別々に設定できます。ServerセッションCookie名を変更する場合、プラグインの「WLCookieName」パラメータを同じ値に変更する必要があります。WebLogicセッションCookie名は、WebLogic固有のデプロイメント記述子の<session-descriptor>要素で設定されます。NSAPI、ISAPIとApacheプラグインおよびHttpClusterServletとHttpProxyServletDefaultFileNameなしURIが「/」の場合、プラグインは次の手順を実行します。PathTrimパラメータで指定されたパスを取り除きます。DefaultFileNameの値を末尾に付加します。PathPrependで指定された値を先頭に付加します。Serverからリダイレクトされなくなります。ServerのWebアプリケーションのデフォルト・ウェルカム・ページに設定します。DefaultFileNameをwelcome.htmlに設定した場合、HTTPリクエストが「http://somehost/weblogic」であれば、「http://somehost/weblogic/welcome.html」になります。このパラメータが機能するためには、リクエストが転送されるすべてのWebアプリケーションで同じウェルカム・ファイルを指定する必要があります。詳細は、「ウェルカム・ページの構成」を参照してください。StrongholdバージョンまたはRavenバージョンを使用する場合は、IfModuleブロックではなくLocationブロックでこのパラメータを定義します。NSAPI、ISAPIとApacheプラグインおよびHttpClusterServletとHttpProxyServletMaxPostSize-1POSTデータの最大許容サイズ(バイト単位)。コンテキスト長がMaxPostSizeを超えた場合、プラグインによってエラー・メッセージが戻されます。-1に設定した場合、POSTデータのサイズはチェックされません。これは、POSTデータを使用してサーバーを過負荷状態にしようとするサービス拒否攻撃を防ぐために役立ちます。Serverのみ)なしMIMEタイプによるプロキシを行う場合、MatchExpressionパラメータを使用してIfModuleブロック内にファイル名のパターンを設定します。/weblogicWebLogicHost=myHost|paramName=value</IfModule>次の構文を使用して、MatchExpressionの新しいパラメータを定義することもできます。Serverに転送されます。これにより、フェイルオーバーの間もPOSTデータが保持され、プライマリがダウンしても、必要なすべてのデータをセカンダリにコピーすることができます。FileCachingがONになっていると、データがWebServerとWebLogicの間でまだ転送中であっても、POSTの進行状況を追跡するクライアントは転送が完了したものと認識することに注意してください。Serverで実際にデータが使用可能になったタイミングを示す場合は、FileCachingをONにしないことも検討する必要があります。Serverクラスタ・メンバーが特定されるまでPOSTデータの読込みが延期されます。Serverに送信します。FileCachingをOFFにするとフェイルオーバーが制限されることに注意してください。Serverプライマリ・サーバーがダウンした場合、すでにプライマリに送信されたPOSTデータはセカンダリに複写できません。POSTデータのサイズが2048バイト以下の場合は、FileCachingの設定に関係なくプラグインがデータをメモリーに読み込み、フェイルオーバー時にセカンダリへの複写が必要であればこれを使用します。デフォルト値は2です。この優先順位は、iisforward.iniファイルに置かれる必要があります。このプロパティを使用して、IISのiisforward.dllフィルタの優先レベルが設定されます。受信リクエストが複数のフィルタに一致する場合に、IISは優先レベルに従って、最初に呼び出すフィルタを判別します。ISAPIプラグインWLExcludePathOrMimeTypeなしこのパラメータを使用すると、特定のリクエストをプロキシ処理から除外できます。このパラメータは、Locationタグ・レベルでローカルに定義することも、グローバルに定義することもできます。このプロパティをローカルに定義した場合、グローバルなプロパティはオーバーライドされず、2つのパラメータの結合が定義されます。NSAPI、ISAPIおよびApacheプラグインWlForwardPathnullWlForwardPathが「/」に設定されている場合は、すべてのリクエストがプロキシされます。特定の文字列で始まるリクエストをプロキシするには、WlForwardPathをその文字列に設定します。Serverに転送されます。このパラメータは、パスによるプロキシを行う場合は必須です。カンマで文字列を区切ることにより、複数の文字列を設定できます。Serverの間のアクティブではない接続が閉じられるまでの時間。(Apacheプラグインを使用している場合はON)に設定する必要があります。このパラメータの値は、管理コンソールのサーバー/HTTPタブで設定される期間フィールドの値、またはKeepAliveSecs属性を使用してサーバーMBeanで設定される値以下である必要があります。Serverの間の接続のプールを有効化します。IISプラグインの有効な値は、trueおよびfalseです。Apacheプラグインの有効な値は、ONおよびOFFです。Serverに渡します。(詳細は、Apacheドキュメントを参照してください。)これは、次の場合に望ましい動作です。Serverに問合せ文字列を渡します。Serverで障害が発生した場合、その障害の発生したサーバーは「bad」とマークされ、プラグインはリスト内の次のサーバーに接続しようとします。MaxSkipsには、プラグインが「bad」とマークされたサーバーへの接続を再試行するまでの時間を設定します。プラグインは、固有のリクエスト(Cookieのないリクエスト)を受信するたびにリスト内の新しいサーバーに接続しようとします。ISAPI,、ApacheとNSAPIプラグインおよびHttpClusterServletDynamicServerListONOFFに設定すると、プラグインからプロキシされるリクエストをロード・バランシングするために使用される動的クラスタ・リストが無視され、WebLogicClusterパラメータで指定された静的リストのみが使用されます。通常、このパラメータはONのままにします。このパラメータをOFFに設定すると、いくつかの影響があります。静的リストの1つまたは複数のサーバーで障害が発生した場合、プラグインは応答不能のサーバーへの接続に時間を費やし、その結果としてパフォーマンスが低下する可能性があります。クラスタに新しいサーバーを追加した場合は、このパラメータを再定義するまでプラグインはその新しいサーバーにリクエストをプロキシできません。Serverは、新しいサーバーがクラスタに追加されたときに動的サーバー・リストにその新しいサーバーを自動的に追加します。Server間のSSL通信を維持する場合は、このパラメータをONに設定します。HTTPクライアント・リクエストがHTTPSプロトコルを指定しています。Serverプロキシ・プラグインを含む)を経由して渡されました。Server間の接続でHTTPプロトコルを使用しています。Serverからクライアントに戻されるロケーション・ヘッダーではHTTPSプロトコルが指定されます。NSAPI、ISAPIとApacheプラグインおよびHttpClusterServletとHttpProxyServletWLProxyPassThroughOFFプロキシ・プラグインまたはHttpClusterServletが一部の他のプロキシまたはロード・バランサで稼働中の連鎖プロキシ設定がある場合、WLProxyPassThroughパラメータを明示的に有効化する必要があります。このパラメータを有効化すると、ネットワークが信頼できるためユーザー証明書などが受渡し可能であると仮定して、プラグインはそのプロキシを信頼するようになります。Serverインスタンスに接続する場合のバインド先の(プラグインのシステム上の)IPアドレスを定義します。WLLocalIPを設定しない場合、マルチホーム・マシンで任意のIPアドレスが使用されます。NSAPI、ISAPIおよびApacheプラグインWLSendHdrSeparatelyONこのパラメータをONに設定すると、ヘッダーおよびレスポンスの本文が別々のパケットで送信されます。ヘッダーとレスポンスの本文を2つのコールで送信する必要がある場合、たとえば、他のISAPIフィルタまたは本文の前にヘッダーがあることを期待するクライアントを持つ場合、このパラメータをONに設定します。Serverに転送されます。これにより、フェイルオーバーの間もPOSTデータが保持されます。UNIXでは、POSTファイルが/tmp/_wl_proxyにあります。Windowsでは、このファイルの場所は次にあります(WLTempDirを指定していない場合)。Serverのユーザーが所有する固定ディレクトリです。Serverが存在する場合があります。この状況により、次のようなエラーが発生します。bytesこの問題を解決するには、WLTempDirパラメータを使用して、POSTデータ・ファイルの_wl_proxyに対して別の場所を指定します。Serverプロキシ・プラグインで使用できません。Serverとプラグインの間でSSL通信を行えます。Serverプロキシ・プラグインで使用できません。Webサーバー・プラグインのSSLパラメータを表7-2に示します。パラメータでは大文字/小文字が区別されます。CA証明書が含まれている証明書チェーンが拒否されないSSL証明書検証に関して存在していたセキュリティ・ホールを修復します。このパラメータによって、有効なCA証明書をルートとし、無効な中間CA証明書を含む証明書チェーンが信頼性を持つことができました。CA証明書は、CAであり、かつクリティカルな拡張としてマークされているBasicConstraints拡張を含む必要があります。この確認は、中間CA証明書に見せかけた非CA証明書から保護します。適用レベルは次のとおりです。OFFこのレベルは、適用を完全に無効にするので、お薦めしません。市販のCA証明書のほとんどは、デフォルト設定のSTRONGで動作します。EnforceBasicConstraints=offEnforceBasicConstraints=falseSTRONGデフォルト値。CA証明書に関するBasicConstraintsがチェックされ、証明書がCA証明書であるかどうかが検証されます。2459が厳格に適用されます。2459に準拠しておらず、BasicConstraintsを「クリティカル」としてマークしていないためです。2459に厳格に準拠する場合は、これを設定します。Server間のすべての通信でSSLプロトコルの使用が有効になります。ServerのポートをSSLプロトコル用に構成しておく必要があります。このパラメータは、メイン・サーバー用の構成と仮想ホスト用の構成(仮想ホストが定義されている場合)の2つのレベルで設定できます。仮想ホスト用の構成でこの設定がオーバーライドされない場合、仮想ホスト用の構成はメイン・サーバー用の構成からSSLの構成を継承します。ISAPI、NSAPIとApacheのプラグイン、HttpClusterServletおよびHttpProxyServletTrustedCAFileなしプラグインに対する信頼性のある認証局によるデジタル証明書が含まれるファイルの名前。SecureProxyパラメータがONに設定されている場合はこのパラメータが必須です。Serverのデジタル証明書のサブジェクト識別名フィールドに一致する必要があるかどうかを指定します。プラグインでSecureProxy=ONおよびRequireSSLHostMatch=trueを設定する場合、ListenAddressプロパティに指定する値を、証明書に指定したホスト名の値と一致させる必要があります。ServerのExternalDNSNameプロパティを使用し、プラグインでSecureProxy=ONおよびRequireSSLHostMatch=trueを設定する場合、ExternalDNSNameプロパティに指定する値を、証明書に指定したホスト名の値と厳密に一致させる必要があります。(OID)を指定します。このパラメータのデフォルト値は、サブジェクト識別名のCommonNameフィールドに対応します。一般的なOID値は次のとおりです。Unit-30Organization-29Locality-26ISAPI、NSAPIおよびApacheのプラグインKeyStoreなし汎用プロキシ・サーブレットで双方向SSLを使用してユーザー定義のID証明書とキーを作成する際に指定するWebアプリケーションのキーストアの場所。HttpClusterServletおよびHttpProxyServletのみに適用KeyStoreTypeなし汎用プロキシ・サーブレットで双方向SSLを使用する際に指定するキーストアのタイプ。定義されていない場合、デフォルトのタイプが使用されます。HttpClusterServletおよびHttpProxyServletのみに適用PrivateKeyAliasなし汎用プロキシ・サーブレットで双方向SSLを使用する際に指定する秘密鍵の別名。HttpClusterServletおよびHttpProxyServletのみに適用KeyStorePasswordPropertiesなしWebアプリケーション内のプロパティ・ファイル。汎用プロキシ・サーブレットで双方向SSLを使用する際に、キーストアおよび秘密鍵の別名にアクセスするための暗号化されたパスワードを定義します。このファイルは次のような内容を持ちます。パスワードを暗号化するには、weblogic.security.Encryptコマンド・ライン・ユーティリティを使用する必要があります。Javaユーティリティの使用に関する項を参照してください。reserved.法律上の注意点ライブラリ。