C

Create a CAdES-T Signature

See more CAdES Examples

Demonstrates how to create a signature with an external timestamp that certifies the time of signing. This requires an online TSA (Time Stamping Authority) service that is capable of producing RFC 3161 compliant timestamps.

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

C

#include <C_CkCrypt2.h>
#include <C_CkCert.h>
#include <C_CkJsonObject.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkCrypt2 crypt;
    HCkCert cert;
    const char *pfxPath;
    const char *pfxPassword;
    HCkJsonObject attrs;
    const char *inFile;
    const char *outFile;

    success = FALSE;

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

    crypt = CkCrypt2_Create();

    // This example will use a certificate + private key from a .pfx/.p12 file.
    // On Windows systems, it is also possible to use certs on smartcards/usb tokens or certs pre-installed in the Windows registry.
    cert = CkCert_Create();

    pfxPath = "qa_data/pfx/myCertAndKey.p12";
    pfxPassword = "test123";

    success = CkCert_LoadPfxFile(cert,pfxPath,pfxPassword);
    if (success != TRUE) {
        printf("%s\n",CkCert_lastErrorText(cert));
        CkCrypt2_Dispose(crypt);
        CkCert_Dispose(cert);
        return;
    }

    success = CkCrypt2_SetSigningCert(crypt,cert);

    // Use SHA-256 rather than the default of SHA-1
    CkCrypt2_putHashAlgorithm(crypt,"sha256");

    // Create JSON that tells Chilkat what signing attributes to include:
    attrs = CkJsonObject_Create();
    CkJsonObject_UpdateBool(attrs,"contentType",TRUE);
    CkJsonObject_UpdateBool(attrs,"signingTime",TRUE);
    CkJsonObject_UpdateBool(attrs,"messageDigest",TRUE);
    CkJsonObject_UpdateBool(attrs,"signingCertificateV2",TRUE);

    // A CAdES-T signature is one that includes a timestampToken created by an online TSA (time stamping authority).
    // We must include the TSA's URL, as well as a few options to indicate what is desired.
    // Except for the TSA URL, the options shown here are typically what you would need.
    CkJsonObject_UpdateBool(attrs,"timestampToken.enabled",TRUE);
    CkJsonObject_UpdateString(attrs,"timestampToken.tsaUrl","https://freetsa.org/tsr");
    CkJsonObject_UpdateBool(attrs,"timestampToken.addNonce",FALSE);
    CkJsonObject_UpdateBool(attrs,"timestampToken.requestTsaCert",TRUE);
    CkJsonObject_UpdateString(attrs,"timestampToken.hashAlg","sha256");

    CkCrypt2_putSigningAttributes(crypt,CkJsonObject_emit(attrs));

    inFile = "qa_data/json/sample.json";
    outFile = "qa_output/sample_cades_t.p7m";

    // This creates the CAdES-T signature.  During the signature creation, it
    // communicates with the TSA to get a timestampToken.
    success = CkCrypt2_CreateP7M(crypt,inFile,outFile);
    if (success != TRUE) {
        printf("%s\n",CkCrypt2_lastErrorText(crypt));
        CkCrypt2_Dispose(crypt);
        CkCert_Dispose(cert);
        CkJsonObject_Dispose(attrs);
        return;
    }

    printf("Success.\n");


    CkCrypt2_Dispose(crypt);
    CkCert_Dispose(cert);
    CkJsonObject_Dispose(attrs);

    }