Unicode C

Trust Specific Root CA Certificates

See more Certificates Examples

Demonstrates how to trust specific root CA certificates and none others. Unicode C

#include <C_CkTrustedRootsW.h>
#include <C_CkCertW.h>
#include <C_CkHttpW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkTrustedRootsW tRoots;
    HCkCertW caCert;
    HCkHttpW http;

    success = FALSE;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // This example will trust the Amazon root CA certificates provided at 
    // https://www.amazontrust.com/repository/

    // I've previously downloaded the root CA certificates to DER format.
    // Add each to the Chilkat TrustedRoots singleton object.

    tRoots = CkTrustedRootsW_Create();

    caCert = CkCertW_Create();
    success = CkCertW_LoadFromFile(caCert,L"qa_data/certs/aws_root_ca/AmazonRootCA1.cer");
    if (success == FALSE) {
        wprintf(L"%s\n",CkCertW_lastErrorText(caCert));
        CkTrustedRootsW_Dispose(tRoots);
        CkCertW_Dispose(caCert);
        return;
    }

    success = CkTrustedRootsW_AddCert(tRoots,caCert);

    // Continue with the others.
    // For brevity, we're not checking return values for success/failure.
    success = CkCertW_LoadFromFile(caCert,L"qa_data/certs/aws_root_ca/AmazonRootCA2.cer");
    success = CkTrustedRootsW_AddCert(tRoots,caCert);

    success = CkCertW_LoadFromFile(caCert,L"qa_data/certs/aws_root_ca/AmazonRootCA3.cer");
    success = CkTrustedRootsW_AddCert(tRoots,caCert);

    success = CkCertW_LoadFromFile(caCert,L"qa_data/certs/aws_root_ca/AmazonRootCA4.cer");
    success = CkTrustedRootsW_AddCert(tRoots,caCert);

    success = CkCertW_LoadFromFile(caCert,L"qa_data/certs/aws_root_ca/SFSRootCAG2.cer");
    success = CkTrustedRootsW_AddCert(tRoots,caCert);

    // Indicate we don't want to automatically trust the operating system's installed root CA certificates.
    // On a Windows operating system, this would be the registry-based CA certificate stores. 
    // On a Linux system, this could be /etc/ssl/certs/ca-certificates.crt, if it exists.
    CkTrustedRootsW_putTrustSystemCaRoots(tRoots,FALSE);

    // Activate the trusted roots object.
    // Once activated, all Chilkat objects that use TLS connections (HTTP, REST, Socket, MailMan, IMAP, FTP, etc.)
    // will fail the TLS handshake if the server certificate is not verified and rooted with one of our explicitly trusted root certificates.
    success = CkTrustedRootsW_Activate(tRoots);

    http = CkHttpW_Create();

    // Note: We also need to explicitly indicate that server certificates are to be verified.
    CkHttpW_putRequireSslCertVerify(http,TRUE);

    // For example, the following should fail because www.chilkatsoft.com's server certificate is not rooted in one of the explicitly trusted root CA certs.
    success = CkHttpW_Download(http,L"https://www.chilkatsoft.com/helloWorld.txt",L"qa_output/helloWorld.txt");
    if (success != TRUE) {
        // The above Download should fail.
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));

        // There should be a message in the LastErrorText indicating that we were "Unable to build certificate chain to root.."
    }

    // However, we should be able to make TLS connections to good.sca1a.amazontrust.com
    success = CkHttpW_Download(http,L"https://good.sca1a.amazontrust.com/",L"qa_output/valid.html");
    if (success != TRUE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkTrustedRootsW_Dispose(tRoots);
        CkCertW_Dispose(caCert);
        CkHttpW_Dispose(http);
        return;
    }

    // We can still examine the LastErrorText and we'll find this message within:  
    // "The public key was successfully validated against the public key of the explicitly trusted root cert."
    wprintf(L"%s\n",CkHttpW_lastErrorText(http));

    wprintf(L"Success!\n");


    CkTrustedRootsW_Dispose(tRoots);
    CkCertW_Dispose(caCert);
    CkHttpW_Dispose(http);

    }