SSL certificate verify failed

一言でいうと（このエラーが何を意味するか）

SSL certificate verify failed（Python なら CERTIFICATE_VERIFY_FAILED、curl なら SSL certificate problem）は、TLS ハンドシェイク中にクライアントがサーバーから受け取った証明書を信頼できると確認できなかったことを示します。暗号化そのものは動いており、詰まっているのは相手が本物かを確かめる認証の段階です。

クライアントは受け取った証明書（リーフ）から、それを署名した中間CA、さらに上位のルートCAへと証明書チェーンをたどり、末端が自分の信頼ストアにあるルートCAに届くことを検証します。加えて有効期限内であること、CN／SAN が接続先ホスト名と一致すること、失効していないことを確認します。どれか1つでも崩れると検証は失敗し、TLS は中断されます。つまりこのエラーは「通信できない」ではなく「安全だと保証できないので止めた」という防御の作動です。

横にスクロール

よくある原因（複数を具体的に、頻度順）

実務で最も多いのは中間CA欠落です。ブラウザは AIA 拡張から中間CAを補完できる場合があるため「ブラウザでは開けるのに curl やアプリだと失敗する」という食い違いが起きやすく、サーバー設定不備が見逃されがちです。次点が更新漏れによる期限切れで、証明書は放置すれば必ず切れます。ホスト名不一致は www 有無、ワイルドカードの階層（*.example.com は a.b.example.com に一致しない）、IPアドレス直接接続で頻発します。

診断の手順（切り分け方・見るべきログ／コマンド）

まず openssl s_client でサーバーが実際に送っている証明書チェーンを見ます。ここが出発点です。

# -showcerts でチェーン全体、SNI 明示のため -servername を必ず付ける
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

出力末尾の Verify return code を確認します。0 (ok) なら OpenSSL 的には検証成功で、失敗するのは呼び出し側（後述の言語ランタイム）の信頼ストアが原因です。20 (unable to get local issuer certificate) は中間CA欠落かローカルのルート不足、10 は期限切れ、18 (self-signed certificate) はリーフが自己署名、21 (unable to verify the first certificate) は中間CA欠落などでリーフの署名を検証できない状態を意味します。

次にチェーンの中身と有効期限を個別に確認します。

# サーバーが提示した各証明書の subject / issuer / 期限を一覧化
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

各証明書の issuer が次の証明書の subject と鎖のように繋がり、最後がルートCAに届いていればチェーンは完全です。途中で途切れていれば中間CA欠落が確定します。SAN 一覧に接続先 FQDN が無ければホスト名不一致です。

言語ランタイム由来かの切り分けも重要です。OpenSSL では通るのに Python だけ失敗する場合、多くは信頼ストアの参照先が違います。

# Python が実際に参照している CA バンドルの場所を確認
python -c "import ssl; print(ssl.get_default_verify_paths())"

時刻ずれは date で端末時計を確認します。証明書の notBefore より前、あるいは notAfter より後に時計がずれていれば、有効な証明書でも「まだ有効でない／期限切れ」と判定されます。コンテナや組み込み機器、長期停止していた端末で起こりがちです。

解決と予防（対処と再発防止）

原因別の対処は次の通りです。サーバー側の不備はサーバーで直すのが原則で、全クライアントに手を入れる回避策より根本的です。

中間CA欠落の修正はサーバーへのフルチェーン配信が要点です。多くの実装は、リーフ証明書の下に発行元の中間CAを連結した1ファイル（末尾がルート直下の中間CAまで）を読み込ませればチェーンが完成します。

Python アプリで信頼ストアが古い・見つからない場合は、標準的な CA バンドルを明示するのが確実です。

import certifi, ssl, urllib.request
ctx = ssl.create_default_context(cafile=certifi.where())
urllib.request.urlopen("https://example.com", context=ctx)

再発防止の軸は自動化です。証明書は必ず切れるので、ACME による自動更新と期限監視をセットで導入し、デプロイ時に openssl s_client でチェーンが末端まで繋がるかを検査する仕組みを CI に組み込みます。TLS と PKI の基礎はセキュリティ、ハンドシェイクとSNIの仕組みはネットワーク、HTTPS 配信側の設定はWebを参照してください。