wrapper.backend.type プロパティ

対応バージョン :3.5.8
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSXLinuxAlpine LinuxIBM AIXFreeBSDSolarisIBM z/Linux

Wrapper は、Wrapper プロセスと JVM 内で実行されているクラスとの間で、常に通信を維持する必要があります。

この通信は、以下のモードを使用して設定できます。

  • AUTO:「PIPE」を使用。エラー発生時に「SOCKET」にフォールバック
  • PIPE:パイプバックエンドを使用
  • SOCKET:優先順位に従って、次のモードを使用。「SOCKET_PAIR」(Unix のみ)、次に「SOCKET_IPv4」にフォールバックし、さらに「SOCKET_IPv6」にフォールバック
  • SOCKET_PAIRWrapper ver. 3.7.0以降、Unix のみ):Unix ドメインソケットペアを使用
  • SOCKET_IPv4:IPv4 ソケットを使用
  • SOCKET_IPv6:IPv6 ソケットを使用

デフォルト値は「AUTO」です。

設定例:
wrapper.backend.type=SOCKET

警告

Unix では、Wrapper ver. 3.6.0 以降、セキュリティ向上のため、「PIPE」モードでは名前付きパイプの代わりに匿名パイプが使用されます。

パスワードなどの機密データがバックエンドチャネル経由で送信される場合(たとえば、ver. 3.5.57 で導入された [wrapper.app.property.<n>]プロパティを使用する場合)、このチャネルのセキュリティを確保することが非常に重要です。

Unix 環境で「PIPE」モードを使用している場合は、少なくともver. 3.6.0 にアップグレードすることを強くお勧めします。 詳細については、脆弱性#13 を参照してください。

WindowsUnix の両方において、ver. 3.7.0 にアップグレードすることで、バックエンド接続の全体的なセキュリティがさらに向上します。 詳細については、脆弱性#15 を参照してください。

プラットフォームごとの設定

Wrapper ver. 3.7.0 以降では、以下のプロパティを使用して、プラットフォームごとにバックエンド通信モードを設定することも可能です。

wrapper.backend.windows.type プロパティ

対応バージョン :3.7.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)Alpine Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)Solaris (未対応)IBM z/Linux (未対応)

可能な値のリスト:

  • AUTO:「PIPE」を使用。エラー発生時に「SOCKET」にフォールバック
  • PIPE:パイプバックエンドを使用
  • SOCKET:「SOCKET_IPv4」を使用。エラー発生時に「SOCKET_IPv6」にフォールバック
  • SOCKET_IPv4:IPv4 ソケットを使用
  • SOCKET_IPv6:IPv6 ソケットを使用

デフォルトでは、[wrapper.backend.type]プロパティの値が使用されます。

設定例:
wrapper.backend.windows.type=PIPE

wrapper.backend.unix.type プロパティ

対応バージョン :3.7.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :Windows (未対応)Mac OSXLinuxAlpine LinuxIBM AIXFreeBSDSolarisIBM z/Linux

可能な値のリスト:

  • AUTO:「PIPE」を使用。エラー発生時に「SOCKET」にフォールバック
  • PIPE:パイプバックエンドを使用
  • SOCKET:優先順位に従って、次のモードを使用。「SOCKET_PAIR」(Unix のみ)、次に「SOCKET_IPv4」にフォールバックし、さらに「SOCKET_IPv6」にフォールバック
  • SOCKET_PAIRWrapper ver. 3.7.0以降):Unix ドメインソケットペアを使用
  • SOCKET_IPv4:IPv4 ソケットを使用
  • SOCKET_IPv6:IPv6 ソケットを使用

デフォルトでは、[wrapper.backend.type]プロパティの値が使用されます。

設定例:
wrapper.backend.unix.type=SOCKET_PAIR

参照: ポート