Document toolboxDocument toolbox

Data Scrambling

Use:
A scramble list is a part of an automation object. For compliance purposes, for example, GDPR purposes, it's required to hide some of the test case fields. Thanks to the anonymizer feature, it's possible to select fields that hold sensitive values and decide what action should be taken to prevent them from being compromised.


Parameter name

Description

Example

Parameter name

Description

Example

Rule Type

Rule type. Available options:

  • Test Case Creation - in case you want to scramble data during the creation of a test case

  • Runtime - in case you want to scramble data during runtime - when the interface is executed, and additional data is loaded to test case data.

 

Scrambling rule

Specify scrambling rule name for identification.

BEFORE

Method

Choose a scrambling method from a list. Available methods:

  • CONSTANT Replace value with constant
    The current value will contain the constant passed in the parameter. The constant should be provided as is without any brackets.

  • GUID Generate GUID

    Generate random value in a GUID format. 

  • RANDOM Generate a random value

    Generates a random value. The value of the parameter defines the upper limit of the range. It is also possible to generate negative numbers. For example, passing -100 in parameter will generate random numbers from -1 to -100

  • HASH create a hash based on value
    Calculates a hash based on the given value using algorithm passed in parameter (default 'SHA1').

  • MASK - replace each character with constant
    Replace each character with a constant passed in parameter. For example, passing X in the parameter will replace scrambled data with X signs.

  • CUSTOM - create custom method
    create a CUSTOM method (implementing an interface /INT4/IFTT_IF_DATA_SCRMBL_METH).

CONSTANT - Replace value with constant

expression type

Expression type. Available options:

  • unspecified

  • XPath (X)

  • Flat expression (F)

This field is optional for all interfaces where there is a single type of output. However, for interfaces that output might be both XML and flat file, it is mandatory to specify the expression type.

X

XPath Expression 1

Path pointing to the field/node where the exception should be applied.

This expression might be both XPath syntax for working with XML files or Int4 Flat File Syntax for flat formats like, for example, EDIFACT or other flat formats.

//ORDER/DATE/text()  (XPATH expression) or



START_TAG(BGM+220+)&&END_TAG(+)&& (Flat file expression)

Processing Parameter

Specify Processing Parameter suitable for a chosen scrambling method.

X (for Mask method)

Procedure:

  1. Open /n/int4/iftt_conf_mass and select required automation object

  2. Navigate to the data scrambling section

     

  3. You can set two types of Scrambling Rules:
    - Test Case Creation - in case you want to scramble data during creation of a test case
    - Runtime - in case you want to scramble data during runtime - when the interface is executed, and additional data is loaded to test case data.

     

  4. Specify scrambling rule name and select a method from the list. You can replace the value with constant, generate GUID number, random/hash value or replace each character with the constant (mask option). You can also create a custom method (using interface /INT4/IFTT_IF_DATA_SCRMBL_METH).

     

  5. Select expression type: Flat (for flat file) of XPath (for XML messages) expression and fill XPath expression. You should also fill the column Processing Parameter Name. In our example, the outcome setting will look like this:

     

  6. Now, when the user creates a new test case and after, selects the Content button to view the message Payload, we can see that product name is scrambled (with predefined constant value):



  7. Furthermore, after executing the test case and viewing its results, we can see that payload data was anonymized in reference and outcome messages, as required:

     

 

© 2017 - 2022 Int4 AG All rights reserved