Creating a Supplemental Passphrase Property File

Windows users running Sterling B2B Integrator 5.2.6.3 and later can create a supplementalPassphrase.properties file containing the system passphrase for use during startup that will be automatically removed after Sterling B2B Integrator is launched.

About this task

On a Windows system, the system passphrase is read by default from the system_overrides.properties file, which contains the passphrase in an encrypted format. Additionally, this passphrase can also be present in the security.properties or customer_overrides.properties files. To enhance security, the passphrase can be removed from the file system by making use of a supplementalPassphrase.properties file.

To create a supplementalPassphrase.properties file:

Procedure

  1. Create a supplementalPassphrase.properties file in the properties directory, and add either the plain text or encrypted version of your passphrase.
    To enter the plain text version, type passphrase=password, substituting the word "password" with your actual password.
    To enter the encrypted version, type enc_pass=<Encrypted_Passphrase>, where <Encrypted_Passphrase> is the passphrase in encrypted format, calculated using the encrypt_string.cmd script.
  2. Add the following properties to the security.properties file: useSupplementalPassphrase=true and supplementalPassphraseFile=<path to properties directory>/supplementalPassphrase.properties.
    Substitute <path to properties directory> with the file path to your own properties directory.
  3. Remove any instances of passphrase and enc_pass from the security.properties, customer_overrides.properties, and system_overrides.properties files.
  4. Run startWindowsServices.cmd.
    After system startup is complete, the supplementalPassphrase.properties file should no longer be in the properties directory.
    Note: This procedure will not work if startASIWindowsService.cmd is used to start the system.