Enable the customPasswordEncryption provider to encrypt sensitive strings by using the
command line utilities such as securityUtility. You can also use the
customPasswordEncryption provider as an encoding option in WebSphere® Developer Tools.
Before you begin
Obtain an Enterprise Systems Architecture (ESA) file that contains the
customPasswordEncryption provider. The customPasswordEncryption provider implements the
com.ibm.wsspi.security.crypto.CustomPasswordEncryption interface and contains the extension manifest
file as described in
Developing a customPasswordEncryption Provider. If you do not
have an ESA file that contains the customPasswordEncryption provider, obtain a Java™ archive (JAR) file and one or more manifest files that include installation
instructions.
About this task
Install the customPasswordEncryption provider so that you can use it in the Liberty runtime
environment and WebSphere Developer Tools. You
can use the customPasswordEncryption provider in the Liberty runtime environment to encrypt
sensitive strings. After you install the customPasswordEncryption provider in the Liberty runtime
environment, WebSphere Developer Tools adds the
customPasswordEncryption option as an encoding option in the Password panel.
Procedure
- Install the ESA file by using the installUtility command.
If the customPasswordEncryption provider is packaged differently from the ESA file, follow the
installation instructions for the customPasswordEncryption provider.
- Verify that the installation was successful.
Issue the following command:
wlp/bin/securityUtility encode --listCustom
The expected output is the information from the customPasswordEncryption provider. The following
output is an example:
[{"name":"custom","featurename":"usr:customPasswordEncryption-1.0","description":"MyCompany custom password encryption"}]
- Optional: To use the customPasswordEncryption provider from the command line tools, add the following
parameter: --encoding=custom
This parameter is accepted by the following command line utilities:
securityUtility
configUtility
bluemixUtility
collective
Results
The customPasswordEncryption provider is installed in the Liberty runtime environment. You
optionally used the customPasswordEncryption provider with command line utilities.
What to do next
On the Password panel in
WebSphere
Developer Tools, you can use the customPasswordEncryption provider as an encoding
option.