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 起動引数は設定例であり、その実行時の動作や出力に関する実行証拠は提供されていません。