證控制實(shí)戰(zhàn)：set_ca_cert_path 與 enable_server_*_verification 使用指南)
后端網(wǎng)絡(luò)【免費(fèi)下載鏈接】cpp-httplibA C header-only HTTP/HTTPS server and client library項(xiàng)目地址https://gitcode.com/GitHub_Trending/cp/cpp-httplib點(diǎn)擊查看免費(fèi)下載HTTPS 客戶端默認(rèn)會(huì)校驗(yàn)服務(wù)器證書cpp-httplib 通過(guò)操作系統(tǒng)根證書存儲(chǔ)區(qū)驗(yàn)證證書鏈有效性并核對(duì)證書與請(qǐng)求主機(jī)名是否匹配。本指南圍繞 docs-src/pages/ja/cookbook/t02-cert-verification.md 的技術(shù)主線完整講解指定自定義 CA 證書、徹底關(guān)閉驗(yàn)證、僅跳過(guò)主機(jī)名校驗(yàn)、使用系統(tǒng)證書存儲(chǔ)區(qū)四類場(chǎng)景的 API 用法并結(jié)合 httplib.h 的源碼實(shí)現(xiàn)與 test/test.cc 的測(cè)試用例說(shuō)明底層原理與安全邊界。讀完你即可為自己的 HTTPS 客戶端精確選擇證書校驗(yàn)策略。默認(rèn)行為驗(yàn)證證書鏈與主機(jī)名在介紹控制手段之前先明確 cpp-httplib 的默認(rèn)安全姿態(tài)。源碼中客戶端兩個(gè)校驗(yàn)開關(guān)的默認(rèn)值均為開啟狀態(tài)httplib.hserver_certificate_verification_ true校驗(yàn)服務(wù)器證書鏈?zhǔn)欠裼墒苄湃?CA 簽發(fā)、是否過(guò)期等server_hostname_verification_ true校驗(yàn)證書的 CN/SAN 與請(qǐng)求主機(jī)名是否一致。只有同時(shí)通過(guò)這兩項(xiàng)檢查HTTPS 請(qǐng)求才會(huì)建立任一失敗都會(huì)返回Error::SSLServerVerification或Error::SSLServerHostnameVerification詳見 C18. SSL 錯(cuò)誤處理 中的常見原因?qū)φ毡?。指定自定義 CA 證書set_ca_cert_path當(dāng)目標(biāo)服務(wù)器的證書由內(nèi)部 CA企業(yè)/私有 CA簽發(fā)或你希望以自建 CA 信任鏈取代系統(tǒng)默認(rèn)信任源時(shí)使用set_ca_cert_path()#include httplib.h httplib::Client cli(https://internal.example.com); cli.set_ca_cert_path(/etc/ssl/certs/internal-ca.pem); auto res cli.Get(/);該方法位于 httplib.h 的ClientImpl接口中void set_ca_cert_path(const std::string ca_cert_file_path, const std::string ca_cert_dir_path std::string());第 1 個(gè)參數(shù)CA 證書文件路徑PEM 格式如/etc/ssl/certs/internal-ca.pem第 2 個(gè)參數(shù)可省略CA 證書目錄路徑用于從目錄批量加載受信任的根證書。其實(shí)現(xiàn)只是把兩個(gè)路徑保存在成員變量中httplib.h真正的加載發(fā)生在建立 TLS 會(huì)話時(shí)由 load_client_ca_config 統(tǒng)一處理文件路徑優(yōu)先其次目錄路徑最后按需加載系統(tǒng)證書。從源碼可以看出set_ca_cert_path若加載失敗會(huì)記錄后端錯(cuò)誤碼此時(shí)Client::is_valid()或請(qǐng)求返回的錯(cuò)誤信息可輔助定位參見 C18. SSL 錯(cuò)誤處理。OpenSSL 后端的進(jìn)階用法set_ca_cert_store如果你使用 OpenSSL 后端編譯時(shí)定義CPPHTTPLIB_OPENSSL_SUPPORT還可以直接傳入一個(gè)X509_STORE*指針跳過(guò)路徑加載環(huán)節(jié)#include httplib.h httplib::Client cli(https://internal.example.com); // X509_STORE* 需由調(diào)用方以 OpenSSL API 構(gòu)造如 X509_STORE_new / X509_STORE_add_cert cli.set_ca_cert_store(ca_store); auto res cli.Get(/);對(duì)應(yīng)聲明在 httplib.h 與 httplib.h其底層會(huì)調(diào)用SSL_CTX_set_cert_store將證書存儲(chǔ)區(qū)掛到 SSL 上下文上httplib.h并從代碼注釋可見該調(diào)用轉(zhuǎn)移 store 所有權(quán)。因此調(diào)用方傳入的X509_STORE*在傳給庫(kù)之后不應(yīng)再自行釋放。關(guān)閉證書鏈驗(yàn)證enable_server_certificate_verification(false)訪問(wèn)自簽名證書的開發(fā)服務(wù)器、或暫時(shí)無(wú)法取得合法證書的測(cè)試環(huán)境時(shí)可以跳過(guò)整個(gè)證書鏈校驗(yàn)#include httplib.h httplib::Client cli(https://self-signed.example.com); cli.enable_server_certificate_verification(false); auto res cli.Get(/);該開關(guān)在 httplib.h 聲明實(shí)現(xiàn)在 httplib.h即把server_certificate_verification_置為false。TLS 會(huì)話建立階段會(huì)依據(jù)該標(biāo)志決定是否執(zhí)行對(duì)端證書驗(yàn)證三個(gè)后端均如此OpenSSL 分支見 httplib.h 的SSL_CTX_set_verify(..., SSL_VERIFY_PEER, ...)wolfSSL 分支見 httplib.h。Warning絕不應(yīng)用于生產(chǎn)環(huán)境。關(guān)閉證書驗(yàn)證等于放棄對(duì)服務(wù)器身份的確認(rèn)中間人攻擊MITM可以直接插入偽造證書竊聽或篡改流量。文檔明確警告如果除了開發(fā)/測(cè)試外還需要關(guān)閉它請(qǐng)先停下來(lái)確認(rèn)自己的實(shí)現(xiàn)是否有誤原始文檔。只跳過(guò)主機(jī)名校驗(yàn)enable_server_hostname_verification(false)證書鏈合法但 CN/SAN 與請(qǐng)求主機(jī)名不匹配例如服務(wù)器 IP 直連、證書簽發(fā)給舊域名、內(nèi)網(wǎng)別名訪問(wèn)時(shí)可以保留證書鏈驗(yàn)證、僅關(guān)閉主機(jī)名核對(duì)httplib::Client cli(https://legacy.example.com); cli.enable_server_certificate_verification(true); // 證書鏈照常校驗(yàn) cli.enable_server_hostname_verification(false); // 僅跳過(guò)主機(jī)名匹配 auto res cli.Get(/);對(duì)應(yīng)聲明 httplib.h、實(shí)現(xiàn) httplib.h。由于證書本身仍會(huì)被驗(yàn)證這比完全關(guān)閉驗(yàn)證更安全但依舊不推薦在生產(chǎn)環(huán)境使用——主機(jī)名校驗(yàn)是抵御證書合法但不屬于該域名場(chǎng)景的關(guān)鍵防線。三檔校驗(yàn)策略對(duì)比策略鏈校驗(yàn)主機(jī)名校驗(yàn)適用場(chǎng)景生產(chǎn)建議默認(rèn)全開??公網(wǎng)正規(guī) HTTPS 服務(wù)強(qiáng)烈推薦僅關(guān)主機(jī)名??IP/舊域名直連不推薦全關(guān)??自簽名證書的開發(fā)/測(cè)試嚴(yán)禁使用使用系統(tǒng)證書存儲(chǔ)區(qū)默認(rèn)即可多數(shù) Linux 發(fā)行版的根證書集中存放于單一文件如/etc/ssl/certs/ca-certificates.crt或證書目錄。cpp-httplib 在啟動(dòng)/建立會(huì)話時(shí)自動(dòng)加載系統(tǒng)默認(rèn)信任源因此連接正規(guī)公網(wǎng)服務(wù)器無(wú)需任何配置。源碼 load_client_ca_config 揭示了自動(dòng)的判定規(guī)則SystemCAMode::Auto模式下僅當(dāng)沒有設(shè)置自定義 CA文件/目錄/store 均為空時(shí)才加載系統(tǒng)證書一旦顯式調(diào)用了set_ca_cert_path()等就不再疊加系統(tǒng)信任源。enable_system_ca(true)可以強(qiáng)制重新啟用系統(tǒng)證書加載httplib.h、httplib.h其枚舉SystemCAMode{Auto, Enabled, Disabled}定義于 httplib.h。OpenSSL 后端的底層實(shí)現(xiàn)調(diào)用SSL_CTX_set_default_verify_pathshttplib.h這正是 OpenSSL 讀取SSL_CERT_FILE/SSL_CERT_DIR環(huán)境變量指向的系統(tǒng)證書的標(biāo)準(zhǔn)途徑macOS 上還會(huì)嘗試從系統(tǒng)鑰匙串自動(dòng)導(dǎo)入根證書?？绾蠖艘恢滦詍bedTLS 與 wolfSSL上述所有 API 在 mbedTLS 與 wolfSSL 后端下同樣可用set_ca_cert_path、enable_server_certificate_verification、enable_server_hostname_verification均為跨后端統(tǒng)一接口。三個(gè)后端在 httplib.h 中各自實(shí)現(xiàn)了等價(jià)的load_ca_file/load_ca_dir/ 驗(yàn)證回調(diào)邏輯OpenSSLSSL_CTX_set_verify、SSL_get_verify_resulthttplib.hmbedTLSmbedtls_ssl_get_verify_resulthttplib.hwolfSSLwolfSSL_CTX_set_verify、wolfSSL_get_verify_resulthttplib.h。后端的選擇在編譯期通過(guò)宏完成CPPHTTPLIB_OPENSSL_SUPPORT、CPPHTTPLIB_MBEDTLS_SUPPORT、CPPHTTPLIB_WOLFSSL_SUPPORT詳見 T01. 選擇 TLS 后端。驗(yàn)證失敗后的排錯(cuò)入口校驗(yàn)失敗并不總是路徑?jīng)]配一種原因。以下癥狀對(duì)照來(lái)自 C18. SSL 錯(cuò)誤處理與本節(jié)配置 API 直接相關(guān)癥狀常見原因SSLServerVerificationCA 路徑未配置或證書為自簽名SSLServerHostnameVerification證書 CN/SAN 與主機(jī)名不匹配SSLConnectionTLS 版本不匹配、無(wú)共同密碼套件調(diào)試時(shí)可用Result::ssl_error()與Result::ssl_backend_error()獲取更細(xì)粒度錯(cuò)誤碼OpenSSL 后端下ssl_backend_error()對(duì)應(yīng)ERR_get_error()返回值可用ERR_error_string_n轉(zhuǎn)成可讀文本。若你的客戶端使用 WebSocketwss://TLS 配置入口見 W05. wss 連接的 TLS 配置。與測(cè)試用例互相印證倉(cāng)庫(kù)的單元測(cè)試覆蓋了本節(jié)全部 API 的實(shí)際行為可作為運(yùn)行驗(yàn)證參考test/test.cc大量用例以cli.enable_server_certificate_verification(false)連接自簽名測(cè)試服務(wù)器驗(yàn)證關(guān)閉鏈校驗(yàn)后可建立連接如 test/test.cc 附近正向用例同時(shí)開啟證書與主機(jī)名校驗(yàn)并指定 CA 文件驗(yàn)證嚴(yán)格模式如 test/test.cc 一帶也包含傳入不存在 CA 路徑如 test/test.cc 的set_ca_cert_path(hello)等失敗路徑的斷言。這些用例與官方文檔相互印證在開發(fā)/CI 環(huán)境中為測(cè)試服務(wù)器自簽證書而關(guān)閉校驗(yàn)是倉(cāng)庫(kù)本身就在采用的標(biāo)準(zhǔn)做法但生產(chǎn)代碼必須保持默認(rèn)嚴(yán)格校驗(yàn)。小結(jié)連接內(nèi)部 CA 簽發(fā)的服務(wù)器 →set_ca_cert_path(file, [dir])OpenSSL 后端可升級(jí)為set_ca_cert_store(X509_STORE*)開發(fā)/測(cè)試訪問(wèn)自簽名證書 →enable_server_certificate_verification(false)僅限非生產(chǎn)證書鏈合法但主機(jī)名不符 →enable_server_hostname_verification(false)同樣慎用于生產(chǎn)訪問(wèn)正規(guī)公網(wǎng)服務(wù) → 什么都不用配置系統(tǒng)證書存儲(chǔ)區(qū)會(huì)自動(dòng)生效所有 API 在 OpenSSL / mbedTLS / wolfSSL 三后端一致可用排錯(cuò)與錯(cuò)誤碼解讀參考 C18. SSL 錯(cuò)誤處理。贊分享后端網(wǎng)絡(luò)【免費(fèi)下載鏈接】cpp-httplibA C header-only HTTP/HTTPS server and client library項(xiàng)目地址https://gitcode.com/GitHub_Trending/cp/cpp-httplib點(diǎn)擊查看免費(fèi)下載相關(guān)推薦cpp-httplib 的 wss:// WebSocket TLS 配置指南證書驗(yàn)證與 mTLS 客戶端實(shí)戰(zhàn)cpp httplib 的 wss:// WebSocket TLS 配置指南證書驗(yàn)證與 mTLS 客戶端實(shí)戰(zhàn) cpp httplib 的 httplib::后端網(wǎng)絡(luò)Podman 容器偽終端詳解--tty / -t 參數(shù)的語(yǔ)義、實(shí)現(xiàn)與實(shí)戰(zhàn)注意事項(xiàng)Podman 容器偽終端詳解 tty / t 參數(shù)的語(yǔ)義、實(shí)現(xiàn)與實(shí)戰(zhàn)注意事項(xiàng) 本篇指南圍繞 Podman 的 tty 短選項(xiàng) t 參數(shù)展開系統(tǒng)講解該參數(shù)后端網(wǎng)絡(luò)cpp-httplib HTTPS 服務(wù)端實(shí)戰(zhàn)從自簽名證書到 SSLServer 客戶端驗(yàn)證cpp httplib HTTPS 服務(wù)端實(shí)戰(zhàn)從自簽名證書到 SSLServer 客戶端驗(yàn)證 導(dǎo)讀 本篇是 cpp httplib 官方 Tour 系列的第后端網(wǎng)絡(luò)創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 cpp-httplib 證書驗(yàn)證控制實(shí)戰(zhàn)：set_ca_cert_path 與 enable_server_*_verification 使用指南
后端網(wǎng)絡(luò)【免費(fèi)下載鏈接】cpp-httplibA C header-only HTTP/HTTPS server and client library項(xiàng)目地址https://gitcode.com/GitHub_Trending/cp/cpp-httplib點(diǎn)擊查看免費(fèi)下載HTTPS 客戶端默認(rèn)會(huì)校驗(yàn)服務(wù)器證書cpp-httplib 通過(guò)操作系統(tǒng)根證書存儲(chǔ)區(qū)驗(yàn)證證書鏈有效性并核對(duì)證書與請(qǐng)求主機(jī)名是否匹配。本指南圍繞 docs-src/pages/ja/cookbook/t02-cert-verification.md 的技術(shù)主線完整講解指定自定義 CA 證書、徹底關(guān)閉驗(yàn)證、僅跳過(guò)主機(jī)名校驗(yàn)、使用系統(tǒng)證書存儲(chǔ)區(qū)四類場(chǎng)景的 API 用法并結(jié)合 httplib.h 的源碼實(shí)現(xiàn)與 test/test.cc 的測(cè)試用例說(shuō)明底層原理與安全邊界。讀完你即可為自己的 HTTPS 客戶端精確選擇證書校驗(yàn)策略。默認(rèn)行為驗(yàn)證證書鏈與主機(jī)名在介紹控制手段之前先明確 cpp-httplib 的默認(rèn)安全姿態(tài)。源碼中客戶端兩個(gè)校驗(yàn)開關(guān)的默認(rèn)值均為開啟狀態(tài)httplib.hserver_certificate_verification_ true校驗(yàn)服務(wù)器證書鏈?zhǔn)欠裼墒苄湃?CA 簽發(fā)、是否過(guò)期等server_hostname_verification_ true校驗(yàn)證書的 CN/SAN 與請(qǐng)求主機(jī)名是否一致。只有同時(shí)通過(guò)這兩項(xiàng)檢查HTTPS 請(qǐng)求才會(huì)建立任一失敗都會(huì)返回Error::SSLServerVerification或Error::SSLServerHostnameVerification詳見 C18. SSL 錯(cuò)誤處理 中的常見原因?qū)φ毡?。指定自定義 CA 證書set_ca_cert_path當(dāng)目標(biāo)服務(wù)器的證書由內(nèi)部 CA企業(yè)/私有 CA簽發(fā)或你希望以自建 CA 信任鏈取代系統(tǒng)默認(rèn)信任源時(shí)使用set_ca_cert_path()#include httplib.h httplib::Client cli(https://internal.example.com); cli.set_ca_cert_path(/etc/ssl/certs/internal-ca.pem); auto res cli.Get(/);該方法位于 httplib.h 的ClientImpl接口中void set_ca_cert_path(const std::string ca_cert_file_path, const std::string ca_cert_dir_path std::string());第 1 個(gè)參數(shù)CA 證書文件路徑PEM 格式如/etc/ssl/certs/internal-ca.pem第 2 個(gè)參數(shù)可省略CA 證書目錄路徑用于從目錄批量加載受信任的根證書。其實(shí)現(xiàn)只是把兩個(gè)路徑保存在成員變量中httplib.h真正的加載發(fā)生在建立 TLS 會(huì)話時(shí)由 load_client_ca_config 統(tǒng)一處理文件路徑優(yōu)先其次目錄路徑最后按需加載系統(tǒng)證書。從源碼可以看出set_ca_cert_path若加載失敗會(huì)記錄后端錯(cuò)誤碼此時(shí)Client::is_valid()或請(qǐng)求返回的錯(cuò)誤信息可輔助定位參見 C18. SSL 錯(cuò)誤處理。OpenSSL 后端的進(jìn)階用法set_ca_cert_store如果你使用 OpenSSL 后端編譯時(shí)定義CPPHTTPLIB_OPENSSL_SUPPORT還可以直接傳入一個(gè)X509_STORE*指針跳過(guò)路徑加載環(huán)節(jié)#include httplib.h httplib::Client cli(https://internal.example.com); // X509_STORE* 需由調(diào)用方以 OpenSSL API 構(gòu)造如 X509_STORE_new / X509_STORE_add_cert cli.set_ca_cert_store(ca_store); auto res cli.Get(/);對(duì)應(yīng)聲明在 httplib.h 與 httplib.h其底層會(huì)調(diào)用SSL_CTX_set_cert_store將證書存儲(chǔ)區(qū)掛到 SSL 上下文上httplib.h并從代碼注釋可見該調(diào)用轉(zhuǎn)移 store 所有權(quán)。因此調(diào)用方傳入的X509_STORE*在傳給庫(kù)之后不應(yīng)再自行釋放。關(guān)閉證書鏈驗(yàn)證enable_server_certificate_verification(false)訪問(wèn)自簽名證書的開發(fā)服務(wù)器、或暫時(shí)無(wú)法取得合法證書的測(cè)試環(huán)境時(shí)可以跳過(guò)整個(gè)證書鏈校驗(yàn)#include httplib.h httplib::Client cli(https://self-signed.example.com); cli.enable_server_certificate_verification(false); auto res cli.Get(/);該開關(guān)在 httplib.h 聲明實(shí)現(xiàn)在 httplib.h即把server_certificate_verification_置為false。TLS 會(huì)話建立階段會(huì)依據(jù)該標(biāo)志決定是否執(zhí)行對(duì)端證書驗(yàn)證三個(gè)后端均如此OpenSSL 分支見 httplib.h 的SSL_CTX_set_verify(..., SSL_VERIFY_PEER, ...)wolfSSL 分支見 httplib.h。Warning絕不應(yīng)用于生產(chǎn)環(huán)境。關(guān)閉證書驗(yàn)證等于放棄對(duì)服務(wù)器身份的確認(rèn)中間人攻擊MITM可以直接插入偽造證書竊聽或篡改流量。文檔明確警告如果除了開發(fā)/測(cè)試外還需要關(guān)閉它請(qǐng)先停下來(lái)確認(rèn)自己的實(shí)現(xiàn)是否有誤原始文檔。只跳過(guò)主機(jī)名校驗(yàn)enable_server_hostname_verification(false)證書鏈合法但 CN/SAN 與請(qǐng)求主機(jī)名不匹配例如服務(wù)器 IP 直連、證書簽發(fā)給舊域名、內(nèi)網(wǎng)別名訪問(wèn)時(shí)可以保留證書鏈驗(yàn)證、僅關(guān)閉主機(jī)名核對(duì)httplib::Client cli(https://legacy.example.com); cli.enable_server_certificate_verification(true); // 證書鏈照常校驗(yàn) cli.enable_server_hostname_verification(false); // 僅跳過(guò)主機(jī)名匹配 auto res cli.Get(/);對(duì)應(yīng)聲明 httplib.h、實(shí)現(xiàn) httplib.h。由于證書本身仍會(huì)被驗(yàn)證這比完全關(guān)閉驗(yàn)證更安全但依舊不推薦在生產(chǎn)環(huán)境使用——主機(jī)名校驗(yàn)是抵御證書合法但不屬于該域名場(chǎng)景的關(guān)鍵防線。三檔校驗(yàn)策略對(duì)比策略鏈校驗(yàn)主機(jī)名校驗(yàn)適用場(chǎng)景生產(chǎn)建議默認(rèn)全開??公網(wǎng)正規(guī) HTTPS 服務(wù)強(qiáng)烈推薦僅關(guān)主機(jī)名??IP/舊域名直連不推薦全關(guān)??自簽名證書的開發(fā)/測(cè)試嚴(yán)禁使用使用系統(tǒng)證書存儲(chǔ)區(qū)默認(rèn)即可多數(shù) Linux 發(fā)行版的根證書集中存放于單一文件如/etc/ssl/certs/ca-certificates.crt或證書目錄。cpp-httplib 在啟動(dòng)/建立會(huì)話時(shí)自動(dòng)加載系統(tǒng)默認(rèn)信任源因此連接正規(guī)公網(wǎng)服務(wù)器無(wú)需任何配置。源碼 load_client_ca_config 揭示了自動(dòng)的判定規(guī)則SystemCAMode::Auto模式下僅當(dāng)沒有設(shè)置自定義 CA文件/目錄/store 均為空時(shí)才加載系統(tǒng)證書一旦顯式調(diào)用了set_ca_cert_path()等就不再疊加系統(tǒng)信任源。enable_system_ca(true)可以強(qiáng)制重新啟用系統(tǒng)證書加載httplib.h、httplib.h其枚舉SystemCAMode{Auto, Enabled, Disabled}定義于 httplib.h。OpenSSL 后端的底層實(shí)現(xiàn)調(diào)用SSL_CTX_set_default_verify_pathshttplib.h這正是 OpenSSL 讀取SSL_CERT_FILE/SSL_CERT_DIR環(huán)境變量指向的系統(tǒng)證書的標(biāo)準(zhǔn)途徑macOS 上還會(huì)嘗試從系統(tǒng)鑰匙串自動(dòng)導(dǎo)入根證書?？绾蠖艘恢滦詍bedTLS 與 wolfSSL上述所有 API 在 mbedTLS 與 wolfSSL 后端下同樣可用set_ca_cert_path、enable_server_certificate_verification、enable_server_hostname_verification均為跨后端統(tǒng)一接口。三個(gè)后端在 httplib.h 中各自實(shí)現(xiàn)了等價(jià)的load_ca_file/load_ca_dir/ 驗(yàn)證回調(diào)邏輯OpenSSLSSL_CTX_set_verify、SSL_get_verify_resulthttplib.hmbedTLSmbedtls_ssl_get_verify_resulthttplib.hwolfSSLwolfSSL_CTX_set_verify、wolfSSL_get_verify_resulthttplib.h。后端的選擇在編譯期通過(guò)宏完成CPPHTTPLIB_OPENSSL_SUPPORT、CPPHTTPLIB_MBEDTLS_SUPPORT、CPPHTTPLIB_WOLFSSL_SUPPORT詳見 T01. 選擇 TLS 后端。驗(yàn)證失敗后的排錯(cuò)入口校驗(yàn)失敗并不總是路徑?jīng)]配一種原因。以下癥狀對(duì)照來(lái)自 C18. SSL 錯(cuò)誤處理與本節(jié)配置 API 直接相關(guān)癥狀常見原因SSLServerVerificationCA 路徑未配置或證書為自簽名SSLServerHostnameVerification證書 CN/SAN 與主機(jī)名不匹配SSLConnectionTLS 版本不匹配、無(wú)共同密碼套件調(diào)試時(shí)可用Result::ssl_error()與Result::ssl_backend_error()獲取更細(xì)粒度錯(cuò)誤碼OpenSSL 后端下ssl_backend_error()對(duì)應(yīng)ERR_get_error()返回值可用ERR_error_string_n轉(zhuǎn)成可讀文本。若你的客戶端使用 WebSocketwss://TLS 配置入口見 W05. wss 連接的 TLS 配置。與測(cè)試用例互相印證倉(cāng)庫(kù)的單元測(cè)試覆蓋了本節(jié)全部 API 的實(shí)際行為可作為運(yùn)行驗(yàn)證參考test/test.cc大量用例以cli.enable_server_certificate_verification(false)連接自簽名測(cè)試服務(wù)器驗(yàn)證關(guān)閉鏈校驗(yàn)后可建立連接如 test/test.cc 附近正向用例同時(shí)開啟證書與主機(jī)名校驗(yàn)并指定 CA 文件驗(yàn)證嚴(yán)格模式如 test/test.cc 一帶也包含傳入不存在 CA 路徑如 test/test.cc 的set_ca_cert_path(hello)等失敗路徑的斷言。這些用例與官方文檔相互印證在開發(fā)/CI 環(huán)境中為測(cè)試服務(wù)器自簽證書而關(guān)閉校驗(yàn)是倉(cāng)庫(kù)本身就在采用的標(biāo)準(zhǔn)做法但生產(chǎn)代碼必須保持默認(rèn)嚴(yán)格校驗(yàn)。小結(jié)連接內(nèi)部 CA 簽發(fā)的服務(wù)器 →set_ca_cert_path(file, [dir])OpenSSL 后端可升級(jí)為set_ca_cert_store(X509_STORE*)開發(fā)/測(cè)試訪問(wèn)自簽名證書 →enable_server_certificate_verification(false)僅限非生產(chǎn)證書鏈合法但主機(jī)名不符 →enable_server_hostname_verification(false)同樣慎用于生產(chǎn)訪問(wèn)正規(guī)公網(wǎng)服務(wù) → 什么都不用配置系統(tǒng)證書存儲(chǔ)區(qū)會(huì)自動(dòng)生效所有 API 在 OpenSSL / mbedTLS / wolfSSL 三后端一致可用排錯(cuò)與錯(cuò)誤碼解讀參考 C18. SSL 錯(cuò)誤處理。贊分享后端網(wǎng)絡(luò)【免費(fèi)下載鏈接】cpp-httplibA C header-only HTTP/HTTPS server and client library項(xiàng)目地址https://gitcode.com/GitHub_Trending/cp/cpp-httplib點(diǎn)擊查看免費(fèi)下載相關(guān)推薦cpp-httplib 的 wss:// WebSocket TLS 配置指南證書驗(yàn)證與 mTLS 客戶端實(shí)戰(zhàn)cpp httplib 的 wss:// WebSocket TLS 配置指南證書驗(yàn)證與 mTLS 客戶端實(shí)戰(zhàn) cpp httplib 的 httplib::后端網(wǎng)絡(luò)Podman 容器偽終端詳解--tty / -t 參數(shù)的語(yǔ)義、實(shí)現(xiàn)與實(shí)戰(zhàn)注意事項(xiàng)Podman 容器偽終端詳解 tty / t 參數(shù)的語(yǔ)義、實(shí)現(xiàn)與實(shí)戰(zhàn)注意事項(xiàng) 本篇指南圍繞 Podman 的 tty 短選項(xiàng) t 參數(shù)展開系統(tǒng)講解該參數(shù)后端網(wǎng)絡(luò)cpp-httplib HTTPS 服務(wù)端實(shí)戰(zhàn)從自簽名證書到 SSLServer 客戶端驗(yàn)證cpp httplib HTTPS 服務(wù)端實(shí)戰(zhàn)從自簽名證書到 SSLServer 客戶端驗(yàn)證 導(dǎo)讀 本篇是 cpp httplib 官方 Tour 系列的第后端網(wǎng)絡(luò)創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考