(Unicode C) HTTPS Server Certificate Require Hostname Match

See more HTTP Examples

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat C/C++ Library Downloads
MS Visual C/C++ C++ Builder Linux C/C++ Alpine Linux C/C++	MacOS C/C++ iOS C/C++ Android C/C++ MinGW C/C++

#include <C_CkHttpW.h>

void ChilkatSample(void)
    {
    HCkHttpW http;
    const wchar_t *html;

    // The RequireHostnameMatch property was added in Chilkat v11.0.0
    // to ensure the URL's hostname matches at least one of the server certificate SAN's (Subject Alternative Names)
    // 
    // In actuality, it is the SNI hostname that must match.  If the SNI hostname is not explicitly set,
    // then Chilkat uses the hostname from the URL as the SNI hostname.

    // Here's an example using chilkatsoft.com
    // The SSL server certificate for chilkatsoft.com has 2 Subject Alternative Names:
    // 
    // 1) DNS Name: *.chilkatsoft.com
    // 2) DNS Name: chilkatsoft.com
    // 
    // See Explaining the SNI Hostname in TLS

    http = CkHttpW_Create();

    CkHttpW_putRequireHostnameMatch(http,TRUE);

    // This should succeed because "www.chilkatsoft.com" matches the SAN entry "*.chilkatsoft.com"
    html = CkHttpW_quickGetStr(http,L"https://www.chilkatsoft.com/helloWorld.html");
    wprintf(L"1) Succeeded: %d\n",CkHttpW_getLastMethodSuccess(http));

    // At the time of writing this example, the IP address for chilkatsoft.com is 3.101.18.47
    // If we send the request using the IP address, it will fail because the IP address is does 
    // not match any of the SAN entries in the server certificate.
    html = CkHttpW_quickGetStr(http,L"https://3.101.18.47/helloWorld.html");
    wprintf(L"2) Succeeded: %d\n",CkHttpW_getLastMethodSuccess(http));

    // However, it will succeed if we explicitly set the SNI hostname.
    CkHttpW_putSniHostname(http,L"www.chilkatsoft.com");
    html = CkHttpW_quickGetStr(http,L"https://3.101.18.47/helloWorld.html");
    wprintf(L"3) Succeeded: %d\n",CkHttpW_getLastMethodSuccess(http));

    // Remove our explicit SNI hostname.
    CkHttpW_putSniHostname(http,L"");

    // Now let's try wrong.host.badssl.com
    // The SSL server certificate for badssl.com has 2 Subject Alternative Names:
    // 
    // 1) DNS Name: *.badssl.com
    // 2) DNS Name: badssl.com

    // The domain wrong.host.badssl.com will fail the RequireHostnameMatch because
    // the wildcarded domain SAN entry only extends 1 level deep.  
    html = CkHttpW_quickGetStr(http,L"https://wrong.host.badssl.com/");
    wprintf(L"4) Succeeded: %d\n",CkHttpW_getLastMethodSuccess(http));

    // The expected output is:
    // 1) Succeeded: True
    // 2) Succeeded: False
    // 3) Succeeded: True
    // 4) Succeeded: False


    CkHttpW_Dispose(http);

    }