Apache Tomcat 11 構成リファレンス

使用する実装の Java クラス名。このクラスは、org.apache.catalina.LifecycleListener インターフェースを実装する必要があります。

使用する SSLEngine の名前。off: SSL を使用しない、on: SSL を使用するが、特定の ENGINE は使用しない。

デフォルト値は on です。これはネイティブ SSL エンジンを初期化します。これは、SSLEnabled 属性を使用して APR/native コネクタで有効にする必要があります。

サポートされている SSL ハードウェアエンジンとメーカーの詳細については、OpenSSL 公式ウェブサイトを参照してください。

Tomcat Native 2.x 以降では SSL が必要なため、Tomcat Native 2.x 以降を使用している場合に SSLEngine が off に設定されていると、APR/native ライブラリは無効になります。

SSLEngine の PRNG のシードに使用されるエントロピーソース。デフォルト値は builtin です。開発システムでは、起動時間を短縮するために、これを /dev/urandom に設定することができます。

この属性の動作は、Tomcat Native が OpenSSL 1.x または OpenSSL 3.x に対してコンパイルされているかどうかによって異なります。

OpenSSL 1.x の場合: OpenSSL を FIPS モードにするように要求するには on に設定します (OpenSSL がすでに FIPS モードの場合、FIPS モードのままになります)。 OpenSSL を強制的に FIPS モードにするには enter に設定します (OpenSSL がすでに FIPS モードの場合、エラーが発生します)。 OpenSSL がすでに FIPS モードであることを要求するには require に設定します (OpenSSL がすでに FIPS モードでない場合、エラーが発生します)。

OpenSSL 3.x の場合: on、enter、require はすべて同じように動作します。 FIPS プロバイダーがデフォルトのプロバイダーである場合、それが使用されます。 FIPS プロバイダーがデフォルトのプロバイダーでない場合、エラーが発生します。

FIPS モードではFIPS 対応の OpenSSL ライブラリが必要です。この属性が off 以外に設定されている場合、SSLEngine も有効にする必要があります。

デフォルト値は off です。

この属性は、OpenSSL JSSE 実装の自動選択を制御します。デフォルトは true で、ネイティブライブラリが利用可能で、NIO または NIO2 コネクタが使用されている場合は OpenSSL が使用されます。

ルートコンテキストの場合、context/path および context/encodedPath に "/" が含まれ、context/name にバージョンがあれば、バージョン付きの "ROOT" が含まれるかどうか。

デフォルト値は true です。

java.lang.System.loadLibrary() で定義されているネイティブライブラリの名前。

java.lang.System.load() で定義されているネイティブライブラリの絶対パス。

Webアプリケーションによってトリガーされた sun.awt.AppContext.getAppContext() の呼び出しがメモリリークにならないように保護を有効にします。この保護を有効にすると、Java がヘッドレスモードで起動されない限り、グラフィカル環境が必要になることに注意してください。デフォルトは false です。

このリスナーの起動時にロードして初期化する、カンマ区切りの完全修飾クラス名のリスト。これにより、リクエスト処理中にロードされた場合にクラスローダーリークを引き起こすことがわかっているクラスを事前にロードできます。 oracle.jdbc.driver.OracleTimeoutThreadPerVM などの非 JRE クラスを参照できます。デフォルト値は空ですが、このリスナーの他の属性によって管理される他のリーク保護機能によって、特定の JRE クラスがロードされます。

java.sql.DriverManager を最初に使うと、現在のクラスローダーとその親に見える JDBC ドライバのロードがトリガーされます。 Web アプリケーションレベルのメモリリーク保護は、ほとんどの場合これを処理できますが、ここでロードをトリガーすると副作用が少なくなります。デフォルトは true です。

デフォルトのセキュリティ spi 実装の内部クラスである SeedGenerator を最初に使うと、一部のプラットフォームでスレッドが作成される可能性があります。セキュアなランダムの最初の使用のタイミングによっては、このスレッドがwebappクラスローダーに関連付けられ、メモリリークが発生する可能性があります。これを true に設定すると、シードが初期化されます。必要がない場合は、ランダムを消費しないように、デフォルトは false です。

java.net.URLConnection を使用して JAR ファイルからリソースを読み取ることで、JAR ファイルがロックされないように保護を有効にします。この保護を有効にすると、java.net.URLConnection を介して取得されたすべてのリソースに対して、デフォルトでキャッシュが無効になることに注意してください。キャッシュは、必要に応じてケースバイケースで再度有効にできます。デフォルトは true です。

OpenSSL 1.x で使用する SSLEngine の名前。

サポートされている SSL ハードウェアエンジンとメーカーの詳細については、OpenSSL 公式ウェブサイトを参照してください。

SSLEngine の PRNG のシードに使用されるエントロピーソース。デフォルト値は builtin です。開発システムでは、起動時間を短縮するために、これを /dev/urandom に設定することができます。

この属性の動作は、Tomcat Native が OpenSSL 1.x または OpenSSL 3.x に対してコンパイルされているかどうかによって異なります。

OpenSSL 1.x の場合: OpenSSL を FIPS モードにするように要求するには on に設定します (OpenSSL がすでに FIPS モードの場合、FIPS モードのままになります)。 OpenSSL を強制的に FIPS モードにするには enter に設定します (OpenSSL がすでに FIPS モードの場合、エラーが発生します)。 OpenSSL がすでに FIPS モードであることを要求するには require に設定します (OpenSSL がすでに FIPS モードでない場合、エラーが発生します)。

OpenSSL 3.x の場合: on、enter、require はすべて同じように動作します。 FIPS プロバイダーがデフォルトのプロバイダーである場合、それが使用されます。 FIPS プロバイダーがデフォルトのプロバイダーでない場合、エラーが発生します。

FIPS モードではFIPS 対応の OpenSSL ライブラリが必要です。この属性が off 以外に設定されている場合、SSLEngine も有効にする必要があります。

デフォルト値は off です。

この属性は、OpenSSL JSSE 実装の自動選択を制御します。 デフォルトは true で、FFM API が利用可能な場合は OpenSSL を使用します。

ロールマッピングプロパティファイルへのパス。プロトコル webapp: と ConfigFileLoader がサポートするものを何でも使用できます。

デフォルト値は webapp:/WEB-INF/role-mapping.properties です。

プロパティキーからフィルタリングするプレフィックス。プレフィックスを持たない他のすべてのキーは無視されます。

Tomcat の起動に使用してはならない OS ユーザーのカンマ区切りリスト。指定しない場合、root のデフォルト値が使用されます。 このチェックを無効にするには、属性を空の文字列に設定します。 ユーザー名は、大文字と小文字を区別しない方法でチェックされます。

Tomcat を起動する前に構成する必要がある最小の制限付き umask。指定しない場合、0007 のデフォルト値が使用されます。 このチェックを無効にするには、属性を空の文字列に設定します。 チェックは Windows プラットフォームでは実行されません。

この Tomcat インスタンスのビルド日とその起動日の間の日数で、警告がログに記録されるまでに許容される最大日数。このチェックを無効にするには、0 未満（例：-1）に設定します。指定しない場合、-1 のデフォルト値が使用されます。

使用する IStoreConfig 実装の名前。指定しない場合、org.apache.catalina.storeconfig.StoreConfig のデフォルトが使用されます。

IStoreConfig が構成を保存する方法を構成する構成ファイルの URL。指定しない場合、組み込みリソース /org/apache/catalina/storeconfig/server-registry.xml が使用されます。

再読み込みチェックの間隔（秒単位）。 LifecycleListener の定期的なプロセスは通常、このリスナーが必要とするよりもはるかに頻繁に実行されます。 この属性は、チェックの間隔を制御します。 指定しない場合、デフォルトの 86,400 秒（24 時間）が使用されます。

新しい証明書が所定の位置にあり、再読み込みをトリガーできると予想される、TLS 証明書の有効期限が切れるまでの日数。 指定しない場合、デフォルトの 14 日が使用されます。

各ユーザーのホームディレクトリ内で検索されるディレクトリ名。デフォルトは public_html です。

ユーザーデータベースクラスのクラス名。 現在、2つのユーザーデータベースがあります。org.apache.catalina.startup.PasswdUserDatabase は、/etc/passwd ファイルを使用して有効なユーザーを識別する Unix システムで使用されます。 org.apache.catalina.startup.HomesUserDatabase は、/etc/passwd が使用されていないサーバーで使用されます。 HomesUserDatabase は、指定されたベースディレクトリで見つかったすべてのディレクトリを展開します。

ユーザーのホームディレクトリを含むベースディレクトリ。 これは、org.apache.catalina.startup.HomesUserDatabase が使用されている場合にのみ有効です。

デプロイが許可されているユーザーを定義する正規表現。 この属性が指定されている場合、デプロイするユーザーはこのパターンに一致する必要があります。 この属性が指定されていない場合、ユーザーが拒否パターンに一致しない限り、すべてのユーザーがデプロイされます。

デプロイが拒否されているユーザーを定義する正規表現。 この属性が指定されている場合、デプロイするユーザーはこのパターンに一致してはなりません。 この属性が指定されていない場合、ユーザーのデプロイは allow 属性によって管理されます。

true の場合、Tomcat の起動時に Java に渡されたコマンドライン引数がログに記録されます。 指定しない場合、true のデフォルト値が使用されます。

true の場合、Tomcat の起動時の現在の環境変数がログに記録されます。 指定しない場合、false のデフォルト値が使用されます。

true の場合、現在の Java システムプロパティがログに記録されます。 指定しない場合、false のデフォルト値が使用されます。

HTTPDからプロキシされたトラフィックを受信するコネクタのポート。デフォルトでは、最初のコネクタが使用されます

Host は、プロキシされたトラフィックを受信するコネクタの address に対応する IP です。デフォルトでは空で、Port が使用されます

proxyURL は、ハートビートハンドラーの httpd 構成の Location に対応する URL で、デフォルトは /HeartbeatListener です

ProxyList は、Tomcat がリクエストを受信するプロキシのリストで、"address:port,address:port" のようにフォーマットされています。一度入力すると、マルチキャストロジックが無効になり、マルチパラメーターは無視されます

Group は、HTTPD にメッセージをブロードキャストするマルチキャスト IP で、デフォルトは 224.0.1.105 です

Multiport は、HTTPD にメッセージをブロードキャストするマルチキャストポートで、デフォルトは 23364 です

Ttl は、ブロードキャストメッセージの TTL で、デフォルトは 16 です