Initial functionality is to change the passwords of the built-in users of webMethods Integration Server (Administrator, Replicator, Developer). The primary use-case is deployment in a container.
To enable the automated update of passwords the environment variable
SAG_WXPASSWORD_UPDATE_DEFAULT_ACCOUNTS must be set to true.
This mechanism protects against accidental execution and by that
a potential lock-out.
In a typical production deployment, the desired passwords need to
be provide as environment variables. The naming convention is
SAG_WXPASSWORD_SET_<USERNAME>. So for the Administrator account
the variable SAG_WXPASSWORD_SET_Administrator must be defined.
If no password is defined via environment variable, a random one will be generated and saved in clear text in the working directory. For each user a separate file will be created and its name matches the user name.
Intended only for non-production environments!
The working directory needs to be provided as an environment variable
(SAG_WXPASSWORD_DIR). If nothing is specified, the fall-back value
is $IS_HOME/config/WxPassword. In both cases, the directory will
be created, if it does not exist. If the creation fails, a
ServiceException is thrown and now further activities performed.
You can use this package in multiple ways.
- Simply make use of the existing functionality
- Use it as a source of inspiration for your own development
- Contribute to WxPassword by adding new functionality and/or fixing bugs
This is the suitable approach, if you either just want to use WxPassword or use it as a starting point for your own development.
- Download
WxPassword.zipfrom the latest release, place it into$IS_HOME/replicate/inbound/, and install via "Packages / Management / Install Inbound Releases"
Details can be found at https://github.com/JahnTech/webmethods-is-pkg-installation
These tools are provided as-is and without warranty or support. Users are free to use, fork and modify them, subject to the license agreement.
webMethods® is a registered trademark of International Business Machines Corporation (“IBM”).