Tcl
Tcl
Sign SOAP XML using a wsse:SecurityTokenReference
See more XML Digital Signatures Examples
This example signs SOAP XML such that the KeyInfo in the XML Signature is a wsse:SecurityTokenReference to the X.509 certificate embedded elsewhere in the SOAP XML.Chilkat Tcl Downloads
load ./chilkat.dll
set success 0
# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.
# To begin, we'll need a PFX containing a certificate and private key, and the SOAP XML to be signed.
# Chilkat provides sample data at chilkatsoft.com and chilkatdownload.com, and our first step is to download.
# -------------------------------------------------------------------------
# Step 1: Get the SOAP XML template to be signed.
#
set sbXml [new_CkStringBuilder]
set http [new_CkHttp]
set success [CkHttp_QuickGetSb $http "https://www.chilkatsoft.com/exampleData/wssSoapTemplate.xml" $sbXml]
if {$success == 0} then {
puts [CkHttp_lastErrorText $http]
delete_CkStringBuilder $sbXml
delete_CkHttp $http
exit
}
# The SOAP XML template contains this:
# <?xml version="1.0" encoding="UTF8"?>
# <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
# <SOAP-ENV:Header>
# <wsse:Security xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
# xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
# xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
# xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" SOAP-ENV:mustUnderstand="1">
# <wsse:BinarySecurityToken
# EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary"
# ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509"
# wsu:Id="x509cert00">BASE64_CERT</wsse:BinarySecurityToken>
# </wsse:Security>
# </SOAP-ENV:Header>
# <SOAP-ENV:Body xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="TheBody">
# <getVersion xmlns="http://msgsec.wssecfvt.ws.ibm.com"/>
# </SOAP-ENV:Body>
# </SOAP-ENV:Envelope>
#
# -------------------------------------------------------------------------
# Step 2: Get the test certificate and private key stored in a .pfx
#
set pfxData [new_CkBinData]
set success [CkHttp_QuickGetBd $http "http://chilkatdownload.com/example_data/testcertificate.pfx" $pfxData]
if {$success == 0} then {
puts [CkHttp_lastErrorText $http]
delete_CkStringBuilder $sbXml
delete_CkHttp $http
delete_CkBinData $pfxData
exit
}
set pfx [new_CkPfx]
set password "test"
set success [CkPfx_LoadPfxEncoded $pfx [CkBinData_getEncoded $pfxData "base64"] "base64" $password]
if {$success == 0} then {
puts [CkPfx_lastErrorText $pfx]
delete_CkStringBuilder $sbXml
delete_CkHttp $http
delete_CkBinData $pfxData
delete_CkPfx $pfx
exit
}
# -------------------------------------------------------------------------
# Step 3: Get the certificate from the PFX.
#
set cert [new_CkCert]
set success [CkPfx_CertAt $pfx 0 $cert]
if {$success == 0} then {
puts [CkPfx_lastErrorText $pfx]
delete_CkStringBuilder $sbXml
delete_CkHttp $http
delete_CkBinData $pfxData
delete_CkPfx $pfx
delete_CkCert $cert
exit
}
# -------------------------------------------------------------------------
# Step 4: Replace "BASE64_CERT" with the actual base64 encoded certificate.
#
set bdCert [new_CkBinData]
CkCert_ExportCertDerBd $cert $bdCert
set numReplaced [CkStringBuilder_Replace $sbXml "BASE64_CERT" [CkBinData_getEncoded $bdCert "base64"]]
# -------------------------------------------------------------------------
# Step 5: Build the wsse:SecurityTokenReference XML.
# This will be the CustomKeyInfoXml (see below).
#
set refXml [new_CkXml]
CkXml_put_Tag $refXml "wsse:SecurityTokenReference"
CkXml_UpdateAttrAt $refXml "wsse:Reference" 1 "URI" "#x509cert00"
CkXml_UpdateAttrAt $refXml "wsse:Reference" 1 "ValueType" "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509"
# The above lines of code builds the following XML:
# <wsse:SecurityTokenReference>
# <wsse:Reference URI="#x509cert00" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509" />
# </wsse:SecurityTokenReference>
#
CkXml_put_EmitXmlDecl $refXml 0
puts [CkXml_getXml $refXml]
# -------------------------------------------------------------------------
# Step 6: Setup the XML Digital Signature Generator and add the XML Signature.
#
set gen [new_CkXmlDSigGen]
CkXmlDSigGen_put_SigLocation $gen "SOAP-ENV:Envelope|SOAP-ENV:Header|wsse:Security"
CkXmlDSigGen_put_SignedInfoPrefixList $gen "wsse SOAP-ENV"
CkXmlDSigGen_AddSameDocRef $gen "TheBody" "sha1" "EXCL_C14N" "" ""
CkXmlDSigGen_put_KeyInfoType $gen "Custom"
CkXml_put_EmitCompact $refXml 1
CkXmlDSigGen_put_CustomKeyInfoXml $gen [CkXml_getXml $refXml]
CkXmlDSigGen_SetX509Cert $gen $cert 1
set success [CkXmlDSigGen_CreateXmlDSigSb $gen $sbXml]
if {$success == 0} then {
puts [CkXmlDSigGen_lastErrorText $gen]
delete_CkStringBuilder $sbXml
delete_CkHttp $http
delete_CkBinData $pfxData
delete_CkPfx $pfx
delete_CkCert $cert
delete_CkBinData $bdCert
delete_CkXml $refXml
delete_CkXmlDSigGen $gen
exit
}
# Examine the signed XML
puts [CkStringBuilder_getAsString $sbXml]
# Pretty-printed, the XML signature looks as shown here:
# (The exact XML signature is shown below. Pretty-printing invalidates the XML signature.)
# <?xml version="1.0" encoding="UTF8" ?>
# <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
# <SOAP-ENV:Header>
# <wsse:Security xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" SOAP-ENV:mustUnderstand="1">
# <wsse:BinarySecurityToken EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509" wsu:Id="x509cert00">MIID...</wsse:BinarySecurityToken>
# <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
# <ds:SignedInfo>
# <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#">
# <InclusiveNamespaces xmlns="http://www.w3.org/2001/10/xml-exc-c14n#" PrefixList="wsse SOAP-ENV" />
# </ds:CanonicalizationMethod>
# <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256" />
# <ds:Reference URI="#TheBody">
# <ds:Transforms>
# <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#" />
# </ds:Transforms>
# <ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
# <ds:DigestValue>VhsSnaEAFsY0OYegKQh99v9csXg=</ds:DigestValue>
# </ds:Reference>
# </ds:SignedInfo>
# <ds:SignatureValue>Ynp3H4rtzpXIh4TaVxkpEkS1bMCCu672aeCzUOzheNNfnpmLsCZz3+zQjMBbchPggCayC5ihpEdhRe3XvPXjPXXAgxDP4mic091QPmjHlmUcu8yqRKfxnPtD35nqaxDtCYw+jGIzj+ch094vA4RPCfY8JQnb1mpy1ZjjsMW8741CIh1epbsd/0bZt6tfINUQ37seg07yvLbCJZ/Zf+h8FlFryQk6lHTTeZl/GfQ9NlDBcShby3x8Hc1KwW++zFqEA7G783R9AYPYn3fWTOBhYk5gkgFc+HaPRLR/L0Bp7ZPbmOR/iZQ+HK4W672tTdN/R2GdN7/deV7QTp2DYK1Z8w==</ds:SignatureValue>
# <ds:KeyInfo>
# <wsse:SecurityTokenReference>
# <wsse:Reference URI="#x509cert00" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509" />
# </wsse:SecurityTokenReference>
# </ds:KeyInfo>
# </ds:Signature>
# </wsse:Security>
# </SOAP-ENV:Header>
# <SOAP-ENV:Body xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="TheBody">
# <getVersion xmlns="http://msgsec.wssecfvt.ws.ibm.com" />
# </SOAP-ENV:Body>
# </SOAP-ENV:Envelope>
#
# --------------------------------------------------------------------------------------------
# This is the XML signature, which is also available at https://www.chilkatsoft.com/exampleData/signedSoapBinarySecurityToken.xml
#
# <?xml version="1.0" encoding="UTF8"?>
# <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
# <SOAP-ENV:Header>
# <wsse:Security xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
# xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
# xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
# xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" SOAP-ENV:mustUnderstand="1">
# <wsse:BinarySecurityToken
# EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary"
# ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509"
# wsu:Id="x509cert00">MIIDg...</wsse:BinarySecurityToken>
# <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#"><ds:SignedInfo><ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"><InclusiveNamespaces xmlns="http://www.w3.org/2001/10/xml-exc-c14n#" PrefixList="wsse SOAP-ENV"/></ds:CanonicalizationMethod><ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/><ds:Reference URI="#TheBody"><ds:Transforms><ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></ds:Transforms><ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><ds:DigestValue>VhsSnaEAFsY0OYegKQh99v9csXg=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>Ynp3H4rtzpXIh4TaVxkpEkS1bMCCu672aeCzUOzheNNfnpmLsCZz3+zQjMBbchPggCayC5ihpEdhRe3XvPXjPXXAgxDP4mic091QPmjHlmUcu8yqRKfxnPtD35nqaxDtCYw+jGIzj+ch094vA4RPCfY8JQnb1mpy1ZjjsMW8741CIh1epbsd/0bZt6tfINUQ37seg07yvLbCJZ/Zf+h8FlFryQk6lHTTeZl/GfQ9NlDBcShby3x8Hc1KwW++zFqEA7G783R9AYPYn3fWTOBhYk5gkgFc+HaPRLR/L0Bp7ZPbmOR/iZQ+HK4W672tTdN/R2GdN7/deV7QTp2DYK1Z8w==</ds:SignatureValue><ds:KeyInfo><wsse:SecurityTokenReference><wsse:Reference URI="#x509cert00" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509" /></wsse:SecurityTokenReference></ds:KeyInfo></ds:Signature></wsse:Security>
# </SOAP-ENV:Header>
# <SOAP-ENV:Body xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="TheBody">
# <getVersion xmlns="http://msgsec.wssecfvt.ws.ibm.com"/>
# </SOAP-ENV:Body>
# </SOAP-ENV:Envelope>
#
delete_CkStringBuilder $sbXml
delete_CkHttp $http
delete_CkBinData $pfxData
delete_CkPfx $pfx
delete_CkCert $cert
delete_CkBinData $bdCert
delete_CkXml $refXml
delete_CkXmlDSigGen $gen