PPM pseudonymization tool

The PPM pseudonymization tool pseudonymizes a clear text value or converts a pseudonymized value to clear text value.

You must add the credentials of a PPM user with system administration rights to the following command line examples:

runppmpseudonymize -user <username> -password <password> [-client <name>]
{-in <filename>} | {-reverse <pseudonymized value> -out <filename>}
[-encoding <encoding>]
[-version]
[-language <ISO code>][protocoloptions]

Parameter

Description

-in <filename>

Name of the file which contains the cleartext value which should be pseudonymized

-reverse <pseudonymized value>

If this parameter is specified, then this pseudonymized value will be converted to cleartext value.

-out <filename>

Name of the file to which the cleartext value should be written.

-encoding <encoding>

Encoding of the in- or out-file (Default: UTF-8)

-language <ISO code>

Language

-version

Version number of the application and the database schema

protocoloptions

protocoloptions can consist of the following instructions:
-protocolfile <filename> Logging to file <file name>
-information {yes|no|default} Logging of information
-warning {yes|no|default} Logging of warnings
-error {yes|no|default} Logging of errors

If the -reverse <pseudonymized value> parameter is specified, the plain text value is output to the file -out <filename> in the specified encoding. If the file filename already exists, it will be overwritten.
If the -in <filename> parameter is specified, the value in the file <filename> is interpreted as a plain text value and the pseudonymized value is output directly on the standard output, that is, not in the protocol. The file is read in the specified encoding.

The key file pseudonymization.key used for encryption/decryption is expected in the following directory: <PPM installation>\server\bin\work\data_ppm\custom\<client>\keyfiles. Therefore, the client must also be specified in the command line using the -client parameter. If the specified client does not support pseudonymization, a corresponding error message appears.

Note that the user used for (de-) pseudonymization with this tool must have system administration rights in PPM.