Global Configruation

The global configuration is stored in the kenaflow program directory (e.g. C:\Program Files\kenaflow).

filename: kenaflow.conf

In the standard configuration, this file is encrypted on the hard disk.

A mechanism provided by the Windows operating system is used for the encryption, which encrypts data using an automatically generated key ("Machine Key"). This key is valid for this Windows installation, but it is different on other Windows installations. This prevents kenaflow.conf from being copied from one computer to another.

The config file is saved as in binary serialized form because this is far more efficient than parsing XML on every start of a kenaflow process. The new serialized file kenaflow.ser.conf is created by the engine if:

If the serialized file is not valid it gets deleted if the account has permissions to do that.

The serialized file is encrypted with the data protection mechanism of Windows!

Notice: There is a property in the kenaflow.conf that can be used to disable encryption so that the global configuration file is stored unencrypted on the hard disk.

Structure

The configuration file is saved in the XML format.

The basic structure is as follows:

<?xml version="1.0" encoding="utf-8"?>
<config>
    <section name="<section-name>">
        <entry key="[key]" type="[typ]" comment="[kommentar]" default="[wert]">[daten]</entry>
        <entry key="[key]" type="[typ]" comment="[kommentar]" default="[wert]">[daten]</entry>
        <entry key="[key]" type="[typ]" comment="[kommentar]" default="[wert]">[daten]</entry>
    </section>
</config>

The division into sections (<section/>) is only included for reasons of clarity. Otherwise, it has no meaning and can be changed at will.

Notice: Sections cannot be nested!

Important: XML comments that you store in the XML file are lost when you save them. Use the comment attribute.

Each configuration entry must have a unique key. This must not be used a second time in the same configuration file.

The type of configuration entry specifies the format in which the data of the configuration entry is expected.

  • System.String
  • System.Int32
  • System.Int64
  • System.Boolean
  • System.Guid

The default value specifies the default setting specified by kenaflow. If no value is specified for the configuration parameter ("[data]"), then the default value is used.

The comment can be set arbitrarily. It is intended to document the settings.

The following sections and properties are defined:

Complete file kenaflow.conf

Here you can find a copy of the complete file: kenaflow.conf

Discussion