(PHP Extension) Create a CAdES-T Signature

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.

Chilkat PHP Downloads PHP Extension for Windows, Linux, MacOS, Alpine Linux, Solaris

<?php

// The version number (9_5_0) should match version of the Chilkat extension used, omitting the micro-version number.
// For example, if using Chilkat v9.5.0.48, then include as shown here:
include("chilkat_9_5_0.php");

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

$crypt = new CkCrypt2();

// 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 = new CkCert();

$pfxPath = 'qa_data/pfx/myCertAndKey.p12';
$pfxPassword = 'test123';

$success = $cert->LoadPfxFile($pfxPath,$pfxPassword);
if ($success != true) {
    print $cert->lastErrorText() . "\n";
    exit;
}

$success = $crypt->SetSigningCert($cert);

// Use SHA-256 rather than the default of SHA-1
$crypt->put_HashAlgorithm('sha256');

// Create JSON that tells Chilkat what signing attributes to include:
$attrs = new CkJsonObject();
$attrs->UpdateBool('contentType',true);
$attrs->UpdateBool('signingTime',true);
$attrs->UpdateBool('messageDigest',true);
$attrs->UpdateBool('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.
$attrs->UpdateBool('timestampToken.enabled',true);
$attrs->UpdateString('timestampToken.tsaUrl','https://freetsa.org/tsr');
$attrs->UpdateBool('timestampToken.addNonce',false);
$attrs->UpdateBool('timestampToken.requestTsaCert',true);
$attrs->UpdateString('timestampToken.hashAlg','sha256');

$crypt->put_SigningAttributes($attrs->emit());

$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 = $crypt->CreateP7M($inFile,$outFile);
if ($success != true) {
    print $crypt->lastErrorText() . "\n";
    exit;
}

print 'Success.' . "\n";

?>