CCI SSL のトレース オプション

SSL 接続エラーは診断が難しい場合があります。SSL セッションのネゴシエーション シーケンス中に発生した接続エラーの詳細な理由を提供するために、トレース機能が追加されました。

CCI SSL トレースは、ctf.cfg ファイルまたは cci.ini ファイル (あるいはその両方) の構成という 2 つの方法で有効にすることができます。CTF で SSL トレースを有効にした場合、SSL トレース出力は ctf.cfg で構成した出力ファイルに書き込まれます。cci.ini ファイルで SSL トレースを構成した場合、SSL トレース出力は cci.ini ファイルで指定したファイルに書き込まれます。

ctf.cfg ファイルでの SSL トレースの有効化

CTF で CCI SSL トレースを有効にするには、最初に CTF トレースを有効にしてから、CCI コンポーネントをトレースするように ctf.cfg 構成ファイルを編集する必要があります。

mftrace.level.mf.cci = info

その後、ctf.cfg ファイルで TLS トレース オプションを指定します。オプションは次のとおりです。

mftrace.comp.mf.CCI.TCP#ssl_cipher=true|false
ネゴシエートされた暗号を表示します。
mftrace.comp.mf.CCI.TCP#ssl_cert=true|false
ピア証明書がある場合は、その詳細を表示します。
mftrace.comp.mf.CCI.TCP#ssl_fail_report=true|false

証明書の検証に失敗した理由を表示します。

mftrace.comp.mf.CCI.TCP#ssl_cert_connection_details=true|false
提供された証明書に関して利用可能なすべての情報を表示します。
mftrace.comp.mf.CCI.TCP#ssl_options_all=true|false
上記の SSL オプションをすべてオンまたはオフに切り替えます。

次の ctf.cfg ファイルの構成例では、すべての CCI SSL トレース オプションが有効になります。

mftrace.level.mf.cci                              = debug
mftrace.comp.mf.CCI.TCP#ssl_options_all           = true

次の ctf.cfg ファイルの構成例では、暗号および接続の詳細のみが有効になります。

mftrace.level.mf.cci                                  = debug
mftrace.comp.mf.CCI.TCP#ssl_cipher                    = true
mftrace.comp.mf.CCI.TCP#ssl_cert_connection_details   = true
mftrace.comp.mf.CCI.TCP#ssl_cert                      = false
mftrace.comp.mf.CCI.TCP#ssl_fail_report               = false

CCI.ini ファイルでの SSL トレースの有効化

SSL トレースは、CCI 構成ファイル cci.ini[ccitrace-base] セクションを構成して有効にすることもできます。オプションは次のとおりです。

ssl_display_cipher=yes|no
ネゴシエートされた暗号を表示します。
ssl_display_cert=yes|no
ピア証明書がある場合は、その詳細を表示します。
ssl_display_cert_fail_report=yes|no
証明書の内容が信頼テストに失敗した理由を表示します。
ssl_display_cert_connection_details=yes|no
提供された証明書に関して利用可能なすべての詳細を表示します。
ssl_display_options_on=yes|no
上記の SSL オプションをすべてオンまたはオフに切り替えます。
ssl_display_destination=file path
トレース出力の書き込み先となるファイルのパスを指定します。
注: file path には、SSL トレース出力が書き込まれるファイルのパスを指定します。たとえば、C:\path\to\sslout.txt です。ファイルが指定されていない場合は、代わりに stderr に SSL トレース出力が書き込まれます。

次の cci.ini ファイルの構成例では、すべての CCI SSL トレース オプションが有効になります。

[ccitrace-base]
ssl_display_options_on=yes
ssl_display_destination=C:\path\to\sslout.txt

次の cci.ini ファイルの構成例では、暗号および接続の詳細のみが有効になります。

[ccitrace-base]
ssl_display_cipher=yes
ssl_display_cert=no
ssl_display_cert_fail_report=no
ssl_display_cert_connection_details=yes
ssl_display_destination=C:\path\to\sslout.txt