PureBasic

REST Basic Auth with Secure Strings

Demonstrates how to do REST Basic authentication using secure strings.

This example requires Chilkat v9.5.0.71 or greater.

PureBasic

IncludeFile "CkRest.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkSecureString.pb"
IncludeFile "CkCrypt2.pb"

Procedure ChilkatExample()

    success.i = 0

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

    ; Imagine we've previously saved our encrypted login and password within a JSON config file
    ; that contains this:

    ; {
    ;   "http_login": "mCrOmA7mBA7Au9RuJGb9hw==",
    ;   "http_password": "jJtiI9TgErTTpqBz9JtHBw=="
    ; }

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

    CkJsonObject::ckLoadFile(json,"qa_data/passwords/http.json")

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

    ; These are the encryption settings we previously used to encrypt the credentials within the JSON config file.
    CkCrypt2::setCkCryptAlgorithm(crypt, "aes")
    CkCrypt2::setCkCipherMode(crypt, "cbc")
    CkCrypt2::setCkKeyLength(crypt, 128)
    CkCrypt2::ckSetEncodedKey(crypt,"000102030405060708090A0B0C0D0E0F","hex")
    CkCrypt2::ckSetEncodedIV(crypt,"000102030405060708090A0B0C0D0E0F","hex")
    CkCrypt2::setCkEncodingMode(crypt, "base64")

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

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

    ; Decrypt to the secure string.  (the strings will still held in memory encrypted, but are now encrypted using
    ; a randomly generated session key.)
    CkCrypt2::ckDecryptSecureENC(crypt,CkJsonObject::ckStringOf(json,"http_login"),ssLogin)
    CkCrypt2::ckDecryptSecureENC(crypt,CkJsonObject::ckStringOf(json,"http_password"),ssPassword)

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

    ; Connect to a REST server.
    bTls.i = 1
    port.i = 443
    bAutoReconnect.i = 1
    success = CkRest::ckConnect(rest,"chilkatsoft.com",port,bTls,bAutoReconnect)

    ; Cause the "Authorization: Basic ..." header to be added to HTTP requests
    CkRest::ckSetAuthBasicSecure(rest,ssLogin,ssPassword)

    responseJson.s = CkRest::ckFullRequestNoBody(rest,"GET","/helloWorld.html")
    If CkRest::ckLastMethodSuccess(rest) <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkJsonObject::ckDispose(json)
        CkCrypt2::ckDispose(crypt)
        CkSecureString::ckDispose(ssLogin)
        CkSecureString::ckDispose(ssPassword)
        CkRest::ckDispose(rest)
        ProcedureReturn
    EndIf

    ; Show the LastRequestHeader that was sent.
    Debug CkRest::ckLastRequestHeader(rest)

    ; The LastRequestHeader looks like this:

    ; Host: chilkatsoft.com
    ; Authorization: Basic bXlIdHRwTG9naW46bXlIdHRwUGFzc3dvcmQ=


    CkJsonObject::ckDispose(json)
    CkCrypt2::ckDispose(crypt)
    CkSecureString::ckDispose(ssLogin)
    CkSecureString::ckDispose(ssPassword)
    CkRest::ckDispose(rest)


    ProcedureReturn
EndProcedure