会社のプロキシを通して HTTPS の API を呼ぶとき、普通はプロキシは中身を見ずに中継するだけで、HTTPS の終端は両端(呼ぶ側と相手のサーバ)です。ただし、会社が TLS インスペクション(HTTPS の中身の検査)をしていると、プロキシが終端になります。プロキシを通るときの全体の流れは「プロキシ経由で外部 API を呼ぶときの流れ」に書いています。
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 インスペクションを通すとうまくいきません。その宛先は検査の対象から外してもらう必要があります。
