TCP/IP

プロキシは HTTPS の終端か(TLS インスペクションの見分け方)

会社のプロキシを通して HTTPS の API を呼ぶとき、普通はプロキシは中身を見ずに中継するだけで、HTTPS の終端は両端(呼ぶ側と相手のサーバ)です。ただし、会社が TLS インスペクション(HTTPS の中身の検査)をしていると、プロキシが終端になります。プロキシを通るときの全体の流れは「プロキシ経由で外部 API を呼ぶときの流れ」に書いています。

素通し(普通) TLS(両端の間で暗号化されたまま) 社内のサーバ プロキシ 中継するだけ 相手のサーバ TLS インスペクション TLS①(会社の証明書) TLS②(相手の証明書) 社内のサーバ プロキシ ここで暗号をほどいて検査 相手のサーバ

2 つの違い

項目素通しTLS インスペクション
HTTPS の終端社内のサーバと相手のサーバプロキシ(両側で 2 回)
プロキシに見えるもの宛先(api.example.com:443)だけURL のパス、ヘッダ、送る中身まで
社内のサーバに届く証明書相手の本物の証明書プロキシが作った会社の証明書
呼ぶ側に必要な設定なし会社の証明書(の発行元)を信頼済みとして登録

見分け方:証明書の発行元を見る

プロキシ経由で相手の証明書を取り、最初に出る Issuer(発行元)を見ます。%{certs} は curl 7.88 以降で使えます。

Windows(PowerShell)

curl.exe -s -o NUL -x http://proxy.example.local:8080 -w "%{certs}" https://api.example.com/ | Select-String "^Issuer" | Select-Object -First 1

Linux

curl -s -o /dev/null -x http://proxy.example.local:8080 -w "%{certs}" https://api.example.com/ | grep -i "^Issuer" | head -1
発行元(Issuer)意味
DigiCert、Let’s Encrypt、Amazon、SSL.com など公的な認証局素通し
会社名、「Proxy」「Zscaler」などを含む名前TLS インスペクションあり
  • Linux の curl(OpenSSL を使うもの)は、-v でも issuer: の行が出ます。Windows の curl.exe は -v では出ないので、上の %{certs} を使います。
  • ウイルス対策ソフトの中にも、PC の中で同じことをする(HTTPS を検査する)ものがあります。その場合は、プロキシがなくても発行元がウイルス対策ソフトの名前になります。

Java で起きること

TLS インスペクションがあると、Java のプログラムで次のエラーが出ることがあります。

javax.net.ssl.SSLHandshakeException: PKIX path building failed

Java は Windows の証明書ストアではなく、自分の cacerts を見るためです。ブラウザや curl.exe では問題ないのに Java だけ失敗する、というときはたいていこれです。会社の証明書(ネットワークの担当者からもらう)を cacerts に登録します。

keytool -importcert -cacerts -alias company-proxy-ca -file company-ca.crt
  • -cacerts は Java 9 以降で使えます。Java 8 では -keystore $JAVA_HOME/jre/lib/security/cacerts と書きます。
  • パスワードを聞かれたら、初期値は changeit です。
  • Java を更新すると cacerts が置き換わり、登録が消えることがあります。更新のあとに同じエラーが出たら、登録し直します。
  • 相手の API がクライアント証明書(mTLS)を求める場合、TLS インスペクションを通すとうまくいきません。その宛先は検査の対象から外してもらう必要があります。
スポンサーリンク
タイトルとURLをコピーしました