Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Whether to verify the DOH SSL certificate's status.

Component Version macOS Windows Linux Server iOS SDK
CURL 11.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "CURL.SetOptionDOHSSLVerifyStatus"; curl; Value )   More


Parameter Description Example
curl The CURL session handle. $curl
Value The new setting.


Returns OK or error.


Whether to verify the DOH SSL certificate's status.
Pass 2 to ask curl to verify the DOH (DNS-over-HTTPS) server's certificate name fields against the host name.
This option is the DOH equivalent of CURL.SetOptionSSLVerifyHost and only affects requests to the DOH server.
When CURL.SetOptionDOHSSLVerifyHost is 2, the SSL certificate provided by the DOH server must indicate that the server name is the same as the server name to which you meant to connect to, or the connection fails.
Curl considers the DOH server the intended one when the Common Name field or a Subject Alternate Name field in the certificate matches the host name in the DOH URL to which you told Curl to connect.
When the verify value is set to 1L it is treated the same as 2L. However for consistency with the other VerifyHost options we suggest use 2 and not 1.
When the verify value is set to 0L, the connection succeeds regardless of the names used in the certificate. Use that ability with caution!

See also CURL.SetOptionDOHSSLVerifyPeer to verify the digital signature of the DOH server certificate. If libcurl is built against NSS and CURL.SetOptionDOHSSLVerifyPeer is zero, CURL.SetOptionDOHSSLVerifyHost is also set to zero and cannot be overridden.

See also DOH_SSL_VERIFYSTATUS option in CURL manual.

See also

Release notes

Blog Entries

Created 31st March 2021, last changed 31st March 2021

CURL.SetOptionDOHSSLVerifyPeer - CURL.SetOptionDOHURL