Amadis

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Introduction

Atheos Gateway, version 02.00.00 has been used successfully for almost 3 years now without any significant maintenance. The integration of High Security Modules (HSM) lead the development team to reengineer it heavily.

The version 03.00.00 is equivalent to the version 02.00.00 in regard to the Nexo functionalities.

The changes brought by the first release of version 3 are the basis for HSM integrations.

What’s new?

  • New configuration file structure

  • Many parameters have been added to the configuration file

  • The configuration may reference environment variables

  • Automatic creation of the files directory structure on the first startup

  • A unique session identifier is added to the sequence number of every message

  • The log file now contains more information and is more structured

  • The private key of the server may be hosted by SoftHSM v2

New configuration file structure

The notion of sections has been introduced with version 3. The configuration file is no longer a simple list of key/value pairs but these key/value pairs are now organized into sections.

Many parameters have been added to the configuration file

Many new parameters have been added or renamed in the configuration file of version 3 to improve the customization of the behaviour of the Gateway.

The configuration file may reference environment variables

The configuration file may reference environment variables. The value of a parameter may be replaced with an environment variable. It provides another source for the value of a parameter.

Its name must be preceded with $$. Thus, $$DIRECTORY_NAME refers to the environment variable DIRECTORY_NAME.

Automatic creation of the files directory structure

Version 2 relied on an installation script to create its required directory structures. This installation script is no longer required. Atheos Gateway will create its directory structures if they do not exist.

A unique session identifier is added to the sequence number of every message

All messages exchanged between a POI and the Gateway are saved. The messages have a sequence number assigned to them related to the order they were received or sent.

Confusion could arise if more than one POI was configured at the same time all using the same POI ID. The sequence number format has been changed. It is still 8 characters long, but the first 6 characters makes a string unique to a session between the POI and the Gateway. The actual sequence number is now only 2 digits long.

The log file now contains more information and is more structured

The structure of the Gateway file has been improved. Also, more information is included such as the message type received from and sent to the POI.

The private key of the server may be hosted by SoftHSM v2

The Gateway uses a certificate to authenticate itself. It is possible to use the private key related to the certificate stored into SoftHSM (v2) as a first step in the HSM integrations.

Migration path from version 2 to version 3

The directory structure did not change.

Atheos Server must be upgraded for the sequence number.

  • No labels