Delphi DLL

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.

Delphi DLL

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Cert, JsonObject, Crypt2;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
crypt: HCkCrypt2;
cert: HCkCert;
pfxPath: PWideChar;
pfxPassword: PWideChar;
attrs: HCkJsonObject;
inFile: PWideChar;
outFile: PWideChar;

begin
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) then
  begin
    Memo1.Lines.Add(CkCert__lastErrorText(cert));
    Exit;
  end;

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) then
  begin
    Memo1.Lines.Add(CkCrypt2__lastErrorText(crypt));
    Exit;
  end;

Memo1.Lines.Add('Success.');

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

end;