Sample code for 30+ languages & platforms
AutoIt

Create IRS MeF Login Service Request Message

See more XML Digital Signatures Examples

This example demonstrates how to create a digitally signed Login Service Request Message.

This example used the documentation at https://www.irs.gov/pub/irs-utl/mef-doc-stp_ref_guide.pdf as a guide.

It creates signed XML as specified in section 4.1.1 found in Section 4: Example A2A Web Service Messages.

Chilkat AutoIt Downloads

AutoIt
Local $bSuccess = False

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

; --------------------------------------------------------------------------------
; Also see Chilkat's Online WSDL Code Generator
; to generate code and SOAP Request and Response XML for each operation in a WSDL.
; --------------------------------------------------------------------------------

; The goal of this example is to create signed SOAP XML such as the following:

; <?xml version="1.0" encoding="UTF-8"?>
; <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
;     <SOAP-ENV:Header>
;         <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
;             <wsse:BinarySecurityToken 
; 		xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
; 		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#X509v3"
; 		wsu:Id="CertId-1673181727">MIIHab...n71P</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#"/>
;                     <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/>
;                     <ds:Reference URI="#id-1214941501">
;                         <ds:Transforms>
;                             <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
;                         </ds:Transforms>
;                         <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
;                         <ds:DigestValue>abcdefghijkLMNOPQRSTUVwxyz012345Em0o3VEOTck=</ds:DigestValue>
;                     </ds:Reference>
;                     <ds:Reference URI="#id-1871558655">
;                         <ds:Transforms>
;                             <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
;                         </ds:Transforms>
;                         <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
;                         <ds:DigestValue>abcdefghijkLMNOPQRSTUVwxyz012345Xm5ViA+royg=</ds:DigestValue>
;                     </ds:Reference>
;                 </ds:SignedInfo>
;                 <ds:SignatureValue>abcd...5Nbw==</ds:SignatureValue>
;                 <ds:KeyInfo Id="KeyId-256137097">
;                     <wsse:SecurityTokenReference xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="STRId-1862925355">
;                         <wsse:Reference URI="#CertId-1673181727" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3"/>
;                     </wsse:SecurityTokenReference>
;                 </ds:KeyInfo>
;             </ds:Signature>
;         </wsse:Security>
;         <ns1:MeFHeader xmlns:ns1="http://www.irs.gov/a2a/mef/MeFHeader.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="id-1214941501">
;             <ns1:MessageID>12345202018200000234</ns1:MessageID>
;             <ns1:Action>Login</ns1:Action>
;             <ns1:MessageTs>2020-06-30T15:25:42.678Z</ns1:MessageTs>
;             <ns1:ETIN>12345</ns1:ETIN>
;             <ns1:SessionKeyCd>Y</ns1:SessionKeyCd>
;             <ns1:TestCd>P</ns1:TestCd>
;             <ns1:AppSysID>65432190</ns1:AppSysID>
;             <ns1:WSDLVersionNum>10.3</ns1:WSDLVersionNum>
;             <ns1:ClientSoftwareTxt>SOATest</ns1:ClientSoftwareTxt>
;         </ns1:MeFHeader>
;     </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="id-1871558655">
;         <LoginRequest xmlns="http://www.irs.gov/a2a/mef/MeFMSIServices.xsd"/>
;     </SOAP-ENV:Body>
; </SOAP-ENV:Envelope>

; -------------------------------------------------------------------------------------------

; First, let's load the certificate + private key to be used for signing (from a PFX).
; (It is also possible to use certificates installed on a Windows system, or from other file formats..)
$oPfx = ObjCreate("Chilkat.Pfx")
$bSuccess = $oPfx.LoadPfxFile("qa_data/pfx/cert_test123.pfx","test123")
If ($bSuccess = False) Then
    ConsoleWrite($oPfx.LastErrorText & @CRLF)
    Exit
EndIf

; We'll be needing the X.509 signing cert as base64 for the BinarySecurityToken, so let's get it now..
; The certificate having the private key should be the 1st in the PFX.

$oSigningCert = ObjCreate("Chilkat.Cert")
$bSuccess = $oPfx.CertAt(0,$oSigningCert)
If ($bSuccess = False) Then
    ConsoleWrite($oPfx.LastErrorText & @CRLF)
    Exit
EndIf

$oBdCert = ObjCreate("Chilkat.BinData")
$oSigningCert.ExportCertDerBd($oBdCert)
$oSbCert64 = ObjCreate("Chilkat.StringBuilder")
$oBdCert.GetEncodedSb("base64",$oSbCert64)

; -------------------------------------------------------------------------------------------
; The XML before signing would look like this:

; <?xml version="1.0" encoding="UTF-8"?>
; <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
;     <SOAP-ENV:Header>
;         <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
;             <wsse:BinarySecurityToken 
; 		xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
; 		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#X509v3"
; 		wsu:Id="CertId-1673181727">MIIHab...n71P</wsse:BinarySecurityToken>
;         </wsse:Security>
;         <ns1:MeFHeader xmlns:ns1="http://www.irs.gov/a2a/mef/MeFHeader.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="id-1214941501">
;             <ns1:MessageID>12345202018200000234</ns1:MessageID>
;             <ns1:Action>Login</ns1:Action>
;             <ns1:MessageTs>2020-06-30T15:25:42.678Z</ns1:MessageTs>
;             <ns1:ETIN>12345</ns1:ETIN>
;             <ns1:SessionKeyCd>Y</ns1:SessionKeyCd>
;             <ns1:TestCd>P</ns1:TestCd>
;             <ns1:AppSysID>65432190</ns1:AppSysID>
;             <ns1:WSDLVersionNum>10.3</ns1:WSDLVersionNum>
;             <ns1:ClientSoftwareTxt>SOATest</ns1:ClientSoftwareTxt>
;         </ns1:MeFHeader>
;     </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="id-1871558655">
;         <LoginRequest xmlns="http://www.irs.gov/a2a/mef/MeFMSIServices.xsd"/>
;     </SOAP-ENV:Body>
; </SOAP-ENV:Envelope>

; You can use the online XML code generation tool at http://tools.chilkat.io/xmlCreate.cshtml
; to generate the following XML creation source code:

; Create the XML to be signed...
$oXmlToSign = ObjCreate("Chilkat.Xml")
$oXmlToSign.Tag = "SOAP-ENV:Envelope"
$oXmlToSign.AddAttribute("xmlns:SOAP-ENV","http://schemas.xmlsoap.org/soap/envelope/")
$oXmlToSign.AddAttribute("xmlns:xsd","http://www.w3.org/2001/XMLSchema")
$oXmlToSign.AddAttribute("xmlns:xsi","http://www.w3.org/2001/XMLSchema-instance")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Header|wsse:Security",True,"xmlns:wsse","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Header|wsse:Security|wsse:BinarySecurityToken",True,"xmlns:wsu","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Header|wsse:Security|wsse:BinarySecurityToken",True,"EncodingType","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Header|wsse:Security|wsse:BinarySecurityToken",True,"ValueType","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Header|wsse:Security|wsse:BinarySecurityToken",True,"wsu:Id","CertId-1673181727")
$oXmlToSign.UpdateChildContent "SOAP-ENV:Header|wsse:Security|wsse:BinarySecurityToken",$oSbCert64.GetAsString()
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Header|ns1:MeFHeader",True,"xmlns:ns1","http://www.irs.gov/a2a/mef/MeFHeader.xsd")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Header|ns1:MeFHeader",True,"xmlns:wsu","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Header|ns1:MeFHeader",True,"wsu:Id","id-1214941501")
$oXmlToSign.UpdateChildContent "SOAP-ENV:Header|ns1:MeFHeader|ns1:MessageID","12345202018200000234"
$oXmlToSign.UpdateChildContent "SOAP-ENV:Header|ns1:MeFHeader|ns1:Action","Login"
$oXmlToSign.UpdateChildContent "SOAP-ENV:Header|ns1:MeFHeader|ns1:MessageTs","2020-06-30T15:25:42.678Z"
$oXmlToSign.UpdateChildContentInt "SOAP-ENV:Header|ns1:MeFHeader|ns1:ETIN",12345
$oXmlToSign.UpdateChildContent "SOAP-ENV:Header|ns1:MeFHeader|ns1:SessionKeyCd","Y"
$oXmlToSign.UpdateChildContent "SOAP-ENV:Header|ns1:MeFHeader|ns1:TestCd","P"
$oXmlToSign.UpdateChildContentInt "SOAP-ENV:Header|ns1:MeFHeader|ns1:AppSysID",65432190
$oXmlToSign.UpdateChildContent "SOAP-ENV:Header|ns1:MeFHeader|ns1:WSDLVersionNum","10.3"
$oXmlToSign.UpdateChildContent "SOAP-ENV:Header|ns1:MeFHeader|ns1:ClientSoftwareTxt","SOATest"
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Body",True,"xmlns:wsu","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Body",True,"wsu:Id","id-1871558655")
$oXmlToSign.UpdateAttrAt("SOAP-ENV:Body|LoginRequest",True,"xmlns","http://www.irs.gov/a2a/mef/MeFMSIServices.xsd")

; -------------------------------------------------------------------------------------------
; Setup the XML DSig generator object to create the desired signature.

$oGen = ObjCreate("Chilkat.XmlDSigGen")

$oGen.SigLocation = "SOAP-ENV:Envelope|SOAP-ENV:Header|wsse:Security"
$oGen.SigLocationMod = 0
$oGen.SigNamespacePrefix = "ds"
$oGen.SigNamespaceUri = "http://www.w3.org/2000/09/xmldsig#"
$oGen.SignedInfoCanonAlg = "EXCL_C14N"
$oGen.SignedInfoDigestMethod = "sha256"

; Set the KeyInfoId before adding references..
$oGen.KeyInfoId = "KeyId-256137097"

; -------- Reference 1 --------
$oGen.AddSameDocRef("id-1214941501","sha256","EXCL_C14N","","")

; -------- Reference 2 --------
$oGen.AddSameDocRef("id-1871558655","sha256","EXCL_C14N","","")

; Provide a certificate + private key. (PFX password is test123)
$oCert = ObjCreate("Chilkat.Cert")
$bSuccess = $oCert.LoadPfxFile("qa_data/pfx/cert_test123.pfx","test123")
If ($bSuccess = False) Then
    ConsoleWrite($oCert.LastErrorText & @CRLF)
    Exit
EndIf

$oGen.SetX509Cert($oCert,True)

$oGen.KeyInfoType = "Custom"

; Create the custom KeyInfo XML..
$oXmlCustomKeyInfo = ObjCreate("Chilkat.Xml")
$oXmlCustomKeyInfo.Tag = "wsse:SecurityTokenReference"
$oXmlCustomKeyInfo.AddAttribute("xmlns:wsu","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd")
$oXmlCustomKeyInfo.AddAttribute("wsu:Id","STRId-1862925355")
$oXmlCustomKeyInfo.UpdateAttrAt("wsse:Reference",True,"URI","#CertId-1673181727")
$oXmlCustomKeyInfo.UpdateAttrAt("wsse:Reference",True,"ValueType","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3")

$oXmlCustomKeyInfo.EmitXmlDecl = False
$oGen.CustomKeyInfoXml = $oXmlCustomKeyInfo.GetXml()

; -------------------------------------------------------------------------------------------
; Load XML to be signed...
$oSbXml = ObjCreate("Chilkat.StringBuilder")
$oXmlToSign.GetXmlSb($oSbXml)

; Update BinarySecurityToken_Base64Binary_Content with the actual X509 of the signing cert.
Local $iNReplaced = $oSbXml.Replace("BinarySecurityToken_Base64Binary_Content",$oCert.GetEncoded())

$oGen.Behaviors = "IndentedSignature"

; Sign the XML...
$bSuccess = $oGen.CreateXmlDSigSb($oSbXml)
If ($bSuccess = False) Then
    ConsoleWrite($oGen.LastErrorText & @CRLF)
    Exit
EndIf

; -----------------------------------------------

; Save the signed XML to a file.
$bSuccess = $oSbXml.WriteFile("c:/temp/qa_output/signedXml.xml","utf-8",False)

ConsoleWrite($oSbXml.GetAsString() & @CRLF)