Sample code for 30+ languages & platforms
C

RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify

See more HTTP Examples

Sends an RFC 3161 timestamp request to a TSA (Timestamp Authority) server and validates the timestamp token response.

Chilkat C Downloads

C
#include <C_CkCrypt2.h>
#include <C_CkHttp.h>
#include <C_CkBinData.h>
#include <C_CkHttpResponse.h>
#include <C_CkCert.h>
#include <C_CkJsonObject.h>
#include <C_CkDtObj.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkCrypt2 crypt;
    const char *base64Hash;
    HCkHttp http;
    HCkBinData requestToken;
    const char *optionalPolicyOid;
    BOOL addNonce;
    BOOL requestTsaCert;
    const char *tsaUrl;
    HCkHttpResponse resp;
    HCkBinData timestampReply;
    HCkCert tsaCert;
    int pkiStatus;
    HCkJsonObject json;
    HCkDtObj signingTime;
    HCkDtObj authAttrSigningTimeUtctime;
    const char *strVal;
    const char *certSerialNumber;
    const char *certIssuerCN;
    const char *certDigestAlgOid;
    const char *certDigestAlgName;
    const char *contentType;
    const char *messageDigest;
    const char *signingAlgOid;
    const char *signingAlgName;
    const char *authAttrContentTypeName;
    const char *authAttrContentTypeOid;
    const char *authAttrSigningTimeName;
    const char *authAttrSigningCertificateName;
    const char *authAttrSigningCertificateDer;
    const char *authAttrMessageDigestName;
    const char *authAttrMessageDigestDigest;
    int timestampReplyPkiStatusValue;
    const char *timestampReplyPkiStatusMeaning;
    int i;
    int count_i;

    success = FALSE;

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

    //  First sha-256 hash the data that is to be timestamped.
    //  In this example, the data is the string "Hello World"

    crypt = CkCrypt2_Create();
    CkCrypt2_putHashAlgorithm(crypt,"sha256");
    CkCrypt2_putEncodingMode(crypt,"base64");
    base64Hash = CkCrypt2_hashStringENC(crypt,"Hello World");

    http = CkHttp_Create();

    requestToken = CkBinData_Create();
    optionalPolicyOid = "";
    addNonce = FALSE;
    requestTsaCert = TRUE;

    //  Create a time-stamp request token
    success = CkHttp_CreateTimestampRequest(http,"sha256",base64Hash,optionalPolicyOid,addNonce,requestTsaCert,requestToken);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkCrypt2_Dispose(crypt);
        CkHttp_Dispose(http);
        CkBinData_Dispose(requestToken);
        return;
    }

    //  Send the time-stamp request token to the TSA.
    //  This is the equivalent of the following CURL command:
    //  curl -H "Content-Type: application/timestamp-query" --data-binary '@file.tsq' https://freetsa.org/tsr > file.tsr
    tsaUrl = "https://freetsa.org/tsr";
    //  Another timestamp server you could try is: http://timestamp.digicert.com
    tsaUrl = "http://timestamp.digicert.com";
    resp = CkHttpResponse_Create();
    success = CkHttp_HttpBd(http,"POST",tsaUrl,requestToken,"application/timestamp-query",resp);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkCrypt2_Dispose(crypt);
        CkHttp_Dispose(http);
        CkBinData_Dispose(requestToken);
        CkHttpResponse_Dispose(resp);
        return;
    }

    //  Get the timestamp reply from the HTTP response object.
    timestampReply = CkBinData_Create();
    CkHttpResponse_GetBodyBd(resp,timestampReply);

    //  Show the base64 encoded timestamp reply.
    printf("%s\n",CkBinData_getEncoded(timestampReply,"base64"));

    //  Let's verify the timestamp reply against the TSA's cert, which we've previously downloaded.
    //  See https://freetsa.org/index_en.php
    tsaCert = CkCert_Create();
    success = CkCert_LoadFromFile(tsaCert,"qa_data/certs/freetsa.org.cer");
    if (success == FALSE) {
        printf("%s\n",CkCert_lastErrorText(tsaCert));
        CkCrypt2_Dispose(crypt);
        CkHttp_Dispose(http);
        CkBinData_Dispose(requestToken);
        CkHttpResponse_Dispose(resp);
        CkBinData_Dispose(timestampReply);
        CkCert_Dispose(tsaCert);
        return;
    }

    //  The VerifyTimestampReply method will return one of the following values:
    //  -1:  The timestampReply does not contain a valid timestamp reply.
    //  -2: The  timestampReply is a valid timestamp reply, but failed verification using the public key of the tsaCert.
    //  0:  Granted and verified.
    //  1: Granted and verified, with mods (see RFC 3161)
    //  2: Rejected.
    //  3: Waiting.
    //  4: Revocation Warning
    //  5: Revocation Notification
    pkiStatus = CkHttp_VerifyTimestampReply(http,timestampReply,tsaCert);
    if (pkiStatus < 0) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkCrypt2_Dispose(crypt);
        CkHttp_Dispose(http);
        CkBinData_Dispose(requestToken);
        CkHttpResponse_Dispose(resp);
        CkBinData_Dispose(timestampReply);
        CkCert_Dispose(tsaCert);
        return;
    }

    printf("pkiStatus = %d\n",pkiStatus);

    json = CkJsonObject_Create();
    CkHttp_GetLastJsonData(http,json);

    CkJsonObject_putEmitCompact(json,FALSE);
    printf("%s\n",CkJsonObject_emit(json));

    //  The JSON looks like the following.

    //  Use this online tool to generate parsing code from sample JSON: 
    //  Generate Parsing Code from JSON

    //  {
    //    "timestampReply": {
    //      "pkiStatus": {
    //        "value": 0,
    //        "meaning": "granted"
    //      }
    //    },
    //    "pkcs7": {
    //      "verify": {
    //        "digestAlgorithms": [
    //          "sha256"
    //        ],
    //        "signerInfo": [
    //          {
    //            "cert": {
    //              "serialNumber": "04CD3F8568AE76C61BB0FE7160CCA76D",
    //              "issuerCN": "DigiCert SHA2 Assured ID Timestamping CA",
    //              "digestAlgOid": "2.16.840.1.101.3.4.2.1",
    //              "digestAlgName": "SHA256"
    //            },
    //            "contentType": "1.2.840.113549.1.9.16.1.4",
    //            "signingTime": "200405023019Z",
    //            "messageDigest": "f14zOsdnN9vyyV3HjjBiLzNDi1PF28hAFMODxNkNRZs=",
    //            "signingAlgOid": "1.2.840.113549.1.1.1",
    //            "signingAlgName": "RSA-PKCSV-1_5",
    //            "authAttr": {
    //              "1.2.840.113549.1.9.3": {
    //                "name": "contentType",
    //                "oid": "1.2.840.113549.1.9.16.1.4"
    //              },
    //              "1.2.840.113549.1.9.5": {
    //                "name": "signingTime",
    //                "utctime": "200405023019Z"
    //              },
    //              "1.2.840.113549.1.9.16.2.12": {
    //                "name": "signingCertificate",
    //                "der": "MBowGDAWBBQDJb1QXtqWMC3CL0+gHkwovig0xQ=="
    //              },
    //              "1.2.840.113549.1.9.4": {
    //                "name": "messageDigest",
    //                "digest": "f14zOsdnN9vyyV3HjjBiLzNDi1PF28hAFMODxNkNRZs="
    //              }
    //            }
    //          }
    //        ]
    //      }
    //    }
    //  }

    //  Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.
    //  See this example explaining how this memory should be used: const char * functions.

    signingTime = CkDtObj_Create();
    authAttrSigningTimeUtctime = CkDtObj_Create();

    timestampReplyPkiStatusValue = CkJsonObject_IntOf(json,"timestampReply.pkiStatus.value");
    timestampReplyPkiStatusMeaning = CkJsonObject_stringOf(json,"timestampReply.pkiStatus.meaning");
    i = 0;
    count_i = CkJsonObject_SizeOfArray(json,"pkcs7.verify.digestAlgorithms");
    while (i < count_i) {
        CkJsonObject_putI(json,i);
        strVal = CkJsonObject_stringOf(json,"pkcs7.verify.digestAlgorithms[i]");
        i = i + 1;
    }

    i = 0;
    count_i = CkJsonObject_SizeOfArray(json,"pkcs7.verify.signerInfo");
    while (i < count_i) {
        CkJsonObject_putI(json,i);
        certSerialNumber = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].cert.serialNumber");
        certIssuerCN = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].cert.issuerCN");
        certDigestAlgOid = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].cert.digestAlgOid");
        certDigestAlgName = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].cert.digestAlgName");
        contentType = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].contentType");
        CkJsonObject_DtOf(json,"pkcs7.verify.signerInfo[i].signingTime",FALSE,signingTime);
        messageDigest = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].messageDigest");
        signingAlgOid = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].signingAlgOid");
        signingAlgName = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].signingAlgName");
        authAttrContentTypeName = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].authAttr.\"1.2.840.113549.1.9.3\".name");
        authAttrContentTypeOid = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].authAttr.\"1.2.840.113549.1.9.3\".oid");
        authAttrSigningTimeName = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].authAttr.\"1.2.840.113549.1.9.5\".name");
        CkJsonObject_DtOf(json,"pkcs7.verify.signerInfo[i].authAttr.\"1.2.840.113549.1.9.5\".utctime",FALSE,authAttrSigningTimeUtctime);
        authAttrSigningCertificateName = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].authAttr.\"1.2.840.113549.1.9.16.2.12\".name");
        authAttrSigningCertificateDer = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].authAttr.\"1.2.840.113549.1.9.16.2.12\".der");
        authAttrMessageDigestName = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].authAttr.\"1.2.840.113549.1.9.4\".name");
        authAttrMessageDigestDigest = CkJsonObject_stringOf(json,"pkcs7.verify.signerInfo[i].authAttr.\"1.2.840.113549.1.9.4\".digest");
        i = i + 1;
    }



    CkCrypt2_Dispose(crypt);
    CkHttp_Dispose(http);
    CkBinData_Dispose(requestToken);
    CkHttpResponse_Dispose(resp);
    CkBinData_Dispose(timestampReply);
    CkCert_Dispose(tsaCert);
    CkJsonObject_Dispose(json);
    CkDtObj_Dispose(signingTime);
    CkDtObj_Dispose(authAttrSigningTimeUtctime);

    }