(PureBasic) Trust Specific Root CA Certificates

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

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkTrustedRoots.pb"
IncludeFile "CkCert.pb"
IncludeFile "CkHttp.pb"

Procedure ChilkatExample()

    ; 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.i = CkTrustedRoots::ckCreate()
    If tRoots.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    caCert.i = CkCert::ckCreate()
    If caCert.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i = CkCert::ckLoadFromFile(caCert,"qa_data/certs/aws_root_ca/AmazonRootCA1.cer")
    If success = 0
        Debug CkCert::ckLastErrorText(caCert)
        CkTrustedRoots::ckDispose(tRoots)
        CkCert::ckDispose(caCert)
        ProcedureReturn
    EndIf

    success = CkTrustedRoots::ckAddCert(tRoots,caCert)

    ; Continue with the others.
    ; For brevity, we're not checking return values for success/failure.
    success = CkCert::ckLoadFromFile(caCert,"qa_data/certs/aws_root_ca/AmazonRootCA2.cer")
    success = CkTrustedRoots::ckAddCert(tRoots,caCert)

    success = CkCert::ckLoadFromFile(caCert,"qa_data/certs/aws_root_ca/AmazonRootCA3.cer")
    success = CkTrustedRoots::ckAddCert(tRoots,caCert)

    success = CkCert::ckLoadFromFile(caCert,"qa_data/certs/aws_root_ca/AmazonRootCA4.cer")
    success = CkTrustedRoots::ckAddCert(tRoots,caCert)

    success = CkCert::ckLoadFromFile(caCert,"qa_data/certs/aws_root_ca/SFSRootCAG2.cer")
    success = CkTrustedRoots::ckAddCert(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.
    CkTrustedRoots::setCkTrustSystemCaRoots(tRoots, 0)

    ; 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 = CkTrustedRoots::ckActivate(tRoots)

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Note: We also need to explicitly indicate that server certificates are to be verified.
    CkHttp::setCkRequireSslCertVerify(http, 1)

    ; 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 = CkHttp::ckDownload(http,"https://www.chilkatsoft.com/helloWorld.txt","qa_output/helloWorld.txt")
    If success <> 1
        ; The above Download should fail.
        Debug CkHttp::ckLastErrorText(http)

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

    ; However, we should be able to make TLS connections to good.sca1a.amazontrust.com
    success = CkHttp::ckDownload(http,"https://good.sca1a.amazontrust.com/","qa_output/valid.html")
    If success <> 1
        Debug CkHttp::ckLastErrorText(http)
        CkTrustedRoots::ckDispose(tRoots)
        CkCert::ckDispose(caCert)
        CkHttp::ckDispose(http)
        ProcedureReturn
    EndIf

    ; 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."
    Debug CkHttp::ckLastErrorText(http)

    Debug "Success!"


    CkTrustedRoots::ckDispose(tRoots)
    CkCert::ckDispose(caCert)
    CkHttp::ckDispose(http)


    ProcedureReturn
EndProcedure