(C#) Create XAdES-T Signed XML

See more XAdES Examples

This example signs XML using the XAdES-T profile. XAdES-T is a profile within the XAdES standard that adds support for secure timestamping of signatures.

Secure timestamping involves adding a timestamp to the signature, indicating the exact time when the signature was applied.

Timestamping enhances the long-term validity of signatures by providing evidence that the signature existed at a specific point in time, even if the signer's certificate has expired or been revoked.

XAdES-T signatures include elements for embedding timestamp data within the XML signature, along with information about the timestamp authority and the timestamp verification process.

XAdES-T signatures are suitable for scenarios where long-term validity and integrity of signatures are essential, such as in legal and regulatory contexts where archived documents may need to be validated years or decades later.

Chilkat .NET Downloads Chilkat .NET Framework Chilkat for .NET Core

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

bool success = true;
// Create the XML to be signed...

// Use this online tool to generate code from sample XML: 
// Generate Code to Create XML

// <?xml version="1.0" encoding="UTF-8"?>
// <es:Dossier xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns="http://uri.etsi.org/01903/v1.3.2#" xmlns:es="https://www.microsec.hu/ds/e-szigno30#" xsi:schemaLocation="https://www.microsec.hu/ds/e-szigno30# https://www.microsec.hu/ds/e-szigno30.xsd">
// 	<es:DossierProfile Id="PObject0" OBJREF="Object0">
// 	<es:Title>e-akta.es3</es:Title>
// 	<es:E-category>electronic dossier</es:E-category>
// 	<es:CreationDate>2022-12-02T07:55:16Z</es:CreationDate>
// 	</es:DossierProfile>
// 	<es:Documents Id="Object0"/>
// </es:Dossier>

Chilkat.Xml xmlToSign = new Chilkat.Xml();
xmlToSign.Tag = "es:Dossier";
xmlToSign.AddAttribute("xmlns:xsi","http://www.w3.org/2001/XMLSchema-instance");
xmlToSign.AddAttribute("xmlns:ds","http://www.w3.org/2000/09/xmldsig#");
xmlToSign.AddAttribute("xmlns","http://uri.etsi.org/01903/v1.3.2#");
xmlToSign.AddAttribute("xmlns:es","https://www.microsec.hu/ds/e-szigno30#");
xmlToSign.AddAttribute("xsi:schemaLocation","https://www.microsec.hu/ds/e-szigno30# https://www.microsec.hu/ds/e-szigno30.xsd");
xmlToSign.UpdateAttrAt("es:DossierProfile",true,"Id","PObject0");
xmlToSign.UpdateAttrAt("es:DossierProfile",true,"OBJREF","Object0");
xmlToSign.UpdateChildContent("es:DossierProfile|es:Title","e-akta.es3");
xmlToSign.UpdateChildContent("es:DossierProfile|es:E-category","electronic dossier");
xmlToSign.UpdateChildContent("es:DossierProfile|es:CreationDate","2022-12-02T07:55:16Z");
xmlToSign.UpdateAttrAt("es:Documents",true,"Id","Object0");

Chilkat.XmlDSigGen gen = new Chilkat.XmlDSigGen();

gen.SigLocation = "es:Dossier";
gen.SigLocationMod = 0;
gen.SigId = "S9fe8096e-2cac-415d-9222-f6cf2ecb314b";
gen.SigValueId = "VS9fe8096e-2cac-415d-9222-f6cf2ecb314b";
gen.SignedInfoId = "SIS9fe8096e-2cac-415d-9222-f6cf2ecb314b";
gen.SignedInfoCanonAlg = "EXCL_C14N";
gen.SignedInfoDigestMethod = "sha256";

// Set the KeyInfoId before adding references..
gen.KeyInfoId = "KS9fe8096e-2cac-415d-9222-f6cf2ecb314b";

// Create an Object to be added to the Signature.
Chilkat.Xml object1 = new Chilkat.Xml();
object1.Tag = "es:SignatureProfile";
object1.AddAttribute("Id","PS9fe8096e-2cac-415d-9222-f6cf2ecb314b");
object1.AddAttribute("OBJREF","Object0");
object1.AddAttribute("SIGREF","S9fe8096e-2cac-415d-9222-f6cf2ecb314b");
object1.AddAttribute("SIGREFLIST","#Object0 #PS9fe8096e-2cac-415d-9222-f6cf2ecb314b #PObject0 #XS9fe8096e-2cac-415d-9222-f6cf2ecb314b");
object1.UpdateChildContent("es:SignerName","EC Minsített-Tesztel Péterke");
object1.UpdateChildContent("es:SDPresented","false");
object1.UpdateChildContent("es:Type","signature");
object1.UpdateAttrAt("es:Generator|es:Program",true,"name","e-Szigno");
object1.UpdateAttrAt("es:Generator|es:Program",true,"version","3.3.6.8");
object1.UpdateAttrAt("es:Generator|es:Device",true,"name","OpenSSL 1.1.1n  15 Mar 2022");
object1.UpdateAttrAt("es:Generator|es:Device",true,"type","");

gen.AddObject("O1S9fe8096e-2cac-415d-9222-f6cf2ecb314b",object1.GetXml(),"","");

// Create an Object to be added to the Signature.
Chilkat.Xml object2 = new Chilkat.Xml();
object2.Tag = "QualifyingProperties";
object2.AddAttribute("Target","#S9fe8096e-2cac-415d-9222-f6cf2ecb314b");
object2.AddAttribute("Id","QPS9fe8096e-2cac-415d-9222-f6cf2ecb314b");
object2.UpdateAttrAt("SignedProperties",true,"Id","XS9fe8096e-2cac-415d-9222-f6cf2ecb314b");
object2.UpdateChildContent("SignedProperties|SignedSignatureProperties|SigningTime","TO BE GENERATED BY CHILKAT");
object2.UpdateAttrAt("SignedProperties|SignedSignatureProperties|SigningCertificateV2|Cert|CertDigest|ds:DigestMethod",true,"Algorithm","http://www.w3.org/2001/04/xmlenc#sha256");
object2.UpdateChildContent("SignedProperties|SignedSignatureProperties|SigningCertificateV2|Cert|CertDigest|ds:DigestValue","TO BE GENERATED BY CHILKAT");
object2.UpdateChildContent("SignedProperties|SignedSignatureProperties|SigningCertificateV2|Cert|IssuerSerialV2","TO BE GENERATED BY CHILKAT");
object2.UpdateChildContent("SignedProperties|SignedSignatureProperties|SignaturePolicyIdentifier|SignaturePolicyImplied","");
object2.UpdateChildContent("SignedProperties|SignedSignatureProperties|SignerRoleV2|ClaimedRoles|ClaimedRole","tesztel");

// Here we have the EncapsulatedTimestamp found in the unsigned signature properties.
object2.UpdateAttrAt("UnsignedProperties|UnsignedSignatureProperties|SignatureTimeStamp",true,"Id","T72cb4961-4326-4319-857a-7cf55e7ef899");
object2.UpdateAttrAt("UnsignedProperties|UnsignedSignatureProperties|SignatureTimeStamp|ds:CanonicalizationMethod",true,"Algorithm","http://www.w3.org/2001/10/xml-exc-c14n#");
object2.UpdateAttrAt("UnsignedProperties|UnsignedSignatureProperties|SignatureTimeStamp|EncapsulatedTimeStamp",true,"Id","ET72cb4961-4326-4319-857a-7cf55e7ef899");
object2.UpdateChildContent("UnsignedProperties|UnsignedSignatureProperties|SignatureTimeStamp|EncapsulatedTimeStamp","TO BE GENERATED BY CHILKAT");
object2.UpdateAttrAt("UnsignedProperties|UnsignedSignatureProperties|TimeStampValidationData",true,"xmlns","http://uri.etsi.org/01903/v1.4.1#");
object2.UpdateAttrAt("UnsignedProperties|UnsignedSignatureProperties|CertificateValues",true,"Id","CV18c7702d-d45b-44bc-853a-a720f41053cd");
object2.UpdateAttrAt("UnsignedProperties|UnsignedSignatureProperties|CertificateValues|EncapsulatedX509Certificate",true,"Id","EC42db04c8-1422-407b-8c42-189353a55268");
object2.UpdateChildContent("UnsignedProperties|UnsignedSignatureProperties|CertificateValues|EncapsulatedX509Certificate","BASE64_CONTENT");
object2.UpdateAttrAt("UnsignedProperties|UnsignedSignatureProperties|CertificateValues|EncapsulatedX509Certificate[1]",true,"Id","EC04728b44-a32c-46c1-b9bb-85b1f6b3c7d3");
object2.UpdateChildContent("UnsignedProperties|UnsignedSignatureProperties|CertificateValues|EncapsulatedX509Certificate[1]","BASE64_CONTENT");

gen.AddObject("O2S9fe8096e-2cac-415d-9222-f6cf2ecb314b",object2.GetXml(),"","");

// -------- Reference 1 --------
gen.AddSameDocRef("Object0","sha256","EXCL_C14N","","");
gen.SetRefIdAttr("Object0","Re1f816c4-7898-4544-9b41-f4156dc0c528");

// -------- Reference 2 --------
gen.AddObjectRef("PS9fe8096e-2cac-415d-9222-f6cf2ecb314b","sha256","EXCL_C14N","","");
gen.SetRefIdAttr("PS9fe8096e-2cac-415d-9222-f6cf2ecb314b","Ra873b616-e568-4c38-ae94-27fbff67cc43");

// -------- Reference 3 --------
gen.AddSameDocRef("PObject0","sha256","EXCL_C14N","","");
gen.SetRefIdAttr("PObject0","Ra5d85948-5d6a-4914-8c32-242f5d6d9e81");

// -------- Reference 4 --------
gen.AddObjectRef("XS9fe8096e-2cac-415d-9222-f6cf2ecb314b","sha256","EXCL_C14N","","http://uri.etsi.org/01903#SignedProperties");
gen.SetRefIdAttr("XS9fe8096e-2cac-415d-9222-f6cf2ecb314b","Ra7412a43-dc05-4e0a-ac84-e9a070214757");

// Provide a certificate + private key. (PFX password is test123)
Chilkat.Cert cert = new Chilkat.Cert();
success = cert.LoadPfxFile("qa_data/pfx/cert_test123.pfx","test123");
if (success != true) {
    Debug.WriteLine(cert.LastErrorText);
    return;
}

gen.SetX509Cert(cert,true);

gen.KeyInfoType = "X509Data";
gen.X509Type = "Certificate";

// -------------------------------------------------------------------------------------------
// To have the EncapsulatedTimeStamp automatically added, we only need to do 2 things.
// 1) Add the <xades:EncapsulatedTimeStamp Encoding="http://uri.etsi.org/01903/v1.2.2#DER">TO BE GENERATED BY CHILKAT</xades:EncapsulatedTimeStamp>
//    to the unsigned properties.
// 2) Specify the TSA URL (Timestamping Authority URL).
//    Here we specify the TSA URL:
// -------------------------------------------------------------------------------------------

Chilkat.JsonObject jsonTsa = new Chilkat.JsonObject();
jsonTsa.UpdateString("timestampToken.tsaUrl","http://timestamp.digicert.com");
jsonTsa.UpdateBool("timestampToken.requestTsaCert",true);
gen.SetTsa(jsonTsa);

// Load XML to be signed...
Chilkat.StringBuilder sbXml = new Chilkat.StringBuilder();
xmlToSign.GetXmlSb(sbXml);

gen.Behaviors = "IndentedSignature,OmitAlreadyDefinedSigNamespace";

// Sign the XML...
success = gen.CreateXmlDSigSb(sbXml);
if (success != true) {
    Debug.WriteLine(gen.LastErrorText);
    return;
}

// -----------------------------------------------

// Save the signed XML to a file.
success = sbXml.WriteFile("c:/temp/qa_output/signedXml.xml","utf-8",false);

Debug.WriteLine(sbXml.GetAsString());

// ----------------------------------------
// Verify the signatures we just produced...
Chilkat.XmlDSig verifier = new Chilkat.XmlDSig();
success = verifier.LoadSignatureSb(sbXml);
if (success != true) {
    Debug.WriteLine(verifier.LastErrorText);
    return;
}

int numSigs = verifier.NumSignatures;
int verifyIdx = 0;
while (verifyIdx < numSigs) {
    verifier.Selector = verifyIdx;
    bool verified = verifier.VerifySignature(true);
    if (verified != true) {
        Debug.WriteLine(verifier.LastErrorText);
        return;
    }

    verifyIdx = verifyIdx + 1;
}

Debug.WriteLine("All signatures were successfully verified.");