Importing And Exporting Audit Messages

The Audit Message Import/Export wizard allows you to import audit data from one source and re-import it to a text file or ODBC database. This wizard is launched from the main interface of the Maintenance Wizard.

This feature allows you to back up audit data or convert it to a different format. Some organizations are legally required to do either task on a regular basis. For this reason, the Audit Message Import/Export wizard also supports answers files.

If your organization is impacted by the General Data Protection Regulation (GDPR), note that for being GDPR-compliant, you must make sure to protect the exported data by encrypting it.

For more information about GDPR, refer to the OneSpan Authentication Server General Data Protection Regulation Compliance Guide.

The answers file is an output file produced by the Installation Wizard, which can be used to store configuration settings used by an OneSpan Authentication Server instance. In turn, it can also be used as an input file for applying pre-set configurations to a OneSpan Authentication Server installation. This is useful, for example, if you install OneSpan Authentication Server in a test environment first and after evaluation want to reapply the same settings in the productive environment.

In this case, answers files allow you to easily import or export audit messages regularly. To create and use an answers file, the Maintenance Wizard must be started from the command line.

To regenerate an answers file (Microsoft Windows)

1. Open a Command Prompt window.
2. Change to the binary installation directory, i.e. %PROGRAMFILES%\VASCO\IDENTIKEY Authentication Server\bin by default.

3. Type the following command:

   ikconfigwizardgui.exe --export=destination_folder\filename.ini

4. Complete the configuration according to your needs.

To regenerate an answers file (Linux)

1. Open a terminal window.

2. Type one of the following commands:

   ikconfigwizardgui --export=destination_folder/filename.ini

   -OR-

   ikconfigwizardconsole --export=destination_folder/filename.ini

3. Complete the configuration according to your needs.

To export audit messages with an answers file

1. Create a new answers file.

   For either platform, these commands will launch the Maintenance Wizard and export your desired settings to destination_folder/filename.ini>.

2. In the Maintenance Wizard, select Audit Message Import/Export.
3. Click OK.

4. Configure the audit message import/export operation as required.

   When exporting audit messages from an ODBC database, you can choose to have all exported audit messages deleted as they are exported. To do so, select the Delete Exported Data checkbox when prompted if you are running ikconfigwizardgui. If you are using the ikconfigwizardconsole tool, set Delete Exported Data to True when prompted.

To import your audit messages again using the settings from the specified answers file, start the Maintenance Wizard from the command line with the --import parameter:

• On Windows, navigate to the location of the ikconfigwizardgui.exe utility, i.e. %PROGRAMFILES%\VASCO\IDENTIKEY Authentication Server\bin by default, and run the following command:

  ikconfigwizardgui.exe --import=path\filename.ini

• On Linux, you can use the answers file with both the GUI or console version of the Maintenance Wizard:

  ikconfigwizardgui --import=path/filename.ini

  -OR-

  ikconfigwizardconsole --import=path/filename.ini

For more information about the Configuration Wizard command-line options, refer to the OneSpan Authentication Server Administrator Reference.