XMLEncryptor Component

Properties   Methods   Events   Config Settings   Errors  

The XMLEncryptor component encrypts XML documents.

Syntax

nsoftware.SecureBlackbox.XMLEncryptor

Remarks

XMLEncryptor encrypts XML documents with certificates or generic keys.

Property List

The following is the full list of the properties of the component with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the component with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the component with short descriptions. Click on the links for further details.

Encoding Property (XMLEncryptor Component)

Specifies XML encoding.

Syntax

• C#
• VB.NET

public string Encoding { get; set; }

Public Property Encoding As String

Default Value

""

Remarks

Use this property to specify the encoding to apply to the XML documents.

EncryptedDataType Property (XMLEncryptor Component)

Specifies the type of the data being encrypted.

Syntax

• C#
• VB.NET

public XMLEncryptorEncryptedDataTypes EncryptedDataType { get; set; }

enum XMLEncryptorEncryptedDataTypes {
  cxedtElement,
  cxedtContent,
  cxedtExternal
}

Public Property EncryptedDataType As XmlencryptorEncryptedDataTypes

Enum XMLEncryptorEncryptedDataTypes
  cxedtElement
  cxedtContent
  cxedtExternal
End Enum

Default Value

0

Remarks

This property specifies the data type to be encrypted.

Supported values:

EncryptionKey Property (XMLEncryptor Component)

The symmetric (session) key used to encrypt the data.

Syntax

• C#
• VB.NET

public byte[] EncryptionKey { get; set; }

Public Property EncryptionKey As Byte()

Remarks

Use this property to provide the encryption symmetric (session) key that will be used to encrypt a data.

It is required when the EncryptKey property is disabled. If the EncryptKey property is enabled, and no value is set, the component will generate a random session key (recommended).

This property is not available at design time.

EncryptionMethod Property (XMLEncryptor Component)

The encryption method used to encrypt the document.

Syntax

• C#
• VB.NET

public string EncryptionMethod { get; set; }

Public Property EncryptionMethod As String

Default Value

"AES256"

Remarks

This property contains the encryption algorithm used to encrypt the XML document.

Supported values:

If UseGCM property is enabled, then supported values are:

EncryptKey Property (XMLEncryptor Component)

Specifies if the encryption key is encrypted.

Syntax

• C#
• VB.NET

public bool EncryptKey { get; set; }

Public Property EncryptKey As Boolean

Default Value

False

Remarks

Use this property to specify if encryption (session) key should be encrypted and also added to the encrypted data.

ExternalData Property (XMLEncryptor Component)

The data that should be encrypted.

Syntax

• C#
• VB.NET

public byte[] ExternalData { get; set; }

Public Property ExternalData As Byte()

Remarks

Use this property to provide the data that should be encrypted if EncryptedDataType property is set to cxedtExternal value.

This property is not available at design time.

FIPSMode Property (XMLEncryptor Component)

Reserved.

Syntax

• C#
• VB.NET

public bool FIPSMode { get; set; }

Public Property FIPSMode As Boolean

Default Value

False

Remarks

This property is reserved for future use.

InputBytes Property (XMLEncryptor Component)

Use this property to pass the input to component in byte array form.

Syntax

• C#
• VB.NET

public byte[] InputBytes { get; set; }

Public Property InputBytes As Byte()

Remarks

Assign a byte array containing the data to be processed to this property.

This property is not available at design time.

InputFile Property (XMLEncryptor Component)

The XML document to be encrypted.

Syntax

• C#
• VB.NET

public string InputFile { get; set; }

Public Property InputFile As String

Default Value

""

Remarks

Provide the path to the XML document to be encrypted.

InputStream Property (XMLEncryptor Component)

Stream containing the XML document.

Syntax

• C#
• VB.NET

public System.IO.Stream InputStream { get; set; }

Public Property InputStream As System.IO.Stream

Default Value

null

Remarks

Use this property to feed the XML document to the component via a stream.

This property is not available at design time.

KeyEncryptionCertificate Property (XMLEncryptor Component)

The certificate used to encrypt a session key.

Syntax

• C#
• VB.NET

public Certificate KeyEncryptionCertificate { get; set; }

Public Property KeyEncryptionCertificate As Certificate

Remarks

Use this property to provide the encryption certificate that will be used to encrypt a session key. It is required when the EncryptKey property is enabled and the KeyEncryptionType is set to cxetKeyTransport value.

This property is not available at design time.

KeyEncryptionKey Property (XMLEncryptor Component)

The symmetric key used to encrypt a session key.

Syntax

• C#
• VB.NET

public byte[] KeyEncryptionKey { get; set; }

Public Property KeyEncryptionKey As Byte()

Remarks

Use this property to provide the encryption symmetric key that will be used to encrypt a session key. It is required when the EncryptKey property is enabled and KeyEncryptionType is set to cxetKeyWrap value.

This property is not available at design time.

KeyEncryptionType Property (XMLEncryptor Component)

Specifies how the session key is encrypted.

Syntax

• C#
• VB.NET

public XMLEncryptorKeyEncryptionTypes KeyEncryptionType { get; set; }

enum XMLEncryptorKeyEncryptionTypes {
  cxetKeyTransport,
  cxetKeyWrap
}

Public Property KeyEncryptionType As XmlencryptorKeyEncryptionTypes

Enum XMLEncryptorKeyEncryptionTypes
  cxetKeyTransport
  cxetKeyWrap
End Enum

Default Value

0

Remarks

This property specifies how the session key is encrypted.

Supported values:

KeyTransportMethod Property (XMLEncryptor Component)

Specifies how the session key is encrypted.

Syntax

• C#
• VB.NET

public XMLEncryptorKeyTransportMethods KeyTransportMethod { get; set; }

enum XMLEncryptorKeyTransportMethods {
  cxktRSA15,
  cxktRSAOAEP
}

Public Property KeyTransportMethod As XmlencryptorKeyTransportMethods

Enum XMLEncryptorKeyTransportMethods
  cxktRSA15
  cxktRSAOAEP
End Enum

Default Value

0

Remarks

This property specifies how the session key is encrypted.

Supported values:

KeyWrapMethod Property (XMLEncryptor Component)

The key wrap method used to encrypt the session key.

Syntax

• C#
• VB.NET

public string KeyWrapMethod { get; set; }

Public Property KeyWrapMethod As String

Default Value

"Camellia256"

Remarks

This property specifies the key wrap algorithm used to encrypt the session key.

Supported values:

OutputBytes Property (XMLEncryptor Component)

Use this property to read the output the component object has produced.

Syntax

• C#
• VB.NET

public byte[] OutputBytes { get; }

Public ReadOnly Property OutputBytes As Byte()

Remarks

Read the contents of this property after the operation has completed to read the produced output. This property will only be set if the OutputFile and OutputStream properties had not been assigned.

This property is read-only and not available at design time.

OutputFile Property (XMLEncryptor Component)

Defines where to save the encrypted XML document.

Syntax

• C#
• VB.NET

public string OutputFile { get; set; }

Public Property OutputFile As String

Default Value

""

Remarks

Specifies the path where the encrypted XML document should be saved.

OutputStream Property (XMLEncryptor Component)

A stream where the encrypted XML document can be written to.

Syntax

• C#
• VB.NET

public System.IO.Stream OutputStream { get; set; }

Public Property OutputStream As System.IO.Stream

Default Value

null

Remarks

Use this property to save the encrypted XML document to the stream.

This property is not available at design time.

UseGCM Property (XMLEncryptor Component)

Specifies if GCM mode is enabled.

Syntax

• C#
• VB.NET

public bool UseGCM { get; set; }

Public Property UseGCM As Boolean

Default Value

False

Remarks

Use this property to enable Galois/Counter Mode (GCM) mode for AES encryption method.

XMLNode Property (XMLEncryptor Component)

Defines the XML element to encrypt.

Syntax

• C#
• VB.NET

public string XMLNode { get; set; }

Public Property XMLNode As String

Default Value

""

Remarks

Defines the XML element/node to encrypt or in case if cxedtExternal encryption data type is used where to save the encrypted data.

Supported values are:

AddKnownNamespace Method (XMLEncryptor Component)

Adds known prefix and correspondent namespace URI.

Syntax

• C#
• VB.NET

public void AddKnownNamespace(string prefix, string URI);

Public Sub AddKnownNamespace(ByVal Prefix As String, ByVal URI As String)

Remarks

Use this method to add a known prefix and namespace URI that are used in XPath expression within XMLElement/XMLNode property, and within TargetXMLElement and XPathPrefixList properties of the references.

Config Method (XMLEncryptor Component)

Sets or retrieves a configuration setting.

Syntax

• C#
• VB.NET

public string Config(string configurationString);

Public Function Config(ByVal ConfigurationString As String) As String

Remarks

Config is a generic method available in every component. It is used to set and retrieve configuration settings for the component.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

DoAction Method (XMLEncryptor Component)

Performs an additional action.

Syntax

• C#
• VB.NET

public string DoAction(string actionID, string actionParams);

Public Function DoAction(ByVal ActionID As String, ByVal ActionParams As String) As String

Remarks

DoAction is a generic method available in every component. It is used to perform an additional action introduced after the product major release. The list of actions is not fixed, and may be flexibly extended over time.

The unique identifier (case insensitive) of the action is provided in the ActionID parameter.

ActionParams contains the value of a single parameter, or a list of multiple parameters for the action in the form of PARAM1=VALUE1;PARAM2=VALUE2;....

Common ActionIDs:

Encrypt Method (XMLEncryptor Component)

Encrypts an XML document.

Syntax

• C#
• VB.NET

public void Encrypt();

Public Sub Encrypt()

Remarks

Call this method to encrypt an XML document.

The component could be used to encrypt the SOAP message as well.

Example 1: Encrypting the SOAP message

void EncryptSOAPMessage(string inputFilename, string outputFilename, string cert, string certPassword) { string encKeyId = "EK-" + Guid.NewGuid().ToString(); string encDataId = "ED-" + Guid.NewGuid().ToString(); using (Xmlencryptor encryptor = new Xmlencryptor()) { encryptor.InputFile = inputFilename; encryptor.OutputFile = outputFilename; string certB64; using (Certificatemanager certMgr = new Certificatemanager()) { certMgr.ImportFromFile(cert, certPassword); encryptor.KeyEncryptionCertificate = certMgr.Certificate; using (Utils utils = new Utils()) { var certBytes = certMgr.Certificate.Bytes; certB64 = utils.Base64Encode(certBytes, false); } } encryptor.XMLNode = "/soapv11:Envelope/soapv11:Body"; encryptor.EncryptedDataType = XmlencryptorEncryptedDataTypes.cxedtContent; encryptor.EncryptionMethod = "AES128"; encryptor.EncryptKey = true; encryptor.KeyEncryptionType = XmlencryptorKeyEncryptionTypes.cxetKeyTransport; encryptor.KeyTransportMethod = XmlencryptorKeyTransportMethods.cxktRSA15; encryptor.Config($"EncryptedDataID={encDataId}"); encryptor.Config($"EncryptedKeyID={encKeyId}"); encryptor.Config("EncryptedKeyXMLElement=/soapv11:Envelope/soapv11:Header/wssev10:Security"); encryptor.Config("KeyInfoCustomXML=<wsse:SecurityTokenReference xmlns:wsse=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd\" " + "xmlns:wsse11=\"http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd\" wsse11:TokenType=\"http://docs.oasis-open.org/wss/oasis-wss-soap-message-security-1.1#EncryptedKey\">" + $"<wsse:Reference URI=\"#{encKeyId}\"/>" + "</wsse:SecurityTokenReference>"); encryptor.Config("EncryptedKeyInfoCustomXML=<wsse:SecurityTokenReference xmlns:wsse=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd\">" + $"<ds:X509Data xmlns:ds=\"http://www.w3.org/2000/09/xmldsig#\">{certB64}</ds:X509Data>" + "</wsse:SecurityTokenReference>"); encryptor.Encrypt(); } } EncryptSOAPMessage(@"soap_test.xml", @"soap_encrypted.xml", @"cert.pfx", "password"); Note: The above code expects that the SOAP message has a WS Security header element.

Sample SOAP message:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <wsse:Security 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" soap:mustUnderstand="1">
    </wsse:Security>
  </soap:Header>
  <soap:Body>
    <ns:Data xmlns:ns="http://test.com">Sample message</ns:Data>
  </soap:Body>
</soap:Envelope>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <wsse:Security 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" soap:mustUnderstand="1">
      <xenc:EncryptedKey Id="EK-89565c75-9556-43d3-9de0-35ce6577e798" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#">
        <xenc:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#rsa-1_5"/>
        <ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
          <wsse:SecurityTokenReference xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <ds:X509Data xmlns:ds="http://www.w3.org/2000/09/xmldsig#">...</ds:X509Data>
          </wsse:SecurityTokenReference>
        </ds:KeyInfo>
        <xenc:CipherData>
          <xenc:CipherValue>...</xenc:CipherValue>
        </xenc:CipherData>
      </xenc:EncryptedKey>
    </wsse:Security>
  </soap:Header>
  <soap:Body>
    <xenc:EncryptedData Id="ED-90fe019e-0093-489d-a646-7ae0cee237c2" Type="http://www.w3.org/2001/04/xmlenc#Content" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
      <xenc:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes128-cbc"/>
      <ds:KeyInfo>
        <wsse:SecurityTokenReference xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsse11="http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd" wsse11:TokenType="http://docs.oasis-open.org/wss/oasis-wss-soap-message-security-1.1#EncryptedKey">
          <wsse:Reference URI="#EK-89565c75-9556-43d3-9de0-35ce6577e798"/>
        </wsse:SecurityTokenReference>
      </ds:KeyInfo>
      <xenc:CipherData>
        <xenc:CipherValue>...</xenc:CipherValue>
      </xenc:CipherData>
    </xenc:EncryptedData>
  </soap:Body>
</soap:Envelope>

void DecryptSOAPMessage(string inputFilename, string outputFilename, string cert, string certPassword) { using (Xmldecryptor decryptor = new Xmldecryptor()) { decryptor.InputFile = inputFilename; decryptor.OutputFile = outputFilename; using (Certificatemanager certMgr = new Certificatemanager()) { certMgr.ImportFromFile(cert, certPassword); decryptor.KeyDecryptionCertificate = certMgr.Certificate; } decryptor.XMLElement = "/soapv11:Envelope/soapv11:Body/xenc:EncryptedData"; decryptor.Config("EncryptedKeyXMLElement=/soapv11:Envelope/soapv11:Header/wssev10:Security"); decryptor.Decrypt(); } } DecryptSOAPMessage(@"soap_encrypted.xml", @"soap_decrypted.xml", @"cert.pfx", "password"); Example 3: Signing and encrypting the SOAP message

void SignAndEncryptSOAPMessage(string inputFilename, string outputFilename, string signingCert, string signingCertPassword, string encryptionCert, string encryptionCertPassword) { byte[] data; string encKeyId = "EK-" + Guid.NewGuid().ToString(); string encDataId1 = "ED-" + Guid.NewGuid().ToString(); string encDataId2 = "ED-" + Guid.NewGuid().ToString(); // Step 1: Creating Web service security (WSS) signature using (Soapsigner signer = new Soapsigner()) { signer.InputFile = inputFilename; // loading the signing certificate using (Certificatemanager certMgr = new Certificatemanager()) { certMgr.ImportFromFile(encryptionCert, encryptionCertPassword); signer.SigningCertificate = certMgr.Certificate; } signer.NewSignature.SignatureType = SOAPSignatureTypes.sstWSSSignature; signer.NewSignature.HashAlgorithm = "SHA256"; signer.NewSignature.XAdES = false; signer.SecurityHeaderIndex = 0; signer.AddBodyReference("ID-" + Guid.NewGuid().ToString(), false); signer.Sign(); data = signer.OutputBytes; } using (Xmlencryptor encryptor = new Xmlencryptor()) { // Step 2: loading the encryption certificate string certB64; using (Certificatemanager certMgr = new Certificatemanager()) { certMgr.ImportFromFile(encryptionCert, encryptionCertPassword); encryptor.KeyEncryptionCertificate = certMgr.Certificate; using (Utils utils = new Utils()) { var certBytes = certMgr.Certificate.Bytes; certB64 = utils.Base64Encode(certBytes, false); } } // Step 3: generating random key encryption key (128-bit length) // this key will be used for both encryptions byte[] KEK; using (Rnd rnd = new Rnd()) { KEK = rnd.NextBytes(16); } encryptor.KeyEncryptionKey = KEK; // Step 4: encrypting Body element and placing encrypted key to the Security block in the SOAP Message Header encryptor.XMLNode = "/soapv11:Envelope/soapv11:Body"; encryptor.EncryptedDataType = XmlencryptorEncryptedDataTypes.cxedtContent; encryptor.EncryptionMethod = "AES128"; encryptor.EncryptKey = true; encryptor.KeyEncryptionType = XmlencryptorKeyEncryptionTypes.cxetKeyTransport; encryptor.KeyTransportMethod = XmlencryptorKeyTransportMethods.cxktRSA15; encryptor.Config($"EncryptedDataID={encDataId1}"); encryptor.Config($"EncryptedKeyID={encKeyId}"); encryptor.Config("EncryptedKeyXMLElement=/soapv11:Envelope/soapv11:Header/wssev10:Security"); encryptor.Config("KeyInfoCustomXML=<wsse:SecurityTokenReference xmlns:wsse=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd\" " + "xmlns:wsse11=\"http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd\" wsse11:TokenType=\"http://docs.oasis-open.org/wss/oasis-wss-soap-message-security-1.1#EncryptedKey\">" + $"<wsse:Reference URI=\"#{encKeyId}\"/>" + "</wsse:SecurityTokenReference>"); encryptor.Config("EncryptedKeyInfoCustomXML=<wsse:SecurityTokenReference xmlns:wsse=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd\">" + $"<ds:X509Data xmlns:ds=\"http://www.w3.org/2000/09/xmldsig#\">{certB64}</ds:X509Data>" + "</wsse:SecurityTokenReference>"); encryptor.InputBytes = data; encryptor.Encrypt(); // Step 5: encrypting WSS Signature encryptor.InputBytes = encryptor.OutputBytes; // resetting settings encryptor.Config("EncryptedKeyXMLElement="); encryptor.Config("EncryptedKeyInfoCustomXML="); encryptor.XMLNode = "/soapv11:Envelope/soapv11:Header/wsse:Security/ds:Signature"; encryptor.EncryptedDataType = XmlencryptorEncryptedDataTypes.cxedtElement; encryptor.EncryptKey = false; encryptor.Config($"EncryptedDataID={encDataId2}"); encryptor.Config("KeyInfoCustomXML=<wsse:SecurityTokenReference xmlns:wsse=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd\" " + "xmlns:wsse11=\"http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd\" wsse11:TokenType=\"http://docs.oasis-open.org/wss/oasis-wss-soap-message-security-1.1#EncryptedKey\">" + $"<wsse:Reference URI=\"#{encKeyId}\"/>" + "</wsse:SecurityTokenReference>"); encryptor.Encrypt(); data = encryptor.OutputBytes; } // Step 6: miscellaneous XML DOM manipulations, not supported by XMLEncryptor, but may be required by SOAP standard using (Soapsigner signer = new Soapsigner()) { signer.InputBytes = data; signer.OutputFile = outputFilename; signer.Open(); // Adding xenc:ReferenceList element to xenc:EncryptedKey element signer.SetInnerXML("/soapv11:Envelope/soapv11:Header/wssev10:Security/xenc:EncryptedKey", signer.GetInnerXML("/soapv11:Envelope/soapv11:Header/wssev10:Security/xenc:EncryptedKey") + "<xenc:ReferenceList>" + $"<xenc:DataReference URI=\"#{encDataId1}\"/>" + $"<xenc:DataReference URI=\"#{encDataId2}\"/>" + "</xenc:ReferenceList>"); // swapping the order of elements in WSS Security header // SOAP requires that items in the header are placed in the order that they will be processed, not the order they were generated // because the decryption should be performed before veryfing SOAP message, the xenc:EncryptedKey element should be placed first var encKeyContent = signer.GetOuterXML("/soapv11:Envelope/soapv11:Header/wssev10:Security/xenc:EncryptedKey"); var secContent = signer.GetInnerXML("/soapv11:Envelope/soapv11:Header/wssev10:Security"); var k = secContent.IndexOf(encKeyContent, StringComparison.Ordinal); if (k != -1) signer.SetInnerXML("/soapv11:Envelope/soapv11:Header/wssev10:Security", encKeyContent + secContent.Substring(0, k)); signer.Close(true); } } SignAndEncryptSOAPMessage(@"soap_test.xml", @"soap_signed_encrypted.xml", @"cert.pfx", "password", @"cert2.pfx", "password2"); Sample SOAP message:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns:Data xmlns:ns="http://test.com">Sample message</ns:Data>
  </soap:Body>
</soap:Envelope>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <wsse:Security 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" soap:mustUnderstand="1">
      <xenc:EncryptedKey Id="EK-14e69f03-fc61-48f1-b825-b03ca613f0f8" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#">
        <xenc:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#rsa-1_5" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#"/>
        <ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
          <wsse:SecurityTokenReference xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <ds:X509Data xmlns:ds="http://www.w3.org/2000/09/xmldsig#">...</ds:X509Data>
          </wsse:SecurityTokenReference>
        </ds:KeyInfo>
        <xenc:CipherData xmlns:xenc="http://www.w3.org/2001/04/xmlenc#">
          <xenc:CipherValue>...</xenc:CipherValue>
        </xenc:CipherData>
        <xenc:ReferenceList>
          <xenc:DataReference URI="#ED-65385224-0bb5-43f0-b4bf-67a9e9452c10"/>
          <xenc:DataReference URI="#ED-4267b8f3-8662-4441-99ec-32a2e9180288"/>
        </xenc:ReferenceList>
      </xenc:EncryptedKey>
      <wsse:BinarySecurityToken ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3" EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary" wsu:Id="id-1135467976" 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">...</wsse:BinarySecurityToken>
      <xenc:EncryptedData Id="ED-4267b8f3-8662-4441-99ec-32a2e9180288" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
        <xenc:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes128-cbc"/>
        <ds:KeyInfo>
          <wsse:SecurityTokenReference xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsse11="http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd" wsse11:TokenType="http://docs.oasis-open.org/wss/oasis-wss-soap-message-security-1.1#EncryptedKey">
            <wsse:Reference URI="#EK-14e69f03-fc61-48f1-b825-b03ca613f0f8"/>
          </wsse:SecurityTokenReference>
        </ds:KeyInfo>
        <xenc:CipherData>
          <xenc:CipherValue>...</xenc:CipherValue>
        </xenc:CipherData>
      </xenc:EncryptedData>
    </wsse:Security>
  </soap:Header>
  <soap:Body wsu:Id="ID-5bbf3495-d919-416e-96c3-67759aab9cf8" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
    <xenc:EncryptedData Id="ED-65385224-0bb5-43f0-b4bf-67a9e9452c10" Type="http://www.w3.org/2001/04/xmlenc#Content" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
      <xenc:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes128-cbc"/>
      <ds:KeyInfo>
        <wsse:SecurityTokenReference xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsse11="http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd" wsse11:TokenType="http://docs.oasis-open.org/wss/oasis-wss-soap-message-security-1.1#EncryptedKey">
          <wsse:Reference URI="#EK-14e69f03-fc61-48f1-b825-b03ca613f0f8"/>
        </wsse:SecurityTokenReference>
      </ds:KeyInfo>
      <xenc:CipherData>
        <xenc:CipherValue>...</xenc:CipherValue>
      </xenc:CipherData>
    </xenc:EncryptedData>
  </soap:Body>
</soap:Envelope>

void DecryptAndVerifySOAPMessage(string inputFilename, string outputFilename, string decryptionCert, string decryptionCertPassword) { byte[] data; using (Xmldecryptor decryptor = new Xmldecryptor()) { decryptor.InputFile = inputFilename; decryptor.OutputFile = outputFilename; using (Certificatemanager certMgr = new Certificatemanager()) { certMgr.ImportFromFile(decryptionCert, decryptionCertPassword); decryptor.KeyDecryptionCertificate = certMgr.Certificate; } decryptor.Config("EncryptedKeyXMLElement=/soapv11:Envelope/soapv11:Header/wssev10:Security"); decryptor.Decrypt(); } using (Soapverifier verifier = new Soapverifier()) { verifier.InputFile = outputFilename; verifier.Verify(); if ((verifier.Signatures.Count != 1) || (verifier.Signatures[0].SignatureValidationResult != SignatureValidities.svtValid)) throw new Exception("Signature not found or failed to verify a signature"); } } DecryptAndVerifySOAPMessage(@"soap_signed_encrypted.xml", @"soap_signed_decrypted.xml", @"cert2.pfx", "password2");

Reset Method (XMLEncryptor Component)

Resets the component settings.

Syntax

• C#
• VB.NET

public void Reset();

Public Sub Reset()

Remarks

Reset is a generic method available in every component.

Error Event (XMLEncryptor Component)

Information about errors during signing.

Syntax

• C#
• VB.NET

public event OnErrorHandler OnError;

public delegate void OnErrorHandler(object sender, XMLEncryptorErrorEventArgs e);

public class XMLEncryptorErrorEventArgs : EventArgs {
  public int ErrorCode { get; }
  public string Description { get; }
}

Public Event OnError As OnErrorHandler

Public Delegate Sub OnErrorHandler(sender As Object, e As XMLEncryptorErrorEventArgs)

Public Class XMLEncryptorErrorEventArgs Inherits EventArgs
  Public ReadOnly Property ErrorCode As Integer
  Public ReadOnly Property Description As String
End Class

Remarks

The event is fired in case of exceptional conditions during signing.

ErrorCode contains an error code and Description contains a textual description of the error.

FormatElement Event (XMLEncryptor Component)

Reports the XML element that is currently being processed.

Syntax

• C#
• VB.NET

public event OnFormatElementHandler OnFormatElement;

public delegate void OnFormatElementHandler(object sender, XMLEncryptorFormatElementEventArgs e);

public class XMLEncryptorFormatElementEventArgs : EventArgs {
  public string StartTagWhitespace { get; set; }
  public string EndTagWhitespace { get; set; }
  public int Level { get; }
  public string Path { get; }
  public bool HasChildElements { get; }
}

Public Event OnFormatElement As OnFormatElementHandler

Public Delegate Sub OnFormatElementHandler(sender As Object, e As XMLEncryptorFormatElementEventArgs)

Public Class XMLEncryptorFormatElementEventArgs Inherits EventArgs
  Public Property StartTagWhitespace As String
  Public Property EndTagWhitespace As String
  Public ReadOnly Property Level As Integer
  Public ReadOnly Property Path As String
  Public ReadOnly Property HasChildElements As Boolean
End Class

Remarks

Path and Level specify the path to the XML element being processed and its nesting level, respectively.

HasChildElements specify if processed XML element has child elements.

Among other purposes, this event may be used to add whitespace formatting before or after a particular element in the signature.

FormatText Event (XMLEncryptor Component)

Reports XML text that is currently being processed.

Syntax

• C#
• VB.NET

public event OnFormatTextHandler OnFormatText;

public delegate void OnFormatTextHandler(object sender, XMLEncryptorFormatTextEventArgs e);

public class XMLEncryptorFormatTextEventArgs : EventArgs {
  public string Text { get; set; }
  public int TextType { get; }
  public int Level { get; }
  public string Path { get; }
}

Public Event OnFormatText As OnFormatTextHandler

Public Delegate Sub OnFormatTextHandler(sender As Object, e As XMLEncryptorFormatTextEventArgs)

Public Class XMLEncryptorFormatTextEventArgs Inherits EventArgs
  Public Property Text As String
  Public ReadOnly Property TextType As Integer
  Public ReadOnly Property Level As Integer
  Public ReadOnly Property Path As String
End Class

Remarks

TextType parameter specifies the type of the XML text (normal or Base64-encoded) that is stored in the element; Path and Level specify the path to the XML element and its nesting level.

Among other purposes, this event may be used to add whitespace formatting before or after a particular element in the signature.

Notification Event (XMLEncryptor Component)

This event notifies the application about an underlying control flow event.

Syntax

• C#
• VB.NET

public event OnNotificationHandler OnNotification;

public delegate void OnNotificationHandler(object sender, XMLEncryptorNotificationEventArgs e);

public class XMLEncryptorNotificationEventArgs : EventArgs {
  public string EventID { get; }
  public string EventParam { get; }
}

Public Event OnNotification As OnNotificationHandler

Public Delegate Sub OnNotificationHandler(sender As Object, e As XMLEncryptorNotificationEventArgs)

Public Class XMLEncryptorNotificationEventArgs Inherits EventArgs
  Public ReadOnly Property EventID As String
  Public ReadOnly Property EventParam As String
End Class

Remarks

The component fires this event to let the application know about some event, occurrence, or milestone in the component. For example, it may fire to report completion of the document processing. The list of events being reported is not fixed, and may be flexibly extended over time.

The unique identifier of the event is provided in the EventID parameter. EventParam contains any parameters accompanying the occurrence. Depending on the type of the component, the exact action it is performing, or the document being processed, one or both may be omitted.

Certificate Type

Encapsulates an individual X.509 certificate.

Remarks

This type keeps and provides access to X.509 certificate details.

Fields

Constructors

• C#
• VB.NET

public Certificate(byte[] bytes, int startIndex, int count, string password);

Public Certificate(ByVal Bytes As Byte(), ByVal StartIndex As Integer, ByVal Count As Integer, ByVal Password As String)

• C#
• VB.NET

public Certificate(byte[] certBytes, int certStartIndex, int certCount, byte[] keyBytes, int keyStartIndex, int keyCount, string password);

Public Certificate(ByVal CertBytes As Byte(), ByVal CertStartIndex As Integer, ByVal CertCount As Integer, ByVal KeyBytes As Byte(), ByVal KeyStartIndex As Integer, ByVal KeyCount As Integer, ByVal Password As String)

• C#
• VB.NET

public Certificate(byte[] bytes, int startIndex, int count);

Public Certificate(ByVal Bytes As Byte(), ByVal StartIndex As Integer, ByVal Count As Integer)

• C#
• VB.NET

public Certificate(string path, string password);

Public Certificate(ByVal Path As String, ByVal Password As String)

• C#
• VB.NET

public Certificate(string certPath, string keyPath, string password);

Public Certificate(ByVal CertPath As String, ByVal KeyPath As String, ByVal Password As String)

• C#
• VB.NET

public Certificate(string path);

Public Certificate(ByVal Path As String)

• C#
• VB.NET

public Certificate(System.IO.Stream stream);

Public Certificate(ByVal Stream As System.IO.Stream)

• C#
• VB.NET

public Certificate(System.IO.Stream stream, string password);

Public Certificate(ByVal Stream As System.IO.Stream, ByVal Password As String)

• C#
• VB.NET

public Certificate(System.IO.Stream certStream, System.IO.Stream keyStream, string password);

Public Certificate(ByVal CertStream As System.IO.Stream, ByVal KeyStream As System.IO.Stream, ByVal Password As String)

• C#
• VB.NET

public Certificate();

Public Certificate()

Config Settings (XMLEncryptor Component)

XMLEncryptor Config Settings

Base Config Settings

Trappable Errors (XMLEncryptor Component)

XMLEncryptor Errors