Folder Encryption

The folder Encryption in Standard modules->TBox XEngines->XML contains the following Modules:

For more information and examples of how to use the Modules in TestCases, see chapter "Verify contents of XML resources".

The Encryption folder contains the additional Modules EncryptionMethod and SymmetricKey. These Modules perform background tasks for Modules that you use for your tests. You cannot use them in TestCases.

Encrypt XML Resource

The Module Encrypt XML Resource allows you to encrypt XML resources.

It has the following ModuleAttributes:

ModuleAttribute

Description

FromResource

Source Resource of the transformation.

ToResource

Target Resource of the transformation.

XPath

XPath that specifies which nodes you want to encrypt. If you don't enter a value, the XML Engine 3.0 encrypts the whole document.

EncryptionMethod

Choose between the specializations SessionKeyEncryption and SymmetricKeyEncryption.

To do so, right-click the TestStepValue and select Implement Specialization from the context menu. In the subsequent dialog box, select a specialization from the drop-down menu and click OK.

Then fill out the required TestStepValues.

EncryptionMethod->EncryptionScope

Specify whether you want to encrypt only the content of an XML node or the node itself.

Possible values are:

  • ContentOnly

  • Including Tag

EncryptionMethod->Algorithm

Encryption algorithm you want to use. Possible values are:

  • AES-128

  • AES-192

  • AES-256

Decrypt XML Resource

The Module Decrypt XML Resource allows you to decrypt XML resources.

It has the following ModuleAttributes:

ModuleAttribute

Description

FromResource

Source Resource of the transformation.

ToResource

Target Resource of the transformation.

EncryptionMethod

Choose between the specializations SessionKeyEncryption and SymmetricKeyEncryption.

To do so, right-click the TestStepValue and select Implement Specialization from the context menu. In the subsequent dialog box, select a specialization from the drop-down menu and click OK.

Then fill out the required TestStepValues.

EncryptionMethod->EncryptionScope

Specify whether you want to encrypt only the content of an XML node or the node itself.

Possible values are:

  • ContentOnly

  • Including Tag

EncryptionMethod->Algorithm

Encryption algorithm you want to use. Possible values are:

  • AES-128

  • AES-192

  • AES-256

SymmetricKeyEncryption

Use this Module as a specialization for the encryption method when you encrypt or decrypt XML resources. For information on specializations, see chapter "Generalizations and Specializations".

It has the following ModuleAttributes:

ModuleAttribute

Description

EncryptionScope

Specify whether you want to encrypt only the content of an XML node or the node itself.

Possible values are:

  • ContentOnly

  • Including Tag

Algorithm

Encryption algorithm you want to use. Possible values are:

  • AES-128

  • AES-192

  • AES-256

KeyType

Choose between the specializations PlainTextSymmetricKey and HexCodeSymmetricKey.

To do so, right-click the TestStepValue and select Implement Specialization from the context menu. In the subsequent dialog box, select a specialization from the drop-down menu and click OK.

Then fill out the required TestStepValues.

KeyType->Key

Key you want to use for the encryption.

SessionKeyEncryption

Use this Module as a specialization for the encryption method when you encrypt or decrypt XML resources. For information on specializations, see chapter "Generalizations and Specializations".

It has the following ModuleAttributes:

ModuleAttribute

Description

EncryptionScope

Specify whether you want to encrypt only the content of an XML node or the node itself.

Possible values are:

  • ContentOnly

  • Including Tag

Algorithm

Encryption algorithm you want to use. Possible values are:

  • AES-128

  • AES-192

  • AES-256

SessionKeyAlgorithm

Algorithm to encrypt the session key. Possible values are:

  • Rsa_Oaep

  • Rsa15

Certificate

Choose between the specializations CertificateStoreData and JavaKeyStoreData.

To do so, right-click the TestStepValue and select Implement Specialization from the context menu. In the subsequent dialog box, select a specialization from the drop-down menu and click OK.

Fill out the required TestStepValues (see chapter "CertificateStoreData" and chapter "JavaKeyStoreData").

If you leave the Attribute empty, the XML Engine 3.0 searches for an embedded key.

PlainTextSymmetricKey

Use this Module as a specialization for the key type when you encrypt or decrypt XML resources. For information on specializations, see chapter "Generalizations and Specializations".

It has the following ModuleAttributes:

ModuleAttribute

Description

Key

Plain-text key for encryption.

HexCodeSymmetricKey

Use this Module as a specialization for the key type when you encrypt or decrypt XML resources. For information on specializations, see chapter "Generalizations and Specializations".

It has the following ModuleAttributes:

ModuleAttribute

Description

Key

Hex code key for encryption.