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)