PureBasic

Create CAdES p7m using Azure Key Vault to Sign in the Cloud

See more Signing in the Cloud Examples

Demonstrates how to create a CAdES p7m, using Azure Key Vault. The signing of the hash happens in the Cloud on Azure Key Vault. Everything else regarding the creation of CAdES happens locally within Chilkat.

Note: This example requires Chilkat v9.5.0.96 or greater.

PureBasic

IncludeFile "CkCert.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkCrypt2.pb"

Procedure ChilkatExample()

    success.i = 0

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

    ; Load the certificate used for signing.  The certificate's private key is stored in 
    ; the Azure Key Vault.
    ; However, we still need the certificate locally (without private key).
    cert.i = CkCert::ckCreate()
    If cert.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkCert::ckLoadFromFile(cert,"qa_data/certs/myCert.cer")
    If success = 0
        Debug CkCert::ckLastErrorText(cert)
        CkCert::ckDispose(cert)
        ProcedureReturn
    EndIf

    ; Here's a screenshot of our certificate with private key on Azure Key Vault:
    ; (image:https://example-code.com/images/azure_key_vault.jpg/endImage)

    ; To sign using the Azure Key Vault, 
    ; add the following lines of code to specify your authentication credentials,
    ; and the name of the certificate w/ private key on the Azure server to be used.
    jsonAzure.i = CkJsonObject::ckCreate()
    If jsonAzure.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Set the "service" equal to "azure_keyvault" to tell Chilkat to use Azure Key Vault for signing.
    CkJsonObject::ckUpdateString(jsonAzure,"service","azure_keyvault")
    CkJsonObject::ckUpdateString(jsonAzure,"client_id","APP_ID")
    CkJsonObject::ckUpdateString(jsonAzure,"client_secret","APP_PASSWORD")
    CkJsonObject::ckUpdateString(jsonAzure,"tenant_id","TENANT_ID")
    ; In the above screenshot, our vault name is "kvchilkat".  You will use your vault name.
    CkJsonObject::ckUpdateString(jsonAzure,"vault_name","VAULT_NAME")
    ; In the above screenshot, our cert name is "ChilkatTest1".  You will use your cert name.
    CkJsonObject::ckUpdateString(jsonAzure,"cert_name","CERT_NAME")
    ; In the above screenshot, our cert version is "63b94a23389546ecbc8eb6208a1bef37".  You will use your cert version.
    CkJsonObject::ckUpdateString(jsonAzure,"cert_version","CERT_VERSION")
    success = CkCert::ckSetCloudSigner(cert,jsonAzure)

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

    success = CkCrypt2::ckSetSigningCert(crypt,cert)
    If success = 0
        Debug CkCrypt2::ckLastErrorText(crypt)
        CkCert::ckDispose(cert)
        CkJsonObject::ckDispose(jsonAzure)
        CkCrypt2::ckDispose(crypt)
        ProcedureReturn
    EndIf

    ; The CadesEnabled property applies to all methods that create PKCS7 signatures. 
    ; To create a CAdES-BES signature, set this property equal to true.
    CkCrypt2::setCkCadesEnabled(crypt, 1)

    CkCrypt2::setCkHashAlgorithm(crypt, "sha256")

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

    CkJsonObject::ckUpdateInt(signedAttrs,"contentType",1)
    CkJsonObject::ckUpdateInt(signedAttrs,"signingTime",1)
    CkJsonObject::ckUpdateInt(signedAttrs,"messageDigest",1)
    CkJsonObject::ckUpdateInt(signedAttrs,"signingCertificateV2",1)
    CkCrypt2::setCkSigningAttributes(crypt, CkJsonObject::ckEmit(signedAttrs))

    ; You can sign any type of file..
    inputXmlPath.s = "qa_data/e-Invoice.xml"
    outputP7mPath.s = "qa_output/signed.p7m"

    ; Create the CAdES-BES attached signature, which contains the original data.
    ; Chilkat will build the .p7m locally, but will (internally) use ARSS
    ; to do the RSA signing remotely.
    success = CkCrypt2::ckCreateP7M(crypt,inputXmlPath,outputP7mPath)
    If success = 0
        Debug CkCrypt2::ckLastErrorText(crypt)
        CkCert::ckDispose(cert)
        CkJsonObject::ckDispose(jsonAzure)
        CkCrypt2::ckDispose(crypt)
        CkJsonObject::ckDispose(signedAttrs)
        ProcedureReturn
    EndIf

    Debug "Success."


    CkCert::ckDispose(cert)
    CkJsonObject::ckDispose(jsonAzure)
    CkCrypt2::ckDispose(crypt)
    CkJsonObject::ckDispose(signedAttrs)


    ProcedureReturn
EndProcedure