cpp-httplib/docs-src/pages/ja/cookbook/c18-ssl-errors.md

---

title: "C18. SSLエラーをハンドリングする" order: 18

status: "draft"

HTTPSリクエストで失敗したとき、res.error()はError::SSLConnectionやError::SSLServerVerificationといった値を返します。ただ、これだけだと原因の切り分けが難しいこともあります。そんなときはResult::ssl_error()とResult::ssl_backend_error()が役に立ちます。

SSLエラーの詳細を取得する

httplib::Client cli("https://api.example.com");
auto res = cli.Get("/");

if (!res) {
  auto err = res.error();
  std::cerr << "error: " << httplib::to_string(err) << std::endl;

  if (err == httplib::Error::SSLConnection ||
      err == httplib::Error::SSLServerVerification) {
    std::cerr << "ssl_error: " << res.ssl_error() << std::endl;
    std::cerr << "ssl_backend_error: " << res.ssl_backend_error() << std::endl;
  }
}

ssl_error()はバックエンドに依存しないTLSエラーの種別で、httplib::tls::ErrorCodeをintにした値です。ssl_backend_error()にはバックエンド固有のエラー値が入ります。OpenSSLの場合、ハンドシェイクに失敗したときはERR_get_error()の値、証明書の検証に失敗したときは検証結果のコード（X509_V_ERR_*）です。

OpenSSLのエラーを文字列化する

ssl_backend_error()で取得した値は、失敗の種類に合ったOpenSSLの関数で文字列にするとデバッグに便利です。

#include <openssl/err.h>
#include <openssl/x509.h>

if (res.error() == httplib::Error::SSLConnection) {
  char buf[256];
  ERR_error_string_n(res.ssl_backend_error(), buf, sizeof(buf));
  std::cerr << "openssl: " << buf << std::endl;
} else if (res.error() == httplib::Error::SSLServerVerification ||
           res.error() == httplib::Error::SSLServerHostnameVerification) {
  auto code = static_cast<long>(res.ssl_backend_error());
  std::cerr << "openssl: " << X509_verify_cert_error_string(code) << std::endl;
}

よくある原因

症状	ありがちな原因
SSLServerVerification	CA証明書のパスが通っていない、自己署名証明書
SSLServerHostnameVerification	証明書のCN/SANとホスト名が一致しない
SSLConnection	TLSバージョンの不一致、対応スイートが無い

証明書の検証設定を変えたい場合はT02. SSL証明書の検証を制御するを参照してください。