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
-
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.
-
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.
-
Remove any instances of
passphrase
and enc_pass
from the
security.properties, customer_overrides.properties, and system_overrides.properties files.
-
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.