Creating dynamic templates.Overview.The XML Security Library uses templates to describe
how and what data should be signed or encrypted. The template
is a regular XML file. You can create templates in advance
using your favorite XML files editor, load them from a file
and use for creating signature or encrypting data. You can
also create templates dynamicaly. The XML Security Library
provides helper functions to quickly create dynamic templates
inside your application.Creating dynamic signature templates.The signature template has structure similar
to the XML Digital Signature structure as it is described in
specification.
The only difference is that some nodes (for example,
<dsig:DigestValue/> or <SignatureValue/>)
are empty. The XML Security Library sets the content of these
nodes after doing necessary calculations.
XML Digital Signature structure
<dsig:Signature ID?>
<dsig:SignedInfo>
<dsig:CanonicalizationMethod Algorithm />
<dsig:SignatureMethod Algorithm />
(<dsig:Reference URI? >
(<dsig:Transforms>
(<dsig:Transform Algorithm />)+
</dsig:Transforms>)?
<dsig:DigestMethod Algorithm >
<dsig:DigestValue>
</dsig:Reference>)+
</dsig:SignedInfo>
<dsig:SignatureValue>
(<dsig:KeyInfo>
<dsig:KeyName>?
<dsig:KeyValue>?
<dsig:RetrievalMethod>?
<dsig:X509Data>?
<dsig:PGPData>?
<enc:EncryptedKey>?
<enc:AgreementMethod>?
<dsig:KeyName>?
<dsig:RetrievalMethod>?
<*>?
</dsig:KeyInfo>)?
(<dsig:Object ID?>)*
</dsig:Signature>
Creating dynamic signature template. node to the doc */
xmlAddChild(xmlDocGetRootElement(doc), signNode);
/* add reference */
refNode = xmlSecTmplSignatureAddReference(signNode, xmlSecTransformSha1Id,
NULL, NULL, NULL);
if(refNode == NULL) {
fprintf(stderr, "Error: failed to add reference to signature template\n");
goto done;
}
/* add enveloped transform */
if(xmlSecTmplReferenceAddTransform(refNode, xmlSecTransformEnvelopedId) == NULL) {
fprintf(stderr, "Error: failed to add enveloped transform to reference\n");
goto done;
}
/* add and nodes to put key name in the signed document */
keyInfoNode = xmlSecTmplSignatureEnsureKeyInfo(signNode, NULL);
if(keyInfoNode == NULL) {
fprintf(stderr, "Error: failed to add key info\n");
goto done;
}
if(xmlSecTmplKeyInfoAddKeyName(keyInfoNode, NULL) == NULL) {
fprintf(stderr, "Error: failed to add key name\n");
goto done;
}
/* create signature context, we don't need keys manager in this example */
dsigCtx = xmlSecDSigCtxCreate(NULL);
if(dsigCtx == NULL) {
fprintf(stderr,"Error: failed to create signature context\n");
goto done;
}
/* load private key, assuming that there is not password */
dsigCtx->signKey = xmlSecCryptoAppKeyLoad(key_file, xmlSecKeyDataFormatPem, NULL, NULL, NULL);
if(dsigCtx->signKey == NULL) {
fprintf(stderr,"Error: failed to load private pem key from \"%s\"\n", key_file);
goto done;
}
/* set key name to the file name, this is just an example! */
if(xmlSecKeySetName(dsigCtx->signKey, key_file) < 0) {
fprintf(stderr,"Error: failed to set key name for key from \"%s\"\n", key_file);
goto done;
}
/* sign the template */
if(xmlSecDSigCtxSign(dsigCtx, signNode) < 0) {
fprintf(stderr,"Error: signature failed\n");
goto done;
}
/* print signed document to stdout */
xmlDocDump(stdout, doc);
/* success */
res = 0;
done:
/* cleanup */
if(dsigCtx != NULL) {
xmlSecDSigCtxDestroy(dsigCtx);
}
if(doc != NULL) {
xmlFreeDoc(doc);
}
return(res);
}
]]>Full program listingCreating dynamic encryption templates.The encryption template has structure similar
to the XML Encryption structure as it is described in
specification.
The only difference is that some nodes (for example,
<enc:CipherValue/>)
are empty. The XML Security Library sets the content of these
nodes after doing necessary calculations.
XML Encryption structure
<enc:EncryptedData Id? Type? MimeType? Encoding?>
<enc:EncryptionMethod Algorithm />?
(<dsig:KeyInfo>
<dsig:KeyName>?
<dsig:KeyValue>?
<dsig:RetrievalMethod>?
<dsig:X509Data>?
<dsig:PGPData>?
<enc:EncryptedKey>?
<enc:AgreementMethod>?
<dsig:KeyName>?
<dsig:RetrievalMethod>?
<*>?
</dsig:KeyInfo>)?
<enc:CipherData>
<enc:CipherValue>?
<enc:CipherReference URI?>?
</enc:CipherData>
<enc:EncryptionProperties>?
</enc:EncryptedData>
Creating dynamic encrytion template. node */
if(xmlSecTmplEncDataEnsureCipherValue(encDataNode) == NULL) {
fprintf(stderr, "Error: failed to add CipherValue node\n");
goto done;
}
/* add and nodes to put key name in the signed document */
keyInfoNode = xmlSecTmplEncDataEnsureKeyInfo(encDataNode, NULL);
if(keyInfoNode == NULL) {
fprintf(stderr, "Error: failed to add key info\n");
goto done;
}
if(xmlSecTmplKeyInfoAddKeyName(keyInfoNode, NULL) == NULL) {
fprintf(stderr, "Error: failed to add key name\n");
goto done;
}
/* create encryption context, we don't need keys manager in this example */
encCtx = xmlSecEncCtxCreate(NULL);
if(encCtx == NULL) {
fprintf(stderr,"Error: failed to create encryption context\n");
goto done;
}
/* load DES key, assuming that there is not password */
encCtx->encKey = xmlSecKeyReadBinaryFile(xmlSecKeyDataDesId, key_file);
if(encCtx->encKey == NULL) {
fprintf(stderr,"Error: failed to load des key from binary file \"%s\"\n", key_file);
goto done;
}
/* set key name to the file name, this is just an example! */
if(xmlSecKeySetName(encCtx->encKey, key_file) < 0) {
fprintf(stderr,"Error: failed to set key name for key from \"%s\"\n", key_file);
goto done;
}
/* encrypt the data */
if(xmlSecEncCtxXmlEncrypt(encCtx, encDataNode, xmlDocGetRootElement(doc)) < 0) {
fprintf(stderr,"Error: encryption failed\n");
goto done;
}
/* we template is inserted in the doc */
encDataNode = NULL;
/* print encrypted data with document to stdout */
xmlDocDump(stdout, doc);
/* success */
res = 0;
done:
/* cleanup */
if(encCtx != NULL) {
xmlSecEncCtxDestroy(encCtx);
}
if(encDataNode != NULL) {
xmlFreeNode(encDataNode);
}
if(doc != NULL) {
xmlFreeDoc(doc);
}
return(res);
}
]]>Full program listing