HOWTO · Java
Java SSL デバッグ ロギングを制限する方法
今日は、Java SSL デバッグ、その重要性、さまざまなユーティリティ、および 1つのコマンドで 1つまたは複数を使用する方法について学習します。
このページの内容
Java SSL/TLS デバッグ ロギングにより、接続が失敗したときにハンドシェイク、証明書、レコードの詳細が明らかになることがあります。JVM が何をしているかを絞り込むのに役立ちますが、TLS 交換の外側にある問題を特定できない場合があります。
Java SSL デバッグ ロギングが接続のトラブルシューティングに役立つ理由
JVM の起動時にシステム プロパティ javax.net.debug を設定します。広範囲な引数 -Djavax.net.debug=ssl は SSL 関連の診断を有効にし、大量の出力を生成することがあるため、焦点を絞った調査に使用し、ログを共有する前に確認してください。詳細な接続ログには機密情報が含まれている場合があります。
引数をアプリケーションの JVM オプションに追加します。アプリケーション サーバーの場合は、その起動設定を更新してサーバーを再起動します。オプションを変更しても、すでに実行中の JVM には影響しません。
デバッグ指定子で Java SSL デバッグ ロギングを制限する
診断を絞り込むには、プロパティ値に指定子を追加します。たとえば、-Djavax.net.debug=ssl:handshake は SSL ハンドシェイクの診断を要求します。複数の指定子を使う形式は -Djavax.net.debug=ssl:handshake,record,session です。これらは代表的な形式です。サポートされる指定子、区切り文字、詳細は Java ランタイムによって異なる場合があります。オプションが認識されない場合や、期待した詳細が得られない場合は、実行している JVM のドキュメントを確認してください。
以下の指定子は、一般的な診断領域を説明しています。利用可能性と詳細の量はランタイムによって異なる場合があり、all は特に大量の出力を生成することがあります。
| デバッグ指定子 | 診断の目的 |
|---|---|
all |
サポートされる領域全体にわたる広範囲なデバッグ。 |
ssl |
SSL/TLS 関連のデバッグ。 |
record |
レコード レベルのトレース。プロトコル データを調査するときに便利です。 |
handshake |
ハンドシェイク メッセージのトレース。 |
keygen |
キー生成の詳細。 |
session |
セッションのアクティビティ。 |
defaultctx |
デフォルト SSL コンテキストの初期化。 |
sslctx |
SSL コンテキストのトレース。 |
sessioncache |
セッション キャッシュのアクティビティ。 |
keymanager |
キー マネージャーのアクティビティ。 |
trustmanager |
トラスト マネージャーのアクティビティ。 |
data |
サポートされる場合の、ハンドシェイク メッセージの 16 進データ。 |
verbose |
サポートされる場合の、より詳細なハンドシェイク メッセージ出力。 |
plaintext |
サポートされる場合の、平文のレコード データ。この出力は機密情報として扱ってください。 |
packet |
サポートされる場合の、生の SSL/TLS パケットの詳細。 |
質問に合う最も狭い指定子から始め、調査が完了したら JVM オプションを削除します。これらの JVM 起動引数は設定例であり、その実行時の動作や出力に関する実行証拠は提供されていません。