Password Management 

Use

The password management function of the Adapter Engine enables you to protect saved passwords that are used in the adapter configurations (for example, those for logging on to the database, queue system, FTP server, or Integration Server).

Prerequisites

You have installed the Adapter Engine and the adapter you require, started the Adapter Engine and called it using your web browser. On the configuration screen, you have chosen the menu option Password Management and the system now displays the menu Password Management: Tokens.

Features

This menu option is available for users with the Adapter Engine Administrator or Adapter Configurator role.

In the Tokens menu you have the following options:

·        Display Tokens

Choose this option to display all tokens currently registered.

·        Create/Change Tokens

Choose this option to create a password for a registered token or to change a password.

·        Delete Tokens

Choose this option to delete a token.

To save adapter configuration passwords so that they are concealed, you must activate password management by entering the following:

PWD.tokenHandler=PWtokens

You must replace the password with the token and place it between the separators <!% and %!>.

If the separators <!%and %!>conflict with other parameter values in the adapter configurations they can be configured using the services.

The corresponding password is saved in the Tokens menu on the password management screen.

During the initialization of the adapter, the properties whose values contain a token are shown. If a token is found that does not exist, initialization is terminated and a corresponding error message displayed. If the properties are not shown, although you specified a token, then you either placed the separators incorrectly and therefore the token was not recognized, or you did not activate password management.

Example

In the sender file/FTP adapter you require the user XIUSER with the password hugo to log on to the Integration Server. In the file/FTP adapter configuration the following two parameters are required:

·        XI.User=XIUSER

·        XI.Password=hugo

To protect the password, a token is created with the name myPassword.

Password management is activated by entering the following in the configuration of the file/FTP adapter:

·        PWD.tokenHandler=PWtokens

The password is then replaced by the token:

·        XI.Password=<!%myPassword%!>

The separators <!% and %!> are required to identify the token.

The password hugo is then saved under the name myPassword in the token menu (without the separators). If the file/FTP adapter is reinitialized, a message appears in the file/FTP adapter log stating that the token was identified and replaced at runtime.